summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/glossaries/glossariesbegin.html
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/latex/glossaries/glossariesbegin.html')
-rw-r--r--Master/texmf-dist/doc/latex/glossaries/glossariesbegin.html614
1 files changed, 310 insertions, 304 deletions
diff --git a/Master/texmf-dist/doc/latex/glossaries/glossariesbegin.html b/Master/texmf-dist/doc/latex/glossaries/glossariesbegin.html
index ea9e0762cbf..8933ab09d4e 100644
--- a/Master/texmf-dist/doc/latex/glossaries/glossariesbegin.html
+++ b/Master/texmf-dist/doc/latex/glossaries/glossariesbegin.html
@@ -255,7 +255,7 @@ span#textcolor40{color:#00FF00}
>
<!--l. 55--><p class="noindent" >
</p><!--l. 55--><p class="noindent" ><span
-class="cmr-17">The glossaries package v4.39: a guide for</span>
+class="cmr-17">The glossaries package v4.40: a guide for</span>
<span
class="cmr-17">beginners</span>
</p>
@@ -268,7 +268,7 @@ class="td11"> <span
class="cmr-12">Nicola L.C. Talbot </span></td></tr></table>
</div>
<!--l. 55--><p class="noindent" ><span
-class="cmr-12">2018-05-23</span></p></div>
+class="cmr-12">2018-06-01</span></p></div>
<div
class="abstract"
>
@@ -422,7 +422,13 @@ class="cmtt-10">.log </span>file and search
for the line that starts with <span
class="cmtt-10">Package: glossaries </span>followed by a date and
version.)
-</p><!--l. 144--><p class="indent" > Abbreviations are slightly different if you use the extension package <span
+</p><!--l. 144--><p class="indent" > <div class="important" title="Important Note"> Be careful of fragile commands. If a command causes a problem when used in one
+of the <span
+class="cmtt-10">\newglossaryentry </span>fields, consider adding <span
+class="cmtt-10">\glsnoexpandfields </span>before you
+start defining your entries. </div>
+</p><!--l. 148--><p class="noindent" >
+</p><!--l. 150--><p class="indent" > Abbreviations are slightly different if you use the extension package <span
class="cmss-10">glossaries-extra</span><a
id="dx1-2006"></a>
(which needs to be installed separately):
@@ -439,7 +445,7 @@ class="cmss-10">glossaries-extra</span><a
&#x00A0;<br />&#x00A0;First&#x00A0;use:&#x00A0;\gls{svm}.&#x00A0;Second&#x00A0;use:&#x00A0;\gls{svm}.
&#x00A0;<br />&#x00A0;\end{document}
</div>
-<!--l. 158--><p class="nopar" > If you still want to use <span
+<!--l. 164--><p class="nopar" > If you still want to use <span
class="cmtt-10">\newacronym </span>(rather than <span
class="cmtt-10">\newabbreviation</span>) then you need
the optional argument of <span
@@ -457,13 +463,13 @@ class="cmtt-10">\setabbreviationstyle</span>:
&#x00A0;<br />&#x00A0;First&#x00A0;use:&#x00A0;\gls{svm}.&#x00A0;Second&#x00A0;use:&#x00A0;\gls{svm}.
&#x00A0;<br />&#x00A0;\end{document}
</div>
-<!--l. 174--><p class="nopar" >
-</p><!--l. 175--><p class="indent" > <div class="important" title="Important Note"> You can&#8217;t use <span
+<!--l. 180--><p class="nopar" >
+</p><!--l. 181--><p class="indent" > <div class="important" title="Important Note"> You can&#8217;t use <span
class="cmtt-10">\setacronymstyle </span>with <span
class="cmss-10">glossaries-extra</span><a
id="dx1-2007"></a>. </div>
-</p><!--l. 177--><p class="noindent" >
-</p><!--l. 179--><p class="indent" > If you like, you can put all your definitions in another file (for example,
+</p><!--l. 183--><p class="noindent" >
+</p><!--l. 185--><p class="indent" > If you like, you can put all your definitions in another file (for example,
<span
class="cmtt-10">defns.tex</span>) and load that file in the preamble using <span
class="cmtt-10">\loadglsentries </span>with the
@@ -475,7 +481,7 @@ filename as the argument. For example:
<div class="verbatim" id="verbatim-5">
\loadglsentries{defns}
</div>
-<!--l. 184--><p class="nopar" > If you find you have a really large number of definitions that are hard to manage in a
+<!--l. 190--><p class="nopar" > If you find you have a really large number of definitions that are hard to manage in a
<span
class="cmtt-10">.tex </span>file, you might want to have a look at <span
class="cmtt-10">bib2gls</span><a
@@ -483,7 +489,7 @@ class="cmtt-10">bib2gls</span><a
requires a <span
class="cmtt-10">.bib </span>format instead that can be managed by an application such as
JabRef.
-</p><!--l. 191--><p class="indent" > Don&#8217;t try inserting formatting commands into the definitions as they can interfere
+</p><!--l. 197--><p class="indent" > Don&#8217;t try inserting formatting commands into the definitions as they can interfere
with the underlying mechanism. Instead, the formatting should be done by the
style. For example, suppose I&#x00A0;want to replace <span
class="cmtt-10">SVM </span>with <span class="obeylines-h"><span class="verb"><span
@@ -505,7 +511,7 @@ style):
&#x00A0;<br />&#x00A0;First&#x00A0;use:&#x00A0;\gls{svm}.&#x00A0;Second&#x00A0;use:&#x00A0;\gls{svm}.
&#x00A0;<br />&#x00A0;\end{document}
</div>
-<!--l. 209--><p class="nopar" > The abbreviation styles have a different naming scheme with <span
+<!--l. 215--><p class="nopar" > The abbreviation styles have a different naming scheme with <span
class="cmss-10">glossaries-extra</span><a
id="dx1-2009"></a>:
@@ -521,7 +527,7 @@ class="cmss-10">glossaries-extra</span><a
&#x00A0;<br />&#x00A0;First&#x00A0;use:&#x00A0;\gls{svm}.&#x00A0;Second&#x00A0;use:&#x00A0;\gls{svm}.
&#x00A0;<br />&#x00A0;\end{document}
</div>
-<!--l. 224--><p class="nopar" > With <span
+<!--l. 230--><p class="nopar" > With <span
class="cmss-10">glossaries-extra</span><a
id="dx1-2010"></a> you can have multiple abbreviation styles for different
categories. Many of these styles have their own associated formatting commands that
@@ -556,22 +562,22 @@ can be redefined for minor adjustments. For example:
&#x00A0;<br />&#x00A0;Next&#x00A0;use:&#x00A0;\gls{svm},&#x00A0;\gls{cbot}.
&#x00A0;<br />&#x00A0;\end{document}
</div>
-<!--l. 262--><p class="nopar" > This produces:
+<!--l. 268--><p class="nopar" > This produces:
</p><div class="quote">
- <!--l. 265--><p class="noindent" >First use: support vector machine (<span
+ <!--l. 271--><p class="noindent" >First use: support vector machine (<span
class="cmcsc-10"><span
class="small-caps">s</span><span
class="small-caps">v</span><span
class="small-caps">m</span></span>), <span
class="cmti-10">Clostridium botulinum</span>.
- </p><!--l. 268--><p class="noindent" >Next use: <span
+ </p><!--l. 274--><p class="noindent" >Next use: <span
class="cmcsc-10"><span
class="small-caps">s</span><span
class="small-caps">v</span><span
class="small-caps">m</span></span>, <span
class="cmti-10">C.</span><span
class="cmti-10">&#x00A0;botulinum</span>.</p></div>
-<!--l. 271--><p class="indent" > As you can hopefully see from the above examples, there are two main ways of
+<!--l. 277--><p class="indent" > As you can hopefully see from the above examples, there are two main ways of
defining a term: as a general entry (<span
class="cmtt-10">\newglossaryentry</span>) or as an abbreviation
(<span
@@ -579,7 +585,7 @@ class="cmtt-10">\newacronym </span>or, with <span
class="cmss-10">glossaries-extra</span><a
id="dx1-2011"></a>, <span
class="cmtt-10">\newabbreviation</span>).
-</p><!--l. 276--><p class="indent" > Regardless of the method of defining a term, the term is always given a label. In
+</p><!--l. 282--><p class="indent" > Regardless of the method of defining a term, the term is always given a label. In
@@ -608,7 +614,7 @@ class="cmss-10">inputenc</span><a
id="dx1-2013"></a> (for example, &eacute; or &szlig;) or things will go horribly wrong. This warning
only applies to the label. It doesn&#8217;t apply to the text that appears in the
document.
-</p><!--l. 291--><p class="indent" > <div class="important" title="Important Note"> Don&#8217;t use <span
+</p><!--l. 297--><p class="indent" > <div class="important" title="Important Note"> Don&#8217;t use <span
class="cmtt-10">\gls </span>in chapter or section headings as it can have some unpleasant
side-effects. Instead use <span
class="cmtt-10">\glsentrytext </span>for regular entries and one of <span
@@ -624,8 +630,8 @@ class="cmtt-10">\glsfmtshort</span>
class="cmtt-10">{</span>&#x27E8;<span
class="cmti-10">label</span>&#x27E9;<span
class="cmtt-10">}</span>. </div>
-</p><!--l. 298--><p class="noindent" >
-</p><!--l. 300--><p class="indent" > The above examples are reasonably straightforward. The difficulty comes if you
+</p><!--l. 304--><p class="noindent" >
+</p><!--l. 306--><p class="indent" > The above examples are reasonably straightforward. The difficulty comes if you
want to display a <span
class="cmti-10">sorted </span>list of all the entries you have used in the document. The
<span
@@ -652,17 +658,17 @@ entries:
&#x00A0;<br />&#x00A0;\printunsrtglossaries&#x00A0;%&#x00A0;list&#x00A0;all&#x00A0;entries
&#x00A0;<br />&#x00A0;\end{document}
</div>
-<!--l. 326--><p class="nopar" > However this method doesn&#8217;t sort the entries (they&#8217;re listed in order of definition)
+<!--l. 332--><p class="nopar" > However this method doesn&#8217;t sort the entries (they&#8217;re listed in order of definition)
and it will display all the defined entries, regardless of whether or not you&#8217;ve used
them all in the document, so &#8220;turnip&#8221; appears in the glossary even though there&#8217;s no
<span class="obeylines-h"><span class="verb"><span
class="cmtt-10">\gls{turnip}</span></span></span> (or similar) in the document.
-</p><!--l. 333--><p class="indent" > The <span
+</p><!--l. 339--><p class="indent" > The <span
class="cmss-10">sort=none</span><a
id="dx1-2016"></a> option isn&#8217;t essential in this case (there&#8217;s no other sort option
available for this document), but it prevents the automatic construction of the sort
value and so slightly improves the document build time.
-</p><!--l. 338--><p class="indent" > Note that this example document uses the same command (<span
+</p><!--l. 344--><p class="indent" > Note that this example document uses the same command (<span
class="cmtt-10">\printunsrtglossaries</span>)
that&#8217;s used with <span
class="cmtt-10">bib2gls</span><a
@@ -675,7 +681,7 @@ class="cmss-10">record</span><a
id="dx1-2019"></a> package option and one or more instances of <span
class="cmtt-10">\GlsXtrLoadResources </span>in the
preamble (see below).
-</p><!--l. 344--><p class="indent" > Most users prefer to have an automatically sorted list that only contains entries
+</p><!--l. 350--><p class="indent" > Most users prefer to have an automatically sorted list that only contains entries
that have been used in the document. The <span
class="cmss-10">glossaries </span>package provides three options:
use <span class="TEX">T<span
@@ -695,7 +701,7 @@ class="cmtt-10">bib2gls</span><a
id="dx1-2023"></a>
(<a
href="#option4">Option&#x00A0;4</a>).
-</p><!--l. 352--><p class="indent" > The first option (using <span class="TEX">T<span
+</p><!--l. 358--><p class="indent" > The first option (using <span class="TEX">T<span
class="E">E</span>X</span>) is the simplest method, as it doesn&#8217;t require an
external tool, but it&#8217;s very inefficient and the sorting is done according to the English
alphabet. To use this method, add <span
@@ -727,13 +733,13 @@ example:
&#x00A0;<br />&#x00A0;\printnoidxglossaries
&#x00A0;<br />&#x00A0;\end{document}
</div>
-<!--l. 382--><p class="nopar" >
-</p><!--l. 384--><p class="indent" > <div class="important" title="Important Note"> The <span
+<!--l. 388--><p class="nopar" >
+</p><!--l. 390--><p class="indent" > <div class="important" title="Important Note"> The <span
class="cmtt-10">\makenoidxglossaries </span>method is very slow, uses an ASCII comparator and
often breaks if there are commands in the <span
class="cmtt-10">name </span>key. </div>
-</p><!--l. 388--><p class="noindent" >
-</p><!--l. 390--><p class="indent" > Try this out and run <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span
+</p><!--l. 394--><p class="noindent" >
+</p><!--l. 396--><p class="indent" > Try this out and run <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span
class="E">E</span>X</span></span>&#x00A0;(or pdf<span class="LATEX">L<span class="A">A</span><span class="TEX">T<span
class="E">E</span>X</span></span>) <span
class="cmti-10">twice</span>. The first run won&#8217;t show the
@@ -741,7 +747,7 @@ glossary. It will only appear on the second run. This doesn&#8217;t include &#82
glossary because that term hasn&#8217;t been used (with commands like <span class="obeylines-h"><span class="verb"><span
class="cmtt-10">\gls{turnip}</span></span></span>) in
the document.
-</p><!--l. 395--><p class="indent" > The glossary has a vertical gap between the &#8220;carrot&#8221; term and the &#8220;potato&#8221; term.
+</p><!--l. 401--><p class="indent" > The glossary has a vertical gap between the &#8220;carrot&#8221; term and the &#8220;potato&#8221; term.
This is because the entries in the glossaries are grouped according to their
first letter. If you don&#8217;t want this gap, just add <span
class="cmss-10">nogroupskip</span><a
@@ -754,7 +760,7 @@ options:
<div class="verbatim" id="verbatim-11">
\usepackage[nogroupskip]{glossaries}
</div>
-<!--l. 401--><p class="nopar" > or you may want to try out a style that shows the group headings:
+<!--l. 407--><p class="nopar" > or you may want to try out a style that shows the group headings:
@@ -762,7 +768,7 @@ options:
<div class="verbatim" id="verbatim-12">
\usepackage[style=indexgroup]{glossaries}
</div>
-<!--l. 405--><p class="nopar" > If you try out this example you may also notice that the description is followed by a
+<!--l. 411--><p class="nopar" > If you try out this example you may also notice that the description is followed by a
full stop (period) and a number. The number is the location in the document where
the entry was used (page&#x00A0;1 in this case), so you can lookup the term in the glossary
and be directed to the relevant pages. It may be that you don&#8217;t want this
@@ -777,7 +783,7 @@ option:
<div class="verbatim" id="verbatim-13">
\usepackage[nonumberlist]{glossaries}
</div>
-<!--l. 415--><p class="nopar" > If you don&#8217;t like the terminating full stop, you can suppress that with the <span
+<!--l. 421--><p class="nopar" > If you don&#8217;t like the terminating full stop, you can suppress that with the <span
class="cmss-10">nopostdot</span><a
id="dx1-2026"></a>
package option:
@@ -788,8 +794,8 @@ package option:
<div class="verbatim" id="verbatim-14">
\usepackage[nopostdot]{glossaries}
</div>
-<!--l. 420--><p class="nopar" >
-</p><!--l. 422--><p class="indent" > If you tried out the previous example with <span
+<!--l. 426--><p class="nopar" >
+</p><!--l. 428--><p class="indent" > If you tried out the previous example with <span
class="cmss-10">glossaries-extra</span><a
id="dx1-2027"></a> and <span
class="cmtt-10">\printunsrtglossaries</span>
@@ -802,7 +808,7 @@ full stop back with
<div class="verbatim" id="verbatim-15">
\usepackage[nopostdot=false]{glossaries-extra}
</div>
-<!--l. 427--><p class="nopar" > or
+<!--l. 433--><p class="nopar" > or
@@ -810,14 +816,14 @@ full stop back with
<div class="verbatim" id="verbatim-16">
\usepackage[postdot]{glossaries-extra}
</div>
-<!--l. 431--><p class="nopar" > If you want the number lists then you need to use an indexing option.
-</p><!--l. 435--><p class="indent" > You may have noticed that I&#8217;ve used another command in the above example:
+<!--l. 437--><p class="nopar" > If you want the number lists then you need to use an indexing option.
+</p><!--l. 441--><p class="indent" > You may have noticed that I&#8217;ve used another command in the above example:
<span
class="cmtt-10">\glspl</span>. This displays the plural form. By default, this is just the singular form with
the letter &#8220;s&#8221; appended, but in the case of &#8220;potato&#8221; I had to specify the correct
plural using the <span
class="cmtt-10">plural </span>key.
-</p><!--l. 441--><p class="indent" > As I mentioned earlier, using <span class="TEX">T<span
+</p><!--l. 447--><p class="indent" > As I mentioned earlier, using <span class="TEX">T<span
class="E">E</span>X</span>&#x00A0;to sort the entries is the simplest but least
efficient method. If you have a large glossary or if your terms contain non-Latin or
extended Latin characters, then you will have a much faster build time if you use
@@ -841,25 +847,25 @@ href="#sec:printglossaries"><span
class="cmsy-10">&sect;</span>4 </a><a
href="#sec:printglossaries">Displaying
a List of Entries<!--tex4ht:ref: sec:printglossaries --></a>.
-</p><!--l. 451--><p class="indent" > The rest of this document briefly describes the main commands provided by the
+</p><!--l. 457--><p class="indent" > The rest of this document briefly describes the main commands provided by the
<span
class="cmss-10">glossaries </span>package. (Most of these are also available with <span
class="cmss-10">glossaries-extra</span><a
id="dx1-2033"></a> but may
behave slightly differently.)
-</p><!--l. 456--><p class="noindent" >
+</p><!--l. 462--><p class="noindent" >
</p>
-<!--l. 456--><p class="noindent" ><a
+<!--l. 462--><p class="noindent" ><a
href="#top">Top</a><h2 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">2 </span> <a
id="sec:defterm"></a>Defining Terms</h3>
-<!--l. 459--><p class="noindent" >When you use the <span
+<!--l. 465--><p class="noindent" >When you use the <span
class="cmss-10">glossaries</span><a
id="dx1-3001"></a> package, you need to define glossary entries in the
document preamble. These entries could be a&#x00A0;word, phrase, abbreviation or symbol.
They&#8217;re usually accompanied by a&#x00A0;description, which could be a short sentence or an
in-depth explanation that spans multiple paragraphs. The simplest method of
defining an entry is to use:
-</p><!--l. 466--><p class="indent" > <hr><div title="Definition"></p><div class="alltt">
+</p><!--l. 472--><p class="indent" > <hr><div title="Definition"></p><div class="alltt">
<div class="obeylines-v">
<span
class="cmtt-10">\newglossaryentry{</span>&#x27E8;<span
@@ -889,7 +895,7 @@ class="cmtt-10">}</span></span>
-<!--l. 474--><p class="noindent" >
+<!--l. 480--><p class="noindent" >
where &#x27E8;<span
class="cmti-10">label</span>&#x27E9; is a unique label that identifies this entry. (Don&#8217;t include the angle
brackets &#x27E8; &#x27E9;. They just indicate the parts of the code you need to change when you use
@@ -898,11 +904,11 @@ class="cmti-10">name</span>&#x27E9; is the word, phrase or symbol
you are defining, and &#x27E8;<span
class="cmti-10">description</span>&#x27E9; is the description to be displayed in the
glossary.
-</p><!--l. 482--><p class="indent" > This command is a &#8220;short&#8221; command, which means that &#x27E8;<span
+</p><!--l. 488--><p class="indent" > This command is a &#8220;short&#8221; command, which means that &#x27E8;<span
class="cmti-10">description</span>&#x27E9; can&#8217;t
contain a&#x00A0;paragraph break. If you have a&#x00A0;long description, you can instead
use:
-</p><!--l. 486--><p class="indent" > <hr><div title="Definition"></p><div class="alltt">
+</p><!--l. 492--><p class="indent" > <hr><div title="Definition"></p><div class="alltt">
<div class="obeylines-v">
<span
class="cmtt-10">\longnewglossaryentry{</span>&#x27E8;<span
@@ -928,8 +934,8 @@ class="cmitt-10">description</span>&#x27E9;<span
class="cmtt-10">}</span>
</div>
</div> </div><hr>
-<!--l. 494--><p class="noindent" >
-</p><!--l. 496--><p class="indent" > Examples:
+<!--l. 500--><p class="noindent" >
+</p><!--l. 502--><p class="indent" > Examples:
</p><ol class="enumerate1" >
<li
class="enumerate" id="x1-3003x1">Define the term &#8220;set&#8221; with the label <span
@@ -944,7 +950,7 @@ class="cmtt-10">set</span>:
&#x00A0;<br />&#x00A0;&#x00A0;description={a&#x00A0;collection&#x00A0;of&#x00A0;objects}
&#x00A0;<br />}
</div>
- <!--l. 505--><p class="nopar" >
+ <!--l. 511--><p class="nopar" >
</p></li>
<li
class="enumerate" id="x1-3005x2">Define the symbol <span
@@ -960,7 +966,7 @@ class="cmtt-10">emptyset</span>:
&#x00A0;<br />&#x00A0;&#x00A0;description={the&#x00A0;empty&#x00A0;set}
&#x00A0;<br />}
</div>
- <!--l. 515--><p class="nopar" > (This will also need a <span
+ <!--l. 521--><p class="nopar" > (This will also need a <span
class="cmtt-10">sort </span>key if you use Options&#x00A0;<a
href="#option1">1</a> or&#x00A0;<a
href="#option3">3</a>, see below.)
@@ -982,7 +988,7 @@ class="cmtt-10">fishage</span>:
&#x00A0;<br />&#x00A0;&#x00A0;fish&#x00A0;species.
&#x00A0;<br />}
</div>
- <!--l. 532--><p class="nopar" > (The percent character discards the end of line character that would otherwise
+ <!--l. 538--><p class="nopar" > (The percent character discards the end of line character that would otherwise
cause an unwanted space to appear at the start of the description.)
</p></li>
<li
@@ -1003,7 +1009,7 @@ class="cmtt-10">&eacute;</span>). This first letter must be placed in a&#x00A0;g
&#x00A0;<br />&#x00A0;&#x00A0;description={select&#x00A0;group&#x00A0;or&#x00A0;class}
&#x00A0;<br />}
</div>
- <!--l. 548--><p class="nopar" > or </p><div class="alltt">
+ <!--l. 554--><p class="nopar" > or </p><div class="alltt">
<div class="obeylines-v">
<span class="verb"><span
class="cmtt-10">\newglossaryentry{elite}</span></span>
@@ -1027,10 +1033,10 @@ class="cmtt-10">&#x00A0;class}</span></span>
class="cmtt-10">}</span></span>
</div>
</div></li></ol>
-<!--l. 558--><p class="noindent" >(For further details, see the section &#8220;UTF-8&#8221; of the <a
+<!--l. 564--><p class="noindent" >(For further details, see the section &#8220;UTF-8&#8221; of the <a
href="https://ctan.org/pkg/mfirstuc" ><span
class="cmss-10">mfirstuc</span></a> user manual.)
-</p><!--l. 561--><p class="indent" > If you use <span
+</p><!--l. 567--><p class="indent" > If you use <span
class="cmtt-10">bib2gls</span><a
id="dx1-3011"></a> with <span
class="cmss-10">glossaries-extra</span><a
@@ -1189,7 +1195,7 @@ package option:
<div class="verbatim" id="verbatim-21">
\usepackage[record]{glossaries-extra}
</div>
-<!--l. 598--><p class="nopar" > and the <span
+<!--l. 604--><p class="nopar" > and the <span
class="cmtt-10">.bib </span>file is specified in the resource command. For example, if the
<span
class="cmtt-10">.bib </span>file is called <span
@@ -1202,7 +1208,7 @@ preamble:
<div class="verbatim" id="verbatim-22">
\GlsXtrLoadResources[src={entries}]
</div>
-<!--l. 604--><p class="nopar" > You can have a comma-separated list. For example, if you also have entries defined
+<!--l. 610--><p class="nopar" > You can have a comma-separated list. For example, if you also have entries defined
in the file <span
class="cmtt-10">entries2.bib</span>:
@@ -1212,8 +1218,8 @@ class="cmtt-10">entries2.bib</span>:
<div class="verbatim" id="verbatim-23">
\GlsXtrLoadResources[src={entries,entries2.bib}]
</div>
-<!--l. 609--><p class="nopar" >
-</p><!--l. 611--><p class="indent" > There are other keys you can use when you define an entry. For example, the <span
+<!--l. 615--><p class="nopar" >
+</p><!--l. 617--><p class="indent" > There are other keys you can use when you define an entry. For example, the <span
class="cmtt-10">name</span>
key indicates how the term should appear in the list of entries (glossary), but if the
term should appear differently when you reference it with <span
@@ -1222,7 +1228,7 @@ class="cmti-10">label</span>&#x27E9;<span
class="cmtt-10">} </span>in the
document, you need to use the <span
class="cmtt-10">text </span>key as well.
-</p><!--l. 617--><p class="indent" > For example:
+</p><!--l. 623--><p class="indent" > For example:
@@ -1236,7 +1242,7 @@ class="cmtt-10">text </span>key as well.
&#x00A0;<br />&#x00A0;&#x00A0;a,&#x00A0;\ldots,&#x00A0;z,&#x00A0;A,&#x00A0;\ldots,&#x00A0;Z}
&#x00A0;<br />}
</div>
-<!--l. 626--><p class="nopar" > This will appear in the text as &#8220;Latin alphabet&#8221; but will be listed in the glossary
+<!--l. 632--><p class="nopar" > This will appear in the text as &#8220;Latin alphabet&#8221; but will be listed in the glossary
as &#8220;Latin Alphabet&#8221;. With <span
class="cmtt-10">bib2gls</span><a
id="dx1-3015"></a> this entry is defined in the <span
@@ -1254,8 +1260,8 @@ as:
&#x00A0;<br />&#x00A0;&#x00A0;a,&#x00A0;\ldots,&#x00A0;z,&#x00A0;A,&#x00A0;\ldots,&#x00A0;Z}
&#x00A0;<br />}
</div>
-<!--l. 638--><p class="nopar" >
-</p><!--l. 640--><p class="indent" > Another commonly used key is <span
+<!--l. 644--><p class="nopar" >
+</p><!--l. 646--><p class="indent" > Another commonly used key is <span
class="cmtt-10">plural </span>for specifying the plural of the term. This
defaults to the value of the <span
class="cmtt-10">text </span>key with an &#8220;s&#8221; appended, but if this is incorrect,
@@ -1273,10 +1279,10 @@ class="cmtt-10">plural </span>key to override it:
&#x00A0;<br />&#x00A0;&#x00A0;description={canal&#x00A0;from&#x00A0;mouth&#x00A0;to&#x00A0;stomach}
&#x00A0;<br />}
</div>
-<!--l. 651--><p class="nopar" > (Remember from earlier that the initial ligature <span
+<!--l. 657--><p class="nopar" > (Remember from earlier that the initial ligature <span
class="cmtt-10">\oe </span>needs to be grouped.)
-</p><!--l. 655--><p class="indent" > Abbreviations can be defined using
-</p><!--l. 657--><p class="indent" > <hr><div title="Definition"><span
+</p><!--l. 661--><p class="indent" > Abbreviations can be defined using
+</p><!--l. 663--><p class="indent" > <hr><div title="Definition"><span
class="cmtt-10">\newacronym[</span>&#x27E8;<span
class="cmitt-10">options</span>&#x27E9;<span
class="cmtt-10">]{</span>&#x27E8;<span
@@ -1286,7 +1292,7 @@ class="cmitt-10">short</span>&#x27E9;<span
class="cmtt-10">}{</span>&#x27E8;<span
class="cmitt-10">long</span>&#x27E9;<span
class="cmtt-10">} </span></div><hr>
-</p><!--l. 658--><p class="noindent" >
+</p><!--l. 664--><p class="noindent" >
where &#x27E8;<span
class="cmti-10">label</span>&#x27E9; is the label (as per <span
class="cmtt-10">\newglossaryentry</span>), &#x27E8;<span
@@ -1300,7 +1306,7 @@ class="cmti-10">long</span>&#x27E9; is the long form. For example, the following
<div class="verbatim" id="verbatim-27">
\newacronym{svm}{SVM}{support&#x00A0;vector&#x00A0;machine}
</div>
-<!--l. 665--><p class="nopar" > This internally uses <span
+<!--l. 671--><p class="nopar" > This internally uses <span
class="cmtt-10">\newglossaryentry </span>to define an entry with the label <span
class="cmtt-10">svm</span>. By
default, the <span
@@ -1320,14 +1326,14 @@ the optional argument:
&#x00A0;<br />&#x00A0;[description={statistical&#x00A0;pattern&#x00A0;recognition&#x00A0;technique}]
&#x00A0;<br />&#x00A0;{svm}{SVM}{support&#x00A0;vector&#x00A0;machine}
</div>
-<!--l. 677--><p class="nopar" >
-</p><!--l. 679--><p class="indent" > Before you define your acronyms (or other types of abbreviations), you need to
+<!--l. 683--><p class="nopar" >
+</p><!--l. 685--><p class="indent" > Before you define your acronyms (or other types of abbreviations), you need to
specify which style to use with
-</p><!--l. 682--><p class="indent" > <hr><div title="Definition"><span
+</p><!--l. 688--><p class="indent" > <hr><div title="Definition"><span
class="cmtt-10">\setacronymstyle{</span>&#x27E8;<span
class="cmitt-10">style name</span>&#x27E9;<span
class="cmtt-10">} </span></div><hr>
-</p><!--l. 683--><p class="noindent" >
+</p><!--l. 689--><p class="noindent" >
where &#x27E8;<span
class="cmti-10">style name</span>&#x27E9; is the name of the style. There are a number of predefined styles,
such as: <span
@@ -1344,13 +1350,13 @@ description). There are some other styles as well that use <span
class="cmtt-10">\textsc </span>to typeset the
acronym or that use a footnote on first use. See the main user guide for further
details.
-</p><!--l. 695--><p class="indent" > The <span
+</p><!--l. 701--><p class="indent" > The <span
class="cmss-10">glossaries-extra</span><a
id="dx1-3016"></a> package provides improved abbreviation handling with <a
href="http://www.dickimaw-books.com/gallery/sample-abbr-styles.shtml" >a lot
more predefined styles</a>. With this extension package, abbreviations are defined
using:
-</p><!--l. 699--><p class="indent" > <hr><div title="Definition"><span
+</p><!--l. 705--><p class="indent" > <hr><div title="Definition"><span
class="cmtt-10">\newabbreviation[</span>&#x27E8;<span
class="cmitt-10">options</span>&#x27E9;<span
class="cmtt-10">]{</span>&#x27E8;<span
@@ -1360,17 +1366,17 @@ class="cmitt-10">short</span>&#x27E9;<span
class="cmtt-10">}{</span>&#x27E8;<span
class="cmitt-10">long</span>&#x27E9;<span
class="cmtt-10">} </span></div><hr>
-</p><!--l. 700--><p class="noindent" >
+</p><!--l. 706--><p class="noindent" >
You can still use <span
class="cmtt-10">\newacronym </span>but it&#8217;s redefined to use the new abbreviation
interface. The style must now be set using:
-</p><!--l. 704--><p class="indent" > <hr><div title="Definition"><span
+</p><!--l. 710--><p class="indent" > <hr><div title="Definition"><span
class="cmtt-10">\setabbreviationstyle[</span>&#x27E8;<span
class="cmitt-10">category</span>&#x27E9;<span
class="cmtt-10">]{</span>&#x27E8;<span
class="cmitt-10">style name</span>&#x27E9;<span
class="cmtt-10">} </span></div><hr>
-</p><!--l. 705--><p class="noindent" >
+</p><!--l. 711--><p class="noindent" >
The default &#x27E8;<span
class="cmti-10">category</span>&#x27E9; is <span
class="cmtt-10">abbreviation</span>. If you use <span
@@ -1418,7 +1424,7 @@ class="cmtt-10">}</span>
class="cmsy-10">}</span>
</div>
</div>
-<!--l. 722--><p class="indent" > The plural forms for abbreviations can be specified using the <span
+<!--l. 728--><p class="indent" > The plural forms for abbreviations can be specified using the <span
class="cmtt-10">longplural </span>and
<span
class="cmtt-10">shortplural </span>keys. For example:
@@ -1431,7 +1437,7 @@ class="cmtt-10">shortplural </span>keys. For example:
&#x00A0;<br />&#x00A0;[longplural={diagonal&#x00A0;matrices}]
&#x00A0;<br />&#x00A0;{dm}{DM}{diagonal&#x00A0;matrix}
</div>
-<!--l. 728--><p class="nopar" > or (with <span
+<!--l. 734--><p class="nopar" > or (with <span
class="cmss-10">glossaries-extra</span><a
id="dx1-3019"></a>):
@@ -1443,7 +1449,7 @@ class="cmss-10">glossaries-extra</span><a
&#x00A0;<br />&#x00A0;[longplural={diagonal&#x00A0;matrices}]
&#x00A0;<br />&#x00A0;{dm}{DM}{diagonal&#x00A0;matrix}
</div>
-<!--l. 734--><p class="nopar" > If omitted, the defaults are again obtained by appending an &#8220;s&#8221; to the singular
+<!--l. 740--><p class="nopar" > If omitted, the defaults are again obtained by appending an &#8220;s&#8221; to the singular
versions. With <span
class="cmtt-10">bib2gls</span><a
id="dx1-3020"></a>, the definition in the <span
@@ -1459,8 +1465,8 @@ class="cmtt-10">.bib </span>file is:
&#x00A0;<br />&#x00A0;&#x00A0;longplural={diagonal&#x00A0;matrices}
&#x00A0;<br />}
</div>
-<!--l. 744--><p class="nopar" >
-</p><!--l. 746--><p class="indent" > It&#8217;s also possible to have both a&#x00A0;name and a&#x00A0;corresponding symbol.
+<!--l. 750--><p class="nopar" >
+</p><!--l. 752--><p class="indent" > It&#8217;s also possible to have both a&#x00A0;name and a&#x00A0;corresponding symbol.
Just use the <span
class="cmtt-10">name </span>key for the name and the <span
class="cmtt-10">symbol </span>key for the symbol. For
@@ -1477,7 +1483,7 @@ example:
&#x00A0;<br />&#x00A0;&#x00A0;description={the&#x00A0;set&#x00A0;containing&#x00A0;no&#x00A0;elements}
&#x00A0;<br />}
</div>
-<!--l. 756--><p class="nopar" > or with <span
+<!--l. 762--><p class="nopar" > or with <span
class="cmtt-10">bib2gls</span><a
id="dx1-3021"></a> the definition in the <span
class="cmtt-10">.bib </span>file is:
@@ -1492,8 +1498,8 @@ class="cmtt-10">.bib </span>file is:
&#x00A0;<br />&#x00A0;&#x00A0;description={the&#x00A0;set&#x00A0;containing&#x00A0;no&#x00A0;elements}
&#x00A0;<br />}
</div>
-<!--l. 764--><p class="nopar" >
-</p><!--l. 766--><p class="indent" > If you want the symbol in the <span
+<!--l. 770--><p class="nopar" >
+</p><!--l. 772--><p class="indent" > If you want the symbol in the <span
class="cmtt-10">name </span>field then you must supply a <span
class="cmtt-10">sort </span>value with
Options&#x00A0;<a
@@ -1519,7 +1525,7 @@ order is a little odd. For example:
&#x00A0;<br />&#x00A0;&#x00A0;description={the&#x00A0;set&#x00A0;containing&#x00A0;no&#x00A0;elements}
&#x00A0;<br />}
</div>
-<!--l. 778--><p class="nopar" > This displays the symbol as <span
+<!--l. 784--><p class="nopar" > This displays the symbol as <span
class="cmsy-10">&#x2205; </span>but sorts according to &#8220;empty set&#8221;. You
may want to consider using <span
class="cmss-10">glossaries-extra</span><a
@@ -1527,7 +1533,7 @@ class="cmss-10">glossaries-extra</span><a
class="cmss-10">symbols</span><a
id="dx1-3025"></a> package option which
provides
-</p><!--l. 784--><p class="indent" > <hr><div title="Definition"><span
+</p><!--l. 790--><p class="indent" > <hr><div title="Definition"><span
class="cmtt-10">\glsxtrnewsymbol[</span>&#x27E8;<span
class="cmitt-10">options</span>&#x27E9;<span
class="cmtt-10">]{</span>&#x27E8;<span
@@ -1535,7 +1541,7 @@ class="cmitt-10">label</span>&#x27E9;<span
class="cmtt-10">}{</span>&#x27E8;<span
class="cmitt-10">symbol</span>&#x27E9;<span
class="cmtt-10">} </span></div><hr>
-</p><!--l. 785--><p class="noindent" >
+</p><!--l. 791--><p class="noindent" >
This internally uses <span
class="cmtt-10">\newglossaryentry </span>but automatically sets the <span
class="cmtt-10">sort </span>key to the
@@ -1558,8 +1564,8 @@ class="cmti-10">label</span>&#x27E9;. For example:
&#x00A0;<br />\printglossaries
&#x00A0;<br />\end{document}
</div>
-<!--l. 805--><p class="nopar" > Now the sort value is &#8220;emptyset&#8221; rather than the previous &#8220;empty set&#8221;.
-</p><!--l. 809--><p class="indent" > With <span
+<!--l. 811--><p class="nopar" > Now the sort value is &#8220;emptyset&#8221; rather than the previous &#8220;empty set&#8221;.
+</p><!--l. 815--><p class="indent" > With <span
class="cmtt-10">bib2gls</span><a
id="dx1-3026"></a> you can define this in the <span
class="cmtt-10">.bib </span>file as
@@ -1573,7 +1579,7 @@ class="cmtt-10">.bib </span>file as
&#x00A0;<br />&#x00A0;&#x00A0;description={the&#x00A0;set&#x00A0;containing&#x00A0;no&#x00A0;elements}
&#x00A0;<br />}
</div>
-<!--l. 816--><p class="nopar" > in which case <span
+<!--l. 822--><p class="nopar" > in which case <span
class="cmtt-10">bib2gls</span><a
id="dx1-3027"></a> will try to interpret the <span
class="cmtt-10">name </span>field to determine the sort
@@ -1588,7 +1594,7 @@ value. Alternatively you can use:
&#x00A0;<br />&#x00A0;&#x00A0;description={the&#x00A0;set&#x00A0;containing&#x00A0;no&#x00A0;elements}
&#x00A0;<br />}
</div>
-<!--l. 824--><p class="nopar" > which will use the label (<span
+<!--l. 830--><p class="nopar" > which will use the label (<span
class="cmtt-10">emptyset</span>) as the sort value. (You don&#8217;t need the <span
class="cmss-10">symbols</span><a
id="dx1-3028"></a>
@@ -1609,20 +1615,20 @@ now:
&#x00A0;<br />\printunsrtglossaries
&#x00A0;<br />\end{document}
</div>
-<!--l. 841--><p class="nopar" >
-</p><!--l. 843--><p class="noindent" >
+<!--l. 847--><p class="nopar" >
+</p><!--l. 849--><p class="noindent" >
</p>
-<!--l. 843--><p class="noindent" ><a
+<!--l. 849--><p class="noindent" ><a
href="#top">Top</a><h2 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">3 </span> <a
id="sec:useterm"></a>Using Entries</h3>
-<!--l. 846--><p class="noindent" >Once you have defined your entries, as described above, you can reference them in
+<!--l. 852--><p class="noindent" >Once you have defined your entries, as described above, you can reference them in
your document. There are a&#x00A0;number of commands to do this, but the most common
one is:
-</p><!--l. 850--><p class="indent" > <hr><div title="Definition"><span
+</p><!--l. 856--><p class="indent" > <hr><div title="Definition"><span
class="cmtt-10">\gls{</span>&#x27E8;<span
class="cmitt-10">label</span>&#x27E9;<span
class="cmtt-10">} </span></div><hr>
-</p><!--l. 851--><p class="noindent" >
+</p><!--l. 857--><p class="noindent" >
where &#x27E8;<span
class="cmti-10">label</span>&#x27E9; is the label you assigned to the entry when you defined it. For example,
<span class="obeylines-h"><span class="verb"><span
@@ -1637,7 +1643,7 @@ class="cmtt-10">bib2gls</span><a
id="dx1-4002"></a> has created the relevant files and <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span
class="E">E</span>X</span></span>&#x00A0;is
rerun.
-</p><!--l. 859--><p class="indent" > If you are using the <span
+</p><!--l. 865--><p class="indent" > If you are using the <span
class="cmss-10">hyperref</span><a
id="dx1-4003"></a> package (remember to load it before <span
class="cmss-10">glossaries</span>) <span
@@ -1648,7 +1654,7 @@ class="cmtt-10">\gls* </span>for
example, <span class="obeylines-h"><span class="verb"><span
class="cmtt-10">\gls*{fishage}</span></span></span>. The other commands described in this section all have a
similar starred form.
-</p><!--l. 866--><p class="indent" > If the entry was defined as an acronym (using <span
+</p><!--l. 872--><p class="indent" > If the entry was defined as an acronym (using <span
class="cmtt-10">\newacronym </span>with <span
class="cmss-10">glossaries</span>
described above) or an abbreviation (using <span
@@ -1672,30 +1678,30 @@ earlier.)
-</p><!--l. 878--><p class="indent" > If you want the plural form, you can use:
-</p><!--l. 880--><p class="indent" > <hr><div title="Definition"><span
+</p><!--l. 884--><p class="indent" > If you want the plural form, you can use:
+</p><!--l. 886--><p class="indent" > <hr><div title="Definition"><span
class="cmtt-10">\glspl{</span>&#x27E8;<span
class="cmitt-10">label</span>&#x27E9;<span
class="cmtt-10">} </span></div><hr>
-</p><!--l. 881--><p class="noindent" >
+</p><!--l. 887--><p class="noindent" >
instead of <span
class="cmtt-10">\gls{</span>&#x27E8;<span
class="cmti-10">label</span>&#x27E9;<span
class="cmtt-10">}</span>. For example, <span class="obeylines-h"><span class="verb"><span
class="cmtt-10">\glspl{set}</span></span></span> displays &#8220;sets&#8221;.
-</p><!--l. 885--><p class="indent" > If the term appears at the start of a&#x00A0;sentence, you can convert the first letter to
+</p><!--l. 891--><p class="indent" > If the term appears at the start of a&#x00A0;sentence, you can convert the first letter to
upper case using:
-</p><!--l. 888--><p class="indent" > <hr><div title="Definition"><span
+</p><!--l. 894--><p class="indent" > <hr><div title="Definition"><span
class="cmtt-10">\Gls{</span>&#x27E8;<span
class="cmitt-10">label</span>&#x27E9;<span
class="cmtt-10">} </span></div><hr>
-</p><!--l. 889--><p class="noindent" >
+</p><!--l. 895--><p class="noindent" >
for the singular form or
-</p><!--l. 892--><p class="indent" > <hr><div title="Definition"><span
+</p><!--l. 898--><p class="indent" > <hr><div title="Definition"><span
class="cmtt-10">\Glspl{</span>&#x27E8;<span
class="cmitt-10">label</span>&#x27E9;<span
class="cmtt-10">} </span></div><hr>
-</p><!--l. 893--><p class="noindent" >
+</p><!--l. 899--><p class="noindent" >
for the plural form. For example:
@@ -1704,21 +1710,21 @@ for the plural form. For example:
<div class="verbatim" id="verbatim-39">
\Glspl{set}&#x00A0;are&#x00A0;collections.
</div>
-<!--l. 897--><p class="nopar" > produces &#8220;Sets are collections&#8221;.
-</p><!--l. 900--><p class="indent" > If you&#8217;ve specified a symbol using the <span
+<!--l. 903--><p class="nopar" > produces &#8220;Sets are collections&#8221;.
+</p><!--l. 906--><p class="indent" > If you&#8217;ve specified a symbol using the <span
class="cmtt-10">symbol </span>key, you can display it
using:
-</p><!--l. 903--><p class="indent" > <hr><div title="Definition"><span
+</p><!--l. 909--><p class="indent" > <hr><div title="Definition"><span
class="cmtt-10">\glssymbol{</span>&#x27E8;<span
class="cmitt-10">label</span>&#x27E9;<span
class="cmtt-10">} </span></div><hr>
-</p><!--l. 904--><p class="noindent" >
-</p><!--l. 906--><p class="noindent" >
+</p><!--l. 910--><p class="noindent" >
+</p><!--l. 912--><p class="noindent" >
</p>
-<!--l. 906--><p class="noindent" ><a
+<!--l. 912--><p class="noindent" ><a
href="#top">Top</a><h2 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">4 </span> <a
id="sec:printglossaries"></a>Displaying a List of Entries</h3>
-<!--l. 909--><p class="noindent" >In <a
+<!--l. 915--><p class="noindent" >In <a
href="#sec:start"><span
class="cmsy-10">&sect;</span>1 </a><a
href="#sec:start">Getting Started<!--tex4ht:ref: sec:start --></a>, I mentioned that there are three options you can
@@ -1739,7 +1745,7 @@ build</a>.
-<!--l. 919--><p class="indent" > <a
+<!--l. 925--><p class="indent" > <a
id="x1-50011"></a></p><hr class="float" /><div class="float"
>
@@ -1757,7 +1763,7 @@ id="TBL-2-3" /><col
id="TBL-2-4" /><col
id="TBL-2-5" /></colgroup><tr
style="vertical-align:baseline;" id="TBL-2-1-"><td style="white-space:wrap; text-align:left;" id="TBL-2-1-1"
-class="td11"> <!--l. 925--><p class="noindent" > </p></td><td style="white-space:nowrap; text-align:center;" id="TBL-2-1-2"
+class="td11"> <!--l. 931--><p class="noindent" > </p></td><td style="white-space:nowrap; text-align:center;" id="TBL-2-1-2"
class="td11"> <a
href="#option1"><span
class="cmbx-10">Option</span><span
@@ -1776,7 +1782,7 @@ class="cmbx-10">Option</span><span
class="cmbx-10">&#x00A0;4</span></a> </td>
</tr><tr
style="vertical-align:baseline;" id="TBL-2-2-"><td style="white-space:wrap; text-align:left;" id="TBL-2-2-1"
-class="td11"> <!--l. 927--><p class="noindent" >Requires
+class="td11"> <!--l. 933--><p class="noindent" >Requires
<span
class="cmss-10">glossaries-extra</span><a
id="dx1-5002"></a>? </p></td><td style="white-space:nowrap; text-align:center;" id="TBL-2-2-2"
@@ -1790,7 +1796,7 @@ class="td11"> <span id="textcolor4"><span
class="pzdr-">&#x2714;</span></span> </td>
</tr><tr
style="vertical-align:baseline;" id="TBL-2-3-"><td style="white-space:wrap; text-align:left;" id="TBL-2-3-1"
-class="td11"> <!--l. 929--><p class="noindent" >Requires
+class="td11"> <!--l. 935--><p class="noindent" >Requires
an
external
application? </p></td><td style="white-space:nowrap; text-align:center;" id="TBL-2-3-2"
@@ -1804,7 +1810,7 @@ class="td11"> <span id="textcolor8"><span
class="pzdr-">&#x2714;</span></span> </td>
</tr><tr
style="vertical-align:baseline;" id="TBL-2-4-"><td style="white-space:wrap; text-align:left;" id="TBL-2-4-1"
-class="td11"> <!--l. 931--><p class="noindent" >Requires
+class="td11"> <!--l. 937--><p class="noindent" >Requires
Perl? </p></td><td style="white-space:nowrap; text-align:center;" id="TBL-2-4-2"
class="td11"> <span id="textcolor9"><span
class="pzdr-">&#x2718;</span></span> </td><td style="white-space:nowrap; text-align:center;" id="TBL-2-4-3"
@@ -1816,7 +1822,7 @@ class="td11"> <span id="textcolor12"><span
class="pzdr-">&#x2718;</span></span> </td>
</tr><tr
style="vertical-align:baseline;" id="TBL-2-5-"><td style="white-space:wrap; text-align:left;" id="TBL-2-5-1"
-class="td11"> <!--l. 933--><p class="noindent" >Requires
+class="td11"> <!--l. 939--><p class="noindent" >Requires
Java? </p></td><td style="white-space:nowrap; text-align:center;" id="TBL-2-5-2"
class="td11"> <span id="textcolor13"><span
class="pzdr-">&#x2718;</span></span> </td><td style="white-space:nowrap; text-align:center;" id="TBL-2-5-3"
@@ -1828,7 +1834,7 @@ class="td11"> <span id="textcolor16"><span
class="pzdr-">&#x2714;</span></span> </td>
</tr><tr
style="vertical-align:baseline;" id="TBL-2-6-"><td style="white-space:wrap; text-align:left;" id="TBL-2-6-1"
-class="td11"> <!--l. 935--><p class="noindent" >Can
+class="td11"> <!--l. 941--><p class="noindent" >Can
sort
extended
Latin
@@ -1845,7 +1851,7 @@ class="td11"> <span id="textcolor20"><span
class="pzdr-">&#x2714;</span></span> </td>
</tr><tr
style="vertical-align:baseline;" id="TBL-2-7-"><td style="white-space:wrap; text-align:left;" id="TBL-2-7-1"
-class="td11"> <!--l. 938--><p class="noindent" >Efficient
+class="td11"> <!--l. 944--><p class="noindent" >Efficient
sort
algorithm? </p></td><td style="white-space:nowrap; text-align:center;" id="TBL-2-7-2"
class="td11"> <span id="textcolor21"><span
@@ -1858,7 +1864,7 @@ class="td11"> <span id="textcolor24"><span
class="pzdr-">&#x2714;</span></span> </td>
</tr><tr
style="vertical-align:baseline;" id="TBL-2-8-"><td style="white-space:wrap; text-align:left;" id="TBL-2-8-1"
-class="td11"> <!--l. 940--><p class="noindent" >Can
+class="td11"> <!--l. 946--><p class="noindent" >Can
use
different
sort
@@ -1876,7 +1882,7 @@ class="td11"> <span id="textcolor28"><span
class="pzdr-">&#x2714;</span></span> </td>
</tr><tr
style="vertical-align:baseline;" id="TBL-2-9-"><td style="white-space:wrap; text-align:left;" id="TBL-2-9-1"
-class="td11"> <!--l. 942--><p class="noindent" >Any
+class="td11"> <!--l. 948--><p class="noindent" >Any
problematic
sort
values? </p></td><td style="white-space:nowrap; text-align:center;" id="TBL-2-9-2"
@@ -1890,7 +1896,7 @@ class="td11"> <span id="textcolor32"><span
class="pzdr-">&#x2718;</span></span> </td>
</tr><tr
style="vertical-align:baseline;" id="TBL-2-10-"><td style="white-space:wrap; text-align:left;" id="TBL-2-10-1"
-class="td11"> <!--l. 944--><p class="noindent" >Can
+class="td11"> <!--l. 950--><p class="noindent" >Can
form
ranges
in
@@ -1907,7 +1913,7 @@ class="td11"> <span id="textcolor36"><span
class="pzdr-">&#x2714;</span></span> </td>
</tr><tr
style="vertical-align:baseline;" id="TBL-2-11-"><td style="white-space:wrap; text-align:left;" id="TBL-2-11-1"
-class="td11"> <!--l. 946--><p class="noindent" >Can
+class="td11"> <!--l. 952--><p class="noindent" >Can
have
non-standard
locations? </p></td><td style="white-space:nowrap; text-align:center;" id="TBL-2-11-2"
@@ -1921,7 +1927,7 @@ class="cmsy-9">&#8224;</span></sup> </td><td style="white-space:nowrap; text-
class="td11"> <span id="textcolor40"><span
class="pzdr-">&#x2714;</span></span> </td>
</tr></table></div>
-<!--l. 949--><p class="noindent" ><sup class="textsuperscript"><span
+<!--l. 955--><p class="noindent" ><sup class="textsuperscript"><span
class="cmsy-9">&#8224;</span></sup> <span
class="cmr-8">Requires some setting up.</span>
@@ -1936,7 +1942,7 @@ class="description"><a
id="option1"></a><span
class="cmbx-10">Option</span><span
class="cmbx-10">&#x00A0;1</span>:
- <!--l. 956--><p class="noindent" >This is the simplest option but it&#8217;s slow and if you want a sorted
+ <!--l. 962--><p class="noindent" >This is the simplest option but it&#8217;s slow and if you want a sorted
list, it doesn&#8217;t work for non-Latin alphabets. The <span
class="cmtt-10">name </span>mustn&#8217;t contain
commands (or, if it does, the <span
@@ -1959,13 +1965,13 @@ href="#sec:defterm">Defining Terms<!--tex4ht:ref: sec:defterm --></a>).
</li>
<li
class="enumerate" id="x1-5009x2">Put
- <!--l. 970--><p class="noindent" ><hr><div title="Definition"><span
+ <!--l. 976--><p class="noindent" ><hr><div title="Definition"><span
class="cmtt-10">\printnoidxglossary[sort=</span>&#x27E8;<span
class="cmitt-10">order</span>&#x27E9;<span
class="cmtt-10">,</span>&#x27E8;<span
class="cmitt-10">other options</span>&#x27E9;<span
class="cmtt-10">] </span></div><hr>
- </p><!--l. 971--><p class="noindent" >
+ </p><!--l. 977--><p class="noindent" >
where you want your list of entries to appear. The sort &#x27E8;<span
class="cmti-10">order</span>&#x27E9; may be one
of: <span
@@ -1976,12 +1982,12 @@ class="cmtt-10">case </span>(case-sensitive
class="cmtt-10">def </span>(in order of definition) or <span
class="cmtt-10">use </span>(in order of use).
Alternatively, use
- </p><!--l. 978--><p class="noindent" ><hr><div title="Definition"><span
+ </p><!--l. 984--><p class="noindent" ><hr><div title="Definition"><span
class="cmtt-10">\printnoidxglossaries </span></div><hr>
- </p><!--l. 979--><p class="noindent" >
+ </p><!--l. 985--><p class="noindent" >
to display all your glossaries (if you have more than one). This command
doesn&#8217;t have any arguments.
- </p><!--l. 983--><p class="noindent" >This option allows you to have different sort methods. For example:
+ </p><!--l. 989--><p class="noindent" >This option allows you to have different sort methods. For example:
@@ -1990,7 +1996,7 @@ class="cmtt-10">\printnoidxglossaries </span></div><hr>
\printnoidxglossary[sort=word]%&#x00A0;main&#x00A0;glossary
&#x00A0;<br />\printnoidxglossary[type=symbols,sort=use]%&#x00A0;symbols&#x00A0;glossary
</div>
- <!--l. 988--><p class="nopar" >
+ <!--l. 994--><p class="nopar" >
</p></li>
<li
class="enumerate" id="x1-5011x3">Run <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span
@@ -1998,7 +2004,7 @@ class="E">E</span>X</span></span>&#x00A0;twice on your document. (As you would d
of contents appear.) For example, click twice on the &#8220;typeset&#8221; or &#8220;build&#8221;
or &#8220;PDF<span class="LATEX">L<span class="A">A</span><span class="TEX">T<span
class="E">E</span>X</span></span>&#8221; button in your editor.</li></ol>
- <!--l. 994--><p class="noindent" >Here&#8217;s a complete document (<span
+ <!--l. 1000--><p class="noindent" >Here&#8217;s a complete document (<span
class="cmtt-10">myDoc.tex</span>):
@@ -2015,7 +2021,7 @@ class="cmtt-10">myDoc.tex</span>):
&#x00A0;<br />\printnoidxglossaries&#x00A0;%&#x00A0;iterate&#x00A0;over&#x00A0;all&#x00A0;indexed&#x00A0;entries
&#x00A0;<br />\end{document}
</div>
- <!--l. 1010--><p class="nopar" > Document build:
+ <!--l. 1016--><p class="nopar" > Document build:
@@ -2024,14 +2030,14 @@ class="cmtt-10">myDoc.tex</span>):
pdflatex&#x00A0;myDoc
&#x00A0;<br />pdflatex&#x00A0;myDoc
</div>
- <!--l. 1015--><p class="nopar" >
+ <!--l. 1021--><p class="nopar" >
</p></dd><dt class="description">
</dt><dd
class="description"><a
id="option2"></a><span
class="cmbx-10">Option</span><span
class="cmbx-10">&#x00A0;2</span>:
- <!--l. 1019--><p class="noindent" >This option uses an application called <span
+ <!--l. 1025--><p class="noindent" >This option uses an application called <span
class="cmtt-10">makeindex</span><a
id="dx1-5012"></a> to sort the entries. This
application comes with all modern <span class="TEX">T<span
@@ -2072,7 +2078,7 @@ class="cmtt-10">\GlsSetQuote </span>to change this to some other character.
<div class="verbatim" id="verbatim-43">
\GlsSetQuote{+}
</div>
- <!--l. 1038--><p class="nopar" > Use this as soon as possible after you&#8217;ve loaded the <span
+ <!--l. 1044--><p class="nopar" > Use this as soon as possible after you&#8217;ve loaded the <span
class="cmss-10">glossaries</span>
package.
</p></li>
@@ -2083,21 +2089,21 @@ class="cmtt-10">\makeglossaries </span>to your preamble (before you start defini
</li>
<li
class="enumerate" id="x1-5025x3">Put
- <!--l. 1047--><p class="noindent" ><hr><div title="Definition"><span
+ <!--l. 1053--><p class="noindent" ><hr><div title="Definition"><span
class="cmtt-10">\printglossary[</span>&#x27E8;<span
class="cmitt-10">options</span>&#x27E9;<span
class="cmtt-10">] </span></div><hr>
- </p><!--l. 1048--><p class="noindent" >
+ </p><!--l. 1054--><p class="noindent" >
where you want your list of entries (glossary) to appear. (The <span
class="cmtt-10">sort </span>key
isn&#8217;t available in &#x27E8;<span
class="cmti-10">options</span>&#x27E9;.) Alternatively, use
- </p><!--l. 1053--><p class="noindent" ><hr><div title="Definition"><span
+ </p><!--l. 1059--><p class="noindent" ><hr><div title="Definition"><span
class="cmtt-10">\printglossaries </span></div><hr>
- </p><!--l. 1054--><p class="noindent" >
+ </p><!--l. 1060--><p class="noindent" >
which will display all glossaries (if you have more than one). This
command doesn&#8217;t have any arguments.
- </p><!--l. 1058--><p class="noindent" ><div class="important" title="Important Note"> All glossaries are sorted using the same method which may be identified
+ </p><!--l. 1064--><p class="noindent" ><div class="important" title="Important Note"> All glossaries are sorted using the same method which may be identified
with one of the package options: <span
class="cmss-10">sort=standard</span><a
id="dx1-5026"></a> (default), <span
@@ -2106,7 +2112,7 @@ class="cmss-10">sort=use</span><a
<span
class="cmss-10">sort=def</span><a
id="dx1-5028"></a>. </div>
- </p><!--l. 1063--><p class="noindent" >
+ </p><!--l. 1069--><p class="noindent" >
</p></li>
<li
class="enumerate" id="x1-5030x4">Run <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span
@@ -2137,7 +2143,7 @@ class="cmtt-10">.tex</span>) extension. If you have access to a terminal or a co
<div class="verbatim" id="verbatim-44">
makeglossaries&#x00A0;myDoc
</div>
- <!--l. 1079--><p class="nopar" > (Replace <span
+ <!--l. 1085--><p class="nopar" > (Replace <span
class="cmtt-10">myDoc </span>with the base name of your <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span
class="E">E</span>X</span></span>&#x00A0;document file
without the <span
@@ -2152,8 +2158,8 @@ class="cmtt-10">makeglossaries-lite</span><a
<div class="verbatim" id="verbatim-45">
makeglossaries-lite&#x00A0;myDoc
</div>
- <!--l. 1086--><p class="nopar" >
- </p><!--l. 1088--><p class="noindent" ><div class="important" title="Important Note"> Some beginners get confused by <span
+ <!--l. 1092--><p class="nopar" >
+ </p><!--l. 1094--><p class="noindent" ><div class="important" title="Important Note"> Some beginners get confused by <span
class="cmtt-10">makeglossaries</span><a
id="dx1-5035"></a> the application (run as
a system command) and <span
@@ -2162,8 +2168,8 @@ class="E">E</span>X</span></span>&#x00A0;command
which should be typed in the document preamble. These are two
different concepts that happen to have similar looking names.
</div>
- </p><!--l. 1094--><p class="noindent" >
- </p><!--l. 1096--><p class="noindent" >If you don&#8217;t know how to use the command prompt, then you can
+ </p><!--l. 1100--><p class="noindent" >
+ </p><!--l. 1102--><p class="noindent" >If you don&#8217;t know how to use the command prompt, then you can
probably configure your text editor to add <span
class="cmtt-10">makeglossaries</span><a
id="dx1-5036"></a> (or
@@ -2182,8 +2188,8 @@ class="cmss-10">automake</span><a
<div class="verbatim" id="verbatim-46">
\usepackage[automake]{glossaries}
</div>
- <!--l. 1106--><p class="nopar" >
- </p><!--l. 1108--><p class="noindent" >The default sort is word order (&#8220;sea lion&#8221; comes before &#8220;seal&#8221;). If you
+ <!--l. 1112--><p class="nopar" >
+ </p><!--l. 1114--><p class="noindent" >The default sort is word order (&#8220;sea lion&#8221; comes before &#8220;seal&#8221;). If you
want letter ordering you need to add the <span
class="cmss-10">order=letter</span><a
id="dx1-5039"></a> package
@@ -2195,13 +2201,13 @@ class="cmss-10">order=letter</span><a
<div class="verbatim" id="verbatim-47">
\usepackage[order=letter]{glossaries}
</div>
- <!--l. 1113--><p class="nopar" >
+ <!--l. 1119--><p class="nopar" >
</p></li>
<li
class="enumerate" id="x1-5041x6">Once you have successfully completed the previous step, you can now run
<span class="LATEX">L<span class="A">A</span><span class="TEX">T<span
class="E">E</span>X</span></span>&#x00A0;on your document again.</li></ol>
- <!--l. 1118--><p class="noindent" >Here&#8217;s a complete document (<span
+ <!--l. 1124--><p class="noindent" >Here&#8217;s a complete document (<span
class="cmtt-10">myDoc.tex</span>):
@@ -2218,7 +2224,7 @@ class="cmtt-10">myDoc.tex</span>):
&#x00A0;<br />\printglossaries&#x00A0;%&#x00A0;input&#x00A0;files&#x00A0;created&#x00A0;by&#x00A0;makeindex
&#x00A0;<br />\end{document}
</div>
- <!--l. 1134--><p class="nopar" > Document build:
+ <!--l. 1140--><p class="nopar" > Document build:
@@ -2228,7 +2234,7 @@ class="cmtt-10">myDoc.tex</span>):
&#x00A0;<br />makeglossaries&#x00A0;myDoc
&#x00A0;<br />pdflatex&#x00A0;myDoc
</div>
- <!--l. 1140--><p class="nopar" > or
+ <!--l. 1146--><p class="nopar" > or
@@ -2238,14 +2244,14 @@ class="cmtt-10">myDoc.tex</span>):
&#x00A0;<br />makeglossaries-lite&#x00A0;myDoc
&#x00A0;<br />pdflatex&#x00A0;myDoc
</div>
- <!--l. 1146--><p class="nopar" >
+ <!--l. 1152--><p class="nopar" >
</p></dd><dt class="description">
</dt><dd
class="description"><a
id="option3"></a><span
class="cmbx-10">Option</span><span
class="cmbx-10">&#x00A0;3</span>:
- <!--l. 1151--><p class="noindent" >This option uses an application called <span
+ <!--l. 1157--><p class="noindent" >This option uses an application called <span
class="cmtt-10">xindy</span><a
id="dx1-5042"></a> to sort the entries. This
application is more flexible than <span
@@ -2289,7 +2295,7 @@ class="cmss-10">glossaries</span><a
<div class="verbatim" id="verbatim-51">
\usepackage[xindy]{glossaries}
</div>
- <!--l. 1170--><p class="nopar" >
+ <!--l. 1176--><p class="nopar" >
</p></li>
<li
class="enumerate" id="x1-5054x2">Add <span
@@ -2298,19 +2304,19 @@ class="cmtt-10">\makeglossaries </span>to your preamble (before you start defini
</li>
<li
class="enumerate" id="x1-5056x3">Put
- <!--l. 1177--><p class="noindent" ><hr><div title="Definition"><span
+ <!--l. 1183--><p class="noindent" ><hr><div title="Definition"><span
class="cmtt-10">\printglossary[</span>&#x27E8;<span
class="cmitt-10">options</span>&#x27E9;<span
class="cmtt-10">] </span></div><hr>
- </p><!--l. 1178--><p class="noindent" >
+ </p><!--l. 1184--><p class="noindent" >
where you want your list of entries (glossary) to appear. (The <span
class="cmtt-10">sort </span>key
isn&#8217;t available in &#x27E8;<span
class="cmti-10">options</span>&#x27E9;.) Alternatively, use
- </p><!--l. 1183--><p class="noindent" ><hr><div title="Definition"><span
+ </p><!--l. 1189--><p class="noindent" ><hr><div title="Definition"><span
class="cmtt-10">\printglossaries </span></div><hr>
- </p><!--l. 1184--><p class="noindent" >
- </p><!--l. 1186--><p class="noindent" ><div class="important" title="Important Note"> All glossaries are sorted using the same method which may be identified
+ </p><!--l. 1190--><p class="noindent" >
+ </p><!--l. 1192--><p class="noindent" ><div class="important" title="Important Note"> All glossaries are sorted using the same method which may be identified
with one of the package options: <span
class="cmss-10">sort=standard</span><a
id="dx1-5057"></a> (default), <span
@@ -2319,7 +2325,7 @@ class="cmss-10">sort=use</span><a
<span
class="cmss-10">sort=def</span><a
id="dx1-5059"></a>. </div>
- </p><!--l. 1191--><p class="noindent" >
+ </p><!--l. 1197--><p class="noindent" >
</p></li>
<li
class="enumerate" id="x1-5061x4">Run <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span
@@ -2350,7 +2356,7 @@ class="cmtt-10">.tex </span>extension). If you have access to a terminal or a co
<div class="verbatim" id="verbatim-52">
makeglossaries&#x00A0;myDoc
</div>
- <!--l. 1207--><p class="nopar" > (Replace <span
+ <!--l. 1213--><p class="nopar" > (Replace <span
class="cmtt-10">myDoc </span>with the base name of your <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span
class="E">E</span>X</span></span>&#x00A0;document file
without the <span
@@ -2360,7 +2366,7 @@ class="cmtt-10">.tex </span>extension. Avoid spaces in the file name. If you don
class="cmtt-10">makeglossaries</span><a
id="dx1-5065"></a> as a build
tool.
- </p><!--l. 1215--><p class="noindent" >The default sort is word order (&#8220;sea lion&#8221; comes before &#8220;seal&#8221;). If you
+ </p><!--l. 1221--><p class="noindent" >The default sort is word order (&#8220;sea lion&#8221; comes before &#8220;seal&#8221;). If you
want letter ordering you need to add the <span
class="cmtt-10">order=letter </span>package
option:
@@ -2371,14 +2377,14 @@ class="cmtt-10">order=letter </span>package
<div class="verbatim" id="verbatim-53">
\usepackage[xindy,order=letter]{glossaries}
</div>
- <!--l. 1221--><p class="nopar" >
+ <!--l. 1227--><p class="nopar" >
</p></li>
<li
class="enumerate" id="x1-5067x6">Once you have successfully completed the previous step, you can now run
<span class="LATEX">L<span class="A">A</span><span class="TEX">T<span
class="E">E</span>X</span></span>&#x00A0;on your document again.
</li></ol>
- <!--l. 1227--><p class="noindent" >Here&#8217;s a complete document (<span
+ <!--l. 1233--><p class="noindent" >Here&#8217;s a complete document (<span
class="cmtt-10">myDoc.tex</span>):
@@ -2395,7 +2401,7 @@ class="cmtt-10">myDoc.tex</span>):
&#x00A0;<br />\printglossaries&#x00A0;%&#x00A0;input&#x00A0;files&#x00A0;created&#x00A0;by&#x00A0;xindy
&#x00A0;<br />\end{document}
</div>
- <!--l. 1243--><p class="nopar" > Document build:
+ <!--l. 1249--><p class="nopar" > Document build:
@@ -2405,14 +2411,14 @@ class="cmtt-10">myDoc.tex</span>):
&#x00A0;<br />makeglossaries&#x00A0;myDoc
&#x00A0;<br />pdflatex&#x00A0;myDoc
</div>
- <!--l. 1249--><p class="nopar" >
+ <!--l. 1255--><p class="nopar" >
</p></dd><dt class="description">
</dt><dd
class="description"><a
id="option4"></a><span
class="cmbx-10">Option</span><span
class="cmbx-10">&#x00A0;4</span>:
- <!--l. 1253--><p class="noindent" >This requires the extension package <span
+ <!--l. 1259--><p class="noindent" >This requires the extension package <span
class="cmss-10">glossaries-extra</span><a
id="dx1-5068"></a> and an application called
<span
@@ -2448,17 +2454,17 @@ class="cmss-10">glossaries-extra</span><a
<div class="verbatim" id="verbatim-56">
\usepackage[record]{glossaries-extra}
</div>
- <!--l. 1272--><p class="nopar" >
+ <!--l. 1278--><p class="nopar" >
</p></li>
<li
class="enumerate" id="x1-5075x2">Add one or more
- <!--l. 1276--><p class="noindent" ><hr><div title="Definition"><span
+ <!--l. 1282--><p class="noindent" ><hr><div title="Definition"><span
class="cmtt-10">\GlsXtrLoadResources[src={</span>&#x27E8;<span
class="cmitt-10">bib list</span>&#x27E9;<span
class="cmtt-10">},</span>&#x27E8;<span
class="cmitt-10">options</span>&#x27E9;<span
class="cmtt-10">] </span></div><hr>
- </p><!--l. 1277--><p class="noindent" >
+ </p><!--l. 1283--><p class="noindent" >
to your preamble where &#x27E8;<span
class="cmti-10">bib list</span>&#x27E9; is the list of <span
class="cmtt-10">.bib </span>files containing the
@@ -2496,7 +2502,7 @@ class="cmtt-10">.bib </span>files containing the
&#x00A0;<br />&#x00A0;&#x00A0;sort={double}%&#x00A0;double-precision&#x00A0;sort
&#x00A0;<br />]
</div>
- <!--l. 1309--><p class="nopar" > The last resource set assumes that the entries defined in the file
+ <!--l. 1315--><p class="nopar" > The last resource set assumes that the entries defined in the file
<span
class="cmtt-10">constants.bib </span>have a number stored in the <span
class="cmtt-10">user1 </span>field. For
@@ -2512,26 +2518,26 @@ class="cmtt-10">user1 </span>field. For
&#x00A0;<br />&#x00A0;&#x00A0;user1={3.141592654}
&#x00A0;<br />}
</div>
- <!--l. 1319--><p class="nopar" >
+ <!--l. 1325--><p class="nopar" >
</p></li>
<li
class="enumerate" id="x1-5077x3">Put
- <!--l. 1323--><p class="noindent" ><hr><div title="Definition"><span
+ <!--l. 1329--><p class="noindent" ><hr><div title="Definition"><span
class="cmtt-10">\printunsrtglossary[type={</span>&#x27E8;<span
class="cmitt-10">type</span>&#x27E9;<span
class="cmtt-10">},</span>&#x27E8;<span
class="cmitt-10">options</span>&#x27E9;<span
class="cmtt-10">] </span></div><hr>
- </p><!--l. 1324--><p class="noindent" >
+ </p><!--l. 1330--><p class="noindent" >
where you want your list of entries (glossary) to appear. (The <span
class="cmtt-10">sort </span>key
isn&#8217;t available in &#x27E8;<span
class="cmti-10">options</span>&#x27E9;. It needs to be used in <span
class="cmtt-10">\GlsXtrLoadResources</span>
instead.) Alternatively, use
- </p><!--l. 1330--><p class="noindent" ><hr><div title="Definition"><span
+ </p><!--l. 1336--><p class="noindent" ><hr><div title="Definition"><span
class="cmtt-10">\printunsrtglossaries </span></div><hr>
- </p><!--l. 1331--><p class="noindent" >
+ </p><!--l. 1337--><p class="noindent" >
</p></li>
<li
class="enumerate" id="x1-5079x4">Run <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span
@@ -2550,7 +2556,7 @@ class="cmtt-10">myDoc.tex</span>:
<div class="verbatim" id="verbatim-59">
pdflatex&#x00A0;myDoc
</div>
- <!--l. 1339--><p class="nopar" >
+ <!--l. 1345--><p class="nopar" >
</p></li>
<li
class="enumerate" id="x1-5083x5">Run <span
@@ -2562,7 +2568,7 @@ class="cmtt-10">bib2gls</span><a
<div class="verbatim" id="verbatim-60">
bib2gls&#x00A0;myDoc
</div>
- <!--l. 1344--><p class="nopar" > or (if you need letter groups)
+ <!--l. 1350--><p class="nopar" > or (if you need letter groups)
@@ -2570,12 +2576,12 @@ class="cmtt-10">bib2gls</span><a
<div class="verbatim" id="verbatim-61">
bib2gls&#x00A0;--group&#x00A0;myDoc
</div>
- <!--l. 1348--><p class="nopar" >
+ <!--l. 1354--><p class="nopar" >
</p></li>
<li
class="enumerate" id="x1-5086x6">Run <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span
class="E">E</span>X</span></span>&#x00A0;again.</li></ol>
- <!--l. 1352--><p class="noindent" >Here&#8217;s a complete document (<span
+ <!--l. 1358--><p class="noindent" >Here&#8217;s a complete document (<span
class="cmtt-10">myDoc.tex</span>):
@@ -2596,7 +2602,7 @@ class="cmtt-10">myDoc.tex</span>):
&#x00A0;<br />\printunsrtglossaries&#x00A0;%&#x00A0;iterate&#x00A0;over&#x00A0;all&#x00A0;defined&#x00A0;entries
&#x00A0;<br />\end{document}
</div>
- <!--l. 1372--><p class="nopar" > The accompanying <span
+ <!--l. 1378--><p class="nopar" > The accompanying <span
class="cmtt-10">entries.bib </span>file:
@@ -2608,7 +2614,7 @@ class="cmtt-10">entries.bib </span>file:
&#x00A0;<br />&#x00A0;&#x00A0;description&#x00A0;=&#x00A0;{an&#x00A0;example}
&#x00A0;<br />}
</div>
- <!--l. 1379--><p class="nopar" > Document build:
+ <!--l. 1385--><p class="nopar" > Document build:
@@ -2618,10 +2624,10 @@ class="cmtt-10">entries.bib </span>file:
&#x00A0;<br />bib2gls&#x00A0;myDoc
&#x00A0;<br />pdflatex&#x00A0;myDoc
</div>
- <!--l. 1385--><p class="nopar" >
+ <!--l. 1391--><p class="nopar" >
</p>
</dd></dl>
-<!--l. 1389--><p class="indent" > If you are having difficulty integrating <span
+<!--l. 1395--><p class="indent" > If you are having difficulty integrating <span
class="cmtt-10">makeglossaries</span><a
id="dx1-5087"></a> into your document build
process, you may want to consider using <span
@@ -2644,7 +2650,7 @@ class="cmtt-10">myDoc.tex </span>might start with:
&#x00A0;<br />&#x00A0;\usepackage{glossaries}
&#x00A0;<br />&#x00A0;\makeglossaries
</div>
-<!--l. 1402--><p class="nopar" > then to build the document you just need the single system call:
+<!--l. 1408--><p class="nopar" > then to build the document you just need the single system call:
@@ -2652,7 +2658,7 @@ class="cmtt-10">myDoc.tex </span>might start with:
<div class="verbatim" id="verbatim-66">
&#x00A0;arara&#x00A0;myDoc
</div>
-<!--l. 1406--><p class="nopar" > (The currently pending version 4.0 of <span
+<!--l. 1412--><p class="nopar" > (The currently pending version 4.0 of <span
class="cmtt-10">arara</span><a
id="dx1-5090"></a> has directives for <span
class="cmtt-10">makeglossaries-lite</span><a
@@ -2665,7 +2671,7 @@ class="cmtt-10">makeglossaries.yaml </span>file and replace <span
class="cmtt-10">makeglossaries</span><a
id="dx1-5093"></a> as
appropriate.)
-</p><!--l. 1413--><p class="indent" > When sorting the entries, the string comparisons are made according to each
+</p><!--l. 1419--><p class="indent" > When sorting the entries, the string comparisons are made according to each
entry&#8217;s <span
class="cmtt-10">sort </span>key. If this is omitted, the <span
class="cmtt-10">name </span>key is used. For example, recall the
@@ -2681,7 +2687,7 @@ earlier definition:
&#x00A0;<br />&#x00A0;&#x00A0;&#x00A0;description={select&#x00A0;group&#x00A0;or&#x00A0;class}
&#x00A0;<br />&#x00A0;}
</div>
-<!--l. 1423--><p class="nopar" > No <span
+<!--l. 1429--><p class="nopar" > No <span
class="cmtt-10">sort </span>key was used, so it&#8217;s set to the same as the <span
class="cmtt-10">name </span>key: <span class="obeylines-h"><span class="verb"><span
class="cmtt-10">{\&#8217;e}lite</span></span></span>. How this
@@ -2746,7 +2752,7 @@ class="cmtt-10">sort </span>value that <span
class="cmtt-10">xindy</span><a
id="dx1-5098"></a> will
accept.
- <!--l. 1449--><p class="noindent" ><div class="important" title="Important Note"> <span
+ <!--l. 1455--><p class="noindent" ><div class="important" title="Important Note"> <span
class="cmtt-10">xindy</span><a
id="dx1-5099"></a> merges entries with duplicate sort values. <span
class="cmtt-10">xindy</span><a
@@ -2755,7 +2761,7 @@ class="cmtt-10">xindy</span><a
class="cmtt-10">xindy</span><a
id="dx1-5101"></a>
has stripped all commands and braces. </div>
- </p><!--l. 1454--><p class="noindent" >
+ </p><!--l. 1460--><p class="noindent" >
</p></dd><dt class="description">
<a
href="#option4"><span
@@ -2775,7 +2781,7 @@ class="cmtt-10">lite</span>. It disregards unknown
class="cmtt-10">bib2gls</span><a
id="dx1-5103"></a> doesn&#8217;t mind
that.
- <!--l. 1463--><p class="noindent" >Note that even if the name is given as <span class="obeylines-h"><span class="verb"><span
+ <!--l. 1469--><p class="noindent" >Note that even if the name is given as <span class="obeylines-h"><span class="verb"><span
class="cmtt-10">{\&#8217;e}lite</span></span></span>, the letter group heading
(if the <span class="obeylines-h"><span class="verb"><span
class="cmtt-10">--group</span></span></span> switch is used) may end up with the character É
@@ -2791,7 +2797,7 @@ class="E">E</span>X</span></span>&#x00A0;engine with native UTF-8
support.
</p>
</dd></dl>
-<!--l. 1473--><p class="indent" > If the <span
+<!--l. 1479--><p class="indent" > If the <span
class="cmss-10">inputenc</span><a
id="dx1-5105"></a> package is used:
@@ -2801,7 +2807,7 @@ class="cmss-10">inputenc</span><a
<div class="verbatim" id="verbatim-68">
&#x00A0;\usepackage[utf8]{inputenc}
</div>
-<!--l. 1476--><p class="nopar" > and the entry is defined as: </p><div class="alltt">
+<!--l. 1482--><p class="nopar" > and the entry is defined as: </p><div class="alltt">
<div class="obeylines-v">
<span
class="cmtt-10">&#x00A0;</span><span class="verb"><span
@@ -2902,7 +2908,7 @@ class="cmtt-10">&#x00A0;UTF-8</span>
</div>
</div>
- <!--l. 1516--><p class="noindent" >With the correct encoding set up, <span
+ <!--l. 1522--><p class="noindent" >With the correct encoding set up, <span
class="cmtt-10">bib2gls</span><a
id="dx1-5111"></a> will determine that the sort value is
<span
@@ -2917,7 +2923,7 @@ class="cmtt-10">lite </span>in the
group.
</p>
</dd></dl>
-<!--l. 1525--><p class="indent" > Therefore if you have extended Latin or non-Latin characters, your best option is
+<!--l. 1531--><p class="indent" > Therefore if you have extended Latin or non-Latin characters, your best option is
to use either <span
class="cmtt-10">xindy</span><a
id="dx1-5112"></a> (<a
@@ -2947,7 +2953,7 @@ this:
&#x00A0;<br />&#x00A0;&#x00A0;description={select&#x00A0;group&#x00A0;or&#x00A0;class}
&#x00A0;<br />}
</div>
-<!--l. 1537--><p class="nopar" > or </p><div class="alltt">
+<!--l. 1543--><p class="nopar" > or </p><div class="alltt">
<div class="obeylines-v">
<span
class="cmtt-10">\newglossaryentry</span><span
@@ -2991,7 +2997,7 @@ need to be careful about fragile commands in the <span
class="cmtt-10">name </span>key if you don&#8217;t set the <span
class="cmtt-10">sort</span>
key.
-<!--l. 1551--><p class="indent" > If you use <a
+<!--l. 1557--><p class="indent" > If you use <a
href="#option3">Option&#x00A0;3</a> and the <span
class="cmtt-10">name </span>only contains a command or commands (such
as <span
@@ -3010,12 +3016,12 @@ example:
&#x00A0;\newglossaryentry{P}{name={\P},sort={P},
&#x00A0;<br />&#x00A0;&#x00A0;description={paragraph&#x00A0;symbol}}
</div>
-<!--l. 1558--><p class="nopar" >
+<!--l. 1564--><p class="nopar" >
</p>
-<!--l. 1560--><p class="noindent" ><a
+<!--l. 1566--><p class="noindent" ><a
href="#top">Top</a><h2 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">5 </span> <a
id="sec:glosstyle"></a>Customising the Glossary</h3>
-<!--l. 1563--><p class="noindent" >The default glossary style uses the <span
+<!--l. 1569--><p class="noindent" >The default glossary style uses the <span
class="cmss-10">description</span><a
id="dx1-6001"></a><a
id="dx1-6002"></a> environment to display the entry list.
@@ -3031,14 +3037,14 @@ class="cmtt-10">\glsnamefont</span>:
<div class="verbatim" id="verbatim-71">
\renewcommand*{\glsnamefont}[1]{\textmd{#1}}
</div>
-<!--l. 1570--><p class="nopar" > Some classes and packages redefine the <span
+<!--l. 1576--><p class="nopar" > Some classes and packages redefine the <span
class="cmss-10">description</span><a
id="dx1-6003"></a><a
id="dx1-6004"></a> environment in such as way that&#8217;s
incompatible with the <span
class="cmss-10">glossaries </span>package. In which case you&#8217;ll need to select a
different glossary style (see below).
-</p><!--l. 1576--><p class="indent" > By default, a&#x00A0;full stop is appended to the description (unless you use
+</p><!--l. 1582--><p class="indent" > By default, a&#x00A0;full stop is appended to the description (unless you use
<span
class="cmss-10">glossaries-extra</span><a
id="dx1-6005"></a>). To prevent this from happening use the <span
@@ -3052,7 +3058,7 @@ option:
<div class="verbatim" id="verbatim-72">
\usepackage[nopostdot]{glossaries}
</div>
-<!--l. 1581--><p class="nopar" > or to add it with <span
+<!--l. 1587--><p class="nopar" > or to add it with <span
class="cmss-10">glossaries-extra</span>:
@@ -3061,8 +3067,8 @@ class="cmss-10">glossaries-extra</span>:
<div class="verbatim" id="verbatim-73">
\usepackage[postdot]{glossaries-extra}
</div>
-<!--l. 1585--><p class="nopar" >
-</p><!--l. 1587--><p class="indent" > By default, a&#x00A0;location list is displayed for each entry (unless you use
+<!--l. 1591--><p class="nopar" >
+</p><!--l. 1593--><p class="indent" > By default, a&#x00A0;location list is displayed for each entry (unless you use
<span
class="cmtt-10">\printunsrtglossary </span>without <span
class="cmtt-10">bib2gls</span><a
@@ -3097,14 +3103,14 @@ option:
<div class="verbatim" id="verbatim-74">
\usepackage[nonumberlist]{glossaries}
</div>
-<!--l. 1599--><p class="nopar" > or with <span
+<!--l. 1605--><p class="nopar" > or with <span
class="cmtt-10">bib2gls</span><a
id="dx1-6011"></a> use <span
class="cmtt-10">save-locations=false </span>in the optional argument of the
appropriate <span
class="cmtt-10">\GlsXtrLoadResources </span>(it&#8217;s possible to have some resource sets with
locations and some without).
-</p><!--l. 1605--><p class="indent" > Entries are grouped according to the first letter of each entry&#8217;s <span
+</p><!--l. 1611--><p class="indent" > Entries are grouped according to the first letter of each entry&#8217;s <span
class="cmtt-10">sort </span>key. By
default a&#x00A0;vertical gap is placed between letter groups. You can suppress this with the
<span
@@ -3117,14 +3123,14 @@ class="cmss-10">nogroupskip</span><a
<div class="verbatim" id="verbatim-75">
\usepackage[nogroupskip]{glossaries}
</div>
-<!--l. 1611--><p class="nopar" >
-</p><!--l. 1613--><p class="indent" > If the default style doesn&#8217;t suit your document, you can change the style
+<!--l. 1617--><p class="nopar" >
+</p><!--l. 1619--><p class="indent" > If the default style doesn&#8217;t suit your document, you can change the style
using:
-</p><!--l. 1616--><p class="indent" > <hr><div title="Definition"><span
+</p><!--l. 1622--><p class="indent" > <hr><div title="Definition"><span
class="cmtt-10">\setglossarystyle{</span>&#x27E8;<span
class="cmitt-10">style name</span>&#x27E9;<span
class="cmtt-10">} </span></div><hr>
-</p><!--l. 1617--><p class="noindent" >
+</p><!--l. 1623--><p class="noindent" >
<a
href="http://www.dickimaw-books.com/gallery/glossaries-styles/" >There are a&#x00A0;number of predefined styles.</a> Glossaries can vary from a&#x00A0;list of symbols
with a&#x00A0;terse description to a&#x00A0;list of words or phrases with descriptions that span
@@ -3137,7 +3143,7 @@ a&#x00A0;style that suits your document. For example:
<div class="verbatim" id="verbatim-76">
\setglossarystyle{index}
</div>
-<!--l. 1625--><p class="nopar" > You can also use the <span
+<!--l. 1631--><p class="nopar" > You can also use the <span
class="cmss-10">style</span><a
id="dx1-6013"></a> package option for the preloaded styles. For example:
@@ -3147,8 +3153,8 @@ class="cmss-10">style</span><a
<div class="verbatim" id="verbatim-77">
\usepackage[style=index]{glossaries}
</div>
-<!--l. 1630--><p class="nopar" >
-</p><!--l. 1632--><p class="indent" > Examples:
+<!--l. 1636--><p class="nopar" >
+</p><!--l. 1638--><p class="indent" > Examples:
</p><ol class="enumerate1" >
<li
class="enumerate" id="x1-6015x1">You have entries where the name is a&#x00A0;symbol and the description is a&#x00A0;brief
@@ -3164,7 +3170,7 @@ class="cmss-10">glossary-mcols</span><a
&#x00A0;<br />\usepackage{glossary-mcols}
&#x00A0;<br />\setglossarystyle{mcolindex}
</div>
- <!--l. 1641--><p class="nopar" > or
+ <!--l. 1647--><p class="nopar" > or
@@ -3172,7 +3178,7 @@ class="cmss-10">glossary-mcols</span><a
<div class="verbatim" id="verbatim-79">
\usepackage[stylemods={mcols},style=mcolindex]{glossaries-extra}
</div>
- <!--l. 1645--><p class="nopar" >
+ <!--l. 1651--><p class="nopar" >
</p></li>
<li
class="enumerate" id="x1-6018x2">You have entries where the name is a&#x00A0;word or phrase and the description spans
@@ -3184,7 +3190,7 @@ class="cmss-10">glossary-mcols</span><a
\usepackage[nopostdot]{glossaries}
&#x00A0;<br />\setglossarystyle{altlist}
</div>
- <!--l. 1653--><p class="nopar" > or
+ <!--l. 1659--><p class="nopar" > or
@@ -3192,7 +3198,7 @@ class="cmss-10">glossary-mcols</span><a
<div class="verbatim" id="verbatim-81">
\usepackage[stylemods,style=altlist]{glossaries-extra}
</div>
- <!--l. 1657--><p class="nopar" >
+ <!--l. 1663--><p class="nopar" >
</p></li>
<li
class="enumerate" id="x1-6020x3">You have entries where the name is a&#x00A0;single word, the description is
@@ -3206,7 +3212,7 @@ class="cmss-10">glossary-mcols</span><a
\usepackage[nopostdot,nonumberlist]{glossaries}
&#x00A0;<br />\setglossarystyle{long4col}
</div>
- <!--l. 1666--><p class="nopar" > or one of the &#8220;tree&#8221; styles:
+ <!--l. 1672--><p class="nopar" > or one of the &#8220;tree&#8221; styles:
@@ -3215,8 +3221,8 @@ class="cmss-10">glossary-mcols</span><a
\usepackage[nopostdot,nonumberlist]{glossaries}
&#x00A0;<br />\setglossarystyle{tree}
</div>
- <!--l. 1671--><p class="nopar" ></p></li></ol>
-<!--l. 1674--><p class="indent" > If your glossary consists of a&#x00A0;list of abbreviations and you also want to specify
+ <!--l. 1677--><p class="nopar" ></p></li></ol>
+<!--l. 1680--><p class="indent" > If your glossary consists of a&#x00A0;list of abbreviations and you also want to specify
a&#x00A0;description as well as the long form, then you need to use an abbreviation style
that will suit the glossary style. For example, use the <span
class="cmtt-10">long-short-desc </span>acronym
@@ -3228,7 +3234,7 @@ style:
<div class="verbatim" id="verbatim-84">
\setacronymstyle{long-short-desc}
</div>
-<!--l. 1680--><p class="nopar" > Define the acronyms with a&#x00A0;description:
+<!--l. 1686--><p class="nopar" > Define the acronyms with a&#x00A0;description:
@@ -3238,7 +3244,7 @@ style:
&#x00A0;<br />&#x00A0;[description={statistical&#x00A0;pattern&#x00A0;recognition&#x00A0;technique}]
&#x00A0;<br />&#x00A0;{svm}{SVM}{support&#x00A0;vector&#x00A0;machine}
</div>
-<!--l. 1686--><p class="nopar" > Alternatively with <span
+<!--l. 1692--><p class="nopar" > Alternatively with <span
class="cmss-10">glossaries-extra</span><a
id="dx1-6021"></a>:
@@ -3251,8 +3257,8 @@ class="cmss-10">glossaries-extra</span><a
&#x00A0;<br />&#x00A0;[description={statistical&#x00A0;pattern&#x00A0;recognition&#x00A0;technique}]
&#x00A0;<br />&#x00A0;{svm}{SVM}{support&#x00A0;vector&#x00A0;machine}
</div>
-<!--l. 1694--><p class="nopar" >
-</p><!--l. 1696--><p class="indent" > Choose a&#x00A0;glossary style that suits wide entry names. For example:
+<!--l. 1700--><p class="nopar" >
+</p><!--l. 1702--><p class="indent" > Choose a&#x00A0;glossary style that suits wide entry names. For example:
@@ -3260,13 +3266,13 @@ class="cmss-10">glossaries-extra</span><a
<div class="verbatim" id="verbatim-87">
\setglossarystyle{altlist}
</div>
-<!--l. 1699--><p class="nopar" >
-</p><!--l. 1701--><p class="noindent" >
+<!--l. 1705--><p class="nopar" >
+</p><!--l. 1707--><p class="noindent" >
</p>
-<!--l. 1701--><p class="noindent" ><a
+<!--l. 1707--><p class="noindent" ><a
href="#top">Top</a><h2 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">6 </span> <a
id="sec:multigloss"></a>Multiple Glossaries</h3>
-<!--l. 1704--><p class="noindent" >The <span
+<!--l. 1710--><p class="noindent" >The <span
class="cmss-10">glossaries</span><a
id="dx1-7001"></a> package predefines a&#x00A0;default <span
class="cmtt-10">main </span>glossary. When you define an entry
@@ -3278,7 +3284,7 @@ automatically assigned to the default glossary, unless you indicate otherwise us
<span
class="cmtt-10">type </span>key. However you first need to make sure the desired glossary has been defined.
This is done using:
-</p><!--l. 1711--><p class="indent" > <hr><div title="Definition"><span
+</p><!--l. 1717--><p class="indent" > <hr><div title="Definition"><span
class="cmtt-10">\newglossary[</span>&#x27E8;<span
class="cmitt-10">glg</span>&#x27E9;<span
class="cmtt-10">]{</span>&#x27E8;<span
@@ -3290,7 +3296,7 @@ class="cmitt-10">glo</span>&#x27E9;<span
class="cmtt-10">}{</span>&#x27E8;<span
class="cmitt-10">title</span>&#x27E9;<span
class="cmtt-10">} </span></div><hr>
-</p><!--l. 1712--><p class="noindent" >
+</p><!--l. 1718--><p class="noindent" >
The &#x27E8;<span
class="cmti-10">label</span>&#x27E9; is a&#x00A0;label that uniquely identifies this new glossary. As with other types of
identifying labels, be careful not to use active characters in &#x27E8;<span
@@ -3318,14 +3324,14 @@ class="cmti-10">gls</span>&#x27E9; and &#x27E8;<span
class="cmti-10">glo</span>&#x27E9;
arguments are ignored, in which case you may prefer to use the starred version where
you don&#8217;t specify the extensions:
-</p><!--l. 1726--><p class="indent" > <hr><div title="Definition"><span
+</p><!--l. 1732--><p class="indent" > <hr><div title="Definition"><span
class="cmtt-10">\newglossary*{</span>&#x27E8;<span
class="cmitt-10">label</span>&#x27E9;<span
class="cmtt-10">}{</span>&#x27E8;<span
class="cmitt-10">title</span>&#x27E9;<span
class="cmtt-10">} </span></div><hr>
-</p><!--l. 1727--><p class="noindent" >
-</p><!--l. 1729--><p class="indent" > In the case of Options&#x00A0;<a
+</p><!--l. 1733--><p class="noindent" >
+</p><!--l. 1735--><p class="indent" > In the case of Options&#x00A0;<a
href="#option2">2</a> or&#x00A0;<a
href="#option3">3</a>, all glossary definitions must come before
<span
@@ -3335,7 +3341,7 @@ of <a
href="#option4">Option&#x00A0;4</a>, all glossary definitions must come before any <span
class="cmtt-10">\GlsXtrLoadResources</span>
that requires them.
-</p><!--l. 1734--><p class="indent" > Since it&#8217;s quite common for documents to have both a&#x00A0;list of terms and a&#x00A0;list of
+</p><!--l. 1740--><p class="indent" > Since it&#8217;s quite common for documents to have both a&#x00A0;list of terms and a&#x00A0;list of
abbreviations, the <span
class="cmss-10">glossaries</span><a
id="dx1-7005"></a> package provides the package option <span
@@ -3351,7 +3357,7 @@ class="cmss-10">acronyms</span><a
<div class="verbatim" id="verbatim-88">
\newglossary[alg]{acronym}{acr}{acn}{\acronymname}
</div>
-<!--l. 1740--><p class="nopar" > The option also changes the behaviour of <span
+<!--l. 1746--><p class="nopar" > The option also changes the behaviour of <span
class="cmtt-10">\newacronym </span>so that acronyms are
automatically put in the list of acronyms instead of the main glossary. The
<span
@@ -3363,7 +3369,7 @@ class="cmss-10">abbreviations</span><a
id="dx1-7009"></a> to create a list of
abbreviations for <span
class="cmtt-10">\newabbreviation</span>.
-</p><!--l. 1748--><p class="indent" > There are some other package options for creating commonly used lists: <span
+</p><!--l. 1754--><p class="indent" > There are some other package options for creating commonly used lists: <span
class="cmss-10">symbols</span><a
id="dx1-7010"></a>
(lists of symbols), <span
@@ -3377,7 +3383,7 @@ class="cmti-10">options</span>&#x27E9;<span
class="cmtt-10">]{</span>&#x27E8;<span
class="cmti-10">label</span>&#x27E9;<span
class="cmtt-10">}</span>).
-</p><!--l. 1753--><p class="indent" > For example, suppose you want a&#x00A0;main glossary for terms, a&#x00A0;list of acronyms and
+</p><!--l. 1759--><p class="indent" > For example, suppose you want a&#x00A0;main glossary for terms, a&#x00A0;list of acronyms and
a&#x00A0;list of notation:
@@ -3387,7 +3393,7 @@ a&#x00A0;list of notation:
&#x00A0;\usepackage[acronyms]{glossaries}
&#x00A0;<br />&#x00A0;\newglossary[nlg]{notation}{not}{ntn}{Notation}
</div>
-<!--l. 1758--><p class="nopar" > After <span
+<!--l. 1764--><p class="nopar" > After <span
class="cmtt-10">\makeglossaries </span>(or <span
class="cmtt-10">\makenoidxglossaries</span>) you can define the entries in
the preamble. For example:
@@ -3410,7 +3416,7 @@ the preamble. For example:
&#x00A0;<br />&#x00A0;&#x00A0;&#x00A0;description={A&#x00A0;set},
&#x00A0;<br />&#x00A0;&#x00A0;&#x00A0;sort={S}}
</div>
-<!--l. 1777--><p class="nopar" > or if you don&#8217;t like using <span
+<!--l. 1783--><p class="nopar" > or if you don&#8217;t like using <span
class="cmtt-10">\ensuremath</span>:
@@ -3425,34 +3431,34 @@ class="cmtt-10">\ensuremath</span>:
&#x00A0;<br />&#x00A0;&#x00A0;&#x00A0;description={A&#x00A0;set},
&#x00A0;<br />&#x00A0;&#x00A0;&#x00A0;sort={S}}
</div>
-<!--l. 1787--><p class="nopar" >
-</p><!--l. 1789--><p class="indent" > Each glossary is displayed using:
-</p><!--l. 1791--><p class="indent" > <hr><div title="Definition"><span
+<!--l. 1793--><p class="nopar" >
+</p><!--l. 1795--><p class="indent" > Each glossary is displayed using:
+</p><!--l. 1797--><p class="indent" > <hr><div title="Definition"><span
class="cmtt-10">\printnoidxglossary[type=</span>&#x27E8;<span
class="cmitt-10">type</span>&#x27E9;<span
class="cmtt-10">] </span></div><hr>
-</p><!--l. 1792--><p class="noindent" >
+</p><!--l. 1798--><p class="noindent" >
(<a
href="#option1">Option&#x00A0;1</a>) or
-</p><!--l. 1795--><p class="indent" > <hr><div title="Definition"><span
+</p><!--l. 1801--><p class="indent" > <hr><div title="Definition"><span
class="cmtt-10">\printglossary[type=</span>&#x27E8;<span
class="cmitt-10">type</span>&#x27E9;<span
class="cmtt-10">] </span></div><hr>
-</p><!--l. 1796--><p class="noindent" >
+</p><!--l. 1802--><p class="noindent" >
(Options&#x00A0;<a
href="#option2">2</a> and&#x00A0;<a
href="#option3">3</a>). Where &#x27E8;<span
class="cmti-10">type</span>&#x27E9; is the glossary label. If the type is omitted the
default <span
class="cmtt-10">main </span>glossary is assumed.
-</p><!--l. 1800--><p class="indent" > If you&#8217;re using <span
+</p><!--l. 1806--><p class="indent" > If you&#8217;re using <span
class="cmtt-10">bib2gls</span><a
id="dx1-7013"></a> then each glossary is displayed using:
-</p><!--l. 1803--><p class="indent" > <hr><div title="Definition"><span
+</p><!--l. 1809--><p class="indent" > <hr><div title="Definition"><span
class="cmtt-10">\printunsrtglossary[type=</span>&#x27E8;<span
class="cmitt-10">type</span>&#x27E9;<span
class="cmtt-10">] </span></div><hr>
-</p><!--l. 1804--><p class="noindent" >
+</p><!--l. 1810--><p class="noindent" >
With this method you don&#8217;t use <span
class="cmtt-10">\makeglossaries </span>or <span
class="cmtt-10">\makenoidxglossaries</span>.
@@ -3476,7 +3482,7 @@ Instead you can assign the entry type with the resource command. For example:
&#x00A0;<br />&#x00A0;&#x00A0;type={symbols}%&#x00A0;put&#x00A0;in&#x00A0;symbols&#x00A0;glossary
&#x00A0;<br />&#x00A0;]
</div>
-<!--l. 1823--><p class="nopar" > Later in the document:
+<!--l. 1829--><p class="nopar" > Later in the document:
@@ -3486,26 +3492,26 @@ Instead you can assign the entry type with the resource command. For example:
&#x00A0;<br />&#x00A0;\printunsrtglossary[type=abbreviations]
&#x00A0;<br />&#x00A0;\printunsrtglossary[type=symbols]
</div>
-<!--l. 1829--><p class="nopar" >
-</p><!--l. 1831--><p class="indent" > There&#8217;s a&#x00A0;convenient shortcut that will display all the defined glossaries
+<!--l. 1835--><p class="nopar" >
+</p><!--l. 1837--><p class="indent" > There&#8217;s a&#x00A0;convenient shortcut that will display all the defined glossaries
depending on the indexing method:
-</p><!--l. 1834--><p class="indent" > <hr><div title="Definition"><span
+</p><!--l. 1840--><p class="indent" > <hr><div title="Definition"><span
class="cmtt-10">\printnoidxglossaries </span></div><hr>
-</p><!--l. 1835--><p class="noindent" >
+</p><!--l. 1841--><p class="noindent" >
(<a
href="#option1">Option&#x00A0;1</a>) or
-</p><!--l. 1838--><p class="indent" > <hr><div title="Definition"><span
+</p><!--l. 1844--><p class="indent" > <hr><div title="Definition"><span
class="cmtt-10">\printglossaries </span></div><hr>
-</p><!--l. 1839--><p class="noindent" >
+</p><!--l. 1845--><p class="noindent" >
(Options&#x00A0;<a
href="#option2">2</a> and&#x00A0;<a
href="#option3">3</a>) or (<span
class="cmss-10">glossaries-extra</span><a
id="dx1-7014"></a> only)
-</p><!--l. 1842--><p class="indent" > <hr><div title="Definition"><span
+</p><!--l. 1848--><p class="indent" > <hr><div title="Definition"><span
class="cmtt-10">\printunsrtglossaries </span></div><hr>
-</p><!--l. 1843--><p class="noindent" >
-</p><!--l. 1845--><p class="indent" > If you use <a
+</p><!--l. 1849--><p class="noindent" >
+</p><!--l. 1851--><p class="indent" > If you use <a
href="#option1">Option&#x00A0;1</a>, you don&#8217;t need to do anything else. If you use Options&#x00A0;<a
href="#option2">2</a>
or&#x00A0;<a
@@ -3540,7 +3546,7 @@ class="cmtt-10">makeindex</span><a
class="cmtt-10">xindy</span><a
id="dx1-7021"></a> errors or warnings if things go
wrong.
-</p><!--l. 1859--><p class="indent" > For example, suppose you have three glossaries in your document (<span
+</p><!--l. 1865--><p class="indent" > For example, suppose you have three glossaries in your document (<span
class="cmtt-10">main</span>, <span
class="cmtt-10">acronym</span>
and <span
@@ -3553,10 +3559,10 @@ class="cmtt-10">notation</span>), specified using:
\usepackage[acronyms]{glossaries}
&#x00A0;<br />\newglossary[nlg]{notation}{not}{ntn}{Notation}
</div>
-<!--l. 1865--><p class="nopar" > Then (assuming your <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span
+<!--l. 1871--><p class="nopar" > Then (assuming your <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span
class="E">E</span>X</span></span>&#x00A0;document is in a&#x00A0;file called <span
class="cmtt-10">myDoc.tex</span>):
-</p><!--l. 1869--><p class="indent" >
+</p><!--l. 1875--><p class="indent" >
</p><dl class="description"><dt class="description">
</dt><dd
class="description"><a
@@ -3571,7 +3577,7 @@ class="cmtt-10">makeglossaries-lite</span><a
<div class="verbatim" id="verbatim-95">
makeglossaries&#x00A0;myDoc
</div>
- <!--l. 1875--><p class="nopar" > or
+ <!--l. 1881--><p class="nopar" > or
@@ -3579,7 +3585,7 @@ class="cmtt-10">makeglossaries-lite</span><a
<div class="verbatim" id="verbatim-96">
makeglossaries-lite&#x00A0;myDoc
</div>
- <!--l. 1879--><p class="nopar" > Or you need to run <span
+ <!--l. 1885--><p class="nopar" > Or you need to run <span
class="cmtt-10">makeindex</span><a
id="dx1-7024"></a> three times:
@@ -3591,7 +3597,7 @@ class="cmtt-10">makeindex</span><a
&#x00A0;<br />makeindex&#x00A0;-t&#x00A0;myDoc.alg&#x00A0;-s&#x00A0;myDoc.ist&#x00A0;-o&#x00A0;myDoc.acr&#x00A0;myDoc.acn
&#x00A0;<br />makeindex&#x00A0;-t&#x00A0;myDoc.nlg&#x00A0;-s&#x00A0;myDoc.ist&#x00A0;-o&#x00A0;myDoc.not&#x00A0;myDoc.ntn
</div>
- <!--l. 1885--><p class="nopar" >
+ <!--l. 1891--><p class="nopar" >
</p></dd><dt class="description">
</dt><dd
class="description"><a
@@ -3604,7 +3610,7 @@ class="cmtt-10">makeglossaries</span><a
<div class="verbatim" id="verbatim-98">
makeglossaries&#x00A0;myDoc
</div>
- <!--l. 1891--><p class="nopar" > Or you need to run <span
+ <!--l. 1897--><p class="nopar" > Or you need to run <span
class="cmtt-10">xindy</span><a
id="dx1-7026"></a> three times (be careful not to insert line breaks
where the line has wrapped.)
@@ -3620,7 +3626,7 @@ class="cmtt-10">xindy</span><a
&#x00A0;<br />xindy&#x00A0;&#x00A0;-L&#x00A0;english&#x00A0;-C&#x00A0;utf8&#x00A0;-I&#x00A0;xindy&#x00A0;-M&#x00A0;myDoc&#x00A0;-t&#x00A0;myDoc.nlg
&#x00A0;<br />-o&#x00A0;myDoc.not&#x00A0;myDoc.ntn
</div>
- <!--l. 1901--><p class="nopar" >
+ <!--l. 1907--><p class="nopar" >
</p></dd><dt class="description">
</dt><dd
class="description"><a
@@ -3635,16 +3641,16 @@ class="cmtt-10">bib2gls</span><a
&#x00A0;<br />bib2gls&#x00A0;--group&#x00A0;myDoc
&#x00A0;<br />pdflatex&#x00A0;myDoc
</div>
- <!--l. 1909--><p class="nopar" > (Omit <span class="obeylines-h"><span class="verb"><span
+ <!--l. 1915--><p class="nopar" > (Omit <span class="obeylines-h"><span class="verb"><span
class="cmtt-10">--group</span></span></span> if you don&#8217;t need letter groups.)</p></dd></dl>
-<!--l. 1914--><p class="noindent" >
+<!--l. 1920--><p class="noindent" >
</p>
-<!--l. 1914--><p class="noindent" ><a
+<!--l. 1920--><p class="noindent" ><a
href="#top">Top</a><h2 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">7 </span> <a
id="sec:hyperref"></a><span
class="cmss-10">glossaries </span>and <span
class="cmss-10">hyperref</span></h3>
-<!--l. 1917--><p class="noindent" >Take care if you use the <span
+<!--l. 1923--><p class="noindent" >Take care if you use the <span
class="cmss-10">glossaries</span><a
id="dx1-8001"></a> package with <span
class="cmss-10">hyperref</span><a
@@ -3668,7 +3674,7 @@ class="cmss-10">hyperref</span><a
\usepackage[colorlinks]{hyperref}
&#x00A0;<br />\usepackage{glossaries}
</div>
-<!--l. 1924--><p class="nopar" > If you use <span
+<!--l. 1930--><p class="nopar" > If you use <span
class="cmss-10">hyperref</span><a
id="dx1-8007"></a> make sure you use PDF<span class="LATEX">L<span class="A">A</span><span class="TEX">T<span
class="E">E</span>X</span></span>&#x00A0;rather than the <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span
@@ -3677,16 +3683,16 @@ engine. The DVI format can&#8217;t break hyperlinks across a&#x00A0;line so long
(such as the full form of acronyms) won&#8217;t line wrap with the DVI engine.
Also, hyperlinks in sub- or superscripts aren&#8217;t correctly sized with the DVI
format.
-</p><!--l. 1931--><p class="indent" > By default, if the <span
+</p><!--l. 1937--><p class="indent" > By default, if the <span
class="cmss-10">hyperref</span><a
id="dx1-8008"></a> package has been loaded, commands like <span
class="cmtt-10">\gls </span>will form
a&#x00A0;hyperlink to the relevant entry in the glossary. If you to disable this for <span
class="cmti-10">all </span>your
glossaries, then use
-</p><!--l. 1936--><p class="indent" > <hr><div title="Definition"><span
+</p><!--l. 1942--><p class="indent" > <hr><div title="Definition"><span
class="cmtt-10">\glsdisablehyper </span></div><hr>
-</p><!--l. 1937--><p class="noindent" >
+</p><!--l. 1943--><p class="noindent" >
If you want hyperlinks suppressed for entries in specific glossaries, then use the
<span
class="cmss-10">nohypertypes</span><a
@@ -3705,8 +3711,8 @@ glossary, then do:
&#x00A0;<br />\usepackage[acronym,nohypertypes={acronym,notation}]{glossaries}
&#x00A0;<br />\newglossary[nlg]{notation}{not}{ntn}{Notation}
</div>
-<!--l. 1947--><p class="nopar" >
-</p><!--l. 1949--><p class="indent" > If you want the hyperlinks suppressed the first time an entry is used, but you
+<!--l. 1953--><p class="nopar" >
+</p><!--l. 1955--><p class="indent" > If you want the hyperlinks suppressed the first time an entry is used, but you
want hyperlinks for subsequence references then use the <span
class="cmss-10">hyperfirst=false</span><a
id="dx1-8010"></a> package
@@ -3719,8 +3725,8 @@ option:
\usepackage[colorlinks]{hyperref}
&#x00A0;<br />\usepackage[hyperfirst=false]{glossaries}
</div>
-<!--l. 1955--><p class="nopar" >
-</p><!--l. 1957--><p class="indent" > Take care not to use non-expandable commands in PDF bookmarks. This isn&#8217;t
+<!--l. 1961--><p class="nopar" >
+</p><!--l. 1963--><p class="indent" > Take care not to use non-expandable commands in PDF bookmarks. This isn&#8217;t
specific to the <span
class="cmss-10">glossaries</span><a
id="dx1-8011"></a> package but is a&#x00A0;limitation of PDF bookmarks.
@@ -3741,15 +3747,15 @@ class="cmtt-10">\texorpdfstring</span>. For example:
<div class="verbatim" id="verbatim-104">
\section{The&#x00A0;\texorpdfstring{\gls{fishage}}{Fish&#x00A0;Age}}
</div>
-<!--l. 1965--><p class="nopar" > However, it&#8217;s not a&#x00A0;good idea to use commands like <span
+<!--l. 1971--><p class="nopar" > However, it&#8217;s not a&#x00A0;good idea to use commands like <span
class="cmtt-10">\gls </span>in a&#x00A0;section heading as
you&#8217;ll end up with the table of contents in your location list. Instead you can
use
-</p><!--l. 1970--><p class="indent" > <hr><div title="Definition"><span
+</p><!--l. 1976--><p class="indent" > <hr><div title="Definition"><span
class="cmtt-10">\glsentrytext{</span>&#x27E8;<span
class="cmitt-10">label</span>&#x27E9;<span
class="cmtt-10">} </span></div><hr>
-</p><!--l. 1971--><p class="noindent" >
+</p><!--l. 1977--><p class="noindent" >
This is expandable provided that the <span
class="cmtt-10">text </span>key doesn&#8217;t contain non-expandable code.
For example, the following works:
@@ -3760,8 +3766,8 @@ For example, the following works:
<div class="verbatim" id="verbatim-105">
\section{The&#x00A0;\glsentrytext{fishage}}
</div>
-<!--l. 1976--><p class="nopar" > and it doesn&#8217;t put the table of contents in the location list.
-</p><!--l. 1979--><p class="indent" > If you use <span
+<!--l. 1982--><p class="nopar" > and it doesn&#8217;t put the table of contents in the location list.
+</p><!--l. 1985--><p class="indent" > If you use <span
class="cmss-10">glossaries-extra</span><a
id="dx1-8013"></a> then use the commands that are provided specifically for
use in section headers. For example:
@@ -3772,19 +3778,19 @@ use in section headers. For example:
<div class="verbatim" id="verbatim-106">
\section{The&#x00A0;\glsfmttext{fishage}}
</div>
-<!--l. 1983--><p class="nopar" >
-</p><!--l. 1985--><p class="noindent" >
+<!--l. 1989--><p class="nopar" >
+</p><!--l. 1991--><p class="noindent" >
</p>
-<!--l. 1985--><p class="noindent" ><a
+<!--l. 1991--><p class="noindent" ><a
href="#top">Top</a><h2 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">8 </span> <a
id="sec:xr"></a>Cross-References</h3>
-<!--l. 1988--><p class="noindent" >You can add a&#x00A0;reference to another entry in a&#x00A0;location list using the <span
+<!--l. 1994--><p class="noindent" >You can add a&#x00A0;reference to another entry in a&#x00A0;location list using the <span
class="cmtt-10">see={</span>&#x27E8;<span
class="cmti-10">label list</span>&#x27E9;<span
class="cmtt-10">}</span>
key when you define an entry. The referenced entry (or entries) must also be
defined.
-</p><!--l. 1992--><p class="indent" > For example:
+</p><!--l. 1998--><p class="indent" > For example:
@@ -3804,7 +3810,7 @@ defined.
&#x00A0;<br />&#x00A0;&#x00A0;see={devonian}
&#x00A0;<br />}
</div>
-<!--l. 2009--><p class="nopar" > The cross-reference will appear as &#8220;<span
+<!--l. 2015--><p class="nopar" > The cross-reference will appear as &#8220;<span
class="cmti-10">see </span>Devonian&#8221;. You can change the &#8220;see&#8221; tag
using the format <span
class="cmtt-10">see=[</span>&#x27E8;<span
@@ -3830,7 +3836,7 @@ class="cmti-10">label</span>&#x27E9;. For example:
&#x00A0;<br />&#x00A0;&#x00A0;&#x00A0;other&#x00A0;letters&#x00A0;such&#x00A0;as&#x00A0;ligatures&#x00A0;or&#x00A0;diacritics.}
&#x00A0;<br />}
</div>
-<!--l. 2027--><p class="nopar" > If you use the <span
+<!--l. 2033--><p class="nopar" > If you use the <span
class="cmtt-10">see </span>key in the optional argument of <span
class="cmtt-10">\newacronym</span>, make sure you
enclose the value in braces. For example:
@@ -3844,7 +3850,7 @@ enclose the value in braces. For example:
&#x00A0;<br />&#x00A0;[see={[see&#x00A0;also]{ksvm}}]
&#x00A0;<br />&#x00A0;{svm}{svm}{support&#x00A0;vector&#x00A0;machine}
</div>
-<!--l. 2036--><p class="nopar" > The <span
+<!--l. 2042--><p class="nopar" > The <span
class="cmss-10">glossaries-extra</span><a
id="dx1-9001"></a> package provides a <span
class="cmtt-10">seealso </span>key. This doesn&#8217;t allow a tag but
@@ -3865,8 +3871,8 @@ class="cmsy-10">}</span>. For example:
&#x00A0;<br />&#x00A0;[seealso={ksvm}]
&#x00A0;<br />&#x00A0;{svm}{svm}{support&#x00A0;vector&#x00A0;machine}
</div>
-<!--l. 2045--><p class="nopar" >
-</p><!--l. 2047--><p class="indent" > Since the cross-reference appears in the location list, if you suppress the
+<!--l. 2051--><p class="nopar" >
+</p><!--l. 2053--><p class="indent" > Since the cross-reference appears in the location list, if you suppress the
location list using the <span
class="cmss-10">nonumberlist</span><a
id="dx1-9002"></a> package option, then the cross-reference
@@ -3898,10 +3904,10 @@ example:
&#x00A0;<br />&#x00A0;type={symbols}%&#x00A0;put&#x00A0;in&#x00A0;symbols&#x00A0;glossary
&#x00A0;<br />]
</div>
-<!--l. 2069--><p class="nopar" >
-</p><!--l. 2071--><p class="noindent" >
+<!--l. 2075--><p class="nopar" >
+</p><!--l. 2077--><p class="noindent" >
</p>
-<!--l. 2071--><p class="noindent" ><a
+<!--l. 2077--><p class="noindent" ><a
href="#top">Top</a><h2 class="sectionHead"></p><h3 class="sectionHead"><span class="titlemark">9 </span> <a
id="sec:moreinfo"></a>Further Information</h3>
<ul class="itemize1">
@@ -3929,7 +3935,7 @@ class="cmss-10">glossaries-extra</span></a> package.
<li class="itemize">The <a
href="https://ctan.org/pkg/bib2gls" ><span
class="cmtt-10">bib2gls</span></a> application.</li></ul>
- <div class="footnotes"><!--l. 1032--><p class="noindent" ><span class="footnote-mark"><a
+ <div class="footnotes"><!--l. 1038--><p class="noindent" ><span class="footnote-mark"><a
href="#fn1x0-bk" id="fn1x0"><sup class="textsuperscript">1</sup></a></span><span
class="cmr-8">deprecated, use </span><span
class="cmss-8">babel</span><a