texlive[74606] trunk: glossaries (13mar25)
commits+karl at tug.org
commits+karl at tug.org
Thu Mar 13 20:38:24 CET 2025
Revision: 74606
https://tug.org/svn/texlive?view=revision&revision=74606
Author: karl
Date: 2025-03-13 20:38:23 +0100 (Thu, 13 Mar 2025)
Log Message:
-----------
glossaries (13mar25)
Modified Paths:
--------------
trunk/Build/source/texk/texlive/linked_scripts/glossaries/makeglossaries
trunk/Build/source/texk/texlive/linked_scripts/glossaries/makeglossaries-lite.lua
trunk/Master/texmf-dist/doc/latex/glossaries/CHANGES
trunk/Master/texmf-dist/doc/latex/glossaries/README.md
trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-code.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example001.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example001.png
trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example002.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example002.png
trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example003.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example003.png
trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example004.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example004.png
trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example005.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example005.png
trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example006.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example006.png
trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example007.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example007.png
trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example008.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example008.png
trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example009.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example009.png
trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example010.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example010.png
trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example024.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example024.png
trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example025.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example025.png
trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example026.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example026.png
trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example027.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example027.png
trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example032.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example032.png
trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user.html
trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user.tex
trunk/Master/texmf-dist/doc/latex/glossaries/glossariesbegin.html
trunk/Master/texmf-dist/doc/latex/glossaries/glossariesbegin.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/glossariesbegin.tex
trunk/Master/texmf-dist/doc/latex/glossaries/glossary2glossaries.html
trunk/Master/texmf-dist/doc/latex/glossaries/glossary2glossaries.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/glossary2glossaries.tex
trunk/Master/texmf-dist/doc/latex/glossaries/samples/glossary-lipsum-examples.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/samples/minimalgls.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/samples/mwe-acr-desc.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/samples/mwe-acr.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/samples/mwe-gls.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/samples/sample-FnDesc.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/samples/sample-chap-hyperfirst.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/samples/sample-crossref.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/samples/sample-custom-acronym.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/samples/sample-dot-abbr.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/samples/sample-dual.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/samples/sample-entrycount.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/samples/sample-entryfmt.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/samples/sample-font-abbr.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/samples/sample-ignored.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/samples/sample-index.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/samples/sample-inline.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/samples/sample-langdict.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/samples/sample-newkeys.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/samples/sample-noidxapp-utf8.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/samples/sample-noidxapp.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/samples/sample-nomathhyper.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/samples/sample-numberlist.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/samples/sample-prefix.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/samples/sample-si.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/samples/sample-storage-abbr-desc.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/samples/sample-storage-abbr.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/samples/sample.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/samples/sample4col.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/samples/sampleAcr.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/samples/sampleAcrDesc.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/samples/sampleCustomAcr.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/samples/sampleDB.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/samples/sampleDesc.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/samples/sampleEq.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/samples/sampleEqPg.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/samples/sampleFnAcrDesc.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/samples/sampleNtn.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/samples/samplePeople.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/samples/sampleSec.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/samples/sampleSort.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/samples/sampleaccsupp.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/samples/sampleacronyms.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/samples/sampletree.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/samples/sampleutf8.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/samples/samplexdy.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/samples/samplexdy2.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/samples/samplexdy3.pdf
trunk/Master/texmf-dist/doc/man/man1/makeglossaries-lite.1
trunk/Master/texmf-dist/doc/man/man1/makeglossaries-lite.man1.pdf
trunk/Master/texmf-dist/doc/man/man1/makeglossaries.1
trunk/Master/texmf-dist/doc/man/man1/makeglossaries.man1.pdf
trunk/Master/texmf-dist/scripts/glossaries/glossaries.l2h
trunk/Master/texmf-dist/scripts/glossaries/makeglossaries
trunk/Master/texmf-dist/scripts/glossaries/makeglossaries-lite.lua
trunk/Master/texmf-dist/source/latex/glossaries/glossaries.dtx
trunk/Master/texmf-dist/source/latex/glossaries/glossaries.ins
trunk/Master/texmf-dist/tex/latex/glossaries/base/glossaries-babel.sty
trunk/Master/texmf-dist/tex/latex/glossaries/base/glossaries-compatible-207.sty
trunk/Master/texmf-dist/tex/latex/glossaries/base/glossaries-compatible-307.sty
trunk/Master/texmf-dist/tex/latex/glossaries/base/glossaries-polyglossia.sty
trunk/Master/texmf-dist/tex/latex/glossaries/base/glossaries-prefix.sty
trunk/Master/texmf-dist/tex/latex/glossaries/base/glossaries.sty
trunk/Master/texmf-dist/tex/latex/glossaries/expl/glossaries-accsupp.sty
trunk/Master/texmf-dist/tex/latex/glossaries/styles/glossary-hypernav.sty
trunk/Master/texmf-dist/tex/latex/glossaries/styles/glossary-inline.sty
trunk/Master/texmf-dist/tex/latex/glossaries/styles/glossary-list.sty
trunk/Master/texmf-dist/tex/latex/glossaries/styles/glossary-long.sty
trunk/Master/texmf-dist/tex/latex/glossaries/styles/glossary-longbooktabs.sty
trunk/Master/texmf-dist/tex/latex/glossaries/styles/glossary-longragged.sty
trunk/Master/texmf-dist/tex/latex/glossaries/styles/glossary-mcols.sty
trunk/Master/texmf-dist/tex/latex/glossaries/styles/glossary-super.sty
trunk/Master/texmf-dist/tex/latex/glossaries/styles/glossary-superragged.sty
trunk/Master/texmf-dist/tex/latex/glossaries/styles/glossary-tree.sty
Removed Paths:
-------------
trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example022.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example022.png
trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example022.tex
trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example023.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example023.png
trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example023.tex
trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example030.pdf
trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example030.png
trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example030.tex
Modified: trunk/Build/source/texk/texlive/linked_scripts/glossaries/makeglossaries
===================================================================
--- trunk/Build/source/texk/texlive/linked_scripts/glossaries/makeglossaries 2025-03-13 19:37:49 UTC (rev 74605)
+++ trunk/Build/source/texk/texlive/linked_scripts/glossaries/makeglossaries 2025-03-13 19:38:23 UTC (rev 74606)
@@ -2,7 +2,7 @@
# File : makeglossaries
# Author : Nicola Talbot
-# Version : 4.56
+# Version : 4.57
# 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.56 (2025-03-03)";
+my $version="4.57 (2025-03-12)";
# History:
-# v4.51 - v4.56:
+# v4.51 - v4.57:
# * No change. (Version number updated in line with glossaries.sty)
# v4.50:
# * Added -e (don't fix encap clashes)
Modified: trunk/Build/source/texk/texlive/linked_scripts/glossaries/makeglossaries-lite.lua
===================================================================
--- trunk/Build/source/texk/texlive/linked_scripts/glossaries/makeglossaries-lite.lua 2025-03-13 19:37:49 UTC (rev 74605)
+++ trunk/Build/source/texk/texlive/linked_scripts/glossaries/makeglossaries-lite.lua 2025-03-13 19:38:23 UTC (rev 74606)
@@ -36,7 +36,7 @@
Also makeglossaries and makeglossaries-lite.lua.
History:
- * 4.48 - 4.56:
+ * 4.48 - 4.57:
- 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.56 (2025-03-03)"
+thisversion = "4.57 (2025-03-12)"
quiet = false
dryrun = false
Modified: trunk/Master/texmf-dist/doc/latex/glossaries/CHANGES
===================================================================
--- trunk/Master/texmf-dist/doc/latex/glossaries/CHANGES 2025-03-13 19:37:49 UTC (rev 74605)
+++ trunk/Master/texmf-dist/doc/latex/glossaries/CHANGES 2025-03-13 19:38:23 UTC (rev 74606)
@@ -1,5 +1,15 @@
glossaries change log:
+v4.57 (2025-03-12)
+
+ * glossaries.sty
+
+ - corrections with the integration of datatool and
+ \printnoidxglossary
+
+ - \printnoidxglossary rewritten to work better with
+ tabular-like glossary styles
+
v4.56 (2025-03-03)
* glossaries.sty:
Modified: trunk/Master/texmf-dist/doc/latex/glossaries/README.md
===================================================================
--- trunk/Master/texmf-dist/doc/latex/glossaries/README.md 2025-03-13 19:37:49 UTC (rev 74605)
+++ trunk/Master/texmf-dist/doc/latex/glossaries/README.md 2025-03-13 19:38:23 UTC (rev 74606)
@@ -1,4 +1,4 @@
-# glossaries v4.56 (2025-03-03)
+# glossaries v4.57 (2025-03-12)
Author: Nicola Talbot ([contact](http://www.dickimaw-books.com/contact))
Modified: trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-code.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example001.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example001.png
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example002.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example002.png
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example003.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example003.png
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example004.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example004.png
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example005.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example005.png
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example006.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example006.png
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example007.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example007.png
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example008.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example008.png
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example009.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example009.png
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example010.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example010.png
===================================================================
(Binary files differ)
Deleted: trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example022.pdf
===================================================================
(Binary files differ)
Deleted: trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example022.png
===================================================================
(Binary files differ)
Deleted: trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example022.tex
===================================================================
--- trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example022.tex 2025-03-13 19:37:49 UTC (rev 74605)
+++ trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example022.tex 2025-03-13 19:38:23 UTC (rev 74606)
@@ -1,16 +0,0 @@
-% 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}
Deleted: trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example023.pdf
===================================================================
(Binary files differ)
Deleted: trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example023.png
===================================================================
(Binary files differ)
Deleted: trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example023.tex
===================================================================
--- trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example023.tex 2025-03-13 19:37:49 UTC (rev 74605)
+++ trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example023.tex 2025-03-13 19:38:23 UTC (rev 74606)
@@ -1,17 +0,0 @@
-% 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}
Modified: trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example024.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example024.png
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example025.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example025.png
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example026.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example026.png
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example027.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example027.png
===================================================================
(Binary files differ)
Deleted: trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example030.pdf
===================================================================
(Binary files differ)
Deleted: trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example030.png
===================================================================
(Binary files differ)
Deleted: trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example030.tex
===================================================================
--- trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example030.tex 2025-03-13 19:37:49 UTC (rev 74605)
+++ trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example030.tex 2025-03-13 19:38:23 UTC (rev 74606)
@@ -1,32 +0,0 @@
-% 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}
Modified: trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example032.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user-examples/glossaries-user-example032.png
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user.html
===================================================================
--- trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user.html 2025-03-13 19:37:49 UTC (rev 74605)
+++ trunk/Master/texmf-dist/doc/latex/glossaries/glossaries-user.html 2025-03-13 19:38:23 UTC (rev 74606)
@@ -4471,7 +4471,13 @@
-<title>User Manual for glossaries.sty v4.56</title>
+
+
+
+
+
+
+<title>User Manual for glossaries.sty v4.57</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;}
@@ -4794,8 +4800,8 @@
<body>
<div id="main">
-<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>
+<header><div class="title">User Manual for glossaries.sty v4.57</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-12</div><!-- end of date --></header>
<p>
<p>
@@ -4894,7 +4900,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.56”</span>.
+<span class="qt">“Documented Code for glossaries v4.57”</span>.
</dd>
<p>
@@ -4993,15 +4999,15 @@
<ul>
<li class="toc-subsection"><a href="#wrglossary.248"><span class="numberline">1.3.1</span> Option 1 (<span class="qt">“noidx”</span>)</a></li><!-- end of toc-subsection -->
-<li class="toc-subsection"><a href="#wrglossary.350"><span class="numberline">1.3.2</span> Option 2 (<span class="appfmt">makeindex</span>)</a></li><!-- end of toc-subsection -->
+<li class="toc-subsection"><a href="#wrglossary.341"><span class="numberline">1.3.2</span> Option 2 (<span class="appfmt">makeindex</span>)</a></li><!-- end of toc-subsection -->
-<li class="toc-subsection"><a href="#wrglossary.485"><span class="numberline">1.3.3</span> Option 3 (<span class="appfmt">xindy</span>)</a></li><!-- end of toc-subsection -->
+<li class="toc-subsection"><a href="#wrglossary.476"><span class="numberline">1.3.3</span> Option 3 (<span class="appfmt">xindy</span>)</a></li><!-- end of toc-subsection -->
-<li class="toc-subsection"><a href="#wrglossary.626"><span class="numberline">1.3.4</span> Option 4 (<span class="appfmt">bib2gls</span>)</a></li><!-- end of toc-subsection -->
+<li class="toc-subsection"><a href="#wrglossary.617"><span class="numberline">1.3.4</span> Option 4 (<span class="appfmt">bib2gls</span>)</a></li><!-- end of toc-subsection -->
-<li class="toc-subsection"><a href="#wrglossary.734"><span class="numberline">1.3.5</span> Option 5 (<span class="qt">“unsrt”</span>)</a></li><!-- end of toc-subsection -->
+<li class="toc-subsection"><a href="#wrglossary.725"><span class="numberline">1.3.5</span> Option 5 (<span class="qt">“unsrt”</span>)</a></li><!-- end of toc-subsection -->
-<li class="toc-subsection"><a href="#wrglossary.789"><span class="numberline">1.3.6</span> Option 6 (<span class="qt">“standalone”</span>)</a></li><!-- end of toc-subsection -->
+<li class="toc-subsection"><a href="#wrglossary.780"><span class="numberline">1.3.6</span> Option 6 (<span class="qt">“standalone”</span>)</a></li><!-- end of toc-subsection -->
</ul>
<li class="toc-section"><a href="#sec:lipsum"><span class="numberline">1.4</span> Dummy Entries for Testing</a></li><!-- end of toc-section -->
@@ -6119,46 +6125,42 @@
<h3><!-- start of subsection header -->1.3.1. <a id="wrglossary.248"></a><dfn id="glo:idx.opt.noidx">Option 1 (<span class="qt">“noidx”</span>)</dfn><span class="labellink"><a href="#option1">[link]</a></span></h3><!-- end of subsection header -->
<p>
-This option isn’t generally recommended as it’s slow, doesn’t
-automatically provide localisation support, and can’t form location
-ranges.
-It’s best used with <a id="wrglossary.249"></a><a href="#glo:opt.sort"><span class="styoptfmt">sort</span></a><span class="optfmt">=</span><a id="wrglossary.250"></a><a href="#glo:optval.sort.use"><span class="optfmt">use</span></a> (order of use) or
-<a id="wrglossary.251"></a><a href="#glo:opt.sort"><span class="styoptfmt">sort</span></a><span class="optfmt">=</span><a id="wrglossary.252"></a><a href="#glo:optval.sort.def"><span class="optfmt">def</span></a> (order of definition) with no
-<a id="wrglossary.253"></a><a href="#glo:dual.locationlist">location lists</a>. For alphabetical
-sorting, ensure you have at least version 3.0 of <a id="wrglossary.254"></a><a href="#glo:pkg.datatool"><span class="styfmt">datatool</span></a> and,
-where available, <a id="wrglossary.255"></a><a href="#glo:pkg.datatool"><span class="styfmt">datatool</span></a> localisation support. If an older
-version is detected, a slower, less efficient sort method will be used.
+For alphabetical sorting, ensure you have at least version 3.0 of
+<a id="wrglossary.249"></a><a href="#glo:pkg.datatool"><span class="styfmt">datatool</span></a> and, where available, <a id="wrglossary.250"></a><a href="#glo:pkg.datatool"><span class="styfmt">datatool</span></a> language
+support. If an older version is detected, a slower, less efficient
+sort method will be used. Note that this method doesn’t form
+location ranges.
<p>
<div class="marginright"><a id="ex:noidx-backref">🖹</a><a href="#ex:noidx">3</a></div>Example <a href="#ex:noidx">3</a> demonstrates this method:
<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\documentclass</code>{article}
-<code class="cmd">\usepackage</code>[<a id="wrglossary.256"></a><a href="#glo:opt.style"><span class="styoptfmt">style</span></a><span class="optfmt">=<a id="wrglossary.257"></a><a href="#glo:opt.glostyle.indexgroup"><span class="glostylefmt">indexgroup</span></a></span>]{glossaries}
-<strong class="strong"><a id="wrglossary.258"></a><a href="#glo:makenoidxglossaries"><code class="csfmt">\makenoidxglossaries</code></a></strong> <span class="comment">% use TeX to sort</span>
-<a id="wrglossary.259"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{parrot}{<a id="wrglossary.260"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={parrot}</span>,
- <a id="wrglossary.261"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a brightly coloured tropical bird}</span>}
-<a id="wrglossary.262"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{duck}{<a id="wrglossary.263"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={duck}</span>,
- <a id="wrglossary.264"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a waterbird}</span>}
-<a id="wrglossary.265"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{puffin}{<a id="wrglossary.266"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={puffin}</span>,
- <a id="wrglossary.267"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a seabird with a brightly coloured bill}</span>}
-<a id="wrglossary.268"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{penguin}{<a id="wrglossary.269"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={penguin}</span>,
- <a id="wrglossary.270"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a flightless black and white seabird}</span>}
+<code class="cmd">\usepackage</code>[<a id="wrglossary.251"></a><a href="#glo:opt.style"><span class="styoptfmt">style</span></a><span class="optfmt">=<a id="wrglossary.252"></a><a href="#glo:opt.glostyle.indexgroup"><span class="glostylefmt">indexgroup</span></a></span>]{glossaries}
+<strong class="strong"><a id="wrglossary.253"></a><a href="#glo:makenoidxglossaries"><code class="csfmt">\makenoidxglossaries</code></a></strong> <span class="comment">% use TeX to sort</span>
+<a id="wrglossary.254"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{parrot}{<a id="wrglossary.255"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={parrot}</span>,
+ <a id="wrglossary.256"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a brightly coloured tropical bird}</span>}
+<a id="wrglossary.257"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{duck}{<a id="wrglossary.258"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={duck}</span>,
+ <a id="wrglossary.259"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a waterbird}</span>}
+<a id="wrglossary.260"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{puffin}{<a id="wrglossary.261"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={puffin}</span>,
+ <a id="wrglossary.262"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a seabird with a brightly coloured bill}</span>}
+<a id="wrglossary.263"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{penguin}{<a id="wrglossary.264"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={penguin}</span>,
+ <a id="wrglossary.265"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a flightless black and white seabird}</span>}
<span class="comment">% a symbol:</span>
-<a id="wrglossary.271"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{alpha}{<a id="wrglossary.272"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={<a id="wrglossary.273"></a><a href="#glo:ensuremath"><code class="csfmt">\ensuremath</code></a>{<a id="wrglossary.274"></a><a href="#glo:alpha"><code class="csfmt">\alpha</code></a>}}</span>,
- <strong class="strong"><a id="wrglossary.275"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a><span class="optfmt">={alpha}</span></strong>,<a id="wrglossary.276"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a variable}</span>}
-<span class="comment">% an <a id="wrglossary.277"></a><a href="#glo:idx.acronym">acronym</a>:</span>
-<a id="wrglossary.278"></a><a href="#glo:setacronymstyle"><code class="csfmt">\setacronymstyle</code></a>{<a id="wrglossary.279"></a><a href="#glo:opt.acrstyle.short-long"><span class="acrstylefmt">short-long</span></a>}
-<a id="wrglossary.280"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a>{arpanet}{ARPANET}{Advanced Research Projects Agency Network}
+<a id="wrglossary.266"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{alpha}{<a id="wrglossary.267"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={<a id="wrglossary.268"></a><a href="#glo:ensuremath"><code class="csfmt">\ensuremath</code></a>{<a id="wrglossary.269"></a><a href="#glo:alpha"><code class="csfmt">\alpha</code></a>}}</span>,
+ <strong class="strong"><a id="wrglossary.270"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a><span class="optfmt">={alpha}</span></strong>,<a id="wrglossary.271"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a variable}</span>}
+<span class="comment">% an <a id="wrglossary.272"></a><a href="#glo:idx.acronym">acronym</a>:</span>
+<a id="wrglossary.273"></a><a href="#glo:setacronymstyle"><code class="csfmt">\setacronymstyle</code></a>{<a id="wrglossary.274"></a><a href="#glo:opt.acrstyle.short-long"><span class="acrstylefmt">short-long</span></a>}
+<a id="wrglossary.275"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a>{arpanet}{ARPANET}{Advanced Research Projects Agency Network}
<code class="cbeg">\begin{document}</code>
-<a id="wrglossary.281"></a><a href="#glo:Gls"><code class="csfmt">\Gls</code></a>{puffin}, <a id="wrglossary.282"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{duck} and <a id="wrglossary.283"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{parrot}.
-<a id="wrglossary.284"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{arpanet} and <a id="wrglossary.285"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{alpha}.
-Next use: <a id="wrglossary.286"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{arpanet}.
-<strong class="strong"><a id="wrglossary.287"></a><a href="#glo:printnoidxglossary"><code class="csfmt">\printnoidxglossary</code></a></strong>
+<a id="wrglossary.276"></a><a href="#glo:Gls"><code class="csfmt">\Gls</code></a>{puffin}, <a id="wrglossary.277"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{duck} and <a id="wrglossary.278"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{parrot}.
+<a id="wrglossary.279"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{arpanet} and <a id="wrglossary.280"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{alpha}.
+Next use: <a id="wrglossary.281"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{arpanet}.
+<strong class="strong"><a id="wrglossary.282"></a><a href="#glo:printnoidxglossary"><code class="csfmt">\printnoidxglossary</code></a></strong>
<code class="cend">\end{document}</code>
</pre>
You can place all your entry definitions in a separate file
-and load it in the <a id="wrglossary.288"></a><a href="#glo:idx.preamble/document">document preamble</a> with <a id="wrglossary.289"></a><a href="#glo:loadglsentries"><code class="csfmt">\loadglsentries</code></a> (<span style="font-style: italic; font-variant: normal; ">after</span>
-<a id="wrglossary.290"></a><a href="#glo:makenoidxglossaries"><code class="csfmt">\makenoidxglossaries</code></a>). Note that six entries have been
-defined but only five are referenced (<a id="wrglossary.291"></a><a href="#glo:dual.indexing">indexed</a>) in the document so
-only those five appear in the <a id="wrglossary.292"></a><a href="#glo:dual.glossary">glossary</a>.
+and load it in the <a id="wrglossary.283"></a><a href="#glo:idx.preamble/document">document preamble</a> with <a id="wrglossary.284"></a><a href="#glo:loadglsentries"><code class="csfmt">\loadglsentries</code></a> (<span style="font-style: italic; font-variant: normal; ">after</span>
+<a id="wrglossary.285"></a><a href="#glo:makenoidxglossaries"><code class="csfmt">\makenoidxglossaries</code></a>). Note that six entries have been
+defined but only five are referenced (<a id="wrglossary.286"></a><a href="#glo:dual.indexing">indexed</a>) in the document so
+only those five appear in the <a id="wrglossary.287"></a><a href="#glo:dual.glossary">glossary</a>.
<div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
<a href="#ex:noidx-backref"><span title="Up" class="icon">⭱</span></a><a id="ex:noidx"></a>Example 3: Simple document that uses TeX to sort entries <a href="glossaries-user-examples/glossaries-user-example003.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-user-examples/glossaries-user-example003.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a>
<p>
@@ -6168,73 +6170,70 @@
There are three letter groups, headed A, D and P.</object>
</div><!-- end of resultbox -->
-This uses the <a id="wrglossary.293"></a><a href="#glo:opt.glostyle.indexgroup"><span class="glostylefmt">indexgroup</span></a> style, which puts a heading at
-the start of each <a id="wrglossary.294"></a><a href="#glo:idx.group">letter group</a>. The <a id="wrglossary.295"></a><a href="#glo:idx.group">letter group</a> is determined by
+This uses the <a id="wrglossary.288"></a><a href="#glo:opt.glostyle.indexgroup"><span class="glostylefmt">indexgroup</span></a> style, which puts a heading at
+the start of each <a id="wrglossary.289"></a><a href="#glo:idx.group">letter group</a>. The <a id="wrglossary.290"></a><a href="#glo:idx.group">letter group</a> is determined by
the first character of the sort value. For a preview of all available
styles, see <a href="https://www.dickimaw-books.com/gallery/index.php?label=glossaries-styles">Gallery: Predefined Styles</a>.
-The number 1 after each description is the <a id="wrglossary.296"></a><a href="#glo:locationlist">number list</a> (or
-<a id="wrglossary.297"></a><a href="#glo:dual.locationlist">location list</a>). This is the list of <a id="wrglossary.298"></a><a href="#glo:dual.entrylocation">locations</a> (page numbers,
-in this case) where the entry was <a id="wrglossary.299"></a><a href="#glo:dual.indexing">indexed</a>. In this example, all
-entries were <a id="wrglossary.300"></a><a href="#glo:dual.indexing">indexed</a> on page 1.
+The number 1 after each description is the <a id="wrglossary.291"></a><a href="#glo:locationlist">number list</a> (or
+<a id="wrglossary.292"></a><a href="#glo:dual.locationlist">location list</a>). This is the list of <a id="wrglossary.293"></a><a href="#glo:dual.entrylocation">locations</a> (page numbers,
+in this case) where the entry was <a id="wrglossary.294"></a><a href="#glo:dual.indexing">indexed</a>. In this example, all
+entries were <a id="wrglossary.295"></a><a href="#glo:dual.indexing">indexed</a> on page 1.
<p>
<div class="information"><div class="informationtitle"><a href="#glo:sym.information"><span title="Information" class="icon">🛈</span></a></div><!-- end of informationtitle -->
-As from version 4.55, the <a id="wrglossary.301"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package will check for
-a new command added to <a id="wrglossary.302"></a><a href="#glo:pkg.datatool-base"><span class="styfmt">datatool-base</span></a> v3.0, that provides
-better sorting. The method is faster and works better with <a id="wrglossary.303"></a><a href="#glo:dual.utf8">UTF-8</a>
-characters. See the <a id="wrglossary.304"></a><a href="#glo:pkg.datatool"><span class="styfmt">datatool</span></a> v3.0+ documentation, in
+As from version 4.55, the <a id="wrglossary.296"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package will check for
+a new command added to <a id="wrglossary.297"></a><a href="#glo:pkg.datatool-base"><span class="styfmt">datatool-base</span></a> v3.0, that provides
+better sorting. The method is faster and works better with <a id="wrglossary.298"></a><a href="#glo:dual.utf8">UTF-8</a>
+characters. See the <a id="wrglossary.299"></a><a href="#glo:pkg.datatool"><span class="styfmt">datatool</span></a> v3.0+ documentation, in
particular the sections on localisation and on sorting lists.
</div><!-- end of information -->
<p>
-This option doesn’t require an external <a id="wrglossary.305"></a><a href="#glo:dual.indexingapp">indexing application</a> but, with
-the default alphabetic sorting and old versions of <a id="wrglossary.306"></a><a href="#glo:pkg.datatool"><span class="styfmt">datatool</span></a>,
+This option doesn’t require an external <a id="wrglossary.300"></a><a href="#glo:dual.indexingapp">indexing application</a> but, with
+the default alphabetic sorting and old versions of <a id="wrglossary.301"></a><a href="#glo:pkg.datatool"><span class="styfmt">datatool</span></a>,
it’s very slow with severe limitations, particularly if the sort
-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>.
+value contains <a id="wrglossary.302"></a><a href="#glo:dual.exlatinchar">extended Latin characters</a> or <a id="wrglossary.303"></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.56, then make sure you
+<a id="wrglossary.304"></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.305"></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}
</pre>
Or:
-<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.311"></a><a href="#glo:opt.languages"><span class="styoptfmt">locales</span></a><span class="optfmt">=en</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.306"></a><a href="#glo:opt.languages"><span class="styoptfmt">locales</span></a><span class="optfmt">=en</span>]{glossaries}
</pre>
-Other languages will need to have the appropriate <a id="wrglossary.312"></a><a href="#glo:pkg.datatool"><span class="styfmt">datatool</span></a>
+Other languages will need to have the appropriate <a id="wrglossary.307"></a><a href="#glo:pkg.datatool"><span class="styfmt">datatool</span></a>
localisation support provided. Examples are provided in the
-<a id="wrglossary.313"></a><a href="#glo:pkg.datatool"><span class="styfmt">datatool</span></a> manual. <strong class="strong">In general, it’s best to use
-<a id="wrglossary.314"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> or <a id="wrglossary.315"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> if you need to sort terms that use an
-<a id="wrglossary.316"></a><a href="#glo:dual.exlatinalph">extended Latin alphabet</a> or <a id="wrglossary.317"></a><a href="#glo:dual.nonlatinalph">non-Latin alphabet</a>.</strong>
+<a id="wrglossary.308"></a><a href="#glo:pkg.datatool"><span class="styfmt">datatool</span></a> manual. <strong class="strong">In general, it’s best to use
+<a id="wrglossary.309"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> or <a id="wrglossary.310"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> if you need to sort terms that use an
+<a id="wrglossary.311"></a><a href="#glo:dual.exlatinalph">extended Latin alphabet</a> or <a id="wrglossary.312"></a><a href="#glo:dual.nonlatinalph">non-Latin alphabet</a>.</strong>
<p>
If you have any commands that cause problems when
-expanding, such as <a id="wrglossary.318"></a><a href="#glo:alpha"><code class="csfmt">\alpha</code></a>, then you must use
-<a id="wrglossary.319"></a><a href="#glo:opt.sanitizesort"><span class="styoptfmt">sanitizesort</span></a><span class="optfmt">=true</span> or change the sort method
-(<a id="wrglossary.320"></a><a href="#glo:opt.sort"><span class="styoptfmt">sort</span></a><span class="optfmt">=</span><a id="wrglossary.321"></a><a href="#glo:optval.sort.use"><span class="optfmt">use</span></a> or <a id="wrglossary.322"></a><a href="#glo:opt.sort"><span class="styoptfmt">sort</span></a><span class="optfmt">=</span><a id="wrglossary.323"></a><a href="#glo:optval.sort.def"><span class="optfmt">def</span></a>) in the package options
-or explicitly set the <a id="wrglossary.324"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a> key when you define the
+expanding, such as <a id="wrglossary.313"></a><a href="#glo:alpha"><code class="csfmt">\alpha</code></a>, then you must use
+<a id="wrglossary.314"></a><a href="#glo:opt.sanitizesort"><span class="styoptfmt">sanitizesort</span></a><span class="optfmt">=true</span> or change the sort method
+(<a id="wrglossary.315"></a><a href="#glo:opt.sort"><span class="styoptfmt">sort</span></a><span class="optfmt">=</span><a id="wrglossary.316"></a><a href="#glo:optval.sort.use"><span class="optfmt">use</span></a> or <a id="wrglossary.317"></a><a href="#glo:opt.sort"><span class="styoptfmt">sort</span></a><span class="optfmt">=</span><a id="wrglossary.318"></a><a href="#glo:optval.sort.def"><span class="optfmt">def</span></a>) in the package options
+or explicitly set the <a id="wrglossary.319"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a> key when you define the
relevant entries, as shown in the above example which has:
-<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.325"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{alpha}{<a id="wrglossary.326"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={<a id="wrglossary.327"></a><a href="#glo:ensuremath"><code class="csfmt">\ensuremath</code></a>{<a id="wrglossary.328"></a><a href="#glo:alpha"><code class="csfmt">\alpha</code></a>}}</span>,
- <strong class="strong"><a id="wrglossary.329"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a><span class="optfmt">={alpha}</span>,</strong><a id="wrglossary.330"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a variable}</span>
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.320"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{alpha}{<a id="wrglossary.321"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={<a id="wrglossary.322"></a><a href="#glo:ensuremath"><code class="csfmt">\ensuremath</code></a>{<a id="wrglossary.323"></a><a href="#glo:alpha"><code class="csfmt">\alpha</code></a>}}</span>,
+ <strong class="strong"><a id="wrglossary.324"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a><span class="optfmt">={alpha}</span>,</strong><a id="wrglossary.325"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a variable}</span>
}
</pre>
<p>
-<div class="information"><div class="informationtitle"><a id="wrglossary.331"></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.326"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a></div><!-- end of informationtitle -->
-The <a id="wrglossary.332"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package has a modified <a id="wrglossary.333"></a><a href="#glo:opt.symbols"><span class="styoptfmt">symbols</span></a>
-package option that provides <a id="wrglossary.334"></a><a href="#glo:glsxtrnewsymbol"><code class="xtrcsfmt">\glsxtrnewsymbol</code></a>, which automatically sets the
-<a id="wrglossary.335"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a> key to the entry label (instead of the <a id="wrglossary.336"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a>).
+The <a id="wrglossary.327"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package has a modified <a id="wrglossary.328"></a><a href="#glo:opt.symbols"><span class="styoptfmt">symbols</span></a>
+package option that provides <a id="wrglossary.329"></a><a href="#glo:glsxtrnewsymbol"><code class="xtrcsfmt">\glsxtrnewsymbol</code></a>, which automatically sets the
+<a id="wrglossary.330"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a> key to the entry label (instead of the <a id="wrglossary.331"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a>).
</div><!-- end of information -->
<p>
-This option works best with the <a id="wrglossary.337"></a><a href="#glo:opt.sort"><span class="styoptfmt">sort</span></a><span class="optfmt">=</span><a id="wrglossary.338"></a><a href="#glo:optval.sort.def"><span class="optfmt">def</span></a> or
-<a id="wrglossary.339"></a><a href="#glo:opt.sort"><span class="styoptfmt">sort</span></a><span class="optfmt">=</span><a id="wrglossary.340"></a><a href="#glo:optval.sort.use"><span class="optfmt">use</span></a> setting. For any
-other setting, be prepared for a long document build time,
-especially if you have a lot of entries defined. <strong class="strong">This
-option is intended as a last resort for alphabetical sorting.</strong>
-This option allows a mixture of sort methods. (For example,
-sorting by word order for one glossary and order of use for another.)
-This option can be problematic with <a id="wrglossary.341"></a><a href="#glo:hierarchicallevel">hierarchical</a> glossaries and does
-not form <a id="wrglossary.342"></a><a href="#glo:idx.range">ranges</a> in the <a id="wrglossary.343"></a><a href="#glo:dual.locationlist">location lists</a>. If you really can’t use an
-<a id="wrglossary.344"></a><a href="#glo:dual.indexingapp">indexing application</a> consider using <a id="wrglossary.345"></a><a href="#glo:idx.opt.unsrt">Option 5</a> instead.
+This option works best with <a id="wrglossary.332"></a><a href="#glo:pkg.datatool"><span class="styfmt">datatool</span></a> v3.0+. If using a word or
+letter sort, be sure to also install the applicable <a id="wrglossary.333"></a><a href="#glo:pkg.datatool"><span class="styfmt">datatool</span></a>
+language file, if available. This option allows a mixture of sort
+methods. (For example, sorting by word order for one glossary and
+order of use for another.) This option can be problematic with
+<a id="wrglossary.334"></a><a href="#glo:hierarchicallevel">hierarchical</a> glossaries and does not form <a id="wrglossary.335"></a><a href="#glo:idx.range">ranges</a> in the
+<a id="wrglossary.336"></a><a href="#glo:dual.locationlist">location lists</a>.
<p>
Summary:
@@ -6241,18 +6240,18 @@
<ol class="displaylist">
<li><span class="numitem">1.</span>Add
-<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.346"></a><a href="#glo:makenoidxglossaries"><code class="csfmt">\makenoidxglossaries</code></a>
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.337"></a><a href="#glo:makenoidxglossaries"><code class="csfmt">\makenoidxglossaries</code></a>
</pre>
-to your <a id="wrglossary.347"></a><a href="#glo:idx.preamble/document">preamble</a> (before you start defining your
+to your <a id="wrglossary.338"></a><a href="#glo:idx.preamble/document">preamble</a> (before you start defining your
entries, as described in §<a href="#sec:newglosentry">4</a>).
<p>
<li><span class="numitem">2.</span>Put
-<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.348"></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.339"></a><a href="#glo:printnoidxglossary"><code class="csfmt">\printnoidxglossary</code></a>
</pre>
where you want your list of entries to appear (described in
§<a href="#sec:printglossary">8</a>). Alternatively, to display all
glossaries use the iterative command:
-<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.349"></a><a href="#glo:printnoidxglossaries"><code class="csfmt">\printnoidxglossaries</code></a>
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.340"></a><a href="#glo:printnoidxglossaries"><code class="csfmt">\printnoidxglossaries</code></a>
</pre>
<p>
<li><span class="numitem">3.</span>Run LaTeX twice on your document. (As you would do to
@@ -6266,46 +6265,46 @@
</section><!-- end of section option1 -->
<section id="option2"><!-- start of section option2 --><div class="tomain"><a href="#main">[top]</a></div>
-<h3><!-- start of subsection header -->1.3.2. <a id="wrglossary.350"></a><dfn id="glo:idx.opt.mkidx">Option 2 (<span class="appfmt">makeindex</span>)</dfn><span class="labellink"><a href="#option2">[link]</a></span></h3><!-- end of subsection header -->
+<h3><!-- start of subsection header -->1.3.2. <a id="wrglossary.341"></a><dfn id="glo:idx.opt.mkidx">Option 2 (<span class="appfmt">makeindex</span>)</dfn><span class="labellink"><a href="#option2">[link]</a></span></h3><!-- end of subsection header -->
<p>
<div class="information"><div class="informationtitle"><a href="#glo:sym.information"><span title="Information" class="icon">🛈</span></a></div><!-- end of informationtitle -->
-Since <a id="wrglossary.351"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> was designed for indexes, it doesn’t fully
-integrate with the <a id="wrglossary.352"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package, which has more complex
-use cases than a simple index. A better solution is to use <a id="wrglossary.353"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>
-which is developed alongside <a id="wrglossary.354"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> and so provides better integration.
+Since <a id="wrglossary.342"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> was designed for indexes, it doesn’t fully
+integrate with the <a id="wrglossary.343"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package, which has more complex
+use cases than a simple index. A better solution is to use <a id="wrglossary.344"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>
+which is developed alongside <a id="wrglossary.345"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> and so provides better integration.
</div><!-- end of information -->
<p>
-<a id="wrglossary.355"></a><div class="marginright"><a id="ex:mkidx-backref">🖹</a><a href="#ex:mkidx">4</a></div>Example <a href="#ex:mkidx">4</a> demonstrates a simple
-document that requires <a id="wrglossary.356"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>:
+<a id="wrglossary.346"></a><div class="marginright"><a id="ex:mkidx-backref">🖹</a><a href="#ex:mkidx">4</a></div>Example <a href="#ex:mkidx">4</a> demonstrates a simple
+document that requires <a id="wrglossary.347"></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><code class="cmd">\documentclass</code>{article}
-<code class="cmd">\usepackage</code>[<a id="wrglossary.357"></a><a href="#glo:opt.style"><span class="styoptfmt">style</span></a><span class="optfmt">=<a id="wrglossary.358"></a><a href="#glo:opt.glostyle.indexgroup"><span class="glostylefmt">indexgroup</span></a></span>]{glossaries}
-<strong class="strong"><a id="wrglossary.359"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a></strong> <span class="comment">% open <a id="wrglossary.360"></a><a href="#glo:dual.indexingfile">indexing files</a></span>
-<a id="wrglossary.361"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{parrot}{<a id="wrglossary.362"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={parrot}</span>,
- <a id="wrglossary.363"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a brightly coloured tropical bird}</span>}
-<a id="wrglossary.364"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{duck}{<a id="wrglossary.365"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={duck}</span>,
- <a id="wrglossary.366"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a waterbird}</span>}
-<a id="wrglossary.367"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{puffin}{<a id="wrglossary.368"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={puffin}</span>,
- <a id="wrglossary.369"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a seabird with a brightly coloured bill}</span>}
-<a id="wrglossary.370"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{penguin}{<a id="wrglossary.371"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={penguin}</span>,
- <a id="wrglossary.372"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a flightless black and white seabird}</span>}
+<code class="cmd">\usepackage</code>[<a id="wrglossary.348"></a><a href="#glo:opt.style"><span class="styoptfmt">style</span></a><span class="optfmt">=<a id="wrglossary.349"></a><a href="#glo:opt.glostyle.indexgroup"><span class="glostylefmt">indexgroup</span></a></span>]{glossaries}
+<strong class="strong"><a id="wrglossary.350"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a></strong> <span class="comment">% open <a id="wrglossary.351"></a><a href="#glo:dual.indexingfile">indexing files</a></span>
+<a id="wrglossary.352"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{parrot}{<a id="wrglossary.353"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={parrot}</span>,
+ <a id="wrglossary.354"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a brightly coloured tropical bird}</span>}
+<a id="wrglossary.355"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{duck}{<a id="wrglossary.356"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={duck}</span>,
+ <a id="wrglossary.357"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a waterbird}</span>}
+<a id="wrglossary.358"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{puffin}{<a id="wrglossary.359"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={puffin}</span>,
+ <a id="wrglossary.360"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a seabird with a brightly coloured bill}</span>}
+<a id="wrglossary.361"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{penguin}{<a id="wrglossary.362"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={penguin}</span>,
+ <a id="wrglossary.363"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a flightless black and white seabird}</span>}
<span class="comment">% a symbol:</span>
-<a id="wrglossary.373"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{alpha}{<a id="wrglossary.374"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={<a id="wrglossary.375"></a><a href="#glo:ensuremath"><code class="csfmt">\ensuremath</code></a>{<a id="wrglossary.376"></a><a href="#glo:alpha"><code class="csfmt">\alpha</code></a>}}</span>,
- <strong class="strong"><a id="wrglossary.377"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a><span class="optfmt">={alpha}</span></strong>,<a id="wrglossary.378"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a variable}</span>}
-<span class="comment">% an <a id="wrglossary.379"></a><a href="#glo:idx.acronym">acronym</a>:</span>
-<a id="wrglossary.380"></a><a href="#glo:setacronymstyle"><code class="csfmt">\setacronymstyle</code></a>{<a id="wrglossary.381"></a><a href="#glo:opt.acrstyle.short-long"><span class="acrstylefmt">short-long</span></a>}
-<a id="wrglossary.382"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a>{arpanet}{ARPANET}{Advanced Research Projects Agency Network}
+<a id="wrglossary.364"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{alpha}{<a id="wrglossary.365"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={<a id="wrglossary.366"></a><a href="#glo:ensuremath"><code class="csfmt">\ensuremath</code></a>{<a id="wrglossary.367"></a><a href="#glo:alpha"><code class="csfmt">\alpha</code></a>}}</span>,
+ <strong class="strong"><a id="wrglossary.368"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a><span class="optfmt">={alpha}</span></strong>,<a id="wrglossary.369"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a variable}</span>}
+<span class="comment">% an <a id="wrglossary.370"></a><a href="#glo:idx.acronym">acronym</a>:</span>
+<a id="wrglossary.371"></a><a href="#glo:setacronymstyle"><code class="csfmt">\setacronymstyle</code></a>{<a id="wrglossary.372"></a><a href="#glo:opt.acrstyle.short-long"><span class="acrstylefmt">short-long</span></a>}
+<a id="wrglossary.373"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a>{arpanet}{ARPANET}{Advanced Research Projects Agency Network}
<code class="cbeg">\begin{document}</code>
-<a id="wrglossary.383"></a><a href="#glo:Gls"><code class="csfmt">\Gls</code></a>{puffin}, <a id="wrglossary.384"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{duck} and <a id="wrglossary.385"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{parrot}.
-<a id="wrglossary.386"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{arpanet} and <a id="wrglossary.387"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{alpha}.
-Next use: <a id="wrglossary.388"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{arpanet}.
-<strong class="strong"><a id="wrglossary.389"></a><a href="#glo:printglossary"><code class="csfmt">\printglossary</code></a></strong>
+<a id="wrglossary.374"></a><a href="#glo:Gls"><code class="csfmt">\Gls</code></a>{puffin}, <a id="wrglossary.375"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{duck} and <a id="wrglossary.376"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{parrot}.
+<a id="wrglossary.377"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{arpanet} and <a id="wrglossary.378"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{alpha}.
+Next use: <a id="wrglossary.379"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{arpanet}.
+<strong class="strong"><a id="wrglossary.380"></a><a href="#glo:printglossary"><code class="csfmt">\printglossary</code></a></strong>
<code class="cend">\end{document}</code>
</pre>
You can place all your entry definitions in a separate file
-and load it in the <a id="wrglossary.390"></a><a href="#glo:idx.preamble/document">preamble</a> with <a id="wrglossary.391"></a><a href="#glo:loadglsentries"><code class="csfmt">\loadglsentries</code></a> (<span style="font-style: italic; font-variant: normal; ">after</span>
-<a id="wrglossary.392"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a>). The result is the same as for
+and load it in the <a id="wrglossary.381"></a><a href="#glo:idx.preamble/document">preamble</a> with <a id="wrglossary.382"></a><a href="#glo:loadglsentries"><code class="csfmt">\loadglsentries</code></a> (<span style="font-style: italic; font-variant: normal; ">after</span>
+<a id="wrglossary.383"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a>). The result is the same as for
Example <a href="#ex:noidx">3</a>.
<div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
<a href="#ex:mkidx-backref"><span title="Up" class="icon">⭱</span></a><a id="ex:mkidx"></a>Example 4: Simple document that uses <span class="appfmt">makeindex</span> to sort entries <a href="glossaries-user-examples/glossaries-user-example004.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-user-examples/glossaries-user-example004.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a>
@@ -6317,58 +6316,58 @@
</div><!-- end of resultbox -->
<p>
-This option uses a <a id="wrglossary.393"></a><a href="#glo:dual.cli">CLI</a> application called <a id="wrglossary.394"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> to sort
+This option uses a <a id="wrglossary.384"></a><a href="#glo:dual.cli">CLI</a> application called <a id="wrglossary.385"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> to sort
the entries. This application comes with all modern TeX distributions,
-but it’s hard-coded for the non-extended <a id="wrglossary.395"></a><a href="#glo:dual.latinalph">Latin alphabet</a>. It can’t
-correctly sort accent commands (such as <a id="wrglossary.396"></a><a href="#glo:cs.apos"><code class="csfmt">\'</code></a> or <a id="wrglossary.397"></a><a href="#glo:c"><code class="csfmt">\c</code></a>) and fails
-with <a id="wrglossary.398"></a><a href="#glo:dual.utf8">UTF-8</a> characters, especially for any sort values that start
-with a <a id="wrglossary.399"></a><a href="#glo:dual.utf8">UTF-8</a> character (as it separates the octets resulting in an
-invalid file <a id="wrglossary.400"></a><a href="#glo:idx.encoding">encoding</a>). This process involves making LaTeX write
-the <a id="wrglossary.401"></a><a href="#glo:dual.glossary">glossary</a> information to a temporary file which <a id="wrglossary.402"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>
-reads. Then <a id="wrglossary.403"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> writes a new file containing the code
-to typeset the <a id="wrglossary.404"></a><a href="#glo:dual.glossary">glossary</a>. Then <a id="wrglossary.405"></a><a href="#glo:printglossary"><code class="csfmt">\printglossary</code></a> reads this file in
+but it’s hard-coded for the non-extended <a id="wrglossary.386"></a><a href="#glo:dual.latinalph">Latin alphabet</a>. It can’t
+correctly sort accent commands (such as <a id="wrglossary.387"></a><a href="#glo:cs.apos"><code class="csfmt">\'</code></a> or <a id="wrglossary.388"></a><a href="#glo:c"><code class="csfmt">\c</code></a>) and fails
+with <a id="wrglossary.389"></a><a href="#glo:dual.utf8">UTF-8</a> characters, especially for any sort values that start
+with a <a id="wrglossary.390"></a><a href="#glo:dual.utf8">UTF-8</a> character (as it separates the octets resulting in an
+invalid file <a id="wrglossary.391"></a><a href="#glo:idx.encoding">encoding</a>). This process involves making LaTeX write
+the <a id="wrglossary.392"></a><a href="#glo:dual.glossary">glossary</a> information to a temporary file which <a id="wrglossary.393"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>
+reads. Then <a id="wrglossary.394"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> writes a new file containing the code
+to typeset the <a id="wrglossary.395"></a><a href="#glo:dual.glossary">glossary</a>. Then <a id="wrglossary.396"></a><a href="#glo:printglossary"><code class="csfmt">\printglossary</code></a> reads this file in
on the next run.
<p>
<div class="information"><div class="informationtitle"><a href="#glo:sym.information"><span title="Information" class="icon">🛈</span></a></div><!-- end of informationtitle -->
-There are other applications that can read <a id="wrglossary.406"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> files,
-such as <a id="wrglossary.407"></a><a href="#glo:app.texindy"><span class="appfmt">texindy</span></a> and <a id="wrglossary.408"></a><a href="#glo:app.xindex"><span class="appfmt">xindex</span></a>, but the <a id="wrglossary.409"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a>
-package uses a customized <a id="wrglossary.410"></a><a href="#glo:ext.ist"><span class="extfmt">ist</span></a> style file (created by
-<a id="wrglossary.411"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a>) that adjusts the special characters and input
+There are other applications that can read <a id="wrglossary.397"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> files,
+such as <a id="wrglossary.398"></a><a href="#glo:app.texindy"><span class="appfmt">texindy</span></a> and <a id="wrglossary.399"></a><a href="#glo:app.xindex"><span class="appfmt">xindex</span></a>, but the <a id="wrglossary.400"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a>
+package uses a customized <a id="wrglossary.401"></a><a href="#glo:ext.ist"><span class="extfmt">ist</span></a> style file (created by
+<a id="wrglossary.402"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a>) that adjusts the special characters and input
keyword and also ensures that the resulting file (which is input by
-<a id="wrglossary.412"></a><a href="#glo:printglossary"><code class="csfmt">\printglossary</code></a>) adheres to the <a id="wrglossary.413"></a><a href="#glo:dual.glossary">glossary</a> style.
+<a id="wrglossary.403"></a><a href="#glo:printglossary"><code class="csfmt">\printglossary</code></a>) adheres to the <a id="wrglossary.404"></a><a href="#glo:dual.glossary">glossary</a> style.
If you want to use an alternative, you will need to ensure that it
-can honour the settings in the <a id="wrglossary.414"></a><a href="#glo:ext.ist"><span class="extfmt">ist</span></a> file or find some way to
-convert the <a id="wrglossary.415"></a><a href="#glo:ext.ist"><span class="extfmt">ist</span></a> file into an equivalent set of instructions.
+can honour the settings in the <a id="wrglossary.405"></a><a href="#glo:ext.ist"><span class="extfmt">ist</span></a> file or find some way to
+convert the <a id="wrglossary.406"></a><a href="#glo:ext.ist"><span class="extfmt">ist</span></a> file into an equivalent set of instructions.
</div><!-- end of information -->
<p>
This option works best if you want to sort entries according to the
Basic Latin alphabet and you don’t want to install Perl or Java. This
-method can also work with the restricted <a id="wrglossary.416"></a><a href="#glo:dual.shellescape">shell escape</a> since
-<a id="wrglossary.417"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> is considered a trusted application, which means you should
-be able to use the <a id="wrglossary.418"></a><a href="#glo:opt.automake"><span class="styoptfmt">automake</span></a><span class="optfmt">=</span><a id="wrglossary.419"></a><a href="#glo:optval.automake.immediate"><span class="optfmt">immediate</span></a> or
-<a id="wrglossary.420"></a><a href="#glo:opt.automake"><span class="styoptfmt">automake</span></a><span class="optfmt">=</span><a id="wrglossary.421"></a><a href="#glo:optval.automake.delayed"><span class="optfmt">true</span></a> package option provided the
-<a id="wrglossary.422"></a><a href="#glo:dual.shellescape">shell escape</a> hasn’t been completely disabled.
+method can also work with the restricted <a id="wrglossary.407"></a><a href="#glo:dual.shellescape">shell escape</a> since
+<a id="wrglossary.408"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> is considered a trusted application, which means you should
+be able to use the <a id="wrglossary.409"></a><a href="#glo:opt.automake"><span class="styoptfmt">automake</span></a><span class="optfmt">=</span><a id="wrglossary.410"></a><a href="#glo:optval.automake.immediate"><span class="optfmt">immediate</span></a> or
+<a id="wrglossary.411"></a><a href="#glo:opt.automake"><span class="styoptfmt">automake</span></a><span class="optfmt">=</span><a id="wrglossary.412"></a><a href="#glo:optval.automake.delayed"><span class="optfmt">true</span></a> package option provided the
+<a id="wrglossary.413"></a><a href="#glo:dual.shellescape">shell escape</a> hasn’t been completely disabled.
<p>
-This method can form <a id="wrglossary.423"></a><a href="#glo:idx.range">ranges</a> in the <a id="wrglossary.424"></a><a href="#glo:locationlist">number list</a> but only
-accepts limited number formats: <a id="wrglossary.425"></a><a href="#glo:arabic"><code class="csfmt">\arabic</code></a>, <a id="wrglossary.426"></a><a href="#glo:roman"><code class="csfmt">\roman</code></a>,
-<a id="wrglossary.427"></a><a href="#glo:Roman"><code class="csfmt">\Roman</code></a>, <a id="wrglossary.428"></a><a href="#glo:alph"><code class="csfmt">\alph</code></a> and <a id="wrglossary.429"></a><a href="#glo:Alph"><code class="csfmt">\Alph</code></a>.
+This method can form <a id="wrglossary.414"></a><a href="#glo:idx.range">ranges</a> in the <a id="wrglossary.415"></a><a href="#glo:locationlist">number list</a> but only
+accepts limited number formats: <a id="wrglossary.416"></a><a href="#glo:arabic"><code class="csfmt">\arabic</code></a>, <a id="wrglossary.417"></a><a href="#glo:roman"><code class="csfmt">\roman</code></a>,
+<a id="wrglossary.418"></a><a href="#glo:Roman"><code class="csfmt">\Roman</code></a>, <a id="wrglossary.419"></a><a href="#glo:alph"><code class="csfmt">\alph</code></a> and <a id="wrglossary.420"></a><a href="#glo:Alph"><code class="csfmt">\Alph</code></a>.
<p>
This option does not allow a mixture of sort methods.
-All <a id="wrglossary.430"></a><a href="#glo:dual.glossary">glossaries</a> must be sorted according to the same method:
+All <a id="wrglossary.421"></a><a href="#glo:dual.glossary">glossaries</a> must be sorted according to the same method:
word/letter ordering or order of use or order of definition.
-If you need word ordering for one <a id="wrglossary.431"></a><a href="#glo:dual.glossary">glossary</a> and letter ordering
-for another you’ll have to explicitly call <a id="wrglossary.432"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> for
-each <a id="wrglossary.433"></a><a href="#glo:dual.glossary">glossary</a> type.
+If you need word ordering for one <a id="wrglossary.422"></a><a href="#glo:dual.glossary">glossary</a> and letter ordering
+for another you’ll have to explicitly call <a id="wrglossary.423"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> for
+each <a id="wrglossary.424"></a><a href="#glo:dual.glossary">glossary</a> type.
<p>
-<div class="information"><div class="informationtitle"><a id="wrglossary.434"></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.425"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a></div><!-- end of informationtitle -->
-The <a id="wrglossary.435"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package allows a hybrid mix of
+The <a id="wrglossary.426"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package allows a hybrid mix of
Options <a href="#glo:idx.opt.noidx">1</a> and <a href="#glo:idx.opt.mkidx">2</a> to provide word/letter ordering with
-<a id="wrglossary.436"></a><a href="#glo:idx.opt.mkidx">Option 2</a> and order of use/definition with
-<a id="wrglossary.437"></a><a href="#glo:idx.opt.noidx">Option 1</a>. See the <a id="wrglossary.438"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> documentation for
-further details. See also the <a id="wrglossary.439"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> alternative to
-<a id="wrglossary.440"></a><a href="#glo:file.sampleSort.tex"><span class="filefmt">sampleSort.tex</span></a> in §<a href="#sec:samplessort">18.5</a>.
+<a id="wrglossary.427"></a><a href="#glo:idx.opt.mkidx">Option 2</a> and order of use/definition with
+<a id="wrglossary.428"></a><a href="#glo:idx.opt.noidx">Option 1</a>. See the <a id="wrglossary.429"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> documentation for
+further details. See also the <a id="wrglossary.430"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> alternative to
+<a id="wrglossary.431"></a><a href="#glo:file.sampleSort.tex"><span class="filefmt">sampleSort.tex</span></a> in §<a href="#sec:samplessort">18.5</a>.
</div><!-- end of information -->
<p>
@@ -6376,76 +6375,76 @@
<ol class="displaylist">
-<li><span class="numitem">1.</span>If you want to use <a id="wrglossary.441"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span>’s</a> <a id="wrglossary.442"></a><a href="#glo:switch.mkidx.g"><span class="shortargfmt">-g</span></a> option
-you must change the quote character using <a id="wrglossary.443"></a><a href="#glo:GlsSetQuote"><code class="csfmt">\GlsSetQuote</code></a>. For example:
-<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.444"></a><a href="#glo:GlsSetQuote"><code class="csfmt">\GlsSetQuote</code></a>{+}
+<li><span class="numitem">1.</span>If you want to use <a id="wrglossary.432"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span>’s</a> <a id="wrglossary.433"></a><a href="#glo:switch.mkidx.g"><span class="shortargfmt">-g</span></a> option
+you must change the quote character using <a id="wrglossary.434"></a><a href="#glo:GlsSetQuote"><code class="csfmt">\GlsSetQuote</code></a>. For example:
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.435"></a><a href="#glo:GlsSetQuote"><code class="csfmt">\GlsSetQuote</code></a>{+}
</pre>
-This must be used before <a id="wrglossary.445"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a>.
-Note that if you are using <a id="wrglossary.446"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a>, the shorthands aren’t
+This must be used before <a id="wrglossary.436"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a>.
+Note that if you are using <a id="wrglossary.437"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a>, the shorthands aren’t
enabled until the start of the document, so you won’t be able to use
-the shorthands in definitions that occur in the <a id="wrglossary.447"></a><a href="#glo:idx.preamble/document">preamble</a>.
+the shorthands in definitions that occur in the <a id="wrglossary.438"></a><a href="#glo:idx.preamble/document">preamble</a>.
<p>
<li><span class="numitem">2.</span>Add
-<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.448"></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><a id="wrglossary.439"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a>
</pre>
-to your <a id="wrglossary.449"></a><a href="#glo:idx.preamble/document">preamble</a> (before you start
+to your <a id="wrglossary.440"></a><a href="#glo:idx.preamble/document">preamble</a> (before you start
defining your entries, as described in
§<a href="#sec:newglosentry">4</a>).
<p>
<li><span class="numitem">3.</span>Put
-<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.450"></a><a href="#glo:printglossary"><code class="csfmt">\printglossary</code></a>
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.441"></a><a href="#glo:printglossary"><code class="csfmt">\printglossary</code></a>
</pre>
where you want your list of entries to appear (described in
§<a href="#sec:printglossary">8</a>). Alternatively, to display all
glossaries use the iterative command:
-<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.451"></a><a href="#glo:printglossaries"><code class="csfmt">\printglossaries</code></a>
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.442"></a><a href="#glo:printglossaries"><code class="csfmt">\printglossaries</code></a>
</pre>
<p>
<li><span class="numitem">4.</span>Run LaTeX on your document. This creates files with the
-extensions <a id="wrglossary.452"></a><a href="#glo:ext.glo"><span class="extfmt">glo</span></a> and <a id="wrglossary.453"></a><a href="#glo:ext.ist"><span class="extfmt">ist</span></a> (for example, if your
+extensions <a id="wrglossary.443"></a><a href="#glo:ext.glo"><span class="extfmt">glo</span></a> and <a id="wrglossary.444"></a><a href="#glo:ext.ist"><span class="extfmt">ist</span></a> (for example, if your
LaTeX document is called <span class="filefmt">myDoc.tex</span>, then you’ll have
two extra files called <span class="filefmt">myDoc.glo</span> and <span class="filefmt">myDoc.ist</span>).
If you look at your document at this point, you won’t see the
glossary as it hasn’t been created yet. (If you use
-<a id="wrglossary.454"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> you’ll see the section heading and some
+<a id="wrglossary.445"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> you’ll see the section heading and some
boilerplate text.)
<p>
-If you have used package options such as <a id="wrglossary.455"></a><a href="#glo:opt.symbols"><span class="styoptfmt">symbols</span></a> there
+If you have used package options such as <a id="wrglossary.446"></a><a href="#glo:opt.symbols"><span class="styoptfmt">symbols</span></a> there
will also be other sets of files corresponding to the extra
glossaries that were created by those options.
<p>
-<li><span class="numitem">5.</span><a id="makeindex.run"></a> Run <a id="wrglossary.456"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> with the <a id="wrglossary.457"></a><a href="#glo:ext.glo"><span class="extfmt">glo</span></a> file as the
-input file and the <a id="wrglossary.458"></a><a href="#glo:ext.ist"><span class="extfmt">ist</span></a> file as the style so that
-it creates an output file with the extension <a id="wrglossary.459"></a><a href="#glo:ext.gls"><span class="extfmt">gls</span></a>:
-<pre class="terminal"><div class="terminaltitle"><a href="#glo:sym.terminal"><span title="Terminal" class="icon">〉_</span></a></div>makeindex <a id="wrglossary.460"></a><a href="#glo:switch.mkidx.s"><span class="shortargfmt">-s</span></a> myDoc.ist <a id="wrglossary.461"></a><a href="#glo:switch.mkidx.o"><span class="shortargfmt">-o</span></a> myDoc.gls myDoc.glo
+<li><span class="numitem">5.</span><a id="makeindex.run"></a> Run <a id="wrglossary.447"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> with the <a id="wrglossary.448"></a><a href="#glo:ext.glo"><span class="extfmt">glo</span></a> file as the
+input file and the <a id="wrglossary.449"></a><a href="#glo:ext.ist"><span class="extfmt">ist</span></a> file as the style so that
+it creates an output file with the extension <a id="wrglossary.450"></a><a href="#glo:ext.gls"><span class="extfmt">gls</span></a>:
+<pre class="terminal"><div class="terminaltitle"><a href="#glo:sym.terminal"><span title="Terminal" class="icon">〉_</span></a></div>makeindex <a id="wrglossary.451"></a><a href="#glo:switch.mkidx.s"><span class="shortargfmt">-s</span></a> myDoc.ist <a id="wrglossary.452"></a><a href="#glo:switch.mkidx.o"><span class="shortargfmt">-o</span></a> myDoc.gls myDoc.glo
</pre>
(Replace <code class="code">myDoc</code> with the base name of your LaTeX document file. Avoid spaces in the file name if possible.)
<p>
<div class="important"><div class="importanttitle"><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
-The file extensions vary according to the <a id="wrglossary.462"></a><a href="#glo:dual.glossary">glossary</a> <a id="wrglossary.463"></a><a href="#glo:opt.gloskey.type"><span class="csoptfmt">type</span></a>.
+The file extensions vary according to the <a id="wrglossary.453"></a><a href="#glo:dual.glossary">glossary</a> <a id="wrglossary.454"></a><a href="#glo:opt.gloskey.type"><span class="csoptfmt">type</span></a>.
See §<a href="#sec:makeindexapp">1.6.4</a> for further details.
-<a id="wrglossary.464"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> must be called for each set of files.
+<a id="wrglossary.455"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> must be called for each set of files.
</div><!-- end of important -->
<p>
If you don’t know how to use the command prompt, then you can probably access
-<a id="wrglossary.465"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> via your text editor, but each editor has a
+<a id="wrglossary.456"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> via your text editor, but each editor has a
different method of doing this. See <a href="https://www.dickimaw-books.com/latex/buildglossaries/">Incorporating
makeglossaries or makeglossaries-lite or bib2gls into the document
build</a> for some examples.
<p>
-Alternatively, run <a id="wrglossary.466"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> indirectly via the
-<a id="wrglossary.467"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> script:
+Alternatively, run <a id="wrglossary.457"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> indirectly via the
+<a id="wrglossary.458"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> script:
<pre class="terminal"><div class="terminaltitle"><a href="#glo:sym.terminal"><span title="Terminal" class="icon">〉_</span></a></div>makeglossaries myDoc
</pre>
Note that the file extension isn’t supplied in this case.
-(Replace <a id="wrglossary.468"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> with <a id="wrglossary.469"></a><a href="#glo:app.makeglossaries-lite"><span class="appfmt">makeglossaries-lite</span></a> if
+(Replace <a id="wrglossary.459"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> with <a id="wrglossary.460"></a><a href="#glo:app.makeglossaries-lite"><span class="appfmt">makeglossaries-lite</span></a> if
you don’t have Perl installed.)
This will pick up all the file extensions from the
-<a id="wrglossary.470"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> file and run <a id="wrglossary.471"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> the appropriate number
+<a id="wrglossary.461"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> file and run <a id="wrglossary.462"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> the appropriate number
of times with all the necessary switches.
<p>
-The simplest approach is to use <a id="wrglossary.472"></a><a href="#glo:app.arara"><span class="appfmt">arara</span></a> and add the following
+The simplest approach is to use <a id="wrglossary.463"></a><a href="#glo:app.arara"><span class="appfmt">arara</span></a> and add the following
comment lines to the start of your document:
<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div>% arara: pdflatex
% arara: makeglossaries
@@ -6456,14 +6455,14 @@
there’s no hyphen in this case.)
<p>
The default sort is word order (<span class="qt">“sea lion”</span> comes before <span class="qt">“seal”</span>).
-If you want letter ordering you need to add the <a id="wrglossary.473"></a><a href="#glo:switch.mkidx.l"><span class="shortargfmt">-l</span></a>
+If you want letter ordering you need to add the <a id="wrglossary.464"></a><a href="#glo:switch.mkidx.l"><span class="shortargfmt">-l</span></a>
switch:
-<pre class="terminal"><div class="terminaltitle"><a href="#glo:sym.terminal"><span title="Terminal" class="icon">〉_</span></a></div>makeindex <a id="wrglossary.474"></a><a href="#glo:switch.mkidx.l"><span class="shortargfmt">-l</span></a> <a id="wrglossary.475"></a><a href="#glo:switch.mkidx.s"><span class="shortargfmt">-s</span></a> myDoc.ist -o myDoc.gls myDoc.glo
+<pre class="terminal"><div class="terminaltitle"><a href="#glo:sym.terminal"><span title="Terminal" class="icon">〉_</span></a></div>makeindex <a id="wrglossary.465"></a><a href="#glo:switch.mkidx.l"><span class="shortargfmt">-l</span></a> <a id="wrglossary.466"></a><a href="#glo:switch.mkidx.s"><span class="shortargfmt">-s</span></a> myDoc.ist -o myDoc.gls myDoc.glo
</pre>
(See §<a href="#sec:makeindexapp">1.6.4</a> for further details on using
-<a id="wrglossary.476"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> explicitly.) If you use <a id="wrglossary.477"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a>
-or <a id="wrglossary.478"></a><a href="#glo:app.makeglossaries-lite"><span class="appfmt">makeglossaries-lite</span></a> then use the <a id="wrglossary.479"></a><a href="#glo:opt.order"><span class="styoptfmt">order</span></a><span class="optfmt">=letter</span>
-package option and the <a id="wrglossary.480"></a><a href="#glo:switch.mkidx.l"><span class="shortargfmt">-l</span></a> option will be added
+<a id="wrglossary.467"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> explicitly.) If you use <a id="wrglossary.468"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a>
+or <a id="wrglossary.469"></a><a href="#glo:app.makeglossaries-lite"><span class="appfmt">makeglossaries-lite</span></a> then use the <a id="wrglossary.470"></a><a href="#glo:opt.order"><span class="styoptfmt">order</span></a><span class="optfmt">=letter</span>
+package option and the <a id="wrglossary.471"></a><a href="#glo:switch.mkidx.l"><span class="shortargfmt">-l</span></a> option will be added
automatically.
<p>
<li><span class="numitem">6.</span><a id="makeindex.relatex"></a> Once you have successfully completed the previous step,
@@ -6471,60 +6470,60 @@
</ol>
-You’ll need to repeat the last step if you have used the <a id="wrglossary.481"></a><a href="#glo:opt.toc"><span class="styoptfmt">toc</span></a>
-option (unless you’re using <a id="wrglossary.482"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>) to ensure the
+You’ll need to repeat the last step if you have used the <a id="wrglossary.472"></a><a href="#glo:opt.toc"><span class="styoptfmt">toc</span></a>
+option (unless you’re using <a id="wrglossary.473"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>) to ensure the
section heading is added to the table of contents. You’ll also need
to repeat steps <a href="#makeindex.run">5</a> and <a href="#makeindex.relatex">6</a> if
-you have any cross-references which can’t be <a id="wrglossary.483"></a><a href="#glo:dual.indexing">indexed</a> until the
-<a id="wrglossary.484"></a><a href="#glo:dual.indexingfile">indexing file</a> has been created.
+you have any cross-references which can’t be <a id="wrglossary.474"></a><a href="#glo:dual.indexing">indexed</a> until the
+<a id="wrglossary.475"></a><a href="#glo:dual.indexingfile">indexing file</a> has been created.
<p>
</section><!-- end of section option2 -->
<section id="option3"><!-- start of section option3 --><div class="tomain"><a href="#main">[top]</a></div>
-<h3><!-- start of subsection header -->1.3.3. <a id="wrglossary.485"></a><dfn id="glo:idx.opt.xdy">Option 3 (<span class="appfmt">xindy</span>)</dfn><span class="labellink"><a href="#option3">[link]</a></span></h3><!-- end of subsection header -->
+<h3><!-- start of subsection header -->1.3.3. <a id="wrglossary.476"></a><dfn id="glo:idx.opt.xdy">Option 3 (<span class="appfmt">xindy</span>)</dfn><span class="labellink"><a href="#option3">[link]</a></span></h3><!-- end of subsection header -->
<p>
<div class="information"><div class="informationtitle"><a href="#glo:sym.information"><span title="Information" class="icon">🛈</span></a></div><!-- end of informationtitle -->
-Since <a id="wrglossary.486"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> was designed for indexes, it doesn’t fully
-integrate with the <a id="wrglossary.487"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package, which has more complex
-use cases than a simple index. A better solution is to use <a id="wrglossary.488"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>
-which is developed alongside <a id="wrglossary.489"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> and so provides better integration.
-See the <a id="wrglossary.490"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> home page <a href="http://www.xindy.org/">http://www.xindy.org/</a> for
-the <a id="wrglossary.491"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> documentation, and links to the mailing list and
+Since <a id="wrglossary.477"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> was designed for indexes, it doesn’t fully
+integrate with the <a id="wrglossary.478"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package, which has more complex
+use cases than a simple index. A better solution is to use <a id="wrglossary.479"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>
+which is developed alongside <a id="wrglossary.480"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> and so provides better integration.
+See the <a id="wrglossary.481"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> home page <a href="http://www.xindy.org/">http://www.xindy.org/</a> for
+the <a id="wrglossary.482"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> documentation, and links to the mailing list and
issue tracker.
</div><!-- end of information -->
<p>
-<a id="wrglossary.492"></a><div class="marginright"><a id="ex:xdy-backref">🖹</a><a href="#ex:xdy">5</a></div>Example <a href="#ex:xdy">5</a> demonstrates a simple document that
-requires <a id="wrglossary.493"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>:
+<a id="wrglossary.483"></a><div class="marginright"><a id="ex:xdy-backref">🖹</a><a href="#ex:xdy">5</a></div>Example <a href="#ex:xdy">5</a> demonstrates a simple document that
+requires <a id="wrglossary.484"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</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>[<strong class="strong"><a id="wrglossary.494"></a><a href="#glo:opt.xindy"><span class="styoptfmt">xindy</span></a></strong>,<a id="wrglossary.495"></a><a href="#glo:opt.style"><span class="styoptfmt">style</span></a><span class="optfmt">=<a id="wrglossary.496"></a><a href="#glo:opt.glostyle.indexgroup"><span class="glostylefmt">indexgroup</span></a></span>]{glossaries}
-<strong class="strong"><a id="wrglossary.497"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a></strong> <span class="comment">% open <a id="wrglossary.498"></a><a href="#glo:dual.indexingfile">indexing files</a></span>
-<a id="wrglossary.499"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{parrot}{<a id="wrglossary.500"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={parrot}</span>,
- <a id="wrglossary.501"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a brightly coloured tropical bird}</span>}
-<a id="wrglossary.502"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{duck}{<a id="wrglossary.503"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={duck}</span>,
- <a id="wrglossary.504"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a waterbird}</span>}
-<a id="wrglossary.505"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{puffin}{<a id="wrglossary.506"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={puffin}</span>,
- <a id="wrglossary.507"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a seabird with a brightly coloured bill}</span>}
-<a id="wrglossary.508"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{penguin}{<a id="wrglossary.509"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={penguin}</span>,
- <a id="wrglossary.510"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a flightless black and white seabird}</span>}
+<code class="cmd">\usepackage</code>[<strong class="strong"><a id="wrglossary.485"></a><a href="#glo:opt.xindy"><span class="styoptfmt">xindy</span></a></strong>,<a id="wrglossary.486"></a><a href="#glo:opt.style"><span class="styoptfmt">style</span></a><span class="optfmt">=<a id="wrglossary.487"></a><a href="#glo:opt.glostyle.indexgroup"><span class="glostylefmt">indexgroup</span></a></span>]{glossaries}
+<strong class="strong"><a id="wrglossary.488"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a></strong> <span class="comment">% open <a id="wrglossary.489"></a><a href="#glo:dual.indexingfile">indexing files</a></span>
+<a id="wrglossary.490"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{parrot}{<a id="wrglossary.491"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={parrot}</span>,
+ <a id="wrglossary.492"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a brightly coloured tropical bird}</span>}
+<a id="wrglossary.493"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{duck}{<a id="wrglossary.494"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={duck}</span>,
+ <a id="wrglossary.495"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a waterbird}</span>}
+<a id="wrglossary.496"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{puffin}{<a id="wrglossary.497"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={puffin}</span>,
+ <a id="wrglossary.498"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a seabird with a brightly coloured bill}</span>}
+<a id="wrglossary.499"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{penguin}{<a id="wrglossary.500"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={penguin}</span>,
+ <a id="wrglossary.501"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a flightless black and white seabird}</span>}
<span class="comment">% a symbol:</span>
-<a id="wrglossary.511"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{alpha}{<a id="wrglossary.512"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={<a id="wrglossary.513"></a><a href="#glo:ensuremath"><code class="csfmt">\ensuremath</code></a>{<a id="wrglossary.514"></a><a href="#glo:alpha"><code class="csfmt">\alpha</code></a>}}</span>,
- <strong class="strong"><a id="wrglossary.515"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a><span class="optfmt">={alpha}</span></strong>,<a id="wrglossary.516"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a variable}</span>}
-<span class="comment">% an <a id="wrglossary.517"></a><a href="#glo:idx.acronym">acronym</a>:</span>
-<a id="wrglossary.518"></a><a href="#glo:setacronymstyle"><code class="csfmt">\setacronymstyle</code></a>{<a id="wrglossary.519"></a><a href="#glo:opt.acrstyle.short-long"><span class="acrstylefmt">short-long</span></a>}
-<a id="wrglossary.520"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a>{arpanet}{ARPANET}{Advanced Research Projects Agency Network}
+<a id="wrglossary.502"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{alpha}{<a id="wrglossary.503"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={<a id="wrglossary.504"></a><a href="#glo:ensuremath"><code class="csfmt">\ensuremath</code></a>{<a id="wrglossary.505"></a><a href="#glo:alpha"><code class="csfmt">\alpha</code></a>}}</span>,
+ <strong class="strong"><a id="wrglossary.506"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a><span class="optfmt">={alpha}</span></strong>,<a id="wrglossary.507"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a variable}</span>}
+<span class="comment">% an <a id="wrglossary.508"></a><a href="#glo:idx.acronym">acronym</a>:</span>
+<a id="wrglossary.509"></a><a href="#glo:setacronymstyle"><code class="csfmt">\setacronymstyle</code></a>{<a id="wrglossary.510"></a><a href="#glo:opt.acrstyle.short-long"><span class="acrstylefmt">short-long</span></a>}
+<a id="wrglossary.511"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a>{arpanet}{ARPANET}{Advanced Research Projects Agency Network}
<code class="cbeg">\begin{document}</code>
-<a id="wrglossary.521"></a><a href="#glo:Gls"><code class="csfmt">\Gls</code></a>{puffin}, <a id="wrglossary.522"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{duck} and <a id="wrglossary.523"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{parrot}.
-<a id="wrglossary.524"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{arpanet} and <a id="wrglossary.525"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{alpha}.
-Next use: <a id="wrglossary.526"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{arpanet}.
-<strong class="strong"><a id="wrglossary.527"></a><a href="#glo:printglossary"><code class="csfmt">\printglossary</code></a></strong>
+<a id="wrglossary.512"></a><a href="#glo:Gls"><code class="csfmt">\Gls</code></a>{puffin}, <a id="wrglossary.513"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{duck} and <a id="wrglossary.514"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{parrot}.
+<a id="wrglossary.515"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{arpanet} and <a id="wrglossary.516"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{alpha}.
+Next use: <a id="wrglossary.517"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{arpanet}.
+<strong class="strong"><a id="wrglossary.518"></a><a href="#glo:printglossary"><code class="csfmt">\printglossary</code></a></strong>
<code class="cend">\end{document}</code>
</pre>
You can place all your entry definitions in a separate file
-and load it in the <a id="wrglossary.528"></a><a href="#glo:idx.preamble/document">preamble</a> with <a id="wrglossary.529"></a><a href="#glo:loadglsentries"><code class="csfmt">\loadglsentries</code></a> (<span style="font-style: italic; font-variant: normal; ">after</span>
-<a id="wrglossary.530"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a>). The result is the same as for
+and load it in the <a id="wrglossary.519"></a><a href="#glo:idx.preamble/document">preamble</a> with <a id="wrglossary.520"></a><a href="#glo:loadglsentries"><code class="csfmt">\loadglsentries</code></a> (<span style="font-style: italic; font-variant: normal; ">after</span>
+<a id="wrglossary.521"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a>). The result is the same as for
Example <a href="#ex:noidx">3</a> and Example <a href="#ex:mkidx">4</a>.
<div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
<a href="#ex:xdy-backref"><span title="Up" class="icon">⭱</span></a><a id="ex:xdy"></a>Example 5: Simple document that uses <span class="appfmt">xindy</span> to sort entries <a href="glossaries-user-examples/glossaries-user-example005.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-user-examples/glossaries-user-example005.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a>
@@ -6536,63 +6535,63 @@
</div><!-- end of resultbox -->
<p>
-This option uses a <a id="wrglossary.531"></a><a href="#glo:dual.cli">CLI</a> application called
-<a id="wrglossary.532"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> to sort the entries. This application is more flexible than
-<a id="wrglossary.533"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> and is able to sort <a id="wrglossary.534"></a><a href="#glo:dual.exlatinalph">extended Latin alphabets</a> or
-<a id="wrglossary.535"></a><a href="#glo:dual.nonlatinalph">non-Latin alphabets</a>, however it does still have some limitations.
-(See Example <a href="#ex:xindyutf8">9</a> for an example with <a id="wrglossary.536"></a><a href="#glo:dual.utf8">UTF-8</a>
+This option uses a <a id="wrglossary.522"></a><a href="#glo:dual.cli">CLI</a> application called
+<a id="wrglossary.523"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> to sort the entries. This application is more flexible than
+<a id="wrglossary.524"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> and is able to sort <a id="wrglossary.525"></a><a href="#glo:dual.exlatinalph">extended Latin alphabets</a> or
+<a id="wrglossary.526"></a><a href="#glo:dual.nonlatinalph">non-Latin alphabets</a>, however it does still have some limitations.
+(See Example <a href="#ex:xindyutf8">9</a> for an example with <a id="wrglossary.527"></a><a href="#glo:dual.utf8">UTF-8</a>
characters.)
<p>
-The <a id="wrglossary.537"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> application comes with both TeX Live and
-MikTeX, but since <a id="wrglossary.538"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> is a Perl script, you will also need
+The <a id="wrglossary.528"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> application comes with both TeX Live and
+MikTeX, but since <a id="wrglossary.529"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> is a Perl script, you will also need
to install Perl, if you don’t already have it. In a similar way to
-<a id="wrglossary.539"></a><a href="#glo:idx.opt.mkidx">Option 2</a>, this option involves making LaTeX write the
-<a id="wrglossary.540"></a><a href="#glo:dual.glossary">glossary</a> information to a temporary file which <a id="wrglossary.541"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> reads. Then
-<a id="wrglossary.542"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> writes a new file containing the code to typeset the
-glossary. Then <a id="wrglossary.543"></a><a href="#glo:printglossary"><code class="csfmt">\printglossary</code></a> reads this file in on the next run.
+<a id="wrglossary.530"></a><a href="#glo:idx.opt.mkidx">Option 2</a>, this option involves making LaTeX write the
+<a id="wrglossary.531"></a><a href="#glo:dual.glossary">glossary</a> information to a temporary file which <a id="wrglossary.532"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> reads. Then
+<a id="wrglossary.533"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> writes a new file containing the code to typeset the
+glossary. Then <a id="wrglossary.534"></a><a href="#glo:printglossary"><code class="csfmt">\printglossary</code></a> reads this file in on the next run.
<p>
-This is the best option with just the base <a id="wrglossary.544"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a>
+This is the best option with just the base <a id="wrglossary.535"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a>
package if you want to sort according to a language other than
-English or if you want non-standard <a id="wrglossary.545"></a><a href="#glo:dual.locationlist">location lists</a>, but it can
+English or if you want non-standard <a id="wrglossary.536"></a><a href="#glo:dual.locationlist">location lists</a>, but it can
require some setting up (see §<a href="#sec:xindy">14</a>). There are
some problems with certain sort values:
<ul class="displaylist">
-<li><span class="bulletitem">•</span>entries with the same sort value are merged by <a id="wrglossary.546"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>
+<li><span class="bulletitem">•</span>entries with the same sort value are merged by <a id="wrglossary.537"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>
into a single glossary line so you must make sure that each entry
has a unique sort value;
-<li><span class="bulletitem">•</span><a id="wrglossary.547"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> forbids empty sort values;
-<li><span class="bulletitem">•</span><a id="wrglossary.548"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> automatically strips control sequences, the math-shift
-character <a id="wrglossary.549"></a><a href="#glo:idx.sym.dollar"><code class="code">$</code></a> and braces <a id="wrglossary.550"></a><a href="#glo:idx.sym.bg"><code class="code">{</code></a><a id="wrglossary.551"></a><a href="#glo:idx.sym.eg"><code class="code">}</code></a> from the sort value,
+<li><span class="bulletitem">•</span><a id="wrglossary.538"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> forbids empty sort values;
+<li><span class="bulletitem">•</span><a id="wrglossary.539"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> automatically strips control sequences, the math-shift
+character <a id="wrglossary.540"></a><a href="#glo:idx.sym.dollar"><code class="code">$</code></a> and braces <a id="wrglossary.541"></a><a href="#glo:idx.sym.bg"><code class="code">{</code></a><a id="wrglossary.542"></a><a href="#glo:idx.sym.eg"><code class="code">}</code></a> from the sort value,
which is usually desired but this can cause the sort value to
-collapse to an empty string which <a id="wrglossary.552"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> forbids.
+collapse to an empty string which <a id="wrglossary.543"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> forbids.
</ul>
-In these problematic cases, you must set the <a id="wrglossary.553"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a> field
+In these problematic cases, you must set the <a id="wrglossary.544"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a> field
explicitly, as in the above example which has:
-<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.554"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{alpha}{<a id="wrglossary.555"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={<a id="wrglossary.556"></a><a href="#glo:ensuremath"><code class="csfmt">\ensuremath</code></a>{<a id="wrglossary.557"></a><a href="#glo:alpha"><code class="csfmt">\alpha</code></a>}}</span>,
- <strong class="strong"><a id="wrglossary.558"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a><span class="optfmt">={alpha}</span>,</strong><a id="wrglossary.559"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a variable}</span>
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.545"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{alpha}{<a id="wrglossary.546"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={<a id="wrglossary.547"></a><a href="#glo:ensuremath"><code class="csfmt">\ensuremath</code></a>{<a id="wrglossary.548"></a><a href="#glo:alpha"><code class="csfmt">\alpha</code></a>}}</span>,
+ <strong class="strong"><a id="wrglossary.549"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a><span class="optfmt">={alpha}</span>,</strong><a id="wrglossary.550"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a variable}</span>
}
</pre>
-<div class="information"><div class="informationtitle"><a id="wrglossary.560"></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.551"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a></div><!-- end of informationtitle -->
-The <a id="wrglossary.561"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package has a modified <a id="wrglossary.562"></a><a href="#glo:opt.symbols"><span class="styoptfmt">symbols</span></a>
-package option that provides <a id="wrglossary.563"></a><a href="#glo:glsxtrnewsymbol"><code class="xtrcsfmt">\glsxtrnewsymbol</code></a>, which automatically sets the
-<a id="wrglossary.564"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a> key to the entry label (instead of the <a id="wrglossary.565"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a>).
+The <a id="wrglossary.552"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package has a modified <a id="wrglossary.553"></a><a href="#glo:opt.symbols"><span class="styoptfmt">symbols</span></a>
+package option that provides <a id="wrglossary.554"></a><a href="#glo:glsxtrnewsymbol"><code class="xtrcsfmt">\glsxtrnewsymbol</code></a>, which automatically sets the
+<a id="wrglossary.555"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a> key to the entry label (instead of the <a id="wrglossary.556"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a>).
</div><!-- end of information -->
<p>
-All <a id="wrglossary.566"></a><a href="#glo:dual.glossary">glossaries</a> must be sorted according to the same method
+All <a id="wrglossary.557"></a><a href="#glo:dual.glossary">glossaries</a> must be sorted according to the same method
(word/letter ordering, order of use, or order of definition).
<p>
-<div class="information"><div class="informationtitle"><a id="wrglossary.567"></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.558"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a></div><!-- end of informationtitle -->
-The <a id="wrglossary.568"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package allows a hybrid mix of
+The <a id="wrglossary.559"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package allows a hybrid mix of
Options <a href="#glo:idx.opt.noidx">1</a> and <a href="#glo:idx.opt.xdy">3</a> to provide word/letter ordering with
-<a id="wrglossary.569"></a><a href="#glo:idx.opt.xdy">Option 3</a> and order of use/definition with <a id="wrglossary.570"></a><a href="#glo:idx.opt.mkidx">Option 2</a>.
-See the <a id="wrglossary.571"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> documentation for further details.
+<a id="wrglossary.560"></a><a href="#glo:idx.opt.xdy">Option 3</a> and order of use/definition with <a id="wrglossary.561"></a><a href="#glo:idx.opt.mkidx">Option 2</a>.
+See the <a id="wrglossary.562"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> documentation for further details.
</div><!-- end of information -->
<p>
@@ -6600,76 +6599,76 @@
<ol class="displaylist">
-<li><span class="numitem">1.</span>Add the <a id="wrglossary.572"></a><a href="#glo:opt.xindy"><span class="styoptfmt">xindy</span></a> option to the <a id="wrglossary.573"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a>
+<li><span class="numitem">1.</span>Add the <a id="wrglossary.563"></a><a href="#glo:opt.xindy"><span class="styoptfmt">xindy</span></a> option to the <a id="wrglossary.564"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a>
package option list:
-<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\usepackage</code>[<a id="wrglossary.574"></a><a href="#glo:opt.xindy"><span class="styoptfmt">xindy</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.565"></a><a href="#glo:opt.xindy"><span class="styoptfmt">xindy</span></a>]{glossaries}
</pre>
If you are using a non-Latin script you’ll also need to either
-switch off the creation of the number <a id="wrglossary.575"></a><a href="#glo:idx.group">group</a>:
-<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\usepackage</code>[<a id="wrglossary.576"></a><a href="#glo:opt.xindy"><span class="styoptfmt">xindy</span></a><span class="optfmt">={<a id="wrglossary.577"></a><a href="#glo:opt.xindy.glsnumbers"><span class="optfmt">glsnumbers</span></a><span class="optfmt">=false</span>}</span>]{glossaries}
+switch off the creation of the number <a id="wrglossary.566"></a><a href="#glo:idx.group">group</a>:
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\usepackage</code>[<a id="wrglossary.567"></a><a href="#glo:opt.xindy"><span class="styoptfmt">xindy</span></a><span class="optfmt">={<a id="wrglossary.568"></a><a href="#glo:opt.xindy.glsnumbers"><span class="optfmt">glsnumbers</span></a><span class="optfmt">=false</span>}</span>]{glossaries}
</pre>
-or use either <code class="code"><a id="wrglossary.578"></a><a href="#glo:GlsSetXdyFirstLetterAfterDigits"><code class="csfmt">\GlsSetXdyFirstLetterAfterDigits</code></a>{<span class="meta">〈<em class="metainner">letter</em>〉</span>}</code> (to indicate the
-first <a id="wrglossary.579"></a><a href="#glo:idx.group">letter group</a> to follow the digits) or
-<code class="code"><a id="wrglossary.580"></a><a href="#glo:GlsSetXdyNumberGroupOrder"><code class="csfmt">\GlsSetXdyNumberGroupOrder</code></a>{<span class="meta">〈<em class="metainner">spec</em>〉</span>}</code> to indicate where the number
-<a id="wrglossary.581"></a><a href="#glo:idx.group">group</a> should be placed (see §<a href="#sec:xindy">14</a>).
+or use either <code class="code"><a id="wrglossary.569"></a><a href="#glo:GlsSetXdyFirstLetterAfterDigits"><code class="csfmt">\GlsSetXdyFirstLetterAfterDigits</code></a>{<span class="meta">〈<em class="metainner">letter</em>〉</span>}</code> (to indicate the
+first <a id="wrglossary.570"></a><a href="#glo:idx.group">letter group</a> to follow the digits) or
+<code class="code"><a id="wrglossary.571"></a><a href="#glo:GlsSetXdyNumberGroupOrder"><code class="csfmt">\GlsSetXdyNumberGroupOrder</code></a>{<span class="meta">〈<em class="metainner">spec</em>〉</span>}</code> to indicate where the number
+<a id="wrglossary.572"></a><a href="#glo:idx.group">group</a> should be placed (see §<a href="#sec:xindy">14</a>).
<p>
-<li><span class="numitem">2.</span>Add <a id="wrglossary.582"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a> to your <a id="wrglossary.583"></a><a href="#glo:idx.preamble/document">preamble</a> (before you start
+<li><span class="numitem">2.</span>Add <a id="wrglossary.573"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a> to your <a id="wrglossary.574"></a><a href="#glo:idx.preamble/document">preamble</a> (before you start
defining your entries, as described in §<a href="#sec:newglosentry">4</a>).
<p>
<li><span class="numitem">3.</span>Run LaTeX on your document. This creates files with the
-extensions <a id="wrglossary.584"></a><a href="#glo:ext.glo"><span class="extfmt">glo</span></a> and <a id="wrglossary.585"></a><a href="#glo:ext.xdy"><span class="extfmt">xdy</span></a> (for example, if your
+extensions <a id="wrglossary.575"></a><a href="#glo:ext.glo"><span class="extfmt">glo</span></a> and <a id="wrglossary.576"></a><a href="#glo:ext.xdy"><span class="extfmt">xdy</span></a> (for example, if your
LaTeX document is called <span class="filefmt">myDoc.tex</span>, then you’ll have
two extra files called <span class="filefmt">myDoc.glo</span> and <span class="filefmt">myDoc.xdy</span>).
If you look at your document at this point, you won’t see the
glossary as it hasn’t been created yet. (If you’re using the
-<a id="wrglossary.586"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> extension package, you’ll see the section
+<a id="wrglossary.577"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> extension package, you’ll see the section
header and some boilerplate text.)
<p>
-If you have used package options such as <a id="wrglossary.587"></a><a href="#glo:opt.symbols"><span class="styoptfmt">symbols</span></a> there
+If you have used package options such as <a id="wrglossary.578"></a><a href="#glo:opt.symbols"><span class="styoptfmt">symbols</span></a> there
will also be other sets of files corresponding to the extra
glossaries that were created by those options.
<p>
-<li><span class="numitem">4.</span>Run <a id="wrglossary.588"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> with the <a id="wrglossary.589"></a><a href="#glo:ext.glo"><span class="extfmt">glo</span></a> file as the
-input file and the <a id="wrglossary.590"></a><a href="#glo:ext.xdy"><span class="extfmt">xdy</span></a> file as a module so that
-it creates an output file with the extension <a id="wrglossary.591"></a><a href="#glo:ext.gls"><span class="extfmt">gls</span></a>. You
-also need to set the language name and input <a id="wrglossary.592"></a><a href="#glo:idx.encoding">encoding</a>, as follows (all on one
+<li><span class="numitem">4.</span>Run <a id="wrglossary.579"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> with the <a id="wrglossary.580"></a><a href="#glo:ext.glo"><span class="extfmt">glo</span></a> file as the
+input file and the <a id="wrglossary.581"></a><a href="#glo:ext.xdy"><span class="extfmt">xdy</span></a> file as a module so that
+it creates an output file with the extension <a id="wrglossary.582"></a><a href="#glo:ext.gls"><span class="extfmt">gls</span></a>. You
+also need to set the language name and input <a id="wrglossary.583"></a><a href="#glo:idx.encoding">encoding</a>, as follows (all on one
line):
-<pre class="terminal"><div class="terminaltitle"><a href="#glo:sym.terminal"><span title="Terminal" class="icon">〉_</span></a></div>xindy <a id="wrglossary.593"></a><a href="#glo:switch.xdy.L"><span class="shortargfmt">-L</span></a> english <a id="wrglossary.594"></a><a href="#glo:switch.xdy.C"><span class="shortargfmt">-C</span></a> utf8 <a id="wrglossary.595"></a><a href="#glo:switch.xdy.I"><span class="shortargfmt">-I</span></a> xindy <a id="wrglossary.596"></a><a href="#glo:switch.xdy.M"><span class="shortargfmt">-M</span></a> myDoc <a id="wrglossary.597"></a><a href="#glo:switch.xdy.t"><span class="shortargfmt">-t</span></a> myDoc.glg <a id="wrglossary.598"></a><a href="#glo:switch.xdy.o"><span class="shortargfmt">-o</span></a> myDoc.gls myDoc.glo
+<pre class="terminal"><div class="terminaltitle"><a href="#glo:sym.terminal"><span title="Terminal" class="icon">〉_</span></a></div>xindy <a id="wrglossary.584"></a><a href="#glo:switch.xdy.L"><span class="shortargfmt">-L</span></a> english <a id="wrglossary.585"></a><a href="#glo:switch.xdy.C"><span class="shortargfmt">-C</span></a> utf8 <a id="wrglossary.586"></a><a href="#glo:switch.xdy.I"><span class="shortargfmt">-I</span></a> xindy <a id="wrglossary.587"></a><a href="#glo:switch.xdy.M"><span class="shortargfmt">-M</span></a> myDoc <a id="wrglossary.588"></a><a href="#glo:switch.xdy.t"><span class="shortargfmt">-t</span></a> myDoc.glg <a id="wrglossary.589"></a><a href="#glo:switch.xdy.o"><span class="shortargfmt">-o</span></a> myDoc.gls myDoc.glo
</pre>
(Replace <code class="code">myDoc</code> with the base name of your LaTeX document file. Avoid spaces in the file name. If necessary, also replace
<code class="code">english</code> with the name of your language and <code class="code">utf8</code>
-with your input <a id="wrglossary.599"></a><a href="#glo:idx.encoding">encoding</a>, for example,
-<code class="code"><a id="wrglossary.600"></a><a href="#glo:switch.xdy.L"><span class="shortargfmt">-L</span></a> german <a id="wrglossary.601"></a><a href="#glo:switch.xdy.C"><span class="shortargfmt">-C</span></a> din5007-utf8</code>.)
+with your input <a id="wrglossary.590"></a><a href="#glo:idx.encoding">encoding</a>, for example,
+<code class="code"><a id="wrglossary.591"></a><a href="#glo:switch.xdy.L"><span class="shortargfmt">-L</span></a> german <a id="wrglossary.592"></a><a href="#glo:switch.xdy.C"><span class="shortargfmt">-C</span></a> din5007-utf8</code>.)
<p>
<div class="important"><div class="importanttitle"><a href="#glo:sym.important"><span title="Important" class="icon">ℹ</span></a></div><!-- end of importanttitle -->
-The file extensions vary according to the glossary <a id="wrglossary.602"></a><a href="#glo:opt.gloskey.type"><span class="csoptfmt">type</span></a>.
+The file extensions vary according to the glossary <a id="wrglossary.593"></a><a href="#glo:opt.gloskey.type"><span class="csoptfmt">type</span></a>.
See §<a href="#sec:xindyapp">1.6.3</a> for further details.
-<a id="wrglossary.603"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> must be called for each set of files.
+<a id="wrglossary.594"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> must be called for each set of files.
</div><!-- end of important -->
<p>
-It’s much simpler to use <a id="wrglossary.604"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> instead:
+It’s much simpler to use <a id="wrglossary.595"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> instead:
<pre class="terminal"><div class="terminaltitle"><a href="#glo:sym.terminal"><span title="Terminal" class="icon">〉_</span></a></div>makeglossaries myDoc
</pre>
Note that the file extension isn’t supplied in this case.
This will pick up all the file extensions from the
-<a id="wrglossary.605"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> file and run <a id="wrglossary.606"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> the appropriate number
+<a id="wrglossary.596"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> file and run <a id="wrglossary.597"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> the appropriate number
of times with all the necessary switches.
<p>
-There’s no benefit in using <a id="wrglossary.607"></a><a href="#glo:app.makeglossaries-lite"><span class="appfmt">makeglossaries-lite</span></a> with <a id="wrglossary.608"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>.
-(Remember that <a id="wrglossary.609"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> is a Perl script so if you can use
-<a id="wrglossary.610"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> then you can also use <a id="wrglossary.611"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a>, and if
-you don’t want to use <a id="wrglossary.612"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> because you don’t
-want to install Perl, then you can’t use <a id="wrglossary.613"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> either.)
+There’s no benefit in using <a id="wrglossary.598"></a><a href="#glo:app.makeglossaries-lite"><span class="appfmt">makeglossaries-lite</span></a> with <a id="wrglossary.599"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>.
+(Remember that <a id="wrglossary.600"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> is a Perl script so if you can use
+<a id="wrglossary.601"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> then you can also use <a id="wrglossary.602"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a>, and if
+you don’t want to use <a id="wrglossary.603"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> because you don’t
+want to install Perl, then you can’t use <a id="wrglossary.604"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> either.)
If you don’t know how to use the command prompt, then you can
-probably access <a id="wrglossary.614"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> or <a id="wrglossary.615"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> via your text editor,
+probably access <a id="wrglossary.605"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> or <a id="wrglossary.606"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> via your text editor,
but each editor has a different method of doing this. See
<a href="https://www.dickimaw-books.com/latex/buildglossaries/">Incorporating
makeglossaries or makeglossaries-lite or bib2gls into the document
build</a> for some examples.
<p>
-Again, a convenient method is to use <a id="wrglossary.616"></a><a href="#glo:app.arara"><span class="appfmt">arara</span></a> and add the follow comment
+Again, a convenient method is to use <a id="wrglossary.607"></a><a href="#glo:app.arara"><span class="appfmt">arara</span></a> and add the follow comment
lines to the start of your document:
<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div>% arara: pdflatex
% arara: makeglossaries
@@ -6678,18 +6677,18 @@
<p>
The default sort is word order (<span class="qt">“sea lion”</span> comes before <span class="qt">“seal”</span>).
If you want letter ordering you need to add the
-<a id="wrglossary.617"></a><a href="#glo:opt.order"><span class="styoptfmt">order</span></a><span class="optfmt">=letter</span> package option:
-<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\usepackage</code>[<a id="wrglossary.618"></a><a href="#glo:opt.xindy"><span class="styoptfmt">xindy</span></a>,<a id="wrglossary.619"></a><a href="#glo:opt.order"><span class="styoptfmt">order</span></a><span class="optfmt">=letter</span>]{glossaries}
+<a id="wrglossary.608"></a><a href="#glo:opt.order"><span class="styoptfmt">order</span></a><span class="optfmt">=letter</span> package option:
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\usepackage</code>[<a id="wrglossary.609"></a><a href="#glo:opt.xindy"><span class="styoptfmt">xindy</span></a>,<a id="wrglossary.610"></a><a href="#glo:opt.order"><span class="styoptfmt">order</span></a><span class="optfmt">=letter</span>]{glossaries}
</pre>
(and return to the previous step). This option is picked up
-by <a id="wrglossary.620"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a>. If you are explicitly using <a id="wrglossary.621"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>
-then you’ll need to add <code class="code"><a id="wrglossary.622"></a><a href="#glo:switch.xdy.M"><span class="shortargfmt">-M</span></a> ord/letorder</code> to the options list.
+by <a id="wrglossary.611"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a>. If you are explicitly using <a id="wrglossary.612"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>
+then you’ll need to add <code class="code"><a id="wrglossary.613"></a><a href="#glo:switch.xdy.M"><span class="shortargfmt">-M</span></a> ord/letorder</code> to the options list.
See §<a href="#sec:xindyapp">1.6.3</a> for further details on using
-<a id="wrglossary.623"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> explicitly.
+<a id="wrglossary.614"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> explicitly.
<p>
<li><span class="numitem">5.</span>Once you have successfully completed the previous step,
you can now run LaTeX on your document again. As with
-<a id="wrglossary.624"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> (<a id="wrglossary.625"></a><a href="#glo:idx.opt.mkidx">Option 2</a>), you may need to repeat the previous
+<a id="wrglossary.615"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> (<a id="wrglossary.616"></a><a href="#glo:idx.opt.mkidx">Option 2</a>), you may need to repeat the previous
step and this step to ensure the table of contents and cross-references are resolved.
<p>
@@ -6700,63 +6699,63 @@
</section><!-- end of section option3 -->
<section id="option4"><!-- start of section option4 --><div class="tomain"><a href="#main">[top]</a></div>
-<h3><!-- start of subsection header -->1.3.4. <a id="wrglossary.626"></a><dfn id="glo:idx.opt.b2g">Option 4 (<span class="appfmt">bib2gls</span>)</dfn><span class="labellink"><a href="#option4">[link]</a></span></h3><!-- end of subsection header -->
+<h3><!-- start of subsection header -->1.3.4. <a id="wrglossary.617"></a><dfn id="glo:idx.opt.b2g">Option 4 (<span class="appfmt">bib2gls</span>)</dfn><span class="labellink"><a href="#option4">[link]</a></span></h3><!-- end of subsection header -->
<p>
-<div class="sidenote"><a id="wrglossary.627"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a></div><span class="clearfix"></span><!-- end of sidenote -->
-<a id="wrglossary.628"></a>This option is only available with the
-<a id="wrglossary.629"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> extension package. This method uses
-<a id="wrglossary.630"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> to both fetch <a id="wrglossary.631"></a><a href="#glo:idx.glossaryentry">entry</a> definitions from <a id="wrglossary.632"></a><a href="#glo:ext.bib"><span class="extfmt">bib</span></a> files
-and to hierarchically sort and collate. The <a id="wrglossary.633"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>
+<div class="sidenote"><a id="wrglossary.618"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a></div><span class="clearfix"></span><!-- end of sidenote -->
+<a id="wrglossary.619"></a>This option is only available with the
+<a id="wrglossary.620"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> extension package. This method uses
+<a id="wrglossary.621"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> to both fetch <a id="wrglossary.622"></a><a href="#glo:idx.glossaryentry">entry</a> definitions from <a id="wrglossary.623"></a><a href="#glo:ext.bib"><span class="extfmt">bib</span></a> files
+and to hierarchically sort and collate. The <a id="wrglossary.624"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>
application is designed specifically for, and developed alongside, the
-<a id="wrglossary.634"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package.
+<a id="wrglossary.625"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package.
<p>
-<div class="marginright"><a id="ex:b2g-backref">🖹</a><a href="#ex:b2g">6</a></div>Example <a href="#ex:b2g">6</a> demonstrates a simple document that requires <a id="wrglossary.635"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>:
+<div class="marginright"><a id="ex:b2g-backref">🖹</a><a href="#ex:b2g">6</a></div>Example <a href="#ex:b2g">6</a> demonstrates a simple document that requires <a id="wrglossary.626"></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><code class="cmd">\documentclass</code>{article}
-<code class="cmd">\usepackage</code>[<strong class="strong"><a id="wrglossary.636"></a><a href="#glo:opt.record"><span class="xtrstyoptfmt">record</span></a></strong>,<a id="wrglossary.637"></a><a href="#glo:opt.style"><span class="styoptfmt">style</span></a><span class="optfmt">=<a id="wrglossary.638"></a><a href="#glo:opt.glostyle.indexgroup"><span class="glostylefmt">indexgroup</span></a></span>]{<strong class="strong">glossaries-extra</strong>}
-<a id="wrglossary.639"></a><a href="#glo:setabbreviationstyle"><code class="xtrcsfmt">\setabbreviationstyle</code></a>{<a id="wrglossary.640"></a><a href="#glo:opt.abbrstyle.short-long"><span class="abbrstylefmt">short-long</span></a>}
+<code class="cmd">\usepackage</code>[<strong class="strong"><a id="wrglossary.627"></a><a href="#glo:opt.record"><span class="xtrstyoptfmt">record</span></a></strong>,<a id="wrglossary.628"></a><a href="#glo:opt.style"><span class="styoptfmt">style</span></a><span class="optfmt">=<a id="wrglossary.629"></a><a href="#glo:opt.glostyle.indexgroup"><span class="glostylefmt">indexgroup</span></a></span>]{<strong class="strong">glossaries-extra</strong>}
+<a id="wrglossary.630"></a><a href="#glo:setabbreviationstyle"><code class="xtrcsfmt">\setabbreviationstyle</code></a>{<a id="wrglossary.631"></a><a href="#glo:opt.abbrstyle.short-long"><span class="abbrstylefmt">short-long</span></a>}
<span class="comment">% data in sample-entries.bib:</span>
-<strong class="strong"><a id="wrglossary.641"></a><a href="#glo:GlsXtrLoadResources"><code class="xtrcsfmt">\GlsXtrLoadResources</code></a></strong>[<a id="wrglossary.642"></a><a href="#glo:opt.resource.src"><span class="xtrcsoptfmt">src</span></a><span class="optfmt">={sample-entries}</span>]
+<strong class="strong"><a id="wrglossary.632"></a><a href="#glo:GlsXtrLoadResources"><code class="xtrcsfmt">\GlsXtrLoadResources</code></a></strong>[<a id="wrglossary.633"></a><a href="#glo:opt.resource.src"><span class="xtrcsoptfmt">src</span></a><span class="optfmt">={sample-entries}</span>]
<code class="cbeg">\begin{document}</code>
-<a id="wrglossary.643"></a><a href="#glo:Gls"><code class="csfmt">\Gls</code></a>{puffin}, <a id="wrglossary.644"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{duck} and <a id="wrglossary.645"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{parrot}.
-<a id="wrglossary.646"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{arpanet} and <a id="wrglossary.647"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{alpha}.
-Next use: <a id="wrglossary.648"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{arpanet}.
-<strong class="strong"><a id="wrglossary.649"></a><a href="#glo:printunsrtglossary"><code class="xtrcsfmt">\printunsrtglossary</code></a></strong>
+<a id="wrglossary.634"></a><a href="#glo:Gls"><code class="csfmt">\Gls</code></a>{puffin}, <a id="wrglossary.635"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{duck} and <a id="wrglossary.636"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{parrot}.
+<a id="wrglossary.637"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{arpanet} and <a id="wrglossary.638"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{alpha}.
+Next use: <a id="wrglossary.639"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{arpanet}.
+<strong class="strong"><a id="wrglossary.640"></a><a href="#glo:printunsrtglossary"><code class="xtrcsfmt">\printunsrtglossary</code></a></strong>
<code class="cend">\end{document}</code>
</pre>
-Note that the <a id="wrglossary.650"></a><a href="#glo:idx.abbrvstyle"><span class="xtrfmt">abbreviation</span> style</a> must be set before <a id="wrglossary.651"></a><a href="#glo:GlsXtrLoadResources"><code class="xtrcsfmt">\GlsXtrLoadResources</code></a>.
+Note that the <a id="wrglossary.641"></a><a href="#glo:idx.abbrvstyle"><span class="xtrfmt">abbreviation</span> style</a> must be set before <a id="wrglossary.642"></a><a href="#glo:GlsXtrLoadResources"><code class="xtrcsfmt">\GlsXtrLoadResources</code></a>.
The file <span class="filefmt">sample-entries.bib</span> contains:
<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="code">@entry</code>{parrot,
- <a id="wrglossary.652"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={parrot}</span>,
- <a id="wrglossary.653"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a brightly coloured tropical bird}</span>
+ <a id="wrglossary.643"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={parrot}</span>,
+ <a id="wrglossary.644"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a brightly coloured tropical bird}</span>
}
<code class="code">@entry</code>{duck,
- <a id="wrglossary.654"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={duck}</span>,
- <a id="wrglossary.655"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a waterbird}</span>
+ <a id="wrglossary.645"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={duck}</span>,
+ <a id="wrglossary.646"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a waterbird}</span>
}
<code class="code">@entry</code>{puffin,
- <a id="wrglossary.656"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={puffin}</span>,
- <a id="wrglossary.657"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a seabird with a brightly
+ <a id="wrglossary.647"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={puffin}</span>,
+ <a id="wrglossary.648"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a seabird with a brightly
coloured bill}</span>
}
<code class="code">@entry</code>{penguin,
- <a id="wrglossary.658"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={penguin}</span>,
- <a id="wrglossary.659"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a flightless black and white seabird}</span>
+ <a id="wrglossary.649"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={penguin}</span>,
+ <a id="wrglossary.650"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a flightless black and white seabird}</span>
}
<code class="code">@symbol</code>{alpha,
- <a id="wrglossary.660"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={<a id="wrglossary.661"></a><a href="#glo:ensuremath"><code class="csfmt">\ensuremath</code></a>{<a id="wrglossary.662"></a><a href="#glo:alpha"><code class="csfmt">\alpha</code></a>}}</span>,
- <a id="wrglossary.663"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a variable}</span>
+ <a id="wrglossary.651"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={<a id="wrglossary.652"></a><a href="#glo:ensuremath"><code class="csfmt">\ensuremath</code></a>{<a id="wrglossary.653"></a><a href="#glo:alpha"><code class="csfmt">\alpha</code></a>}}</span>,
+ <a id="wrglossary.654"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a variable}</span>
}
<code class="code">@abbreviation</code>{arpanet,
- <a id="wrglossary.664"></a><a href="#glo:opt.gloskey.short"><span class="csoptfmt">short</span></a><span class="optfmt">={ARPANET}</span>,
- <a id="wrglossary.665"></a><a href="#glo:opt.gloskey.long"><span class="csoptfmt">long</span></a><span class="optfmt">={Advanced Research Projects Agency Network}</span>
+ <a id="wrglossary.655"></a><a href="#glo:opt.gloskey.short"><span class="csoptfmt">short</span></a><span class="optfmt">={ARPANET}</span>,
+ <a id="wrglossary.656"></a><a href="#glo:opt.gloskey.long"><span class="csoptfmt">long</span></a><span class="optfmt">={Advanced Research Projects Agency Network}</span>
}
</pre>
The result is slightly different from the previous examples. Letter
-groups aren’t created by default with <a id="wrglossary.666"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> so, even though
-the <a id="wrglossary.667"></a><a href="#glo:idx.glossarystyle">glossary style</a> supports <a id="wrglossary.668"></a><a href="#glo:idx.group">letter groups</a>, there’s no
-<a id="wrglossary.669"></a><a href="#glo:idx.group">group</a> information. This can be added by invoking <a id="wrglossary.670"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>
-with the <a id="wrglossary.671"></a><a href="#glo:switch.group"><span class="longargfmt">--group</span></a> switch.
+groups aren’t created by default with <a id="wrglossary.657"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> so, even though
+the <a id="wrglossary.658"></a><a href="#glo:idx.glossarystyle">glossary style</a> supports <a id="wrglossary.659"></a><a href="#glo:idx.group">letter groups</a>, there’s no
+<a id="wrglossary.660"></a><a href="#glo:idx.group">group</a> information. This can be added by invoking <a id="wrglossary.661"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>
+with the <a id="wrglossary.662"></a><a href="#glo:switch.group"><span class="longargfmt">--group</span></a> switch.
<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:b2g-backref"><span title="Up" class="icon">⭱</span></a><a id="ex:b2g"></a>Example 6: Simple document that uses <span class="appfmt">bib2gls</span> to sort entries <a href="glossaries-user-examples/glossaries-user-example006.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-user-examples/glossaries-user-example006.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a>
<p>
@@ -6767,66 +6766,66 @@
</div><!-- end of resultbox -->
<p>
-All entries must be provided in one or more <a id="wrglossary.672"></a><a href="#glo:ext.bib"><span class="extfmt">bib</span></a> files.
-(See the <a id="wrglossary.673"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> user manual for the required format.)
+All entries must be provided in one or more <a id="wrglossary.663"></a><a href="#glo:ext.bib"><span class="extfmt">bib</span></a> files.
+(See the <a id="wrglossary.664"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> user manual for the required format.)
In this example, the terms <span class="qt">“parrot”</span>, <span class="qt">“duck”</span>, <span class="qt">“puffin”</span> and
<span class="qt">“penguin”</span> are defined using <code class="code">@atentry</code>, the symbol alpha
-(\(\alpha \)) is defined using <code class="code">@symbol</code> and the <a id="wrglossary.674"></a><a href="#glo:idx.abbreviation"><span class="xtrfmt">abbreviation</span></a>
+(\(\alpha \)) is defined using <code class="code">@symbol</code> and the <a id="wrglossary.665"></a><a href="#glo:idx.abbreviation"><span class="xtrfmt">abbreviation</span></a>
<span class="qt">“ARPANET”</span> is defined using <code class="code">@abbreviation</code>.
-See Example <a href="#ex:bib2glsutf8">10</a> for an example with <a id="wrglossary.675"></a><a href="#glo:dual.utf8">UTF-8</a>
+See Example <a href="#ex:bib2glsutf8">10</a> for an example with <a id="wrglossary.666"></a><a href="#glo:dual.utf8">UTF-8</a>
content.
<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.676"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a> key should not be used. Each entry type
+Note that the <a id="wrglossary.667"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a> key should not be used. Each entry type
(<code class="code">@entry</code>, <code class="code">@symbol</code>, <code class="code">@abbreviation</code>) has a
particular field that’s used for the sort value by default
-(<a id="wrglossary.677"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a>, the label, <a id="wrglossary.678"></a><a href="#glo:opt.gloskey.short"><span class="csoptfmt">short</span></a>). You will break this
-mechanism if you explicitly use the <a id="wrglossary.679"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a> key. See
+(<a id="wrglossary.668"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a>, the label, <a id="wrglossary.669"></a><a href="#glo:opt.gloskey.short"><span class="csoptfmt">short</span></a>). You will break this
+mechanism if you explicitly use the <a id="wrglossary.670"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a> key. See
<a href="https://www.dickimaw-books.com/gallery/index.php?label=bib2gls-sorting"><span class="appfmt">bib2gls</span> gallery: sorting</a> for examples.
</div><!-- end of important -->
<p>
-The <a id="wrglossary.680"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package needs to be loaded with the
-<a id="wrglossary.681"></a><a href="#glo:opt.record"><span class="xtrstyoptfmt">record</span></a> package option:
-<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\usepackage</code>[<a id="wrglossary.682"></a><a href="#glo:opt.record"><span class="xtrstyoptfmt">record</span></a>]{glossaries-extra}
+The <a id="wrglossary.671"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package needs to be loaded with the
+<a id="wrglossary.672"></a><a href="#glo:opt.record"><span class="xtrstyoptfmt">record</span></a> package option:
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\usepackage</code>[<a id="wrglossary.673"></a><a href="#glo:opt.record"><span class="xtrstyoptfmt">record</span></a>]{glossaries-extra}
</pre>
or (equivalently)
-<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\usepackage</code>[<a id="wrglossary.683"></a><a href="#glo:opt.record"><span class="xtrstyoptfmt">record</span></a><span class="optfmt">=only</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.674"></a><a href="#glo:opt.record"><span class="xtrstyoptfmt">record</span></a><span class="optfmt">=only</span>]{glossaries-extra}
</pre>
-or (with <a id="wrglossary.684"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.37+ and <a id="wrglossary.685"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> v1.8+):
-<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\usepackage</code>[<a id="wrglossary.686"></a><a href="#glo:opt.record"><span class="xtrstyoptfmt">record</span></a><span class="optfmt">=nameref</span>]{glossaries-extra}
+or (with <a id="wrglossary.675"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.37+ and <a id="wrglossary.676"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> v1.8+):
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\usepackage</code>[<a id="wrglossary.677"></a><a href="#glo:opt.record"><span class="xtrstyoptfmt">record</span></a><span class="optfmt">=nameref</span>]{glossaries-extra}
</pre>
-The <a id="wrglossary.687"></a><a href="#glo:opt.record"><span class="xtrstyoptfmt">record</span></a><span class="optfmt">=nameref</span> option is the best method if you are
-using <a id="wrglossary.688"></a><a href="#glo:pkg.hyperref"><span class="styfmt">hyperref</span></a>.
+The <a id="wrglossary.678"></a><a href="#glo:opt.record"><span class="xtrstyoptfmt">record</span></a><span class="optfmt">=nameref</span> option is the best method if you are
+using <a id="wrglossary.679"></a><a href="#glo:pkg.hyperref"><span class="styfmt">hyperref</span></a>.
<p>
-Each resource set is loaded with <a id="wrglossary.689"></a><a href="#glo:GlsXtrLoadResources"><code class="xtrcsfmt">\GlsXtrLoadResources</code></a>.
+Each resource set is loaded with <a id="wrglossary.680"></a><a href="#glo:GlsXtrLoadResources"><code class="xtrcsfmt">\GlsXtrLoadResources</code></a>.
For example:
-<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.690"></a><a href="#glo:GlsXtrLoadResources"><code class="xtrcsfmt">\GlsXtrLoadResources</code></a>
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.681"></a><a href="#glo:GlsXtrLoadResources"><code class="xtrcsfmt">\GlsXtrLoadResources</code></a>
[<span class="comment">% definitions in entries1.bib and entries2.bib:</span>
- <a id="wrglossary.691"></a><a href="#glo:opt.resource.src"><span class="xtrcsoptfmt">src</span></a><span class="optfmt">={entries1,entries2}</span>,
- <a id="wrglossary.692"></a><a href="#glo:opt.resource.sort"><span class="xtrcsoptfmt">sort</span></a><span class="optfmt">={de-CH-1996}</span><span class="comment">% sort according to this locale</span>
+ <a id="wrglossary.682"></a><a href="#glo:opt.resource.src"><span class="xtrcsoptfmt">src</span></a><span class="optfmt">={entries1,entries2}</span>,
+ <a id="wrglossary.683"></a><a href="#glo:opt.resource.sort"><span class="xtrcsoptfmt">sort</span></a><span class="optfmt">={de-CH-1996}</span><span class="comment">% sort according to this locale</span>
]
</pre>
-The <a id="wrglossary.693"></a><a href="#glo:ext.bib"><span class="extfmt">bib</span></a> files are identified as a comma-separated list in the
-value of the <a id="wrglossary.694"></a><a href="#glo:opt.resource.src"><span class="xtrcsoptfmt">src</span></a> key. The <a id="wrglossary.695"></a><a href="#glo:opt.resource.sort"><span class="xtrcsoptfmt">sort</span></a> option
+The <a id="wrglossary.684"></a><a href="#glo:ext.bib"><span class="extfmt">bib</span></a> files are identified as a comma-separated list in the
+value of the <a id="wrglossary.685"></a><a href="#glo:opt.resource.src"><span class="xtrcsoptfmt">src</span></a> key. The <a id="wrglossary.686"></a><a href="#glo:opt.resource.sort"><span class="xtrcsoptfmt">sort</span></a> option
identifies the sorting method. This may be a locale identifier for
alphabetic sorting, but there are other sort methods available, such
as character code or numeric. One resource set may cover multiple
-<a id="wrglossary.696"></a><a href="#glo:dual.glossary">glossaries</a> or one <a id="wrglossary.697"></a><a href="#glo:dual.glossary">glossary</a> may be split across multiple resource
+<a id="wrglossary.687"></a><a href="#glo:dual.glossary">glossaries</a> or one <a id="wrglossary.688"></a><a href="#glo:dual.glossary">glossary</a> may be split across multiple resource
sets, forming logical sub-blocks.
<p>
If you want to ensure that all entries are selected, even if
they haven’t been referenced in the document, then add the option
-<a id="wrglossary.698"></a><a href="#glo:opt.resource.selection"><span class="xtrcsoptfmt">selection</span></a><span class="optfmt">=all</span>. (There are also ways of filtering the
+<a id="wrglossary.689"></a><a href="#glo:opt.resource.selection"><span class="xtrcsoptfmt">selection</span></a><span class="optfmt">=all</span>. (There are also ways of filtering the
selection or you can even have a random selection by shuffling and
-truncating the list. See the <a id="wrglossary.699"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> user manual for further details.)
+truncating the list. See the <a id="wrglossary.690"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> user manual for further details.)
<p>
-The <a id="wrglossary.700"></a><a href="#glo:dual.glossary">glossary</a> is displayed using:
-<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.701"></a><a href="#glo:printunsrtglossary"><code class="xtrcsfmt">\printunsrtglossary</code></a>
+The <a id="wrglossary.691"></a><a href="#glo:dual.glossary">glossary</a> is displayed using:
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.692"></a><a href="#glo:printunsrtglossary"><code class="xtrcsfmt">\printunsrtglossary</code></a>
</pre>
Alternatively all glossaries can be displayed using the iterative
command:
-<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.702"></a><a href="#glo:printunsrtglossaries"><code class="xtrcsfmt">\printunsrtglossaries</code></a>
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.693"></a><a href="#glo:printunsrtglossaries"><code class="xtrcsfmt">\printunsrtglossaries</code></a>
</pre>
The document is built using:
<pre class="terminal"><div class="terminaltitle"><a href="#glo:sym.terminal"><span title="Terminal" class="icon">〉_</span></a></div>pdflatex myDoc
@@ -6833,57 +6832,57 @@
bib2gls myDoc
pdflatex myDoc
</pre>
-If <a id="wrglossary.703"></a><a href="#glo:idx.group">letter groups</a> are required, you need the <a id="wrglossary.704"></a><a href="#glo:switch.group"><span class="longargfmt">--group</span></a> switch:
-<pre class="terminal"><div class="terminaltitle"><a href="#glo:sym.terminal"><span title="Terminal" class="icon">〉_</span></a></div>bib2gls <a id="wrglossary.705"></a><a href="#glo:switch.group"><span class="longargfmt">--group</span></a> myDoc
+If <a id="wrglossary.694"></a><a href="#glo:idx.group">letter groups</a> are required, you need the <a id="wrglossary.695"></a><a href="#glo:switch.group"><span class="longargfmt">--group</span></a> switch:
+<pre class="terminal"><div class="terminaltitle"><a href="#glo:sym.terminal"><span title="Terminal" class="icon">〉_</span></a></div>bib2gls <a id="wrglossary.696"></a><a href="#glo:switch.group"><span class="longargfmt">--group</span></a> myDoc
</pre>
-or with <a id="wrglossary.706"></a><a href="#glo:app.arara"><span class="appfmt">arara</span></a>:
+or with <a id="wrglossary.697"></a><a href="#glo:app.arara"><span class="appfmt">arara</span></a>:
<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div>% arara: bib2gls: { group: on }
</pre>
-(You will also need an appropriate <a id="wrglossary.707"></a><a href="#glo:idx.glossarystyle">glossary style</a>.)
+(You will also need an appropriate <a id="wrglossary.698"></a><a href="#glo:idx.glossarystyle">glossary style</a>.)
<p>
Unlike Options <a href="#glo:idx.opt.mkidx">2</a> and <a href="#glo:idx.opt.xdy">3</a>, this method doesn’t create a file containing
-the typeset <a id="wrglossary.708"></a><a href="#glo:dual.glossary">glossary</a> but simply determines which entries are
+the typeset <a id="wrglossary.699"></a><a href="#glo:dual.glossary">glossary</a> but simply determines which entries are
needed for the document, their associated locations and (if
-required) their associated <a id="wrglossary.709"></a><a href="#glo:idx.group">letter group</a>. This option allows
+required) their associated <a id="wrglossary.700"></a><a href="#glo:idx.group">letter group</a>. This option allows
a mixture of sort methods. For example, sorting by word order
for one glossary and order of use for another or even sorting
-one block of the <a id="wrglossary.710"></a><a href="#glo:dual.glossary">glossary</a> differently to another block in the
-same <a id="wrglossary.711"></a><a href="#glo:dual.glossary">glossary</a>. See <a href="https://www.dickimaw-books.com/gallery/index.php?label=bib2gls-sorting"><span class="appfmt">bib2gls</span> gallery: sorting</a>.
+one block of the <a id="wrglossary.701"></a><a href="#glo:dual.glossary">glossary</a> differently to another block in the
+same <a id="wrglossary.702"></a><a href="#glo:dual.glossary">glossary</a>. See <a href="https://www.dickimaw-books.com/gallery/index.php?label=bib2gls-sorting"><span class="appfmt">bib2gls</span> gallery: sorting</a>.
<p>
-This method supports Unicode and uses the <a id="wrglossary.712"></a><a href="#glo:cldr">CLDR</a>, which provides
-more extensive language support than <a id="wrglossary.713"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>. (Except for
-Klingon, which is supported by <a id="wrglossary.714"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>, but not by the
-<a id="wrglossary.715"></a><a href="#glo:cldr">CLDR</a>.) The locations in the <a id="wrglossary.716"></a><a href="#glo:locationlist">number list</a> may be in any
-format. If <a id="wrglossary.717"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> can deduce a numerical value it will
-attempt to form <a id="wrglossary.718"></a><a href="#glo:idx.range">ranges</a> otherwise it will simply list the
-<a id="wrglossary.719"></a><a href="#glo:dual.entrylocation">locations</a>.
+This method supports Unicode and uses the <a id="wrglossary.703"></a><a href="#glo:cldr">CLDR</a>, which provides
+more extensive language support than <a id="wrglossary.704"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>. (Except for
+Klingon, which is supported by <a id="wrglossary.705"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>, but not by the
+<a id="wrglossary.706"></a><a href="#glo:cldr">CLDR</a>.) The locations in the <a id="wrglossary.707"></a><a href="#glo:locationlist">number list</a> may be in any
+format. If <a id="wrglossary.708"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> can deduce a numerical value it will
+attempt to form <a id="wrglossary.709"></a><a href="#glo:idx.range">ranges</a> otherwise it will simply list the
+<a id="wrglossary.710"></a><a href="#glo:dual.entrylocation">locations</a>.
<p>
Summary:
<ol class="displaylist">
-<li><span class="numitem">1.</span>Use <a id="wrglossary.720"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> with the <a id="wrglossary.721"></a><a href="#glo:opt.record"><span class="xtrstyoptfmt">record</span></a> package
+<li><span class="numitem">1.</span>Use <a id="wrglossary.711"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> with the <a id="wrglossary.712"></a><a href="#glo:opt.record"><span class="xtrstyoptfmt">record</span></a> package
option:
-<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\usepackage</code>[<a id="wrglossary.722"></a><a href="#glo:opt.record"><span class="xtrstyoptfmt">record</span></a>]{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.713"></a><a href="#glo:opt.record"><span class="xtrstyoptfmt">record</span></a>]{glossaries-extra}
</pre>
<p>
-<li><span class="numitem">2.</span>Use <a id="wrglossary.723"></a><a href="#glo:GlsXtrLoadResources"><code class="xtrcsfmt">\GlsXtrLoadResources</code></a> to identify the <a id="wrglossary.724"></a><a href="#glo:ext.bib"><span class="extfmt">bib</span></a>
-file(s) and <a id="wrglossary.725"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> options. The <a id="wrglossary.726"></a><a href="#glo:ext.bib"><span class="extfmt">bib</span></a> extension may be
+<li><span class="numitem">2.</span>Use <a id="wrglossary.714"></a><a href="#glo:GlsXtrLoadResources"><code class="xtrcsfmt">\GlsXtrLoadResources</code></a> to identify the <a id="wrglossary.715"></a><a href="#glo:ext.bib"><span class="extfmt">bib</span></a>
+file(s) and <a id="wrglossary.716"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> options. The <a id="wrglossary.717"></a><a href="#glo:ext.bib"><span class="extfmt">bib</span></a> extension may be
omitted:
-<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.727"></a><a href="#glo:GlsXtrLoadResources"><code class="xtrcsfmt">\GlsXtrLoadResources</code></a>[<a id="wrglossary.728"></a><a href="#glo:opt.resource.src"><span class="xtrcsoptfmt">src</span></a><span class="optfmt">={terms.bib,abbreviations.bib}</span>,<a id="wrglossary.729"></a><a href="#glo:opt.resource.sort"><span class="xtrcsoptfmt">sort</span></a><span class="optfmt">=en</span>]
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.718"></a><a href="#glo:GlsXtrLoadResources"><code class="xtrcsfmt">\GlsXtrLoadResources</code></a>[<a id="wrglossary.719"></a><a href="#glo:opt.resource.src"><span class="xtrcsoptfmt">src</span></a><span class="optfmt">={terms.bib,abbreviations.bib}</span>,<a id="wrglossary.720"></a><a href="#glo:opt.resource.sort"><span class="xtrcsoptfmt">sort</span></a><span class="optfmt">=en</span>]
</pre>
<p>
<li><span class="numitem">3.</span>Put
-<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.730"></a><a href="#glo:printunsrtglossary"><code class="xtrcsfmt">\printunsrtglossary</code></a>
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.721"></a><a href="#glo:printunsrtglossary"><code class="xtrcsfmt">\printunsrtglossary</code></a>
</pre>
where you want your list of entries to appear. Alternatively to
display all glossaries use the iterative command:
-<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.731"></a><a href="#glo:printunsrtglossaries"><code class="xtrcsfmt">\printunsrtglossaries</code></a>
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.722"></a><a href="#glo:printunsrtglossaries"><code class="xtrcsfmt">\printunsrtglossaries</code></a>
</pre>
<p>
<li><span class="numitem">4.</span>Run LaTeX on your document.
<p>
-<li><span class="numitem">5.</span>Run <a id="wrglossary.732"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> with just the document base name.
+<li><span class="numitem">5.</span>Run <a id="wrglossary.723"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> with just the document base name.
<p>
<li><span class="numitem">6.</span>Run LaTeX on your document.
<p>
@@ -6891,7 +6890,7 @@
</ol>
<p>
-See <a href="http://mirrors.ctan.org/support/bib2gls/bib2gls-begin.pdf"><span class="styfmt">glossaries-extra</span> and <span class="appfmt">bib2gls</span>: An Introductory Guide</a> or the <a id="wrglossary.733"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> user manual for further
+See <a href="http://mirrors.ctan.org/support/bib2gls/bib2gls-begin.pdf"><span class="styfmt">glossaries-extra</span> and <span class="appfmt">bib2gls</span>: An Introductory Guide</a> or the <a id="wrglossary.724"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> user manual for further
details of this method, and
also <a href="https://www.dickimaw-books.com/latex/buildglossaries/">Incorporating
makeglossaries or makeglossaries-lite or bib2gls into the document
@@ -6901,46 +6900,46 @@
</section><!-- end of section option4 -->
<section id="option5"><!-- start of section option5 --><div class="tomain"><a href="#main">[top]</a></div>
-<h3><!-- start of subsection header -->1.3.5. <a id="wrglossary.734"></a><dfn id="glo:idx.opt.unsrt">Option 5 (<span class="qt">“unsrt”</span>)</dfn><span class="labellink"><a href="#option5">[link]</a></span></h3><!-- end of subsection header -->
+<h3><!-- start of subsection header -->1.3.5. <a id="wrglossary.725"></a><dfn id="glo:idx.opt.unsrt">Option 5 (<span class="qt">“unsrt”</span>)</dfn><span class="labellink"><a href="#option5">[link]</a></span></h3><!-- end of subsection header -->
<p>
-<div class="sidenote"><a id="wrglossary.735"></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.726"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a></div><span class="clearfix"></span><!-- end of sidenote -->
This option is only available with the extension package
-<a id="wrglossary.736"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>. No <a id="wrglossary.737"></a><a href="#glo:dual.indexingapp">indexing application</a> is required.
+<a id="wrglossary.727"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>. No <a id="wrglossary.728"></a><a href="#glo:dual.indexingapp">indexing application</a> is required.
<p>
<div class="marginright"><a id="ex:unsrt-backref">🖹</a><a href="#ex:unsrt">7</a></div>Example <a href="#ex:unsrt">7</a> demonstrates this method:
<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\documentclass</code>{article}
-<code class="cmd">\usepackage</code>[<a id="wrglossary.738"></a><a href="#glo:opt.style"><span class="styoptfmt">style</span></a><span class="optfmt">=<a id="wrglossary.739"></a><a href="#glo:opt.glostyle.indexgroup"><span class="glostylefmt">indexgroup</span></a></span>]{glossaries-extra}
-<a id="wrglossary.740"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{parrot}{<a id="wrglossary.741"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={parrot}</span>,
- <a id="wrglossary.742"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a brightly coloured tropical bird}</span>}
-<a id="wrglossary.743"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{duck}{<a id="wrglossary.744"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={duck}</span>,
- <a id="wrglossary.745"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a waterbird}</span>}
-<a id="wrglossary.746"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{puffin}{<a id="wrglossary.747"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={puffin}</span>,
- <a id="wrglossary.748"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a seabird with a brightly coloured bill}</span>}
-<a id="wrglossary.749"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{penguin}{<a id="wrglossary.750"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={penguin}</span>,
- <a id="wrglossary.751"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a flightless black and white seabird}</span>}
+<code class="cmd">\usepackage</code>[<a id="wrglossary.729"></a><a href="#glo:opt.style"><span class="styoptfmt">style</span></a><span class="optfmt">=<a id="wrglossary.730"></a><a href="#glo:opt.glostyle.indexgroup"><span class="glostylefmt">indexgroup</span></a></span>]{glossaries-extra}
+<a id="wrglossary.731"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{parrot}{<a id="wrglossary.732"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={parrot}</span>,
+ <a id="wrglossary.733"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a brightly coloured tropical bird}</span>}
+<a id="wrglossary.734"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{duck}{<a id="wrglossary.735"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={duck}</span>,
+ <a id="wrglossary.736"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a waterbird}</span>}
+<a id="wrglossary.737"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{puffin}{<a id="wrglossary.738"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={puffin}</span>,
+ <a id="wrglossary.739"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a seabird with a brightly coloured bill}</span>}
+<a id="wrglossary.740"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{penguin}{<a id="wrglossary.741"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={penguin}</span>,
+ <a id="wrglossary.742"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a flightless black and white seabird}</span>}
<span class="comment">% a symbol:</span>
-<a id="wrglossary.752"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{alpha}{<a id="wrglossary.753"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={<a id="wrglossary.754"></a><a href="#glo:ensuremath"><code class="csfmt">\ensuremath</code></a>{<a id="wrglossary.755"></a><a href="#glo:alpha"><code class="csfmt">\alpha</code></a>}}</span>,
- <a id="wrglossary.756"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a variable}</span>}
-<span class="comment">% an <a id="wrglossary.757"></a><a href="#glo:idx.abbreviation"><span class="xtrfmt">abbreviation</span></a>:</span>
-<a id="wrglossary.758"></a><a href="#glo:setabbreviationstyle"><code class="xtrcsfmt">\setabbreviationstyle</code></a>{<a id="wrglossary.759"></a><a href="#glo:opt.abbrstyle.short-long"><span class="abbrstylefmt">short-long</span></a>}
-<a id="wrglossary.760"></a><a href="#glo:newabbreviation"><code class="xtrcsfmt">\newabbreviation</code></a>{arpanet}{ARPANET}{Advanced Research Projects Agency Network}
+<a id="wrglossary.743"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{alpha}{<a id="wrglossary.744"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={<a id="wrglossary.745"></a><a href="#glo:ensuremath"><code class="csfmt">\ensuremath</code></a>{<a id="wrglossary.746"></a><a href="#glo:alpha"><code class="csfmt">\alpha</code></a>}}</span>,
+ <a id="wrglossary.747"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a variable}</span>}
+<span class="comment">% an <a id="wrglossary.748"></a><a href="#glo:idx.abbreviation"><span class="xtrfmt">abbreviation</span></a>:</span>
+<a id="wrglossary.749"></a><a href="#glo:setabbreviationstyle"><code class="xtrcsfmt">\setabbreviationstyle</code></a>{<a id="wrglossary.750"></a><a href="#glo:opt.abbrstyle.short-long"><span class="abbrstylefmt">short-long</span></a>}
+<a id="wrglossary.751"></a><a href="#glo:newabbreviation"><code class="xtrcsfmt">\newabbreviation</code></a>{arpanet}{ARPANET}{Advanced Research Projects Agency Network}
<code class="cbeg">\begin{document}</code>
-<a id="wrglossary.761"></a><a href="#glo:Gls"><code class="csfmt">\Gls</code></a>{puffin}, <a id="wrglossary.762"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{duck} and <a id="wrglossary.763"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{parrot}.
-<a id="wrglossary.764"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{arpanet} and <a id="wrglossary.765"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{alpha}.
-Next use: <a id="wrglossary.766"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{arpanet}.
-<strong class="strong"><a id="wrglossary.767"></a><a href="#glo:printunsrtglossary"><code class="xtrcsfmt">\printunsrtglossary</code></a></strong>
+<a id="wrglossary.752"></a><a href="#glo:Gls"><code class="csfmt">\Gls</code></a>{puffin}, <a id="wrglossary.753"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{duck} and <a id="wrglossary.754"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{parrot}.
+<a id="wrglossary.755"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{arpanet} and <a id="wrglossary.756"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{alpha}.
+Next use: <a id="wrglossary.757"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{arpanet}.
+<strong class="strong"><a id="wrglossary.758"></a><a href="#glo:printunsrtglossary"><code class="xtrcsfmt">\printunsrtglossary</code></a></strong>
<code class="cend">\end{document}</code>
</pre>
You can place all your entry definitions in a separate file
-and load it in the <a id="wrglossary.768"></a><a href="#glo:idx.preamble/document">preamble</a> with <a id="wrglossary.769"></a><a href="#glo:loadglsentries"><code class="csfmt">\loadglsentries</code></a>.
-There’s no <span class="qt">“activation”</span> command (such as <a id="wrglossary.770"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a> for
+and load it in the <a id="wrglossary.759"></a><a href="#glo:idx.preamble/document">preamble</a> with <a id="wrglossary.760"></a><a href="#glo:loadglsentries"><code class="csfmt">\loadglsentries</code></a>.
+There’s no <span class="qt">“activation”</span> command (such as <a id="wrglossary.761"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a> for
Options <a href="#glo:idx.opt.mkidx">2</a> and <a href="#glo:idx.opt.xdy">3</a>).
<p>
The result is different from the previous examples. Now all entries
-are listed in the <a id="wrglossary.771"></a><a href="#glo:dual.glossary">glossary</a>, including <span class="qt">“penguin”</span> which
+are listed in the <a id="wrglossary.762"></a><a href="#glo:dual.glossary">glossary</a>, including <span class="qt">“penguin”</span> which
hasn’t been referenced in the document, and the list is in the order
-that the entries were defined. There are no <a id="wrglossary.772"></a><a href="#glo:locationlist">number lists</a>.
+that the entries were defined. There are no <a id="wrglossary.763"></a><a href="#glo:locationlist">number lists</a>.
<div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
<a href="#ex:unsrt-backref"><span title="Up" class="icon">⭱</span></a><a id="ex:unsrt"></a>Example 7: Simple document with an unsorted list of all defined entries <a href="glossaries-user-examples/glossaries-user-example007.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-user-examples/glossaries-user-example007.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a>
<p>
@@ -6953,36 +6952,36 @@
Note that the letter groups are fragmented because the list isn’t in
alphabetical order, so there are two <span class="qt">“P”</span> letter groups.
<p>
-The <a id="wrglossary.773"></a><a href="#glo:printunsrtglossary"><code class="xtrcsfmt">\printunsrtglossary</code></a> command simply iterates over the set
-of all defined entries associated with the given <a id="wrglossary.774"></a><a href="#glo:dual.glossary">glossary</a> and
+The <a id="wrglossary.764"></a><a href="#glo:printunsrtglossary"><code class="xtrcsfmt">\printunsrtglossary</code></a> command simply iterates over the set
+of all defined entries associated with the given <a id="wrglossary.765"></a><a href="#glo:dual.glossary">glossary</a> and
lists them in the order of definition. This means that child
entries must be defined immediately after their parent entry
-if they must be kept together in the glossary. Some <a id="wrglossary.775"></a><a href="#glo:idx.glossarystyle">glossary styles</a>
-indent entries that have a parent but it’s the <a id="wrglossary.776"></a><a href="#glo:dual.indexingapp">indexing application</a>
+if they must be kept together in the glossary. Some <a id="wrglossary.766"></a><a href="#glo:idx.glossarystyle">glossary styles</a>
+indent entries that have a parent but it’s the <a id="wrglossary.767"></a><a href="#glo:dual.indexingapp">indexing application</a>
that ensures the child entries are listed immediately after the
parent. If you’re opting to use this manual approach then it’s your
responsibility to define the entries in the correct order.
<p>
-The <a id="wrglossary.777"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package requires entries to be defined in the
-<a id="wrglossary.778"></a><a href="#glo:idx.preamble/document">preamble</a> by default. It’s possible to remove this restriction, but
-bear in mind that any entries defined after <a id="wrglossary.779"></a><a href="#glo:printunsrtglossary"><code class="xtrcsfmt">\printunsrtglossary</code></a>
+The <a id="wrglossary.768"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package requires entries to be defined in the
+<a id="wrglossary.769"></a><a href="#glo:idx.preamble/document">preamble</a> by default. It’s possible to remove this restriction, but
+bear in mind that any entries defined after <a id="wrglossary.770"></a><a href="#glo:printunsrtglossary"><code class="xtrcsfmt">\printunsrtglossary</code></a>
won’t be listed.
<p>
-The <a id="wrglossary.780"></a><a href="#glo:dual.glossary">glossary</a> is displayed using:
-<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.781"></a><a href="#glo:printunsrtglossary"><code class="xtrcsfmt">\printunsrtglossary</code></a>
+The <a id="wrglossary.771"></a><a href="#glo:dual.glossary">glossary</a> is displayed using:
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.772"></a><a href="#glo:printunsrtglossary"><code class="xtrcsfmt">\printunsrtglossary</code></a>
</pre>
Alternatively all glossaries can be displayed using the iterative
command:
-<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.782"></a><a href="#glo:printunsrtglossaries"><code class="xtrcsfmt">\printunsrtglossaries</code></a>
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.773"></a><a href="#glo:printunsrtglossaries"><code class="xtrcsfmt">\printunsrtglossaries</code></a>
</pre>
<p>
This method will display <span style="font-style: italic; font-variant: normal; ">all</span> defined entries, regardless of
whether or not they have been used in the document. Note that this
-uses the same command for displaying the <a id="wrglossary.783"></a><a href="#glo:dual.glossary">glossary</a> as
-<a id="wrglossary.784"></a><a href="#glo:idx.opt.b2g">Option 4</a>. This is because <a id="wrglossary.785"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> takes advantage of this
+uses the same command for displaying the <a id="wrglossary.774"></a><a href="#glo:dual.glossary">glossary</a> as
+<a id="wrglossary.775"></a><a href="#glo:idx.opt.b2g">Option 4</a>. This is because <a id="wrglossary.776"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> takes advantage of this
method by defining the wanted entries in the required order and
-setting the locations (and <a id="wrglossary.786"></a><a href="#glo:idx.group">letter group</a> information, if required).
-See the <a id="wrglossary.787"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> manual for further details.
+setting the locations (and <a id="wrglossary.777"></a><a href="#glo:idx.group">letter group</a> information, if required).
+See the <a id="wrglossary.778"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> manual for further details.
<p>
Therefore, the above example document has a glossary containing the
entries: parrot, duck, puffin, penguin, \(\alpha \) and ARPANET (in
@@ -7001,71 +7000,71 @@
then additional steps are required. Similarly for all the other
options above.)
<p>
-See the <a id="wrglossary.788"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> documentation for further details of this method.
+See the <a id="wrglossary.779"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> documentation for further details of this method.
<p>
</section><!-- end of section option5 -->
<section id="option6"><!-- start of section option6 --><div class="tomain"><a href="#main">[top]</a></div>
-<h3><!-- start of subsection header -->1.3.6. <a id="wrglossary.789"></a><dfn id="glo:idx.opt.standalone">Option 6 (<span class="qt">“standalone”</span>)</dfn><span class="labellink"><a href="#option6">[link]</a></span></h3><!-- end of subsection header -->
+<h3><!-- start of subsection header -->1.3.6. <a id="wrglossary.780"></a><dfn id="glo:idx.opt.standalone">Option 6 (<span class="qt">“standalone”</span>)</dfn><span class="labellink"><a href="#option6">[link]</a></span></h3><!-- end of subsection header -->
<p>
-<div class="sidenote"><a id="wrglossary.790"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a></div><span class="clearfix"></span><!-- end of sidenote -->
-This option is only available with the <a id="wrglossary.791"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>
+<div class="sidenote"><a id="wrglossary.781"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a></div><span class="clearfix"></span><!-- end of sidenote -->
+This option is only available with the <a id="wrglossary.782"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>
extension package. (You can just use the base
-<a id="wrglossary.792"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package for the first case, but it’s less
+<a id="wrglossary.783"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package for the first case, but it’s less
convenient. You’d have to manually insert the entry target before
-the sectioning command and use <code class="code"><a id="wrglossary.793"></a><a href="#glo:glsentryname"><code class="csfmt">\glsentryname</code></a>{<span class="meta">〈<em class="metainner">label</em>〉</span>}</code> or
-<code class="code"><a id="wrglossary.794"></a><a href="#glo:Glsentryname"><code class="csfmt">\Glsentryname</code></a>{<span class="meta">〈<em class="metainner">label</em>〉</span>}</code> to display the entry name.) Instead
+the sectioning command and use <code class="code"><a id="wrglossary.784"></a><a href="#glo:glsentryname"><code class="csfmt">\glsentryname</code></a>{<span class="meta">〈<em class="metainner">label</em>〉</span>}</code> or
+<code class="code"><a id="wrglossary.785"></a><a href="#glo:Glsentryname"><code class="csfmt">\Glsentryname</code></a>{<span class="meta">〈<em class="metainner">label</em>〉</span>}</code> to display the entry name.) Instead
of creating a list, this has standalone definitions throughout the
document. The entry name may or may not be in a section heading.
<p>
-You can either define entries in the <a id="wrglossary.795"></a><a href="#glo:idx.preamble/document">preamble</a> (or in an
-external file loaded with <a id="wrglossary.796"></a><a href="#glo:loadglsentries"><code class="csfmt">\loadglsentries</code></a>), as with
-<a id="wrglossary.797"></a><a href="#glo:idx.opt.unsrt">Option 5</a>, or use <a id="wrglossary.798"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> if you want to manage a large
+You can either define entries in the <a id="wrglossary.786"></a><a href="#glo:idx.preamble/document">preamble</a> (or in an
+external file loaded with <a id="wrglossary.787"></a><a href="#glo:loadglsentries"><code class="csfmt">\loadglsentries</code></a>), as with
+<a id="wrglossary.788"></a><a href="#glo:idx.opt.unsrt">Option 5</a>, or use <a id="wrglossary.789"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> if you want to manage a large
database of terms.
<p>
<div class="marginright"><a id="ex:standalone-backref">🖹</a><a href="#ex:standalone">8</a></div>Example <a href="#ex:standalone">8</a> demonstrates standalone definitions
-without <a id="wrglossary.799"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>:
+without <a id="wrglossary.790"></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><code class="cmd">\documentclass</code>{article}
<code class="cmd">\usepackage</code>[colorlinks]{hyperref}
-<code class="cmd">\usepackage</code>[<a id="wrglossary.800"></a><a href="#glo:opt.sort"><span class="styoptfmt">sort</span></a><span class="optfmt">=none</span>,
- <a id="wrglossary.801"></a><a href="#glo:opt.nostyles"><span class="styoptfmt">nostyles</span></a><span class="comment">% <- no glossary styles are required</span>
+<code class="cmd">\usepackage</code>[<a id="wrglossary.791"></a><a href="#glo:opt.sort"><span class="styoptfmt">sort</span></a><span class="optfmt">=none</span>,
+ <a id="wrglossary.792"></a><a href="#glo:opt.nostyles"><span class="styoptfmt">nostyles</span></a><span class="comment">% <- no glossary styles are required</span>
]{glossaries-extra}
-<a id="wrglossary.802"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{set}{<a id="wrglossary.803"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={set}</span>,
- <a id="wrglossary.804"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a collection of any kind of objects}</span>,
- <a id="wrglossary.805"></a><a href="#glo:opt.gloskey.symbol"><span class="csoptfmt">symbol</span></a><span class="optfmt">={<a id="wrglossary.806"></a><a href="#glo:ensuremath"><code class="csfmt">\ensuremath</code></a>{<code class="cmd">\mathcal</code>{S}}}</span>
+<a id="wrglossary.793"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{set}{<a id="wrglossary.794"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={set}</span>,
+ <a id="wrglossary.795"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a collection of any kind of objects}</span>,
+ <a id="wrglossary.796"></a><a href="#glo:opt.gloskey.symbol"><span class="csoptfmt">symbol</span></a><span class="optfmt">={<a id="wrglossary.797"></a><a href="#glo:ensuremath"><code class="csfmt">\ensuremath</code></a>{<code class="cmd">\mathcal</code>{S}}}</span>
}
-<a id="wrglossary.807"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{function}{<a id="wrglossary.808"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={function}</span>,
- <a id="wrglossary.809"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a rule that assigns every element in the
- domain <a id="wrglossary.810"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{set} to an element in the range <a id="wrglossary.811"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{set}}</span>,
- <a id="wrglossary.812"></a><a href="#glo:opt.gloskey.symbol"><span class="csoptfmt">symbol</span></a><span class="optfmt">={<a id="wrglossary.813"></a><a href="#glo:ensuremath"><code class="csfmt">\ensuremath</code></a>{f(x)}}</span>
+<a id="wrglossary.798"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{function}{<a id="wrglossary.799"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={function}</span>,
+ <a id="wrglossary.800"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a rule that assigns every element in the
+ domain <a id="wrglossary.801"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{set} to an element in the range <a id="wrglossary.802"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{set}}</span>,
+ <a id="wrglossary.803"></a><a href="#glo:opt.gloskey.symbol"><span class="csoptfmt">symbol</span></a><span class="optfmt">={<a id="wrglossary.804"></a><a href="#glo:ensuremath"><code class="csfmt">\ensuremath</code></a>{f(x)}}</span>
}
<code class="cmd">\newcommand</code>*{<code class="cmd">\termdef</code>}[1]{<span class="comment">% </span>
- <a id="wrglossary.814"></a><a href="#glo:section"><code class="csfmt">\section</code></a>{<a id="wrglossary.815"></a><a href="#glo:Glsxtrglossentry"><code class="csfmt">\Glsxtrglossentry</code></a>{#1} <a id="wrglossary.816"></a><a href="#glo:glsentrysymbol"><code class="csfmt">\glsentrysymbol</code></a>{#1}}<span class="comment">% </span>
- <code class="cbeg">\begin{quote}</code><code class="cmd">\em</code><a id="wrglossary.817"></a><a href="#glo:Glsentrydesc"><code class="csfmt">\Glsentrydesc</code></a>{#1}.<code class="cend">\end{quote}</code><span class="comment">% </span>
+ <a id="wrglossary.805"></a><a href="#glo:section"><code class="csfmt">\section</code></a>{<a id="wrglossary.806"></a><a href="#glo:Glsxtrglossentry"><code class="csfmt">\Glsxtrglossentry</code></a>{#1} <a id="wrglossary.807"></a><a href="#glo:glsentrysymbol"><code class="csfmt">\glsentrysymbol</code></a>{#1}}<span class="comment">% </span>
+ <code class="cbeg">\begin{quote}</code><code class="cmd">\em</code><a id="wrglossary.808"></a><a href="#glo:Glsentrydesc"><code class="csfmt">\Glsentrydesc</code></a>{#1}.<code class="cend">\end{quote}</code><span class="comment">% </span>
}
<code class="cbeg">\begin{document}</code>
<code class="cmd">\tableofcontents</code>
-<a id="wrglossary.818"></a><a href="#glo:section"><code class="csfmt">\section</code></a>{Introduction}
-Sample document about <a id="wrglossary.819"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>{function} and <a id="wrglossary.820"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>{set}.
+<a id="wrglossary.809"></a><a href="#glo:section"><code class="csfmt">\section</code></a>{Introduction}
+Sample document about <a id="wrglossary.810"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>{function} and <a id="wrglossary.811"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>{set}.
<code class="cmd">\termdef</code>{set}
-More detailed information about <a id="wrglossary.821"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>{set} with examples.
+More detailed information about <a id="wrglossary.812"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>{set} with examples.
<code class="cmd">\termdef</code>{function}
-More detailed information about <a id="wrglossary.822"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>{function} with examples.
+More detailed information about <a id="wrglossary.813"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>{function} with examples.
<code class="cend">\end{document}</code>
</pre>
-This allows the references to <a id="wrglossary.823"></a><a href="#glo:idx.hyperlink">hyperlink</a> to the standalone
-definitions rather than to a <a id="wrglossary.824"></a><a href="#glo:dual.glossary">glossary</a>.
+This allows the references to <a id="wrglossary.814"></a><a href="#glo:idx.hyperlink">hyperlink</a> to the standalone
+definitions rather than to a <a id="wrglossary.815"></a><a href="#glo:dual.glossary">glossary</a>.
<div class="resultbox"><div class="resultboxtitle"><a href="#glo:sym.result"><span title="Result" class="icon">🖺</span></a></div><!-- end of resultboxtitle -->
<a href="#ex:standalone-backref"><span title="Up" class="icon">⭱</span></a><a id="ex:standalone"></a>Example 8: Simple document with standalone entries <a href="glossaries-user-examples/glossaries-user-example008.tex" class="icon"><span title="Download TeX File" class="icon">📥<sup>🖹</sup></span></a> <a href="glossaries-user-examples/glossaries-user-example008.pdf" class="icon"><span title="Download PDF" class="icon">📥<sup>🖺</sup></span></a>
<p>
@@ -7074,62 +7073,62 @@
</div><!-- end of resultbox -->
<p>
-The above example can be modified to use <a id="wrglossary.825"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> if the terms
-are defined in one or more <a id="wrglossary.826"></a><a href="#glo:ext.bib"><span class="extfmt">bib</span></a> files:
+The above example can be modified to use <a id="wrglossary.816"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> if the terms
+are defined in one or more <a id="wrglossary.817"></a><a href="#glo:ext.bib"><span class="extfmt">bib</span></a> files:
<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\documentclass</code>{article}
<code class="cmd">\usepackage</code>[colorlinks]{hyperref}
-<code class="cmd">\usepackage</code>[<a id="wrglossary.827"></a><a href="#glo:opt.record"><span class="xtrstyoptfmt">record</span></a>,
- <a id="wrglossary.828"></a><a href="#glo:opt.nostyles"><span class="styoptfmt">nostyles</span></a><span class="comment">% <- no glossary styles are required</span>
+<code class="cmd">\usepackage</code>[<a id="wrglossary.818"></a><a href="#glo:opt.record"><span class="xtrstyoptfmt">record</span></a>,
+ <a id="wrglossary.819"></a><a href="#glo:opt.nostyles"><span class="styoptfmt">nostyles</span></a><span class="comment">% <- no glossary styles are required</span>
]{glossaries-extra}
-<a id="wrglossary.829"></a><a href="#glo:GlsXtrLoadResources"><code class="xtrcsfmt">\GlsXtrLoadResources</code></a>[<a id="wrglossary.830"></a><a href="#glo:opt.resource.src"><span class="xtrcsoptfmt">src</span></a><span class="optfmt">={terms}</span>,<a id="wrglossary.831"></a><a href="#glo:opt.resource.sort"><span class="xtrcsoptfmt">sort</span></a><span class="optfmt">=none</span>,<a id="wrglossary.832"></a><a href="#glo:opt.resource.save-locations"><span class="xtrcsoptfmt">save-locations</span></a><span class="optfmt">=false</span>]
+<a id="wrglossary.820"></a><a href="#glo:GlsXtrLoadResources"><code class="xtrcsfmt">\GlsXtrLoadResources</code></a>[<a id="wrglossary.821"></a><a href="#glo:opt.resource.src"><span class="xtrcsoptfmt">src</span></a><span class="optfmt">={terms}</span>,<a id="wrglossary.822"></a><a href="#glo:opt.resource.sort"><span class="xtrcsoptfmt">sort</span></a><span class="optfmt">=none</span>,<a id="wrglossary.823"></a><a href="#glo:opt.resource.save-locations"><span class="xtrcsoptfmt">save-locations</span></a><span class="optfmt">=false</span>]
<code class="cmd">\newcommand</code>*{<code class="cmd">\termdef</code>}[1]{<span class="comment">% </span>
- <a id="wrglossary.833"></a><a href="#glo:section"><code class="csfmt">\section</code></a>{<a id="wrglossary.834"></a><a href="#glo:Glsxtrglossentry"><code class="csfmt">\Glsxtrglossentry</code></a>{#1} <strong class="strong"><a id="wrglossary.835"></a><a href="#glo:glossentrysymbol"><code class="csfmt">\glossentrysymbol</code></a></strong>{#1}}<span class="comment">% </span>
- <a id="wrglossary.836"></a><a href="#glo:glsadd"><code class="csfmt">\glsadd</code></a>{#1}<span class="comment">% <- index this entry</span>
- <code class="cbeg">\begin{quote}</code><code class="cmd">\em</code><a id="wrglossary.837"></a><a href="#glo:Glsentrydesc"><code class="csfmt">\Glsentrydesc</code></a>{#1}.<code class="cend">\end{quote}</code><span class="comment">% </span>
+ <a id="wrglossary.824"></a><a href="#glo:section"><code class="csfmt">\section</code></a>{<a id="wrglossary.825"></a><a href="#glo:Glsxtrglossentry"><code class="csfmt">\Glsxtrglossentry</code></a>{#1} <strong class="strong"><a id="wrglossary.826"></a><a href="#glo:glossentrysymbol"><code class="csfmt">\glossentrysymbol</code></a></strong>{#1}}<span class="comment">% </span>
+ <a id="wrglossary.827"></a><a href="#glo:glsadd"><code class="csfmt">\glsadd</code></a>{#1}<span class="comment">% <- index this entry</span>
+ <code class="cbeg">\begin{quote}</code><code class="cmd">\em</code><a id="wrglossary.828"></a><a href="#glo:Glsentrydesc"><code class="csfmt">\Glsentrydesc</code></a>{#1}.<code class="cend">\end{quote}</code><span class="comment">% </span>
}
<code class="cbeg">\begin{document}</code>
<code class="cmd">\tableofcontents</code>
-<a id="wrglossary.838"></a><a href="#glo:section"><code class="csfmt">\section</code></a>{Introduction}
-Sample document about <a id="wrglossary.839"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>{function} and <a id="wrglossary.840"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>{set}.
+<a id="wrglossary.829"></a><a href="#glo:section"><code class="csfmt">\section</code></a>{Introduction}
+Sample document about <a id="wrglossary.830"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>{function} and <a id="wrglossary.831"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>{set}.
<code class="cmd">\termdef</code>{set}
-More detailed information about <a id="wrglossary.841"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>{set} with examples.
+More detailed information about <a id="wrglossary.832"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>{set} with examples.
<code class="cmd">\termdef</code>{function}
-More detailed information about <a id="wrglossary.842"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>{function} with examples.
+More detailed information about <a id="wrglossary.833"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>{function} with examples.
<code class="cend">\end{document}</code>
</pre>
Where the file <span class="filefmt">terms.bib</span> contains:
<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="code">@entry</code>{set,
- <a id="wrglossary.843"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={set}</span>,
- <a id="wrglossary.844"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a collection of any kind of objects}</span>,
- <a id="wrglossary.845"></a><a href="#glo:opt.gloskey.symbol"><span class="csoptfmt">symbol</span></a><span class="optfmt">={<a id="wrglossary.846"></a><a href="#glo:ensuremath"><code class="csfmt">\ensuremath</code></a>{<code class="cmd">\mathcal</code>{S}}}</span>
+ <a id="wrglossary.834"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={set}</span>,
+ <a id="wrglossary.835"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a collection of any kind of objects}</span>,
+ <a id="wrglossary.836"></a><a href="#glo:opt.gloskey.symbol"><span class="csoptfmt">symbol</span></a><span class="optfmt">={<a id="wrglossary.837"></a><a href="#glo:ensuremath"><code class="csfmt">\ensuremath</code></a>{<code class="cmd">\mathcal</code>{S}}}</span>
}
<code class="code">@entry</code>{function,
- <a id="wrglossary.847"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={function}</span>,
- <a id="wrglossary.848"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a rule that assigns every element in the domain
- <a id="wrglossary.849"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{set} to an element in the range <a id="wrglossary.850"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{set}}</span>,
- <a id="wrglossary.851"></a><a href="#glo:opt.gloskey.symbol"><span class="csoptfmt">symbol</span></a><span class="optfmt">={<a id="wrglossary.852"></a><a href="#glo:ensuremath"><code class="csfmt">\ensuremath</code></a>{f(x)}}</span>
+ <a id="wrglossary.838"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={function}</span>,
+ <a id="wrglossary.839"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a rule that assigns every element in the domain
+ <a id="wrglossary.840"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{set} to an element in the range <a id="wrglossary.841"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{set}}</span>,
+ <a id="wrglossary.842"></a><a href="#glo:opt.gloskey.symbol"><span class="csoptfmt">symbol</span></a><span class="optfmt">={<a id="wrglossary.843"></a><a href="#glo:ensuremath"><code class="csfmt">\ensuremath</code></a>{f(x)}}</span>
}
</pre>
-The advantage in this approach (with <a id="wrglossary.853"></a><a href="#glo:loadglsentries"><code class="csfmt">\loadglsentries</code></a> or
-<a id="wrglossary.854"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>) is that you can use an existing database of
+The advantage in this approach (with <a id="wrglossary.844"></a><a href="#glo:loadglsentries"><code class="csfmt">\loadglsentries</code></a> or
+<a id="wrglossary.845"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>) is that you can use an existing database of
entries shared across multiple documents, ensuring consistent
notation for all of them.
<p>
-In both cases, there’s no need to load all the <a id="wrglossary.855"></a><a href="#glo:idx.glossarystyle">glossary styles</a>
+In both cases, there’s no need to load all the <a id="wrglossary.846"></a><a href="#glo:idx.glossarystyle">glossary styles</a>
packages, as they’re not required, so I’ve used the
-<a id="wrglossary.856"></a><a href="#glo:opt.nostyles"><span class="styoptfmt">nostyles</span></a> package option to prevent them from being loaded.
+<a id="wrglossary.847"></a><a href="#glo:opt.nostyles"><span class="styoptfmt">nostyles</span></a> package option to prevent them from being loaded.
<p>
In the first case, you just need to define the terms (preferably in
-the <a id="wrglossary.857"></a><a href="#glo:idx.preamble/document">preamble</a> or in a file that’s input in the
-<a id="wrglossary.858"></a><a href="#glo:idx.preamble/document">preamble</a>).
+the <a id="wrglossary.848"></a><a href="#glo:idx.preamble/document">preamble</a> or in a file that’s input in the
+<a id="wrglossary.849"></a><a href="#glo:idx.preamble/document">preamble</a>).
No external tool is required. Just run LaTeX as normal. (Twice to ensure that the
table of contents is up to date.)
<pre class="terminal"><div class="terminaltitle"><a href="#glo:sym.terminal"><span title="Terminal" class="icon">〉_</span></a></div>pdflatex myDoc
@@ -7136,19 +7135,19 @@
pdflatex myDoc
</pre>
<p>
-In the second case, you need the <a id="wrglossary.859"></a><a href="#glo:opt.record"><span class="xtrstyoptfmt">record</span></a> package
-option (as in <a id="wrglossary.860"></a><a href="#glo:idx.opt.b2g">Option 4</a>) since <a id="wrglossary.861"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> is needed to select the
+In the second case, you need the <a id="wrglossary.850"></a><a href="#glo:opt.record"><span class="xtrstyoptfmt">record</span></a> package
+option (as in <a id="wrglossary.851"></a><a href="#glo:idx.opt.b2g">Option 4</a>) since <a id="wrglossary.852"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> is needed to select the
required entries, but you don’t need a sorted list:
-<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.862"></a><a href="#glo:GlsXtrLoadResources"><code class="xtrcsfmt">\GlsXtrLoadResources</code></a>[<a id="wrglossary.863"></a><a href="#glo:opt.resource.src"><span class="xtrcsoptfmt">src</span></a><span class="optfmt">={terms}</span>,<strong class="strong"><a id="wrglossary.864"></a><a href="#glo:opt.resource.sort"><span class="xtrcsoptfmt">sort</span></a><span class="optfmt">=none</span></strong>]
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.853"></a><a href="#glo:GlsXtrLoadResources"><code class="xtrcsfmt">\GlsXtrLoadResources</code></a>[<a id="wrglossary.854"></a><a href="#glo:opt.resource.src"><span class="xtrcsoptfmt">src</span></a><span class="optfmt">={terms}</span>,<strong class="strong"><a id="wrglossary.855"></a><a href="#glo:opt.resource.sort"><span class="xtrcsoptfmt">sort</span></a><span class="optfmt">=none</span></strong>]
</pre>
-This will ensure that any entries <a id="wrglossary.865"></a><a href="#glo:dual.indexing">indexed</a> in the document (through
-commands like <a id="wrglossary.866"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> or <a id="wrglossary.867"></a><a href="#glo:glsadd"><code class="csfmt">\glsadd</code></a>) will be selected by
-<a id="wrglossary.868"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>, but it will skip the sorting step.
-(The chances are you probably also won’t need <a id="wrglossary.869"></a><a href="#glo:dual.locationlist">location lists</a> either.
-If so, you can add the option <a id="wrglossary.870"></a><a href="#glo:opt.resource.save-locations"><span class="xtrcsoptfmt">save-locations</span></a><span class="optfmt">=false</span>.)
+This will ensure that any entries <a id="wrglossary.856"></a><a href="#glo:dual.indexing">indexed</a> in the document (through
+commands like <a id="wrglossary.857"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> or <a id="wrglossary.858"></a><a href="#glo:glsadd"><code class="csfmt">\glsadd</code></a>) will be selected by
+<a id="wrglossary.859"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>, but it will skip the sorting step.
+(The chances are you probably also won’t need <a id="wrglossary.860"></a><a href="#glo:dual.locationlist">location lists</a> either.
+If so, you can add the option <a id="wrglossary.861"></a><a href="#glo:opt.resource.save-locations"><span class="xtrcsoptfmt">save-locations</span></a><span class="optfmt">=false</span>.)
<p>
-Remember that for this second case you need to run <a id="wrglossary.871"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> as
-per <a id="wrglossary.872"></a><a href="#glo:idx.opt.b2g">Option 4</a>:
+Remember that for this second case you need to run <a id="wrglossary.862"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> as
+per <a id="wrglossary.863"></a><a href="#glo:idx.opt.b2g">Option 4</a>:
<pre class="terminal"><div class="terminaltitle"><a href="#glo:sym.terminal"><span title="Terminal" class="icon">〉_</span></a></div>pdflatex myDoc
bib2gls myDoc
pdflatex myDoc
@@ -7155,142 +7154,142 @@
pdflatex myDoc
</pre>
<p>
-For both cases (with or without <a id="wrglossary.873"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>), instead of listing
-all the entries using <a id="wrglossary.874"></a><a href="#glo:printunsrtglossary"><code class="xtrcsfmt">\printunsrtglossary</code></a>, you use
-<code class="code"><a id="wrglossary.875"></a><a href="#glo:glsxtrglossentry"><code class="csfmt">\glsxtrglossentry</code></a>{<span class="meta">〈<em class="metainner">label</em>〉</span>}</code> where you want the name (and
-anchor with <a id="wrglossary.876"></a><a href="#glo:pkg.hyperref"><span class="styfmt">hyperref</span></a>) to appear in the document. This will
-allow the <a id="wrglossary.877"></a><a href="#glo:dual.linktext">link text</a> created by commands like <a id="wrglossary.878"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> to link
+For both cases (with or without <a id="wrglossary.864"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>), instead of listing
+all the entries using <a id="wrglossary.865"></a><a href="#glo:printunsrtglossary"><code class="xtrcsfmt">\printunsrtglossary</code></a>, you use
+<code class="code"><a id="wrglossary.866"></a><a href="#glo:glsxtrglossentry"><code class="csfmt">\glsxtrglossentry</code></a>{<span class="meta">〈<em class="metainner">label</em>〉</span>}</code> where you want the name (and
+anchor with <a id="wrglossary.867"></a><a href="#glo:pkg.hyperref"><span class="styfmt">hyperref</span></a>) to appear in the document. This will
+allow the <a id="wrglossary.868"></a><a href="#glo:dual.linktext">link text</a> created by commands like <a id="wrglossary.869"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> to link
to that point in the document. The description can simply be
-displayed with <code class="code"><a id="wrglossary.879"></a><a href="#glo:glsentrydesc"><code class="csfmt">\glsentrydesc</code></a>{<span class="meta">〈<em class="metainner">label</em>〉</span>}</code> or
-<code class="code"><a id="wrglossary.880"></a><a href="#glo:Glsentrydesc"><code class="csfmt">\Glsentrydesc</code></a>{label}</code>, as in the above examples. In both
+displayed with <code class="code"><a id="wrglossary.870"></a><a href="#glo:glsentrydesc"><code class="csfmt">\glsentrydesc</code></a>{<span class="meta">〈<em class="metainner">label</em>〉</span>}</code> or
+<code class="code"><a id="wrglossary.871"></a><a href="#glo:Glsentrydesc"><code class="csfmt">\Glsentrydesc</code></a>{label}</code>, as in the above examples. In both
examples, I’ve defined a custom command <code class="csfmt">\termdef</code> to simplify the
code and ensure consistency. Extra styling, such as placing the
description in a coloured frame, can be added to this custom
definition as required.
<p>
-(Instead of using <a id="wrglossary.881"></a><a href="#glo:glsentrydesc"><code class="csfmt">\glsentrydesc</code></a> or <a id="wrglossary.882"></a><a href="#glo:Glsentrydesc"><code class="csfmt">\Glsentrydesc</code></a>, you can use
-<code class="code"><a id="wrglossary.883"></a><a href="#glo:glossentrydesc"><code class="csfmt">\glossentrydesc</code></a>{<span class="meta">〈<em class="metainner">label</em>〉</span>}</code>, which will obey
-<a id="wrglossary.884"></a><a href="#glo:idx.categoryattribute">category attributes</a> such as
-<a id="wrglossary.885"></a><a href="#glo:opt.catattr.glossdesc"><span class="csoptfmt">glossdesc</span></a> and <a id="wrglossary.886"></a><a href="#glo:opt.catattr.glossdescfont"><span class="csoptfmt">glossdescfont</span></a>. See the <a id="wrglossary.887"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>
+(Instead of using <a id="wrglossary.872"></a><a href="#glo:glsentrydesc"><code class="csfmt">\glsentrydesc</code></a> or <a id="wrglossary.873"></a><a href="#glo:Glsentrydesc"><code class="csfmt">\Glsentrydesc</code></a>, you can use
+<code class="code"><a id="wrglossary.874"></a><a href="#glo:glossentrydesc"><code class="csfmt">\glossentrydesc</code></a>{<span class="meta">〈<em class="metainner">label</em>〉</span>}</code>, which will obey
+<a id="wrglossary.875"></a><a href="#glo:idx.categoryattribute">category attributes</a> such as
+<a id="wrglossary.876"></a><a href="#glo:opt.catattr.glossdesc"><span class="csoptfmt">glossdesc</span></a> and <a id="wrglossary.877"></a><a href="#glo:opt.catattr.glossdescfont"><span class="csoptfmt">glossdescfont</span></a>. See the <a id="wrglossary.878"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>
manual for further details.)
<p>
The symbol (if required) can be displayed with either
-<code class="code"><a id="wrglossary.888"></a><a href="#glo:glsentrysymbol"><code class="csfmt">\glsentrysymbol</code></a>{<span class="meta">〈<em class="metainner">label</em>〉</span>}</code> or
-<code class="code"><a id="wrglossary.889"></a><a href="#glo:glossentrysymbol"><code class="csfmt">\glossentrysymbol</code></a>{<span class="meta">〈<em class="metainner">label</em>〉</span>}</code>.
-In the first example, I’ve used <a id="wrglossary.890"></a><a href="#glo:glsentrysymbol"><code class="csfmt">\glsentrysymbol</code></a>. In the
-second I’ve used <a id="wrglossary.891"></a><a href="#glo:glossentrysymbol"><code class="csfmt">\glossentrysymbol</code></a>. The latter is
-necessary with <a id="wrglossary.892"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> if the symbol needs to go in a
+<code class="code"><a id="wrglossary.879"></a><a href="#glo:glsentrysymbol"><code class="csfmt">\glsentrysymbol</code></a>{<span class="meta">〈<em class="metainner">label</em>〉</span>}</code> or
+<code class="code"><a id="wrglossary.880"></a><a href="#glo:glossentrysymbol"><code class="csfmt">\glossentrysymbol</code></a>{<span class="meta">〈<em class="metainner">label</em>〉</span>}</code>.
+In the first example, I’ve used <a id="wrglossary.881"></a><a href="#glo:glsentrysymbol"><code class="csfmt">\glsentrysymbol</code></a>. In the
+second I’ve used <a id="wrglossary.882"></a><a href="#glo:glossentrysymbol"><code class="csfmt">\glossentrysymbol</code></a>. The latter is
+necessary with <a id="wrglossary.883"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> if the symbol needs to go in a
section title as the entries aren’t defined on the first LaTeX run.
<p>
-In normal document text, <a id="wrglossary.893"></a><a href="#glo:glsentrysymbol"><code class="csfmt">\glsentrysymbol</code></a> will silently do nothing
+In normal document text, <a id="wrglossary.884"></a><a href="#glo:glsentrysymbol"><code class="csfmt">\glsentrysymbol</code></a> will silently do nothing
if the entry hasn’t been defined, but when used in a section heading
it will expand to an undefined internal command when written to the
-<a id="wrglossary.894"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> file, which triggers an error.
+<a id="wrglossary.885"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> file, which triggers an error.
<p>
-The <a id="wrglossary.895"></a><a href="#glo:glossentrysymbol"><code class="csfmt">\glossentrysymbol</code></a> command performs an existence check,
+The <a id="wrglossary.886"></a><a href="#glo:glossentrysymbol"><code class="csfmt">\glossentrysymbol</code></a> command performs an existence check,
which triggers a warning if the entry is undefined. (All entries
-will be undefined before the first <a id="wrglossary.896"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> call.) You need at
-least <a id="wrglossary.897"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.42 to use this command in a section
-title. (<a id="wrglossary.898"></a><a href="#glo:glossentrysymbol"><code class="csfmt">\glossentrysymbol</code></a> is defined by the base
-<a id="wrglossary.899"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package but is redefined by
-<a id="wrglossary.900"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>.) If <a id="wrglossary.901"></a><a href="#glo:pkg.hyperref"><span class="styfmt">hyperref</span></a> has been loaded, this
-will use <a id="wrglossary.902"></a><a href="#glo:texorpdfstring"><code class="csfmt">\texorpdfstring</code></a> to allow a simple expansion for the
-<a id="wrglossary.903"></a><a href="#glo:idx.PDFbookmark">PDF bookmarks</a> (see the <a id="wrglossary.904"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> user manual for
+will be undefined before the first <a id="wrglossary.887"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> call.) You need at
+least <a id="wrglossary.888"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.42 to use this command in a section
+title. (<a id="wrglossary.889"></a><a href="#glo:glossentrysymbol"><code class="csfmt">\glossentrysymbol</code></a> is defined by the base
+<a id="wrglossary.890"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package but is redefined by
+<a id="wrglossary.891"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>.) If <a id="wrglossary.892"></a><a href="#glo:pkg.hyperref"><span class="styfmt">hyperref</span></a> has been loaded, this
+will use <a id="wrglossary.893"></a><a href="#glo:texorpdfstring"><code class="csfmt">\texorpdfstring</code></a> to allow a simple expansion for the
+<a id="wrglossary.894"></a><a href="#glo:idx.PDFbookmark">PDF bookmarks</a> (see the <a id="wrglossary.895"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> user manual for
further details).
<p>
-If you want to test if the <a id="wrglossary.905"></a><a href="#glo:opt.gloskey.symbol"><span class="csoptfmt">symbol</span></a> field has been set, you
-need to use <a id="wrglossary.906"></a><a href="#glo:ifglshassymbol"><code class="csfmt">\ifglshassymbol</code></a> outside of the section title. For
+If you want to test if the <a id="wrglossary.896"></a><a href="#glo:opt.gloskey.symbol"><span class="csoptfmt">symbol</span></a> field has been set, you
+need to use <a id="wrglossary.897"></a><a href="#glo:ifglshassymbol"><code class="csfmt">\ifglshassymbol</code></a> outside of the section title. For
example:
-<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.907"></a><a href="#glo:ifglshassymbol"><code class="csfmt">\ifglshassymbol</code></a>{#1}<span class="comment">% </span>
-{<a id="wrglossary.908"></a><a href="#glo:section"><code class="csfmt">\section</code></a>{<a id="wrglossary.909"></a><a href="#glo:glsxtrglossentry"><code class="csfmt">\glsxtrglossentry</code></a>{#1} <a id="wrglossary.910"></a><a href="#glo:glossentrysymbol"><code class="csfmt">\glossentrysymbol</code></a>{#1}}}
-{<a id="wrglossary.911"></a><a href="#glo:section"><code class="csfmt">\section</code></a>{<a id="wrglossary.912"></a><a href="#glo:glsxtrglossentry"><code class="csfmt">\glsxtrglossentry</code></a>{#1}}}
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.898"></a><a href="#glo:ifglshassymbol"><code class="csfmt">\ifglshassymbol</code></a>{#1}<span class="comment">% </span>
+{<a id="wrglossary.899"></a><a href="#glo:section"><code class="csfmt">\section</code></a>{<a id="wrglossary.900"></a><a href="#glo:glsxtrglossentry"><code class="csfmt">\glsxtrglossentry</code></a>{#1} <a id="wrglossary.901"></a><a href="#glo:glossentrysymbol"><code class="csfmt">\glossentrysymbol</code></a>{#1}}}
+{<a id="wrglossary.902"></a><a href="#glo:section"><code class="csfmt">\section</code></a>{<a id="wrglossary.903"></a><a href="#glo:glsxtrglossentry"><code class="csfmt">\glsxtrglossentry</code></a>{#1}}}
</pre>
<p>
-In both of the above examples, the section titles start with a <a id="wrglossary.913"></a><a href="#glo:idx.lowercase">lowercase</a>
-character (because the <a id="wrglossary.914"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> value is all <a id="wrglossary.915"></a><a href="#glo:idx.lowercase">lowercase</a> in
-entry definitions). You can apply automatic <a id="wrglossary.916"></a><a href="#glo:dual.casechange">case change</a> with the
-<a id="wrglossary.917"></a><a href="#glo:opt.catattr.glossname"><span class="csoptfmt">glossname</span></a> <a id="wrglossary.918"></a><a href="#glo:idx.categoryattribute">category attribute</a>. For example:
-<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.919"></a><a href="#glo:glssetcategoryattribute"><code class="xtrcsfmt">\glssetcategoryattribute</code></a>{<a id="wrglossary.920"></a><a href="#glo:opt.cat.general"><span class="catfmt">general</span></a>}{<a id="wrglossary.921"></a><a href="#glo:opt.catattr.glossname"><span class="csoptfmt">glossname</span></a>}{firstuc}
+In both of the above examples, the section titles start with a <a id="wrglossary.904"></a><a href="#glo:idx.lowercase">lowercase</a>
+character (because the <a id="wrglossary.905"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> value is all <a id="wrglossary.906"></a><a href="#glo:idx.lowercase">lowercase</a> in
+entry definitions). You can apply automatic <a id="wrglossary.907"></a><a href="#glo:dual.casechange">case change</a> with the
+<a id="wrglossary.908"></a><a href="#glo:opt.catattr.glossname"><span class="csoptfmt">glossname</span></a> <a id="wrglossary.909"></a><a href="#glo:idx.categoryattribute">category attribute</a>. For example:
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.910"></a><a href="#glo:glssetcategoryattribute"><code class="xtrcsfmt">\glssetcategoryattribute</code></a>{<a id="wrglossary.911"></a><a href="#glo:opt.cat.general"><span class="catfmt">general</span></a>}{<a id="wrglossary.912"></a><a href="#glo:opt.catattr.glossname"><span class="csoptfmt">glossname</span></a>}{firstuc}
</pre>
or (for title-case)
-<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.922"></a><a href="#glo:glssetcategoryattribute"><code class="xtrcsfmt">\glssetcategoryattribute</code></a>{<a id="wrglossary.923"></a><a href="#glo:opt.cat.general"><span class="catfmt">general</span></a>}{<a id="wrglossary.924"></a><a href="#glo:opt.catattr.glossname"><span class="csoptfmt">glossname</span></a>}{title}
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.913"></a><a href="#glo:glssetcategoryattribute"><code class="xtrcsfmt">\glssetcategoryattribute</code></a>{<a id="wrglossary.914"></a><a href="#glo:opt.cat.general"><span class="catfmt">general</span></a>}{<a id="wrglossary.915"></a><a href="#glo:opt.catattr.glossname"><span class="csoptfmt">glossname</span></a>}{title}
</pre>
-However, this won’t apply the <a id="wrglossary.925"></a><a href="#glo:dual.casechange">case change</a> in the table of contents
+However, this won’t apply the <a id="wrglossary.916"></a><a href="#glo:dual.casechange">case change</a> in the table of contents
or bookmarks. Instead you can use helper commands provided by
-<a id="wrglossary.926"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+ but make sure you have up-to-date
-versions of <a id="wrglossary.927"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> and <a id="wrglossary.928"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a>.
+<a id="wrglossary.917"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+ but make sure you have up-to-date
+versions of <a id="wrglossary.918"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> and <a id="wrglossary.919"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a>.
<p>
-In the second example, you can instead use <a id="wrglossary.929"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> to apply a
-<a id="wrglossary.930"></a><a href="#glo:dual.casechange">case change</a>. For example, to apply <a id="wrglossary.931"></a><a href="#glo:idx.sentencecase">sentence case</a> to the
-<a id="wrglossary.932"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> field:
-<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.933"></a><a href="#glo:GlsXtrLoadResources"><code class="xtrcsfmt">\GlsXtrLoadResources</code></a>[<a id="wrglossary.934"></a><a href="#glo:opt.resource.src"><span class="xtrcsoptfmt">src</span></a><span class="optfmt">={terms}</span>,
- <a id="wrglossary.935"></a><a href="#glo:opt.resource.sort"><span class="xtrcsoptfmt">sort</span></a><span class="optfmt">=none</span>,<a id="wrglossary.936"></a><a href="#glo:opt.resource.save-locations"><span class="xtrcsoptfmt">save-locations</span></a><span class="optfmt">=false</span><strong class="strong">,
- <a id="wrglossary.937"></a><a href="#glo:opt.resource.replicate-fields"><span class="xtrcsoptfmt">replicate-fields</span></a><span class="optfmt">={name=text}</span>,
- <a id="wrglossary.938"></a><a href="#glo:opt.resource.name-case-change"><span class="xtrcsoptfmt">name-case-change</span></a><span class="optfmt">=firstuc</span></strong>
+In the second example, you can instead use <a id="wrglossary.920"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> to apply a
+<a id="wrglossary.921"></a><a href="#glo:dual.casechange">case change</a>. For example, to apply <a id="wrglossary.922"></a><a href="#glo:idx.sentencecase">sentence case</a> to the
+<a id="wrglossary.923"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> field:
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.924"></a><a href="#glo:GlsXtrLoadResources"><code class="xtrcsfmt">\GlsXtrLoadResources</code></a>[<a id="wrglossary.925"></a><a href="#glo:opt.resource.src"><span class="xtrcsoptfmt">src</span></a><span class="optfmt">={terms}</span>,
+ <a id="wrglossary.926"></a><a href="#glo:opt.resource.sort"><span class="xtrcsoptfmt">sort</span></a><span class="optfmt">=none</span>,<a id="wrglossary.927"></a><a href="#glo:opt.resource.save-locations"><span class="xtrcsoptfmt">save-locations</span></a><span class="optfmt">=false</span><strong class="strong">,
+ <a id="wrglossary.928"></a><a href="#glo:opt.resource.replicate-fields"><span class="xtrcsoptfmt">replicate-fields</span></a><span class="optfmt">={name=text}</span>,
+ <a id="wrglossary.929"></a><a href="#glo:opt.resource.name-case-change"><span class="xtrcsoptfmt">name-case-change</span></a><span class="optfmt">=firstuc</span></strong>
]
</pre>
-(Or <a id="wrglossary.939"></a><a href="#glo:opt.resource.name-case-change"><span class="xtrcsoptfmt">name-case-change</span></a><span class="optfmt">=title</span> for <a id="wrglossary.940"></a><a href="#glo:idx.titlecase">title case</a>.)
-This copies the <a id="wrglossary.941"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> value to the <a id="wrglossary.942"></a><a href="#glo:opt.gloskey.text"><span class="csoptfmt">text</span></a> field and
-then applies a <a id="wrglossary.943"></a><a href="#glo:dual.casechange">case change</a> to the <a id="wrglossary.944"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> field (leaving the
-<a id="wrglossary.945"></a><a href="#glo:opt.gloskey.text"><span class="csoptfmt">text</span></a> field unchanged). The name in the section titles now
-starts with a capital but the <a id="wrglossary.946"></a><a href="#glo:dual.linktext">link text</a> produced by commands like
-<a id="wrglossary.947"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> is still <a id="wrglossary.948"></a><a href="#glo:idx.lowercase">lowercase</a>.
+(Or <a id="wrglossary.930"></a><a href="#glo:opt.resource.name-case-change"><span class="xtrcsoptfmt">name-case-change</span></a><span class="optfmt">=title</span> for <a id="wrglossary.931"></a><a href="#glo:idx.titlecase">title case</a>.)
+This copies the <a id="wrglossary.932"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> value to the <a id="wrglossary.933"></a><a href="#glo:opt.gloskey.text"><span class="csoptfmt">text</span></a> field and
+then applies a <a id="wrglossary.934"></a><a href="#glo:dual.casechange">case change</a> to the <a id="wrglossary.935"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> field (leaving the
+<a id="wrglossary.936"></a><a href="#glo:opt.gloskey.text"><span class="csoptfmt">text</span></a> field unchanged). The name in the section titles now
+starts with a capital but the <a id="wrglossary.937"></a><a href="#glo:dual.linktext">link text</a> produced by commands like
+<a id="wrglossary.938"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> is still <a id="wrglossary.939"></a><a href="#glo:idx.lowercase">lowercase</a>.
<p>
-In the first example (without <a id="wrglossary.949"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>) you can do this
+In the first example (without <a id="wrglossary.940"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>) you can do this
manually. For example:
-<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.950"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{set}{<a id="wrglossary.951"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={<strong class="strong">S</strong>et}</span>,<strong class="strong"><a id="wrglossary.952"></a><a href="#glo:opt.gloskey.text"><span class="csoptfmt">text</span></a><span class="optfmt">={set}</span></strong>,
- <a id="wrglossary.953"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a collection of any kind of objects}</span>,
- <a id="wrglossary.954"></a><a href="#glo:opt.gloskey.symbol"><span class="csoptfmt">symbol</span></a><span class="optfmt">={<a id="wrglossary.955"></a><a href="#glo:ensuremath"><code class="csfmt">\ensuremath</code></a>{<code class="cmd">\mathcal</code>{S}}}</span>
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.941"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{set}{<a id="wrglossary.942"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={<strong class="strong">S</strong>et}</span>,<strong class="strong"><a id="wrglossary.943"></a><a href="#glo:opt.gloskey.text"><span class="csoptfmt">text</span></a><span class="optfmt">={set}</span></strong>,
+ <a id="wrglossary.944"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a collection of any kind of objects}</span>,
+ <a id="wrglossary.945"></a><a href="#glo:opt.gloskey.symbol"><span class="csoptfmt">symbol</span></a><span class="optfmt">={<a id="wrglossary.946"></a><a href="#glo:ensuremath"><code class="csfmt">\ensuremath</code></a>{<code class="cmd">\mathcal</code>{S}}}</span>
}
</pre>
A more automated solution can be obtained with the standalone helper
-commands for the <a id="wrglossary.956"></a><a href="#glo:idx.PDFbookmark">PDF bookmark</a> and heading text (<a id="wrglossary.957"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+).
+commands for the <a id="wrglossary.947"></a><a href="#glo:idx.PDFbookmark">PDF bookmark</a> and heading text (<a id="wrglossary.948"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> v1.49+).
<p>
-Note that if you use the default <a id="wrglossary.958"></a><a href="#glo:opt.resource.save-locations"><span class="xtrcsoptfmt">save-locations</span></a><span class="optfmt">=true</span>
-with <a id="wrglossary.959"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>, it’s possible to combine Options <a href="#glo:idx.opt.b2g">4</a> and <a href="#glo:idx.opt.standalone">6</a>
+Note that if you use the default <a id="wrglossary.949"></a><a href="#glo:opt.resource.save-locations"><span class="xtrcsoptfmt">save-locations</span></a><span class="optfmt">=true</span>
+with <a id="wrglossary.950"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>, it’s possible to combine Options <a href="#glo:idx.opt.b2g">4</a> and <a href="#glo:idx.opt.standalone">6</a>
to have both standalone
-definitions and an index. In this case, a <a id="wrglossary.960"></a><a href="#glo:idx.glossarystyle">glossary style</a> is
-required. In the example below, I’ve use <a id="wrglossary.961"></a><a href="#glo:opt.glostyle.bookindex"><span class="xtrglostylefmt">bookindex</span></a>, which is provided in
-the <a id="wrglossary.962"></a><a href="#glo:pkg.glossary-bookindex"><span class="styfmt">glossary-bookindex</span></a> package (bundled with
-<a id="wrglossary.963"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>). I don’t need any of the other style
-packages, so I can still keep the <a id="wrglossary.964"></a><a href="#glo:opt.nostyles"><span class="styoptfmt">nostyles</span></a> option and just
-load <a id="wrglossary.965"></a><a href="#glo:pkg.glossary-bookindex"><span class="styfmt">glossary-bookindex</span></a>:
-<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\usepackage</code>[<a id="wrglossary.966"></a><a href="#glo:opt.record"><span class="xtrstyoptfmt">record</span></a><span class="optfmt">=nameref</span>,<span class="comment">% <- using <a id="wrglossary.967"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a></span>
- <a id="wrglossary.968"></a><a href="#glo:opt.nostyles"><span class="styoptfmt">nostyles</span></a>,<span class="comment">% <- don't load default style packages</span>
- <a id="wrglossary.969"></a><a href="#glo:opt.stylemods"><span class="xtrstyoptfmt">stylemods</span></a><span class="optfmt">=bookindex</span>,<span class="comment">% <- load glossary-bookindex.sty</span>
- <a id="wrglossary.970"></a><a href="#glo:opt.style"><span class="styoptfmt">style</span></a><span class="optfmt">=<a id="wrglossary.971"></a><a href="#glo:opt.glostyle.bookindex"><span class="xtrglostylefmt">bookindex</span></a></span><span class="comment">% <- set the default style to 'bookindex'</span>
+definitions and an index. In this case, a <a id="wrglossary.951"></a><a href="#glo:idx.glossarystyle">glossary style</a> is
+required. In the example below, I’ve use <a id="wrglossary.952"></a><a href="#glo:opt.glostyle.bookindex"><span class="xtrglostylefmt">bookindex</span></a>, which is provided in
+the <a id="wrglossary.953"></a><a href="#glo:pkg.glossary-bookindex"><span class="styfmt">glossary-bookindex</span></a> package (bundled with
+<a id="wrglossary.954"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>). I don’t need any of the other style
+packages, so I can still keep the <a id="wrglossary.955"></a><a href="#glo:opt.nostyles"><span class="styoptfmt">nostyles</span></a> option and just
+load <a id="wrglossary.956"></a><a href="#glo:pkg.glossary-bookindex"><span class="styfmt">glossary-bookindex</span></a>:
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\usepackage</code>[<a id="wrglossary.957"></a><a href="#glo:opt.record"><span class="xtrstyoptfmt">record</span></a><span class="optfmt">=nameref</span>,<span class="comment">% <- using <a id="wrglossary.958"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a></span>
+ <a id="wrglossary.959"></a><a href="#glo:opt.nostyles"><span class="styoptfmt">nostyles</span></a>,<span class="comment">% <- don't load default style packages</span>
+ <a id="wrglossary.960"></a><a href="#glo:opt.stylemods"><span class="xtrstyoptfmt">stylemods</span></a><span class="optfmt">=bookindex</span>,<span class="comment">% <- load glossary-bookindex.sty</span>
+ <a id="wrglossary.961"></a><a href="#glo:opt.style"><span class="styoptfmt">style</span></a><span class="optfmt">=<a id="wrglossary.962"></a><a href="#glo:opt.glostyle.bookindex"><span class="xtrglostylefmt">bookindex</span></a></span><span class="comment">% <- set the default style to 'bookindex'</span>
]{glossaries-extra}
</pre>
I also need to sort the entries, so the resource command is now:
-<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.972"></a><a href="#glo:GlsXtrLoadResources"><code class="xtrcsfmt">\GlsXtrLoadResources</code></a>[<a id="wrglossary.973"></a><a href="#glo:opt.resource.src"><span class="xtrcsoptfmt">src</span></a><span class="optfmt">={terms}</span>,<span class="comment">% definitions in terms.bib</span>
- <a id="wrglossary.974"></a><a href="#glo:opt.resource.sort"><span class="xtrcsoptfmt">sort</span></a><span class="optfmt">=en-GB</span>,<span class="comment">% sort by this locale</span>
- <a id="wrglossary.975"></a><a href="#glo:opt.resource.replicate-fields"><span class="xtrcsoptfmt">replicate-fields</span></a><span class="optfmt">={name=text}</span>,
- <a id="wrglossary.976"></a><a href="#glo:opt.resource.name-case-change"><span class="xtrcsoptfmt">name-case-change</span></a><span class="optfmt">=firstuc</span>
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.963"></a><a href="#glo:GlsXtrLoadResources"><code class="xtrcsfmt">\GlsXtrLoadResources</code></a>[<a id="wrglossary.964"></a><a href="#glo:opt.resource.src"><span class="xtrcsoptfmt">src</span></a><span class="optfmt">={terms}</span>,<span class="comment">% definitions in terms.bib</span>
+ <a id="wrglossary.965"></a><a href="#glo:opt.resource.sort"><span class="xtrcsoptfmt">sort</span></a><span class="optfmt">=en-GB</span>,<span class="comment">% sort by this locale</span>
+ <a id="wrglossary.966"></a><a href="#glo:opt.resource.replicate-fields"><span class="xtrcsoptfmt">replicate-fields</span></a><span class="optfmt">={name=text}</span>,
+ <a id="wrglossary.967"></a><a href="#glo:opt.resource.name-case-change"><span class="xtrcsoptfmt">name-case-change</span></a><span class="optfmt">=firstuc</span>
]
</pre>
-At the end of the document, I can add the <a id="wrglossary.977"></a><a href="#glo:dual.glossary">glossary</a>:
-<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.978"></a><a href="#glo:printunsrtglossary"><code class="xtrcsfmt">\printunsrtglossary</code></a>[<a id="wrglossary.979"></a><a href="#glo:opt.printgloss.title"><span class="csoptfmt">title</span></a><span class="optfmt">=Index</span>,<a id="wrglossary.980"></a><a href="#glo:opt.printgloss.target"><span class="xtrcsoptfmt">target</span></a><span class="optfmt">=false</span>]
+At the end of the document, I can add the <a id="wrglossary.968"></a><a href="#glo:dual.glossary">glossary</a>:
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.969"></a><a href="#glo:printunsrtglossary"><code class="xtrcsfmt">\printunsrtglossary</code></a>[<a id="wrglossary.970"></a><a href="#glo:opt.printgloss.title"><span class="csoptfmt">title</span></a><span class="optfmt">=Index</span>,<a id="wrglossary.971"></a><a href="#glo:opt.printgloss.target"><span class="xtrcsoptfmt">target</span></a><span class="optfmt">=false</span>]
</pre>
Note that I’ve had to switch off the hypertargets with
-<a id="wrglossary.981"></a><a href="#glo:opt.printgloss.target"><span class="xtrcsoptfmt">target</span></a><span class="optfmt">=false</span> (otherwise there would be duplicate
-targets). If you want <a id="wrglossary.982"></a><a href="#glo:idx.group">letter group</a> headings you need to use the
-<a id="wrglossary.983"></a><a href="#glo:switch.group"><span class="longargfmt">--group</span></a> switch:
-<pre class="terminal"><div class="terminaltitle"><a href="#glo:sym.terminal"><span title="Terminal" class="icon">〉_</span></a></div>bib2gls <a id="wrglossary.984"></a><a href="#glo:switch.group"><span class="longargfmt">--group</span></a> myDoc
+<a id="wrglossary.972"></a><a href="#glo:opt.printgloss.target"><span class="xtrcsoptfmt">target</span></a><span class="optfmt">=false</span> (otherwise there would be duplicate
+targets). If you want <a id="wrglossary.973"></a><a href="#glo:idx.group">letter group</a> headings you need to use the
+<a id="wrglossary.974"></a><a href="#glo:switch.group"><span class="longargfmt">--group</span></a> switch:
+<pre class="terminal"><div class="terminaltitle"><a href="#glo:sym.terminal"><span title="Terminal" class="icon">〉_</span></a></div>bib2gls <a id="wrglossary.975"></a><a href="#glo:switch.group"><span class="longargfmt">--group</span></a> myDoc
</pre>
-or if you are using <a id="wrglossary.985"></a><a href="#glo:app.arara"><span class="appfmt">arara</span></a>:
+or if you are using <a id="wrglossary.976"></a><a href="#glo:app.arara"><span class="appfmt">arara</span></a>:
<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div>% arara: bib2gls: { group: on }
</pre>
<p>
-The <a id="wrglossary.986"></a><a href="#glo:opt.glostyle.bookindex"><span class="xtrglostylefmt">bookindex</span></a> style doesn’t show the
+The <a id="wrglossary.977"></a><a href="#glo:opt.glostyle.bookindex"><span class="xtrglostylefmt">bookindex</span></a> style doesn’t show the
description, so only the name and location is displayed. Remember
-that the name has had a <a id="wrglossary.987"></a><a href="#glo:dual.casechange">case change</a> so it now starts with an
+that the name has had a <a id="wrglossary.978"></a><a href="#glo:dual.casechange">case change</a> so it now starts with an
initial capital. If you feel this is inappropriate for the index,
-you can adjust the <a id="wrglossary.988"></a><a href="#glo:opt.glostyle.bookindex"><span class="xtrglostylefmt">bookindex</span></a> style so that it uses
-the <a id="wrglossary.989"></a><a href="#glo:opt.gloskey.text"><span class="csoptfmt">text</span></a> field instead. For example:
-<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\renewcommand</code>*{<a id="wrglossary.990"></a><a href="#glo:glsxtrbookindexname"><code class="xtrcsfmt">\glsxtrbookindexname</code></a>}[1]{<span class="comment">% </span>
- <a id="wrglossary.991"></a><a href="#glo:glossentrynameother"><code class="xtrcsfmt">\glossentrynameother</code></a>{#1}{text}}
+you can adjust the <a id="wrglossary.979"></a><a href="#glo:opt.glostyle.bookindex"><span class="xtrglostylefmt">bookindex</span></a> style so that it uses
+the <a id="wrglossary.980"></a><a href="#glo:opt.gloskey.text"><span class="csoptfmt">text</span></a> field instead. For example:
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="cmd">\renewcommand</code>*{<a id="wrglossary.981"></a><a href="#glo:glsxtrbookindexname"><code class="xtrcsfmt">\glsxtrbookindexname</code></a>}[1]{<span class="comment">% </span>
+ <a id="wrglossary.982"></a><a href="#glo:glossentrynameother"><code class="xtrcsfmt">\glossentrynameother</code></a>{#1}{text}}
</pre>
-See the <a id="wrglossary.992"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> user manual for further details about
+See the <a id="wrglossary.983"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> user manual for further details about
this style.
<p>
Note that on the first LaTeX run none of the entries will be
@@ -7300,15 +7299,15 @@
<p>
If there are extra terms that need to be included in the index that
don’t have a description, you can define them with <code class="code">@index</code>
-in the <a id="wrglossary.993"></a><a href="#glo:ext.bib"><span class="extfmt">bib</span></a> file. For example:
+in the <a id="wrglossary.984"></a><a href="#glo:ext.bib"><span class="extfmt">bib</span></a> file. For example:
<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><code class="code">@index</code>{element}
-<code class="code">@index</code>{member,<a id="wrglossary.994"></a><a href="#glo:opt.gloskey.alias"><span class="xtrcsoptfmt">alias</span></a><span class="optfmt">={element}</span>}
+<code class="code">@index</code>{member,<a id="wrglossary.985"></a><a href="#glo:opt.gloskey.alias"><span class="xtrcsoptfmt">alias</span></a><span class="optfmt">={element}</span>}
</pre>
They can be used in the document as usual:
-<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div>The objects that make up a set are the <a id="wrglossary.995"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>{element}
-or <a id="wrglossary.996"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>{member}.
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div>The objects that make up a set are the <a id="wrglossary.986"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>{element}
+or <a id="wrglossary.987"></a><a href="#glo:glspl"><code class="csfmt">\glspl</code></a>{member}.
</pre>
-See <a href="http://mirrors.ctan.org/support/bib2gls/bib2gls-begin.pdf"><span class="styfmt">glossaries-extra</span> and <span class="appfmt">bib2gls</span>: An Introductory Guide</a> or the <a id="wrglossary.997"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> user manual for further
+See <a href="http://mirrors.ctan.org/support/bib2gls/bib2gls-begin.pdf"><span class="styfmt">glossaries-extra</span> and <span class="appfmt">bib2gls</span>: An Introductory Guide</a> or the <a id="wrglossary.988"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> user manual for further
details.
<p>
@@ -7318,41 +7317,41 @@
<h2><!-- start of section header -->1.4. Dummy Entries for Testing<span class="labellink"><a href="#sec:lipsum">[link]</a></span></h2><!-- end of section header -->
<p>
-In addition to the sample files described in §<a href="#sec:samples">18</a>, <a id="wrglossary.998"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a>
-also provides some files containing lorum ipsum dummy <a id="wrglossary.999"></a><a href="#glo:idx.glossaryentry">entries</a>. These
+In addition to the sample files described in §<a href="#sec:samples">18</a>, <a id="wrglossary.989"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a>
+also provides some files containing lorum ipsum dummy <a id="wrglossary.990"></a><a href="#glo:idx.glossaryentry">entries</a>. These
are provided for testing purposes and are on TeX’s path (in
<span class="filefmt">tex/latex/glossaries/test-entries</span>) so
-they can be included via <a id="wrglossary.1000"></a><a href="#glo:input"><code class="csfmt">\input</code></a> or <a id="wrglossary.1001"></a><a href="#glo:loadglsentries"><code class="csfmt">\loadglsentries</code></a>. The
-<a id="wrglossary.1002"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package provides <a id="wrglossary.1003"></a><a href="#glo:ext.bib"><span class="extfmt">bib</span></a> versions of
-all these files for use with <a id="wrglossary.1004"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>. The files are as
+they can be included via <a id="wrglossary.991"></a><a href="#glo:input"><code class="csfmt">\input</code></a> or <a id="wrglossary.992"></a><a href="#glo:loadglsentries"><code class="csfmt">\loadglsentries</code></a>. The
+<a id="wrglossary.993"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package provides <a id="wrglossary.994"></a><a href="#glo:ext.bib"><span class="extfmt">bib</span></a> versions of
+all these files for use with <a id="wrglossary.995"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>. The files are as
follows:
<p>
-<div class="filedef">🗋 <a id="wrglossary.1005"></a><dfn id="glo:file.example-glossaries-brief.tex"><span class="filefmt">example-glossaries-brief.tex</span></dfn></div><!-- end of filedef -->
+<div class="filedef">🗋 <a id="wrglossary.996"></a><dfn id="glo:file.example-glossaries-brief.tex"><span class="filefmt">example-glossaries-brief.tex</span></dfn></div><!-- end of filedef -->
These entries all have brief descriptions. For example:
-<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.1006"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{lorem}{<a id="wrglossary.1007"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={lorem}</span>,<a id="wrglossary.1008"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={ipsum}</span>}
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.997"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{lorem}{<a id="wrglossary.998"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={lorem}</span>,<a id="wrglossary.999"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={ipsum}</span>}
</pre>
<p>
-<div class="filedef">🗋 <a id="wrglossary.1009"></a><dfn id="glo:file.example-glossaries-utf8.tex"><span class="filefmt">example-glossaries-utf8.tex</span></dfn></div><!-- end of filedef -->
+<div class="filedef">🗋 <a id="wrglossary.1000"></a><dfn id="glo:file.example-glossaries-utf8.tex"><span class="filefmt">example-glossaries-utf8.tex</span></dfn></div><!-- end of filedef -->
-This file is based on <a id="wrglossary.1010"></a><a href="#glo:file.example-glossaries-brief.tex"><span class="filefmt">example-glossaries-brief.tex</span></a> but random
+This file is based on <a id="wrglossary.1001"></a><a href="#glo:file.example-glossaries-brief.tex"><span class="filefmt">example-glossaries-brief.tex</span></a> but random
characters have been converted to accented characters to test
-<a id="wrglossary.1011"></a><a href="#glo:dual.utf8">UTF-8</a> support.
+<a id="wrglossary.1002"></a><a href="#glo:dual.utf8">UTF-8</a> support.
<p>
-<div class="filedef">🗋 <a id="wrglossary.1012"></a><dfn id="glo:file.example-glossaries-long.tex"><span class="filefmt">example-glossaries-long.tex</span></dfn></div><!-- end of filedef -->
+<div class="filedef">🗋 <a id="wrglossary.1003"></a><dfn id="glo:file.example-glossaries-long.tex"><span class="filefmt">example-glossaries-long.tex</span></dfn></div><!-- end of filedef -->
These entries all have long descriptions. For example:
-<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.1013"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{loremipsum}{<a id="wrglossary.1014"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={lorem ipsum}</span>,
-<a id="wrglossary.1015"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={dolor sit amet, consectetuer adipiscing
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.1004"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{loremipsum}{<a id="wrglossary.1005"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={lorem ipsum}</span>,
+<a id="wrglossary.1006"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={dolor sit amet, consectetuer adipiscing
elit. Ut purus elit, vestibulum ut, placerat ac,
adipiscing vitae, felis. Curabitur dictum gravida
mauris.}</span>}
</pre>
<p>
-<div class="filedef">🗋 <a id="wrglossary.1016"></a><dfn id="glo:file.example-glossaries-multipar.tex"><span class="filefmt">example-glossaries-multipar.tex</span></dfn></div><!-- end of filedef -->
+<div class="filedef">🗋 <a id="wrglossary.1007"></a><dfn id="glo:file.example-glossaries-multipar.tex"><span class="filefmt">example-glossaries-multipar.tex</span></dfn></div><!-- end of filedef -->
These entries all have multi-paragraph descriptions. For example:
-<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.1017"></a><a href="#glo:longnewglossaryentry"><code class="csfmt">\longnewglossaryentry</code></a>{loremi-ii}{<a id="wrglossary.1018"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={lorem 1--2}</span>}<span class="comment">% </span>
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.1008"></a><a href="#glo:longnewglossaryentry"><code class="csfmt">\longnewglossaryentry</code></a>{loremi-ii}{<a id="wrglossary.1009"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={lorem 1--2}</span>}<span class="comment">% </span>
{<span class="comment">% </span>
Lorem ipsum ...
@@ -7360,71 +7359,71 @@
}
</pre>
<p>
-<div class="filedef">🗋 <a id="wrglossary.1019"></a><dfn id="glo:file.example-glossaries-symbols.tex"><span class="filefmt">example-glossaries-symbols.tex</span></dfn></div><!-- end of filedef -->
+<div class="filedef">🗋 <a id="wrglossary.1010"></a><dfn id="glo:file.example-glossaries-symbols.tex"><span class="filefmt">example-glossaries-symbols.tex</span></dfn></div><!-- end of filedef -->
-These entries all use the <a id="wrglossary.1020"></a><a href="#glo:opt.gloskey.symbol"><span class="csoptfmt">symbol</span></a> key. For example:
-<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.1021"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{alpha}{<a id="wrglossary.1022"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={alpha}</span>,
-<a id="wrglossary.1023"></a><a href="#glo:opt.gloskey.symbol"><span class="csoptfmt">symbol</span></a><span class="optfmt">={<a id="wrglossary.1024"></a><a href="#glo:ensuremath"><code class="csfmt">\ensuremath</code></a>{<a id="wrglossary.1025"></a><a href="#glo:alpha"><code class="csfmt">\alpha</code></a>}}</span>,
-<a id="wrglossary.1026"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={Quisque ullamcorper placerat ipsum.}</span>}
+These entries all use the <a id="wrglossary.1011"></a><a href="#glo:opt.gloskey.symbol"><span class="csoptfmt">symbol</span></a> key. For example:
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.1012"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{alpha}{<a id="wrglossary.1013"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={alpha}</span>,
+<a id="wrglossary.1014"></a><a href="#glo:opt.gloskey.symbol"><span class="csoptfmt">symbol</span></a><span class="optfmt">={<a id="wrglossary.1015"></a><a href="#glo:ensuremath"><code class="csfmt">\ensuremath</code></a>{<a id="wrglossary.1016"></a><a href="#glo:alpha"><code class="csfmt">\alpha</code></a>}}</span>,
+<a id="wrglossary.1017"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={Quisque ullamcorper placerat ipsum.}</span>}
</pre>
<p>
-<div class="filedef">🗋 <a id="wrglossary.1027"></a><dfn id="glo:file.example-glossaries-symbolnames.tex"><span class="filefmt">example-glossaries-symbolnames.tex</span></dfn></div><!-- end of filedef -->
+<div class="filedef">🗋 <a id="wrglossary.1018"></a><dfn id="glo:file.example-glossaries-symbolnames.tex"><span class="filefmt">example-glossaries-symbolnames.tex</span></dfn></div><!-- end of filedef -->
-Similar to the previous file but the <a id="wrglossary.1028"></a><a href="#glo:opt.gloskey.symbol"><span class="csoptfmt">symbol</span></a> key isn’t
-used. Instead the symbol is stored in the <a id="wrglossary.1029"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> key. For
+Similar to the previous file but the <a id="wrglossary.1019"></a><a href="#glo:opt.gloskey.symbol"><span class="csoptfmt">symbol</span></a> key isn’t
+used. Instead the symbol is stored in the <a id="wrglossary.1020"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> key. For
example:
-<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.1030"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{sym.alpha}{<a id="wrglossary.1031"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a><span class="optfmt">={alpha}</span>,
-<a id="wrglossary.1032"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={<a id="wrglossary.1033"></a><a href="#glo:ensuremath"><code class="csfmt">\ensuremath</code></a>{<a id="wrglossary.1034"></a><a href="#glo:alpha"><code class="csfmt">\alpha</code></a>}}</span>,
-<a id="wrglossary.1035"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={Quisque ullamcorper placerat ipsum.}</span>}
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.1021"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{sym.alpha}{<a id="wrglossary.1022"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a><span class="optfmt">={alpha}</span>,
+<a id="wrglossary.1023"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={<a id="wrglossary.1024"></a><a href="#glo:ensuremath"><code class="csfmt">\ensuremath</code></a>{<a id="wrglossary.1025"></a><a href="#glo:alpha"><code class="csfmt">\alpha</code></a>}}</span>,
+<a id="wrglossary.1026"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={Quisque ullamcorper placerat ipsum.}</span>}
</pre>
<p>
-<div class="filedef">🗋 <a id="wrglossary.1036"></a><dfn id="glo:file.example-glossaries-user.tex"><span class="filefmt">example-glossaries-user.tex</span></dfn></div><!-- end of filedef -->
+<div class="filedef">🗋 <a id="wrglossary.1027"></a><dfn id="glo:file.example-glossaries-user.tex"><span class="filefmt">example-glossaries-user.tex</span></dfn></div><!-- end of filedef -->
-The <a id="wrglossary.1037"></a><a href="#glo:hierarchicallevel">top level (level 0)</a> entries have the <a id="wrglossary.1038"></a><a href="#glo:opt.gloskey.symbol"><span class="csoptfmt">symbol</span></a> key and all
-<a id="wrglossary.1039"></a><a href="#glo:opt.gloskey.user1"><span class="csoptfmt">user1</span></a>, <a id="wrglossary.1040"></a><a id="wrglossary.1041"></a><a id="wrglossary.1042"></a><a id="wrglossary.1043"></a>…, <a id="wrglossary.1044"></a><a href="#glo:opt.gloskey.user6"><span class="csoptfmt">user6</span></a> keys set. For example:
-<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.1045"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{sample-a}
-{<a id="wrglossary.1046"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={a name}</span>,
-<a id="wrglossary.1047"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a description}</span>,
-<a id="wrglossary.1048"></a><a href="#glo:opt.gloskey.symbol"><span class="csoptfmt">symbol</span></a><span class="optfmt">={<code class="cmd">\ensuremath</code>{<code class="cmd">\alpha</code>}}</span>,
-<a id="wrglossary.1049"></a><a href="#glo:opt.gloskey.user1"><span class="csoptfmt">user1</span></a><span class="optfmt">={A}</span>,
-<a id="wrglossary.1050"></a><a href="#glo:opt.gloskey.user2"><span class="csoptfmt">user2</span></a><span class="optfmt">={1}</span>,
-<a id="wrglossary.1051"></a><a href="#glo:opt.gloskey.user3"><span class="csoptfmt">user3</span></a><span class="optfmt">={i}</span>,
-<a id="wrglossary.1052"></a><a href="#glo:opt.gloskey.user4"><span class="csoptfmt">user4</span></a><span class="optfmt">={A-i}</span>,
-<a id="wrglossary.1053"></a><a href="#glo:opt.gloskey.user5"><span class="csoptfmt">user5</span></a><span class="optfmt">={25.2020788573521}</span>,
-<a id="wrglossary.1054"></a><a href="#glo:opt.gloskey.user6"><span class="csoptfmt">user6</span></a><span class="optfmt">={1585-11-06}</span>}
+The <a id="wrglossary.1028"></a><a href="#glo:hierarchicallevel">top level (level 0)</a> entries have the <a id="wrglossary.1029"></a><a href="#glo:opt.gloskey.symbol"><span class="csoptfmt">symbol</span></a> key and all
+<a id="wrglossary.1030"></a><a href="#glo:opt.gloskey.user1"><span class="csoptfmt">user1</span></a>, <a id="wrglossary.1031"></a><a id="wrglossary.1032"></a><a id="wrglossary.1033"></a><a id="wrglossary.1034"></a>…, <a id="wrglossary.1035"></a><a href="#glo:opt.gloskey.user6"><span class="csoptfmt">user6</span></a> keys set. For example:
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.1036"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{sample-a}
+{<a id="wrglossary.1037"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={a name}</span>,
+<a id="wrglossary.1038"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={a description}</span>,
+<a id="wrglossary.1039"></a><a href="#glo:opt.gloskey.symbol"><span class="csoptfmt">symbol</span></a><span class="optfmt">={<code class="cmd">\ensuremath</code>{<code class="cmd">\alpha</code>}}</span>,
+<a id="wrglossary.1040"></a><a href="#glo:opt.gloskey.user1"><span class="csoptfmt">user1</span></a><span class="optfmt">={A}</span>,
+<a id="wrglossary.1041"></a><a href="#glo:opt.gloskey.user2"><span class="csoptfmt">user2</span></a><span class="optfmt">={1}</span>,
+<a id="wrglossary.1042"></a><a href="#glo:opt.gloskey.user3"><span class="csoptfmt">user3</span></a><span class="optfmt">={i}</span>,
+<a id="wrglossary.1043"></a><a href="#glo:opt.gloskey.user4"><span class="csoptfmt">user4</span></a><span class="optfmt">={A-i}</span>,
+<a id="wrglossary.1044"></a><a href="#glo:opt.gloskey.user5"><span class="csoptfmt">user5</span></a><span class="optfmt">={25.2020788573521}</span>,
+<a id="wrglossary.1045"></a><a href="#glo:opt.gloskey.user6"><span class="csoptfmt">user6</span></a><span class="optfmt">={1585-11-06}</span>}
</pre>
-There are also some <a id="wrglossary.1055"></a><a href="#glo:hierarchicallevel">level 1</a> entries, which may or may not have
-the <a id="wrglossary.1056"></a><a href="#glo:opt.gloskey.symbol"><span class="csoptfmt">symbol</span></a> and user keys set. For example:
-<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.1057"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{sample-b-0}
-{<a id="wrglossary.1058"></a><a href="#glo:opt.gloskey.parent"><span class="csoptfmt">parent</span></a><span class="optfmt">={sample-b}</span>,
-<a id="wrglossary.1059"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={b/0 name}</span>,
-<a id="wrglossary.1060"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={child 0 of b}</span>,
-<a id="wrglossary.1061"></a><a href="#glo:opt.gloskey.symbol"><span class="csoptfmt">symbol</span></a><span class="optfmt">={<code class="cmd">\ensuremath</code>{<code class="cmd">\sigma</code>}}</span>,
-<a id="wrglossary.1062"></a><a href="#glo:opt.gloskey.user2"><span class="csoptfmt">user2</span></a><span class="optfmt">={0}</span>,
-<a id="wrglossary.1063"></a><a href="#glo:opt.gloskey.user4"><span class="csoptfmt">user4</span></a><span class="optfmt">={a-i}</span>}
+There are also some <a id="wrglossary.1046"></a><a href="#glo:hierarchicallevel">level 1</a> entries, which may or may not have
+the <a id="wrglossary.1047"></a><a href="#glo:opt.gloskey.symbol"><span class="csoptfmt">symbol</span></a> and user keys set. For example:
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.1048"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{sample-b-0}
+{<a id="wrglossary.1049"></a><a href="#glo:opt.gloskey.parent"><span class="csoptfmt">parent</span></a><span class="optfmt">={sample-b}</span>,
+<a id="wrglossary.1050"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={b/0 name}</span>,
+<a id="wrglossary.1051"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={child 0 of b}</span>,
+<a id="wrglossary.1052"></a><a href="#glo:opt.gloskey.symbol"><span class="csoptfmt">symbol</span></a><span class="optfmt">={<code class="cmd">\ensuremath</code>{<code class="cmd">\sigma</code>}}</span>,
+<a id="wrglossary.1053"></a><a href="#glo:opt.gloskey.user2"><span class="csoptfmt">user2</span></a><span class="optfmt">={0}</span>,
+<a id="wrglossary.1054"></a><a href="#glo:opt.gloskey.user4"><span class="csoptfmt">user4</span></a><span class="optfmt">={a-i}</span>}
</pre>
-There are no deeper <a id="wrglossary.1064"></a><a href="#glo:hierarchicallevel">hierarchical</a> entries. Where set, the
-<a id="wrglossary.1065"></a><a href="#glo:opt.gloskey.user1"><span class="csoptfmt">user1</span></a> key is an <a id="wrglossary.1066"></a><a href="#glo:idx.uppercase">uppercase</a> letter (A–Z), the
-<a id="wrglossary.1067"></a><a href="#glo:opt.gloskey.user2"><span class="csoptfmt">user2</span></a> key is an integer, the <a id="wrglossary.1068"></a><a href="#glo:opt.gloskey.user3"><span class="csoptfmt">user3</span></a> key is a
-<a id="wrglossary.1069"></a><a href="#glo:idx.lowercase">lowercase</a> Roman numeral, the <a id="wrglossary.1070"></a><a href="#glo:opt.gloskey.user4"><span class="csoptfmt">user4</span></a> key is in the
+There are no deeper <a id="wrglossary.1055"></a><a href="#glo:hierarchicallevel">hierarchical</a> entries. Where set, the
+<a id="wrglossary.1056"></a><a href="#glo:opt.gloskey.user1"><span class="csoptfmt">user1</span></a> key is an <a id="wrglossary.1057"></a><a href="#glo:idx.uppercase">uppercase</a> letter (A–Z), the
+<a id="wrglossary.1058"></a><a href="#glo:opt.gloskey.user2"><span class="csoptfmt">user2</span></a> key is an integer, the <a id="wrglossary.1059"></a><a href="#glo:opt.gloskey.user3"><span class="csoptfmt">user3</span></a> key is a
+<a id="wrglossary.1060"></a><a href="#glo:idx.lowercase">lowercase</a> Roman numeral, the <a id="wrglossary.1061"></a><a href="#glo:opt.gloskey.user4"><span class="csoptfmt">user4</span></a> key is in the
form <span class="meta">〈<em class="metainner">alpha</em>〉</span>-<span class="meta">〈<em class="metainner">roman</em>〉</span> where <span class="meta">〈<em class="metainner">alpha</em>〉</span> is either an
-upper or <a id="wrglossary.1071"></a><a href="#glo:idx.lowercase">lowercase</a> letter (a–z or A–Z) and <span class="meta">〈<em class="metainner">roman</em>〉</span> is
-either an upper or <a id="wrglossary.1072"></a><a href="#glo:idx.lowercase">lowercase</a> Roman numeral. The
-<a id="wrglossary.1073"></a><a href="#glo:opt.gloskey.user5"><span class="csoptfmt">user5</span></a> key is a random number (in the range \((-50,+50)\)
-for <a id="wrglossary.1074"></a><a href="#glo:hierarchicallevel">top level (level 0)</a> entries and \((-1,+1)\) for child entries).
-The <a id="wrglossary.1075"></a><a href="#glo:opt.gloskey.user6"><span class="csoptfmt">user6</span></a> key is a random date between 1000-01-01 and
+upper or <a id="wrglossary.1062"></a><a href="#glo:idx.lowercase">lowercase</a> letter (a–z or A–Z) and <span class="meta">〈<em class="metainner">roman</em>〉</span> is
+either an upper or <a id="wrglossary.1063"></a><a href="#glo:idx.lowercase">lowercase</a> Roman numeral. The
+<a id="wrglossary.1064"></a><a href="#glo:opt.gloskey.user5"><span class="csoptfmt">user5</span></a> key is a random number (in the range \((-50,+50)\)
+for <a id="wrglossary.1065"></a><a href="#glo:hierarchicallevel">top level (level 0)</a> entries and \((-1,+1)\) for child entries).
+The <a id="wrglossary.1066"></a><a href="#glo:opt.gloskey.user6"><span class="csoptfmt">user6</span></a> key is a random date between 1000-01-01 and
2099-12-31.
<p>
-<div class="filedef">🗋 <a id="wrglossary.1076"></a><dfn id="glo:file.example-glossaries-images.tex"><span class="filefmt">example-glossaries-images.tex</span></dfn></div><!-- end of filedef -->
+<div class="filedef">🗋 <a id="wrglossary.1067"></a><dfn id="glo:file.example-glossaries-images.tex"><span class="filefmt">example-glossaries-images.tex</span></dfn></div><!-- end of filedef -->
-These entries use the <a id="wrglossary.1077"></a><a href="#glo:opt.gloskey.user1"><span class="csoptfmt">user1</span></a> key to store the name of an
-image file. (The images are provided by the <a id="wrglossary.1078"></a><a href="#glo:pkg.mwe"><span class="styfmt">mwe</span></a> package and
+These entries use the <a id="wrglossary.1068"></a><a href="#glo:opt.gloskey.user1"><span class="csoptfmt">user1</span></a> key to store the name of an
+image file. (The images are provided by the <a id="wrglossary.1069"></a><a href="#glo:pkg.mwe"><span class="styfmt">mwe</span></a> package and
should be on TeX’s path.) One entry doesn’t have an associated
image to help test for a missing key. The descriptions are long to
allow for tests with the text wrapping around the image. For
example:
-<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.1079"></a><a href="#glo:longnewglossaryentry"><code class="csfmt">\longnewglossaryentry</code></a>{sedfeugiat}{<a id="wrglossary.1080"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={sed feugiat}</span>,
-<a id="wrglossary.1081"></a><a href="#glo:opt.gloskey.user1"><span class="csoptfmt">user1</span></a><span class="optfmt">={example-image}</span>}<span class="comment">% </span>
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.1070"></a><a href="#glo:longnewglossaryentry"><code class="csfmt">\longnewglossaryentry</code></a>{sedfeugiat}{<a id="wrglossary.1071"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={sed feugiat}</span>,
+<a id="wrglossary.1072"></a><a href="#glo:opt.gloskey.user1"><span class="csoptfmt">user1</span></a><span class="optfmt">={example-image}</span>}<span class="comment">% </span>
{<span class="comment">% </span>
Cum sociis natoque...
@@ -7432,115 +7431,115 @@
}
</pre>
<p>
-<div class="filedef">🗋 <a id="wrglossary.1082"></a><dfn id="glo:file.example-glossaries-acronym.tex"><span class="filefmt">example-glossaries-acronym.tex</span></dfn></div><!-- end of filedef -->
+<div class="filedef">🗋 <a id="wrglossary.1073"></a><dfn id="glo:file.example-glossaries-acronym.tex"><span class="filefmt">example-glossaries-acronym.tex</span></dfn></div><!-- end of filedef -->
-These entries are all <a id="wrglossary.1083"></a><a href="#glo:idx.acronym">acronyms</a>. For example:
-<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.1084"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a>[<a id="wrglossary.1085"></a><a href="#glo:opt.gloskey.type"><span class="csoptfmt">type</span></a><span class="optfmt">={<a id="wrglossary.1086"></a><a href="#glo:glsdefaulttype"><code class="csfmt">\glsdefaulttype</code></a>}</span>]{lid}{LID}{lorem ipsum
+These entries are all <a id="wrglossary.1074"></a><a href="#glo:idx.acronym">acronyms</a>. For example:
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.1075"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a>[<a id="wrglossary.1076"></a><a href="#glo:opt.gloskey.type"><span class="csoptfmt">type</span></a><span class="optfmt">={<a id="wrglossary.1077"></a><a href="#glo:glsdefaulttype"><code class="csfmt">\glsdefaulttype</code></a>}</span>]{lid}{LID}{lorem ipsum
dolor}
</pre>
-<div class="information"><div class="informationtitle"><a id="wrglossary.1087"></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.1078"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a></div><!-- end of informationtitle -->
-If you use the <a id="wrglossary.1088"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> extension package, then
-<a id="wrglossary.1089"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a> is redefined to use <a id="wrglossary.1090"></a><a href="#glo:newabbreviation"><code class="xtrcsfmt">\newabbreviation</code></a>
-with the <a id="wrglossary.1091"></a><a href="#glo:opt.gloskey.category"><span class="xtrcsoptfmt">category</span></a> key set to <a id="wrglossary.1092"></a><a href="#glo:opt.cat.acronym"><span class="catfmt">acronym</span></a> (rather
-than the default <a id="wrglossary.1093"></a><a href="#glo:opt.cat.abbreviation"><span class="catfmt">abbreviation</span></a>). This means that you need to
-set the <a id="wrglossary.1094"></a><a href="#glo:idx.abbrvstyle"><span class="xtrfmt">abbreviation</span> style</a> for the <a id="wrglossary.1095"></a><a href="#glo:opt.cat.acronym"><span class="catfmt">acronym</span></a> category. For
+If you use the <a id="wrglossary.1079"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> extension package, then
+<a id="wrglossary.1080"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a> is redefined to use <a id="wrglossary.1081"></a><a href="#glo:newabbreviation"><code class="xtrcsfmt">\newabbreviation</code></a>
+with the <a id="wrglossary.1082"></a><a href="#glo:opt.gloskey.category"><span class="xtrcsoptfmt">category</span></a> key set to <a id="wrglossary.1083"></a><a href="#glo:opt.cat.acronym"><span class="catfmt">acronym</span></a> (rather
+than the default <a id="wrglossary.1084"></a><a href="#glo:opt.cat.abbreviation"><span class="catfmt">abbreviation</span></a>). This means that you need to
+set the <a id="wrglossary.1085"></a><a href="#glo:idx.abbrvstyle"><span class="xtrfmt">abbreviation</span> style</a> for the <a id="wrglossary.1086"></a><a href="#glo:opt.cat.acronym"><span class="catfmt">acronym</span></a> category. For
example:
-<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.1096"></a><a href="#glo:setabbreviationstyle"><code class="xtrcsfmt">\setabbreviationstyle</code></a>[acronym]{<a id="wrglossary.1097"></a><a href="#glo:opt.abbrstyle.long-short"><span class="abbrstylefmt">long-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.1087"></a><a href="#glo:setabbreviationstyle"><code class="xtrcsfmt">\setabbreviationstyle</code></a>[acronym]{<a id="wrglossary.1088"></a><a href="#glo:opt.abbrstyle.long-short"><span class="abbrstylefmt">long-short</span></a>}
</pre>
</div><!-- end of information -->
<p>
-<div class="filedef">🗋 <a id="wrglossary.1098"></a><dfn id="glo:file.example-glossaries-acronym-desc.tex"><span class="filefmt">example-glossaries-acronym-desc.tex</span></dfn></div><!-- end of filedef -->
+<div class="filedef">🗋 <a id="wrglossary.1089"></a><dfn id="glo:file.example-glossaries-acronym-desc.tex"><span class="filefmt">example-glossaries-acronym-desc.tex</span></dfn></div><!-- end of filedef -->
This file contains entries that are all
-<a id="wrglossary.1099"></a><a href="#glo:idx.acronym">acronyms</a> that use the <a id="wrglossary.1100"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a> key.
+<a id="wrglossary.1090"></a><a href="#glo:idx.acronym">acronyms</a> that use the <a id="wrglossary.1091"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a> key.
For example:
-<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.1101"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a>[<a id="wrglossary.1102"></a><a href="#glo:opt.gloskey.type"><span class="csoptfmt">type</span></a><span class="optfmt">={<a id="wrglossary.1103"></a><a href="#glo:glsdefaulttype"><code class="csfmt">\glsdefaulttype</code></a>}</span>,
- <a id="wrglossary.1104"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={fringilla a, euismod sodales,
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.1092"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a>[<a id="wrglossary.1093"></a><a href="#glo:opt.gloskey.type"><span class="csoptfmt">type</span></a><span class="optfmt">={<a id="wrglossary.1094"></a><a href="#glo:glsdefaulttype"><code class="csfmt">\glsdefaulttype</code></a>}</span>,
+ <a id="wrglossary.1095"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={fringilla a, euismod sodales,
sollicitudin vel, wisi}</span>]{ndl}{NDL}{nam dui ligula}
</pre>
-<div class="information"><div class="informationtitle"><a id="wrglossary.1105"></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.1096"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a></div><!-- end of informationtitle -->
-If you use the <a id="wrglossary.1106"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> extension package, then
-<a id="wrglossary.1107"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a> is redefined to use <a id="wrglossary.1108"></a><a href="#glo:newabbreviation"><code class="xtrcsfmt">\newabbreviation</code></a>
-with the <a id="wrglossary.1109"></a><a href="#glo:opt.gloskey.category"><span class="xtrcsoptfmt">category</span></a> key set to <a id="wrglossary.1110"></a><a href="#glo:opt.cat.acronym"><span class="catfmt">acronym</span></a> (rather
-than the default <a id="wrglossary.1111"></a><a href="#glo:opt.cat.abbreviation"><span class="catfmt">abbreviation</span></a>). This means that you need to
-set the <a id="wrglossary.1112"></a><a href="#glo:idx.abbrvstyle"><span class="xtrfmt">abbreviation</span> style</a> for the <a id="wrglossary.1113"></a><a href="#glo:opt.cat.acronym"><span class="catfmt">acronym</span></a> category. For
+If you use the <a id="wrglossary.1097"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> extension package, then
+<a id="wrglossary.1098"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a> is redefined to use <a id="wrglossary.1099"></a><a href="#glo:newabbreviation"><code class="xtrcsfmt">\newabbreviation</code></a>
+with the <a id="wrglossary.1100"></a><a href="#glo:opt.gloskey.category"><span class="xtrcsoptfmt">category</span></a> key set to <a id="wrglossary.1101"></a><a href="#glo:opt.cat.acronym"><span class="catfmt">acronym</span></a> (rather
+than the default <a id="wrglossary.1102"></a><a href="#glo:opt.cat.abbreviation"><span class="catfmt">abbreviation</span></a>). This means that you need to
+set the <a id="wrglossary.1103"></a><a href="#glo:idx.abbrvstyle"><span class="xtrfmt">abbreviation</span> style</a> for the <a id="wrglossary.1104"></a><a href="#glo:opt.cat.acronym"><span class="catfmt">acronym</span></a> category. For
example:
-<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.1114"></a><a href="#glo:setabbreviationstyle"><code class="xtrcsfmt">\setabbreviationstyle</code></a>[<a id="wrglossary.1115"></a><a href="#glo:opt.cat.acronym"><span class="catfmt">acronym</span></a>]{<a id="wrglossary.1116"></a><a href="#glo:opt.abbrstyle.long-short-desc"><span class="abbrstylefmt">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.1105"></a><a href="#glo:setabbreviationstyle"><code class="xtrcsfmt">\setabbreviationstyle</code></a>[<a id="wrglossary.1106"></a><a href="#glo:opt.cat.acronym"><span class="catfmt">acronym</span></a>]{<a id="wrglossary.1107"></a><a href="#glo:opt.abbrstyle.long-short-desc"><span class="abbrstylefmt">long-short-desc</span></a>}
</pre>
</div><!-- end of information -->
<p>
-<div class="filedef">🗋 <a id="wrglossary.1117"></a><dfn id="glo:file.example-glossaries-acronyms-lang.tex"><span class="filefmt">example-glossaries-acronyms-lang.tex</span></dfn></div><!-- end of filedef -->
+<div class="filedef">🗋 <a id="wrglossary.1108"></a><dfn id="glo:file.example-glossaries-acronyms-lang.tex"><span class="filefmt">example-glossaries-acronyms-lang.tex</span></dfn></div><!-- end of filedef -->
-These entries are all <a id="wrglossary.1118"></a><a href="#glo:idx.acronym">acronyms</a>, where some of them have
-a translation supplied in the <a id="wrglossary.1119"></a><a href="#glo:opt.gloskey.user1"><span class="csoptfmt">user1</span></a> key.
+These entries are all <a id="wrglossary.1109"></a><a href="#glo:idx.acronym">acronyms</a>, where some of them have
+a translation supplied in the <a id="wrglossary.1110"></a><a href="#glo:opt.gloskey.user1"><span class="csoptfmt">user1</span></a> key.
For example:
-<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.1120"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a>[<a id="wrglossary.1121"></a><a href="#glo:opt.gloskey.type"><span class="csoptfmt">type</span></a><span class="optfmt">={<a id="wrglossary.1122"></a><a href="#glo:glsdefaulttype"><code class="csfmt">\glsdefaulttype</code></a>}</span>,<a id="wrglossary.1123"></a><a href="#glo:opt.gloskey.user1"><span class="csoptfmt">user1</span></a><span class="optfmt">={love itself}</span>]
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.1111"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a>[<a id="wrglossary.1112"></a><a href="#glo:opt.gloskey.type"><span class="csoptfmt">type</span></a><span class="optfmt">={<a id="wrglossary.1113"></a><a href="#glo:glsdefaulttype"><code class="csfmt">\glsdefaulttype</code></a>}</span>,<a id="wrglossary.1114"></a><a href="#glo:opt.gloskey.user1"><span class="csoptfmt">user1</span></a><span class="optfmt">={love itself}</span>]
{li}{LI}{lorem ipsum}
</pre>
-<div class="information"><div class="informationtitle"><a id="wrglossary.1124"></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.1115"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a></div><!-- end of informationtitle -->
-If you use the <a id="wrglossary.1125"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> extension package, then
-<a id="wrglossary.1126"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a> is redefined to use <a id="wrglossary.1127"></a><a href="#glo:newabbreviation"><code class="xtrcsfmt">\newabbreviation</code></a>
-with the <a id="wrglossary.1128"></a><a href="#glo:opt.gloskey.category"><span class="xtrcsoptfmt">category</span></a> key set to <a id="wrglossary.1129"></a><a href="#glo:opt.cat.acronym"><span class="catfmt">acronym</span></a> (rather
-than the default <a id="wrglossary.1130"></a><a href="#glo:opt.cat.abbreviation"><span class="catfmt">abbreviation</span></a>). This means that you need to
-set the <a id="wrglossary.1131"></a><a href="#glo:idx.abbrvstyle"><span class="xtrfmt">abbreviation</span> style</a> for the <a id="wrglossary.1132"></a><a href="#glo:opt.cat.acronym"><span class="catfmt">acronym</span></a> category. For
+If you use the <a id="wrglossary.1116"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> extension package, then
+<a id="wrglossary.1117"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a> is redefined to use <a id="wrglossary.1118"></a><a href="#glo:newabbreviation"><code class="xtrcsfmt">\newabbreviation</code></a>
+with the <a id="wrglossary.1119"></a><a href="#glo:opt.gloskey.category"><span class="xtrcsoptfmt">category</span></a> key set to <a id="wrglossary.1120"></a><a href="#glo:opt.cat.acronym"><span class="catfmt">acronym</span></a> (rather
+than the default <a id="wrglossary.1121"></a><a href="#glo:opt.cat.abbreviation"><span class="catfmt">abbreviation</span></a>). This means that you need to
+set the <a id="wrglossary.1122"></a><a href="#glo:idx.abbrvstyle"><span class="xtrfmt">abbreviation</span> style</a> for the <a id="wrglossary.1123"></a><a href="#glo:opt.cat.acronym"><span class="catfmt">acronym</span></a> category. For
example:
-<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.1133"></a><a href="#glo:setabbreviationstyle"><code class="xtrcsfmt">\setabbreviationstyle</code></a>[<a id="wrglossary.1134"></a><a href="#glo:opt.cat.acronym"><span class="catfmt">acronym</span></a>]{<a id="wrglossary.1135"></a><a href="#glo:opt.abbrstyle.long-short-user"><span class="abbrstylefmt">long-short-user</span></a>}
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.1124"></a><a href="#glo:setabbreviationstyle"><code class="xtrcsfmt">\setabbreviationstyle</code></a>[<a id="wrglossary.1125"></a><a href="#glo:opt.cat.acronym"><span class="catfmt">acronym</span></a>]{<a id="wrglossary.1126"></a><a href="#glo:opt.abbrstyle.long-short-user"><span class="abbrstylefmt">long-short-user</span></a>}
</pre>
</div><!-- end of information -->
<p>
-<div class="filedef">🗋 <a id="wrglossary.1136"></a><dfn id="glo:file.example-glossaries-parent.tex"><span class="filefmt">example-glossaries-parent.tex</span></dfn></div><!-- end of filedef -->
+<div class="filedef">🗋 <a id="wrglossary.1127"></a><dfn id="glo:file.example-glossaries-parent.tex"><span class="filefmt">example-glossaries-parent.tex</span></dfn></div><!-- end of filedef -->
These are hierarchical entries where the child entries
-use the <a id="wrglossary.1137"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> key. For example:
-<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.1138"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{sedmattis}{<a id="wrglossary.1139"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={sed mattis}</span>,
-<a id="wrglossary.1140"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={erat sit amet}</span>}
+use the <a id="wrglossary.1128"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> key. For example:
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.1129"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{sedmattis}{<a id="wrglossary.1130"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={sed mattis}</span>,
+<a id="wrglossary.1131"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={erat sit amet}</span>}
-<a id="wrglossary.1141"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{gravida}{<a id="wrglossary.1142"></a><a href="#glo:opt.gloskey.parent"><span class="csoptfmt">parent</span></a><span class="optfmt">={sedmattis}</span>,
- <a id="wrglossary.1143"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={gravida}</span>,<a id="wrglossary.1144"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={malesuada}</span>}
+<a id="wrglossary.1132"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{gravida}{<a id="wrglossary.1133"></a><a href="#glo:opt.gloskey.parent"><span class="csoptfmt">parent</span></a><span class="optfmt">={sedmattis}</span>,
+ <a id="wrglossary.1134"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={gravida}</span>,<a id="wrglossary.1135"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={malesuada}</span>}
</pre>
<p>
-<div class="filedef">🗋 <a id="wrglossary.1145"></a><dfn id="glo:file.example-glossaries-childnoname.tex"><span class="filefmt">example-glossaries-childnoname.tex</span></dfn></div><!-- end of filedef -->
+<div class="filedef">🗋 <a id="wrglossary.1136"></a><dfn id="glo:file.example-glossaries-childnoname.tex"><span class="filefmt">example-glossaries-childnoname.tex</span></dfn></div><!-- end of filedef -->
These are hierarchical entries where the child entries
-don’t use the <a id="wrglossary.1146"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> key.
+don’t use the <a id="wrglossary.1137"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> key.
For example:
-<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.1147"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{scelerisque}{<a id="wrglossary.1148"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={scelerisque}</span>,
- <a id="wrglossary.1149"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={at}</span>}
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.1138"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{scelerisque}{<a id="wrglossary.1139"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={scelerisque}</span>,
+ <a id="wrglossary.1140"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={at}</span>}
-<a id="wrglossary.1150"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{vestibulum}{<a id="wrglossary.1151"></a><a href="#glo:opt.gloskey.parent"><span class="csoptfmt">parent</span></a><span class="optfmt">={scelerisque}</span>,
- <a id="wrglossary.1152"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={eu, nulla}</span>}
+<a id="wrglossary.1141"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{vestibulum}{<a id="wrglossary.1142"></a><a href="#glo:opt.gloskey.parent"><span class="csoptfmt">parent</span></a><span class="optfmt">={scelerisque}</span>,
+ <a id="wrglossary.1143"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={eu, nulla}</span>}
</pre>
<p>
-<div class="filedef">🗋 <a id="wrglossary.1153"></a><dfn id="glo:file.example-glossaries-longchild.tex"><span class="filefmt">example-glossaries-longchild.tex</span></dfn></div><!-- end of filedef -->
+<div class="filedef">🗋 <a id="wrglossary.1144"></a><dfn id="glo:file.example-glossaries-longchild.tex"><span class="filefmt">example-glossaries-longchild.tex</span></dfn></div><!-- end of filedef -->
These entries all have long descriptions and there are some
child entries. For example:
-<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.1154"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{longsedmattis}{<a id="wrglossary.1155"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={sed mattis}</span>,
- <a id="wrglossary.1156"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={erat sit amet dolor sit amet, consectetuer adipiscing elit.
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.1145"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{longsedmattis}{<a id="wrglossary.1146"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={sed mattis}</span>,
+ <a id="wrglossary.1147"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={erat sit amet dolor sit amet, consectetuer adipiscing elit.
Ut purus elit, vestibulum ut, placerat ac, adipiscing vitae, felis.
Curabitur dictum gravida mauris.}</span>}
-<a id="wrglossary.1157"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{longgravida}{<a id="wrglossary.1158"></a><a href="#glo:opt.gloskey.parent"><span class="csoptfmt">parent</span></a><span class="optfmt">={longsedmattis}</span>,<a id="wrglossary.1159"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={gravida}</span>,
- <a id="wrglossary.1160"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={malesuada libero, nonummy eget, consectetuer id, vulputate a,
+<a id="wrglossary.1148"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{longgravida}{<a id="wrglossary.1149"></a><a href="#glo:opt.gloskey.parent"><span class="csoptfmt">parent</span></a><span class="optfmt">={longsedmattis}</span>,<a id="wrglossary.1150"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={gravida}</span>,
+ <a id="wrglossary.1151"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={malesuada libero, nonummy eget, consectetuer id, vulputate a,
magna. Donec vehicula augue eu neque. Pellentesque habitant morbi tristique
senectus et netus et malesuada fames ac turpis egestas. Mauris ut
leo.}</span>}
</pre>
<p>
-<div class="filedef">🗋 <a id="wrglossary.1161"></a><dfn id="glo:file.example-glossaries-childmultipar.tex"><span class="filefmt">example-glossaries-childmultipar.tex</span></dfn></div><!-- end of filedef -->
+<div class="filedef">🗋 <a id="wrglossary.1152"></a><dfn id="glo:file.example-glossaries-childmultipar.tex"><span class="filefmt">example-glossaries-childmultipar.tex</span></dfn></div><!-- end of filedef -->
This consists of parent entries with single paragraph descriptions and
child entries with multi-paragraph descriptions. Some entries have
-the <a id="wrglossary.1162"></a><a href="#glo:opt.gloskey.user1"><span class="csoptfmt">user1</span></a> key set to the name of an image file provided by
-the <a id="wrglossary.1163"></a><a href="#glo:pkg.mwe"><span class="styfmt">mwe</span></a> package. For example:
-<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.1164"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{hiersedmattis}{<a id="wrglossary.1165"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={sed mattis}</span>,<a id="wrglossary.1166"></a><a href="#glo:opt.gloskey.user1"><span class="csoptfmt">user1</span></a><span class="optfmt">={example-image}</span>,
- <a id="wrglossary.1167"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={Erat sit amet dolor sit amet, consectetuer adipiscing elit.
+the <a id="wrglossary.1153"></a><a href="#glo:opt.gloskey.user1"><span class="csoptfmt">user1</span></a> key set to the name of an image file provided by
+the <a id="wrglossary.1154"></a><a href="#glo:pkg.mwe"><span class="styfmt">mwe</span></a> package. For example:
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.1155"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{hiersedmattis}{<a id="wrglossary.1156"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={sed mattis}</span>,<a id="wrglossary.1157"></a><a href="#glo:opt.gloskey.user1"><span class="csoptfmt">user1</span></a><span class="optfmt">={example-image}</span>,
+ <a id="wrglossary.1158"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={Erat sit amet dolor sit amet, consectetuer adipiscing elit.
Ut purus elit, vestibulum ut, placerat ac, adipiscing vitae, felis. Curabitur
dictum gravida mauris. Ut pellentesque augue sed urna. Vestibulum
diam eros, fringilla et, consectetuer eu, nonummy id, sapien. Nullam
@@ -7547,8 +7546,8 @@
at lectus. In sagittis ultrices mauris. Curabitur malesuada erat sit
amet massa. Fusce blandit. Aliquam erat volutpat.}</span>}
-<a id="wrglossary.1168"></a><a href="#glo:longnewglossaryentry"><code class="csfmt">\longnewglossaryentry</code></a>{hierloremi-ii}
-{<a id="wrglossary.1169"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={lorem 1--2}</span>,<a id="wrglossary.1170"></a><a href="#glo:opt.gloskey.parent"><span class="csoptfmt">parent</span></a><span class="optfmt">={hiersedmattis}</span>}<span class="comment">% </span>
+<a id="wrglossary.1159"></a><a href="#glo:longnewglossaryentry"><code class="csfmt">\longnewglossaryentry</code></a>{hierloremi-ii}
+{<a id="wrglossary.1160"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={lorem 1--2}</span>,<a id="wrglossary.1161"></a><a href="#glo:opt.gloskey.parent"><span class="csoptfmt">parent</span></a><span class="optfmt">={hiersedmattis}</span>}<span class="comment">% </span>
{<span class="comment">% </span>
Lorem ipsum ...
@@ -7556,26 +7555,26 @@
}
</pre>
<p>
-<div class="filedef">🗋 <a id="wrglossary.1171"></a><dfn id="glo:file.example-glossaries-cite.tex"><span class="filefmt">example-glossaries-cite.tex</span></dfn></div><!-- end of filedef -->
+<div class="filedef">🗋 <a id="wrglossary.1162"></a><dfn id="glo:file.example-glossaries-cite.tex"><span class="filefmt">example-glossaries-cite.tex</span></dfn></div><!-- end of filedef -->
These entries use the
-<a id="wrglossary.1172"></a><a href="#glo:opt.gloskey.user1"><span class="csoptfmt">user1</span></a> key to store a citation key (or comma-separated list
+<a id="wrglossary.1163"></a><a href="#glo:opt.gloskey.user1"><span class="csoptfmt">user1</span></a> key to store a citation key (or comma-separated list
of citation keys). The citations are defined in <span class="filefmt">xampl.bib</span>,
which should be available on all modern TeX distributions.
One entry doesn’t have an associated citation to help test for a missing
key.
For example:
-<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.1173"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{fusce}{<a id="wrglossary.1174"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={fusce}</span>,
-<a id="wrglossary.1175"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={suscipit cursus sem}</span>,<a id="wrglossary.1176"></a><a href="#glo:opt.gloskey.user1"><span class="csoptfmt">user1</span></a><span class="optfmt">={article-minimal}</span>}
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.1164"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{fusce}{<a id="wrglossary.1165"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={fusce}</span>,
+<a id="wrglossary.1166"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={suscipit cursus sem}</span>,<a id="wrglossary.1167"></a><a href="#glo:opt.gloskey.user1"><span class="csoptfmt">user1</span></a><span class="optfmt">={article-minimal}</span>}
</pre>
<p>
-<div class="filedef">🗋 <a id="wrglossary.1177"></a><dfn id="glo:file.example-glossaries-url.tex"><span class="filefmt">example-glossaries-url.tex</span></dfn></div><!-- end of filedef -->
+<div class="filedef">🗋 <a id="wrglossary.1168"></a><dfn id="glo:file.example-glossaries-url.tex"><span class="filefmt">example-glossaries-url.tex</span></dfn></div><!-- end of filedef -->
-These entries use the <a id="wrglossary.1178"></a><a href="#glo:opt.gloskey.user1"><span class="csoptfmt">user1</span></a> key to store an <a id="wrglossary.1179"></a><a href="#glo:URL">URL</a> associated
+These entries use the <a id="wrglossary.1169"></a><a href="#glo:opt.gloskey.user1"><span class="csoptfmt">user1</span></a> key to store an <a id="wrglossary.1170"></a><a href="#glo:URL">URL</a> associated
with the entry. For example:
-<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.1180"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{aenean-url}{<a id="wrglossary.1181"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={aenean}</span>,
- <a id="wrglossary.1182"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={adipiscing auctor est}</span>,
- <a id="wrglossary.1183"></a><a href="#glo:opt.gloskey.user1"><span class="csoptfmt">user1</span></a><span class="optfmt">={http://uk.tug.org/}</span>}
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.1171"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{aenean-url}{<a id="wrglossary.1172"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={aenean}</span>,
+ <a id="wrglossary.1173"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={adipiscing auctor est}</span>,
+ <a id="wrglossary.1174"></a><a href="#glo:opt.gloskey.user1"><span class="csoptfmt">user1</span></a><span class="optfmt">={http://uk.tug.org/}</span>}
</pre>
<p>
The sample file <a href="http://mirrors.ctan.org/macros/latex/contrib/glossaries/samples//glossary-lipsum-examples.tex"><span class="filefmt">glossary-lipsum-examples.tex</span></a> in the
@@ -7582,22 +7581,22 @@
<span class="filefmt">doc/latex/glossaries/samples</span> directory
uses all these files. See also <a href="https://www.dickimaw-books.com/gallery/#glossaries"><span class="styfmt">glossaries</span> gallery</a>.
<p>
-<div class="sidenote"><a id="wrglossary.1184"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a></div><span class="clearfix"></span><!-- end of sidenote -->
-The <a id="wrglossary.1185"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package provides the additional test file:
-<div class="filedef">🗋 <a id="wrglossary.1186"></a><dfn id="glo:file.example-glossaries-xr.tex"><span class="filefmt">example-glossaries-xr.tex</span></dfn></div><!-- end of filedef -->
+<div class="sidenote"><a id="wrglossary.1175"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a></div><span class="clearfix"></span><!-- end of sidenote -->
+The <a id="wrglossary.1176"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package provides the additional test file:
+<div class="filedef">🗋 <a id="wrglossary.1177"></a><dfn id="glo:file.example-glossaries-xr.tex"><span class="filefmt">example-glossaries-xr.tex</span></dfn></div><!-- end of filedef -->
-These entries use the <a id="wrglossary.1187"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a> key provided by the base
-<span class="styfmt">glossaries</span> package and also the <a id="wrglossary.1188"></a><a href="#glo:opt.gloskey.alias"><span class="xtrcsoptfmt">alias</span></a> and
-<a id="wrglossary.1189"></a><a href="#glo:opt.gloskey.seealso"><span class="xtrcsoptfmt">seealso</span></a> keys that require <a id="wrglossary.1190"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>. For
+These entries use the <a id="wrglossary.1178"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a> key provided by the base
+<span class="styfmt">glossaries</span> package and also the <a id="wrglossary.1179"></a><a href="#glo:opt.gloskey.alias"><span class="xtrcsoptfmt">alias</span></a> and
+<a id="wrglossary.1180"></a><a href="#glo:opt.gloskey.seealso"><span class="xtrcsoptfmt">seealso</span></a> keys that require <a id="wrglossary.1181"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>. For
example:
-<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.1191"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{alias-lorem}{<a id="wrglossary.1192"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={alias-lorem}</span>,
- <a id="wrglossary.1193"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={ipsum}</span>,<a id="wrglossary.1194"></a><a href="#glo:opt.gloskey.alias"><span class="xtrcsoptfmt">alias</span></a><span class="optfmt">={lorem}</span>}
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.1182"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{alias-lorem}{<a id="wrglossary.1183"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={alias-lorem}</span>,
+ <a id="wrglossary.1184"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={ipsum}</span>,<a id="wrglossary.1185"></a><a href="#glo:opt.gloskey.alias"><span class="xtrcsoptfmt">alias</span></a><span class="optfmt">={lorem}</span>}
-<a id="wrglossary.1195"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{amet}{<a id="wrglossary.1196"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={amet}</span>,<a id="wrglossary.1197"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={consectetuer}</span>,
- <a id="wrglossary.1198"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a><span class="optfmt">={dolor}</span>}
+<a id="wrglossary.1186"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{amet}{<a id="wrglossary.1187"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={amet}</span>,<a id="wrglossary.1188"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={consectetuer}</span>,
+ <a id="wrglossary.1189"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a><span class="optfmt">={dolor}</span>}
-<a id="wrglossary.1199"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{arcu}<a id="wrglossary.1200"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={arcu}</span>,<a id="wrglossary.1201"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={libero}</span>,
- <a id="wrglossary.1202"></a><a href="#glo:opt.gloskey.seealso"><span class="xtrcsoptfmt">seealso</span></a><span class="optfmt">={placerat,vitae,curabitur}</span>
+<a id="wrglossary.1190"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{arcu}<a id="wrglossary.1191"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={arcu}</span>,<a id="wrglossary.1192"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={libero}</span>,
+ <a id="wrglossary.1193"></a><a href="#glo:opt.gloskey.seealso"><span class="xtrcsoptfmt">seealso</span></a><span class="optfmt">={placerat,vitae,curabitur}</span>
</pre>
<p>
@@ -7609,18 +7608,18 @@
<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.1203"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package uses the <a id="wrglossary.1204"></a><a href="#glo:pkg.tracklang"><span class="styfmt">tracklang</span></a> package
+The <a id="wrglossary.1194"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package uses the <a id="wrglossary.1195"></a><a href="#glo:pkg.tracklang"><span class="styfmt">tracklang</span></a> package
to determine the document languages. Unfortunately, because there
isn’t a standard language identification framework provided with
-LaTeX, <a id="wrglossary.1205"></a><a href="#glo:pkg.tracklang"><span class="styfmt">tracklang</span></a> isn’t always able to detect the selected
+LaTeX, <a id="wrglossary.1196"></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.
<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.
+You will needed at least version 1.6.4 of <a id="wrglossary.1197"></a><a href="#glo:pkg.tracklang"><span class="styfmt">tracklang</span></a> to
+support <a id="wrglossary.1198"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span>’s</a> <a id="wrglossary.1199"></a><a href="#glo:babelprovide"><code class="csfmt">\babelprovide</code></a>. All instances of
+<a id="wrglossary.1200"></a><a href="#glo:babelprovide"><code class="csfmt">\babelprovide</code></a> need to occur before <a id="wrglossary.1201"></a><a href="#glo:pkg.tracklang"><span class="styfmt">tracklang</span></a> is loaded.
+In the event that <a id="wrglossary.1202"></a><a href="#glo:pkg.tracklang"><span class="styfmt">tracklang</span></a> can’t detect the language, use the <a id="wrglossary.1203"></a><a href="#glo:opt.languages"><span class="styoptfmt">languages</span></a>
+or <a id="wrglossary.1204"></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.
@@ -7627,46 +7626,46 @@
</div><!-- end of important -->
<p>
-For example (using <a id="wrglossary.1214"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a>):
+For example (using <a id="wrglossary.1205"></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.1215"></a><a href="#glo:pkg.translator"><span class="styfmt">translator</span></a>. Compare this with:
+load <a id="wrglossary.1206"></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.1216"></a><a href="#glo:pkg.translator"><span class="styfmt">translator</span></a>.
+<a id="wrglossary.1207"></a><a href="#glo:pkg.translator"><span class="styfmt">translator</span></a>.
<p>
-In both the above cases, <a id="wrglossary.1217"></a><a href="#glo:pkg.tracklang"><span class="styfmt">tracklang</span></a> will automatically
+In both the above cases, <a id="wrglossary.1208"></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.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
+<a id="wrglossary.1209"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> will use the definitions in
+<a id="wrglossary.1210"></a><a href="#glo:file.glossaries-german.ldf"><span class="filefmt">glossaries-german.ldf</span></a> (which needs to be installed
separately).
<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.1220"></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.1211"></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.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
+The above document doesn’t load <a id="wrglossary.1212"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a> or <a id="wrglossary.1213"></a><a href="#glo:pkg.polyglossia"><span class="styfmt">polyglossia</span></a> or
+<a id="wrglossary.1214"></a><a href="#glo:pkg.translator"><span class="styfmt">translator</span></a>, but the <a id="wrglossary.1215"></a><a href="#glo:opt.translate"><span class="styoptfmt">translate</span></a><span class="optfmt">=true</span> setting will
+ensure that <a id="wrglossary.1216"></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.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}
+Alternatively, using the <a id="wrglossary.1217"></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.1218"></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.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
+This will required both <a id="wrglossary.1219"></a><a href="#glo:file.glossaries-german.ldf"><span class="filefmt">glossaries-german.ldf</span></a> and
+<a id="wrglossary.1220"></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.1221"></a><a href="#glo:opt.languages"><span class="styoptfmt">locales</span></a> option is a synonym of the
+<a id="wrglossary.1222"></a><a href="#glo:opt.languages"><span class="styoptfmt">languages</span></a> option, but semantically <a id="wrglossary.1223"></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.1233"></a><a href="#glo:pkg.tracklang"><span class="styfmt">tracklang</span></a>, then the list of supported locales will be picked
+<a id="wrglossary.1224"></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}
@@ -7673,95 +7672,95 @@
</pre>
<p>
The best method to sort terms that use an
-<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>,
+<a id="wrglossary.1225"></a><a href="#glo:dual.exlatinalph">extended Latin alphabet</a> or <a id="wrglossary.1226"></a><a href="#glo:dual.nonlatinalph">non-Latin alphabet</a> is with
+<a id="wrglossary.1227"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> and <a id="wrglossary.1228"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>. This means using a
+<a id="wrglossary.1229"></a><a href="#glo:ext.bib"><span class="extfmt">bib</span></a> file to store the entry data (see <a id="wrglossary.1230"></a><a href="#glo:idx.opt.b2g">Option 4</a>). If you
+prefer to only use the base <a id="wrglossary.1231"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package, then <a id="wrglossary.1232"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>
+(<a id="wrglossary.1233"></a><a href="#glo:idx.opt.xdy">Option 3</a>) is the best option, but be aware that <a id="wrglossary.1234"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>
+is a general purpose <a id="wrglossary.1235"></a><a href="#glo:dual.indexingapp">indexing application</a> that’s developed
+independently of <a id="wrglossary.1236"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> (as opposed to <a id="wrglossary.1237"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>,
which is specifically designed for, and developed alongside,
-<a id="wrglossary.1247"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> and therefore provides better integration).
+<a id="wrglossary.1238"></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.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
+Note also that <a id="wrglossary.1239"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> can support any language provided by
+the <a id="wrglossary.1240"></a><a href="#glo:cldr">CLDR</a>, whereas <a id="wrglossary.1241"></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.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>.
+If you are using a non-Latin script with <a id="wrglossary.1242"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>, you may need the
+<a id="wrglossary.1243"></a><a href="#glo:opt.xindynoglsnumbers"><span class="styoptfmt">xindynoglsnumbers</span></a> option or use
+<a id="wrglossary.1244"></a><a href="#glo:GlsSetXdyFirstLetterAfterDigits"><code class="csfmt">\GlsSetXdyFirstLetterAfterDigits</code></a> to indicate the first
+<a id="wrglossary.1245"></a><a href="#glo:idx.group">letter group</a> that should follow the number <a id="wrglossary.1246"></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.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>.
+<a id="wrglossary.1247"></a><a href="#glo:dual.utf8">UTF-8</a> characters that requires <a id="wrglossary.1248"></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.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.
+assumed to be <a id="wrglossary.1249"></a><a href="#glo:dual.utf8">UTF-8</a> so I haven’t bothered loading the
+<a id="wrglossary.1250"></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.1260"></a><a href="#glo:opt.xindy"><span class="styoptfmt">xindy</span></a>]{glossaries}
+<code class="cmd">\usepackage</code>[<a id="wrglossary.1251"></a><a href="#glo:opt.xindy"><span class="styoptfmt">xindy</span></a>]{glossaries}
</pre>
-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.
+Note the use of the <a id="wrglossary.1252"></a><a href="#glo:opt.xindy"><span class="styoptfmt">xindy</span></a> package option, which ensures that
+all the <a id="wrglossary.1253"></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.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>}
+<a id="wrglossary.1254"></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.1255"></a><a href="#glo:newglossary*"><code class="csfmt">\newglossary*</code></a>{dictionary}{<a id="wrglossary.1256"></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.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
+language-sensitive <a id="wrglossary.1257"></a><a href="#glo:glossaryname"><code class="csfmt">\glossaryname</code></a> (which is also the title
+provided for the main <a id="wrglossary.1258"></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.1268"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package.
+the base <a id="wrglossary.1259"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package.
<p>
-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>
+To ensure that the files required by <a id="wrglossary.1260"></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.1261"></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.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 class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.1262"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{élite}{<a id="wrglossary.1263"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={élite}</span>,
+<a id="wrglossary.1264"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={select group or class}</span>}
+<a id="wrglossary.1265"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{elephant}{<a id="wrglossary.1266"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={elephant}</span>,
+<a id="wrglossary.1267"></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.1268"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{elk}{<a id="wrglossary.1269"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={elk}</span>, <a id="wrglossary.1270"></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.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 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>{água}{<a id="wrglossary.1272"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={água}</span>,
+<a id="wrglossary.1273"></a><a href="#glo:opt.gloskey.type"><span class="csoptfmt">type</span></a><span class="optfmt">={dictionary}</span>,
+<a id="wrglossary.1274"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={water}</span>}
+<a id="wrglossary.1275"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{árvore}{<a id="wrglossary.1276"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={árvore}</span>,
+<a id="wrglossary.1277"></a><a href="#glo:opt.gloskey.type"><span class="csoptfmt">type</span></a><span class="optfmt">={dictionary}</span>,
+<a id="wrglossary.1278"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={tree}</span>}
+<a id="wrglossary.1279"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{ano}{<a id="wrglossary.1280"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={ano}</span>,
+<a id="wrglossary.1281"></a><a href="#glo:opt.gloskey.type"><span class="csoptfmt">type</span></a><span class="optfmt">={dictionary}</span>,
+<a id="wrglossary.1282"></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.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
+provided in the first argument of <a id="wrglossary.1283"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a> and the
+<a id="wrglossary.1284"></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.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.
+An <a id="wrglossary.1285"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{elk} and an <a id="wrglossary.1286"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{elephant} belonged to an
+<a id="wrglossary.1287"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{élite} group.
-<a id="wrglossary.1297"></a><a href="#glo:printglossary"><code class="csfmt">\printglossary</code></a>
+<a id="wrglossary.1288"></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.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 <a id="wrglossary.1289"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{árvore} tive <a id="wrglossary.1290"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{água} este <a id="wrglossary.1291"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ano}.
-<a id="wrglossary.1301"></a><a href="#glo:printglossary"><code class="csfmt">\printglossary</code></a>[type=dictionary]
+<a id="wrglossary.1292"></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
@@ -7773,86 +7772,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="349">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="351">Example document that defines a term with a UTF-8
character.</object>
</div><!-- end of resultbox -->
<p>
-<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="sidenote"><a id="wrglossary.1293"></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.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
+the previous example which uses <a id="wrglossary.1294"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> (and therefore
+requires <a id="wrglossary.1295"></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.1296"></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.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>
+ <a id="wrglossary.1297"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={élite}</span>,
+ <a id="wrglossary.1298"></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.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>
+ <a id="wrglossary.1299"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={elephant}</span>,
+ <a id="wrglossary.1300"></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.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>
+ <a id="wrglossary.1301"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={elk}</span>,
+ <a id="wrglossary.1302"></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.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>
+ <a id="wrglossary.1303"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={água}</span>,
+ <a id="wrglossary.1304"></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.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>
+ <a id="wrglossary.1305"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={árvore}</span>,
+ <a id="wrglossary.1306"></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.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>
+ <a id="wrglossary.1307"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={ano}</span>,
+ <a id="wrglossary.1308"></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.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:
+The document now requires <a id="wrglossary.1309"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> with the
+<a id="wrglossary.1310"></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.1320"></a><a href="#glo:opt.record"><span class="xtrstyoptfmt">record</span></a>]{glossaries-extra}
+<code class="cmd">\usepackage</code>[<a id="wrglossary.1311"></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.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 class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.1312"></a><a href="#glo:newglossary*"><code class="csfmt">\newglossary*</code></a>{dictionary}{<a id="wrglossary.1313"></a><a href="#glo:glossaryname"><code class="csfmt">\glossaryname</code></a>}
</pre>
-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>
+Instead of using <a id="wrglossary.1314"></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.1315"></a><a href="#glo:GlsXtrLoadResources"><code class="xtrcsfmt">\GlsXtrLoadResources</code></a>[
+ <a id="wrglossary.1316"></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.1317"></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.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>
+<a id="wrglossary.1318"></a><a href="#glo:GlsXtrLoadResources"><code class="xtrcsfmt">\GlsXtrLoadResources</code></a>[
+ <a id="wrglossary.1319"></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.1320"></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.1321"></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.1331"></a><a href="#glo:dual.glossary">glossary</a>.
+but a different command is needed to display the <a id="wrglossary.1322"></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.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.
+An <a id="wrglossary.1323"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{elk} and an <a id="wrglossary.1324"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{elephant} belonged to an
+<a id="wrglossary.1325"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{élite} group.
-<a id="wrglossary.1335"></a><a href="#glo:printunsrtglossary"><code class="xtrcsfmt">\printunsrtglossary</code></a>
+<a id="wrglossary.1326"></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.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 <a id="wrglossary.1327"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{árvore} tive <a id="wrglossary.1328"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{água} este <a id="wrglossary.1329"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{ano}.
-<a id="wrglossary.1339"></a><a href="#glo:printunsrtglossary"><code class="xtrcsfmt">\printunsrtglossary</code></a>[type=dictionary]
+<a id="wrglossary.1330"></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:
@@ -7863,69 +7862,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="595" height="842">Example UTF-8 document that defines terms in bib
+<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
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.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
+Note that although a <a id="wrglossary.1331"></a><a href="#glo:dual.nonlatinchar">non-Latin character</a>, such as é, looks like a
+plain character in your <a id="wrglossary.1332"></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.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>
+support <a id="wrglossary.1333"></a><a href="#glo:dual.utf8">UTF-8</a>.) Recent versions of the LaTeX kernel have
+made significant improvements in handling <a id="wrglossary.1334"></a><a href="#glo:dual.utf8">UTF-8</a>. To ensure you have the best
+<a id="wrglossary.1335"></a><a href="#glo:dual.utf8">UTF-8</a> support, use at least <a id="wrglossary.1336"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a> v2.08+ with
+<a id="wrglossary.1337"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.50+ (and, if required, <a id="wrglossary.1338"></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.1339"></a><a href="#glo:dual.utf8">UTF-8</a>
characters in labels.
</div><!-- end of important -->
<p>
-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>}
+With old versions of <a id="wrglossary.1340"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a> (pre v2.08), if you use a <a id="wrglossary.1341"></a><a href="#glo:dual.utf8">UTF-8</a>
+character at the start of an <a id="wrglossary.1342"></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.1343"></a><a href="#glo:idx.sentencecase">sentence case</a> commands
+(e.g. <a id="wrglossary.1344"></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.1345"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a> v2.07:</span>
+<a id="wrglossary.1346"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{elite}{<a id="wrglossary.1347"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={{é}lite}</span>,
+<a id="wrglossary.1348"></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.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
+This isn’t necessary with <a id="wrglossary.1349"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> v4.50+ and <a id="wrglossary.1350"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a>
+v2.08+, and with a newer LaTeX kernel the <a id="wrglossary.1351"></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.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 class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><span class="comment">% <a id="wrglossary.1352"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span></a> v2.08:</span>
+<a id="wrglossary.1353"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{élite}{<a id="wrglossary.1354"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={élite}</span>,
+<a id="wrglossary.1355"></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.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>.
+If you are using <a id="wrglossary.1356"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> or <a id="wrglossary.1357"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>, the application needs
+to know the <a id="wrglossary.1358"></a><a href="#glo:idx.encoding">encoding</a> of the <a id="wrglossary.1359"></a><a href="#glo:ext.tex"><span class="extfmt">tex</span></a> file. This information
+is added to the <a id="wrglossary.1360"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> file and can be picked up by
+<a id="wrglossary.1361"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> and <a id="wrglossary.1362"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>.
<p>
-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:
+Note that <a id="wrglossary.1363"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> doesn’t support <a id="wrglossary.1364"></a><a href="#glo:dual.utf8">UTF-8</a> so, although it
+can be used with some <a id="wrglossary.1365"></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.1366"></a><a href="#glo:dual.utf8">UTF-8</a>.
+If you have the double-quote character (<a id="wrglossary.1367"></a><a href="#glo:idx.sym.dblquote"><code class="code">"</code></a>) as an
+active character (for example, a <a id="wrglossary.1368"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a> shorthand) and you
+want to use <a id="wrglossary.1369"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span>’s</a> <a id="wrglossary.1370"></a><a href="#glo:switch.mkidx.g"><span class="shortargfmt">-g</span></a> (German) option, you’ll
+need to change <a id="wrglossary.1371"></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.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>
+<a id="wrglossary.1372"></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.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>.
+Note that <span class="meta">〈<em class="metainner">character</em>〉</span> may not be one of <a id="wrglossary.1373"></a><a href="#glo:idx.sym.questionmark"><code class="code">?</code> (question mark)</a>,
+<a id="wrglossary.1374"></a><a href="#glo:idx.sym.pipe"><code class="code">|</code> (pipe)</a> or <a id="wrglossary.1375"></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.1385"></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.1376"></a><a href="#glo:GlsSetQuote"><code class="csfmt">\GlsSetQuote</code></a>{+}
</pre>
-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
+This must be done before <a id="wrglossary.1377"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a> and any entry
+definitions. It’s only applicable for <a id="wrglossary.1378"></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.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>.
+<a id="wrglossary.1379"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> to use the <a id="wrglossary.1380"></a><a href="#glo:switch.mkidx.g"><span class="shortargfmt">-g</span></a> switch when invoking
+<a id="wrglossary.1381"></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}
@@ -7932,18 +7931,18 @@
<code class="cmd">\usepackage</code>[ngerman]{babel}
<code class="cmd">\usepackage</code>{glossaries}
-<a id="wrglossary.1391"></a><a href="#glo:GlsSetQuote"><code class="csfmt">\GlsSetQuote</code></a>{+}
+<a id="wrglossary.1382"></a><a href="#glo:GlsSetQuote"><code class="csfmt">\GlsSetQuote</code></a>{+}
-<a id="wrglossary.1392"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a>
+<a id="wrglossary.1383"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a>
-<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>}
+<a id="wrglossary.1384"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{rna}{name=ribonukleinsäure,
+ <a id="wrglossary.1385"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a><span class="optfmt">={ribonukleins"aure}</span>,
+ <a id="wrglossary.1386"></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.1396"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{rna}
+<a id="wrglossary.1387"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{rna}
-<a id="wrglossary.1397"></a><a href="#glo:printglossaries"><code class="csfmt">\printglossaries</code></a>
+<a id="wrglossary.1388"></a><a href="#glo:printglossaries"><code class="csfmt">\printglossaries</code></a>
<code class="cend">\end{document}</code>
</pre>
<p>
@@ -7956,40 +7955,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.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
+package such as <a id="wrglossary.1389"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a> or <a id="wrglossary.1390"></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.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
+are using <a id="wrglossary.1391"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a> or <a id="wrglossary.1392"></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.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>
+the words babel uses</a> or read the <a id="wrglossary.1393"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a> or <a id="wrglossary.1394"></a><a href="#glo:pkg.polyglossia"><span class="styfmt">polyglossia</span></a>
+documentation. If you have loaded <a id="wrglossary.1395"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a>, then <a id="wrglossary.1396"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a>
+will attempt to load <a id="wrglossary.1397"></a><a href="#glo:pkg.translator"><span class="styfmt">translator</span></a>, unless you have used the
+<a id="wrglossary.1398"></a><a href="#glo:opt.notranslate"><span class="styoptfmt">notranslate</span></a>, <a id="wrglossary.1399"></a><a href="#glo:opt.translate"><span class="styoptfmt">translate</span></a><span class="optfmt">=false</span> or
+<a id="wrglossary.1400"></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.1410"></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.1401"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a></div><!-- end of informationtitle -->
-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.
+The <a id="wrglossary.1402"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package defaults to
+<a id="wrglossary.1403"></a><a href="#glo:opt.translate"><span class="styoptfmt">translate</span></a><span class="optfmt">=babel</span> if <a id="wrglossary.1404"></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.1414"></a><a href="#glo:pkg.translator"><span class="styfmt">translator</span></a> package is loaded, the
+If the <a id="wrglossary.1405"></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.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>:
+<a id="wrglossary.1406"></a><a href="#glo:pkg.translator"><span class="styfmt">translator</span></a> package for advice on changing translations provided by
+<a id="wrglossary.1407"></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.1408"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a>’s
+interface using <a id="wrglossary.1409"></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.1419"></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.1410"></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.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
+and then use <a id="wrglossary.1411"></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.1412"></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.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
+<a id="wrglossary.1413"></a><a href="#glo:pkg.translator"><span class="styfmt">translator</span></a>, then <a id="wrglossary.1414"></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.1415"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a>’s
caption hooks will be used instead.
<p>
<div class="table">
@@ -8046,12 +8045,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.1425"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package. You only need to install the
+the <a id="wrglossary.1416"></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.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
+<a id="wrglossary.1417"></a><a href="#glo:pkg.translator"><span class="styfmt">translator</span></a> dictionary files for <a id="wrglossary.1418"></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.
@@ -8060,23 +8059,23 @@
<ul class="displaylist">
-<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>:
+<li><span class="bulletitem">•</span>Using <a id="wrglossary.1419"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a> and <a id="wrglossary.1420"></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.1430"></a><a href="#glo:pkg.translator"><span class="styfmt">translator</span></a> is automatically loaded).
+(<a id="wrglossary.1421"></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.1431"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a>:
+<li><span class="bulletitem">•</span>Using <a id="wrglossary.1422"></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.1432"></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.1423"></a><a href="#glo:opt.translate"><span class="styoptfmt">translate</span></a><span class="optfmt">=babel</span>]{glossaries}
</pre>
-(<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
+(<a id="wrglossary.1424"></a><a href="#glo:pkg.translator"><span class="styfmt">translator</span></a> isn’t loaded). The <a id="wrglossary.1425"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package
+has <a id="wrglossary.1426"></a><a href="#glo:opt.translate"><span class="styoptfmt">translate</span></a><span class="optfmt">=babel</span> as the default if <a id="wrglossary.1427"></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.1437"></a><a href="#glo:pkg.polyglossia"><span class="styfmt">polyglossia</span></a>:
+<li><span class="bulletitem">•</span>Using <a id="wrglossary.1428"></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}
@@ -8087,24 +8086,24 @@
</ul>
<p>
-Due to the varied nature of <a id="wrglossary.1438"></a><a href="#glo:dual.glossary">glossaries</a>, it’s likely that the
+Due to the varied nature of <a id="wrglossary.1429"></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.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 id="wrglossary.1430"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a> package and the <a id="wrglossary.1431"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package option
+<a id="wrglossary.1432"></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.1442"></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.1433"></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.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>).
+<a id="wrglossary.1434"></a><a href="#glo:dual.glossary">glossary</a>, you can use the <a id="wrglossary.1435"></a><a href="#glo:opt.printgloss.title"><span class="csoptfmt">title</span></a> key in
+commands like <a id="wrglossary.1436"></a><a href="#glo:printglossary"><code class="csfmt">\printglossary</code></a> (but not the iterative commands
+like <a id="wrglossary.1437"></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.1447"></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.1438"></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.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>
+in the <a id="wrglossary.1439"></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.1440"></a><a href="#glo:pkg.translator"><span class="styfmt">translator</span></a>
documentation for further details.
</div><!-- end of important -->
@@ -8113,7 +8112,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.1450"></a><a href="#glo:dual.locationlist">location list</a> should be labelled
+<span class="qt">“Nomenclature”</span> and the <a id="wrglossary.1441"></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:
@@ -8128,25 +8127,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.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:
+If you are using <a id="wrglossary.1442"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a> and don’t want to use the
+<a id="wrglossary.1443"></a><a href="#glo:pkg.translator"><span class="styfmt">translator</span></a> interface, you can use the package
+option <a id="wrglossary.1444"></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.1454"></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.1445"></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.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>
+<code class="cmd">\addto</code><a id="wrglossary.1446"></a><a href="#glo:captionslanguage"><code class="csfmt">\captionsbritish</code></a>{<span class="comment">% </span>
+ <code class="cmd">\renewcommand</code>*{<a id="wrglossary.1447"></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.1448"></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.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
+Note that <a id="wrglossary.1449"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> and <a id="wrglossary.1450"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> provide much better
+multi-lingual support than <a id="wrglossary.1451"></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.1452"></a><a href="#glo:dual.glossary">glossary</a> entries that
+contain <a id="wrglossary.1453"></a><a href="#glo:dual.nonlatinchar">non-Latin characters</a>. See §<a href="#sec:xindy">14</a> for further
+details on <a id="wrglossary.1454"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>, and see the <a id="wrglossary.1455"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> user manual for
further details of that application.
<p>
@@ -8156,19 +8155,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.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
+The <a id="wrglossary.1456"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package now uses the <a id="wrglossary.1457"></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.1467"></a><a href="#glo:pkg.tracklang"><span class="styfmt">tracklang</span></a> documentation.
+<a id="wrglossary.1458"></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.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
+files called: <a id="wrglossary.1459"></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.1460"></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.1470"></a><a href="#glo:pkg.translator"><span class="styfmt">translator</span></a> (for example, <code class="code">English</code>).
+<a id="wrglossary.1461"></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.1471"></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.1462"></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}
@@ -8181,56 +8180,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.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>)
+<code class="code">English</code> to the <a id="wrglossary.1463"></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.1464"></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.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}
+Here’s an example of <a id="wrglossary.1465"></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.1466"></a><a href="#glo:ProvidesGlossariesLang"><code class="csfmt">\ProvidesGlossariesLang</code></a>{english}
-<a id="wrglossary.1476"></a><a href="#glo:glsifusedtranslatordict"><code class="csfmt">\glsifusedtranslatordict</code></a>{English}
+<a id="wrglossary.1467"></a><a href="#glo:glsifusedtranslatordict"><code class="csfmt">\glsifusedtranslatordict</code></a>{English}
{<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>
+ <a id="wrglossary.1468"></a><a href="#glo:addglossarytocaptions"><code class="csfmt">\addglossarytocaptions</code></a>{<a id="wrglossary.1469"></a><a href="#glo:CurrentTrackedLanguage"><code class="csfmt">\CurrentTrackedLanguage</code></a>}<span class="comment">% </span>
+ <a id="wrglossary.1470"></a><a href="#glo:addglossarytocaptions"><code class="csfmt">\addglossarytocaptions</code></a>{<a id="wrglossary.1471"></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.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>
+ <code class="cmd">\renewcommand</code>*{<a id="wrglossary.1472"></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.1473"></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.1474"></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.1475"></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.1476"></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.1477"></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.1478"></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.1479"></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.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>
+ <code class="cmd">\renewcommand</code>*{<a id="wrglossary.1480"></a><a href="#glo:glossaryname"><code class="csfmt">\glossaryname</code></a>}{Glossary}<span class="comment">% </span>
+ <code class="cmd">\renewcommand</code>*{<a id="wrglossary.1481"></a><a href="#glo:acronymname"><code class="csfmt">\acronymname</code></a>}{Acronyms}<span class="comment">% </span>
+ <code class="cmd">\renewcommand</code>*{<a id="wrglossary.1482"></a><a href="#glo:entryname"><code class="csfmt">\entryname</code></a>}{Notation}<span class="comment">% </span>
+ <code class="cmd">\renewcommand</code>*{<a id="wrglossary.1483"></a><a href="#glo:descriptionname"><code class="csfmt">\descriptionname</code></a>}{Description}<span class="comment">% </span>
+ <code class="cmd">\renewcommand</code>*{<a id="wrglossary.1484"></a><a href="#glo:symbolname"><code class="csfmt">\symbolname</code></a>}{Symbol}<span class="comment">% </span>
+ <code class="cmd">\renewcommand</code>*{<a id="wrglossary.1485"></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.1486"></a><a href="#glo:glssymbolsgroupname"><code class="csfmt">\glssymbolsgroupname</code></a>}{Symbols}<span class="comment">% </span>
+ <code class="cmd">\renewcommand</code>*{<a id="wrglossary.1487"></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.1497"></a><a href="#glo:CurrentTrackedDialect"><code class="csfmt">\CurrentTrackedDialect</code></a>}
+ <code class="cmd">\ifcsdef</code>{captions<a id="wrglossary.1488"></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>
+ <code class="cmd">\csappto</code>{captions<a id="wrglossary.1489"></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.1499"></a><a href="#glo:CurrentTrackedLanguage"><code class="csfmt">\CurrentTrackedLanguage</code></a>}
+ <code class="cmd">\ifcsdef</code>{captions<a id="wrglossary.1490"></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>
+ <code class="cmd">\csappto</code>{captions<a id="wrglossary.1491"></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>
@@ -8240,12 +8239,12 @@
}<span class="comment">% </span>
<code class="cmd">\glossariescaptionsenglish</code>
}
-<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>}}
+<code class="cmd">\renewcommand</code>*{<a id="wrglossary.1492"></a><a href="#glo:glspluralsuffix"><code class="csfmt">\glspluralsuffix</code></a>}{s}
+<code class="cmd">\renewcommand</code>*{<a id="wrglossary.1493"></a><a href="#glo:glsacrpluralsuffix"><code class="csfmt">\glsacrpluralsuffix</code></a>}{<a id="wrglossary.1494"></a><a href="#glo:glspluralsuffix"><code class="csfmt">\glspluralsuffix</code></a>}
+<code class="cmd">\renewcommand</code>*{<a id="wrglossary.1495"></a><a href="#glo:glsupacrpluralsuffix"><code class="csfmt">\glsupacrpluralsuffix</code></a>}{<a id="wrglossary.1496"></a><a href="#glo:glstextup"><code class="csfmt">\glstextup</code></a>{<a id="wrglossary.1497"></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.1507"></a><a href="#glo:pkg.translator"><span class="styfmt">translator</span></a>
+template. Replace <code class="code">English</code> with the <a id="wrglossary.1498"></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
@@ -8253,39 +8252,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.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>.
+hasn’t been specified are given by <a id="wrglossary.1499"></a><a href="#glo:glspluralsuffix"><code class="csfmt">\glspluralsuffix</code></a> (for
+general entries). For <a id="wrglossary.1500"></a><a href="#glo:idx.acronym">acronyms</a> defined with the base
+<a id="wrglossary.1501"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a>, <a id="wrglossary.1502"></a><a href="#glo:glsupacrpluralsuffix"><code class="csfmt">\glsupacrpluralsuffix</code></a> is used for the
+<a id="wrglossary.1503"></a><a href="#glo:dual.smallcaps">small caps</a> <a id="wrglossary.1504"></a><a href="#glo:idx.acronymstyle">acronym styles</a> where the suffix needs to be
+set using <a id="wrglossary.1505"></a><a href="#glo:glstextup"><code class="csfmt">\glstextup</code></a> to counteract the effects of <a id="wrglossary.1506"></a><a href="#glo:textsc"><code class="csfmt">\textsc</code></a>
+and <a id="wrglossary.1507"></a><a href="#glo:glsacrpluralsuffix"><code class="csfmt">\glsacrpluralsuffix</code></a> for other <a id="wrglossary.1508"></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.1518"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> configuration.
+on the <a id="wrglossary.1509"></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.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
+the <a id="wrglossary.1510"></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.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
+suffix required in your document and use the <a id="wrglossary.1511"></a><a href="#glo:opt.gloskey.plural"><span class="csoptfmt">plural</span></a>,
+<a id="wrglossary.1512"></a><a href="#glo:opt.gloskey.longplural"><span class="csoptfmt">longplural</span></a>, <a id="wrglossary.1513"></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.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
+<a id="wrglossary.1514"></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.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}
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.1515"></a><a href="#glo:ProvidesGlossariesLang"><code class="csfmt">\ProvidesGlossariesLang</code></a>{en-GB}
+ <a id="wrglossary.1516"></a><a href="#glo:RequireGlossariesLang"><code class="csfmt">\RequireGlossariesLang</code></a>{english}
+ <a id="wrglossary.1517"></a><a href="#glo:glsifusedtranslatordict"><code class="csfmt">\glsifusedtranslatordict</code></a>{British}
{<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>
+ <a id="wrglossary.1518"></a><a href="#glo:addglossarytocaptions"><code class="csfmt">\addglossarytocaptions</code></a>{<a id="wrglossary.1519"></a><a href="#glo:CurrentTrackedLanguage"><code class="csfmt">\CurrentTrackedLanguage</code></a>}<span class="comment">% </span>
+ <a id="wrglossary.1520"></a><a href="#glo:addglossarytocaptions"><code class="csfmt">\addglossarytocaptions</code></a>{<a id="wrglossary.1521"></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>
@@ -8300,23 +8299,23 @@
}
</pre>
<p>
-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.
+If the translations includes <a id="wrglossary.1522"></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.1523"></a><a href="#glo:idx.encoding">encoding</a>. Remember that
+while some users may use <a id="wrglossary.1524"></a><a href="#glo:dual.utf8">UTF-8</a> (and it’s now the default
+<a id="wrglossary.1525"></a><a href="#glo:idx.encoding">encoding</a> with modern LaTeX kernels), others may use Latin-1 or any other
+supported <a id="wrglossary.1526"></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.1527"></a><a href="#glo:dual.utf8">UTF-8</a> version.
<p>
-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}
+The <a id="wrglossary.1528"></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.1529"></a><a href="#glo:ProvidesGlossariesLang"><code class="csfmt">\ProvidesGlossariesLang</code></a>{irish}
-<a id="wrglossary.1539"></a><a href="#glo:glsifusedtranslatordict"><code class="csfmt">\glsifusedtranslatordict</code></a>{Irish}
+<a id="wrglossary.1530"></a><a href="#glo:glsifusedtranslatordict"><code class="csfmt">\glsifusedtranslatordict</code></a>{Irish}
{<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>
+ <a id="wrglossary.1531"></a><a href="#glo:addglossarytocaptions"><code class="csfmt">\addglossarytocaptions</code></a>{<a id="wrglossary.1532"></a><a href="#glo:CurrentTrackedLanguage"><code class="csfmt">\CurrentTrackedLanguage</code></a>}<span class="comment">% </span>
+ <a id="wrglossary.1533"></a><a href="#glo:addglossarytocaptions"><code class="csfmt">\addglossarytocaptions</code></a>{<a id="wrglossary.1534"></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.1544"></a><a href="#glo:inputencodingname"><code class="csfmt">\inputencodingname</code></a>}{utf8}
+ <code class="cmd">\ifdefstring</code>{<a id="wrglossary.1535"></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>
@@ -8323,17 +8322,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.1545"></a><a href="#glo:CurrentTrackedDialect"><code class="csfmt">\CurrentTrackedDialect</code></a>}
+ <code class="cmd">\ifcsdef</code>{captions<a id="wrglossary.1536"></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>
+ <code class="cmd">\csappto</code>{captions<a id="wrglossary.1537"></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.1547"></a><a href="#glo:CurrentTrackedLanguage"><code class="csfmt">\CurrentTrackedLanguage</code></a>}
+ <code class="cmd">\ifcsdef</code>{captions<a id="wrglossary.1538"></a><a href="#glo:CurrentTrackedLanguage"><code class="csfmt">\CurrentTrackedLanguage</code></a>}
{
- <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>
+ <code class="cmd">\csappto</code>{captions<a id="wrglossary.1539"></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>
@@ -8346,11 +8345,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.1549"></a><a href="#glo:pkg.translator"><span class="styfmt">translator</span></a> dictionary label.)
+<a id="wrglossary.1540"></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.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>).
+(no <a id="wrglossary.1541"></a><a href="#glo:idx.encoding">encoding</a> information)
+and <span class="filefmt">glossaries-irish-utf8.ldf</span> (<a id="wrglossary.1542"></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:
@@ -8357,31 +8356,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.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>
+ <code class="cmd">\renewcommand</code>*{<a id="wrglossary.1543"></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.1544"></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.1545"></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.1546"></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.1547"></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.1548"></a><a href="#glo:glssymbolsgroupname"><code class="csfmt">\glssymbolsgroupname</code></a>}{<code class="cmd">\textirish</code>{Comhartha<a id="wrglossary.1549"></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.1550"></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.1551"></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.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>
+ <code class="cmd">\renewcommand</code>*{<a id="wrglossary.1552"></a><a href="#glo:glossaryname"><code class="csfmt">\glossaryname</code></a>}{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>}{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>}{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>}{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>}{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>}{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>}{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>}{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.1570"></a><a href="#glo:dual.utf8">UTF-8</a> characters.
+the appropriate <a id="wrglossary.1561"></a><a href="#glo:dual.utf8">UTF-8</a> characters.
<p>
</section><!-- end of section sec:newlang -->
@@ -8393,25 +8392,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.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.)
+(For <a id="wrglossary.1562"></a><a href="#glo:idx.opt.b2g">Option 4</a>, see the <a id="wrglossary.1563"></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.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>).
+<a id="wrglossary.1564"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a> key if the <a id="wrglossary.1565"></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.1566"></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.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
+to run external tools like <a id="wrglossary.1567"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> or <a id="wrglossary.1568"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>,
+you can try using the <a id="wrglossary.1569"></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.1579"></a><a href="#glo:dual.shellescape">shell escape</a> enabled. See also
+<a id="wrglossary.1570"></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.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
+Since <a id="wrglossary.1571"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> is on the trusted list, the restricted
+<a id="wrglossary.1572"></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.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 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.1573"></a><a href="#glo:opt.automake"><span class="styoptfmt">automake</span></a>]{glossaries}
+<a id="wrglossary.1574"></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:
@@ -8421,8 +8420,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.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 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.1575"></a><a href="#glo:opt.xindy"><span class="styoptfmt">xindy</span></a>,<a id="wrglossary.1576"></a><a href="#glo:opt.automake"><span class="styoptfmt">automake</span></a>]{glossaries}
+<a id="wrglossary.1577"></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
@@ -8431,156 +8430,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.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
+In order to generate a sorted <a id="wrglossary.1578"></a><a href="#glo:dual.glossary">glossary</a> with compact
+<a id="wrglossary.1579"></a><a href="#glo:locationlist">number lists</a>, it is necessary to use an external
+<a id="wrglossary.1580"></a><a href="#glo:dual.indexingapp">indexing application</a> as an intermediate step (<a id="wrglossary.1581"></a><a href="#glo:idx.opt.noidx">Option 1</a>, which
+uses TeX to do the sorting, can’t compact <a id="wrglossary.1582"></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.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>
+required to typeset the <a id="wrglossary.1583"></a><a href="#glo:dual.glossary">glossary</a>. <strong class="strong">If this step is
+omitted, the <a id="wrglossary.1584"></a><a href="#glo:dual.glossary">glossaries</a> will not appear in your document.</strong>
<p>
-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
+The two oldest <a id="wrglossary.1585"></a><a href="#glo:dual.indexingapp">indexing applications</a> most commonly used with LaTeX are <a id="wrglossary.1586"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> and <a id="wrglossary.1587"></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.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
+that can support <a id="wrglossary.1588"></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.1589"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>. Simply follow the <a id="wrglossary.1590"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>
+instructions and substitute the call to <a id="wrglossary.1591"></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.1601"></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.1592"></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.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
+document compilation using applications such as <a id="wrglossary.1593"></a><a href="#glo:app.latexmk"><span class="appfmt">latexmk</span></a> and
+<a id="wrglossary.1594"></a><a href="#glo:app.arara"><span class="appfmt">arara</span></a>. With <a id="wrglossary.1595"></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.1605"></a><a href="#glo:app.latexmk"><span class="appfmt">latexmk</span></a> you need to set up the required dependencies.
+With <a id="wrglossary.1596"></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.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
+The <a id="wrglossary.1597"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package comes with the Perl script
+<a id="wrglossary.1598"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> which will run <a id="wrglossary.1599"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> or <a id="wrglossary.1600"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>
+on all the <a id="wrglossary.1601"></a><a href="#glo:dual.indexingfile">indexing files</a> using a customized style file (which is
+created by <a id="wrglossary.1602"></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.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
+<a id="wrglossary.1603"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> and <a id="wrglossary.1604"></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.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>.
+install Perl if you want to use <a id="wrglossary.1605"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> or <a id="wrglossary.1606"></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.1616"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a>:
+The advantages of using <a id="wrglossary.1607"></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.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.
+<li><span class="bulletitem">•</span>It automatically detects whether to use <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> and sets the relevant application switches.
<p>
-<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.
+<li><span class="bulletitem">•</span>One call of <a id="wrglossary.1610"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> will run
+<a id="wrglossary.1611"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>/<a id="wrglossary.1612"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> for each <a id="wrglossary.1613"></a><a href="#glo:dual.glossary">glossary</a> type.
<p>
-<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
+<li><span class="bulletitem">•</span>If things go wrong, <a id="wrglossary.1614"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> will scan the
+messages from <a id="wrglossary.1615"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> or <a id="wrglossary.1616"></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.1617"></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.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.
+file and see if you can work it out from the <a id="wrglossary.1618"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> or
+<a id="wrglossary.1619"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> messages.
<p>
-<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>
+<li><span class="bulletitem">•</span>If <a id="wrglossary.1620"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> warns about <a id="wrglossary.1621"></a><a href="#glo:idx.multipleencap">multiple encap</a> values,
+<a id="wrglossary.1622"></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.1623"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> when
+<a id="wrglossary.1624"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> is used since <a id="wrglossary.1625"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> uses the order of the
+<a id="wrglossary.1626"></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.1627"></a><a href="#glo:switch.mkgls.e"><span class="shortargfmt">-e</span></a>
switch.
<p>
-<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.
+<li><span class="bulletitem">•</span>If <a id="wrglossary.1628"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> warns about invalid or
+<a id="wrglossary.1629"></a><a href="#glo:idx.emptylocation">empty locations</a>, <a id="wrglossary.1630"></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.1631"></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.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
+<a id="wrglossary.1632"></a><a href="#glo:dual.locationlist">location list</a>, but it’s useful if the <a id="wrglossary.1633"></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.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+
+<li><span class="bulletitem">•</span>If <a id="wrglossary.1634"></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.1635"></a><a href="#glo:dual.entrylocation">location</a>, <a id="wrglossary.1636"></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.1646"></a><a href="#glo:locationencap">encap</a>.
+and into the <a id="wrglossary.1637"></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.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>.
+<a id="wrglossary.1638"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> has a <a id="wrglossary.1639"></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.1640"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a>
+can change to that directory before running <a id="wrglossary.1641"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>
+or <a id="wrglossary.1642"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>.
</ul>
-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>.
+The first two items also apply to <a id="wrglossary.1643"></a><a href="#glo:app.makeglossaries-lite"><span class="appfmt">makeglossaries-lite</span></a>.
<p>
-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
+As from version 4.16, the <a id="wrglossary.1644"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package also comes
+with a Lua script called <a id="wrglossary.1645"></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.1646"></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.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>).
+to use <a id="wrglossary.1647"></a><a href="#glo:app.makeglossaries-lite"><span class="appfmt">makeglossaries-lite</span></a> so it’s an alternative to
+<a id="wrglossary.1648"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> if you want to use <a id="wrglossary.1649"></a><a href="#glo:idx.opt.mkidx">Option 2</a> (<a id="wrglossary.1650"></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.1660"></a><a href="#glo:dual.glossary">glossaries</a>
+If things go wrong and you can’t work out why your <a id="wrglossary.1651"></a><a href="#glo:dual.glossary">glossaries</a>
aren’t being generated correctly, you can use
-<a id="wrglossary.1661"></a><a href="#glo:app.makeglossariesgui"><span class="appfmt">makeglossariesgui</span></a> as a diagnostic tool. Once you’ve
+<a id="wrglossary.1652"></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.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>.
+<a id="wrglossary.1653"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> or <a id="wrglossary.1654"></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.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
+Whilst I strongly recommended that you use the <a id="wrglossary.1655"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a>
+Perl script or the <a id="wrglossary.1656"></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.1657"></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.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>.
+have no effect if you explicitly run <a id="wrglossary.1658"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>/<a id="wrglossary.1659"></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.1669"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> because you
+If you are choosing not to use <a id="wrglossary.1660"></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.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
+<a id="wrglossary.1661"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> as <a id="wrglossary.1662"></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.1663"></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.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>.
+switch to <a id="wrglossary.1664"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> and <a id="wrglossary.1665"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>.
</div><!-- end of important -->
<p>
-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.
+Below, references to <a id="wrglossary.1666"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> can usually be substituted
+with <a id="wrglossary.1667"></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.1677"></a><a href="#glo:dual.glossary">glossary</a> (for example, the entry is only referenced in the
+the <a id="wrglossary.1668"></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.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
+<a id="wrglossary.1669"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a>, <a id="wrglossary.1670"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> or <a id="wrglossary.1671"></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.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>}
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.1672"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{citrusfruit}{<a id="wrglossary.1673"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={citrus fruit}</span>,
+<a id="wrglossary.1674"></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.1675"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{orange})}</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>}
+<a id="wrglossary.1676"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{orange}{<a id="wrglossary.1677"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={orange}</span>,
+<a id="wrglossary.1678"></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.1688"></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.1679"></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.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>.
+orange entry won’t appear in your <a id="wrglossary.1680"></a><a href="#glo:dual.glossary">glossary</a> until
+you first create the <a id="wrglossary.1681"></a><a href="#glo:dual.glossary">glossary</a> and then do another run
+of <a id="wrglossary.1682"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a>, <a id="wrglossary.1683"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> or <a id="wrglossary.1684"></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
@@ -8589,22 +8588,22 @@
makeglossaries myDoc
pdflatex myDoc
</pre>
-(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.)
+(In the case of <a id="wrglossary.1685"></a><a href="#glo:idx.opt.b2g">Option 4</a>, <a id="wrglossary.1686"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> will scan the description for
+instances of commands like <a id="wrglossary.1687"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> to ensure they are selected but
+an extra <a id="wrglossary.1688"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> call is required to ensure the <a id="wrglossary.1689"></a><a href="#glo:dual.entrylocation">locations</a> are
+included, if <a id="wrglossary.1690"></a><a href="#glo:dual.locationlist">location lists</a> are required. See the
+<a id="wrglossary.1691"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> manual for further details.)
<p>
-Likewise, an additional <a id="wrglossary.1701"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> and LaTeX run
+Likewise, an additional <a id="wrglossary.1692"></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.1702"></a><a href="#glo:locationlist">number lists</a> in the glossary may
+means that the <a id="wrglossary.1693"></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.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.
+<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.xindy"><span class="appfmt">xindy</span></a> or <a id="wrglossary.1696"></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
@@ -8617,7 +8616,7 @@
build</a>.
<p>
If any problems occur, remember to check the transcript files
-(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.
+(e.g. <a id="wrglossary.1697"></a><a href="#glo:ext.glg"><span class="extfmt">glg</span></a> or <a id="wrglossary.1698"></a><a href="#glo:ext.alg"><span class="extfmt">alg</span></a>) for messages.
<p>
<div class="table">
@@ -8662,13 +8661,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.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>
+<pre class="terminal"><div class="terminaltitle"><a href="#glo:sym.terminal"><span title="Terminal" class="icon">〉_</span></a></div><a id="wrglossary.1699"></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.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
+The <a id="wrglossary.1700"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> script picks up the relevant information
+from the auxiliary (<a id="wrglossary.1701"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a>) file and will either call
+<a id="wrglossary.1702"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> or <a id="wrglossary.1703"></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.1713"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a>. For example, if your
+without the extension to <a id="wrglossary.1704"></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
@@ -8675,18 +8674,18 @@
makeglossaries myDoc
pdflatex myDoc
</pre>
-If you only want one <a id="wrglossary.1714"></a><a href="#glo:dual.glossary">glossary</a> processed (for example, if you
+If you only want one <a id="wrglossary.1705"></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.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>
+<a id="wrglossary.1706"></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.1707"></a><a href="#glo:newglossary"><code class="csfmt">\newglossary</code></a>, such as <a id="wrglossary.1708"></a><a href="#glo:ext.glo"><span class="extfmt">glo</span></a> for the <a id="wrglossary.1709"></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.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.
+document has multiple <a id="wrglossary.1710"></a><a href="#glo:dual.glossary">glossaries</a> defined, then
+<a id="wrglossary.1711"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> will tell you how many <a id="wrglossary.1712"></a><a href="#glo:dual.glossary">glossaries</a> have
+been ignored unless the <a id="wrglossary.1713"></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.1723"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> Perl script. MikTeX also
+wrapper for the <a id="wrglossary.1714"></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
@@ -8694,193 +8693,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.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.
+When upgrading the <a id="wrglossary.1715"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package, make sure you also
+upgrade your version of <a id="wrglossary.1716"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a>. The current version is
+4.57.
</div><!-- end of important -->
<p>
-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>.
+Some of the options are only applicable to <a id="wrglossary.1717"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> and some
+are only applicable to <a id="wrglossary.1718"></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.1728"></a><code class="code"><dfn id="glo:switch.mkgls.help"><span class="longargfmt">--help</span></dfn></code></div><!-- end of settingsbox -->
+<a id="wrglossary.1719"></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.1729"></a><code class="code"><dfn id="glo:switch.mkgls.version"><span class="longargfmt">--version</span></dfn></code></div><!-- end of settingsbox -->
+<a id="wrglossary.1720"></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.1730"></a><code class="code"><dfn id="glo:switch.mkgls.n"><span class="shortargfmt">-n</span></dfn></code></div><!-- end of settingsbox -->
+<a id="wrglossary.1721"></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.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
+<a id="wrglossary.1722"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>/<a id="wrglossary.1723"></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.1724"></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.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 -->
+<a id="wrglossary.1725"></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.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.
+Instructs <a id="wrglossary.1726"></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.1727"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a>,
+<a id="wrglossary.1728"></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.1738"></a><a href="#glo:switch.mkgls.d"><span class="shortargfmt">-d</span></a> myTmpDir myDoc
+makeglossaries <a id="wrglossary.1729"></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.1739"></a><code class="code"><dfn id="glo:switch.mkgls.e"><span class="shortargfmt">-e</span></dfn></code></div><!-- end of settingsbox -->
+<a id="wrglossary.1730"></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.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>).
+Don’t check for <a id="wrglossary.1731"></a><a href="#glo:idx.multipleencap">multiple encaps</a> (only applicable with <a id="wrglossary.1732"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>).
By default, if you are using
-<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.
+<a id="wrglossary.1733"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>, <a id="wrglossary.1734"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> will check the <a id="wrglossary.1735"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>
+transcript for <a id="wrglossary.1736"></a><a href="#glo:idx.multipleencap">multiple encap</a> warnings.
<p>
-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
+The <a id="wrglossary.1737"></a><a href="#glo:idx.multipleencap">multiple encap</a> warning is where different <a id="wrglossary.1738"></a><a href="#glo:dual.locationencap">location encap</a>
+values (location formats) are used on the same <a id="wrglossary.1739"></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.1749"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a>
+<a id="wrglossary.1740"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a>
-<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>}
+<a id="wrglossary.1741"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{sample}{<a id="wrglossary.1742"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={sample}</span>,<a id="wrglossary.1743"></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.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>
+<a id="wrglossary.1744"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{sample}, <a id="wrglossary.1745"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>[<a id="wrglossary.1746"></a><a href="#glo:opt.glsopt.format"><span class="csoptfmt">format</span></a><span class="optfmt">=textbf</span>]{sample}.
+<a id="wrglossary.1747"></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.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
+If you explicitly use <a id="wrglossary.1748"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>, this will cause a warning and
+the <a id="wrglossary.1749"></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.1759"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> will check for this warning and, if found, will
+<a id="wrglossary.1750"></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.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>.
+prevent <a id="wrglossary.1751"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> from checking and correcting the
+duplicates with <a id="wrglossary.1752"></a><a href="#glo:switch.mkgls.e"><span class="shortargfmt">-e</span></a>.
<p>
-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>
+There’s no similar check for <a id="wrglossary.1753"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> as <a id="wrglossary.1754"></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.1764"></a><code class="code"><dfn id="glo:switch.mkgls.q"><span class="shortargfmt">-q</span></dfn></code></div><!-- end of settingsbox -->
+<a id="wrglossary.1755"></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.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
+The <a id="wrglossary.1756"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> script attempts to fork the
+<a id="wrglossary.1757"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>/<a id="wrglossary.1758"></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.1768"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a>
+help diagnose problems. If this method fails <a id="wrglossary.1759"></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.1769"></a><a href="#glo:switch.mkgls.q"><span class="shortargfmt">-q</span></a> switch
+redirection. Without this redirection, the <a id="wrglossary.1760"></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.1770"></a><code class="code"><dfn id="glo:switch.mkgls.Q"><span class="shortargfmt">-Q</span></dfn></code></div><!-- end of settingsbox -->
+<a id="wrglossary.1761"></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.1771"></a><code class="code"><dfn id="glo:switch.mkgls.k"><span class="shortargfmt">-k</span></dfn></code></div><!-- end of settingsbox -->
+<a id="wrglossary.1762"></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.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 -->
+<a id="wrglossary.1763"></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.1773"></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.1764"></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.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>
+<a id="wrglossary.1765"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> files (including support for <a id="wrglossary.1766"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> style
+files via <a id="wrglossary.1767"></a><a href="#glo:switch.mkidx.s"><span class="shortargfmt">-s</span></a>), then you can use <a id="wrglossary.1768"></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.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
+<a id="wrglossary.1769"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>. Note that both <a id="wrglossary.1770"></a><a href="#glo:app.xindex"><span class="appfmt">xindex</span></a> and <a id="wrglossary.1771"></a><a href="#glo:app.texindy"><span class="appfmt">texindy</span></a> can
+read <a id="wrglossary.1772"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> files using the default <a id="wrglossary.1773"></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.1783"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> style files.
+<a id="wrglossary.1774"></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.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 -->
+<a id="wrglossary.1775"></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.1785"></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.1776"></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.1786"></a><code class="code"><dfn id="glo:switch.mkgls.c"><span class="shortargfmt">-c</span></dfn></code></div><!-- end of settingsbox -->
+<a id="wrglossary.1777"></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.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.)
+Compress intermediate blanks. This will pass <a id="wrglossary.1778"></a><a href="#glo:switch.mkidx.c"><span class="shortargfmt">-c</span></a> to
+<a id="wrglossary.1779"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>. (Ignored if <a id="wrglossary.1780"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> should be called.)
<p>
<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.novaluesetting"><span title="Valueless Setting" class="icon">𝍢</span></a></div><!-- end of settingsboxtitle -->
-<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 -->
+<a id="wrglossary.1781"></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.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.)
+Disable implicit page <a id="wrglossary.1782"></a><a href="#glo:idx.range">range</a> formation. This will pass <a id="wrglossary.1783"></a><a href="#glo:switch.mkidx.r"><span class="shortargfmt">-r</span></a> to
+<a id="wrglossary.1784"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>. (Ignored if <a id="wrglossary.1785"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> should be called.)
<p>
<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.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 -->
+<a id="wrglossary.1786"></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.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.)
+<code class="code"><a id="wrglossary.1787"></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.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>
The following switches may be used to override settings written to
-the <a id="wrglossary.1799"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> file.
+the <a id="wrglossary.1790"></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.1800"></a><code class="code"><dfn id="glo:switch.mkgls.l"><span class="shortargfmt">-l</span></dfn></code></div><!-- end of settingsbox -->
+<a id="wrglossary.1791"></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.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>.
+Use letter ordering. This will pass <a id="wrglossary.1792"></a><a href="#glo:switch.mkidx.l"><span class="shortargfmt">-l</span></a> to <a id="wrglossary.1793"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>
+or <code class="code"><a id="wrglossary.1794"></a><a href="#glo:switch.xdy.M"><span class="shortargfmt">-M</span></a> ord/letorder</code> to <a id="wrglossary.1795"></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.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 -->
+<a id="wrglossary.1796"></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.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>
+The language to pass to <a id="wrglossary.1797"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>. (Ignored if <a id="wrglossary.1798"></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.1808"></a><code class="code"><dfn id="glo:switch.mkgls.g"><span class="shortargfmt">-g</span></dfn></code></div><!-- end of settingsbox -->
+<a id="wrglossary.1799"></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.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.)
+Employ German word ordering. This will pass <a id="wrglossary.1800"></a><a href="#glo:switch.mkidx.g"><span class="shortargfmt">-g</span></a> to
+<a id="wrglossary.1801"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>. (Ignored if <a id="wrglossary.1802"></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.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 -->
+<a id="wrglossary.1803"></a><code class="code"><dfn id="glo:switch.mkgls.s"><span class="shortargfmt">-s</span></dfn> <span class="meta">〈<em class="metainner">filename</em>〉</span></code></div><!-- end of settingsbox -->
Set the style file. This will pass
-<code class="code"><a id="wrglossary.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.
+<code class="code"><a id="wrglossary.1804"></a><a href="#glo:switch.mkidx.s"><span class="shortargfmt">-s</span></a> <span class="meta">〈<em class="metainner">filename</em>〉</span></code> to <a id="wrglossary.1805"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>
+or <code class="code"><a id="wrglossary.1806"></a><a href="#glo:switch.xdy.M"><span class="shortargfmt">-M</span></a> <span class="meta">〈<em class="metainner">basename</em>〉</span></code> to <a id="wrglossary.1807"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> (where
+<span class="meta">〈<em class="metainner">basename</em>〉</span> is <span class="meta">〈<em class="metainner">filename</em>〉</span> with the <a id="wrglossary.1808"></a><a href="#glo:ext.xdy"><span class="extfmt">xdy</span></a> extension
+removed). This will generate an error if the extension is <a id="wrglossary.1809"></a><a href="#glo:ext.xdy"><span class="extfmt">xdy</span></a>
+when <a id="wrglossary.1810"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> should be called, or if the extension isn’t
+<a id="wrglossary.1811"></a><a href="#glo:ext.xdy"><span class="extfmt">xdy</span></a> when <a id="wrglossary.1812"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> should be called.
<p>
<div class="settingsbox"><div class="settingsboxtitle"><a href="#glo:sym.valuesetting"><span title="Setting" class="icon"><span class="quarterleft">🎚</span></span></a></div><!-- end of settingsboxtitle -->
-<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 -->
+<a id="wrglossary.1813"></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.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>).
+only one <a id="wrglossary.1814"></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.1815"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a>
+with the extension associated with the <a id="wrglossary.1816"></a><a href="#glo:dual.glossary">glossary</a> (the <span class="meta">〈<em class="metainner">in-ext</em>〉</span>
+argument of <a id="wrglossary.1817"></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.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 -->
+<a id="wrglossary.1818"></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.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>).
+only one <a id="wrglossary.1819"></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.1820"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a>
+with the extension associated with the <a id="wrglossary.1821"></a><a href="#glo:dual.glossary">glossary</a> (the <span class="meta">〈<em class="metainner">log-ext</em>〉</span>
+argument of <a id="wrglossary.1822"></a><a href="#glo:newglossary"><code class="csfmt">\newglossary</code></a>).
<p>
</section><!-- end of section sec:makeglossariesapp -->
@@ -8889,17 +8888,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.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>
+<pre class="terminal"><div class="terminaltitle"><a href="#glo:sym.terminal"><span title="Terminal" class="icon">〉_</span></a></div><a id="wrglossary.1823"></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.1833"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> Perl script requires
+The Lua alternative to the <a id="wrglossary.1824"></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.1834"></a><a href="#glo:app.makeglossaries-lite"><span class="appfmt">makeglossaries-lite</span></a>
+scripting languages, such as Perl. The <a id="wrglossary.1825"></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.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
+available to the <a id="wrglossary.1826"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> Perl script aren’t available
+here. (In particular the <a id="wrglossary.1827"></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
@@ -8913,119 +8912,119 @@
</div><!-- end of information -->
<p>
-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
+The <a id="wrglossary.1828"></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.1829"></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.1839"></a><a href="#glo:app.arara"><span class="appfmt">arara</span></a> rule doesn’t contain the hyphen:
+Note that the <a id="wrglossary.1830"></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.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
+Some of the options are only applicable to <a id="wrglossary.1831"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> and some
+are only applicable to <a id="wrglossary.1832"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>. There’s no equivalent to
+the <a id="wrglossary.1833"></a><a href="#glo:switch.mkgls.d"><span class="shortargfmt">-d</span></a> available to <a id="wrglossary.1834"></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.1844"></a><code class="code"><dfn id="glo:switch.mkglslite.help"><span class="longargfmt">--help</span></dfn></code></div><!-- end of settingsbox -->
+<a id="wrglossary.1835"></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.1845"></a><code class="code"><dfn id="glo:switch.mkglslite.version"><span class="longargfmt">--version</span></dfn></code></div><!-- end of settingsbox -->
+<a id="wrglossary.1836"></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.1846"></a><code class="code"><dfn id="glo:switch.mkglslite.n"><span class="shortargfmt">-n</span></dfn></code></div><!-- end of settingsbox -->
+<a id="wrglossary.1837"></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.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
+<a id="wrglossary.1838"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>/<a id="wrglossary.1839"></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.1840"></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.1850"></a><code class="code"><dfn id="glo:switch.mkglslite.q"><span class="shortargfmt">-q</span></dfn></code></div><!-- end of settingsbox -->
+<a id="wrglossary.1841"></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.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 -->
+<a id="wrglossary.1842"></a><code class="code"><dfn id="glo:switch.mkglslite.m"><span class="shortargfmt">-m</span></dfn> <span class="meta">〈<em class="metainner">application</em>〉</span></code><span class="floatrightbox"><span class="summarytag">initial: </span>makeindex</span><span class="clearfix"></span></div><!-- end of settingsbox -->
-The <a id="wrglossary.1852"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> application. Only the name is required if it’s
+The <a id="wrglossary.1843"></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.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 -->
+<a id="wrglossary.1844"></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.1854"></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.1845"></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.1855"></a><code class="code"><dfn id="glo:switch.mkglslite.c"><span class="shortargfmt">-c</span></dfn></code></div><!-- end of settingsbox -->
+<a id="wrglossary.1846"></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.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.)
+Compress intermediate blanks. This will pass <a id="wrglossary.1847"></a><a href="#glo:switch.mkidx.c"><span class="shortargfmt">-c</span></a> to
+<a id="wrglossary.1848"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>. (Ignored if <a id="wrglossary.1849"></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.1859"></a><code class="code"><dfn id="glo:switch.mkglslite.r"><span class="shortargfmt">-r</span></dfn></code></div><!-- end of settingsbox -->
+<a id="wrglossary.1850"></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.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.)
+Disable implicit page <a id="wrglossary.1851"></a><a href="#glo:idx.range">range</a> formation. This will pass <a id="wrglossary.1852"></a><a href="#glo:switch.mkidx.r"><span class="shortargfmt">-r</span></a> to
+<a id="wrglossary.1853"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>. (Ignored if <a id="wrglossary.1854"></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.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 -->
+<a id="wrglossary.1855"></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.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.)
+<code class="code"><a id="wrglossary.1856"></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.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>
The following switches may be used to override settings written to
-the <a id="wrglossary.1868"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> file.
+the <a id="wrglossary.1859"></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.1869"></a><code class="code"><dfn id="glo:switch.mkglslite.l"><span class="shortargfmt">-l</span></dfn></code></div><!-- end of settingsbox -->
+<a id="wrglossary.1860"></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.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>.
+Use letter ordering. This will pass <a id="wrglossary.1861"></a><a href="#glo:switch.mkidx.l"><span class="shortargfmt">-l</span></a> to <a id="wrglossary.1862"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>
+or <code class="code"><a id="wrglossary.1863"></a><a href="#glo:switch.xdy.M"><span class="shortargfmt">-M</span></a> ord/letorder</code> to <a id="wrglossary.1864"></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.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 -->
+<a id="wrglossary.1865"></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.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>
+The language to pass to <a id="wrglossary.1866"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>. (Ignored if <a id="wrglossary.1867"></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.1877"></a><code class="code"><dfn id="glo:switch.mkglslite.g"><span class="shortargfmt">-g</span></dfn></code></div><!-- end of settingsbox -->
+<a id="wrglossary.1868"></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.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.)
+Employ German word ordering. This will pass <a id="wrglossary.1869"></a><a href="#glo:switch.mkidx.g"><span class="shortargfmt">-g</span></a> to
+<a id="wrglossary.1870"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>. (Ignored if <a id="wrglossary.1871"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> should be called.)
<p>
<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.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 -->
+<a id="wrglossary.1872"></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.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 -->
+<a id="wrglossary.1873"></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.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>).
+only one <a id="wrglossary.1874"></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.1875"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a>
+with the extension associated with the <a id="wrglossary.1876"></a><a href="#glo:dual.glossary">glossary</a> (the <span class="meta">〈<em class="metainner">in-ext</em>〉</span>
+argument of <a id="wrglossary.1877"></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.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 -->
+<a id="wrglossary.1878"></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.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>).
+only one <a id="wrglossary.1879"></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.1880"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a>
+with the extension associated with the <a id="wrglossary.1881"></a><a href="#glo:dual.glossary">glossary</a> (the <span class="meta">〈<em class="metainner">log-ext</em>〉</span>
+argument of <a id="wrglossary.1882"></a><a href="#glo:newglossary"><code class="csfmt">\newglossary</code></a>).
<p>
</section><!-- end of section sec:makeglossarieslua -->
@@ -9034,60 +9033,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.1892"></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.1883"></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.1893"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> to process the glossary
+If you want to use <a id="wrglossary.1884"></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.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}
+<a id="wrglossary.1885"></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.1886"></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.1896"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>
+This is required regardless of whether you use <a id="wrglossary.1887"></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.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>.
+as <a id="wrglossary.1888"></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.1889"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> format, so you need to
+use <code class="code"><a id="wrglossary.1890"></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.1891"></a><a href="#glo:switch.xdy.I"><span class="shortargfmt">-I</span></a> tex</code>.
<p>
-To run <a id="wrglossary.1901"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> type the following in your terminal
+To run <a id="wrglossary.1892"></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.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 class="terminal"><div class="terminaltitle"><a href="#glo:sym.terminal"><span title="Terminal" class="icon">〉_</span></a></div>xindy <a id="wrglossary.1893"></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.1894"></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.1895"></a><a href="#glo:switch.xdy.I"><span class="shortargfmt">-I</span></a> xindy <a id="wrglossary.1896"></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.1897"></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.1898"></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.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.
+is the <a id="wrglossary.1899"></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.1900"></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.1901"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> style file without the <a id="wrglossary.1902"></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.1912"></a><a href="#glo:setStyleFile"><code class="csfmt">\setStyleFile</code></a>. As usual for command line
+but can be changed via <a id="wrglossary.1903"></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.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
+you are using <a id="wrglossary.1904"></a><a href="#glo:dual.utf8">UTF-8</a> <a id="wrglossary.1905"></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.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
+Note that this just creates the <a id="wrglossary.1906"></a><a href="#glo:opt.glostype.main"><code class="glostypefmt">main</code></a> <a id="wrglossary.1907"></a><a href="#glo:dual.glossary">glossary</a>. You need to do
+the same for each of the other <a id="wrglossary.1908"></a><a href="#glo:dual.glossary">glossaries</a> (including the
+list of <a id="wrglossary.1909"></a><a href="#glo:idx.acronym">acronyms</a> if you have used the <a id="wrglossary.1910"></a><a href="#glo:opt.acronym"><span class="styoptfmt">acronym</span></a>
+package option), substituting <a id="wrglossary.1911"></a><a href="#glo:ext.glg"><span class="extfmt">glg</span></a>, <a id="wrglossary.1912"></a><a href="#glo:ext.gls"><span class="extfmt">gls</span></a>
+and <a id="wrglossary.1913"></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.1914"></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.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>.
+For additional <a id="wrglossary.1915"></a><a href="#glo:dual.glossary">glossaries</a>, the extensions are those supplied
+when you created the <a id="wrglossary.1916"></a><a href="#glo:dual.glossary">glossary</a> with <a id="wrglossary.1917"></a><a href="#glo:newglossary"><code class="csfmt">\newglossary</code></a>.
<p>
-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>:
+Note that if you use <a id="wrglossary.1918"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> instead, you can
+replace all those calls to <a id="wrglossary.1919"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> with just one call
+to <a id="wrglossary.1920"></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.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
+you use <a id="wrglossary.1921"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> explicitly instead of using
+<a id="wrglossary.1922"></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>
@@ -9098,19 +9097,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.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
+If you want to use <a id="wrglossary.1923"></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.1924"></a><a href="#glo:opt.xindy"><span class="styoptfmt">xindy</span></a> package
+option or the <a id="wrglossary.1925"></a><a href="#glo:idx.glossaryentry">glossary entries</a> will be written in the wrong
+format. To run <a id="wrglossary.1926"></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.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 class="terminal"><div class="terminaltitle"><a href="#glo:sym.terminal"><span title="Terminal" class="icon">〉_</span></a></div>makeindex <a id="wrglossary.1927"></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.1928"></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.1929"></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.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
+<a id="wrglossary.1930"></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.1931"></a><a href="#glo:ext.ist"><span class="extfmt">ist</span></a> is the
+name of the <a id="wrglossary.1932"></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.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>
+<a id="wrglossary.1933"></a><a href="#glo:setStyleFile"><code class="csfmt">\setStyleFile</code></a>. Note that there are other options,
+such as <a id="wrglossary.1934"></a><a href="#glo:switch.mkidx.l"><span class="shortargfmt">-l</span></a> (letter ordering). See the <a id="wrglossary.1935"></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
@@ -9117,27 +9116,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.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
+Note that this only creates the <a id="wrglossary.1936"></a><a href="#glo:opt.glostype.main"><code class="glostypefmt">main</code></a> <a id="wrglossary.1937"></a><a href="#glo:dual.glossary">glossary</a>. If you have
+additional <a id="wrglossary.1938"></a><a href="#glo:dual.glossary">glossaries</a> (for example, if you have used the
+<a id="wrglossary.1939"></a><a href="#glo:opt.acronym"><span class="styoptfmt">acronym</span></a> package option) then you must call
+<a id="wrglossary.1940"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> for each glossary, substituting
+<a id="wrglossary.1941"></a><a href="#glo:ext.glg"><span class="extfmt">glg</span></a>, <a id="wrglossary.1942"></a><a href="#glo:ext.gls"><span class="extfmt">gls</span></a> and <a id="wrglossary.1943"></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.1953"></a><a href="#glo:opt.acronym"><span class="styoptfmt">acronym</span></a> package option, then you need to type the
+<a id="wrglossary.1944"></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.1954"></a><a href="#glo:newglossary"><code class="csfmt">\newglossary</code></a>.
+when you created the glossary with <a id="wrglossary.1945"></a><a href="#glo:newglossary"><code class="csfmt">\newglossary</code></a>.
<p>
-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>:
+Note that if you use <a id="wrglossary.1946"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> instead, you can
+replace all those calls to <a id="wrglossary.1947"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> with just one call
+to <a id="wrglossary.1948"></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.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
+you use <a id="wrglossary.1949"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> explicitly instead of using
+<a id="wrglossary.1950"></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>
@@ -9147,10 +9146,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.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>
+The information needed to determine whether to use <a id="wrglossary.1951"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>,
+<a id="wrglossary.1952"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> or <a id="wrglossary.1953"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> is stored in the <a id="wrglossary.1954"></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.1964"></a><a href="#glo:dual.glossary">glossaries</a> where appropriate. This section
+script to make the <a id="wrglossary.1955"></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
@@ -9163,80 +9162,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.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:
+The <a id="wrglossary.1956"></a><a href="#glo:idx.fileextension">file extension</a> of the <a id="wrglossary.1957"></a><a href="#glo:dual.indexingfile">indexing files</a> used for each defined
+<a id="wrglossary.1958"></a><a href="#glo:dual.glossary">glossary</a> (not including any <a id="wrglossary.1959"></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.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 -->
+<a id="wrglossary.1960"></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.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
+<span style="font-style: italic; font-variant: normal; "><a id="wrglossary.1961"></a><a href="#glo:dual.indexingapp">indexing application’s</a></span> input file (the output file from the
+<a id="wrglossary.1962"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package’s point of view), such as <a id="wrglossary.1963"></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.1964"></a><a href="#glo:dual.indexingapp">indexing application’s</a></span>
+output file (the input file from the <a id="wrglossary.1965"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package’s
+point of view), such as <a id="wrglossary.1966"></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.1967"></a><a href="#glo:dual.indexingapp">indexing application’s</a> transcript file, such as <a id="wrglossary.1968"></a><a href="#glo:ext.glg"><span class="extfmt">glg</span></a>.
+The label for the <a id="wrglossary.1969"></a><a href="#glo:dual.glossary">glossary</a> is also given. This isn’t required
+with <a id="wrglossary.1970"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>, but with <a id="wrglossary.1971"></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.1972"></a><a href="#glo:idx.encoding">encoding</a> (see below). For example, the
+information for the default <a id="wrglossary.1973"></a><a href="#glo:opt.glostype.main"><code class="glostypefmt">main</code></a> <a id="wrglossary.1974"></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.1984"></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.1975"></a><a href="#glo:@newglossary"><code class="csfmt">\@newglossary</code></a>{main}{glg}{gls}{glo}
</pre>
-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:
+If <a id="wrglossary.1976"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span>’s</a> hybrid method has been used (with
+<a id="wrglossary.1977"></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.1978"></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.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 -->
+<a id="wrglossary.1979"></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.1989"></a><a href="#glo:dual.indexingapp">indexing application’s</a> style file is specified by:
+The <a id="wrglossary.1980"></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.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 -->
+<a id="wrglossary.1981"></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.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
+The file extension indicates whether to use <a id="wrglossary.1982"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>
+(<a id="wrglossary.1983"></a><a href="#glo:ext.ist"><span class="extfmt">ist</span></a>) or <a id="wrglossary.1984"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> (<a id="wrglossary.1985"></a><a href="#glo:ext.xdy"><span class="extfmt">xdy</span></a>). Note that
+the <a id="wrglossary.1986"></a><a href="#glo:dual.glossary">glossary</a> information has a different syntax depending on
+which <a id="wrglossary.1987"></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.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>:
+For example, with <a id="wrglossary.1988"></a><a href="#glo:app.arara"><span class="appfmt">arara</span></a> you can easily determine whether to
+run <a id="wrglossary.1989"></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.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>.
+It’s more complicated if you want to explicitly run <a id="wrglossary.1990"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>
+or <a id="wrglossary.1991"></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.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.
+Note that if you choose to explicitly call <a id="wrglossary.1992"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> or
+<a id="wrglossary.1993"></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.1994"></a><a href="#glo:locationencap">encap</a>-clash fix
+that <a id="wrglossary.1995"></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.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 -->
+<a id="wrglossary.1996"></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.2006"></a><a href="#glo:opt.order"><span class="styoptfmt">order</span></a> package option).
+(obtained from the <a id="wrglossary.1997"></a><a href="#glo:opt.order"><span class="styoptfmt">order</span></a> package option).
<p>
-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:
+If <a id="wrglossary.1998"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> should be used, the language for each <a id="wrglossary.1999"></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.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 -->
+<a id="wrglossary.2000"></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.2010"></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.2001"></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.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:
+The <a id="wrglossary.2002"></a><a href="#glo:idx.codepage">codepage</a> (file <a id="wrglossary.2003"></a><a href="#glo:idx.encoding">encoding</a>) for all <a id="wrglossary.2004"></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.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 -->
+<a id="wrglossary.2005"></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.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.
+where <span class="meta">〈<em class="metainner">code</em>〉</span> is the <a id="wrglossary.2006"></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.2007"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> should be used.
<p>
-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
+If <a id="wrglossary.2008"></a><a href="#glo:idx.opt.noidx">Option 1</a> has been used, the <a id="wrglossary.2009"></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.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 -->
+<a id="wrglossary.2010"></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>
@@ -9247,18 +9246,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.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
+If you need to gather labels for <a id="wrglossary.2011"></a><a href="#glo:idx.auto-completion">auto-completion</a>, the
+<a id="wrglossary.2012"></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.2013"></a><a href="#glo:idx.glossaryentry">entries</a> (regardless of whether or not the
+<a id="wrglossary.2014"></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.2015"></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.2025"></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.2016"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a></div><!-- end of informationtitle -->
-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>.
+The <a id="wrglossary.2017"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>
+package also provides <a id="wrglossary.2018"></a><a href="#glo:opt.docdef"><span class="xtrstyoptfmt">docdef</span></a><span class="optfmt">=atom</span>, which will create the
+<a id="wrglossary.2019"></a><a href="#glo:ext.glsdefs"><span class="extfmt">glsdefs</span></a> file but will act like <a id="wrglossary.2020"></a><a href="#glo:opt.docdef"><span class="xtrstyoptfmt">docdef</span></a><span class="optfmt">=restricted</span>.
</div><!-- end of information -->
<p>
@@ -9269,57 +9268,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.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
+<div class="sidenote"><a id="wrglossary.2021"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a></div><span class="clearfix"></span><!-- end of sidenote -->
+If <a id="wrglossary.2022"></a><a href="#glo:idx.opt.b2g">Option 4</a> has been used, the <a id="wrglossary.2023"></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.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 -->
+<a id="wrglossary.2024"></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.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
+where <span class="meta">〈<em class="metainner">basename</em>〉</span> is the basename of the <a id="wrglossary.2025"></a><a href="#glo:ext.glstex"><span class="extfmt">glstex</span></a> file that
+needs to be created by <a id="wrglossary.2026"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>. If
+<a id="wrglossary.2027"></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.2037"></a><a href="#glo:ext.bib"><span class="extfmt">bib</span></a> file.
+associated <a id="wrglossary.2028"></a><a href="#glo:ext.bib"><span class="extfmt">bib</span></a> file.
<p>
-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>:
+For example, with <a id="wrglossary.2029"></a><a href="#glo:app.arara"><span class="appfmt">arara</span></a> you can easily determine whether or
+not to run <a id="wrglossary.2030"></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.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.)
+(It gets more complicated if both <a id="wrglossary.2031"></a><a href="#glo:glsxtr at resource"><code class="csfmt">\glsxtr at resource</code></a> and
+<a id="wrglossary.2032"></a><a href="#glo:@istfilename"><code class="csfmt">\@istfilename</code></a> are present as that indicates the hybrid
+<a id="wrglossary.2033"></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.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
+Remember that with <a id="wrglossary.2034"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>, the <a id="wrglossary.2035"></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.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
+in the <a id="wrglossary.2036"></a><a href="#glo:ext.glstex"><span class="extfmt">glstex</span></a> file created by <a id="wrglossary.2037"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>). You can
+also pick up labels from the <a id="wrglossary.2038"></a><a href="#glo:dual.indexing">records</a> in <a id="wrglossary.2039"></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.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 -->
+<a id="wrglossary.2040"></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.2050"></a><a href="#glo:opt.record"><span class="xtrstyoptfmt">record</span></a><span class="optfmt">=nameref</span>):
+or (with <a id="wrglossary.2041"></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.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 -->
+<a id="wrglossary.2042"></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.2052"></a><a href="#glo:glssee"><code class="csfmt">\glssee</code></a>):
+or (with <a id="wrglossary.2043"></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.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 -->
+<a id="wrglossary.2044"></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.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:
+<a id="wrglossary.2045"></a><a href="#glo:glsxtrnewglslike"><code class="xtrcsfmt">\glsxtrnewglslike</code></a>, which are added to the <a id="wrglossary.2046"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> file
+for <a id="wrglossary.2047"></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.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 -->
+<a id="wrglossary.2048"></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.2058"></a><a href="#glo:GlsXtrSetAltModifier"><code class="xtrcsfmt">\GlsXtrSetAltModifier</code></a> is used, then the modifier is
+If <a id="wrglossary.2049"></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.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 -->
+<a id="wrglossary.2050"></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.2060"></a><a href="#glo:dgls"><code class="xtrcsfmt">\dgls</code></a> set of commands) are identified
+Label prefixes (for the <a id="wrglossary.2051"></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.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 -->
+<a id="wrglossary.2052"></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>
@@ -9329,17 +9328,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.2062"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package
+This section describes the available <a id="wrglossary.2053"></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.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>).
+example, <a id="wrglossary.2054"></a><a href="#glo:opt.acronym"><span class="styoptfmt">acronym</span></a> is equivalent to <a id="wrglossary.2055"></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.2065"></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.2056"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a></div><!-- end of informationtitle -->
-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
+The <a id="wrglossary.2057"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package has additional options described
+in the <a id="wrglossary.2058"></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.2068"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> may have additional package
+versions of <a id="wrglossary.2059"></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 -->
@@ -9347,9 +9346,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.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
+may be omitted, such as <a id="wrglossary.2060"></a><a href="#glo:opt.acronym"><span class="styoptfmt">acronym</span></a>.) This is a general limitation
+not restricted to the <a id="wrglossary.2061"></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.2062"></a><a href="#glo:opt.makeindex"><span class="styoptfmt">makeindex</span></a>) may be passed via the document
class options.
</div><!-- end of important -->
@@ -9364,112 +9363,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.2072"></a><code class="code"><dfn id="glo:opt.nowarn"><span class="styoptfmt">nowarn</span></dfn></code></div><!-- end of settingsbox -->
+<a id="wrglossary.2063"></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.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
+the <a id="wrglossary.2064"></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.2065"></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.2066"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a>).
+Note that if you use <a id="wrglossary.2067"></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.2077"></a><code class="code"><dfn id="glo:opt.nolangwarn"><span class="styoptfmt">nolangwarn</span></dfn></code></div><!-- end of settingsbox -->
+<a id="wrglossary.2068"></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.2078"></a><code class="code"><dfn id="glo:opt.noredefwarn"><span class="styoptfmt">noredefwarn</span></dfn></code></div><!-- end of settingsbox -->
+<a id="wrglossary.2069"></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.2079"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> with
+If you load <a id="wrglossary.2070"></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.2080"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> will warn you that it’s
+commands, by default <a id="wrglossary.2071"></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.2081"></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.2072"></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.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>.)
+<a id="wrglossary.2073"></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.2074"></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.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 -->
+<a id="wrglossary.2075"></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.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 -->
+<a id="wrglossary.2076"></a><a id="wrglossary.2077"></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.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 -->
+<a id="wrglossary.2078"></a><a id="wrglossary.2079"></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.2089"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a>:
+opened by <a id="wrglossary.2080"></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.2090"></a><a href="#glo:opt.nowarn"><span class="styoptfmt">nowarn</span></a>.
+Note that this setting will also cancel <a id="wrglossary.2081"></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.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 -->
+<a id="wrglossary.2082"></a><a id="wrglossary.2083"></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.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.
+As <a id="wrglossary.2084"></a><a href="#glo:opt.debug"><span class="styoptfmt">debug</span></a><span class="optfmt">=</span><a id="wrglossary.2085"></a><a href="#glo:optval.debug.true"><span class="optfmt">true</span></a> but also adds a marker where the
+<a id="wrglossary.2086"></a><a href="#glo:dual.glossary">glossary</a>-related <a id="wrglossary.2087"></a><a href="#glo:idx.hyperlink">hyperlinks</a> and targets occur in the document.
<p>
-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:
+The <a id="wrglossary.2088"></a><a href="#glo:opt.debug"><span class="styoptfmt">debug</span></a><span class="optfmt">=</span><a id="wrglossary.2089"></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.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 -->
+<a id="wrglossary.2090"></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.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:
+to show the <a id="wrglossary.2091"></a><a href="#glo:idx.hypertarget">hypertarget</a> or <a id="wrglossary.2092"></a><a href="#glo:idx.hyperlink">hyperlink</a> name when
+<a id="wrglossary.2093"></a><a href="#glo:glsdohypertarget"><code class="csfmt">\glsdohypertarget</code></a> is used by commands like <a id="wrglossary.2094"></a><a href="#glo:glstarget"><code class="csfmt">\glstarget</code></a>
+and when <a id="wrglossary.2095"></a><a href="#glo:glsdohyperlink"><code class="csfmt">\glsdohyperlink</code></a> is used by commands like <a id="wrglossary.2096"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>.
+In <a id="wrglossary.2097"></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.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 -->
+<a id="wrglossary.2098"></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.2108"></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.2099"></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.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 -->
+<a id="wrglossary.2100"></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.2110"></a><a href="#glo:glsshowtarget"><code class="csfmt">\glsshowtarget</code></a> uses:
+In outer mode <a id="wrglossary.2101"></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.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 -->
+<a id="wrglossary.2102"></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.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 -->
+<a id="wrglossary.2103"></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.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:
+The font used by both <a id="wrglossary.2104"></a><a href="#glo:glsshowtargetfonttext"><code class="csfmt">\glsshowtargetfonttext</code></a> and
+<a id="wrglossary.2105"></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.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 -->
+<a id="wrglossary.2106"></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.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 -->
+<a id="wrglossary.2107"></a><a id="wrglossary.2108"></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.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:
+As <a id="wrglossary.2109"></a><a href="#glo:opt.debug"><span class="styoptfmt">debug</span></a><span class="optfmt">=</span><a id="wrglossary.2110"></a><a href="#glo:optval.debug.true"><span class="optfmt">true</span></a> but also adds a marker where the
+<a id="wrglossary.2111"></a><a href="#glo:dual.glossary">glossary</a>-related accessibility information occurs (see
+<a id="wrglossary.2112"></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.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 -->
+<a id="wrglossary.2113"></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.2123"></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.2114"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a></div><!-- end of informationtitle -->
-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>
+The <a id="wrglossary.2115"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package provides extra values
+<a id="wrglossary.2116"></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.2117"></a><a href="#glo:dual.indexing">indexing</a> is occurring, and <a id="wrglossary.2118"></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.2119"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>
manual for further details.
</div><!-- end of information -->
@@ -9478,46 +9477,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.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="cmd">\newglossaryentry</code>{sample1}{<a id="wrglossary.2120"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={sample1}</span>,<a id="wrglossary.2121"></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.2122"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={sample2}</span>,<a id="wrglossary.2123"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={example}</span>}
+<strong class="strong"><a id="wrglossary.2124"></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.2125"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a></strong>
<code class="cbeg">\begin{document}</code>
-<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>
+<a id="wrglossary.2126"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{sample1}.
+<a id="wrglossary.2127"></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.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
+In this case, only the <span class="qt">“sample1”</span> entry has been <a id="wrglossary.2128"></a><a href="#glo:dual.indexing">indexed</a>, even
+though <code class="code"><a id="wrglossary.2129"></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.2130"></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.2131"></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.2141"></a><a href="#glo:dual.glossary">glossary</a>.
+the <span class="qt">“sample2”</span> entry doesn’t appear in the <a id="wrglossary.2132"></a><a href="#glo:dual.glossary">glossary</a>.
<p>
-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>
+Without <a id="wrglossary.2133"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a> the <a id="wrglossary.2134"></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.2135"></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.2145"></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.2136"></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.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
+<a id="wrglossary.2137"></a><a href="#glo:dual.firstuse">first use</a>) but not display any <a id="wrglossary.2138"></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.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
+<a id="wrglossary.2139"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a> in order to suppress the <a id="wrglossary.2140"></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.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>.
+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.2141"></a><a href="#glo:dual.indexing">indexing</a>, which don’t
+use <a id="wrglossary.2142"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a>.
<p>
-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>.
+Therefore <a id="wrglossary.2143"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a> can’t be used to enable
+<a id="wrglossary.2144"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a> and commands like <a id="wrglossary.2145"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> and <a id="wrglossary.2146"></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.2156"></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.2147"></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.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}
+The debug mode, enabled with the <a id="wrglossary.2148"></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.2149"></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.2159"></a><a href="#glo:dual.indexing">indexing</a>
+will write information to the log file when the <a id="wrglossary.2150"></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
@@ -9526,17 +9525,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.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
+glossary but you’re sure you used commands like <a id="wrglossary.2151"></a><a href="#glo:glsadd"><code class="csfmt">\glsadd</code></a>
+or <a id="wrglossary.2152"></a><a href="#glo:glsaddall"><code class="csfmt">\glsaddall</code></a>, try switching on the <a id="wrglossary.2153"></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.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 -->
+<a id="wrglossary.2154"></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.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
+number of write registers used by the <a id="wrglossary.2155"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package.
+The default is <a id="wrglossary.2156"></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.2157"></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 -->
@@ -9545,90 +9544,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.2167"></a><a href="#glo:ext.glsdefs"><span class="extfmt">glsdefs</span></a> file is needed to save document
+required if the <a id="wrglossary.2158"></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.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
+(document definitions aren’t permitted and <a id="wrglossary.2159"></a><a href="#glo:dual.indexing">indexing</a> information is
+written to the <a id="wrglossary.2160"></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.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>.
+then consider using <a id="wrglossary.2161"></a><a href="#glo:opt.docdef"><span class="xtrstyoptfmt">docdef</span></a><span class="optfmt">=restricted</span> with
+<a id="wrglossary.2162"></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.2172"></a><a href="#glo:dual.glossary">glossaries</a> or if you are using a class or other
+a large number of <a id="wrglossary.2163"></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.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
+maximum number of available registers. If <a id="wrglossary.2164"></a><a href="#glo:opt.savewrites"><span class="styoptfmt">savewrites</span></a> is
+set, the <a id="wrglossary.2165"></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.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>
+cause the <a id="wrglossary.2166"></a><a href="#glo:dual.indexing">indexing</a> to fail. Page numbers in the <a id="wrglossary.2167"></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.2177"></a><a href="#glo:pkg.scrwfile"><span class="styfmt">scrwfile</span></a>
+output routine. As an alternative, you can use the <a id="wrglossary.2168"></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.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
+provided with <a id="wrglossary.2169"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> has a total of 15 <a id="wrglossary.2170"></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.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
+and registers provided by the kernel or <a id="wrglossary.2171"></a><a href="#glo:pkg.hyperref"><span class="styfmt">hyperref</span></a>, such as
+<a id="wrglossary.2172"></a><a href="#glo:ext.aux"><span class="extfmt">aux</span></a> and <span class="filefmt">out</span>.) With
+<a id="wrglossary.2173"></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.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>.
+If you want to use TeX’s <a id="wrglossary.2174"></a><a href="#glo:dual.shellescape">shell escape</a> to call
+<a id="wrglossary.2175"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> or <a id="wrglossary.2176"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> from your document and use
+<a id="wrglossary.2177"></a><a href="#glo:opt.savewrites"><span class="styoptfmt">savewrites</span></a>, then use <a id="wrglossary.2178"></a><a href="#glo:opt.automake"><span class="styoptfmt">automake</span></a><span class="optfmt">=</span><a id="wrglossary.2179"></a><a href="#glo:optval.automake.immediate"><span class="optfmt">immediate</span></a> or
+<a id="wrglossary.2180"></a><a href="#glo:opt.automake"><span class="styoptfmt">automake</span></a><span class="optfmt">=</span><a id="wrglossary.2181"></a><a href="#glo:optval.automake.makegloss"><span class="optfmt">makegloss</span></a> or <a id="wrglossary.2182"></a><a href="#glo:opt.automake"><span class="styoptfmt">automake</span></a><span class="optfmt">=</span><a id="wrglossary.2183"></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.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 -->
+<a id="wrglossary.2184"></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.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>.
+<a id="wrglossary.2185"></a><a href="#glo:opt.translate"><span class="styoptfmt">translate</span></a><span class="optfmt">=</span><a id="wrglossary.2186"></a><a href="#glo:optval.translate.false"><span class="optfmt">false</span></a> otherwise the default is
+<a id="wrglossary.2187"></a><a href="#glo:opt.translate"><span class="styoptfmt">translate</span></a><span class="optfmt">=</span><a id="wrglossary.2188"></a><a href="#glo:optval.translate.true"><span class="optfmt">true</span></a> for the base <a id="wrglossary.2189"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package
+and <a id="wrglossary.2190"></a><a href="#glo:opt.translate"><span class="styoptfmt">translate</span></a><span class="optfmt">=</span><a id="wrglossary.2191"></a><a href="#glo:optval.translate.babel"><span class="optfmt">babel</span></a> for <a id="wrglossary.2192"></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.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 -->
+<a id="wrglossary.2193"></a><a id="wrglossary.2194"></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.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
+If <a id="wrglossary.2195"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a> has been loaded and the <a id="wrglossary.2196"></a><a href="#glo:pkg.translator"><span class="styfmt">translator</span></a> package is
+installed, <a id="wrglossary.2197"></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.2198"></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.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
+<a id="wrglossary.2199"></a><a href="#glo:pkg.translator"><span class="styfmt">translator</span></a> package isn’t installed and <a id="wrglossary.2200"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a> is loaded,
+the <a id="wrglossary.2201"></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.2202"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span>’s</a>
+<code class="csfmt">\addto</code><a id="wrglossary.2203"></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.2204"></a><a href="#glo:pkg.polyglossia"><span class="styfmt">polyglossia</span></a> has been loaded, <a id="wrglossary.2205"></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.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 -->
+<a id="wrglossary.2206"></a><a id="wrglossary.2207"></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.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>.)
+Don’t provide translations, even if <a id="wrglossary.2208"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a> or <a id="wrglossary.2209"></a><a href="#glo:pkg.polyglossia"><span class="styfmt">polyglossia</span></a>
+has been loaded. (Note that <a id="wrglossary.2210"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a> provides the command
+<a id="wrglossary.2211"></a><a href="#glo:glossaryname"><code class="csfmt">\glossaryname</code></a> so that will still be translated if you have
+loaded <a id="wrglossary.2212"></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.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 -->
+<a id="wrglossary.2213"></a><a id="wrglossary.2214"></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.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>.
+Don’t load the <a id="wrglossary.2215"></a><a href="#glo:pkg.translator"><span class="styfmt">translator</span></a> package. Instead load <a id="wrglossary.2216"></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.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>.
+I recommend you use <a id="wrglossary.2217"></a><a href="#glo:opt.translate"><span class="styoptfmt">translate</span></a><span class="optfmt">=</span><a id="wrglossary.2218"></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.2219"></a><a href="#glo:idx.PDFbookmark">PDF bookmarks</a>, but to maintain backward
+compatibility, if <a id="wrglossary.2220"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a> has been loaded the default is
+<a id="wrglossary.2221"></a><a href="#glo:opt.translate"><span class="styoptfmt">translate</span></a><span class="optfmt">=</span><a id="wrglossary.2222"></a><a href="#glo:optval.translate.true"><span class="optfmt">true</span></a>.
</div><!-- end of important -->
<p>
@@ -9635,184 +9634,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.2232"></a><code class="code"><dfn id="glo:opt.notranslate"><span class="styoptfmt">notranslate</span></dfn></code></div><!-- end of settingsbox -->
+<a id="wrglossary.2223"></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.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
+This is equivalent to <a id="wrglossary.2224"></a><a href="#glo:opt.translate"><span class="styoptfmt">translate</span></a><span class="optfmt">=</span><a id="wrglossary.2225"></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.2235"></a><code class="code"><dfn id="glo:opt.languages"><span class="styoptfmt">languages</span></dfn></code></div><!-- end of settingsbox -->
+<a id="wrglossary.2226"></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.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
+This automatically implements <a id="wrglossary.2227"></a><a href="#glo:opt.translate"><span class="styoptfmt">translate</span></a><span class="optfmt">=</span><a id="wrglossary.2228"></a><a href="#glo:optval.translate.babel"><span class="optfmt">babel</span></a> (which
+means that <a id="wrglossary.2229"></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.2230"></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.2240"></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.2231"></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.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 -->
+<a id="wrglossary.2232"></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.2242"></a><a href="#glo:opt.languages"><span class="styoptfmt">languages</span></a>.
+Synonym of <a id="wrglossary.2233"></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.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 -->
+<a id="wrglossary.2234"></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.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 true, terms on <a id="wrglossary.2235"></a><a href="#glo:dual.firstuse">first use</a> will have a <a id="wrglossary.2236"></a><a href="#glo:idx.hyperlink">hyperlink</a>, if
+supported, unless the <a id="wrglossary.2237"></a><a href="#glo:idx.hyperlink">hyperlink</a> is explicitly suppressed using
+starred versions of commands such as <code class="code"><a id="wrglossary.2238"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>*</code>.
+If false, only <a id="wrglossary.2239"></a><a href="#glo:dual.subsequentuse">subsequent use</a> instances will have a <a id="wrglossary.2240"></a><a href="#glo:idx.hyperlink">hyperlink</a>
(if supported).
<p>
-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>).
+Note that <a id="wrglossary.2241"></a><a href="#glo:opt.nohypertypes"><span class="styoptfmt">nohypertypes</span></a> overrides <a id="wrglossary.2242"></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.2243"></a><a href="#glo:dual.firstuseflag">first use flag</a>, such
+as the <a id="wrglossary.2244"></a><a href="#glo:glslike"><code class="csfmt">\gls</code>-like</a> commands (for example, <a id="wrglossary.2245"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> or
+<a id="wrglossary.2246"></a><a href="#glo:glsdisp"><code class="csfmt">\glsdisp</code></a>), but not the <a id="wrglossary.2247"></a><a href="#glo:glstextlike"><code class="csfmt">\glstext</code>-like</a> commands
+(for example, <a id="wrglossary.2248"></a><a href="#glo:glslink"><code class="csfmt">\glslink</code></a> or <a id="wrglossary.2249"></a><a href="#glo:glstext"><code class="csfmt">\glstext</code></a>).
<p>
-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
+The <a id="wrglossary.2250"></a><a href="#glo:opt.hyperfirst"><span class="styoptfmt">hyperfirst</span></a> setting applies to
+all <a id="wrglossary.2251"></a><a href="#glo:dual.glossary">glossary</a> types (unless identified by <a id="wrglossary.2252"></a><a href="#glo:opt.nohypertypes"><span class="styoptfmt">nohypertypes</span></a> or
+defined with <a id="wrglossary.2253"></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.2254"></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.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>.
+It may be that you only want to suppress <a id="wrglossary.2255"></a><a href="#glo:idx.hyperlink">hyperlinks</a> for just the <a id="wrglossary.2256"></a><a href="#glo:idx.acronym">acronyms</a>
+(where the <a id="wrglossary.2257"></a><a href="#glo:dual.firstuse">first use</a> explains the meaning of the <a id="wrglossary.2258"></a><a href="#glo:idx.acronym">acronym</a>) but not
+for ordinary <a id="wrglossary.2259"></a><a href="#glo:idx.glossaryentry">glossary entries</a> (where the <a id="wrglossary.2260"></a><a href="#glo:dual.firstuse">first use</a> is identical to
+<a id="wrglossary.2261"></a><a href="#glo:dual.subsequentuse">subsequent use</a>). In this case, you can use <a id="wrglossary.2262"></a><a href="#glo:opt.hyperfirst"><span class="styoptfmt">hyperfirst</span></a><span class="optfmt">=false</span> and
+apply <a id="wrglossary.2263"></a><a href="#glo:glsunsetall"><code class="csfmt">\glsunsetall</code></a> to all the regular (non-<a id="wrglossary.2264"></a><a href="#glo:idx.acronym">acronym</a>)
+<a id="wrglossary.2265"></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.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>
+<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.2266"></a><a href="#glo:opt.acronym"><span class="styoptfmt">acronym</span></a>,<a id="wrglossary.2267"></a><a href="#glo:opt.hyperfirst"><span class="styoptfmt">hyperfirst</span></a><span class="optfmt">=false</span>]{glossaries}
+<span class="comment">% <a id="wrglossary.2268"></a><a href="#glo:idx.acronym">acronym</a> and <a id="wrglossary.2269"></a><a href="#glo:idx.glossaryentry">glossary entry</a> definitions</span>
<span class="comment">% at the end of the preamble</span>
-<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>]
+<a id="wrglossary.2270"></a><a href="#glo:glsunsetall"><code class="csfmt">\glsunsetall</code></a>[<a id="wrglossary.2271"></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.2281"></a><code class="code"><dfn id="glo:glslinkcheckfirsthyperhook"><code class="csfmt">\glslinkcheckfirsthyperhook</code></dfn></code></div><!-- end of pinnedbox -->
+<a id="wrglossary.2272"></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.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>
+which is used by the commands that check the <a id="wrglossary.2273"></a><a href="#glo:dual.firstuseflag">first use flag</a>, such
+as <a id="wrglossary.2274"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>. Within the definition of this command, you can use
+<a id="wrglossary.2275"></a><a href="#glo:glslabel"><code class="csfmt">\glslabel</code></a> to reference the <a id="wrglossary.2276"></a><a href="#glo:idx.glossaryentry">entry</a> label and <a id="wrglossary.2277"></a><a href="#glo:glstype"><code class="csfmt">\glstype</code></a> to
+reference the <a id="wrglossary.2278"></a><a href="#glo:dual.glossary">glossary</a> type. You can also use <a id="wrglossary.2279"></a><a href="#glo:ifglsused"><code class="csfmt">\ifglsused</code></a>
+to determine if the <a id="wrglossary.2280"></a><a href="#glo:idx.glossaryentry">entry</a> has been used. You can test if an
+<a id="wrglossary.2281"></a><a href="#glo:idx.glossaryentry">entry</a> is an <a id="wrglossary.2282"></a><a href="#glo:idx.acronym">acronym</a> by checking if it has the <a id="wrglossary.2283"></a><a href="#glo:opt.gloskey.long"><span class="csoptfmt">long</span></a> key set using
+<a id="wrglossary.2284"></a><a href="#glo:ifglshaslong"><code class="csfmt">\ifglshaslong</code></a> (or if the <a id="wrglossary.2285"></a><a href="#glo:opt.gloskey.short"><span class="csoptfmt">short</span></a> key has been set using
+<a id="wrglossary.2286"></a><a href="#glo:ifglshasshort"><code class="csfmt">\ifglshasshort</code></a>). For example, to switch off the <a id="wrglossary.2287"></a><a href="#glo:idx.hyperlink">hyperlink</a> on
+<a id="wrglossary.2288"></a><a href="#glo:dual.firstuse">first use</a> just for <a id="wrglossary.2289"></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.2290"></a><a href="#glo:glslinkcheckfirsthyperhook"><code class="csfmt">\glslinkcheckfirsthyperhook</code></a>}{<span class="comment">% </span>
+ <a id="wrglossary.2291"></a><a href="#glo:ifglsused"><code class="csfmt">\ifglsused</code></a>{<a id="wrglossary.2292"></a><a href="#glo:glslabel"><code class="csfmt">\glslabel</code></a>}{}<span class="comment">% </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>
+ <a id="wrglossary.2293"></a><a href="#glo:ifglshaslong"><code class="csfmt">\ifglshaslong</code></a>{<a id="wrglossary.2294"></a><a href="#glo:glslabel"><code class="csfmt">\glslabel</code></a>}{<code class="cmd">\setkeys</code>{glslink}{<a id="wrglossary.2295"></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.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.)
+<a id="wrglossary.2296"></a><a href="#glo:dual.firstuseflag">first use flag</a>, such as <a id="wrglossary.2297"></a><a href="#glo:glstext"><code class="csfmt">\glstext</code></a>. (You can, instead, redefine
+<a id="wrglossary.2298"></a><a href="#glo:glslinkpostsetkeys"><code class="csfmt">\glslinkpostsetkeys</code></a>, which is used by both the <a id="wrglossary.2299"></a><a href="#glo:glslike"><code class="csfmt">\gls</code>-like</a> and
+<a id="wrglossary.2300"></a><a href="#glo:glstextlike"><code class="csfmt">\glstext</code>-like</a> commands.)
<p>
-<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 -->
+<div class="information"><div class="informationtitle"><a id="wrglossary.2301"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a></div><!-- end of informationtitle -->
-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.
+The <a id="wrglossary.2302"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package provides a method of disabling
+the <a id="wrglossary.2303"></a><a href="#glo:dual.firstuse">first use</a> <a id="wrglossary.2304"></a><a href="#glo:idx.hyperlink">hyperlink</a> according to the <a id="wrglossary.2305"></a><a href="#glo:idx.glossaryentry">entry’s</a> associated
+<a id="wrglossary.2306"></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.2307"></a><a href="#glo:dual.firstuse">first use</a>
+hyperlink for <a id="wrglossary.2308"></a><a href="#glo:idx.abbreviation"><span class="xtrfmt">abbreviations</span></a> then you simply need to set
+the <a id="wrglossary.2309"></a><a href="#glo:opt.catattr.nohyperfirst"><span class="csoptfmt">nohyperfirst</span></a> <a id="wrglossary.2310"></a><a href="#glo:idx.categoryattribute">attribute</a> for the <a id="wrglossary.2311"></a><a href="#glo:opt.cat.abbreviation"><span class="catfmt">abbreviation</span></a>
+and, if appropriate, <a id="wrglossary.2312"></a><a href="#glo:opt.cat.acronym"><span class="catfmt">acronym</span></a> categories. (Instead of using the
+<a id="wrglossary.2313"></a><a href="#glo:opt.hyperfirst"><span class="styoptfmt">hyperfirst</span></a> package option.) See the
+<a id="wrglossary.2314"></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.2324"></a><code class="code"><dfn id="glo:opt.writeglslabels"><span class="styoptfmt">writeglslabels</span></dfn></code></div><!-- end of settingsbox -->
+<a id="wrglossary.2315"></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.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.
+<code class="code"><a id="wrglossary.2316"></a><a href="#glo:jobname"><code class="csfmt">\jobname</code></a>.<a id="wrglossary.2317"></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.2327"></a><a href="#glo:dual.ignoredglossary">ignored glossaries</a>). It’s provided for
+(including those in any <a id="wrglossary.2318"></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.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.)
+<a id="wrglossary.2319"></a><a href="#glo:idx.auto-completion">auto-completion</a>. If you also want the name, use
+<a id="wrglossary.2320"></a><a href="#glo:opt.writeglslabelnames"><span class="styoptfmt">writeglslabelnames</span></a>. (See also <a id="wrglossary.2321"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span>’s</a>
+<a id="wrglossary.2322"></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.2332"></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.2323"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a></div><!-- end of informationtitle -->
-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.
+Note that with <a id="wrglossary.2324"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> the file will only contain the entries
+that <a id="wrglossary.2325"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> has selected from the <a id="wrglossary.2326"></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.2336"></a><code class="code"><dfn id="glo:opt.writeglslabelnames"><span class="styoptfmt">writeglslabelnames</span></dfn></code></div><!-- end of settingsbox -->
+<a id="wrglossary.2327"></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.2337"></a><a href="#glo:opt.writeglslabels"><span class="styoptfmt">writeglslabels</span></a> but writes both
+Similar to <a id="wrglossary.2328"></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.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 -->
+<a id="wrglossary.2329"></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.2339"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>, the value for this
+Only available with <a id="wrglossary.2330"></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.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 -->
+<a id="wrglossary.2331"></a><a id="wrglossary.2332"></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.2342"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package).
+the base <a id="wrglossary.2333"></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.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 -->
+<a id="wrglossary.2334"></a><a id="wrglossary.2335"></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.2345"></a><a href="#glo:idx.opt.b2g">Option 4</a>).
+activated with <a id="wrglossary.2336"></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.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 -->
+<a id="wrglossary.2337"></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.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
+Only available with <a id="wrglossary.2338"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>, this
+option governs the use of <a id="wrglossary.2339"></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.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 -->
+<a id="wrglossary.2340"></a><a id="wrglossary.2341"></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.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).
+This setting means that <a id="wrglossary.2342"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a> is not permitted in
+the <a id="wrglossary.2343"></a><a href="#glo:env.document"><span class="envfmt">document</span></a> environment (default with <a id="wrglossary.2344"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>
+and for <a id="wrglossary.2345"></a><a href="#glo:idx.opt.noidx">Option 1</a> with just the base <a id="wrglossary.2346"></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.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 -->
+<a id="wrglossary.2347"></a><a id="wrglossary.2348"></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.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
+This setting means that <a id="wrglossary.2349"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a> is only permitted in
+the <a id="wrglossary.2350"></a><a href="#glo:env.document"><span class="envfmt">document</span></a> environment if it occurs before
+<a id="wrglossary.2351"></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.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 -->
+<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.atom"><span class="xtroptfmt">atom</span></dfn></code></div><!-- end of optionvaluebox -->
-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>).
+This setting is as <a id="wrglossary.2354"></a><a href="#glo:opt.docdef"><span class="xtrstyoptfmt">docdef</span></a><span class="optfmt">=</span><a id="wrglossary.2355"></a><a href="#glo:optval.docdef.restricted"><span class="xtroptfmt">restricted</span></a> but creates the
+<a id="wrglossary.2356"></a><a href="#glo:ext.glsdefs"><span class="extfmt">glsdefs</span></a> file for use by <a id="wrglossary.2357"></a><a href="#glo:app.atom"><span class="appfmt">atom</span></a> (without the
+limitations of <a id="wrglossary.2358"></a><a href="#glo:opt.docdef"><span class="xtrstyoptfmt">docdef</span></a><span class="optfmt">=</span><a id="wrglossary.2359"></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.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 -->
+<a id="wrglossary.2360"></a><a id="wrglossary.2361"></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.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.
+This setting means that <a id="wrglossary.2362"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a> is permitted in the
+<a id="wrglossary.2363"></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.2364"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package. This will create the
+<a id="wrglossary.2365"></a><a href="#glo:ext.glsdefs"><span class="extfmt">glsdefs</span></a> file if <a id="wrglossary.2366"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a> is found in the
+<a id="wrglossary.2367"></a><a href="#glo:env.document"><span class="envfmt">document</span></a> environment.
<p>
</section><!-- end of section sec:pkgopts-general -->
@@ -9822,174 +9821,184 @@
<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.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 -->
+<a id="wrglossary.2368"></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.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).
+Adds the <a id="wrglossary.2369"></a><a href="#glo:dual.glossary">glossaries</a> to the <a id="wrglossary.2370"></a><a href="#glo:idx.tableofcontents">table of contents</a> (<a id="wrglossary.2371"></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.2381"></a><code class="code"><dfn id="glo:glstoctrue"><code class="csfmt">\glstoctrue</code></dfn></code></div><!-- end of pinnedbox -->
+<a id="wrglossary.2372"></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.2382"></a><code class="code"><dfn id="glo:glstocfalse"><code class="csfmt">\glstocfalse</code></dfn></code></div><!-- end of pinnedbox -->
+<a id="wrglossary.2373"></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.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 -->
+<a id="wrglossary.2374"></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.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>.
+The default value is <a id="wrglossary.2375"></a><a href="#glo:opt.toc"><span class="styoptfmt">toc</span></a><span class="optfmt">=false</span> for the base
+<a id="wrglossary.2376"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package and <a id="wrglossary.2377"></a><a href="#glo:opt.toc"><span class="styoptfmt">toc</span></a><span class="optfmt">=true</span> for
+<a id="wrglossary.2378"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>.
+This option has no effect if <a id="wrglossary.2379"></a><a href="#glo:opt.numberedsection"><span class="styoptfmt">numberedsection</span></a> has been used to switch to
+a numbered (unstarred) sectioning command.
<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 simply governs whether or not <a id="wrglossary.2380"></a><a href="#glo:glossarysection"><code class="csfmt">\glossarysection</code></a>
+should use <a id="wrglossary.2381"></a><a href="#glo:addcontentsline"><code class="csfmt">\addcontentsline</code></a> after the applicable starred section
+command. The document class you are using may have its own behaviour
+for starred sections, such as adding the title to the PDF bookmarks.
+</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.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 -->
+<a id="wrglossary.2382"></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.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>
+When used with <a id="wrglossary.2383"></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.2384"></a><a href="#glo:numberline"><code class="csfmt">\numberline</code></a>{}</code> in the final argument of
+<a id="wrglossary.2385"></a><a href="#glo:addcontentsline"><code class="csfmt">\addcontentsline</code></a>. This will align the <a id="wrglossary.2386"></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.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
+effect with <a id="wrglossary.2387"></a><a href="#glo:opt.toc"><span class="styoptfmt">toc</span></a><span class="optfmt">=false</span>. If <a id="wrglossary.2388"></a><a href="#glo:opt.toc"><span class="styoptfmt">toc</span></a><span class="optfmt">=true</span> is used
+without <a id="wrglossary.2389"></a><a href="#glo:opt.numberline"><span class="styoptfmt">numberline</span></a>, the <a id="wrglossary.2390"></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.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 -->
+<a id="wrglossary.2391"></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.2398"></a><a href="#glo:dual.glossary">glossary</a>.
+This option indicates the sectional unit to use for the <a id="wrglossary.2392"></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.2399"></a><a href="#glo:chapter"><code class="csfmt">\chapter</code></a> or <code class="code">chapter*</code>).
+not <a id="wrglossary.2393"></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.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.
+<a id="wrglossary.2394"></a><a href="#glo:chapter"><code class="csfmt">\chapter</code></a>, if that command exists, or <a id="wrglossary.2395"></a><a href="#glo:section"><code class="csfmt">\section</code></a> otherwise. The
+starred or unstarred form is determined by the <a id="wrglossary.2396"></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.2403"></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.2397"></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.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}
+You can omit the value if you want to use <a id="wrglossary.2398"></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.2399"></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.2406"></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.2400"></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.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 -->
+<a id="wrglossary.2401"></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.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>).
+The start of each <a id="wrglossary.2402"></a><a href="#glo:dual.glossary">glossary</a> adds information to the page header via
+<a id="wrglossary.2403"></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.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 -->
+<a id="wrglossary.2404"></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.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
+If <a id="wrglossary.2405"></a><a href="#glo:opt.ucmark"><span class="styoptfmt">ucmark</span></a><span class="optfmt">=true</span>, this will make <a id="wrglossary.2406"></a><a href="#glo:glsglossarymark"><code class="csfmt">\glsglossarymark</code></a> use
+<a id="wrglossary.2407"></a><a href="#glo:idx.allcaps">all caps</a> in the header, otherwise no <a id="wrglossary.2408"></a><a href="#glo:dual.casechange">case change</a> will be
applied.
The default is
-<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>.
+<a id="wrglossary.2409"></a><a href="#glo:opt.ucmark"><span class="styoptfmt">ucmark</span></a><span class="optfmt">=false</span>, unless <a id="wrglossary.2410"></a><a href="#glo:cls.memoir"><span class="clsfmt">memoir</span></a> has been loaded, in
+which case the default is <a id="wrglossary.2411"></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.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 -->
+<a id="wrglossary.2412"></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.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>
+<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.2413"></a><a href="#glo:glsglossarymark"><code class="csfmt">\glsglossarymark</code></a>}[1]{<span class="comment">% </span>
+ <a id="wrglossary.2414"></a><a href="#glo:ifglsucmark"><code class="csfmt">\ifglsucmark</code></a>
+ <a id="wrglossary.2415"></a><a href="#glo:markright"><code class="csfmt">\markright</code></a>{<a id="wrglossary.2416"></a><a href="#glo:glsuppercase"><code class="csfmt">\glsuppercase</code></a>{#1}}<span class="comment">% </span>
<code class="cmd">\else</code>
- <a id="wrglossary.2423"></a><a href="#glo:markright"><code class="csfmt">\markright</code></a>{#1}<span class="comment">% </span>
+ <a id="wrglossary.2417"></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.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 -->
+<a id="wrglossary.2418"></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.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
+The <a id="wrglossary.2419"></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.2420"></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.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 -->
+<a id="wrglossary.2421"></a><a id="wrglossary.2422"></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.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>).
+of sectioning command (for example, <a id="wrglossary.2423"></a><a href="#glo:chapter"><code class="csfmt">\chapter*</code></a> or
+<a id="wrglossary.2424"></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.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 -->
+<a id="wrglossary.2425"></a><a id="wrglossary.2426"></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.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
+command (for example, <a id="wrglossary.2427"></a><a href="#glo:chapter"><code class="csfmt">\chapter</code></a> or <a id="wrglossary.2428"></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.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 -->
+<a id="wrglossary.2429"></a><a id="wrglossary.2430"></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.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>
+labelling. Each <a id="wrglossary.2431"></a><a href="#glo:dual.glossary">glossary</a> uses the unstarred form of a 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>) and is assigned a label
+(via <a id="wrglossary.2434"></a><a href="#glo:label"><code class="csfmt">\label</code></a>). The label is formed from the <a id="wrglossary.2435"></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.2442"></a><code class="code"><dfn id="glo:glsautoprefix"><code class="csfmt">\glsautoprefix</code></dfn></code></div><!-- end of pinnedbox -->
+<a id="wrglossary.2436"></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.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>]
+The default value of <a id="wrglossary.2437"></a><a href="#glo:glsautoprefix"><code class="csfmt">\glsautoprefix</code></a> is empty. For example,
+if you load <a id="wrglossary.2438"></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.2439"></a><a href="#glo:opt.section"><span class="styoptfmt">section</span></a>,<a id="wrglossary.2440"></a><a href="#glo:opt.numberedsection"><span class="styoptfmt">numberedsection</span></a><span class="optfmt">=autolabel</span>]
{glossaries}
</pre>
-then each <a id="wrglossary.2447"></a><a href="#glo:dual.glossary">glossary</a> will appear in a numbered section, and can
+then each <a id="wrglossary.2441"></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.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 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.2442"></a><a href="#glo:idx.nbsp"><code class="code">~</code></a><a id="wrglossary.2443"></a><a href="#glo:ref"><code class="csfmt">\ref</code></a>{main} and
+the list of acronyms is in section<a id="wrglossary.2444"></a><a href="#glo:idx.nbsp"><code class="code">~</code></a><a id="wrglossary.2445"></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.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>}.
+<a id="wrglossary.2446"></a><a href="#glo:acronymtype"><code class="csfmt">\acronymtype</code></a> which is set to <a id="wrglossary.2447"></a><a href="#glo:opt.glostype.main"><code class="glostypefmt">main</code></a> if the
+<a id="wrglossary.2448"></a><a href="#glo:opt.acronym"><span class="styoptfmt">acronym</span></a> option is not used and is set to <a id="wrglossary.2449"></a><a href="#glo:opt.glostype.acronym"><code class="glostypefmt">acronym</code></a>
+if the <a id="wrglossary.2450"></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.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>{<a id="wrglossary.2453"></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.2460"></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.2454"></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.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>}.
+section<a id="wrglossary.2455"></a><a href="#glo:idx.nbsp"><code class="code">~</code></a><a id="wrglossary.2456"></a><a href="#glo:ref"><code class="csfmt">\ref</code></a>{glo:<a id="wrglossary.2457"></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.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>}.
+section<a id="wrglossary.2458"></a><a href="#glo:idx.nbsp"><code class="code">~</code></a><a id="wrglossary.2459"></a><a href="#glo:ref"><code class="csfmt">\ref</code></a>{<a id="wrglossary.2460"></a><a href="#glo:glsautoprefix"><code class="csfmt">\glsautoprefix</code></a><a id="wrglossary.2461"></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.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 -->
+<a id="wrglossary.2462"></a><a id="wrglossary.2463"></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.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:
+<a id="wrglossary.2464"></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.2465"></a><a href="#glo:chapter"><code class="csfmt">\chapter*</code></a> or <a id="wrglossary.2466"></a><a href="#glo:section"><code class="csfmt">\section*</code></a>). It’s
+designed for use with the <a id="wrglossary.2467"></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.2474"></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.2468"></a><a href="#glo:opt.numberedsection"><span class="styoptfmt">numberedsection</span></a><span class="optfmt">=nameref</span>]{glossaries}
</pre>
-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>:
+Alternatively, since <a id="wrglossary.2469"></a><a href="#glo:pkg.nameref"><span class="styfmt">nameref</span></a> is automatically loaded by
+<a id="wrglossary.2470"></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.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.2471"></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.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.
+Now <code class="code"><a id="wrglossary.2472"></a><a href="#glo:nameref"><code class="csfmt">\nameref</code></a>{main}</code> will display the
+(<a id="wrglossary.2473"></a><a href="#glo:idx.tableofcontents">table of contents</a>) section title
+associated with the <a id="wrglossary.2474"></a><a href="#glo:opt.glostype.main"><code class="glostypefmt">main</code></a> glossary. As above, you can
+redefine <a id="wrglossary.2475"></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 -->
@@ -9999,178 +10008,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.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>
+<a id="wrglossary.2476"></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.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
+store the <a id="wrglossary.2477"></a><a href="#glo:locationlist">number list</a> for each entry. The default is
+<a id="wrglossary.2478"></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.2479"></a><a href="#glo:glsentrynumberlist"><code class="csfmt">\glsentrynumberlist</code></a> and <a id="wrglossary.2480"></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.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.
+<a id="wrglossary.2481"></a><a href="#glo:idx.opt.noidx">Option 1</a> as a by-product of the way that <a id="wrglossary.2482"></a><a href="#glo:dual.indexing">indexing</a> method works.
<p>
-<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 -->
+<div class="information"><div class="informationtitle"><a id="wrglossary.2483"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a></div><!-- end of informationtitle -->
-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.
+If you use the <a id="wrglossary.2484"></a><a href="#glo:opt.record"><span class="xtrstyoptfmt">record</span></a> option (with either no value or
+<a id="wrglossary.2485"></a><a href="#glo:opt.record"><span class="xtrstyoptfmt">record</span></a><span class="optfmt">=only</span> or <a id="wrglossary.2486"></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.2487"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>, the
+<a id="wrglossary.2488"></a><a href="#glo:locationlist">number lists</a> are automatically saved with the default
+<a id="wrglossary.2489"></a><a href="#glo:opt.resource.save-locations"><span class="xtrcsoptfmt">save-locations</span></a><span class="optfmt">=true</span> and
+<a id="wrglossary.2490"></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.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 -->
+<a id="wrglossary.2491"></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.2498"></a><code class="code"><dfn id="glo:ctr.glossaryentry"><span class="ctrfmt">glossaryentry</span></dfn></code></div><!-- end of ctrbox -->
+<a id="wrglossary.2492"></a><code class="code"><dfn id="glo:ctr.glossaryentry"><span class="ctrfmt">glossaryentry</span></dfn></code></div><!-- end of ctrbox -->
-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>
+Each <a id="wrglossary.2493"></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.2494"></a><a href="#glo:dual.entryline">entry line</a> when using
+<a id="wrglossary.2495"></a><a href="#glo:idx.glossarystyle">glossary styles</a> that support this setting.
+Note that if you also use <a id="wrglossary.2496"></a><a href="#glo:opt.subentrycounter"><span class="styoptfmt">subentrycounter</span></a> the option order
+makes a difference. If <a id="wrglossary.2497"></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.2498"></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.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
+If you use this option (and are using a <a id="wrglossary.2499"></a><a href="#glo:idx.glossarystyle">glossary style</a> that
+supports this option) then you can reference the <a id="wrglossary.2500"></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.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 -->
+<a id="wrglossary.2501"></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.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
+This will use <a id="wrglossary.2502"></a><a href="#glo:ref"><code class="csfmt">\ref</code></a> if either <a id="wrglossary.2503"></a><a href="#glo:opt.entrycounter"><span class="styoptfmt">entrycounter</span></a><span class="optfmt">=true</span> or
+<a id="wrglossary.2504"></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.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 -->
+<a id="wrglossary.2505"></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.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
+If both <a id="wrglossary.2506"></a><a href="#glo:opt.entrycounter"><span class="styoptfmt">entrycounter</span></a><span class="optfmt">=false</span> and
+<a id="wrglossary.2507"></a><a href="#glo:opt.subentrycounter"><span class="styoptfmt">subentrycounter</span></a><span class="optfmt">=false</span>, <code class="code"><a id="wrglossary.2508"></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.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
+If you use <a id="wrglossary.2509"></a><a href="#glo:glsrefentry"><code class="csfmt">\glsrefentry</code></a>, you must run LaTeX twice after
+creating the <a id="wrglossary.2510"></a><a href="#glo:dual.indexingfile">indexing files</a> using <a id="wrglossary.2511"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a>,
+<a id="wrglossary.2512"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> or <a id="wrglossary.2513"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> (or after creating the <a id="wrglossary.2514"></a><a href="#glo:ext.glstex"><span class="extfmt">glstex</span></a>
+file with <a id="wrglossary.2515"></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.2522"></a><a href="#glo:dual.glossary">glossary</a> is typeset.
+labelled until the <a id="wrglossary.2516"></a><a href="#glo:dual.glossary">glossary</a> is typeset.
</div><!-- end of important -->
<p>
-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:
+The <a id="wrglossary.2517"></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.2524"></a><code class="code"><dfn id="glo:glsresetentrycounter"><code class="csfmt">\glsresetentrycounter</code></dfn></code></div><!-- end of pinnedbox -->
+<a id="wrglossary.2518"></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.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:
+This does nothing if <a id="wrglossary.2519"></a><a href="#glo:opt.entrycounter"><span class="styoptfmt">entrycounter</span></a><span class="optfmt">=false</span>.
+The <a id="wrglossary.2520"></a><a href="#glo:ctr.glossaryentry"><span class="ctrfmt">glossaryentry</span></a> counter can be simultaneously incremented and labelled (using
+<a id="wrglossary.2521"></a><a href="#glo:refstepcounter"><code class="csfmt">\refstepcounter</code></a> and <a id="wrglossary.2522"></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.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 -->
+<a id="wrglossary.2523"></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.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.
+This command is within the definition of <a id="wrglossary.2524"></a><a href="#glo:glsentryitem"><code class="csfmt">\glsentryitem</code></a>, which is
+typically used in <a id="wrglossary.2525"></a><a href="#glo:idx.glossarystyle">glossary styles</a> at the start of
+<a id="wrglossary.2526"></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.2533"></a><a href="#glo:ctr.glossaryentry"><span class="ctrfmt">glossaryentry</span></a> counter can be displayed with:
+The value of the <a id="wrglossary.2527"></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.2534"></a><code class="code"><dfn id="glo:theglossaryentry"><code class="csfmt">\theglossaryentry</code></dfn></code>
+<a id="wrglossary.2528"></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.2535"></a><a href="#glo:ctr.glossaryentry"><span class="ctrfmt">glossaryentry</span></a> counter is
+This command is defined when the <a id="wrglossary.2529"></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.2536"></a><code class="code"><dfn id="glo:glsentrycounterlabel"><code class="csfmt">\glsentrycounterlabel</code></dfn></code></div><!-- end of pinnedbox -->
+<a id="wrglossary.2530"></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.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
+This will do <code class="code"><a id="wrglossary.2531"></a><a href="#glo:theglossaryentry"><code class="csfmt">\theglossaryentry</code></a>.<a id="wrglossary.2532"></a><a href="#glo:space"><code class="csfmt">\space</code></a></code> if
+<a id="wrglossary.2533"></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.2534"></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.2541"></a><a href="#glo:glsentryitem"><code class="csfmt">\glsentryitem</code></a>.
+within the definition of <a id="wrglossary.2535"></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.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 -->
+<a id="wrglossary.2536"></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.2543"></a><code class="code"><dfn id="glo:glsentrycounterfalse"><code class="csfmt">\glsentrycounterfalse</code></dfn></code></div><!-- end of pinnedbox -->
+<a id="wrglossary.2537"></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.2544"></a><code class="code"><dfn id="glo:glsentrycountertrue"><code class="csfmt">\glsentrycountertrue</code></dfn></code></div><!-- end of pinnedbox -->
+<a id="wrglossary.2538"></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.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.
+but note that this won’t define <a id="wrglossary.2539"></a><a href="#glo:ctr.glossaryentry"><span class="ctrfmt">glossaryentry</span></a> if
+<a id="wrglossary.2540"></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.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>.
+<a id="wrglossary.2541"></a><a href="#glo:dual.glossary">glossary</a> using the <a id="wrglossary.2542"></a><a href="#glo:opt.printgloss.entrycounter"><span class="csoptfmt">entrycounter</span></a>
+<a id="wrglossary.2543"></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.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 -->
+<a id="wrglossary.2544"></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.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
+If used, this option will automatically set <a id="wrglossary.2545"></a><a href="#glo:opt.entrycounter"><span class="styoptfmt">entrycounter</span></a>true and the
+<a id="wrglossary.2546"></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.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>
+<a id="wrglossary.2547"></a><a href="#glo:ctr.glossaryentry"><span class="ctrfmt">glossaryentry</span></a> has no parent counter (but <a id="wrglossary.2548"></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.2555"></a><a href="#glo:ctr.glossaryentry"><span class="ctrfmt">glossaryentry</span></a> counter isn’t automatically reset at the
+The <a id="wrglossary.2549"></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.2556"></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.2550"></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.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>
+If you want the counter reset at the start of each <a id="wrglossary.2551"></a><a href="#glo:dual.glossary">glossary</a>, you can
+modify the <a id="wrglossary.2552"></a><a href="#glo:idx.preamble/glossary">glossary preamble</a> (<a id="wrglossary.2553"></a><a href="#glo:glossarypreamble"><code class="csfmt">\glossarypreamble</code></a>) to use
+<a id="wrglossary.2554"></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.2555"></a><a href="#glo:glossarypreamble"><code class="csfmt">\glossarypreamble</code></a>}{<span class="comment">% </span>
+ <a id="wrglossary.2556"></a><a href="#glo:glsresetentrycounter"><code class="csfmt">\glsresetentrycounter</code></a>
}
</pre>
-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>
+or if you are using <a id="wrglossary.2557"></a><a href="#glo:setglossarypreamble"><code class="csfmt">\setglossarypreamble</code></a>, add it to each
+<a id="wrglossary.2558"></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.2559"></a><a href="#glo:setglossarypreamble"><code class="csfmt">\setglossarypreamble</code></a>[<a id="wrglossary.2560"></a><a href="#glo:opt.glostype.acronym"><code class="glostypefmt">acronym</code></a>]{<span class="comment">% </span>
+ <a id="wrglossary.2561"></a><a href="#glo:glsresetentrycounter"><code class="csfmt">\glsresetentrycounter</code></a>
The preamble text here for the list of acronyms.
}
-<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.
+<a id="wrglossary.2562"></a><a href="#glo:setglossarypreamble"><code class="csfmt">\setglossarypreamble</code></a>{<span class="comment">% </span>
+ <a id="wrglossary.2563"></a><a href="#glo:glsresetentrycounter"><code class="csfmt">\glsresetentrycounter</code></a>
+ The preamble text here for the <a id="wrglossary.2564"></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.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 -->
+<a id="wrglossary.2565"></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.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>
+If set, each <a id="wrglossary.2566"></a><a href="#glo:hierarchicallevel">level 1</a> glossary <a id="wrglossary.2567"></a><a href="#glo:idx.glossaryentry">entry</a> will be numbered at the
+start of its <a id="wrglossary.2568"></a><a href="#glo:dual.entryline">entry line</a> when using <a id="wrglossary.2569"></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.2576"></a><code class="code"><dfn id="glo:ctr.glossarysubentry"><span class="ctrfmt">glossarysubentry</span></dfn></code></div><!-- end of ctrbox -->
+<a id="wrglossary.2570"></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.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
+If the <a id="wrglossary.2571"></a><a href="#glo:opt.entrycounter"><span class="styoptfmt">entrycounter</span></a> option is used before
+<a id="wrglossary.2572"></a><a href="#glo:opt.subentrycounter"><span class="styoptfmt">subentrycounter</span></a>, then <a id="wrglossary.2573"></a><a href="#glo:ctr.glossarysubentry"><span class="ctrfmt">glossarysubentry</span></a> will be added to
+the reset list for <a id="wrglossary.2574"></a><a href="#glo:ctr.glossaryentry"><span class="ctrfmt">glossaryentry</span></a>. If <a id="wrglossary.2575"></a><a href="#glo:opt.subentrycounter"><span class="styoptfmt">subentrycounter</span></a> is
+used without <a id="wrglossary.2576"></a><a href="#glo:opt.entrycounter"><span class="styoptfmt">entrycounter</span></a> then the <a id="wrglossary.2577"></a><a href="#glo:ctr.glossarysubentry"><span class="ctrfmt">glossarysubentry</span></a>
+counter will be reset by <a id="wrglossary.2578"></a><a href="#glo:glsentryitem"><code class="csfmt">\glsentryitem</code></a>. If
+<a id="wrglossary.2579"></a><a href="#glo:opt.subentrycounter"><span class="styoptfmt">subentrycounter</span></a> is used before <a id="wrglossary.2580"></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.2587"></a><a href="#glo:dual.hierarchicallevel">hierarchical levels</a>. Some
+There’s no support for deeper <a id="wrglossary.2581"></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.
@@ -10177,290 +10186,290 @@
</div><!-- end of information -->
<p>
-As with the <a id="wrglossary.2588"></a><a href="#glo:opt.entrycounter"><span class="styoptfmt">entrycounter</span></a> option, you can
+As with the <a id="wrglossary.2582"></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.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>.
+<a id="wrglossary.2583"></a><a href="#glo:glsrefentry"><code class="csfmt">\glsrefentry</code></a>. There are analogous commands to those for
+<a id="wrglossary.2584"></a><a href="#glo:opt.entrycounter"><span class="styoptfmt">entrycounter</span></a>.
<p>
-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:
+The <a id="wrglossary.2585"></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.2592"></a><code class="code"><dfn id="glo:glsresetsubentrycounter"><code class="csfmt">\glsresetsubentrycounter</code></dfn></code></div><!-- end of pinnedbox -->
+<a id="wrglossary.2586"></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.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>.
+This does nothing if <a id="wrglossary.2587"></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.2588"></a><a href="#glo:glsentryitem"><code class="csfmt">\glsentryitem</code></a> if
+<a id="wrglossary.2589"></a><a href="#glo:opt.entrycounter"><span class="styoptfmt">entrycounter</span></a><span class="optfmt">=false</span>.
<p>
-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:
+The <a id="wrglossary.2590"></a><a href="#glo:ctr.glossarysubentry"><span class="ctrfmt">glossarysubentry</span></a> counter can be simultaneously incremented and labelled (using
+<a id="wrglossary.2591"></a><a href="#glo:refstepcounter"><code class="csfmt">\refstepcounter</code></a> and <a id="wrglossary.2592"></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.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 -->
+<a id="wrglossary.2593"></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.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>.
+This command is used in <a id="wrglossary.2594"></a><a href="#glo:glssubentryitem"><code class="csfmt">\glssubentryitem</code></a> if
+<a id="wrglossary.2595"></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.2596"></a><a href="#glo:label"><code class="csfmt">\label</code></a> is as for
+<a id="wrglossary.2597"></a><a href="#glo:glsrefentry"><code class="csfmt">\glsrefentry</code></a>.
<p>
-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:
+The value of the <a id="wrglossary.2598"></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.2605"></a><code class="code"><dfn id="glo:theglossarysubentry"><code class="csfmt">\theglossarysubentry</code></dfn></code>
+<a id="wrglossary.2599"></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.2606"></a><a href="#glo:ctr.glossarysubentry"><span class="ctrfmt">glossarysubentry</span></a> counter is
+This command is defined when the <a id="wrglossary.2600"></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.2607"></a><code class="code"><dfn id="glo:glssubentrycounterlabel"><code class="csfmt">\glssubentrycounterlabel</code></dfn></code></div><!-- end of pinnedbox -->
+<a id="wrglossary.2601"></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.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
+This will do <code class="code"><a id="wrglossary.2602"></a><a href="#glo:theglossarysubentry"><code class="csfmt">\theglossarysubentry</code></a>)<a id="wrglossary.2603"></a><a href="#glo:space"><code class="csfmt">\space</code></a></code> if
+<a id="wrglossary.2604"></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.2605"></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.2612"></a><a href="#glo:glssubentryitem"><code class="csfmt">\glssubentryitem</code></a>.
+<a id="wrglossary.2606"></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.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 -->
+<a id="wrglossary.2607"></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.2614"></a><code class="code"><dfn id="glo:glssubentrycounterfalse"><code class="csfmt">\glssubentrycounterfalse</code></dfn></code></div><!-- end of pinnedbox -->
+<a id="wrglossary.2608"></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.2615"></a><code class="code"><dfn id="glo:glssubentrycountertrue"><code class="csfmt">\glssubentrycountertrue</code></dfn></code></div><!-- end of pinnedbox -->
+<a id="wrglossary.2609"></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.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.
+but note that this won’t define <a id="wrglossary.2610"></a><a href="#glo:ctr.glossarysubentry"><span class="ctrfmt">glossarysubentry</span></a> if
+<a id="wrglossary.2611"></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.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>.
+<a id="wrglossary.2612"></a><a href="#glo:dual.glossary">glossary</a> using the <a id="wrglossary.2613"></a><a href="#glo:opt.printgloss.subentrycounter"><span class="csoptfmt">subentrycounter</span></a>
+<a id="wrglossary.2614"></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.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 -->
+<a id="wrglossary.2615"></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.2622"></a><a href="#glo:idx.glossarystyle">glossary style</a> to
+This option sets the default <a id="wrglossary.2616"></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.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>
+<a id="wrglossary.2617"></a><a href="#glo:opt.style"><span class="styoptfmt">style</span></a><span class="optfmt">=<a id="wrglossary.2618"></a><a href="#glo:opt.glostyle.list"><span class="glostylefmt">list</span></a></span> unless <a id="wrglossary.2619"></a><a href="#glo:pkg.classicthesis"><span class="styfmt">classicthesis</span></a>
has been loaded, in which case the default is
-<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>.)
+<a id="wrglossary.2620"></a><a href="#glo:opt.style"><span class="styoptfmt">style</span></a><span class="optfmt">=<a id="wrglossary.2621"></a><a href="#glo:opt.glostyle.index"><span class="glostylefmt">index</span></a></span>. (The styles that use the
+<a id="wrglossary.2622"></a><a href="#glo:env.description"><span class="envfmt">description</span></a> environment, such as the <a id="wrglossary.2623"></a><a href="#glo:opt.glostyle.list"><span class="glostylefmt">list</span></a> style, are incompatible
+with <a id="wrglossary.2624"></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.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>.
+<a id="wrglossary.2625"></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.2626"></a><a href="#glo:pkg.glossary-list"><span class="styfmt">glossary-list</span></a>, <a id="wrglossary.2627"></a><a href="#glo:pkg.glossary-long"><span class="styfmt">glossary-long</span></a>,
+<a id="wrglossary.2628"></a><a href="#glo:pkg.glossary-super"><span class="styfmt">glossary-super</span></a> or <a id="wrglossary.2629"></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.2630"></a><a href="#glo:opt.nostyles"><span class="styoptfmt">nostyles</span></a>. Style packages
+can also be loaded by the <a id="wrglossary.2631"></a><a href="#glo:opt.stylemods"><span class="xtrstyoptfmt">stylemods</span></a> option provided by
+<a id="wrglossary.2632"></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.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 -->
+<a id="wrglossary.2633"></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.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>.
+or use the <a id="wrglossary.2634"></a><a href="#glo:opt.printgloss.style"><span class="csoptfmt">style</span></a> <a id="wrglossary.2635"></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.2642"></a><code class="code"><dfn id="glo:opt.nolong"><span class="styoptfmt">nolong</span></dfn></code></div><!-- end of settingsbox -->
+<a id="wrglossary.2636"></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.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
+This prevents the <a id="wrglossary.2637"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package
+from automatically loading <a id="wrglossary.2638"></a><a href="#glo:pkg.glossary-long"><span class="styfmt">glossary-long</span></a> (which means that
+the <a id="wrglossary.2639"></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.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>).
+<a id="wrglossary.2640"></a><a href="#glo:idx.glossarystyle">glossary styles</a> defined in the <a id="wrglossary.2641"></a><a href="#glo:pkg.glossary-long"><span class="styfmt">glossary-long</span></a> package (unless
+you explicitly load <a id="wrglossary.2642"></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.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>.
+Some style packages implicitly load <a id="wrglossary.2643"></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.2644"></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.2651"></a><code class="code"><dfn id="glo:opt.nosuper"><span class="styoptfmt">nosuper</span></dfn></code></div><!-- end of settingsbox -->
+<a id="wrglossary.2645"></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.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
+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-super"><span class="styfmt">glossary-super</span></a> (which means that
+the <a id="wrglossary.2648"></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.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>).
+<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-super"><span class="styfmt">glossary-super</span></a> package
+(unless you explicitly load <a id="wrglossary.2651"></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.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.
+This option is automatically implemented if <a id="wrglossary.2652"></a><a href="#glo:pkg.xtab"><span class="styfmt">xtab</span></a> has been
+loaded as it’s incompatible with <a id="wrglossary.2653"></a><a href="#glo:pkg.supertabular"><span class="styfmt">supertabular</span></a>. This option is
+also automatically implemented if <a id="wrglossary.2654"></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.2661"></a><code class="code"><dfn id="glo:opt.nolist"><span class="styoptfmt">nolist</span></dfn></code></div><!-- end of settingsbox -->
+<a id="wrglossary.2655"></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.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
+This prevents the <a id="wrglossary.2656"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package
+from automatically loading <a id="wrglossary.2657"></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.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
+<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-list"><span class="styfmt">glossary-list</span></a> package
+(unless you explicitly load <a id="wrglossary.2660"></a><a href="#glo:pkg.glossary-list"><span class="styfmt">glossary-list</span></a>).
+Note that since the default style is <a id="wrglossary.2661"></a><a href="#glo:opt.glostyle.list"><span class="glostylefmt">list</span></a> (unless
+<a id="wrglossary.2662"></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.2663"></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.2670"></a><code class="code"><dfn id="glo:opt.notree"><span class="styoptfmt">notree</span></dfn></code></div><!-- end of settingsbox -->
+<a id="wrglossary.2664"></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.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
+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-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.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>.
+<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-tree"><span class="styfmt">glossary-tree</span></a> package
+(unless you explicitly load <a id="wrglossary.2669"></a><a href="#glo:pkg.glossary-tree"><span class="styfmt">glossary-tree</span></a>). Note that if
+<a id="wrglossary.2670"></a><a href="#glo:pkg.classicthesis"><span class="styfmt">classicthesis</span></a> has been loaded, the default style is
+<a id="wrglossary.2671"></a><a href="#glo:opt.glostyle.index"><span class="glostylefmt">index</span></a>, which is provided by <a id="wrglossary.2672"></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.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>.
+Some style packages implicitly load <a id="wrglossary.2673"></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.2674"></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.2681"></a><code class="code"><dfn id="glo:opt.nostyles"><span class="styoptfmt">nostyles</span></dfn></code></div><!-- end of settingsbox -->
+<a id="wrglossary.2675"></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.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}
+<a id="wrglossary.2676"></a><a href="#glo:idx.glossarystyle">glossary style</a> package (such as <a id="wrglossary.2677"></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.2678"></a><a href="#glo:opt.style"><span class="styoptfmt">style</span></a> package option
+(unless you use <a id="wrglossary.2679"></a><a href="#glo:opt.stylemods"><span class="xtrstyoptfmt">stylemods</span></a> with <a id="wrglossary.2680"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>).
+Instead you must either use <a id="wrglossary.2681"></a><a href="#glo:setglossarystyle"><code class="csfmt">\setglossarystyle</code></a> or the
+<a id="wrglossary.2682"></a><a href="#glo:opt.printgloss.style"><span class="csoptfmt">style</span></a> <a id="wrglossary.2683"></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.2684"></a><a href="#glo:opt.nostyles"><span class="styoptfmt">nostyles</span></a>]{glossaries}
<code class="cmd">\usepackage</code>{glossary-mcols}
-<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>}
+<a id="wrglossary.2685"></a><a href="#glo:setglossarystyle"><code class="csfmt">\setglossarystyle</code></a>{<a id="wrglossary.2686"></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.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 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.2687"></a><a href="#glo:opt.nostyles"><span class="styoptfmt">nostyles</span></a>,<a id="wrglossary.2688"></a><a href="#glo:opt.stylemods"><span class="xtrstyoptfmt">stylemods</span></a><span class="optfmt">=mcols</span>,<a id="wrglossary.2689"></a><a href="#glo:opt.style"><span class="styoptfmt">style</span></a><span class="optfmt">=<a id="wrglossary.2690"></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.2697"></a><code class="code"><dfn id="glo:opt.nonumberlist"><span class="styoptfmt">nonumberlist</span></dfn></code></div><!-- end of settingsbox -->
+<a id="wrglossary.2691"></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.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 will suppress the associated <a id="wrglossary.2692"></a><a href="#glo:locationlist">number lists</a> in the
+<a id="wrglossary.2693"></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.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>.
+<a id="wrglossary.2694"></a><a href="#glo:dual.glossary">glossary</a> with the <a id="wrglossary.2695"></a><a href="#glo:opt.printgloss.nonumberlist"><span class="csoptfmt">nonumberlist</span></a>
+<a id="wrglossary.2696"></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.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
+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.2697"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> or <a id="wrglossary.2698"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>)
+then the <a id="wrglossary.2699"></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.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>.
+prevents the <a id="wrglossary.2700"></a><a href="#glo:locationlist">number list</a> from being displayed, but both
+<a id="wrglossary.2701"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> and <a id="wrglossary.2702"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> still require a <a id="wrglossary.2703"></a><a href="#glo:dual.entrylocation">location</a> or
+cross-reference for each term that’s <a id="wrglossary.2704"></a><a href="#glo:dual.indexing">indexed</a>.
</div><!-- end of warning -->
<p>
-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>).
+Remember that <a id="wrglossary.2705"></a><a href="#glo:locationlist">number list</a> includes any cross-references, so
+suppressing the <a id="wrglossary.2706"></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.2707"></a><a href="#glo:opt.seeautonumberlist"><span class="styoptfmt">seeautonumberlist</span></a>).
<p>
-<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 -->
+<div class="information"><div class="informationtitle"><a id="wrglossary.2708"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a></div><!-- end of informationtitle -->
-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.
+With <a id="wrglossary.2709"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>, it’s more efficient to use
+<a id="wrglossary.2710"></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.2711"></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.2718"></a><code class="code"><dfn id="glo:opt.seeautonumberlist"><span class="styoptfmt">seeautonumberlist</span></dfn></code></div><!-- end of settingsbox -->
+<a id="wrglossary.2712"></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.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
+<a id="wrglossary.2713"></a><a href="#glo:locationlist">number lists</a> with <a id="wrglossary.2714"></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.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 id="wrglossary.2715"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a> key in <a id="wrglossary.2716"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a> or <a id="wrglossary.2717"></a><a href="#glo:glssee"><code class="csfmt">\glssee</code></a>. If you
+use <a id="wrglossary.2718"></a><a href="#glo:opt.seeautonumberlist"><span class="styoptfmt">seeautonumberlist</span></a>, the <a id="wrglossary.2719"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a> key will
+automatically implement <a id="wrglossary.2720"></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.2721"></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.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 -->
+<a id="wrglossary.2722"></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.2729"></a><a href="#glo:locationlist">number lists</a> (see
+default counter to use in the <a id="wrglossary.2723"></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.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.
+specific <a id="wrglossary.2724"></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.2725"></a><a href="#glo:newglossary"><code class="csfmt">\newglossary</code></a> or the <a id="wrglossary.2726"></a><a href="#glo:opt.gloskey.counter"><span class="csoptfmt">counter</span></a> key when defining an
+entry or by the <a id="wrglossary.2727"></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.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 -->
+<a id="wrglossary.2728"></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.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 -->
+<a id="wrglossary.2729"></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.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>.
+<a id="wrglossary.2730"></a><a href="#glo:idx.fullstop">full stop</a> in <a id="wrglossary.2731"></a><a href="#glo:idx.glossarystyle">glossary styles</a> that use the
+post-description hook <a id="wrglossary.2732"></a><a href="#glo:glspostdescription"><code class="csfmt">\glspostdescription</code></a>.
<p>
-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>.
+The default setting is <a id="wrglossary.2733"></a><a href="#glo:opt.nopostdot"><span class="styoptfmt">nopostdot</span></a><span class="optfmt">=false</span> for the base
+<a id="wrglossary.2734"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package and <a id="wrglossary.2735"></a><a href="#glo:opt.nopostdot"><span class="styoptfmt">nopostdot</span></a><span class="optfmt">=true</span> for
+<a id="wrglossary.2736"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>.
<p>
-<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 -->
+<div class="information"><div class="informationtitle"><a id="wrglossary.2737"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a></div><!-- end of informationtitle -->
-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
+The <a id="wrglossary.2738"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package provides <a id="wrglossary.2739"></a><a href="#glo:opt.postdot"><span class="xtrstyoptfmt">postdot</span></a>, which
+is equivalent to <a id="wrglossary.2740"></a><a href="#glo:opt.nopostdot"><span class="styoptfmt">nopostdot</span></a><span class="optfmt">=false</span>, and also
+<a id="wrglossary.2741"></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.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 -->
+<a id="wrglossary.2742"></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.2749"></a><a href="#glo:idx.glossarystyle">glossary styles</a>.
+letter groups used by some of the predefined <a id="wrglossary.2743"></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.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>.
+<a id="wrglossary.2744"></a><a href="#glo:dual.glossary">glossary</a> with the <a id="wrglossary.2745"></a><a href="#glo:opt.printgloss.nogroupskip"><span class="csoptfmt">nogroupskip</span></a>
+<a id="wrglossary.2746"></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.2753"></a><a href="#glo:idx.glossarystyle">glossary styles</a> that use the
+This option is only relevant for <a id="wrglossary.2747"></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.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 -->
+<a id="wrglossary.2748"></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.2755"></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.2749"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a></div><!-- end of informationtitle -->
-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
+If you are using <a id="wrglossary.2750"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> without the <a id="wrglossary.2751"></a><a href="#glo:switch.group"><span class="longargfmt">--group</span></a> (or
+<a id="wrglossary.2752"></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.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 -->
+<a id="wrglossary.2753"></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.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,
+Loads the <a id="wrglossary.2754"></a><a href="#glo:pkg.glossaries-extra-stylemods"><span class="styfmt">glossaries-extra-stylemods</span></a> package, which patches the
+predefined <a id="wrglossary.2755"></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.2762"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> manual for further details.
+<a id="wrglossary.2756"></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 -->
@@ -10469,139 +10478,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.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 -->
+<a id="wrglossary.2757"></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.2758"></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.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
+(This option is only relevant with <a id="wrglossary.2759"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> and <a id="wrglossary.2760"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>.)
+The <a id="wrglossary.2761"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a> key automatically <a id="wrglossary.2762"></a><a href="#glo:dual.indexing">indexes</a> the
+cross-referenced entry using <a id="wrglossary.2763"></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.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>.
+<a id="wrglossary.2764"></a><a href="#glo:dual.indexingfile">indexing file</a> has been opened, the <a id="wrglossary.2765"></a><a href="#glo:dual.indexing">indexing</a> can’t be performed.
+Since this is easy to miss, the <a id="wrglossary.2766"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package by
+default issues an error message if the <a id="wrglossary.2767"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a> key is used
+before <a id="wrglossary.2768"></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.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 -->
+<a id="wrglossary.2769"></a><a id="wrglossary.2770"></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.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 -->
+<a id="wrglossary.2771"></a><a id="wrglossary.2772"></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.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 -->
+<a id="wrglossary.2773"></a><a id="wrglossary.2774"></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.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>.
+<a id="wrglossary.2775"></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.2776"></a><a href="#glo:dual.indexing">indexing</a>, you can use
+<a id="wrglossary.2777"></a><a href="#glo:opt.seenoindex"><span class="styoptfmt">seenoindex</span></a><span class="optfmt">=warn</span> or <a id="wrglossary.2778"></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.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 -->
+<a id="wrglossary.2779"></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.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>.
+Only applicable to <a id="wrglossary.2780"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> and <a id="wrglossary.2781"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>.
As from v4.50, the initial setting is now
-<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>.
+<a id="wrglossary.2782"></a><a href="#glo:opt.esclocations"><span class="styoptfmt">esclocations</span></a><span class="optfmt">=false</span>. Previously it was
+<a id="wrglossary.2783"></a><a href="#glo:opt.esclocations"><span class="styoptfmt">esclocations</span></a><span class="optfmt">=true</span>.
<p>
-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
+Both <a id="wrglossary.2784"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> and <a id="wrglossary.2785"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> are fussy about the <a id="wrglossary.2786"></a><a href="#glo:dual.entrylocation">location</a> syntax (<a id="wrglossary.2787"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> more so than <a id="wrglossary.2788"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>) so, if
+<a id="wrglossary.2789"></a><a href="#glo:opt.esclocations"><span class="styoptfmt">esclocations</span></a><span class="optfmt">=true</span>, the <a id="wrglossary.2790"></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.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
+<a id="wrglossary.2791"></a><a href="#glo:dual.entrylocation">location</a> to be substituted for a format that’s more acceptable to
+the <a id="wrglossary.2792"></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.2799"></a><a href="#glo:dual.glossary">glossary</a>
+acceptable format (or you’re prepared to post-process the <a id="wrglossary.2793"></a><a href="#glo:dual.glossary">glossary</a>
file before passing it to the relevant indexing application) then
-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
+use <a id="wrglossary.2794"></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.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
+If, however, your <a id="wrglossary.2795"></a><a href="#glo:dual.entrylocation">locations</a> (for example, <a id="wrglossary.2796"></a><a href="#glo:thepage"><code class="csfmt">\thepage</code></a> with the
+default <a id="wrglossary.2797"></a><a href="#glo:opt.counter"><span class="styoptfmt">counter</span></a><span class="optfmt">=<a id="wrglossary.2798"></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.2799"></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.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 -->
+<a id="wrglossary.2800"></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.2807"></a><a href="#glo:thepage"><code class="csfmt">\thepage</code></a>.
+special characters without prematurely expanding <a id="wrglossary.2801"></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.2808"></a><code class="code"><dfn id="glo:glswrallowprimitivemodstrue"><code class="csfmt">\glswrallowprimitivemodstrue</code></dfn></code></div><!-- end of pinnedbox -->
+<a id="wrglossary.2802"></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.2809"></a><a href="#glo:opt.esclocations"><span class="styoptfmt">esclocations</span></a><span class="optfmt">=false</span>.
+<a id="wrglossary.2803"></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.2810"></a><code class="code"><dfn id="glo:glswrallowprimitivemodsfalse"><code class="csfmt">\glswrallowprimitivemodsfalse</code></dfn></code></div><!-- end of pinnedbox -->
+<a id="wrglossary.2804"></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.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
+If you are using <a id="wrglossary.2805"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> and your <a id="wrglossary.2806"></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.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>
+a command (optionally preceded by <a id="wrglossary.2807"></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.2808"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>, then you can use
+<a id="wrglossary.2809"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> to make a suitable adjustment without
+<a id="wrglossary.2810"></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.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.
+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.2811"></a><a href="#glo:dual.entrylocation">locations</a> are written to
+the <a id="wrglossary.2812"></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.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 -->
+<a id="wrglossary.2813"></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.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>
+If true, this setting will only <a id="wrglossary.2814"></a><a href="#glo:dual.indexing">index</a> on <a id="wrglossary.2815"></a><a href="#glo:dual.firstuse">first use</a>.
+The default setting <a id="wrglossary.2816"></a><a href="#glo:opt.indexonlyfirst"><span class="styoptfmt">indexonlyfirst</span></a><span class="optfmt">=false</span>,
+will <a id="wrglossary.2817"></a><a href="#glo:dual.indexing">index</a> the entry every time one of the
+<a id="wrglossary.2818"></a><a href="#glo:glslike"><code class="csfmt">\gls</code>-like</a> or <a id="wrglossary.2819"></a><a href="#glo:glstextlike"><code class="csfmt">\glstext</code>-like</a> commands are used. Note that <a id="wrglossary.2820"></a><a href="#glo:glsadd"><code class="csfmt">\glsadd</code></a>
+will always add information to the external <a id="wrglossary.2821"></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.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 -->
+<a id="wrglossary.2822"></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.2829"></a><code class="code"><dfn id="glo:glsindexonlyfirsttrue"><code class="csfmt">\glsindexonlyfirsttrue</code></dfn></code></div><!-- end of pinnedbox -->
+<a id="wrglossary.2823"></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.2830"></a><code class="code"><dfn id="glo:glsindexonlyfirstfalse"><code class="csfmt">\glsindexonlyfirstfalse</code></dfn></code></div><!-- end of pinnedbox -->
+<a id="wrglossary.2824"></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.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
+Resetting the <a id="wrglossary.2825"></a><a href="#glo:dual.firstuseflag">first use flag</a> with commands like
+<a id="wrglossary.2826"></a><a href="#glo:glsreset"><code class="csfmt">\glsreset</code></a> after an entry has been <a id="wrglossary.2827"></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.2834"></a><a href="#glo:dual.firstuseflag">first use flag</a> before an entry has been
+Likewise unsetting the <a id="wrglossary.2828"></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.2835"></a><a href="#glo:glsadd"><code class="csfmt">\glsadd</code></a>).
+indexed with <a id="wrglossary.2829"></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.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 -->
+<a id="wrglossary.2830"></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.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>
+The default definition of <a id="wrglossary.2831"></a><a href="#glo:glswriteentry"><code class="csfmt">\glswriteentry</code></a> is:
+<pre class="compactcodebox"><code class="cmd">\newcommand</code>*{<a id="wrglossary.2832"></a><a href="#glo:glswriteentry"><code class="csfmt">\glswriteentry</code></a>}[2]{<span class="comment">% </span>
+ <a id="wrglossary.2833"></a><a href="#glo:ifglsindexonlyfirst"><code class="csfmt">\ifglsindexonlyfirst</code></a>
+ <a id="wrglossary.2834"></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>
@@ -10608,15 +10617,15 @@
}
</pre>
This does <span class="meta">〈<em class="metainner">indexing code</em>〉</span> unless
-<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>
+<a id="wrglossary.2835"></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.2836"></a><a href="#glo:firstuseflag">used</a>
<p>
-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>
+For example, suppose you only want to index the <a id="wrglossary.2837"></a><a href="#glo:dual.firstuse">first use</a> for
+entries in the <a id="wrglossary.2838"></a><a href="#glo:opt.glostype.acronym"><code class="glostypefmt">acronym</code></a> glossary and not in the
+<a id="wrglossary.2839"></a><a href="#glo:opt.glostype.main"><code class="glostypefmt">main</code></a> (or any other) <a id="wrglossary.2840"></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.2841"></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.2842"></a><a href="#glo:glsentrytype"><code class="csfmt">\glsentrytype</code></a>{#1}}{acronym}
+ {<a id="wrglossary.2843"></a><a href="#glo:ifglsused"><code class="csfmt">\ifglsused</code></a>{#1}{}{#2}}<span class="comment">% </span>
{#2}<span class="comment">% </span>
}
</pre>
@@ -10625,124 +10634,124 @@
There are other methods of performing an expanded string comparison,
which you may prefer to use.
<p>
-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.
+With the <a id="wrglossary.2844"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package it’s possible to only index
+<a id="wrglossary.2845"></a><a href="#glo:dual.firstuse">first use</a> for particular categories. For example, if you only
+want this enabled for <a id="wrglossary.2846"></a><a href="#glo:idx.abbreviation"><span class="xtrfmt">abbreviations</span></a> then you can set
+the <a id="wrglossary.2847"></a><a href="#glo:opt.catattr.indexonlyfirst"><span class="csoptfmt">indexonlyfirst</span></a> <a id="wrglossary.2848"></a><a href="#glo:idx.categoryattribute">attribute</a>
+for the <a id="wrglossary.2849"></a><a href="#glo:opt.cat.abbreviation"><span class="catfmt">abbreviation</span></a>
+and, if appropriate, <a id="wrglossary.2850"></a><a href="#glo:opt.cat.acronym"><span class="catfmt">acronym</span></a> categories. (Instead of using the
+<a id="wrglossary.2851"></a><a href="#glo:opt.indexonlyfirst"><span class="styoptfmt">indexonlyfirst</span></a> package option.) See the
+<a id="wrglossary.2852"></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.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 -->
+<a id="wrglossary.2853"></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.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
+This option is only available with <a id="wrglossary.2854"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>.
+If true, this will automatically index (<a id="wrglossary.2855"></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.2862"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> manual for further details.
+<a id="wrglossary.2856"></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.2863"></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.2857"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a></div><!-- end of informationtitle -->
-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
+Note that <a id="wrglossary.2858"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> can automatically find dependent entries
+when it parses the <a id="wrglossary.2859"></a><a href="#glo:ext.bib"><span class="extfmt">bib</span></a> file. Use the <a id="wrglossary.2860"></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.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 -->
+<a id="wrglossary.2861"></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.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>.
+This option is only available with <a id="wrglossary.2862"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>.
+The base <a id="wrglossary.2863"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package always implements
+<a id="wrglossary.2864"></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.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.
+If true, this makes the <a id="wrglossary.2865"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a> and
+<a id="wrglossary.2866"></a><a href="#glo:opt.gloskey.seealso"><span class="xtrcsoptfmt">seealso</span></a> keys automatically index the entry
+(with <a id="wrglossary.2867"></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.2868"></a><a href="#glo:opt.gloskey.see"><span class="csoptfmt">see</span></a> (or <a id="wrglossary.2869"></a><a href="#glo:opt.gloskey.seealso"><span class="xtrcsoptfmt">seealso</span></a>) key will
+automatically be added to the <a id="wrglossary.2870"></a><a href="#glo:dual.glossary">glossary</a>. See the
+<a id="wrglossary.2871"></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.2878"></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.2872"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a></div><!-- end of informationtitle -->
-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
+With <a id="wrglossary.2873"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>, use the <a id="wrglossary.2874"></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.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 -->
+<a id="wrglossary.2875"></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.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
+This option is only available with <a id="wrglossary.2876"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>.
+See <a id="wrglossary.2877"></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.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 -->
+<a id="wrglossary.2878"></a><a id="wrglossary.2879"></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.2886"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> isn’t being used.
+This default setting indicates that <a id="wrglossary.2880"></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.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 -->
+<a id="wrglossary.2881"></a><a id="wrglossary.2882"></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.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
+This setting indicates that <a id="wrglossary.2883"></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.2884"></a><a href="#glo:ext.bib"><span class="extfmt">bib</span></a> files, to sort the entries and collate the
+<a id="wrglossary.2885"></a><a href="#glo:locationlist">number lists</a>, where the <a id="wrglossary.2886"></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.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 -->
+<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.nameref"><span class="xtroptfmt">nameref</span></dfn></code></div><!-- end of optionvaluebox -->
-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
+This setting is like <a id="wrglossary.2889"></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.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 -->
+<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.hybrid"><span class="xtroptfmt">hybrid</span></dfn></code></div><!-- end of optionvaluebox -->
-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
+This setting indicates a hybrid approach where <a id="wrglossary.2892"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>
+is 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 but
+<a id="wrglossary.2894"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> or <a id="wrglossary.2895"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> are used for the <a id="wrglossary.2896"></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.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 -->
+<a id="wrglossary.2897"></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.2904"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>.
+This option is only available with <a id="wrglossary.2898"></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.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
+<a id="wrglossary.2899"></a><a href="#glo:dual.locationcounter">location counter</a> to automatically switch to <a id="wrglossary.2900"></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.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 -->
+<a id="wrglossary.2901"></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.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>
+This option is only available with <a id="wrglossary.2902"></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.2903"></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.2910"></a><a href="#glo:caption"><code class="csfmt">\caption</code></a> command that
+float. (Remember that with floats it’s the <a id="wrglossary.2904"></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.2911"></a><a href="#glo:dual.indexing">indexed</a> within the float before the caption.)
+is <a id="wrglossary.2905"></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.2912"></a><code class="code"><dfn id="glo:opt.indexcounter"><span class="xtrstyoptfmt">indexcounter</span></dfn></code></div><!-- end of settingsbox -->
+<a id="wrglossary.2906"></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.2913"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>.
+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 valueless option is primarily intended for use with
-<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
+<a id="wrglossary.2908"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a> and <a id="wrglossary.2909"></a><a href="#glo:pkg.hyperref"><span class="styfmt">hyperref</span></a> allowing the page location
+<a id="wrglossary.2910"></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.2917"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> manual for
+with other indexing methods. See <a id="wrglossary.2911"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> manual for
further details.
-<a id="wrglossary.2918"></a>
+<a id="wrglossary.2912"></a>
<p>
</section><!-- end of section sec:pkgopts-indexing -->
@@ -10751,225 +10760,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.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>.
+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.2913"></a><a href="#glo:opt.sort"><span class="styoptfmt">sort</span></a> and
+<a id="wrglossary.2914"></a><a href="#glo:opt.order"><span class="styoptfmt">order</span></a> options are applicable for <a id="wrglossary.2915"></a><a href="#glo:idx.opt.noidx">Option 1</a>.
<p>
-<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 -->
+<div class="information"><div class="informationtitle"><a id="wrglossary.2916"></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.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.b2g">4</a>, <a href="#glo:idx.opt.unsrt">5</a> and <a href="#glo:idx.opt.standalone">6</a>, only <a id="wrglossary.2917"></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.2918"></a><a href="#glo:opt.record"><span class="xtrstyoptfmt">record</span></a><span class="optfmt">=</span><a id="wrglossary.2919"></a><a href="#glo:optval.record.only"><span class="xtroptfmt">only</span></a> and
+<a id="wrglossary.2920"></a><a href="#glo:opt.record"><span class="xtrstyoptfmt">record</span></a><span class="optfmt">=</span><a id="wrglossary.2921"></a><a href="#glo:optval.record.nameref"><span class="xtroptfmt">nameref</span></a>). With <a id="wrglossary.2922"></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.2923"></a><a href="#glo:GlsXtrLoadResources"><code class="xtrcsfmt">\GlsXtrLoadResources</code></a>
+not with the <a id="wrglossary.2924"></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.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 -->
+<a id="wrglossary.2925"></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.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
+This option determines whether or not to <a id="wrglossary.2926"></a><a href="#glo:dual.sanitize">sanitize</a> the sort value when
+writing to the external <a id="wrglossary.2927"></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.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 class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.2928"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{hash}{<a id="wrglossary.2929"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={<a id="wrglossary.2930"></a><a href="#glo:cs.hash"><code class="csfmt">\#</code></a>}</span>,<a id="wrglossary.2931"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a><span class="optfmt">={<a id="wrglossary.2932"></a><a href="#glo:idx.sym.hash"></a>}</span>,
+ <a id="wrglossary.2933"></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.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
+The sort value (<a id="wrglossary.2934"></a><a href="#glo:idx.sym.hash"></a>) must be sanitized before writing it to the
+<a id="wrglossary.2935"></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.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>}
+<a id="wrglossary.2936"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{sample}{<span class="comment">% </span>
+ <a id="wrglossary.2937"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={sample}</span>,
+ <a id="wrglossary.2938"></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.2939"></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.2946"></a><a href="#glo:opt.sanitizesort"><span class="styoptfmt">sanitizesort</span></a>false.
+<a id="wrglossary.2940"></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.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>.
+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.2941"></a><a href="#glo:opt.sanitizesort"><span class="styoptfmt">sanitizesort</span></a><span class="optfmt">=true</span>, and the
+default for <a id="wrglossary.2942"></a><a href="#glo:idx.opt.noidx">Option 1</a> is <a id="wrglossary.2943"></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.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 -->
+<a id="wrglossary.2944"></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.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
+<a id="wrglossary.2945"></a><a href="#glo:idx.opt.noidx">Option 1</a> allows you to specify sort methods for individual glossaries
+via the <a id="wrglossary.2946"></a><a href="#glo:opt.printgloss.sort"><span class="csoptfmt">sort</span></a> key in the optional
+argument of <a id="wrglossary.2947"></a><a href="#glo:printnoidxglossary"><code class="csfmt">\printnoidxglossary</code></a>. If you have multiple
+<a id="wrglossary.2948"></a><a href="#glo:dual.glossary">glossaries</a> in your document and you are using <a id="wrglossary.2949"></a><a href="#glo:idx.opt.noidx">Option 1</a>, only use
the package options
-<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>.
+<a id="wrglossary.2950"></a><a href="#glo:opt.sort"><span class="styoptfmt">sort</span></a><span class="optfmt">=</span><a id="wrglossary.2951"></a><a href="#glo:optval.sort.def"><span class="optfmt">def</span></a> or <a id="wrglossary.2952"></a><a href="#glo:opt.sort"><span class="styoptfmt">sort</span></a><span class="optfmt">=</span><a id="wrglossary.2953"></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.2954"></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.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 -->
+<a id="wrglossary.2955"></a><a id="wrglossary.2956"></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.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
+<a id="wrglossary.2957"></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.2958"></a><a href="#glo:makenoidxglossaries"><code class="csfmt">\makenoidxglossaries</code></a> (<a id="wrglossary.2959"></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.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
+<a id="wrglossary.2960"></a><a href="#glo:dual.glossary">glossary</a> is required or if <a id="wrglossary.2961"></a><a href="#glo:printunsrtglossary"><code class="xtrcsfmt">\printunsrtglossary</code></a> is used
+(<a id="wrglossary.2962"></a><a href="#glo:idx.opt.unsrt">Option 5</a>). If you want an unsorted <a id="wrglossary.2963"></a><a href="#glo:dual.glossary">glossary</a> with
+<a id="wrglossary.2964"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>, use the resource option <a id="wrglossary.2965"></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.2966"></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.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>
+This option will still assign the <a id="wrglossary.2967"></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.2968"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a>
+key set to an empty value instead, use <a id="wrglossary.2969"></a><a href="#glo:opt.sort"><span class="styoptfmt">sort</span></a><span class="optfmt">=</span><a id="wrglossary.2970"></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.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 -->
+<a id="wrglossary.2971"></a><a id="wrglossary.2972"></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.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>.
+As <a id="wrglossary.2973"></a><a href="#glo:opt.sort"><span class="styoptfmt">sort</span></a><span class="optfmt">=</span><a id="wrglossary.2974"></a><a href="#glo:optval.sort.none"><span class="optfmt">none</span></a> but sets the <a id="wrglossary.2975"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a> key to an
+empty value. This will affect <a id="wrglossary.2976"></a><a href="#glo:idx.group">letter group</a> formations in
+<a id="wrglossary.2977"></a><a href="#glo:printunsrtglossary"><code class="xtrcsfmt">\printunsrtglossary</code></a> with <a id="wrglossary.2978"></a><a href="#glo:idx.opt.unsrt">Option 5</a>. See the
+<a id="wrglossary.2979"></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.2980"></a><a href="#glo:glsindexingsetting"><code class="csfmt">\glsindexingsetting</code></a> to <code class="code">none</code>. The remaining
+<a id="wrglossary.2981"></a><a href="#glo:opt.sort"><span class="styoptfmt">sort</span></a> options listed below don’t change <a id="wrglossary.2982"></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.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 -->
+<a id="wrglossary.2983"></a><a id="wrglossary.2984"></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.2991"></a><a href="#glo:idx.opt.noidx">Option 1</a>, this is implemented by
+which they were defined. With <a id="wrglossary.2985"></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.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
+(since that’s the purpose of <a id="wrglossary.2986"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> and <a id="wrglossary.2987"></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.2994"></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.2988"></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.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 -->
+<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.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.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
+the document. With <a id="wrglossary.2991"></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.2992"></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.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>.
+<a id="wrglossary.2993"></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.2994"></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.2995"></a><a href="#glo:dual.indexing">indexed</a>.
<p>
-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
+Both <a id="wrglossary.2996"></a><a href="#glo:opt.sort"><span class="styoptfmt">sort</span></a><span class="optfmt">=</span><a id="wrglossary.2997"></a><a href="#glo:optval.sort.def"><span class="optfmt">def</span></a> and <a id="wrglossary.2998"></a><a href="#glo:opt.sort"><span class="styoptfmt">sort</span></a><span class="optfmt">=</span><a id="wrglossary.2999"></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.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 -->
+<a id="wrglossary.3000"></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.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>).
+case of <a id="wrglossary.3001"></a><a href="#glo:opt.sort"><span class="styoptfmt">sort</span></a><span class="optfmt">=</span><a id="wrglossary.3002"></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.3003"></a><a href="#glo:opt.sort"><span class="styoptfmt">sort</span></a><span class="optfmt">=</span><a id="wrglossary.3004"></a><a href="#glo:optval.sort.use"><span class="optfmt">use</span></a>).
<p>
-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>
+Note that the <a id="wrglossary.3005"></a><a href="#glo:idx.group">group</a> styles (such as <a id="wrglossary.3006"></a><a href="#glo:opt.glostyle.listgroup"><span class="glostylefmt">listgroup</span></a>) are
+incompatible with the <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> and <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.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.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 -->
+<a id="wrglossary.3011"></a><a id="wrglossary.3012"></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.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).
+Entries are sorted according to the value of the <a id="wrglossary.3013"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a> key
+used in <a id="wrglossary.3014"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a> (if present) or the <a id="wrglossary.3015"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a>
+key (if <a id="wrglossary.3016"></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.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 -->
+<a id="wrglossary.3017"></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.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:
+sort value (which was either explicitly set via the <a id="wrglossary.3018"></a><a href="#glo:opt.gloskey.sort"><span class="csoptfmt">sort</span></a>
+key or implicitly set via the <a id="wrglossary.3019"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a> key) before any escaping of the
+<a id="wrglossary.3020"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>/<a id="wrglossary.3021"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> special characters is performed.
+By default <a id="wrglossary.3022"></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.3029"></a><code class="code"><dfn id="glo:glsdosanitizesort"><code class="csfmt">\glsdosanitizesort</code></dfn></code>
+<a id="wrglossary.3023"></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.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>).
+which <a id="wrglossary.3024"></a><a href="#glo:dual.sanitize">sanitizes</a> <span class="meta">〈<em class="metainner">sort cs</em>〉</span> if <a id="wrglossary.3025"></a><a href="#glo:opt.sanitizesort"><span class="styoptfmt">sanitizesort</span></a><span class="optfmt">=true</span>
+(or does nothing if <a id="wrglossary.3026"></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.3033"></a><a href="#glo:dual.glossary">glossary</a> type and the entry label for the current entry. Note that
+<a id="wrglossary.3027"></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.3034"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>.
+be in the form used in the first argument of <a id="wrglossary.3028"></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.3035"></a><a href="#glo:glsprestandardsort"><code class="csfmt">\glsprestandardsort</code></a> won’t affect any entries that
+Redefining <a id="wrglossary.3029"></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.3036"></a><a href="#glo:opt.sort"><span class="styoptfmt">sort</span></a> setting.
+use another <a id="wrglossary.3030"></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.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
+Suppose I have three <a id="wrglossary.3031"></a><a href="#glo:dual.glossary">glossaries</a>: <a id="wrglossary.3032"></a><a href="#glo:opt.glostype.main"><code class="glostypefmt">main</code></a>,
+<a id="wrglossary.3033"></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.3034"></a><a href="#glo:opt.glostype.main"><code class="glostypefmt">main</code></a> and <a id="wrglossary.3035"></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.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>]
+For <a id="wrglossary.3036"></a><a href="#glo:idx.opt.noidx">Option 1</a>, the <a id="wrglossary.3037"></a><a href="#glo:opt.printgloss.sort"><span class="csoptfmt">sort</span></a> option can be
+used in <a id="wrglossary.3038"></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.3039"></a><a href="#glo:printnoidxglossary"><code class="csfmt">\printnoidxglossary</code></a>[<a id="wrglossary.3040"></a><a href="#glo:opt.printgloss.sort"><span class="csoptfmt">sort</span></a><span class="optfmt">=word</span>]
+<a id="wrglossary.3041"></a><a href="#glo:printnoidxglossary"><code class="csfmt">\printnoidxglossary</code></a>[<a id="wrglossary.3042"></a><a href="#glo:opt.printgloss.type"><span class="csoptfmt">type</span></a><span class="optfmt">=<a id="wrglossary.3043"></a><a href="#glo:opt.glostype.acronym"><code class="glostypefmt">acronym</code></a></span>,<a id="wrglossary.3044"></a><a href="#glo:opt.printgloss.sort"><span class="csoptfmt">sort</span></a><span class="optfmt">=word</span>]
+<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.type"><span class="csoptfmt">type</span></a><span class="optfmt">=notation</span>,<a id="wrglossary.3047"></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.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>
+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.3048"></a><a href="#glo:opt.sort"><span class="styoptfmt">sort</span></a><span class="optfmt">=</span><a id="wrglossary.3049"></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.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
+all my <a id="wrglossary.3050"></a><a href="#glo:opt.glostype.main"><code class="glostypefmt">main</code></a> and <a id="wrglossary.3051"></a><a href="#glo:opt.glostype.acronym"><code class="glostypefmt">acronym</code></a> entries, then
+redefine <a id="wrglossary.3052"></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.3059"></a><a href="#glo:glsprestandardsort"><code class="csfmt">\glsprestandardsort</code></a> to check for the glossary type and only
+<a id="wrglossary.3053"></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.3060"></a><a href="#glo:glsprestandardsort"><code class="csfmt">\glsprestandardsort</code></a>}[3]{<span class="comment">% </span>
+<code class="cmd">\renewcommand</code>{<a id="wrglossary.3054"></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.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>
+ <code class="cmd">\edef</code>#1{<a id="wrglossary.3055"></a><a href="#glo:glssortnumberfmt"><code class="csfmt">\glssortnumberfmt</code></a>{<a id="wrglossary.3056"></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.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.3057"></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.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.3058"></a><a href="#glo:glssortnumberfmt"><code class="csfmt">\glssortnumberfmt</code></a>{<a id="wrglossary.3059"></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.3066"></a><a href="#glo:glsdosanitizesort"><code class="csfmt">\glsdosanitizesort</code></a>
+ <a id="wrglossary.3060"></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.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>.
+(<code class="csfmt">\ifdefstring</code> is defined by the <a id="wrglossary.3061"></a><a href="#glo:pkg.etoolbox"><span class="styfmt">etoolbox</span></a> package, which
+is automatically loaded by <a id="wrglossary.3062"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a>.)
+For a complete document, see the sample file <a id="wrglossary.3063"></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.3070"></a><a href="#glo:dual.glossary">glossary</a> of people and you want the names listed
+Suppose you want a <a id="wrglossary.3064"></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.3071"></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.3065"></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>
@@ -10980,15 +10989,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.3072"></a><a href="#glo:glsprestandardsort"><code class="csfmt">\glsprestandardsort</code></a> so that it temporarily sets
+Now redefine <a id="wrglossary.3066"></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.3073"></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.3067"></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.3074"></a><a href="#glo:glsdosanitizesort"><code class="csfmt">\glsdosanitizesort</code></a>
+ <a id="wrglossary.3068"></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
@@ -10995,145 +11004,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.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>
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.3069"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{joebloggs}<a id="wrglossary.3070"></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.3071"></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.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>}
+<a id="wrglossary.3072"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{johnsmith}{<a id="wrglossary.3073"></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.3074"></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.3081"></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.3075"></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.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 -->
+<a id="wrglossary.3076"></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.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 -->
+<a id="wrglossary.3077"></a><a id="wrglossary.3078"></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.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 -->
+<a id="wrglossary.3079"></a><a id="wrglossary.3080"></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.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>.
+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.3081"></a><a href="#glo:opt.order"><span class="styoptfmt">order</span></a> option has
+no effect if you explicitly call <a id="wrglossary.3082"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> or <a id="wrglossary.3083"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>.
</div><!-- end of important -->
<p>
-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>]
+If you use <a id="wrglossary.3084"></a><a href="#glo:idx.opt.noidx">Option 1</a>, this setting will be used if you use
+<a id="wrglossary.3085"></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.3086"></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.3087"></a><a href="#glo:printnoidxglossary"><code class="csfmt">\printnoidxglossary</code></a>[<a id="wrglossary.3088"></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.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>]
+<a id="wrglossary.3089"></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.3090"></a><a href="#glo:printnoidxglossary"><code class="csfmt">\printnoidxglossary</code></a>[<a id="wrglossary.3091"></a><a href="#glo:opt.printgloss.sort"><span class="csoptfmt">sort</span></a><span class="optfmt">=word</span>]
+<a id="wrglossary.3092"></a><a href="#glo:printnoidxglossary"><code class="csfmt">\printnoidxglossary</code></a>[<a id="wrglossary.3093"></a><a href="#glo:opt.printgloss.type"><span class="csoptfmt">type</span></a><span class="optfmt">=<a id="wrglossary.3094"></a><a href="#glo:opt.glostype.acronym"><code class="glostypefmt">acronym</code></a></span>,<a id="wrglossary.3095"></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.3102"></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.3096"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a></div><!-- end of informationtitle -->
-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>.
+With <a id="wrglossary.3097"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>, use the <a id="wrglossary.3098"></a><a href="#glo:opt.resource.break-at"><span class="xtrcsoptfmt">break-at</span></a> option
+in <a id="wrglossary.3099"></a><a href="#glo:GlsXtrLoadResources"><code class="xtrcsfmt">\GlsXtrLoadResources</code></a> instead of <a id="wrglossary.3100"></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.3107"></a><code class="code"><dfn id="glo:opt.makeindex"><span class="styoptfmt">makeindex</span></dfn></code>
+<a id="wrglossary.3101"></a><code class="code"><dfn id="glo:opt.makeindex"><span class="styoptfmt">makeindex</span></dfn></code>
<p>
-<div class="noteBox"><a id="wrglossary.3108"></a><a href="#glo:idx.opt.mkidx">Option 2</a></div><!-- end of noteBox -->
+<div class="noteBox"><a id="wrglossary.3102"></a><a href="#glo:idx.opt.mkidx">Option 2</a></div><!-- end of noteBox -->
</div><!-- end of settingsbox -->
-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>
+The <a id="wrglossary.3103"></a><a href="#glo:dual.glossary">glossary</a> information and <a id="wrglossary.3104"></a><a href="#glo:dual.indexing">indexing</a> style file will be
+written in <a id="wrglossary.3105"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> format. If you use <a id="wrglossary.3106"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a>
+or <a id="wrglossary.3107"></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.3108"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>. If you don’t use
+<a id="wrglossary.3109"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a>, you need to remember to use <a id="wrglossary.3110"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>
+not <a id="wrglossary.3111"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>. The indexing style file will been given a <a id="wrglossary.3112"></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.3119"></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.3113"></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.3120"></a><a href="#glo:opt.xindy"><span class="styoptfmt">xindy</span></a> in the package option list.
+occurrence of <a id="wrglossary.3114"></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.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>
+<a id="wrglossary.3115"></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.3122"></a><a href="#glo:idx.opt.xdy">Option 3</a></div><!-- end of noteBox -->
+<div class="noteBox"><a id="wrglossary.3116"></a><a href="#glo:idx.opt.xdy">Option 3</a></div><!-- end of noteBox -->
</div><!-- end of settingsbox -->
-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.
+The <a id="wrglossary.3117"></a><a href="#glo:dual.glossary">glossary</a> information and <a id="wrglossary.3118"></a><a href="#glo:dual.indexing">indexing</a> style
+file will be written in <a id="wrglossary.3119"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> format. If you use
+<a id="wrglossary.3120"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a>, it will automatically detect that it needs to
+call <a id="wrglossary.3121"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>. If you don’t use <a id="wrglossary.3122"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a>, you need to
+remember to use <a id="wrglossary.3123"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> not <a id="wrglossary.3124"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>. The indexing style
+file will been given a <a id="wrglossary.3125"></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.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.
+these options are irrelevant if you explicitly call <a id="wrglossary.3126"></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.3127"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>
+with the <a id="wrglossary.3128"></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.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 -->
+<a id="wrglossary.3129"></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.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>
+<a id="wrglossary.3130"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a> otherwise the syntax in the <a id="wrglossary.3131"></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.3138"></a><a href="#glo:idx.opt.xdy">Option 3</a> is in effect. (If you need to
+any option other than <a id="wrglossary.3132"></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.3139"></a><a href="#glo:glsindexingsetting"><code class="csfmt">\glsindexingsetting</code></a> instead.)
+<a id="wrglossary.3133"></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.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 -->
+<a id="wrglossary.3134"></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.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>.
+The language module to use, which is passed to <a id="wrglossary.3135"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> with the
+<a id="wrglossary.3136"></a><a href="#glo:switch.xdy.L"><span class="shortargfmt">-L</span></a> switch. The default is obtained from <a id="wrglossary.3137"></a><a href="#glo:languagename"><code class="csfmt">\languagename</code></a>
+but note that this may not be correct as <a id="wrglossary.3138"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> has a different
+labelling system to <a id="wrglossary.3139"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a> and <a id="wrglossary.3140"></a><a href="#glo:pkg.polyglossia"><span class="styfmt">polyglossia</span></a>.
<p>
-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
+The <a id="wrglossary.3141"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> script has a set of mappings of known
+<a id="wrglossary.3142"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a> language names to <a id="wrglossary.3143"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> language names, but new
+<a id="wrglossary.3144"></a><a href="#glo:pkg.babel"><span class="styfmt">babel</span></a> dialect names may not be included. The
+<a id="wrglossary.3145"></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.3146"></a><a href="#glo:app.makeglossaries-lite"><span class="appfmt">makeglossaries-lite</span></a> instead of
+<a id="wrglossary.3147"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> when using <a id="wrglossary.3148"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>). The <a id="wrglossary.3149"></a><a href="#glo:opt.automake"><span class="styoptfmt">automake</span></a><span class="optfmt">=o</span>ption that calls <a id="wrglossary.3150"></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.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:
+<a id="wrglossary.3151"></a><a href="#glo:languagename"><code class="csfmt">\languagename</code></a> may still not expand to the language required for
+the <a id="wrglossary.3152"></a><a href="#glo:dual.glossary">glossary</a>. In which case, you need to specify the correct
+<a id="wrglossary.3153"></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.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}
+<code class="cmd">\usepackage</code>[<a id="wrglossary.3154"></a><a href="#glo:opt.xindy"><span class="styoptfmt">xindy</span></a><span class="optfmt">=<a id="wrglossary.3155"></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.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.
+If you have multiple <a id="wrglossary.3156"></a><a href="#glo:dual.glossary">glossaries</a> in different languages, use
+<a id="wrglossary.3157"></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.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 -->
+<a id="wrglossary.3158"></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.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
+The <a id="wrglossary.3159"></a><a href="#glo:idx.codepage">codepage</a> is the file <a id="wrglossary.3160"></a><a href="#glo:idx.encoding">encoding</a> for the <a id="wrglossary.3161"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> files and is
+passed to <a id="wrglossary.3162"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> with the <a id="wrglossary.3163"></a><a href="#glo:switch.xdy.C"><span class="shortargfmt">-C</span></a> switch. The default
+<a id="wrglossary.3164"></a><a href="#glo:idx.codepage">codepage</a> is obtained from <a id="wrglossary.3165"></a><a href="#glo:inputencodingname"><code class="csfmt">\inputencodingname</code></a>. As from v4.50, if
+<a id="wrglossary.3166"></a><a href="#glo:inputencodingname"><code class="csfmt">\inputencodingname</code></a> isn’t defined, <a id="wrglossary.3167"></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.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
+need to use the <a id="wrglossary.3168"></a><a href="#glo:opt.xindy.codepage"><span class="optfmt">codepage</span></a> option but make sure you
+use the <a id="wrglossary.3169"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> <a id="wrglossary.3170"></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.3171"></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.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
+The <a id="wrglossary.3172"></a><a href="#glo:idx.codepage">codepage</a> may not simply be the <a id="wrglossary.3173"></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 -->
@@ -11140,56 +11149,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.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>]
+<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.3174"></a><a href="#glo:opt.xindy"><span class="styoptfmt">xindy</span></a><span class="optfmt">=<a id="wrglossary.3175"></a><a href="#glo:opt.xindy.language"><span class="optfmt">language</span></a><span class="optfmt">=english</span>,<a id="wrglossary.3176"></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.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 -->
+<a id="wrglossary.3177"></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.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>
+If true, this option will define the number <a id="wrglossary.3178"></a><a href="#glo:idx.group">group</a> in the <a id="wrglossary.3179"></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.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>.
+<a id="wrglossary.3180"></a><a href="#glo:idx.group">letter group</a>. If you don’t want this <a id="wrglossary.3181"></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.3182"></a><a href="#glo:idx.group">letter group</a> is only available with
+<a id="wrglossary.3183"></a><a href="#glo:dual.latinalph">Latin alphabets</a>, so if you are using a <a id="wrglossary.3184"></a><a href="#glo:dual.nonlatinalph">non-Latin alphabet</a>, you
+will either need to switch off the number <a id="wrglossary.3185"></a><a href="#glo:idx.group">group</a> or identify the
+<a id="wrglossary.3186"></a><a href="#glo:idx.group">letter group</a> that it should come before with
+<a id="wrglossary.3187"></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.3194"></a><code class="code"><dfn id="glo:opt.xindygloss"><span class="styoptfmt">xindygloss</span></dfn></code>
+<a id="wrglossary.3188"></a><code class="code"><dfn id="glo:opt.xindygloss"><span class="styoptfmt">xindygloss</span></dfn></code>
<p>
-<div class="noteBox"><a id="wrglossary.3195"></a><a href="#glo:idx.opt.xdy">Option 3</a></div><!-- end of noteBox -->
+<div class="noteBox"><a id="wrglossary.3189"></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.3196"></a><a href="#glo:opt.xindy"><span class="styoptfmt">xindy</span></a> without any value supplied
+This is equivalent to <a id="wrglossary.3190"></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.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
+and code page can be set via <a id="wrglossary.3191"></a><a href="#glo:GlsSetXdyLanguage"><code class="csfmt">\GlsSetXdyLanguage</code></a> and
+<a id="wrglossary.3192"></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.3199"></a><code class="code"><dfn id="glo:opt.xindynoglsnumbers"><span class="styoptfmt">xindynoglsnumbers</span></dfn></code>
+<a id="wrglossary.3193"></a><code class="code"><dfn id="glo:opt.xindynoglsnumbers"><span class="styoptfmt">xindynoglsnumbers</span></dfn></code>
<p>
-<div class="noteBox"><a id="wrglossary.3200"></a><a href="#glo:idx.opt.xdy">Option 3</a></div><!-- end of noteBox -->
+<div class="noteBox"><a id="wrglossary.3194"></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.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>
+<a id="wrglossary.3195"></a><a href="#glo:opt.xindy"><span class="styoptfmt">xindy</span></a><span class="optfmt">={<a id="wrglossary.3196"></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.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 -->
+<a id="wrglossary.3197"></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.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>
+This option will attempt to use the <a id="wrglossary.3198"></a><a href="#glo:dual.shellescape">shell escape</a> to run the
+appropriate <a id="wrglossary.3199"></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.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>}
+<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.3200"></a><a href="#glo:opt.automake"><span class="styoptfmt">automake</span></a>]{glossaries}
+<a id="wrglossary.3201"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a>
+<a id="wrglossary.3202"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{sample}{<a id="wrglossary.3203"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={sample}</span>,<a id="wrglossary.3204"></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.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>
+<a id="wrglossary.3205"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a>{sample}
+<a id="wrglossary.3206"></a><a href="#glo:printglossaries"><code class="csfmt">\printglossaries</code></a>
<code class="cend">\end{document}</code>
</pre>
Then the document build is now:
@@ -11196,26 +11205,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.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
+This will run <a id="wrglossary.3207"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> on every LaTeX run. If you have a
+large <a id="wrglossary.3208"></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.3209"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>
+(either explicitly or via <a id="wrglossary.3210"></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.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>
+<a id="wrglossary.3211"></a><a href="#glo:dual.shellescape">shell escape</a> enabled (restricted mode for a direct call to
+<a id="wrglossary.3212"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> and unrestricted mode for <a id="wrglossary.3213"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>,
+<a id="wrglossary.3214"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> or <a id="wrglossary.3215"></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.3216"></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.3223"></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.3217"></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.3224"></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.3218"></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
@@ -11227,20 +11236,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.3225"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> is on the list of trusted applications.
+mode because <a id="wrglossary.3219"></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.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 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.3220"></a><a href="#glo:opt.automake"><span class="styoptfmt">automake</span></a><span class="optfmt">=</span><a id="wrglossary.3221"></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.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
+This indicates that an attempt was made to run <a id="wrglossary.3222"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a>
+(rather than a direct call to <a id="wrglossary.3223"></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.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>.
+<a id="wrglossary.3224"></a><a href="#glo:opt.automake"><span class="styoptfmt">automake</span></a><span class="optfmt">=</span><a id="wrglossary.3225"></a><a href="#glo:optval.automake.lite"><span class="optfmt">lite</span></a> or if the <a id="wrglossary.3226"></a><a href="#glo:opt.xindy"><span class="styoptfmt">xindy</span></a> option is used.
+These cases require the unrestricted <a id="wrglossary.3227"></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
@@ -11247,46 +11256,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.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
+in restricted mode (or with the <a id="wrglossary.3228"></a><a href="#glo:dual.shellescape">shell escape</a> disabled) and
+search the <a id="wrglossary.3229"></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.3236"></a><a href="#glo:ext.log"><span class="extfmt">log</span></a> file should now be:
+line in the <a id="wrglossary.3230"></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.3237"></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.3231"></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.3238"></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.3232"></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.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).
+results, check the <a id="wrglossary.3233"></a><a href="#glo:dual.indexingapp">indexing application’s</a> transcript file (for
+example, the <a id="wrglossary.3234"></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.3235"></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.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 -->
+<a id="wrglossary.3236"></a><a id="wrglossary.3237"></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.3244"></a><a href="#glo:dual.shellescape">shell escape</a>.
+No attempt is made to use the <a id="wrglossary.3238"></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.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 -->
+<a id="wrglossary.3239"></a><a id="wrglossary.3240"></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.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.
+<a id="wrglossary.3241"></a><a href="#glo:opt.automake"><span class="styoptfmt">automake</span></a><span class="optfmt">=</span><a id="wrglossary.3242"></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.3243"></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.3244"></a><a href="#glo:opt.automake"><span class="styoptfmt">automake</span></a><span class="optfmt">=</span><a id="wrglossary.3245"></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.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 id="wrglossary.3246"></a><a id="wrglossary.3247"></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.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>
+A direct call to <a id="wrglossary.3248"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> or <a id="wrglossary.3249"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> (as appropriate) for
+each non-empty <a id="wrglossary.3250"></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.3251"></a><a href="#glo:dual.glossary">glossary</a>
files are complete. (It’s necessary to delay writing to the
-<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
+<a id="wrglossary.3252"></a><a href="#glo:dual.indexingfile">indexing files</a> in order to ensure that <a id="wrglossary.3253"></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
@@ -11293,102 +11302,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.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 id="wrglossary.3254"></a><a id="wrglossary.3255"></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.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
+A direct call to <a id="wrglossary.3256"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> or <a id="wrglossary.3257"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> (as appropriate) for
+each non-empty <a id="wrglossary.3258"></a><a href="#glo:dual.glossary">glossary</a> will be made at the start of
+<a id="wrglossary.3259"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a> using an immediate write. This ensures that the
+<a id="wrglossary.3260"></a><a href="#glo:dual.indexingfile">indexing files</a> are read by the <a id="wrglossary.3261"></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.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>
+If you are using <a id="wrglossary.3262"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>, then <a id="wrglossary.3263"></a><a href="#glo:opt.automake"><span class="styoptfmt">automake</span></a><span class="optfmt">=</span><a id="wrglossary.3264"></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.3271"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> you get the
+the unrestricted mode, but with <a id="wrglossary.3265"></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.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 id="wrglossary.3266"></a><a id="wrglossary.3267"></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.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
+A call to <a id="wrglossary.3268"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> will be made at the start of
+<a id="wrglossary.3269"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a> using an immediate write if the <a id="wrglossary.3270"></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.3271"></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.3278"></a><a href="#glo:dual.shellescape">shell escape</a>.
+both requires Perl and the unrestricted <a id="wrglossary.3272"></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.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 id="wrglossary.3273"></a><a id="wrglossary.3274"></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.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
+A call to <a id="wrglossary.3275"></a><a href="#glo:app.makeglossaries-lite"><span class="appfmt">makeglossaries-lite</span></a> will be made at the start of
+<a id="wrglossary.3276"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a> using an immediate write if the <a id="wrglossary.3277"></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.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
+<a id="wrglossary.3278"></a><a href="#glo:opt.automake"><span class="styoptfmt">automake</span></a><span class="optfmt">=</span><a id="wrglossary.3279"></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.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 -->
+<a id="wrglossary.3280"></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.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>.
+This valueless option is equivalent to <a id="wrglossary.3281"></a><a href="#glo:opt.automake"><span class="styoptfmt">automake</span></a><span class="optfmt">=</span><a id="wrglossary.3282"></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.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 -->
+<a id="wrglossary.3283"></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.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>.
+This valueless option is equivalent to <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.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.3292"></a><code class="code"><dfn id="glo:opt.disablemakegloss"><span class="styoptfmt">disablemakegloss</span></dfn></code></div><!-- end of settingsbox -->
+<a id="wrglossary.3286"></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.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
+This valueless option indicates that <a id="wrglossary.3287"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a> and
+<a id="wrglossary.3288"></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.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.)
+automatically performs <a id="wrglossary.3289"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a> or
+<a id="wrglossary.3290"></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.3291"></a><a href="#glo:dual.indexing">indexing</a> method or you want to
+disable <a id="wrglossary.3292"></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.3299"></a><a href="#glo:dual.indexing">indexing</a> method, for example, it’s an
+insists on a specific <a id="wrglossary.3293"></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.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
+or passed using <a id="wrglossary.3294"></a><a href="#glo:PassOptionsToPackage"><code class="csfmt">\PassOptionsToPackage</code></a> before <a id="wrglossary.3295"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> is
loaded. Note that this does nothing if
-<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
+<a id="wrglossary.3296"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a> or <a id="wrglossary.3297"></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.3304"></a><code class="code"><dfn id="glo:opt.restoremakegloss"><span class="styoptfmt">restoremakegloss</span></dfn></code></div><!-- end of settingsbox -->
+<a id="wrglossary.3298"></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.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
+Cancels the effect of <a id="wrglossary.3299"></a><a href="#glo:opt.disablemakegloss"><span class="styoptfmt">disablemakegloss</span></a>. This option may be used in
+<a id="wrglossary.3300"></a><a href="#glo:setupglossaries"><code class="csfmt">\setupglossaries</code></a>. It issues a warning if <a id="wrglossary.3301"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a> or
+<a id="wrglossary.3302"></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.3303"></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.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>
+automatically loads <a id="wrglossary.3304"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> and does <a id="wrglossary.3305"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a>
+but you need an extra <a id="wrglossary.3306"></a><a href="#glo:dual.glossary">glossary</a>, which has to be defined before
+<a id="wrglossary.3307"></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.3308"></a><a href="#glo:opt.disablemakegloss"><span class="styoptfmt">disablemakegloss</span></a>]{customclass}
+<a id="wrglossary.3309"></a><a href="#glo:newglossary*"><code class="csfmt">\newglossary*</code></a>{functions}{Functions}
+<a id="wrglossary.3310"></a><a href="#glo:setupglossaries"><code class="csfmt">\setupglossaries</code></a>{restoremakegloss}
+<a id="wrglossary.3311"></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.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}
+<pre class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.3312"></a><a href="#glo:PassOptionsToPackage"><code class="csfmt">\PassOptionsToPackage</code></a>{<a id="wrglossary.3313"></a><a href="#glo:opt.disablemakegloss"><span class="styoptfmt">disablemakegloss</span></a>}{glossaries}
<code class="cmd">\documentclass</code>{customclass}
-<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>
+<a id="wrglossary.3314"></a><a href="#glo:newglossary*"><code class="csfmt">\newglossary*</code></a>{functions}{Functions}
+<a id="wrglossary.3315"></a><a href="#glo:setupglossaries"><code class="csfmt">\setupglossaries</code></a>{restoremakegloss}
+<a id="wrglossary.3316"></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.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>.
+settings will apply. For example, if you use the <a id="wrglossary.3317"></a><a href="#glo:opt.record"><span class="xtrstyoptfmt">record</span></a><span class="optfmt">=only</span>
+or <a id="wrglossary.3318"></a><a href="#glo:opt.record"><span class="xtrstyoptfmt">record</span></a><span class="optfmt">=nameref</span> options with <a id="wrglossary.3319"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>
+then you can’t use <a id="wrglossary.3320"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a> or <a id="wrglossary.3321"></a><a href="#glo:makenoidxglossaries"><code class="csfmt">\makenoidxglossaries</code></a>
+regardless of <a id="wrglossary.3322"></a><a href="#glo:opt.restoremakegloss"><span class="styoptfmt">restoremakegloss</span></a>.
<p>
</section><!-- end of section sec:pkgopts-sort -->
@@ -11398,213 +11407,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.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 -->
+<a id="wrglossary.3323"></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.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
+<a id="wrglossary.3324"></a><a href="#glo:dual.glossary">glossaries</a> and you want to suppress the entry <a id="wrglossary.3325"></a><a href="#glo:idx.hyperlink">hyperlinks</a> for a
+particular <a id="wrglossary.3326"></a><a href="#glo:dual.glossary">glossary</a> or <a id="wrglossary.3327"></a><a href="#glo:dual.glossary">glossaries</a>. The value of this option should
+be a comma-separated list of <a id="wrglossary.3328"></a><a href="#glo:dual.glossary">glossary</a> types where <a id="wrglossary.3329"></a><a href="#glo:gls"><code class="csfmt">\gls</code></a> etc
+shouldn’t have <a id="wrglossary.3330"></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.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>]
+<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.3331"></a><a href="#glo:opt.acronym"><span class="styoptfmt">acronym</span></a>,<a id="wrglossary.3332"></a><a href="#glo:opt.nohypertypes"><span class="styoptfmt">nohypertypes</span></a><span class="optfmt">={<a id="wrglossary.3333"></a><a href="#glo:opt.glostype.acronym"><code class="glostypefmt">acronym</code></a>,notation}</span>]
{glossaries}
-<a id="wrglossary.3340"></a><a href="#glo:newglossary"><code class="csfmt">\newglossary</code></a>[nlg]{notation}{not}{ntn}{Notation}
+<a id="wrglossary.3334"></a><a href="#glo:newglossary"><code class="csfmt">\newglossary</code></a>[nlg]{notation}{not}{ntn}{Notation}
</pre>
-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>.
+As illustrated above, the <a id="wrglossary.3335"></a><a href="#glo:dual.glossary">glossary</a> doesn’t need to exist when
+you identify it in <a id="wrglossary.3336"></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.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>.
+example, <a id="wrglossary.3337"></a><a href="#glo:opt.nohypertypes"><span class="styoptfmt">nohypertypes</span></a><span class="optfmt">=<a id="wrglossary.3338"></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.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 -->
+<a id="wrglossary.3339"></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.3346"></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.3340"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a></div><!-- end of informationtitle -->
-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
+The <a id="wrglossary.3341"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package has the <a id="wrglossary.3342"></a><a href="#glo:opt.catattr.nohyper"><span class="csoptfmt">nohyper</span></a>
+<a id="wrglossary.3343"></a><a href="#glo:idx.categoryattribute">category attribute</a> which will suppress the <a id="wrglossary.3344"></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.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.
+suppressing the <a id="wrglossary.3345"></a><a href="#glo:idx.hyperlink">hyperlink</a> on a per-<a id="wrglossary.3346"></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.3353"></a><code class="code"><dfn id="glo:opt.nomain"><span class="styoptfmt">nomain</span></dfn></code></div><!-- end of settingsbox -->
+<a id="wrglossary.3347"></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.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
+This suppresses the creation of the <a id="wrglossary.3348"></a><a href="#glo:opt.glostype.main"><code class="glostypefmt">main</code></a>
+glossary and associated <a id="wrglossary.3349"></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.3350"></a><a href="#glo:dual.glossary">glossary</a> in which to
+put all your entries (either via the <a id="wrglossary.3351"></a><a href="#glo:opt.acronym"><span class="styoptfmt">acronym</span></a> (or
+<a id="wrglossary.3352"></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.3353"></a><a href="#glo:opt.symbols"><span class="styoptfmt">symbols</span></a>,
+<a id="wrglossary.3354"></a><a href="#glo:opt.numbers"><span class="styoptfmt">numbers</span></a> or <a id="wrglossary.3355"></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.3356"></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.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.
+the <a id="wrglossary.3357"></a><a href="#glo:dual.glossary">glossary</a>, a default <a id="wrglossary.3358"></a><a href="#glo:dual.glossary">glossary</a> is still required.
<p>
-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:
+If you don’t use the <a id="wrglossary.3359"></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.3360"></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.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.
+Have you used any entries defined in glossary '<a id="wrglossary.3361"></a><a href="#glo:opt.glostype.main"><code class="glostypefmt">main</code></a>'?
+Remember to use package option '<a id="wrglossary.3362"></a><a href="#glo:opt.nomain"><span class="styoptfmt">nomain</span></a>' if
+you don't want to use the <a id="wrglossary.3363"></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.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>.
+If you did actually want to use the <a id="wrglossary.3364"></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.3365"></a><a href="#glo:dual.glossary">glossary</a>
+via commands such as <a id="wrglossary.3366"></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.3373"></a><code class="code"><dfn id="glo:opt.symbols"><span class="styoptfmt">symbols</span></dfn></code></div><!-- end of settingsbox -->
+<a id="wrglossary.3367"></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.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>}
+This valueless option defines a new <a id="wrglossary.3368"></a><a href="#glo:dual.glossary">glossary</a> type with
+the label <a id="wrglossary.3369"></a><dfn id="glo:opt.glostype.symbols"><code class="glostypefmt">symbols</code></dfn> via
+<pre class="compactcodebox"><a id="wrglossary.3370"></a><a href="#glo:newglossary"><code class="csfmt">\newglossary</code></a>[slg]{<a id="wrglossary.3371"></a><a href="#glo:opt.glostype.symbols"><code class="glostypefmt">symbols</code></a>}{sls}{slo}{<a id="wrglossary.3372"></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.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>
+<a id="wrglossary.3373"></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.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 class="compactcodebox"><a id="wrglossary.3374"></a><a href="#glo:printglossary"><code class="csfmt">\printglossary</code></a>[<a id="wrglossary.3375"></a><a href="#glo:opt.printgloss.type"><span class="csoptfmt">type</span></a><span class="optfmt">=<a id="wrglossary.3376"></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.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>]
+If you use <a id="wrglossary.3377"></a><a href="#glo:idx.opt.noidx">Option 1</a>, you need to use:
+<pre class="compactcodebox"><a id="wrglossary.3378"></a><a href="#glo:printnoidxglossary"><code class="csfmt">\printnoidxglossary</code></a>[<a id="wrglossary.3379"></a><a href="#glo:opt.printgloss.type"><span class="csoptfmt">type</span></a><span class="optfmt">=<a id="wrglossary.3380"></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.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.
+Remember to use the <a id="wrglossary.3381"></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.3382"></a><a href="#glo:opt.glostype.symbols"><code class="glostypefmt">symbols</code></a> glossary and don’t intend
+to use the <a id="wrglossary.3383"></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.3390"></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.3384"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a></div><!-- end of informationtitle -->
-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>
+The <a id="wrglossary.3385"></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.3386"></a><a href="#glo:glsxtrnewsymbol"><code class="xtrcsfmt">\glsxtrnewsymbol</code></a>
as a convenient shortcut method for defining symbols. See the
-<a id="wrglossary.3393"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> manual for further details.
+<a id="wrglossary.3387"></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.3394"></a><code class="code"><dfn id="glo:opt.numbers"><span class="styoptfmt">numbers</span></dfn></code></div><!-- end of settingsbox -->
+<a id="wrglossary.3388"></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.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>}
+This valueless option defines a new <a id="wrglossary.3389"></a><a href="#glo:dual.glossary">glossary</a> type with
+the label <a id="wrglossary.3390"></a><dfn id="glo:opt.glostype.numbers"><code class="glostypefmt">numbers</code></dfn> via
+<pre class="compactcodebox"><a id="wrglossary.3391"></a><a href="#glo:newglossary"><code class="csfmt">\newglossary</code></a>[nlg]{<a id="wrglossary.3392"></a><a href="#glo:opt.glostype.numbers"><code class="glostypefmt">numbers</code></a>}{nls}{nlo}{<a id="wrglossary.3393"></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.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>
+<a id="wrglossary.3394"></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.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 class="compactcodebox"><a id="wrglossary.3395"></a><a href="#glo:printglossary"><code class="csfmt">\printglossary</code></a>[<a id="wrglossary.3396"></a><a href="#glo:opt.printgloss.type"><span class="csoptfmt">type</span></a><span class="optfmt">=<a id="wrglossary.3397"></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.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>]
+If you use <a id="wrglossary.3398"></a><a href="#glo:idx.opt.noidx">Option 1</a>, you need to use:
+<pre class="compactcodebox"><a id="wrglossary.3399"></a><a href="#glo:printnoidxglossary"><code class="csfmt">\printnoidxglossary</code></a>[<a id="wrglossary.3400"></a><a href="#glo:opt.printgloss.type"><span class="csoptfmt">type</span></a><span class="optfmt">=<a id="wrglossary.3401"></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.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.
+Remember to use the <a id="wrglossary.3402"></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.3403"></a><a href="#glo:opt.glostype.numbers"><code class="glostypefmt">numbers</code></a> glossary and don’t intend
+to use the <a id="wrglossary.3404"></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.3411"></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.3405"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a></div><!-- end of informationtitle -->
-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>
+The <a id="wrglossary.3406"></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.3407"></a><a href="#glo:glsxtrnewnumber"><code class="xtrcsfmt">\glsxtrnewnumber</code></a>
as a convenient shortcut method for defining numbers. See the
-<a id="wrglossary.3414"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> manual for further details.
+<a id="wrglossary.3408"></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.3415"></a><code class="code"><dfn id="glo:opt.index"><span class="styoptfmt">index</span></dfn></code></div><!-- end of settingsbox -->
+<a id="wrglossary.3409"></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.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>}
+This valueless option defines a new <a id="wrglossary.3410"></a><a href="#glo:dual.glossary">glossary</a> type with
+the label <a id="wrglossary.3411"></a><dfn id="glo:opt.glostype.index"><code class="glostypefmt">index</code></dfn> via
+<pre class="compactcodebox"><a id="wrglossary.3412"></a><a href="#glo:newglossary"><code class="csfmt">\newglossary</code></a>[ilg]{<a id="wrglossary.3413"></a><a href="#glo:opt.glostype.index"><code class="glostypefmt">index</code></a>}{ind}{idx}{<a id="wrglossary.3414"></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.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>
+<a id="wrglossary.3415"></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.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 class="compactcodebox"><a id="wrglossary.3416"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>{<span class="meta">〈<em class="metainner">entry-label</em>〉</span>}{<a id="wrglossary.3417"></a><a href="#glo:opt.gloskey.type"><span class="csoptfmt">type</span></a><span class="optfmt">={<a id="wrglossary.3418"></a><a href="#glo:opt.glostype.index"><code class="glostypefmt">index</code></a>}</span>,<a id="wrglossary.3419"></a><a href="#glo:opt.gloskey.name"><span class="csoptfmt">name</span></a><span class="optfmt">={entry-label}</span>,
+<a id="wrglossary.3420"></a><a href="#glo:opt.gloskey.description"><span class="csoptfmt">description</span></a><span class="optfmt">={<a id="wrglossary.3421"></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.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>
+<a id="wrglossary.3422"></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.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 class="compactcodebox"><a id="wrglossary.3423"></a><a href="#glo:printglossary"><code class="csfmt">\printglossary</code></a>[<a id="wrglossary.3424"></a><a href="#glo:opt.printgloss.type"><span class="csoptfmt">type</span></a><span class="optfmt">=<a id="wrglossary.3425"></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.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>]
+If you use <a id="wrglossary.3426"></a><a href="#glo:idx.opt.noidx">Option 1</a>, you need to use:
+<pre class="compactcodebox"><a id="wrglossary.3427"></a><a href="#glo:printnoidxglossary"><code class="csfmt">\printnoidxglossary</code></a>[<a id="wrglossary.3428"></a><a href="#glo:opt.printgloss.type"><span class="csoptfmt">type</span></a><span class="optfmt">=<a id="wrglossary.3429"></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.3436"></a><a href="#glo:dual.glossary">glossary</a>.
+to display this <a id="wrglossary.3430"></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.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>.
+Remember to use the <a id="wrglossary.3431"></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.3432"></a><a href="#glo:opt.glostype.index"><code class="glostypefmt">index</code></a> glossary and don’t intend to
+use the <a id="wrglossary.3433"></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.3434"></a><a href="#glo:index"><code class="csfmt">\index</code></a>. Either use
+<a id="wrglossary.3435"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> for the <a id="wrglossary.3436"></a><a href="#glo:dual.indexing">indexing</a> or use a custom <a id="wrglossary.3437"></a><a href="#glo:dual.indexing">indexing</a>
+package, such as <a id="wrglossary.3438"></a><a href="#glo:pkg.makeidx"><span class="styfmt">makeidx</span></a>, <a id="wrglossary.3439"></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.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.)
+load <a id="wrglossary.3440"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> without the <a id="wrglossary.3441"></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.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>}
+might also want to disable the <a id="wrglossary.3442"></a><a href="#glo:idx.hyperlink">hyperlinks</a> for this <a id="wrglossary.3443"></a><a href="#glo:dual.glossary">glossary</a> using
+the package option <a id="wrglossary.3444"></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.3445"></a><a href="#glo:GlsDeclareNoHyperList"><code class="csfmt">\GlsDeclareNoHyperList</code></a>{<a id="wrglossary.3446"></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.3453"></a><a href="#glo:dual.locationlist">location list</a> to find other parts of the document
+up the term’s <a id="wrglossary.3447"></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.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.
+<a id="wrglossary.3448"></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.3449"></a><a href="#glo:idx.tableofcontents">table of contents</a>”</span>, or general commands, such as
+<a id="wrglossary.3450"></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.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.
+The example file <a id="wrglossary.3451"></a><a href="#glo:file.sample-index.tex"><span class="filefmt">sample-index.tex</span></a> illustrates the use of the
+<a id="wrglossary.3452"></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.3459"></a><code class="code"><dfn id="glo:opt.noglossaryindex"><span class="styoptfmt">noglossaryindex</span></dfn></code></div><!-- end of settingsbox -->
+<a id="wrglossary.3453"></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.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
+This valueless option switches off <a id="wrglossary.3454"></a><a href="#glo:opt.index"><span class="styoptfmt">index</span></a> if <a id="wrglossary.3455"></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.3462"></a><a href="#glo:setupglossaries"><code class="csfmt">\setupglossaries</code></a>.
+options). This option can’t be used in <a id="wrglossary.3456"></a><a href="#glo:setupglossaries"><code class="csfmt">\setupglossaries</code></a>.
<p>
</section><!-- end of section sec:pkgopts-type -->
@@ -11613,153 +11622,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.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 -->
+<a id="wrglossary.3457"></a><a id="wrglossary.3458"></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.3459"></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.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>}
+If true, this creates a new <a id="wrglossary.3460"></a><a href="#glo:dual.glossary">glossary</a> with the
+label <a id="wrglossary.3461"></a><dfn id="glo:opt.glostype.acronym"><code class="glostypefmt">acronym</code></dfn>. This is equivalent to:
+<pre class="compactcodebox"><a id="wrglossary.3462"></a><a href="#glo:newglossary"><code class="csfmt">\newglossary</code></a>[alg]{<a id="wrglossary.3463"></a><a href="#glo:opt.glostype.acronym"><code class="glostypefmt">acronym</code></a>}{acr}{acn}{<a id="wrglossary.3464"></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.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>
+<a id="wrglossary.3465"></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.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 class="compactcodebox"><a id="wrglossary.3466"></a><a href="#glo:printglossary"><code class="csfmt">\printglossary</code></a>[<a id="wrglossary.3467"></a><a href="#glo:opt.printgloss.type"><span class="csoptfmt">type</span></a><span class="optfmt">=<a id="wrglossary.3468"></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.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>]
+If you are using <a id="wrglossary.3469"></a><a href="#glo:idx.opt.noidx">Option 1</a>, you need to use
+<pre class="compactcodebox"><a id="wrglossary.3470"></a><a href="#glo:printnoidxglossary"><code class="csfmt">\printnoidxglossary</code></a>[<a id="wrglossary.3471"></a><a href="#glo:opt.printgloss.type"><span class="csoptfmt">type</span></a><span class="optfmt">=<a id="wrglossary.3472"></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.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.
+If the <a id="wrglossary.3473"></a><a href="#glo:opt.acronym"><span class="styoptfmt">acronym</span></a> package option is used, <a id="wrglossary.3474"></a><a href="#glo:acronymtype"><code class="csfmt">\acronymtype</code></a> is
+set to <a id="wrglossary.3475"></a><a href="#glo:opt.glostype.acronym"><code class="glostypefmt">acronym</code></a> otherwise it is set to
+<a id="wrglossary.3476"></a><a href="#glo:glsdefaulttype"><code class="csfmt">\glsdefaulttype</code></a> (which is normally the <a id="wrglossary.3477"></a><a href="#glo:opt.glostype.main"><code class="glostypefmt">main</code></a>
+glossary.) Entries that are defined using <a id="wrglossary.3478"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a> are
+placed in the <a id="wrglossary.3479"></a><a href="#glo:dual.glossary">glossary</a> whose label is given by <a id="wrglossary.3480"></a><a href="#glo:acronymtype"><code class="csfmt">\acronymtype</code></a>,
+unless another <a id="wrglossary.3481"></a><a href="#glo:dual.glossary">glossary</a> is explicitly specified with the
+<a id="wrglossary.3482"></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.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.)
+Remember to use the <a id="wrglossary.3483"></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.3484"></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.3485"></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.3492"></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.3486"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a></div><!-- end of informationtitle -->
-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>.
+The <a id="wrglossary.3487"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> extension package comes with an analogous
+<a id="wrglossary.3488"></a><a href="#glo:opt.abbreviations"><span class="xtrstyoptfmt">abbreviations</span></a> option, which creates a new <a id="wrglossary.3489"></a><a href="#glo:dual.glossary">glossary</a> with
+the label <a id="wrglossary.3490"></a><a href="#glo:opt.glostype.abbreviations"><code class="glostypefmt">abbreviations</code></a> and sets the command
+<a id="wrglossary.3491"></a><a href="#glo:glsxtrabbrvtype"><code class="xtrcsfmt">\glsxtrabbrvtype</code></a> to this. If the <a id="wrglossary.3492"></a><a href="#glo:opt.acronym"><span class="styoptfmt">acronym</span></a> option hasn’t
+also been used, then <a id="wrglossary.3493"></a><a href="#glo:acronymtype"><code class="csfmt">\acronymtype</code></a> will be set to
+<a id="wrglossary.3494"></a><a href="#glo:glsxtrabbrvtype"><code class="xtrcsfmt">\glsxtrabbrvtype</code></a>. This enables both <a id="wrglossary.3495"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a> and
+<a id="wrglossary.3496"></a><a href="#glo:newabbreviation"><code class="xtrcsfmt">\newabbreviation</code></a> to use the same <a id="wrglossary.3497"></a><a href="#glo:dual.glossary">glossary</a>.
<p>
-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
+Make sure you have at least v1.42 of <a id="wrglossary.3498"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> if you
+use the <a id="wrglossary.3499"></a><a href="#glo:opt.acronym"><span class="styoptfmt">acronym</span></a> (or <a id="wrglossary.3500"></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.3507"></a><a href="#glo:idx.abbrvstyle"><span class="xtrfmt">abbreviation</span> style</a>.
+<a id="wrglossary.3501"></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.3508"></a><code class="code"><dfn id="glo:opt.acronyms"><span class="styoptfmt">acronyms</span></dfn></code></div><!-- end of settingsbox -->
+<a id="wrglossary.3502"></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.3509"></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.3503"></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.3510"></a><code class="code"><dfn id="glo:opt.abbreviations"><span class="xtrstyoptfmt">abbreviations</span></dfn></code></div><!-- end of settingsbox -->
+<a id="wrglossary.3504"></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.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>}
+This valueless option provided by <a id="wrglossary.3505"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> creates a new
+<a id="wrglossary.3506"></a><a href="#glo:dual.glossary">glossary</a> type with the label
+<a id="wrglossary.3507"></a><dfn id="glo:opt.glostype.abbreviations"><code class="glostypefmt">abbreviations</code></dfn> using:
+<pre class="compactcodebox"><a id="wrglossary.3508"></a><a href="#glo:newglossary"><code class="csfmt">\newglossary</code></a>[glg-abr]{<a id="wrglossary.3509"></a><a href="#glo:opt.glostype.abbreviations"><code class="glostypefmt">abbreviations</code></a>}{gls-abr}{glo-abr}{<a id="wrglossary.3510"></a><a href="#glo:abbreviationsname"><code class="xtrcsfmt">\abbreviationsname</code></a>}
</pre>
-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
+The label can be accessed with <a id="wrglossary.3511"></a><a href="#glo:glsxtrabbrvtype"><code class="xtrcsfmt">\glsxtrabbrvtype</code></a>, which is
+analogous to <a id="wrglossary.3512"></a><a href="#glo:acronymtype"><code class="csfmt">\acronymtype</code></a>. See <a id="wrglossary.3513"></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.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 -->
+<a id="wrglossary.3514"></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.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
+This option is used to identify the <a id="wrglossary.3515"></a><a href="#glo:dual.glossary">glossaries</a> that contain
+<a id="wrglossary.3516"></a><a href="#glo:idx.acronym">acronyms</a> so that they can have their <a id="wrglossary.3517"></a><a href="#glo:idx.entryformat">entry format</a>
+adjusted by <a id="wrglossary.3518"></a><a href="#glo:setacronymstyle"><code class="csfmt">\setacronymstyle</code></a>. (It also enables <a id="wrglossary.3519"></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.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.
+By default, if the list is empty when <a id="wrglossary.3520"></a><a href="#glo:setacronymstyle"><code class="csfmt">\setacronymstyle</code></a> is used
+then it will automatically add <a id="wrglossary.3521"></a><a href="#glo:acronymtype"><code class="csfmt">\acronymtype</code></a> to the list.
<p>
-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}
+If you have other lists of <a id="wrglossary.3522"></a><a href="#glo:idx.acronym">acronyms</a>, you can specify them as
+a comma-separated list in the value of <a id="wrglossary.3523"></a><a href="#glo:opt.acronymlists"><span class="styoptfmt">acronymlists</span></a>. For
+example, if you use the <a id="wrglossary.3524"></a><a href="#glo:opt.acronym"><span class="styoptfmt">acronym</span></a> package option but you also
+want the <a id="wrglossary.3525"></a><a href="#glo:opt.glostype.main"><code class="glostypefmt">main</code></a> glossary to also contain a list of
+<a id="wrglossary.3526"></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.3527"></a><a href="#glo:opt.acronym"><span class="styoptfmt">acronym</span></a>,<a id="wrglossary.3528"></a><a href="#glo:opt.acronymlists"><span class="styoptfmt">acronymlists</span></a><span class="optfmt">=<a id="wrglossary.3529"></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.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>]
+No check is performed to determine if the listed <a id="wrglossary.3530"></a><a href="#glo:dual.glossary">glossaries</a> exist,
+so you can add <a id="wrglossary.3531"></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.3532"></a><a href="#glo:opt.acronym"><span class="styoptfmt">acronym</span></a>,<a id="wrglossary.3533"></a><a href="#glo:opt.acronymlists"><span class="styoptfmt">acronymlists</span></a><span class="optfmt">={<a id="wrglossary.3534"></a><a href="#glo:opt.glostype.main"><code class="glostypefmt">main</code></a>,acronym2}</span>]
{glossaries}
-<a id="wrglossary.3541"></a><a href="#glo:newglossary"><code class="csfmt">\newglossary</code></a>[alg2]{acronym2}{acr2}{acn2}<span class="comment">% </span>
+<a id="wrglossary.3535"></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.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 -->
+<a id="wrglossary.3536"></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.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:
+instead of or in addition to the <a id="wrglossary.3537"></a><a href="#glo:opt.acronymlists"><span class="styoptfmt">acronymlists</span></a> option.
+This will add the <a id="wrglossary.3538"></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.3539"></a><a href="#glo:dual.glossary">glossaries</a> that are identified as lists of <a id="wrglossary.3540"></a><a href="#glo:idx.acronym">acronyms</a>.
+To replace the list of <a id="wrglossary.3541"></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.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 -->
+<a id="wrglossary.3542"></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.3549"></a><a href="#glo:setacronymstyle"><code class="csfmt">\setacronymstyle</code></a>
+If the list is changed after <a id="wrglossary.3543"></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.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
+<a id="wrglossary.3544"></a><a href="#glo:setacronymstyle"><code class="csfmt">\setacronymstyle</code></a> occurring in a package that loads
+<a id="wrglossary.3545"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a>), you will need to set the <a id="wrglossary.3546"></a><a href="#glo:idx.entryformat">entry format</a> to
match the style:
-<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 class="compactcodebox"><a id="wrglossary.3547"></a><a href="#glo:DeclareAcronymList"><code class="csfmt">\DeclareAcronymList</code></a>{<span class="meta">〈<em class="metainner">glossary-label</em>〉</span>}
+<a id="wrglossary.3548"></a><a href="#glo:defglsentryfmt"><code class="csfmt">\defglsentryfmt</code></a>[<span class="meta">〈<em class="metainner">glossary-label</em>〉</span>]{<a id="wrglossary.3549"></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.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:
+You can determine if a <a id="wrglossary.3550"></a><a href="#glo:dual.glossary">glossary</a> has been identified as being a list
+of <a id="wrglossary.3551"></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.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 -->
+<a id="wrglossary.3552"></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.3559"></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.3553"></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.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.
+This option and associated commands are incompatible with <a id="wrglossary.3554"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span>’s</a>
+<a id="wrglossary.3555"></a><a href="#glo:idx.abbreviation"><span class="xtrfmt">abbreviation</span></a> mechanism. Lists of <a id="wrglossary.3556"></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.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 -->
+<a id="wrglossary.3557"></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.3564"></a><a href="#glo:idx.acronym">acronyms</a>. See §<a href="#sec:acronyms">6</a> for further details.
+for <a id="wrglossary.3558"></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.3565"></a><code class="code"><dfn id="glo:DefineAcronymSynonyms"><code class="csfmt">\DefineAcronymSynonyms</code></dfn></code></div><!-- end of pinnedbox -->
+<a id="wrglossary.3559"></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.3566"></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.3560"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a></div><!-- end of informationtitle -->
-The <a id="wrglossary.3567"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package provides additional shortcuts.
+The <a id="wrglossary.3561"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package provides additional shortcuts.
</div><!-- end of information -->
<p>
@@ -11776,99 +11785,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.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>
+If you want to change the <a id="wrglossary.3562"></a><a href="#glo:idx.acronymstyle">acronym style</a>, use <a id="wrglossary.3563"></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.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 -->
+<a id="wrglossary.3564"></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.3571"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a> to allow a description.
+This option changed the definition of <a id="wrglossary.3565"></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.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 class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.3566"></a><a href="#glo:setacronymstyle"><code class="csfmt">\setacronymstyle</code></a>{<a id="wrglossary.3567"></a><a href="#glo:opt.acrstyle.long-short-desc"><span class="acrstylefmt">long-short-desc</span></a>}
</pre>
-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>}
+or (with <a id="wrglossary.3568"></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.3569"></a><a href="#glo:setacronymstyle"><code class="csfmt">\setacronymstyle</code></a>{<a id="wrglossary.3570"></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.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>}
+or (with <a id="wrglossary.3571"></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.3572"></a><a href="#glo:setacronymstyle"><code class="csfmt">\setacronymstyle</code></a>{<a id="wrglossary.3573"></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.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>}
+or (with <a id="wrglossary.3574"></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.3575"></a><a href="#glo:setacronymstyle"><code class="csfmt">\setacronymstyle</code></a>{<a id="wrglossary.3576"></a><a href="#glo:opt.acrstyle.footnote-desc"><span class="acrstylefmt">footnote-desc</span></a>}
</pre>
-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>}
+or (with <a id="wrglossary.3577"></a><a href="#glo:opt.footnote"><span class="styoptfmt">footnote</span></a> and <a id="wrglossary.3578"></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.3579"></a><a href="#glo:setacronymstyle"><code class="csfmt">\setacronymstyle</code></a>{<a id="wrglossary.3580"></a><a href="#glo:opt.acrstyle.footnote-sc-desc"><span class="acrstylefmt">footnote-sc-desc</span></a>}
</pre>
-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>}
+or (with <a id="wrglossary.3581"></a><a href="#glo:opt.footnote"><span class="styoptfmt">footnote</span></a> and <a id="wrglossary.3582"></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.3583"></a><a href="#glo:setacronymstyle"><code class="csfmt">\setacronymstyle</code></a>{<a id="wrglossary.3584"></a><a href="#glo:opt.acrstyle.footnote-sm-desc"><span class="acrstylefmt">footnote-sm-desc</span></a>}
</pre>
-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>}
+or (with <a id="wrglossary.3585"></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.3586"></a><a href="#glo:setacronymstyle"><code class="csfmt">\setacronymstyle</code></a>{<a id="wrglossary.3587"></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.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 -->
+<a id="wrglossary.3588"></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.3595"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a> and the way that acronyms are displayed.
+<a id="wrglossary.3589"></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.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 class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.3590"></a><a href="#glo:setacronymstyle"><code class="csfmt">\setacronymstyle</code></a>{<a id="wrglossary.3591"></a><a href="#glo:opt.acrstyle.long-sc-short"><span class="acrstylefmt">long-sc-short</span></a>}
</pre>
-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>}
+or (with <a id="wrglossary.3592"></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.3593"></a><a href="#glo:setacronymstyle"><code class="csfmt">\setacronymstyle</code></a>{<a id="wrglossary.3594"></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.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>}
+or (with <a id="wrglossary.3595"></a><a href="#glo:opt.description"><span class="styoptfmt">description</span></a> and <a id="wrglossary.3596"></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.3597"></a><a href="#glo:setacronymstyle"><code class="csfmt">\setacronymstyle</code></a>{<a id="wrglossary.3598"></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.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 -->
+<a id="wrglossary.3599"></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.3606"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a> and the way that acronyms are displayed.
+<a id="wrglossary.3600"></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.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 class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.3601"></a><a href="#glo:setacronymstyle"><code class="csfmt">\setacronymstyle</code></a>{<a id="wrglossary.3602"></a><a href="#glo:opt.acrstyle.long-sm-short"><span class="acrstylefmt">long-sm-short</span></a>}
</pre>
-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>}
+or (with <a id="wrglossary.3603"></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.3604"></a><a href="#glo:setacronymstyle"><code class="csfmt">\setacronymstyle</code></a>{<a id="wrglossary.3605"></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.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>}
+or (with <a id="wrglossary.3606"></a><a href="#glo:opt.description"><span class="styoptfmt">description</span></a> and <a id="wrglossary.3607"></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.3608"></a><a href="#glo:setacronymstyle"><code class="csfmt">\setacronymstyle</code></a>{<a id="wrglossary.3609"></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.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 -->
+<a id="wrglossary.3610"></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.3617"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a> and the way that acronyms are displayed.
+<a id="wrglossary.3611"></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.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 class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.3612"></a><a href="#glo:setacronymstyle"><code class="csfmt">\setacronymstyle</code></a>{<a id="wrglossary.3613"></a><a href="#glo:opt.acrstyle.footnote"><span class="acrstylefmt">footnote</span></a>}
</pre>
-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>}
+or (with <a id="wrglossary.3614"></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.3615"></a><a href="#glo:setacronymstyle"><code class="csfmt">\setacronymstyle</code></a>{<a id="wrglossary.3616"></a><a href="#glo:opt.acrstyle.footnote-sc"><span class="acrstylefmt">footnote-sc</span></a>}
</pre>
-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>}
+or (with <a id="wrglossary.3617"></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.3618"></a><a href="#glo:setacronymstyle"><code class="csfmt">\setacronymstyle</code></a>{<a id="wrglossary.3619"></a><a href="#glo:opt.acrstyle.footnote-sm"><span class="acrstylefmt">footnote-sm</span></a>}
</pre>
-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>}
+or (with <a id="wrglossary.3620"></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.3621"></a><a href="#glo:setacronymstyle"><code class="csfmt">\setacronymstyle</code></a>{<a id="wrglossary.3622"></a><a href="#glo:opt.acrstyle.footnote-desc"><span class="acrstylefmt">footnote-desc</span></a>}
</pre>
-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>}
+or (with <a id="wrglossary.3623"></a><a href="#glo:opt.smallcaps"><span class="styoptfmt">smallcaps</span></a> and <a id="wrglossary.3624"></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.3625"></a><a href="#glo:setacronymstyle"><code class="csfmt">\setacronymstyle</code></a>{<a id="wrglossary.3626"></a><a href="#glo:opt.acrstyle.footnote-sc-desc"><span class="acrstylefmt">footnote-sc-desc</span></a>}
</pre>
-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>}
+or (with <a id="wrglossary.3627"></a><a href="#glo:opt.smaller"><span class="styoptfmt">smaller</span></a> and <a id="wrglossary.3628"></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.3629"></a><a href="#glo:setacronymstyle"><code class="csfmt">\setacronymstyle</code></a>{<a id="wrglossary.3630"></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.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 -->
+<a id="wrglossary.3631"></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.3638"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a> so that acronyms are always expanded.
+<a id="wrglossary.3632"></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.3639"></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.3633"></a><a href="#glo:setacronymstyle"><code class="csfmt">\setacronymstyle</code></a>{dua}
</pre>
-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>}
+or (with <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.dua-desc"><span class="acrstylefmt">dua-desc</span></a>}
</pre>
<p>
@@ -11882,47 +11891,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.3643"></a><code class="code"><dfn id="glo:opt.accsupp"><span class="xtrstyoptfmt">accsupp</span></dfn></code></div><!-- end of settingsbox -->
+<a id="wrglossary.3637"></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.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>
+Only available with <a id="wrglossary.3638"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>, this option
+loads the <a id="wrglossary.3639"></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.3640"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> or while <a id="wrglossary.3641"></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.3648"></a><code class="code"><dfn id="glo:opt.prefix"><span class="xtrstyoptfmt">prefix</span></dfn></code></div><!-- end of settingsbox -->
+<a id="wrglossary.3642"></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.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.
+Only available with <a id="wrglossary.3643"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>, this option
+loads the <a id="wrglossary.3644"></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.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 -->
+<a id="wrglossary.3645"></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.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.
+by <a id="wrglossary.3646"></a><a href="#glo:printglossary"><code class="csfmt">\printglossary</code></a> if the <a id="wrglossary.3647"></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.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 -->
+<a id="wrglossary.3648"></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.3655"></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.3649"></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.3656"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span>’s</a> other package option.
+corresponding to <a id="wrglossary.3650"></a><a href="#glo:pkg.mfirstuc"><span class="styfmt">mfirstuc</span>’s</a> other package option.
<p>
-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>
+The default is <a id="wrglossary.3651"></a><a href="#glo:opt.mfirstuc"><span class="styoptfmt">mfirstuc</span></a><span class="optfmt">=unexpanded</span> to safeguard against
+<a id="wrglossary.3652"></a><a href="#glo:idx.glossarystyle">glossary styles</a> that convert the description to
+<a id="wrglossary.3653"></a><a href="#glo:idx.sentencecase">sentence case</a>. With older versions of <a id="wrglossary.3654"></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.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
+affected by the <a id="wrglossary.3655"></a><a href="#glo:dual.casechange">case change</a>, but now, if the entire description is passed
+to <a id="wrglossary.3656"></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.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 -->
+<a id="wrglossary.3657"></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
@@ -11930,7 +11939,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.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 -->
+<a id="wrglossary.3658"></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
@@ -11937,11 +11946,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.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 -->
+<a id="wrglossary.3659"></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.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>
+As a legacy from the precursor <a id="wrglossary.3660"></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.3661"></a><a href="#glo:makeglossary"><code class="csfmt">\makeglossary</code></a>
+and <a id="wrglossary.3662"></a><a href="#glo:cs.glossary"><code class="csfmt">\glossary</code></a>) are redefined in terms of the <a id="wrglossary.3663"></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>)
@@ -11949,43 +11958,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.3670"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> and no longer
+the internal commands provided by <a id="wrglossary.3664"></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.3671"></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.3665"></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.3672"></a><a href="#glo:opt.kernelglossredefs"><span class="styoptfmt">kernelglossredefs</span></a><span class="optfmt">=false</span>.
+<a id="wrglossary.3666"></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.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 -->
+<a id="wrglossary.3667"></a><a id="wrglossary.3668"></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.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
+Don’t redefine <a id="wrglossary.3669"></a><a href="#glo:cs.glossary"><code class="csfmt">\glossary</code></a> and <a id="wrglossary.3670"></a><a href="#glo:makeglossary"><code class="csfmt">\makeglossary</code></a>. If they have
+been previously redefined by <a id="wrglossary.3671"></a><a href="#glo:opt.kernelglossredefs"><span class="styoptfmt">kernelglossredefs</span></a> their original
+definitions (at the time <a id="wrglossary.3672"></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.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 -->
+<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.true"><span class="optfmt">true</span></dfn></code></div><!-- end of optionvaluebox -->
-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
+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>, 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.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 -->
+<a id="wrglossary.3677"></a><a id="wrglossary.3678"></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.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.
+Redefine <a id="wrglossary.3679"></a><a href="#glo:cs.glossary"><code class="csfmt">\glossary</code></a> and <a id="wrglossary.3680"></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.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
+The only glossary-related commands provided by the LaTeX kernel are <a id="wrglossary.3681"></a><a href="#glo:makeglossary"><code class="csfmt">\makeglossary</code></a> and <a id="wrglossary.3682"></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.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
+environments that conflict with <a id="wrglossary.3683"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> (such as
+<a id="wrglossary.3684"></a><a href="#glo:printglossary"><code class="csfmt">\printglossary</code></a> and <a id="wrglossary.3685"></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.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>.)
+mechanisms. (The <a id="wrglossary.3686"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package will override the existing
+definitions of <a id="wrglossary.3687"></a><a href="#glo:printglossary"><code class="csfmt">\printglossary</code></a> and <a id="wrglossary.3688"></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.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>.)
+provides a glossary mechanism. (The <a id="wrglossary.3689"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package does
+check for the <a id="wrglossary.3690"></a><a href="#glo:pkg.doc"><span class="styfmt">doc</span></a> package and patches <a id="wrglossary.3691"></a><a href="#glo:PrintChanges"><code class="csfmt">\PrintChanges</code></a>.)
<p>
</section><!-- end of section sec:pkgopts-other -->
@@ -11995,24 +12004,24 @@
<p>
Some of the options described above may also be set after the
-<a id="wrglossary.3698"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package has been loaded using
+<a id="wrglossary.3692"></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.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 -->
+<a id="wrglossary.3693"></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.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 id="wrglossary.3694"></a><a href="#glo:setupglossaries"><code class="csfmt">\setupglossaries</code></a>: <a id="wrglossary.3695"></a><a href="#glo:opt.xindy"><span class="styoptfmt">xindy</span></a>, <a id="wrglossary.3696"></a><a href="#glo:opt.xindygloss"><span class="styoptfmt">xindygloss</span></a>,
+<a id="wrglossary.3697"></a><a href="#glo:opt.xindynoglsnumbers"><span class="styoptfmt">xindynoglsnumbers</span></a>, <a id="wrglossary.3698"></a><a href="#glo:opt.makeindex"><span class="styoptfmt">makeindex</span></a>,
+<a id="wrglossary.3699"></a><a href="#glo:opt.nolong"><span class="styoptfmt">nolong</span></a>, <a id="wrglossary.3700"></a><a href="#glo:opt.nosuper"><span class="styoptfmt">nosuper</span></a>, <a id="wrglossary.3701"></a><a href="#glo:opt.nolist"><span class="styoptfmt">nolist</span></a>,
+<a id="wrglossary.3702"></a><a href="#glo:opt.notree"><span class="styoptfmt">notree</span></a>, <a id="wrglossary.3703"></a><a href="#glo:opt.nostyles"><span class="styoptfmt">nostyles</span></a>, <a id="wrglossary.3704"></a><a href="#glo:opt.nomain"><span class="styoptfmt">nomain</span></a>,
+<a id="wrglossary.3705"></a><a href="#glo:opt.compatible-2.07"><span class="styoptfmt">compatible-2.07</span></a>, <a id="wrglossary.3706"></a><a href="#glo:opt.translate"><span class="styoptfmt">translate</span></a>, <a id="wrglossary.3707"></a><a href="#glo:opt.notranslate"><span class="styoptfmt">notranslate</span></a>,
+<a id="wrglossary.3708"></a><a href="#glo:opt.languages"><span class="styoptfmt">languages</span></a>, <a id="wrglossary.3709"></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.3710"></a><a href="#glo:opt.xindy"><span class="styoptfmt">xindy</span></a> sub-options which can be set
+using commands like <a id="wrglossary.3711"></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.3718"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> otherwise you might
+possible after loading <a id="wrglossary.3712"></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.
@@ -12019,9 +12028,9 @@
</div><!-- end of important -->
<p>
-<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 -->
+<div class="information"><div class="informationtitle"><a id="wrglossary.3713"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a></div><!-- end of informationtitle -->
-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>
+With <a id="wrglossary.3714"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>, use <a id="wrglossary.3715"></a><a href="#glo:glossariesextrasetup"><code class="xtrcsfmt">\glossariesextrasetup</code></a>
instead.
</div><!-- end of information -->
@@ -12034,16 +12043,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.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
+In the <a id="wrglossary.3716"></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.3717"></a><a href="#glo:dual.glossary">glossary</a> (or <a id="wrglossary.3718"></a><a href="#glo:dual.glossary">glossaries</a>). The available options with
+both <a id="wrglossary.3719"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> and <a id="wrglossary.3720"></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.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
+<a id="wrglossary.3721"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> and <a id="wrglossary.3722"></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.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
+If you don’t need to display any <a id="wrglossary.3723"></a><a href="#glo:dual.glossary">glossaries</a>, for example, if you are
+just using the <a id="wrglossary.3724"></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>
@@ -12055,15 +12064,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.3731"></a><code class="code"><dfn id="glo:makenoidxglossaries"><code class="csfmt">\makenoidxglossaries</code></dfn></code>
+<a id="wrglossary.3725"></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.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>
+must be placed in the <a id="wrglossary.3726"></a><a href="#glo:idx.preamble/document">document preamble</a>. This sets up the internal commands
+required to make <a id="wrglossary.3727"></a><a href="#glo:idx.opt.noidx">Option 1</a> work.
+<strong class="strong">If you omit <a id="wrglossary.3728"></a><a href="#glo:makenoidxglossaries"><code class="csfmt">\makenoidxglossaries</code></a> none of
+the <a id="wrglossary.3729"></a><a href="#glo:dual.glossary">glossaries</a> will be displayed.</strong>
<p>
</section><!-- end of section sec:setupopt1 -->
@@ -12074,104 +12083,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.3736"></a><code class="code"><dfn id="glo:makeglossaries"><code class="csfmt">\makeglossaries</code></dfn></code>
+<a id="wrglossary.3730"></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.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>)
+must be placed in the <a id="wrglossary.3731"></a><a href="#glo:idx.preamble/document">document preamble</a> in order to create the customised
+<a id="wrglossary.3732"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> (<a id="wrglossary.3733"></a><a href="#glo:ext.ist"><span class="extfmt">ist</span></a>) or <a id="wrglossary.3734"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> (<a id="wrglossary.3735"></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.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>
+<a id="wrglossary.3736"></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.3737"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a> none of
+the <a id="wrglossary.3738"></a><a href="#glo:dual.indexingfile">indexing files</a> will be created.</strong>
<p>
-<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 -->
+<div class="information"><div class="informationtitle"><a id="wrglossary.3739"></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.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
+If you are using <a id="wrglossary.3740"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a>, <a id="wrglossary.3741"></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.3748"></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.3742"></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.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
+Note that some of the commands provided by the <a id="wrglossary.3743"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a>
+package must not be used after <a id="wrglossary.3744"></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.3751"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a> you will generate
+to use those commands after <a id="wrglossary.3745"></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.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.
+<a id="wrglossary.3746"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a> because they require the associated
+<a id="wrglossary.3747"></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.3754"></a><a href="#glo:dual.indexing">indexing</a> option may be chosen that doesn’t require
+different <a id="wrglossary.3748"></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.3755"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a> command internally uses:
+The <a id="wrglossary.3749"></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.3756"></a><code class="code"><dfn id="glo:writeist"><code class="csfmt">\writeist</code></dfn></code></div><!-- end of pinnedbox -->
+<a id="wrglossary.3750"></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.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
+to create the custom <a id="wrglossary.3751"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>/<a id="wrglossary.3752"></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.3753"></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.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
+<code class="code"><a id="wrglossary.3754"></a><a href="#glo:jobname"><code class="csfmt">\jobname</code></a>.<a id="wrglossary.3755"></a><a href="#glo:ext.ist"><span class="extfmt">ist</span></a></code> (<a id="wrglossary.3756"></a><a href="#glo:idx.opt.mkidx">Option 2</a>) or
+<code class="code"><a id="wrglossary.3757"></a><a href="#glo:jobname"><code class="csfmt">\jobname</code></a>.<a id="wrglossary.3758"></a><a href="#glo:ext.xdy"><span class="extfmt">xdy</span></a></code> (<a id="wrglossary.3759"></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.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 -->
+<a id="wrglossary.3760"></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.3767"></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.3761"></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.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 -->
+<a id="wrglossary.3762"></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.3769"></a><code class="code"><dfn id="glo:glswrite"><code class="csfmt">\glswrite</code></dfn></code></div><!-- end of pinnedbox -->
+<a id="wrglossary.3763"></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.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.
+Note that this register is defined by <a id="wrglossary.3764"></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.3765"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>
+nor <a id="wrglossary.3766"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a> is required.
<p>
-If you use the <a id="wrglossary.3773"></a><a href="#glo:GlsSetWriteIstHook"><code class="csfmt">\GlsSetWriteIstHook</code></a> hook to write extra
+If you use the <a id="wrglossary.3767"></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.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>
+syntax for the desired <a id="wrglossary.3768"></a><a href="#glo:dual.indexingapp">indexing application</a>. For example, with
+<a id="wrglossary.3769"></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.3770"></a><a href="#glo:GlsSetWriteIstHook"><code class="csfmt">\GlsSetWriteIstHook</code></a>{<span class="comment">% </span>
+ <a id="wrglossary.3771"></a><a href="#glo:write"><code class="csfmt">\write</code></a><a id="wrglossary.3772"></a><a href="#glo:glswrite"><code class="csfmt">\glswrite</code></a>{page_precedence "arnAR"}<span class="comment">% </span>
+ <a id="wrglossary.3773"></a><a href="#glo:write"><code class="csfmt">\write</code></a><a id="wrglossary.3774"></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.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>.
+This changes the <a id="wrglossary.3775"></a><a href="#glo:idx.pageprecedence">page precedence</a> and the maximum line length
+used by <a id="wrglossary.3776"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>.
<p>
-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
+Remember that if you switch to <a id="wrglossary.3777"></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.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:
+You can suppress the creation of the customised <a id="wrglossary.3778"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>
+or <a id="wrglossary.3779"></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.3786"></a><code class="code"><dfn id="glo:noist"><code class="csfmt">\noist</code></dfn></code></div><!-- end of pinnedbox -->
+<a id="wrglossary.3780"></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.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.
+options and commands provided by the <a id="wrglossary.3781"></a><a href="#glo:pkg.glossaries"><span class="styfmt">glossaries</span></a> package.
+This command sets <a id="wrglossary.3782"></a><a href="#glo:writeist"><code class="csfmt">\writeist</code></a> to <a id="wrglossary.3783"></a><a href="#glo:relax"><code class="csfmt">\relax</code></a> (making it do
+nothing) but will also update the <a id="wrglossary.3784"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>
+<a id="wrglossary.3785"></a><a href="#glo:idx.xindyattr">attribute list</a> if applicable.
<p>
-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.
+If you have a custom <a id="wrglossary.3786"></a><a href="#glo:ext.xdy"><span class="extfmt">xdy</span></a> file created when using
+<a id="wrglossary.3787"></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.3788"></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
@@ -12178,50 +12187,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.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
+Each <a id="wrglossary.3789"></a><a href="#glo:idx.glossaryentry">glossary entry</a> is assigned a <a id="wrglossary.3790"></a><a href="#glo:locationlist">number list</a> that lists all
+the <a id="wrglossary.3791"></a><a href="#glo:dual.entrylocation">locations</a> in the document where that <a id="wrglossary.3792"></a><a href="#glo:idx.glossaryentry">entry</a> was used. By default,
+the <a id="wrglossary.3793"></a><a href="#glo:dual.entrylocation">location</a> refers to the page number but this may be overridden
+using the <a id="wrglossary.3794"></a><a href="#glo:opt.counter"><span class="styoptfmt">counter</span></a> package option. The default form of
+the <a id="wrglossary.3795"></a><a href="#glo:dual.entrylocation">location</a> number assumes a full stop <a id="wrglossary.3796"></a><a href="#glo:idx.compositor">compositor</a> (for example, 1.2),
+but if your <a id="wrglossary.3797"></a><a href="#glo:dual.entrylocation">location</a> numbers use a different <a id="wrglossary.3798"></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.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 -->
+<a id="wrglossary.3799"></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.3806"></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.3800"></a><a href="#glo:glsSetCompositor"><code class="csfmt">\glsSetCompositor</code></a>{-}
</pre>
-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>
+This command must not be used after <a id="wrglossary.3801"></a><a href="#glo:makeglossaries"><code class="csfmt">\makeglossaries</code></a>. Note that
+with <a id="wrglossary.3802"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a>, any <a id="wrglossary.3803"></a><a href="#glo:dual.entrylocation">locations</a> with the wrong <a id="wrglossary.3804"></a><a href="#glo:idx.compositor">compositor</a>
(or one that hasn’t been correctly identified with
-<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 id="wrglossary.3805"></a><a href="#glo:glsSetCompositor"><code class="csfmt">\glsSetCompositor</code></a>) will cause <a id="wrglossary.3806"></a><a href="#glo:app.makeindex"><span class="appfmt">makeindex</span></a> to reject the
+<a id="wrglossary.3807"></a><a href="#glo:dual.entrylocation">location</a> with an invalid number/digit message. As from
+v4.50, <a id="wrglossary.3808"></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.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
+<a id="wrglossary.3809"></a><a href="#glo:dual.entrylocation">location</a> in the <a id="wrglossary.3810"></a><a href="#glo:locationlist">number list</a>. See the information about
+<a id="wrglossary.3811"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span>’s</a> <a id="wrglossary.3812"></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.3819"></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.3813"></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.3820"></a><a href="#glo:app.makeglossaries"><span class="appfmt">makeglossaries</span></a> will check for and will provided
+something that <a id="wrglossary.3814"></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.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
+If you use <a id="wrglossary.3815"></a><a href="#glo:idx.opt.xdy">Option 3</a>, you can have a different <a id="wrglossary.3816"></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.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>
+<a id="wrglossary.3817"></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.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
+This command is only available with <a id="wrglossary.3818"></a><a href="#glo:app.xindy"><span class="appfmt">xindy</span></a>. For example, if you want
+<a id="wrglossary.3819"></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.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 class="codebox"><div class="codeboxtitle"><a href="#glo:sym.code"><span title="Input" class="icon">🖹</span></a></div><a id="wrglossary.3820"></a><a href="#glo:glsSetCompositor"><code class="csfmt">\glsSetCompositor</code></a>{.}<a id="wrglossary.3821"></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.3828"></a><a href="#glo:locationlist">number lists</a>.
+<a id="wrglossary.3822"></a><a href="#glo:locationlist">number lists</a>.
<p>
</section><!-- end of section sec:setupopt23 -->
@@ -12230,71 +12239,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.3829"></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.3823"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a></div><!-- end of informationtitle -->
-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>
+If you want to use <a id="wrglossary.3824"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>, entries must be defined in
+<a id="wrglossary.3825"></a><a href="#glo:ext.bib"><span class="extfmt">bib</span></a> files using the syntax described in the <a id="wrglossary.3826"></a><a href="#glo:app.bib2gls"><span class="appfmt">bib2gls</span></a>
user manual.
</div><!-- end of information -->
<p>
-<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
+<a id="wrglossary.3827"></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.3828"></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.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>.
+<a id="wrglossary.3829"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a> can also be used in the optional argument of
+<a id="wrglossary.3830"></a><a href="#glo:newacronym"><code class="csfmt">\newacronym</code></a>, although some of them, such as <a id="wrglossary.3831"></a><a href="#glo:opt.gloskey.first"><span class="csoptfmt">first</span></a> and
+<a id="wrglossary.3832"></a><a href="#glo:opt.gloskey.plural"><span class="csoptfmt">plural</span></a>, interfere with the <a id="wrglossary.3833"></a><a href="#glo:idx.acronymstyle">acronym styles</a>.
<p>
-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>
+All <a id="wrglossary.3834"></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.3835"></a><a href="#glo:idx.preamble/document">document preamble</a> to ensure this. In fact, some
+commands such as <a id="wrglossary.3836"></a><a href="#glo:longnewglossaryentry"><code class="csfmt">\longnewglossaryentry</code></a>
+may only be used in the <a id="wrglossary.3837"></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.3838"></a><a href="#glo:idx.glossaryentry">entries</a> within the
+document instead of in the <a id="wrglossary.3839"></a><a href="#glo:idx.preamble/document">preamble</a>. (The <a id="wrglossary.3840"></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.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>.
+<a id="wrglossary.3841"></a><a href="#glo:idx.opt.noidx">Option 1</a> enforces the <a id="wrglossary.3842"></a><a href="#glo:idx.preamble/document">preamble</a>-only restriction on
+<a id="wrglossary.3843"></a><a href="#glo:newglossaryentry"><code class="csfmt">\newglossaryentry</code></a>. <a id="wrglossary.3844"></a><a href="#glo:idx.opt.b2g">Option 4</a> requires that definitions are provided
+in <a id="wrglossary.3845"></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.3846"></a><a href="#glo:idx.preamble/document">preamble</a>-only
+definitions or the use of the <a id="wrglossary.3847"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package option
+<a id="wrglossary.3848"></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.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
+Bear in mind that with <a id="wrglossary.3849"></a><a href="#glo:opt.docdef"><span class="xtrstyoptfmt">docdef</span></a><span class="optfmt">=restricted</span>, the
+<a id="wrglossary.3850"></a><a href="#glo:idx.glossaryentry">entries</a> must be defined before any <a id="wrglossary.3851"></a><a href="#glo:idx.glossaryentry">entries</a> are used,
+including when they are displayed in the <a id="wrglossary.3852"></a><a href="#glo:dual.glossary">glossary</a> (for example, with
+<a id="wrglossary.3853"></a><a href="#glo:printunsrtglossary"><code class="xtrcsfmt">\printunsrtglossary</code></a>) or where they appear in the
+<a id="wrglossary.3854"></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.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
+Only those <a id="wrglossary.3855"></a><a href="#glo:idx.glossaryentry">entries</a> that are <a id="wrglossary.3856"></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.3863"></a><a href="#glo:dual.glossary">glossary</a>. See
+§<a href="#sec:crossref">11</a>) will appear in the <a id="wrglossary.3857"></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.3864"></a><a href="#glo:dual.glossary">glossary</a>.
+<a id="wrglossary.3858"></a><a href="#glo:dual.glossary">glossary</a>.
<p>
-New <a id="wrglossary.3865"></a><a href="#glo:idx.glossaryentry">glossary entries</a> are defined using the command:
+New <a id="wrglossary.3859"></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.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 -->
+<a id="wrglossary.3860"></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.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
+any commas (<a id="wrglossary.3861"></a><a href="#glo:idx.sym.comma"><code class="code">,</code></a>) or equal signs (<a id="wrglossary.3862"></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.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 -->
+<a id="wrglossary.3863"></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.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>).
+<a id="wrglossary.3864"></a><a href="#glo:idx.preamble/document">preamble</a> (regardless of <a id="wrglossary.3865"></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.
@@ -12301,39 +12310,39 @@
</div><!-- end of warning -->
<p>
-<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,
+<a id="wrglossary.3866"></a><a href="#glo:longnewglossaryentry"><code class="csfmt">\longnewglossaryentry</code></a> will remove trailing spaces in the
+description (via <a id="wrglossary.3867"></a><a href="#glo:unskip"><code class="csfmt">\unskip</code></a>) but won’t remove leading spaces. This
+command also appends <a id="wrglossary.3868"></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.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>.
+description). The <a id="wrglossary.3869"></a><a href="#glo:pkg.glossaries-extra"><span class="styfmt">glossaries-extra</span></a> package provides a starred
+version of <a id="wrglossary.3870"></a><a href="#glo:longnewglossaryentry"><code class="csfmt">\longnewglossaryentry</code></a> that doesn’t append either
+<a id="wrglossary.3871"></a><a href="#glo:unskip"><code class="csfmt">\unskip</code></a> or <a id="wrglossary.3872"></a><a href="#glo:nopostdesc"><code class="csfmt">\nopostdesc</code></a>.
<p>
-There are also commands that will only define the <a id="wrglossary.3879"></a><a href="#glo:idx.glossaryentry">entry</a> if it
+There are also commands that will only define the <a id="wrglossary.3873"></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.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 -->
+<a id="wrglossary.3874"></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.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 -->
+<a id="wrglossary.3875"></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.3882"></a><a href="#glo:idx.preamble/document">preamble</a>-only commands.)
+(These are both <a id="wrglossary.3876"></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.3883"></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.3877"></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.3884"></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.3878"></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.3885"></a><a href="#glo:dual.utf8">UTF-8</a> characters in the label.
+be able to use <a id="wrglossary.3879"></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 -->
@@ Diff output truncated at 1234567 characters. @@
More information about the tex-live-commits
mailing list.