diff options
Diffstat (limited to 'Master/texmf-dist/doc/latex/glossaries/glossaries-user.html')
-rw-r--r-- | Master/texmf-dist/doc/latex/glossaries/glossaries-user.html | 17650 |
1 files changed, 17650 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/latex/glossaries/glossaries-user.html b/Master/texmf-dist/doc/latex/glossaries/glossaries-user.html new file mode 100644 index 00000000000..b122907da37 --- /dev/null +++ b/Master/texmf-dist/doc/latex/glossaries/glossaries-user.html @@ -0,0 +1,17650 @@ +<a + id="top"></a><?xml version="1.0" encoding="iso-8859-1" ?> +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" + "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> +<!--http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd--> +<html xmlns="http://www.w3.org/1999/xhtml" +> +<head><title>User Manual for glossaries.sty v3.0</title> +<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" /> +<meta name="generator" content="TeX4ht (http://www.cse.ohio-state.edu/~gurari/TeX4ht/)" /> +<meta name="originator" content="TeX4ht (http://www.cse.ohio-state.edu/~gurari/TeX4ht/)" /> +<!-- xhtml,fn-in,css-in --> +<meta name="src" content="glossaries-user.tex" /> +<meta name="date" content="2011-04-04 11:04:00" /> + +<style type="text/css"> +<!-- + +/* start css.sty */ +.cmr-7{font-size:70%;} +.cmmi-7{font-size:70%;font-style: italic;} +.cmmi-10{font-style: italic;} +.ecrm-1728{font-size:170%;} +.ecrm-1200{font-size:120%;} +.ectt-1200{font-size:120%; font-family: monospace;} +.ectt-1200{ font-family: monospace;} +.ectt-1200{ font-family: monospace;} +.ectt-1200{ font-family: monospace;} +.ectt-1200{ font-family: monospace;} +.ectt-1200{ font-family: monospace;} +.ectt-1200{ font-family: monospace;} +.ectt-1200{ font-family: monospace;} +.ectt-1200{ font-family: monospace;} +.ectt-1200{ font-family: monospace;} +.ectt-1200{ font-family: monospace;} +.ectt-1200{ font-family: monospace;} +.ectt-1200{ font-family: monospace;} +.ectt-1200{ font-family: monospace;} +.ecss-1000{ font-family: sans-serif;} +.ecss-1000{ font-family: sans-serif;} +.ecss-1000{ font-family: sans-serif;} +.ecss-1000{ font-family: sans-serif;} +.ecss-1000{ font-family: sans-serif;} +.ecss-1000{ font-family: sans-serif;} +.ecss-1000{ font-family: sans-serif;} +.ecss-1000{ font-family: sans-serif;} +.ecss-1000{ font-family: sans-serif;} +.ecss-1000{ font-family: sans-serif;} +.ecss-1000{ font-family: sans-serif;} +.ecss-1000{ font-family: sans-serif;} +.ecss-1000{ font-family: sans-serif;} +.ecss-1000{ font-family: sans-serif;} +.ecbx-1000{ font-weight: bold;} +.ecbx-1000{ font-weight: bold;} +.ecbx-1000{ font-weight: bold;} +.ecbx-1000{ font-weight: bold;} +.ecbx-1000{ font-weight: bold;} +.ecbx-1000{ font-weight: bold;} +.ecbx-1000{ font-weight: bold;} +.ecbx-1000{ font-weight: bold;} +.ecbx-1000{ font-weight: bold;} +.ecbx-1000{ font-weight: bold;} +.ecbx-1000{ font-weight: bold;} +.ecbx-1000{ font-weight: bold;} +.ecbx-1000{ font-weight: bold;} +.ecbx-1000{ font-weight: bold;} +.ectt-1000{ font-family: monospace;} +.ectt-1000{ font-family: monospace;} +.ectt-1000{ font-family: monospace;} +.ectt-1000{ font-family: monospace;} +.ectt-1000{ font-family: monospace;} +.ectt-1000{ font-family: monospace;} +.ectt-1000{ font-family: monospace;} +.ectt-1000{ font-family: monospace;} +.ectt-1000{ font-family: monospace;} +.ectt-1000{ font-family: monospace;} +.ectt-1000{ font-family: monospace;} +.ectt-1000{ font-family: monospace;} +.ectt-1000{ font-family: monospace;} +.ectt-1000{ font-family: monospace;} +.ecti-1000{ font-style: italic;} +.ecti-1000{ font-style: italic;} +.ecti-1000{ font-style: italic;} +.ecti-1000{ font-style: italic;} +.ecti-1000{ font-style: italic;} +.ecti-1000{ font-style: italic;} +.ecti-1000{ font-style: italic;} +.ecti-1000{ font-style: italic;} +.ecti-1000{ font-style: italic;} +.ecti-1000{ font-style: italic;} +.ecti-1000{ font-style: italic;} +.ecti-1000{ font-style: italic;} +.ecti-1000{ font-style: italic;} +.ecti-1000{ font-style: italic;} +.ecrm-0900{font-size:90%;} +.ecrm-0800{font-size:80%;} +.ectt-0800{font-size:80%; font-family: monospace;} +.ectt-0800{ font-family: monospace;} +.ectt-0800{ font-family: monospace;} +.ectt-0800{ font-family: monospace;} +.ectt-0800{ font-family: monospace;} +.ectt-0800{ font-family: monospace;} +.ectt-0800{ font-family: monospace;} +.ectt-0800{ font-family: monospace;} +.ectt-0800{ font-family: monospace;} +.ectt-0800{ font-family: monospace;} +.ectt-0800{ font-family: monospace;} +.ectt-0800{ font-family: monospace;} +.ectt-0800{ font-family: monospace;} +.ectt-0800{ font-family: monospace;} +.ecss-0800{font-size:80%; font-family: sans-serif;} +.ecss-0800{ font-family: sans-serif;} +.ecss-0800{ font-family: sans-serif;} +.ecss-0800{ font-family: sans-serif;} +.ecss-0800{ font-family: sans-serif;} +.ecss-0800{ font-family: sans-serif;} +.ecss-0800{ font-family: sans-serif;} +.ecss-0800{ font-family: sans-serif;} +.ecss-0800{ font-family: sans-serif;} +.ecss-0800{ font-family: sans-serif;} +.ecss-0800{ font-family: sans-serif;} +.ecss-0800{ font-family: sans-serif;} +.ecss-0800{ font-family: sans-serif;} +.ecss-0800{ font-family: sans-serif;} +.ecsx-1000{ font-weight: bold;} +.ecsx-1000{ font-weight: bold;} +.ecsx-1000{ font-weight: bold;} +.ecsx-1000{ font-weight: bold;} +.ecsx-1000{ font-weight: bold;} +.ecsx-1000{ font-weight: bold;} +.ecsx-1000{ font-weight: bold;} +.ecsx-1000{ font-weight: bold;} +.ecsx-1000{ font-weight: bold;} +.ecsx-1000{ font-weight: bold;} +.ecsx-1000{ font-weight: bold;} +.ecsx-1000{ font-weight: bold;} +.ecsx-1000{ font-weight: bold;} +.ecsx-1000{ font-weight: bold;} +.ectt-0900{font-size:90%; font-family: monospace;} +.ectt-0900{ font-family: monospace;} +.ectt-0900{ font-family: monospace;} +.ectt-0900{ font-family: monospace;} +.ectt-0900{ font-family: monospace;} +.ectt-0900{ font-family: monospace;} +.ectt-0900{ font-family: monospace;} +.ectt-0900{ font-family: monospace;} +.ectt-0900{ font-family: monospace;} +.ectt-0900{ font-family: monospace;} +.ectt-0900{ font-family: monospace;} +.ectt-0900{ font-family: monospace;} +.ectt-0900{ font-family: monospace;} +.ectt-0900{ font-family: monospace;} +.small-caps{font-variant: small-caps; } +p.noindent { text-indent: 0em } +td p.noindent { text-indent: 0em; margin-top:0em; } +p.nopar { text-indent: 0em; } +p.indent{ text-indent: 1.5em } +@media print {div.crosslinks {visibility:hidden;}} +a img { border-top: 0; border-left: 0; border-right: 0; } +center { margin-top:1em; margin-bottom:1em; } +td center { margin-top:0em; margin-bottom:0em; } +.Canvas { position:relative; } +img.math{vertical-align:middle;} +li p.indent { text-indent: 0em } +li p:first-child{ margin-top:0em; } +li p:last-child, li div:last-child { margin-bottom:0.5em; } +li p~ul:last-child, li p~ol:last-child{ margin-bottom:0.5em; } +.enumerate1 {list-style-type:decimal;} +.enumerate2 {list-style-type:lower-alpha;} +.enumerate3 {list-style-type:lower-roman;} +.enumerate4 {list-style-type:upper-alpha;} +div.newtheorem { margin-bottom: 2em; margin-top: 2em;} +.obeylines-h,.obeylines-v {white-space: nowrap; } +div.obeylines-v p { margin-top:0; margin-bottom:0; } +.overline{ text-decoration:overline; } +.overline img{ border-top: 1px solid black; } +td.displaylines {text-align:center; white-space:nowrap;} +.centerline {text-align:center;} +.rightline {text-align:right;} +div.verbatim {font-family: monospace; white-space: nowrap; text-align:left; clear:both; } +.fbox {padding-left:3.0pt; padding-right:3.0pt; text-indent:0pt; border:solid black 0.4pt; } +div.fbox {display:table} +div.center div.fbox {text-align:center; clear:both; padding-left:3.0pt; padding-right:3.0pt; text-indent:0pt; border:solid black 0.4pt; } +div.minipage{width:100%;} +div.center, div.center div.center {text-align: center; margin-left:1em; margin-right:1em;} +div.center div {text-align: left;} +div.flushright, div.flushright div.flushright {text-align: right;} +div.flushright div {text-align: left;} +div.flushleft {text-align: left;} +.underline{ text-decoration:underline; } +.underline img{ border-bottom: 1px solid black; margin-bottom:1pt; } +.framebox-c, .framebox-l, .framebox-r { padding-left:3.0pt; padding-right:3.0pt; text-indent:0pt; border:solid black 0.4pt; } +.framebox-c {text-align:center;} +.framebox-l {text-align:left;} +.framebox-r {text-align:right;} +span.thank-mark{ vertical-align: super } +span.footnote-mark sup.textsuperscript, span.footnote-mark a sup.textsuperscript{ font-size:80%; } +div.footnotes{border-top:solid 1px black; border-bottom:solid 1px black; padding-bottom:1ex; padding-top:0.5ex; margin-right:15%; margin-top:2ex; font-style:italic; font-size:85%;} +div.footnotes p{margin-top:0; margin-bottom:0; text-indent:0;} +div.tabular, div.center div.tabular {text-align: center; margin-top:0.5em; margin-bottom:0.5em; } +table.tabular td p{margin-top:0em;} +table.tabular {margin-left: auto; margin-right: auto;} +td p:first-child{ margin-top:0em; } +td p:last-child{ margin-bottom:0em; } +div.td00{ margin-left:0pt; margin-right:0pt; } +div.td01{ margin-left:0pt; margin-right:5pt; } +div.td10{ margin-left:5pt; margin-right:0pt; } +div.td11{ margin-left:5pt; margin-right:5pt; } +table[rules] {border-left:solid black 0.4pt; border-right:solid black 0.4pt; } +td.td00{ padding-left:0pt; padding-right:0pt; } +td.td01{ padding-left:0pt; padding-right:5pt; } +td.td10{ padding-left:5pt; padding-right:0pt; } +td.td11{ padding-left:5pt; padding-right:5pt; } +table[rules] {border-left:solid black 0.4pt; border-right:solid black 0.4pt; } +.hline hr, .cline hr{ height : 1px; margin:0px; } +.tabbing-right {text-align:right;} +span.TEX {letter-spacing: -0.125em; } +span.TEX span.E{ position:relative;top:0.5ex;left:-0.0417em;} +a span.TEX span.E {text-decoration: none; } +span.LATEX span.A{ position:relative; top:-0.5ex; left:-0.4em; font-size:85%;} +span.LATEX span.TEX{ position:relative; left: -0.4em; } +div.float, div.figure {margin-left: auto; margin-right: auto;} +div.float img {text-align:center;} +div.figure img {text-align:center;} +.marginpar {width:20%; float:right; text-align:left; margin-left:auto; margin-top:0.5em; font-size:85%; text-decoration:underline;} +.marginpar p{margin-top:0.4em; margin-bottom:0.4em;} +table.equation {width:100%;} +.equation td{text-align:center; } +td.equation { margin-top:1em; margin-bottom:1em; } +td.equation-label { width:5%; text-align:center; } +td.eqnarray4 { width:5%; white-space: normal; } +td.eqnarray2 { width:5%; } +table.eqnarray-star, table.eqnarray {width:100%;} +div.eqnarray{text-align:center;} +div.array {text-align:center;} +div.pmatrix {text-align:center;} +table.pmatrix {width:100%;} +span.pmatrix img{vertical-align:middle;} +div.pmatrix {text-align:center;} +table.pmatrix {width:100%;} +span.bar-css {text-decoration:overline;} +img.cdots{vertical-align:middle;} +.partToc a, .partToc, .likepartToc a, .likepartToc {line-height: 200%; font-weight:bold; font-size:110%;} +.index-item, .index-subitem, .index-subsubitem {display:block} +div.caption {text-indent:-2em; margin-left:3em; margin-right:1em; text-align:left;} +div.caption span.id{font-weight: bold; white-space: nowrap; } +h1.partHead{text-align: center} +p.bibitem { text-indent: -2em; margin-left: 2em; margin-top:0.6em; margin-bottom:0.6em; } +p.bibitem-p { text-indent: 0em; margin-left: 2em; margin-top:0.6em; margin-bottom:0.6em; } +.paragraphHead, .likeparagraphHead { margin-top:2em; font-weight: bold;} +.subparagraphHead, .likesubparagraphHead { font-weight: bold;} +.quote {margin-bottom:0.25em; margin-top:0.25em; margin-left:1em; margin-right:1em; text-align:justify;} +.verse{white-space:nowrap; margin-left:2em} +div.maketitle {text-align:center;} +h2.titleHead{text-align:center;} +div.maketitle{ margin-bottom: 2em; } +div.author, div.date {text-align:center;} +div.thanks{text-align:left; margin-left:10%; font-size:85%; font-style:italic; } +.quotation {margin-bottom:0.25em; margin-top:0.25em; margin-left:1em; } +.abstract p {margin-left:5%; margin-right:5%;} +div.abstract {width:100%;} +table.multicols { width:100%; margin-left:1em; margin-top:1em; margin-bottom:1em; } +.alltt P { margin-bottom : 0em; margin-top : 0em; } +.alltt { margin-bottom : 1em; margin-top : 1em; } +table[rules] {border-left:solid black 0.4pt; border-right:solid black 0.4pt; } +div.longtable{text-align:center;} +.supertabular {text-align:center} +div.important { background-color:red; } +/* end css.sty */ + + +--> +</style> +</head><body +> + <div class="maketitle"> + + + + + + + +<h2 class="titleHead">User Manual for glossaries.sty v3.0</h2> + <div class="author" ><span +class="ecrm-1200">Nicola L.C. Talbot</span> +<br /> <span +class="ecrm-1200">School of Computing Sciences</span> +<br /> <span +class="ecrm-1200">University of East Anglia</span> +<br /> <span +class="ecrm-1200">Norwich. Norfolk</span> +<br /> <span +class="ecrm-1200">NR4 7TJ. United Kingdom.</span> +<br /><a +href="http://theoval.cmp.uea.ac.uk/~nlct/" class="url" ><span +class="ectt-1200">http://theoval.cmp.uea.ac.uk/~nlct/</span></a></div><br /> +<div class="date" ><span +class="ecrm-1200">2011-04-02</span></div> + </div> +<!--l. 228--><p class="noindent" >The <span +class="ecss-1000">glossaries </span>bundle comes with the following documentation: + </p><dl class="description"><dt class="description"> +<a +href="glossariesbegin.pdf" class="url" ><span +class="ectt-1000">glossariesbegin.pdf</span></a> </dt><dd +class="description">If you are a complete beginner, start with <a +href="glossariesbegin.html" >“The glossaries + package: a guide for beginners”</a>. + </dd><dt class="description"> +<a +href="glossary2glossaries.pdf" class="url" ><span +class="ectt-1000">glossary2glossaries.pdf</span></a> </dt><dd +class="description">If you are moving over from the obsolete <span +class="ecss-1000">glossary</span><a + id="dx1-2"></a> + package, read <a +href="glossary2glossaries.html" >“Upgrading from the glossary package to the glossaries + package”</a>. + </dd><dt class="description"> +<span +class="ecbx-1000">glossaries-user.pdf</span> </dt><dd +class="description">This document is the main user guide for the <span +class="ecss-1000">glossaries</span> + package. + </dd><dt class="description"> +<a +href="mfirstuc-manual.pdf" class="url" ><span +class="ectt-1000">mfirstuc-manual.pdf</span></a> </dt><dd +class="description">The commands provided by the <span +class="ecss-1000">mfirstuc</span><a + id="dx1-3"></a> package are + briefly described in <a +href="mfirstuc-manual.html" >“mfirstuc.sty: uppercasing first letter”</a>. + </dd><dt class="description"> +<a +href="glossaries.pdf" class="url" ><span +class="ectt-1000">glossaries.pdf</span></a> </dt><dd +class="description">Advanced users wishing to know more about the inner workings + of all the packages provided in the <span +class="ecss-1000">glossaries </span>bundle should read “Documented + Code for glossaries v3.0”. This includes how to iterate over all entry labels + defined in a given glossary or how to iterate over all glossary types, as well + as the documented code for the <span +class="ecss-1000">mfirstuc</span><a + id="dx1-4"></a> package. + </dd><dt class="description"> +<span +class="ecbx-1000">INSTALL</span> </dt><dd +class="description">Installation instructions. + + + + </dd><dt class="description"> +<span +class="ecbx-1000">CHANGES</span> </dt><dd +class="description">Change log. + </dd><dt class="description"> +<span +class="ecbx-1000">README</span> </dt><dd +class="description">Package summary. + </dd></dl> +<!--l. 266--><p class="indent" > <div class="important" title="Important Note"> If you use <span +class="ecss-1000">hyperref</span><a + id="dx1-5"></a> and <span +class="ecss-1000">glossaries</span>, you must load <span +class="ecss-1000">hyperref</span><a + id="dx1-6"></a> <span +class="ecti-1000">first</span>. </div> +</p><!--l. 269--><p class="noindent" > + + + +</p> + <h3 class="likesectionHead"><a + id="x1-1000"></a>Contents</h3> + <div class="tableofcontents"> + <span class="sectionToc" ><a +href="#Q1-1-2">Glossary</a></span> +<br /> <span class="sectionToc" >1 <a +href="#x1-30001" id="QQ2-1-4">Introduction</a></span> +<br />  <span class="subsectionToc" >1.1 <a +href="#x1-40001.1" id="QQ2-1-5">Sample Documents</a></span> +<br />  <span class="subsectionToc" >1.2 <a +href="#x1-50001.2" id="QQ2-1-6">Multi-Lingual Support</a></span> +<br />   <span class="subsubsectionToc" >1.2.1 <a +href="#x1-60001.2.1" id="QQ2-1-7">Changing the Fixed Names</a></span> +<br />  <span class="subsectionToc" >1.3 <a +href="#x1-70001.3" id="QQ2-1-10">Generating the Associated Glossary Files</a></span> +<br />   <span class="subsubsectionToc" >1.3.1 <a +href="#x1-80001.3.1" id="QQ2-1-12">Using the makeglossaries Perl Script</a></span> +<br />   <span class="subsubsectionToc" >1.3.2 <a +href="#x1-90001.3.2" id="QQ2-1-13">Using xindy explicitly</a></span> +<br />   <span class="subsubsectionToc" >1.3.3 <a +href="#x1-100001.3.3" id="QQ2-1-14">Using makeindex explicitly</a></span> +<br />   <span class="subsubsectionToc" >1.3.4 <a +href="#x1-110001.3.4" id="QQ2-1-15">Note to Front-End and Script Developers</a></span> +<br /> <span class="sectionToc" >2 <a +href="#x1-120002" id="QQ2-1-16">Package Options</a></span> +<br />  <span class="subsectionToc" >2.1 <a +href="#x1-130002.1" id="QQ2-1-17">General Options</a></span> +<br />  <span class="subsectionToc" >2.2 <a +href="#x1-140002.2" id="QQ2-1-18">Sectioning and TOC Options</a></span> +<br />  <span class="subsectionToc" >2.3 <a +href="#x1-150002.3" id="QQ2-1-19">Glossary Appearance Options</a></span> +<br />  <span class="subsectionToc" >2.4 <a +href="#x1-160002.4" id="QQ2-1-20">Sorting Options</a></span> +<br />  <span class="subsectionToc" >2.5 <a +href="#x1-170002.5" id="QQ2-1-21">Acronym Options</a></span> +<br /> <span class="sectionToc" >3 <a +href="#x1-180003" id="QQ2-1-22">Setting Up</a></span> +<br /> <span class="sectionToc" >4 <a +href="#x1-190004" id="QQ2-1-23">Defining Glossary Entries</a></span> +<br />  <span class="subsectionToc" >4.1 <a +href="#x1-200004.1" id="QQ2-1-24">Plurals</a></span> +<br />  <span class="subsectionToc" >4.2 <a +href="#x1-210004.2" id="QQ2-1-25">Sub-Entries</a></span> +<br />   <span class="subsubsectionToc" >4.2.1 <a +href="#x1-220004.2.1" id="QQ2-1-26">Hierarchical Categories</a></span> +<br />   <span class="subsubsectionToc" >4.2.2 <a +href="#x1-230004.2.2" id="QQ2-1-27">Homographs</a></span> +<br />  <span class="subsectionToc" >4.3 <a +href="#x1-240004.3" id="QQ2-1-28">Loading Entries From a File</a></span> +<br /> <span class="sectionToc" >5 <a +href="#x1-250005" id="QQ2-1-29">Number lists</a></span> +<br /> <span class="sectionToc" >6 <a +href="#x1-260006" id="QQ2-1-30">Links to Glossary Entries</a></span> +<br />  <span class="subsectionToc" >6.1 <a +href="#x1-270006.1" id="QQ2-1-32">Changing the format of the link text</a></span> +<br />  <span class="subsectionToc" >6.2 <a +href="#x1-280006.2" id="QQ2-1-33">Enabling and disabling hyperlinks to glossary entries</a></span> +<br /> <span class="sectionToc" >7 <a +href="#x1-290007" id="QQ2-1-34">Adding an Entry to the Glossary Without Generating Text</a></span> +<br /> <span class="sectionToc" >8 <a +href="#x1-300008" id="QQ2-1-35">Cross-Referencing Entries</a></span> +<br />  <span class="subsectionToc" >8.1 <a +href="#x1-310008.1" id="QQ2-1-36">Customising Cross-reference Text</a></span> +<br /> <span class="sectionToc" >9 <a +href="#x1-320009" id="QQ2-1-37">Using Glossary Terms Without Links</a></span> +<br /> <span class="sectionToc" >10 <a +href="#x1-3300010" id="QQ2-1-38">Displaying a glossary</a></span> +<br /> <span class="sectionToc" >11 <a +href="#x1-3400011" id="QQ2-1-39">Xindy</a></span> +<br />  <span class="subsectionToc" >11.1 <a +href="#x1-3500011.1" id="QQ2-1-40">Language and Encodings</a></span> +<br />  <span class="subsectionToc" >11.2 <a +href="#x1-3600011.2" id="QQ2-1-41">Locations and Number lists</a></span> +<br />  <span class="subsectionToc" >11.3 <a +href="#x1-3700011.3" id="QQ2-1-42">Glossary Groups</a></span> +<br /> <span class="sectionToc" >12 <a +href="#x1-3800012" id="QQ2-1-43">Defining New Glossaries</a></span> +<br /> <span class="sectionToc" >13 <a +href="#x1-3900013" id="QQ2-1-44">Acronyms</a></span> +<br />  <span class="subsectionToc" >13.1 <a +href="#x1-4000013.1" id="QQ2-1-46">Predefined Acronym Styles</a></span> +<br />  <span class="subsectionToc" >13.2 <a +href="#x1-4100013.2" id="QQ2-1-47">Displaying the List of Acronyms</a></span> +<br />  <span class="subsectionToc" >13.3 <a +href="#x1-4200013.3" id="QQ2-1-49">Defining A Custom Acronym Style</a></span> +<br />  <span class="subsectionToc" >13.4 <a +href="#x1-4300013.4" id="QQ2-1-50">Upgrading From the glossary Package</a></span> + + + +<br /> <span class="sectionToc" >14 <a +href="#x1-4400014" id="QQ2-1-52">Unsetting and Resetting Entry Flags</a></span> +<br /> <span class="sectionToc" >15 <a +href="#x1-4500015" id="QQ2-1-53">Glossary Styles</a></span> +<br />  <span class="subsectionToc" >15.1 <a +href="#x1-4600015.1" id="QQ2-1-55">List Styles</a></span> +<br />  <span class="subsectionToc" >15.2 <a +href="#x1-4700015.2" id="QQ2-1-56">Longtable Styles</a></span> +<br />  <span class="subsectionToc" >15.3 <a +href="#x1-4800015.3" id="QQ2-1-57">Longtable Styles (Ragged Right)</a></span> +<br />  <span class="subsectionToc" >15.4 <a +href="#x1-4900015.4" id="QQ2-1-58">Supertabular Styles</a></span> +<br />  <span class="subsectionToc" >15.5 <a +href="#x1-5000015.5" id="QQ2-1-59">Supertabular Styles (Ragged Right)</a></span> +<br />  <span class="subsectionToc" >15.6 <a +href="#x1-5100015.6" id="QQ2-1-60">Tree-Like Styles</a></span> +<br /> <span class="sectionToc" >16 <a +href="#x1-5200016" id="QQ2-1-61">Defining your own glossary style</a></span> +<br />  <span class="subsectionToc" >16.1 <a +href="#x1-5300016.1" id="QQ2-1-62">Example: creating a completely new style</a></span> +<br />  <span class="subsectionToc" >16.2 <a +href="#x1-5400016.2" id="QQ2-1-63">Example: creating a new glossary style based on an existing style</a></span> +<br />  <span class="subsectionToc" >16.3 <a +href="#x1-5500016.3" id="QQ2-1-64">Example: creating a glossary style that uses the <span +class="ecss-1000">user1</span>, …, <span +class="ecss-1000">user6 </span>keys</a></span> +<br /> <span class="sectionToc" >17 <a +href="#x1-5600017" id="QQ2-1-65">Accessibility Support</a></span> +<br /> <span class="sectionToc" >18 <a +href="#x1-5700018" id="QQ2-1-66">Troubleshooting</a></span> +<br /> <span class="sectionToc" ><a +href="#Q1-1-67">Index</a></span> + </div> + + + +<!--l. 1--><p class="indent" > <a + id="likesection.1"></a><a + id="Q1-1-2"></a> +</p> + <h3 class="likesectionHead"><a + id="x1-2000"></a>Glossary</h3> +<!--l. 1--><p class="noindent" ><span +class="ecti-1000">This glossary style was setup using:</span> </p> +<table +cellpadding="0" border="0" cellspacing="0" +class="tabbing"><tr +style="vertical-align:baseline;" class="tabbing"><td style="width:94;" +class="tabbing"><span +class="ectt-1000">\usepackage[</span></td><td +class="tabbing"><span +class="ectt-1000">xindy,</span> +</td></tr></table> +<!--l. 1--><p class="indent" > </p><table +cellpadding="0" border="0" cellspacing="0" +class="tabbing"><tr +style="vertical-align:baseline;" class="tabbing"><td style="width:94;" +class="tabbing"> </td><td +class="tabbing"><span +class="ectt-1000">nonumberlist,</span></td></tr></table> +<!--l. 1--><p class="indent" > </p><table +cellpadding="0" border="0" cellspacing="0" +class="tabbing"><tr +style="vertical-align:baseline;" class="tabbing"><td style="width:94;" +class="tabbing"></td><td +class="tabbing"><span +class="ectt-1000">seeautonumberlist,</span></td></tr></table> +<!--l. 1--><p class="indent" > </p><table +cellpadding="0" border="0" cellspacing="0" +class="tabbing"><tr +style="vertical-align:baseline;" class="tabbing"><td style="width:94;" +class="tabbing"></td><td +class="tabbing"><span +class="ectt-1000">toc,</span></td></tr></table> +<!--l. 1--><p class="indent" > </p><table +cellpadding="0" border="0" cellspacing="0" +class="tabbing"><tr +style="vertical-align:baseline;" class="tabbing"><td style="width:94;" +class="tabbing"></td><td +class="tabbing"><span +class="ectt-1000">style=altlist]{glossaries}</span></td></tr></table> +<!--l. 1--><p class="indent" > +</p><!--l. 1--><p class="noindent" ><span +class="ectt-1000">\renewcommand*{\glsgroupskip</span><a + id="dx1-2001"></a><span +class="ectt-1000">}{}</span><br +class="newline" /><span +class="ectt-1000">\renewcommand*{\glsseeformat</span><a + id="dx1-2002"></a><span +class="ectt-1000">}[3][\seename</span><a + id="dx1-2003"></a><span +class="ectt-1000">]{(\xmakefirstuc</span><a + id="dx1-2004"></a><span +class="ectt-1000">{#1} </span><br +class="newline" /><span +class="ectt-1000">\glsseelist</span><a + id="dx1-2005"></a><span +class="ectt-1000">{#2}.)}</span> + </p><dl class="description"><dt class="description"> +<a + id="glo:entrylocation"></a><span +class="ecbx-1000">Entry location</span><a + id="dx1-2006"></a> </dt><dd +class="description"><br +class="newline" />The location of the entry in the document. This defaults to the page number + on which the entry appears. An entry may have multiple locations. <br +class="newline" /> + </dd><dt class="description"> +<a + id="glo:firstuse"></a><span +class="ecbx-1000">First use</span><a + id="dx1-2007"></a> </dt><dd +class="description"><br +class="newline" />The first time a glossary entry is used (from the start of the document or + after a reset) with one of the following commands: <span +class="ectt-1000">\gls</span><a + id="dx1-2008"></a>, <span +class="ectt-1000">\Gls</span><a + id="dx1-2009"></a>, <span +class="ectt-1000">\GLS</span><a + id="dx1-2010"></a>, <span +class="ectt-1000">\glspl</span><a + id="dx1-2011"></a>, + <span +class="ectt-1000">\Glspl</span><a + id="dx1-2012"></a>, <span +class="ectt-1000">\GLSpl</span><a + id="dx1-2013"></a> or <span +class="ectt-1000">\glsdisp</span><a + id="dx1-2014"></a>. (See <a +href="#glo:firstuseflag">first use flag</a> & <a +href="#glo:firstusetext">first use text</a>.) <br +class="newline" /> + </dd><dt class="description"> +<a + id="glo:firstuseflag"></a><span +class="ecbx-1000">First use flag</span><a + id="dx1-2015"></a> </dt><dd +class="description"><br +class="newline" />A conditional that determines whether or not the entry has been used + according to the rules of <a + id="dx1-2016"></a><a +href="#glo:firstuse">first use</a>. Commands to unset or reset this + conditional are described in <a +href="#x1-4400014">§14 </a><a +href="#x1-4400014">Unsetting and Resetting Entry Flags<!--tex4ht:ref: sec:glsunset --></a>. <br +class="newline" /> + </dd><dt class="description"> +<a + id="glo:firstusetext"></a><span +class="ecbx-1000">First use text</span><a + id="dx1-2017"></a> </dt><dd +class="description"><br +class="newline" />The text that is displayed on <a + id="dx1-2018"></a><a +href="#glo:firstuse">first use</a>, which is governed by the <span +class="ecss-1000">first</span><a + id="dx1-2019"></a> and + <span +class="ecss-1000">firstplural</span><a + id="dx1-2020"></a> keys of <span +class="ectt-1000">\newglossaryentry</span><a + id="dx1-2021"></a>. (May be overridden by <span +class="ectt-1000">\glsdisp</span><a + id="dx1-2022"></a>.) <br +class="newline" /> + + + + </dd><dt class="description"> +<a + id="glo:linktext"></a><span +class="ecbx-1000">Link text</span><a + id="dx1-2023"></a> </dt><dd +class="description"><br +class="newline" />The text produced by commands such as <span +class="ectt-1000">\gls</span><a + id="dx1-2024"></a>. It may or may not be a + hyperlink to the glossary. <br +class="newline" /> + </dd><dt class="description"> +<a + id="glo:locationlist"></a><span +class="ecbx-1000">Location list</span> </dt><dd +class="description"><br +class="newline" />A list of <a + id="dx1-2025"></a><a +href="#glo:entrylocation">entry locations</a>. (See <a +href="#glo:numberlist">number list<a + id="dx1-2026"></a></a>.)<br +class="newline" /> + </dd><dt class="description"> +<a + id="glo:makeglossaries"></a><span +class="ectt-1000">makeglossaries</span><a + id="dx1-2027"></a> </dt><dd +class="description"><br +class="newline" />A <span +class="ecss-1000">glossaries</span><a + id="dx1-2028"></a> custom designed Perl script interface to <a + id="dx1-2029"></a><a +href="#glo:xindy"><span +class="ectt-1000">xindy</span><a + id="dx1-2030"></a></a> and <a + id="dx1-2031"></a><a +href="#glo:makeindex"><span +class="ectt-1000">makeindex</span><a + id="dx1-2032"></a></a>. + <br +class="newline" /> + </dd><dt class="description"> +<a + id="glo:makeindex"></a><span +class="ectt-1000">makeindex</span><a + id="dx1-2033"></a> </dt><dd +class="description"><br +class="newline" />An indexing application. <br +class="newline" /> + </dd><dt class="description"> +<a + id="glo:numberlist"></a><span +class="ecbx-1000">Number list</span><a + id="dx1-2034"></a> </dt><dd +class="description"><br +class="newline" />A list of <a + id="dx1-2035"></a><a +href="#glo:entrylocation">entry locations</a> (also called a location list). The number list can be + suppressed using the <span +class="ecss-1000">nonumberlist</span><a + id="dx1-2036"></a> package option. <br +class="newline" /> + </dd><dt class="description"> +<a + id="glo:sanitize"></a><span +class="ecbx-1000">Sanitize</span><a + id="dx1-2037"></a> </dt><dd +class="description"><br +class="newline" />Converts command names into character sequences. That is, a command + called, say, <span +class="ectt-1000">\foo</span>, is converted into the sequence of characters: <span +class="ectt-1000">\</span>, <span +class="ectt-1000">f</span>, <span +class="ectt-1000">o</span>, <span +class="ectt-1000">o</span>. + Depending on the font, the backslash character may appear as a dash when + used in the main document text, so <span +class="ectt-1000">\foo </span>will appear as: —foo. + <!--l. 131--><p class="noindent" >When <span class="TEX">T<span +class="E">E</span>X</span> writes information to a file, fragile commands must be + protected. The <span +class="ecss-1000">name</span><a + id="dx1-2038"></a>, <span +class="ecss-1000">description</span><a + id="dx1-2039"></a> and <span +class="ecss-1000">symbol</span><a + id="dx1-2040"></a> keys all have their values written + to a file, which means that care must be taken if those values contain fragile + commands. There are two approaches: 1) the fragile commands must be + protected using <span +class="ectt-1000">\protect</span><a + id="dx1-2041"></a>; 2) the values are sanitized. Sanitizing the values + gets rid of the inconvenience of having to protect fragile commands, but at + the expense of no longer being able to use those values in the document. + Sanitization is governed by the package option <span +class="ecss-1000">sanitize</span><a + id="dx1-2042"></a> described in <a +href="#x1-130002.1">§2.1 + </a><a +href="#x1-130002.1">General Options<!--tex4ht:ref: sec:pkgopts-general --></a>. <br +class="newline" /> + </p></dd><dt class="description"> +<a + id="glo:xindy"></a><span +class="ectt-1000">xindy</span><a + id="dx1-2043"></a> </dt><dd +class="description"><br +class="newline" />An flexible indexing application with multilingual support. <br +class="newline" /></dd></dl> +<!--l. 277--><p class="noindent" > +</p> + <h3 class="sectionHead"><span class="titlemark">1 </span> <a + id="x1-30001"></a>Introduction</h3> +<!--l. 279--><p class="noindent" >The <span +class="ecss-1000">glossaries </span>package is provided to assist generating glossaries. It has a certain +amount of flexibility, allowing the user to customize the format of the glossary and +define multiple glossaries. It also supports acronyms and glossary styles that +include symbols (in addition to a name and description) for glossary entries. +There is provision for loading a database of glossary terms. Only those terms +used<span class="footnote-mark"><a +href="#fn1x0" id="fn1x0-bk"><sup class="textsuperscript">1</sup></a></span><a + id="x1-3001f1"></a> +in the document will be added to the glossary. +</p><!--l. 292--><p class="indent" > <span +class="ecbx-1000">This package replaces the </span><span +class="ecsx-1000">glossary</span><a + id="dx1-3005"></a> <span +class="ecbx-1000">package which is now obsolete. </span>Please +see the document <a +href="glossary2glossaries.html" >“Upgrading from the glossary package to the glossaries package”</a> for +assistance in upgrading. +</p><!--l. 296--><p class="indent" > One of the strengths of this package is its flexibility, however the drawback of this is +the necessity of having a large manual that can cover all the various settings. If you are +daunted by the size of the manual, try starting off with the much shorter <a +href="glossariesbegin.html" >guide for +beginners</a>. +</p><!--l. 302--><p class="indent" > <div class="important" title="Important Note"> The <span +class="ecss-1000">glossaries </span>package comes with a <a +href="http://www.perl.org/about.html" >Perl</a> script called <a + id="dx1-3006"></a><a +href="#glo:makeglossaries"><span +class="ectt-1000">makeglossaries</span><a + id="dx1-3007"></a></a>. This +provides a convenient interface to <a + id="dx1-3008"></a><a +href="#glo:makeindex"><span +class="ectt-1000">makeindex</span><a + id="dx1-3009"></a></a> or <a + id="dx1-3010"></a><a +href="#glo:xindy"><span +class="ectt-1000">xindy</span><a + id="dx1-3011"></a></a>. It is strongly recommended that +you use this script, but <span +class="ecti-1000">it is not essential</span>. If you are reluctant to install Perl, or for any +other reason you don’t want to use <a + id="dx1-3012"></a><span +class="ectt-1000">makeglossaries</span><a + id="dx1-3013"></a>, you can called <a + id="dx1-3014"></a><span +class="ectt-1000">makeindex</span><a + id="dx1-3015"></a> or +<a + id="dx1-3016"></a><span +class="ectt-1000">xindy</span><a + id="dx1-3017"></a> explicitly. See <a +href="#x1-70001.3">§1.3 </a><a +href="#x1-70001.3">Generating the Associated Glossary Files<!--tex4ht:ref: sec:makeglossaries --></a> for further details. +</div> +</p><!--l. 312--><p class="noindent" > +</p><!--l. 314--><p class="indent" > The remainder of this introductory section covers the following: </p> + <ul class="itemize1"> + <li class="itemize"><a +href="#x1-40001.1">§1.1 </a><a +href="#x1-40001.1">Sample Documents<!--tex4ht:ref: sec:samples --></a> lists the sample documents provided with this + package. + </li> + <li class="itemize"><a +href="#x1-50001.2">§1.2 </a><a +href="#x1-50001.2">Multi-Lingual Support<!--tex4ht:ref: sec:languages --></a> provides information for users who wish to write + in a language other than English. + </li> + <li class="itemize"><a +href="#x1-70001.3">§1.3 </a><a +href="#x1-70001.3">Generating the Associated Glossary Files<!--tex4ht:ref: sec:makeglossaries --></a> describes how to use a + post-processor to create the sorted glossaries for your document. + </li></ul> + + + +<!--l. 328--><p class="noindent" > +</p> +<!--l. 328--><p class="noindent" ><a +href="#top">Top</a></p><h4 class="subsectionHead"><span class="titlemark">1.1 </span> <a + id="x1-40001.1"></a>Sample Documents</h4> +<!--l. 331--><p class="noindent" >The <span +class="ecss-1000">glossaries </span>package is provided with some sample documents that illustrate the +various functions. These should be located in the <span +class="ectt-1000">samples </span>subdirectory (folder) of +the <span +class="ecss-1000">glossaries </span>documentation directory. This location varies according to your +operating system and <span class="TEX">T<span +class="E">E</span>X</span> distribution. You can use <span +class="ectt-1000">texdoc </span>to locate the main +glossaries documentation. For example, in a terminal or command prompt, type: +<spacer type=vertical size=10><span class="obeylines-h"> + <br /><span +class="ectt-1000">texdoc -l glossaries</span></span> +</p><!--l. 340--><p class="indent" > <spacer type=vertical size=10> +This should display the full pathname of the file <span +class="ectt-1000">glossaries.pdf</span>. View the contents of +that directory and see if it contains the <span +class="ectt-1000">samples </span>subdirectory. +</p><!--l. 345--><p class="indent" > If you can’t find the sample files, they are available in the subdirectory +<span +class="ectt-1000">doc/latex/glossaries/samples/ </span>in the <span +class="ectt-1000">glossaries.tds.zip </span>archive which can be +downloaded from <a +href="http://tug.ctan.org/tex-archive/macros/latex/contrib/glossaries/" >CTAN</a>. +</p><!--l. 351--><p class="indent" > The sample documents are as follows: + </p><dl class="description"><dt class="description"> +<span +class="ecbx-1000">minimalgls.tex</span> </dt><dd +class="description"> This document is a minimal working example. You can test your + installation using this file. To create the complete document you will need to do + the following steps: + <ol class="enumerate1" > + <li + class="enumerate" id="x1-4002x1">Run <span +class="ectt-1000">minimalgls.tex </span>through <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span +class="E">E</span>X</span></span> either by typing <spacer type=vertical size=10><span class="obeylines-h"> + <br /><span +class="ectt-1000">latex minimalgls</span></span> + <!--l. 362--><p class="noindent" ><spacer type=vertical size=10> + in a terminal or by using the relevant button or menu item in your text + editor or front-end. This will create the required associated files but you will + not see the glossary. If you use PDF<span class="LATEX">L<span class="A">A</span><span class="TEX">T<span +class="E">E</span>X</span></span> you will also get warnings about + non-existent references. These warnings may be ignored on the first + run. + </p><!--l. 369--><p class="noindent" >If you get a <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">Missing</span><span +class="ectt-1000"> \begin{document}</span></span></span> error, then it’s most likely that + your version of <span +class="ecss-1000">xkeyval</span><a + id="dx1-4003"></a> is out of date. Check the log file for a warning of + that nature. If this is the case, you will need to update the <span +class="ecss-1000">xkeyval</span> + package. + </p></li> + <li + class="enumerate" id="x1-4005x2">Run <a + id="dx1-4006"></a><a +href="#glo:makeglossaries"><span +class="ectt-1000">makeglossaries</span><a + id="dx1-4007"></a></a> on the document. This can be done on a terminal + either by typing <spacer type=vertical size=10><span class="obeylines-h"> + <br /><span +class="ectt-1000">makeglossaries minimalgls</span></span> + <!--l. 379--><p class="noindent" ><spacer type=vertical size=10> + or by typing <spacer type=vertical size=10><span class="obeylines-h"> + <br /><span +class="ectt-1000">perl makeglossaries minimalgls</span></span> + </p><!--l. 383--><p class="noindent" ><spacer type=vertical size=10> + If your system doesn’t recognise the command <span +class="ectt-1000">perl </span>then it’s likely you don’t + + + + have Perl installed. In which case you will need to use <a + id="dx1-4008"></a><a +href="#glo:makeindex"><span +class="ectt-1000">makeindex</span><a + id="dx1-4009"></a></a> + directly. You can do this in a terminal by typing (all on one line): + <spacer type=vertical size=10><span class="obeylines-h"> + <br /><span +class="ectt-1000">makeindex -s minimalgls.ist -t minimalgls.glg -o minimalgls.gls</span> + <span +class="ectt-1000">minimalgls.glo</span></span> + </p><!--l. 390--><p class="noindent" ><spacer type=vertical size=10> + (See <a +href="#x1-100001.3.3">§1.3.3 </a><a +href="#x1-100001.3.3">Using makeindex explicitly<!--tex4ht:ref: sec:makeindexapp --></a> for further details on using <a + id="dx1-4010"></a><span +class="ectt-1000">makeindex</span><a + id="dx1-4011"></a> + explicitly.) + </p><!--l. 394--><p class="noindent" >Note that if you need to specify the full path and the path contains + spaces, you will need to delimit the file names with the double-quote + character. + </p></li> + <li + class="enumerate" id="x1-4013x3">Run <span +class="ectt-1000">minimalgls.tex </span>through <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span +class="E">E</span>X</span></span> again (as step 1)</li></ol> + <!--l. 400--><p class="noindent" >You should now have a complete document. The number following each entry in + the glossary is the location number. By default, this is the page number where the + entry was referenced. + </p></dd><dt class="description"> +<span +class="ecbx-1000">sample4col.tex</span> </dt><dd +class="description"> This document illustrates a four column glossary where the entries + have a symbol in addition to the name and description. To create the complete + document, you need to do: <spacer type=vertical size=10><span class="obeylines-h"> + <br /><span +class="ectt-1000">latex sample4col</span> + <br /><span +class="ectt-1000">makeglossaries sample4col</span> + <br /><span +class="ectt-1000">latex sample4col</span></span> + <!--l. 412--><p class="noindent" ><spacer type=vertical size=10> + As before, if you don’t have Perl installed, you will need to use <a + id="dx1-4014"></a><a +href="#glo:makeindex"><span +class="ectt-1000">makeindex</span><a + id="dx1-4015"></a></a> directly + instead of using <a + id="dx1-4016"></a><a +href="#glo:makeglossaries"><span +class="ectt-1000">makeglossaries</span><a + id="dx1-4017"></a></a>. The vertical gap between entries is the gap + created at the start of each group. This can be suppressed by redefining + <span +class="ectt-1000">\glsgroupskip</span><a + id="dx1-4018"></a> after the glossary style has been set: + + + +</p> + <div class="verbatim" id="verbatim-1"> + \renewcommand*{\glsgroupskip}{} +</div> + <!--l. 420--><p class="nopar" > + </p></dd><dt class="description"> +<span +class="ecbx-1000">sampleAcr.tex</span> </dt><dd +class="description"> This document has some sample acronyms. It also adds the glossary + to the table of contents, so an extra run through <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span +class="E">E</span>X</span></span> is required to ensure + the document is up to date: <spacer type=vertical size=10><span class="obeylines-h"> + <br /><span +class="ectt-1000">latex sampleAcr</span> + <br /><span +class="ectt-1000">makeglossaries sampleAcr</span> + <br /><span +class="ectt-1000">latex sampleAcr</span> + <br /><span +class="ectt-1000">latex sampleAcr</span></span> + <!--l. 431--><p class="noindent" ><spacer type=vertical size=10> + </p></dd><dt class="description"> +<span +class="ecbx-1000">sampleAcrDesc.tex</span> </dt><dd +class="description"> This is similar to the previous example, except that the + acronyms have an associated description. As with the previous example, the + glossary is added to the table of contents, so an extra run through <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span +class="E">E</span>X</span></span> is + required: <spacer type=vertical size=10><span class="obeylines-h"> + <br /><span +class="ectt-1000">latex sampleAcrDesc</span> + <br /><span +class="ectt-1000">makeglossaries sampleAcrDesc</span> + <br /><span +class="ectt-1000">latex sampleAcrDesc</span> + <br /><span +class="ectt-1000">latex sampleAcrDesc</span></span> + <!--l. 442--><p class="noindent" ><spacer type=vertical size=10> + </p></dd><dt class="description"> +<span +class="ecbx-1000">sampleDesc.tex</span> </dt><dd +class="description"> This is similar to the previous example, except that it defines the + acronyms using <span +class="ectt-1000">\newglossaryentry</span><a + id="dx1-4019"></a> instead of <span +class="ectt-1000">\newacronym</span><a + id="dx1-4020"></a>. As with the + previous example, the glossary is added to the table of contents, so an extra run + through <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span +class="E">E</span>X</span></span> is required: <spacer type=vertical size=10><span class="obeylines-h"> + <br /><span +class="ectt-1000">latex sampleDesc</span> + <br /><span +class="ectt-1000">makeglossaries sampleDesc</span> + <br /><span +class="ectt-1000">latex sampleDesc</span> + <br /><span +class="ectt-1000">latex sampleDesc</span></span> + <!--l. 454--><p class="noindent" ><spacer type=vertical size=10> + + + + </p></dd><dt class="description"> +<span +class="ecbx-1000">sample-custom-acronym.tex</span> </dt><dd +class="description"> This document illustrates how to define your + own acronym style if the predefined styles don’t suit your requirements. + <spacer type=vertical size=10><span class="obeylines-h"> + <br /><span +class="ectt-1000">latex sample-custom-acronym</span> + <br /><span +class="ectt-1000">makeglossaries sample-custom-acronym</span> + <br /><span +class="ectt-1000">latex sample-custom-acronym</span></span> + <!--l. 463--><p class="noindent" ><spacer type=vertical size=10> + </p></dd><dt class="description"> +<span +class="ecbx-1000">sample-crossref.tex</span> </dt><dd +class="description"> This document illustrates how to cross-reference entries in the + glossary. <spacer type=vertical size=10><span class="obeylines-h"> + <br /><span +class="ectt-1000">latex sample-crossref</span> + <br /><span +class="ectt-1000">makeglossaries sample-crossref</span> + <br /><span +class="ectt-1000">latex sample-crossref</span></span> + <!--l. 472--><p class="noindent" ><spacer type=vertical size=10> + </p></dd><dt class="description"> +<span +class="ecbx-1000">sampleDB.tex</span> </dt><dd +class="description"> This document illustrates how to load external files containing the + glossary definitions. It also illustrates how to define a new glossary type. This + document has the <a + id="dx1-4021"></a><a +href="#glo:numberlist">number list<a + id="dx1-4022"></a></a> suppressed and uses <span +class="ectt-1000">\glsaddall</span><a + id="dx1-4023"></a> to add all the + entries to the glossaries without referencing each one explicitly. To create the + document do: <spacer type=vertical size=10><span class="obeylines-h"> + <br /><span +class="ectt-1000">latex sampleDB</span> + <br /><span +class="ectt-1000">makeglossaries sampleDB</span> + <br /><span +class="ectt-1000">latex sampleDB</span></span> + <!--l. 484--><p class="noindent" ><spacer type=vertical size=10> + The glossary definitions are stored in the accompanying files <span +class="ectt-1000">database1.tex </span>and + <span +class="ectt-1000">database2.tex</span>. Note that if you don’t have Perl installed, you will need to use + <a + id="dx1-4024"></a><a +href="#glo:makeindex"><span +class="ectt-1000">makeindex</span><a + id="dx1-4025"></a></a> twice instead of a single call to <a + id="dx1-4026"></a><a +href="#glo:makeglossaries"><span +class="ectt-1000">makeglossaries</span><a + id="dx1-4027"></a></a>: + </p><ol class="enumerate1" > + <li + class="enumerate" id="x1-4029x1">Create the main glossary: <spacer type=vertical size=10><span class="obeylines-h"> + <br /><span +class="ectt-1000">makeindex -s sampleDB.ist -t sampleDB.glg -o sampleDB.gls</span> + <span +class="ectt-1000">sampleDB.glo</span></span> + <!--l. 493--><p class="noindent" ><spacer type=vertical size=10> + </p></li> + <li + class="enumerate" id="x1-4031x2">Create the secondary glossary: <spacer type=vertical size=10><span class="obeylines-h"> + + + + <br /><span +class="ectt-1000">makeindex -s sampleDB.ist -t sampleDB.nlg -o sampleDB.not</span> + <span +class="ectt-1000">sampleDB.ntn</span></span> + <!--l. 497--><p class="noindent" ><spacer type=vertical size=10> + </p></li></ol> + </dd><dt class="description"> +<span +class="ecbx-1000">sampleEq.tex</span> </dt><dd +class="description"> This document illustrates how to change the location to something + other than the page number. In this case, the <span +class="ectt-1000">equation </span>counter is used since all + glossary entries appear inside an <span +class="ecss-1000">equation</span><a + id="dx1-4032"></a><a + id="dx1-4033"></a> environment. To create the document + do: <spacer type=vertical size=10><span class="obeylines-h"> + <br /><span +class="ectt-1000">latex sampleEq</span> + <br /><span +class="ectt-1000">makeglossaries sampleEq</span> + <br /><span +class="ectt-1000">latex sampleEq</span></span> + <!--l. 509--><p class="noindent" ><spacer type=vertical size=10> + </p></dd><dt class="description"> +<span +class="ecbx-1000">sampleEqPg.tex</span> </dt><dd +class="description"> This is similar to the previous example, but the <a + id="dx1-4034"></a><a +href="#glo:numberlist">number list<a + id="dx1-4035"></a>s</a> are a + mixture of page numbers and equation numbers. This example adds the + glossary to the table of contents, so an extra <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span +class="E">E</span>X</span></span> run is required: + <spacer type=vertical size=10><span class="obeylines-h"> + <br /><span +class="ectt-1000">latex sampleEqPg</span> + <br /><span +class="ectt-1000">makeglossaries sampleEqPg</span> + <br /><span +class="ectt-1000">latex sampleEqPg</span> + <br /><span +class="ectt-1000">latex sampleEqPg</span></span> + <!--l. 521--><p class="noindent" ><spacer type=vertical size=10> + </p></dd><dt class="description"> +<span +class="ecbx-1000">sampleSec.tex</span> </dt><dd +class="description"> This document also illustrates how to change the location to + something other than the page number. In this case, the <span +class="ectt-1000">section </span>counter is used. + This example adds the glossary to the table of contents, so an extra <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span +class="E">E</span>X</span></span> run + is required: <spacer type=vertical size=10><span class="obeylines-h"> + <br /><span +class="ectt-1000">latex sampleSec</span> + <br /><span +class="ectt-1000">makeglossaries sampleSec</span> + <br /><span +class="ectt-1000">latex sampleSec</span> + <br /><span +class="ectt-1000">latex sampleSec</span></span> + <!--l. 533--><p class="noindent" ><spacer type=vertical size=10> + + + + </p></dd><dt class="description"> +<span +class="ecbx-1000">sampleNtn.tex</span> </dt><dd +class="description"> This document illustrates how to create an additional glossary type. + This example adds the glossary to the table of contents, so an extra <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span +class="E">E</span>X</span></span> run + is required: <spacer type=vertical size=10><span class="obeylines-h"> + <br /><span +class="ectt-1000">latex sampleNtn</span> + <br /><span +class="ectt-1000">makeglossaries sampleNtn</span> + <br /><span +class="ectt-1000">latex sampleNtn</span> + <br /><span +class="ectt-1000">latex sampleNtn</span></span> + <!--l. 544--><p class="noindent" ><spacer type=vertical size=10> + Note that if you don’t have Perl installed, you will need to use <a + id="dx1-4036"></a><a +href="#glo:makeindex"><span +class="ectt-1000">makeindex</span><a + id="dx1-4037"></a></a> twice + instead of a single call to <a + id="dx1-4038"></a><a +href="#glo:makeglossaries"><span +class="ectt-1000">makeglossaries</span><a + id="dx1-4039"></a></a>: + </p><ol class="enumerate1" > + <li + class="enumerate" id="x1-4041x1">Create the main glossary: <spacer type=vertical size=10><span class="obeylines-h"> + <br /><span +class="ectt-1000">makeindex -s sampleNtn.ist -t sampleNtn.glg -o sampleNtn.gls</span> + <span +class="ectt-1000">sampleNtn.glo</span></span> + <!--l. 552--><p class="noindent" ><spacer type=vertical size=10> + </p></li> + <li + class="enumerate" id="x1-4043x2">Create the secondary glossary: <spacer type=vertical size=10><span class="obeylines-h"> + <br /><span +class="ectt-1000">makeindex -s sampleNtn.ist -t sampleNtn.nlg -o sampleNtn.not</span> + <span +class="ectt-1000">sampleNtn.ntn</span></span> + <!--l. 556--><p class="noindent" ><spacer type=vertical size=10> + </p></li></ol> + </dd><dt class="description"> +<span +class="ecbx-1000">sample.tex</span> </dt><dd +class="description"> This document illustrates some of the basics, including how to create + child entries that use the same name as the parent entry. This example adds the + glossary to the table of contents and it also uses <span +class="ectt-1000">\glsrefentry</span><a + id="dx1-4044"></a>, so an extra + <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span +class="E">E</span>X</span></span> run is required: <spacer type=vertical size=10><span class="obeylines-h"> + <br /><span +class="ectt-1000">latex sample</span> + <br /><span +class="ectt-1000">makeglossaries sample</span> + <br /><span +class="ectt-1000">latex sample</span> + <br /><span +class="ectt-1000">latex sample</span></span> + <!--l. 569--><p class="noindent" ><spacer type=vertical size=10> + You can see the difference between word and letter ordering if you substitute + <span +class="ecss-1000">order=word</span><a + id="dx1-4045"></a> with <span +class="ecss-1000">order=letter</span><a + id="dx1-4046"></a>. (Note that this will only have an effect if you use + <a + id="dx1-4047"></a><a +href="#glo:makeglossaries"><span +class="ectt-1000">makeglossaries</span><a + id="dx1-4048"></a></a>. If you use <a + id="dx1-4049"></a><a +href="#glo:makeindex"><span +class="ectt-1000">makeindex</span><a + id="dx1-4050"></a></a> explicitly, you will need to use the <span +class="ectt-1000">-l</span> + switch to indicate letter ordering.) + </p></dd><dt class="description"> +<span +class="ecbx-1000">sampletree.tex</span> </dt><dd +class="description"> This document illustrates a hierarchical glossary structure where + child entries have different names to their corresponding parent entry. To create + the document do: <spacer type=vertical size=10><span class="obeylines-h"> + + + + <br /><span +class="ectt-1000">latex sampletree</span> + <br /><span +class="ectt-1000">makeglossaries sampletree</span> + <br /><span +class="ectt-1000">latex sampletree</span></span> + <!--l. 585--><p class="noindent" ><spacer type=vertical size=10> + </p></dd><dt class="description"> +<span +class="ecbx-1000">sample-dual.tex</span> </dt><dd +class="description"> This document illustrates how to define an entry that both appears + in the list of acronyms and in the main glossary. To create the document do: + <spacer type=vertical size=10><span class="obeylines-h"> + <br /><span +class="ectt-1000">latex sample-dual</span> + <br /><span +class="ectt-1000">makeglossaries sample-dual</span> + <br /><span +class="ectt-1000">latex sample-dual</span></span> + <!--l. 594--><p class="noindent" ><spacer type=vertical size=10> + </p></dd><dt class="description"> +<span +class="ecbx-1000">samplexdy.tex</span> </dt><dd +class="description"> This document illustrates how to use the <span +class="ecss-1000">glossaries </span>package with + <a + id="dx1-4051"></a><a +href="#glo:xindy"><span +class="ectt-1000">xindy</span><a + id="dx1-4052"></a></a> instead of <a + id="dx1-4053"></a><a +href="#glo:makeindex"><span +class="ectt-1000">makeindex</span><a + id="dx1-4054"></a></a>. The document uses UTF8 encoding (with the + <span +class="ecss-1000">inputenc</span><a + id="dx1-4055"></a> package). The encoding is picked up by <a + id="dx1-4056"></a><a +href="#glo:makeglossaries"><span +class="ectt-1000">makeglossaries</span><a + id="dx1-4057"></a></a>. By default, this + document will create a <a + id="dx1-4058"></a><a +href="#glo:xindy"><span +class="ectt-1000">xindy</span><a + id="dx1-4059"></a></a> style file called <span +class="ectt-1000">samplexdy.xdy</span>, but if you + uncomment the lines + + + + <div class="verbatim" id="verbatim-2"> + \setStyleFile{samplexdy-mc} +  <br />\noist +  <br />\GlsSetXdyLanguage{} +</div> + <!--l. 607--><p class="nopar" > it will set the style file to <span +class="ectt-1000">samplexdy-mc.xdy </span>instead. This provides an additional + letter group for entries starting with “Mc” or “Mac”. If you use <a + id="dx1-4060"></a><a +href="#glo:makeglossaries"><span +class="ectt-1000">makeglossaries</span><a + id="dx1-4061"></a></a>, + you don’t need to supply any additional information. If you don’t use + <a + id="dx1-4062"></a><span +class="ectt-1000">makeglossaries</span><a + id="dx1-4063"></a>, you will need to specify the required information. Note that if + you set the style file to <span +class="ectt-1000">samplexdy-mc.xdy </span>you must also specify <span +class="ectt-1000">\noist</span><a + id="dx1-4064"></a>, + otherwise the <span +class="ecss-1000">glossaries </span>package will overwrite <span +class="ectt-1000">samplexdy-mc.xdy </span>and you will + lose the “Mc” letter group. + </p><!--l. 619--><p class="noindent" >To create the document do: <spacer type=vertical size=10><span class="obeylines-h"> + <br /><span +class="ectt-1000">latex samplexdy</span> + <br /><span +class="ectt-1000">makeglossaries samplexdy</span> + <br /><span +class="ectt-1000">latex samplexdy</span></span> + </p><!--l. 624--><p class="noindent" ><spacer type=vertical size=10> + If you don’t have Perl installed, you will have to call <a + id="dx1-4065"></a><a +href="#glo:xindy"><span +class="ectt-1000">xindy</span><a + id="dx1-4066"></a></a> explicitly instead of + using <a + id="dx1-4067"></a><a +href="#glo:makeglossaries"><span +class="ectt-1000">makeglossaries</span><a + id="dx1-4068"></a></a>. If you are using the default style file <span +class="ectt-1000">samplexdy.xdy</span>, then + do (no line breaks): <spacer type=vertical size=10><span class="obeylines-h"> + <br /><span +class="ectt-1000">xindy -L english -C utf8 -I xindy -M samplexdy -t samplexdy.glg -o</span> + <span +class="ectt-1000">samplexdy.gls samplexdy.glo</span></span> + </p><!--l. 631--><p class="noindent" ><spacer type=vertical size=10> + otherwise, if you are using <span +class="ectt-1000">samplexdy-mc.xdy</span>, then do (no line breaks): + <spacer type=vertical size=10><span class="obeylines-h"> + <br /><span +class="ectt-1000">xindy -I xindy -M samplexdy-mc -t samplexdy.glg -o samplexdy.gls</span> + <span +class="ectt-1000">samplexdy.glo</span></span> + </p><!--l. 636--><p class="noindent" ><spacer type=vertical size=10> + </p></dd><dt class="description"> +<span +class="ecbx-1000">samplexdy2.tex</span> </dt><dd +class="description"> This document illustrates how to use the <span +class="ecss-1000">glossaries </span>package where + the location numbers don’t follow a standard format. This example will only work + with <a + id="dx1-4069"></a><a +href="#glo:xindy"><span +class="ectt-1000">xindy</span><a + id="dx1-4070"></a></a>. To create the document do: <spacer type=vertical size=10><span class="obeylines-h"> + <br /><span +class="ectt-1000">pdflatex samplexdy2</span> + <br /><span +class="ectt-1000">makeglossaries samplexdy2</span> + <br /><span +class="ectt-1000">pdflatex samplexdy2</span></span> + <!--l. 646--><p class="noindent" ><spacer type=vertical size=10> + If you can’t use <a + id="dx1-4071"></a><a +href="#glo:makeglossaries"><span +class="ectt-1000">makeglossaries</span><a + id="dx1-4072"></a></a> then you need to do: <spacer type=vertical size=10><span class="obeylines-h"> + + + + <br /><span +class="ectt-1000">xindy -L english -C utf8 -I xindy -M samplexdy2 -t samplexdy2.glg -o</span> + <span +class="ectt-1000">samplexdy2.gls samplexdy2.glo</span></span> + </p><!--l. 650--><p class="noindent" ><spacer type=vertical size=10> + See <a +href="#x1-3600011.2">§11.2 </a><a +href="#x1-3600011.2">Locations and Number lists<!--tex4ht:ref: sec:xindyloc --></a> for further details. + </p></dd><dt class="description"> +<span +class="ecbx-1000">sampleutf8.tex</span> </dt><dd +class="description"> This is another example that uses <a + id="dx1-4073"></a><a +href="#glo:xindy"><span +class="ectt-1000">xindy</span><a + id="dx1-4074"></a></a>. Unlike <a + id="dx1-4075"></a><a +href="#glo:makeindex"><span +class="ectt-1000">makeindex</span><a + id="dx1-4076"></a></a>, <a + id="dx1-4077"></a><a +href="#glo:xindy"><span +class="ectt-1000">xindy</span><a + id="dx1-4078"></a></a> + can cope with accented or non-Latin characters. This document uses UTF8 + encoding. To create the document do: <spacer type=vertical size=10><span class="obeylines-h"> + <br /><span +class="ectt-1000">latex sampleutf8</span> + <br /><span +class="ectt-1000">makeglossaries sampleutf8</span> + <br /><span +class="ectt-1000">latex sampleutf8</span></span> + <!--l. 661--><p class="noindent" ><spacer type=vertical size=10> + If you don’t have Perl installed, you will have to call <a + id="dx1-4079"></a><a +href="#glo:xindy"><span +class="ectt-1000">xindy</span><a + id="dx1-4080"></a></a> explicitly instead of + using <a + id="dx1-4081"></a><a +href="#glo:makeglossaries"><span +class="ectt-1000">makeglossaries</span><a + id="dx1-4082"></a></a> (no line breaks): <spacer type=vertical size=10><span class="obeylines-h"> + <br /><span +class="ectt-1000">xindy -L english -C utf8 -I xindy -M sampleutf8 -t sampleutf8.glg -o</span> + <span +class="ectt-1000">sampleutf8.gls sampleutf8.glo</span></span> + </p><!--l. 667--><p class="noindent" ><spacer type=vertical size=10> + </p><!--l. 669--><p class="noindent" >If you remove the <span +class="ecss-1000">xindy</span><a + id="dx1-4083"></a> option from <span +class="ectt-1000">sampleutf8.tex </span>and do: <spacer type=vertical size=10><span class="obeylines-h"> + <br /><span +class="ectt-1000">latex sampleutf8</span> + <br /><span +class="ectt-1000">makeglossaries sampleutf8</span> + <br /><span +class="ectt-1000">latex sampleutf8</span></span> + </p><!--l. 675--><p class="noindent" ><spacer type=vertical size=10> + you will see that the entries that start with a non-Latin character now appear in + the symbols group, and the word “manœuvre” is now after “manor” instead of + before it. If you are unable to use <a + id="dx1-4084"></a><a +href="#glo:makeglossaries"><span +class="ectt-1000">makeglossaries</span><a + id="dx1-4085"></a></a>, the call to <a + id="dx1-4086"></a><a +href="#glo:makeindex"><span +class="ectt-1000">makeindex</span><a + id="dx1-4087"></a></a> is as + follows (no line breaks): <spacer type=vertical size=10><span class="obeylines-h"> + <br /><span +class="ectt-1000">makeindex -s sampleutf8.ist -t sampleutf8.glg -o sampleutf8.gls</span> + <span +class="ectt-1000">sampleutf8.glo</span></span> + </p><!--l. 683--><p class="noindent" ><spacer type=vertical size=10> + </p></dd><dt class="description"> +<span +class="ecbx-1000">sampleaccsupp.tex</span> </dt><dd +class="description"> This document uses the experimental <span +class="ecss-1000">glossaries-accsupp</span><a + id="dx1-4088"></a> package. + The symbol is set to the replacement text. Note that some PDF viewers don’t use + the accessibility support. Information about the <span +class="ecss-1000">glossaries-accsupp </span>package can be + found in <a +href="#x1-5600017">§17 </a><a +href="#x1-5600017">Accessibility Support<!--tex4ht:ref: sec:accsupp --></a>. + </dd></dl> + + + +<!--l. 695--><p class="noindent" > +</p> +<!--l. 695--><p class="noindent" ><a +href="#top">Top</a></p><h4 class="subsectionHead"><span class="titlemark">1.2 </span> <a + id="x1-50001.2"></a>Multi-Lingual Support</h4> +<!--l. 698--><p class="noindent" >As from version 1.17, the <span +class="ecss-1000">glossaries </span>package can now be used with <a + id="dx1-5001"></a><a +href="#glo:xindy"><span +class="ectt-1000">xindy</span><a + id="dx1-5002"></a></a> as well as +<a + id="dx1-5003"></a><a +href="#glo:makeindex"><span +class="ectt-1000">makeindex</span><a + id="dx1-5004"></a></a>. If you are writing in a language that uses accented characters or non-Latin +characters it is recommended that you use <a + id="dx1-5005"></a><span +class="ectt-1000">xindy</span><a + id="dx1-5006"></a> as <a + id="dx1-5007"></a><span +class="ectt-1000">makeindex</span><a + id="dx1-5008"></a> is hard-coded for +Latin languages. This means that you are not restricted to the A, …, Z letter +groups. If you want to use <a + id="dx1-5009"></a><span +class="ectt-1000">xindy</span><a + id="dx1-5010"></a>, remember to use the <span +class="ecss-1000">xindy</span><a + id="dx1-5011"></a> package option. For +example: + + + +</p> + <div class="verbatim" id="verbatim-3"> +\documentclass[frenchb]{article} + <br />\usepackage[utf8]{inputenc} + <br />\usepackage[T1]{fontenc} + <br />\usepackage{babel} + <br />\usepackage[xindy]{glossaries} +</div> +<!--l. 712--><p class="nopar" > +</p><!--l. 714--><p class="indent" > <div class="important" title="Important Note"> Note that although an accented character, such as é, looks like a plain character in +your tex file, it’s actually a macro and can therefore cause problems. +</p><!--l. 719--><p class="indent" > + </p><ol class="enumerate1" > + <li + class="enumerate" id="x1-5013x1">If you use an accented (or other expandable) character at the start of an entry + name, you must place it in a group, or it will cause a problem for commands that + convert the first letter to uppercase (e.g. <span +class="ectt-1000">\Gls</span><a + id="dx1-5014"></a>) due to expansion issues. For + example: + + + + <div class="verbatim" id="verbatim-4"> + \newglossaryentry{elite}{name={{é}lite}, +  <br />description={select group or class}} +</div> + <!--l. 728--><p class="nopar" > + </p></li> + <li + class="enumerate" id="x1-5016x2">If you use an accented (or other expandable) character in an entry name + and you haven’t switched off the <span +class="ecss-1000">name</span><a + id="dx1-5017"></a> key <a + id="dx1-5018"></a><a +href="#glo:sanitize">sanitization<a + id="dx1-5019"></a></a>, you must use + commands like <span +class="ectt-1000">\glsentrytext</span><a + id="dx1-5020"></a> or <span +class="ectt-1000">\glstext</span><a + id="dx1-5021"></a> instead of <span +class="ectt-1000">\glsentryname</span><a + id="dx1-5022"></a> or + <span +class="ectt-1000">\glsname</span><a + id="dx1-5023"></a> or you will end up with strange looking characters in your + document. + </li></ol> +</div> +<!--l. 738--><p class="noindent" > +</p><!--l. 740--><p class="indent" > If you use the <span +class="ecss-1000">inputenc</span><a + id="dx1-5024"></a> package, <a + id="dx1-5025"></a><a +href="#glo:makeglossaries"><span +class="ectt-1000">makeglossaries</span><a + id="dx1-5026"></a></a> will pick up the encoding from the +auxiliary file. If you use <a + id="dx1-5027"></a><a +href="#glo:xindy"><span +class="ectt-1000">xindy</span><a + id="dx1-5028"></a></a> explicitly instead of via <a + id="dx1-5029"></a><span +class="ectt-1000">makeglossaries</span><a + id="dx1-5030"></a>, you may need +to specify the encoding using the <span +class="ectt-1000">-C </span>option. Read the <a + id="dx1-5031"></a><span +class="ectt-1000">xindy</span><a + id="dx1-5032"></a> manual for further +details. +</p><!--l. 746--><p class="noindent" > +</p> +<!--l. 746--><p class="noindent" ><a +href="#top">Top</a></p><h5 class="subsubsectionHead"><span class="titlemark">1.2.1 </span> <a + id="x1-60001.2.1"></a>Changing the Fixed Names</h5> +<!--l. 749--><p class="noindent" >As from version 1.08, the <span +class="ecss-1000">glossaries </span>package now has limited multi-lingual support, +thanks to all the people who have sent me the relevant translations either via email or +via <span +class="ectt-1000">comp.text.tex</span>. However you must load <span +class="ecss-1000">babel</span><a + id="dx1-6001"></a> or <span +class="ecss-1000">polyglossia</span><a + id="dx1-6002"></a> <span +class="ecti-1000">before </span><span +class="ecss-1000">glossaries </span>to +enable this. Note that if <span +class="ecss-1000">babel</span><a + id="dx1-6003"></a> is loaded and the <span +class="ecss-1000">translator</span><a + id="dx1-6004"></a> package is detected on <span class="TEX">T<span +class="E">E</span>X</span>’s +path, then the <span +class="ecss-1000">translator</span><a + id="dx1-6005"></a> package will be loaded automatically. However, it may not pick +up on the required languages so, if the predefined text is not translated, you may +need to explicitly load the <span +class="ecss-1000">translator</span><a + id="dx1-6006"></a> package with the required languages. For +example: + + + +</p> + <div class="verbatim" id="verbatim-5"> +\usepackage[spanish]{babel} + <br />\usepackage[spanish]{translator} + <br />\usepackage{glossaries} +</div> +<!--l. 764--><p class="nopar" > Alternatively, specify the language as a class option rather than a package option. For +example: + + + +</p> + <div class="verbatim" id="verbatim-6"> +\documentclass[spanish]{report} + <br />\usepackage{babel} + <br />\usepackage{glossaries} +</div> +<!--l. 772--><p class="nopar" > +</p><!--l. 774--><p class="indent" > If you want to use <span +class="ecss-1000">ngerman</span><a + id="dx1-6007"></a> or <span +class="ecss-1000">german</span><a + id="dx1-6008"></a> instead of <span +class="ecss-1000">babel</span><a + id="dx1-6009"></a>, you will need to include the +<span +class="ecss-1000">translator</span><a + id="dx1-6010"></a> package to provide the translations. For example: + + + +</p> + <div class="verbatim" id="verbatim-7"> +\documentclass[ngerman]{article} + <br />\usepackage{ngerman} + <br />\usepackage{translator} + <br />\usepackage{glossaries} +</div> +<!--l. 782--><p class="nopar" > +</p><!--l. 784--><p class="indent" > The languages are currently supported by the <span +class="ecss-1000">glossaries </span>package are listed in +<a +href="#x1-60111">table 1</a>. Please note that (apart from spelling mistakes) I don’t intend to change the +default translations as it will cause compatibility problems. +</p> + <div class="table"> + + + +<!--l. 790--><p class="indent" > <a + id="x1-60111"></a></p><hr class="float" /><div class="float" +> + + + + <div class="caption" +><span class="id">Table 1: </span><span +class="content">Supported Languages</span></div><!--tex4ht:label?: x1-60111 --> +<div class="center" +> +<!--l. 793--><p class="noindent" > +</p> +<div class="tabular"> <table id="TBL-2" class="tabular" +cellspacing="0" cellpadding="0" +><colgroup id="TBL-2-1g"><col +id="TBL-2-1" /><col +id="TBL-2-2" /></colgroup><tr + style="vertical-align:baseline;" id="TBL-2-1-"><td style="white-space:nowrap; text-align:left;" id="TBL-2-1-1" +class="td11"><span +class="ecbx-1000">Language </span></td><td style="white-space:nowrap; text-align:center;" id="TBL-2-1-2" +class="td11"><span +class="ecbx-1000">As from version</span></td> +</tr><tr + style="vertical-align:baseline;" id="TBL-2-2-"><td style="white-space:nowrap; text-align:left;" id="TBL-2-2-1" +class="td11">Brazilian Portuguese</td><td style="white-space:nowrap; text-align:center;" id="TBL-2-2-2" +class="td11"> 1.17 </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-2-3-"><td style="white-space:nowrap; text-align:left;" id="TBL-2-3-1" +class="td11">Danish </td><td style="white-space:nowrap; text-align:center;" id="TBL-2-3-2" +class="td11"> 1.08 </td></tr><tr + style="vertical-align:baseline;" id="TBL-2-4-"><td style="white-space:nowrap; text-align:left;" id="TBL-2-4-1" +class="td11">Dutch </td><td style="white-space:nowrap; text-align:center;" id="TBL-2-4-2" +class="td11"> 1.08</td> +</tr><tr + style="vertical-align:baseline;" id="TBL-2-5-"><td style="white-space:nowrap; text-align:left;" id="TBL-2-5-1" +class="td11">English </td><td style="white-space:nowrap; text-align:center;" id="TBL-2-5-2" +class="td11"> 1.08 </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-2-6-"><td style="white-space:nowrap; text-align:left;" id="TBL-2-6-1" +class="td11">French </td><td style="white-space:nowrap; text-align:center;" id="TBL-2-6-2" +class="td11"> 1.08 </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-2-7-"><td style="white-space:nowrap; text-align:left;" id="TBL-2-7-1" +class="td11">German </td><td style="white-space:nowrap; text-align:center;" id="TBL-2-7-2" +class="td11"> 1.08 </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-2-8-"><td style="white-space:nowrap; text-align:left;" id="TBL-2-8-1" +class="td11">Irish </td><td style="white-space:nowrap; text-align:center;" id="TBL-2-8-2" +class="td11"> 1.08 </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-2-9-"><td style="white-space:nowrap; text-align:left;" id="TBL-2-9-1" +class="td11">Italian </td><td style="white-space:nowrap; text-align:center;" id="TBL-2-9-2" +class="td11"> 1.08 </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-2-10-"><td style="white-space:nowrap; text-align:left;" id="TBL-2-10-1" +class="td11">Hungarian </td><td style="white-space:nowrap; text-align:center;" id="TBL-2-10-2" +class="td11"> 1.08 </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-2-11-"><td style="white-space:nowrap; text-align:left;" id="TBL-2-11-1" +class="td11">Polish </td><td style="white-space:nowrap; text-align:center;" id="TBL-2-11-2" +class="td11"> 1.13 </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-2-12-"><td style="white-space:nowrap; text-align:left;" id="TBL-2-12-1" +class="td11">Serbian </td><td style="white-space:nowrap; text-align:center;" id="TBL-2-12-2" +class="td11"> 2.06 </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-2-13-"><td style="white-space:nowrap; text-align:left;" id="TBL-2-13-1" +class="td11">Spanish </td><td style="white-space:nowrap; text-align:center;" id="TBL-2-13-2" +class="td11"> 1.08 </td></tr></table> +</div></div> + + + + </div><hr class="endfloat" /> + </div> +<!--l. 812--><p class="indent" > The language dependent commands and <span +class="ecss-1000">translator</span><a + id="dx1-6012"></a> keys used by the glossaries +package are listed in <a +href="#x1-60132">table 2</a>. +</p> + <div class="table"> + + + +<!--l. 815--><p class="indent" > <a + id="x1-60132"></a></p><hr class="float" /><div class="float" +> + + + + <div class="caption" +><span class="id">Table 2: </span><span +class="content">Customised Text</span></div><!--tex4ht:label?: x1-60132 --> +<div class="center" +> +<!--l. 818--><p class="noindent" > +</p> +<div class="tabular"> <table id="TBL-3" class="tabular" +cellspacing="0" cellpadding="0" +><colgroup id="TBL-3-1g"><col +id="TBL-3-1" /><col +id="TBL-3-2" /><col +id="TBL-3-3" /></colgroup><tr + style="vertical-align:baseline;" id="TBL-3-1-"><td style="white-space:nowrap; text-align:left;" id="TBL-3-1-1" +class="td01"><span +class="ecbx-1000">Command Name </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-3-1-2" +class="td11"><span +class="ecbx-1000">Translator Key Word </span></td><td style="white-space:wrap; text-align:left;" id="TBL-3-1-3" +class="td10"><!--l. 821--><p class="noindent" ><span +class="ecbx-1000">Purpose</span> </p></td> +</tr><tr + style="vertical-align:baseline;" id="TBL-3-2-"><td style="white-space:nowrap; text-align:left;" id="TBL-3-2-1" +class="td01"><span +class="ectt-1000">\glossaryname</span><a + id="dx1-6014"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-3-2-2" +class="td11"><span +class="ectt-1000">Glossary </span></td><td style="white-space:wrap; text-align:left;" id="TBL-3-2-3" +class="td10"><!--l. 822--><p class="noindent" >Title of the main glossary. </p></td> +</tr><tr + style="vertical-align:baseline;" id="TBL-3-3-"><td style="white-space:nowrap; text-align:left;" id="TBL-3-3-1" +class="td01"><span +class="ectt-1000">\acronymname</span><a + id="dx1-6015"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-3-3-2" +class="td11"><span +class="ectt-1000">Acronyms </span></td><td style="white-space:wrap; text-align:left;" id="TBL-3-3-3" +class="td10"><!--l. 823--><p class="noindent" >Title of the list of acronyms +(when used with package option +<span +class="ecss-1000">acronym</span><a + id="dx1-6016"></a>). </p></td> +</tr><tr + style="vertical-align:baseline;" id="TBL-3-4-"><td style="white-space:nowrap; text-align:left;" id="TBL-3-4-1" +class="td01"><span +class="ectt-1000">\entryname</span><a + id="dx1-6017"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-3-4-2" +class="td11"><span +class="ectt-1000">Notation (glossaries) </span></td><td style="white-space:wrap; text-align:left;" id="TBL-3-4-3" +class="td10"><!--l. 826--><p class="noindent" >Header for first column in the +glossary (for 2, 3 or 4 column +glossaries that support headers).</p></td> +</tr><tr + style="vertical-align:baseline;" id="TBL-3-5-"><td style="white-space:nowrap; text-align:left;" id="TBL-3-5-1" +class="td01"><span +class="ectt-1000">\descriptionname</span><a + id="dx1-6018"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-3-5-2" +class="td11"><span +class="ectt-1000">Description (glossaries)</span></td><td style="white-space:wrap; text-align:left;" id="TBL-3-5-3" +class="td10"><!--l. 829--><p class="noindent" >Header for second column in the +glossary (for 2, 3 or 4 column +glossaries that support headers).</p></td> +</tr><tr + style="vertical-align:baseline;" id="TBL-3-6-"><td style="white-space:nowrap; text-align:left;" id="TBL-3-6-1" +class="td01"><span +class="ectt-1000">\symbolname</span><a + id="dx1-6019"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-3-6-2" +class="td11"><span +class="ectt-1000">Symbol (glossaries) </span></td><td style="white-space:wrap; text-align:left;" id="TBL-3-6-3" +class="td10"><!--l. 831--><p class="noindent" >Header for symbol column in the +glossary for glossary styles that +support this option. </p></td> +</tr><tr + style="vertical-align:baseline;" id="TBL-3-7-"><td style="white-space:nowrap; text-align:left;" id="TBL-3-7-1" +class="td01"><span +class="ectt-1000">\pagelistname</span><a + id="dx1-6020"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-3-7-2" +class="td11"><span +class="ectt-1000">Page List (glossaries) </span></td><td style="white-space:wrap; text-align:left;" id="TBL-3-7-3" +class="td10"><!--l. 834--><p class="noindent" >Header for page list column in +the glossary for glossaries that +support this option. </p></td> +</tr><tr + style="vertical-align:baseline;" id="TBL-3-8-"><td style="white-space:nowrap; text-align:left;" id="TBL-3-8-1" +class="td01"><span +class="ectt-1000">\glssymbolsgroupname</span><a + id="dx1-6021"></a></td><td style="white-space:nowrap; text-align:left;" id="TBL-3-8-2" +class="td11"><span +class="ectt-1000">Symbols (glossaries) </span></td><td style="white-space:wrap; text-align:left;" id="TBL-3-8-3" +class="td10"><!--l. 837--><p class="noindent" >Header for symbols section of the +glossary for glossary styles that +support this option. </p></td> +</tr><tr + style="vertical-align:baseline;" id="TBL-3-9-"><td style="white-space:nowrap; text-align:left;" id="TBL-3-9-1" +class="td01"><span +class="ectt-1000">\glsnumbersgroupname</span><a + id="dx1-6022"></a></td><td style="white-space:nowrap; text-align:left;" id="TBL-3-9-2" +class="td11"><span +class="ectt-1000">Numbers (glossaries) </span></td><td style="white-space:wrap; text-align:left;" id="TBL-3-9-3" +class="td10"><!--l. 839--><p class="noindent" >Header for numbers section of +the glossary for glossary styles +that support this option. </p></td> +</tr></table></div></div> + + + + </div><hr class="endfloat" /> + </div> +<!--l. 846--><p class="indent" > Due to the varied nature of glossaries, it’s likely that the predefined translations +may not be appropriate. If you are using the <span +class="ecss-1000">babel</span><a + id="dx1-6023"></a> package and do not have the +<span +class="ecss-1000">translator</span><a + id="dx1-6024"></a> package installed, you need to be familiar with the advice given in <a +href="http://www.tex.ac.uk/cgi-bin/texfaq2html?label=latexwords" >changing +the words babel uses</a>. If you have the <span +class="ecss-1000">translator</span><a + id="dx1-6025"></a> package installed, then you can provide +your own dictionary with the necessary modifications (using <span +class="ectt-1000">\deftranslation</span>) and +load it using <span +class="ectt-1000">\usedictionary</span>. +</p><!--l. 856--><p class="indent" > <div class="important" title="Important Note"> Note that the dictionaries are loaded at the beginning of the document, so it won’t +have any effect if you put <span +class="ectt-1000">\deftranslation </span>in the preamble. It should be +put in your personal dictionary instead (as in the example below). See the +<span +class="ecss-1000">translator</span><a + id="dx1-6026"></a> documentation for further details. (Now with <span +class="ecss-1000">beamer</span><a + id="dx1-6027"></a> documentation.) +</div> +</p><!--l. 863--><p class="noindent" > +</p><!--l. 865--><p class="indent" > Your custom dictionary doesn’t have to be just a translation from English to +another language. You may prefer to have a dictionary for a particular type of +document. For example, suppose your institution’s in-house reports have to have the +glossary labelled as “Nomenclature” and the page list should be labelled “Location”, +then you can create a file called, say, + + + +</p> + <div class="verbatim" id="verbatim-8"> +myinstitute-glossaries-dictionary-English.dict +</div> +<!--l. 873--><p class="nopar" > that contains the following: + + + +</p> + <div class="verbatim" id="verbatim-9"> +\ProvidesDictionary{myinstitute-glossaries-dictionary}{English} + <br />\deftranslation{Glossary}{Nomenclature} + <br />\deftranslation{Page List (glossaries)}{Location} +</div> +<!--l. 879--><p class="nopar" > You can now load it using: + + + +</p> + <div class="verbatim" id="verbatim-10"> +\usedictionary{myinstitute-glossaries-dictionary} +</div> +<!--l. 883--><p class="nopar" > (Make sure that <span +class="ectt-1000">myinstitute-glossaries-dictionary-English.dict </span>can be found +by <span class="TEX">T<span +class="E">E</span>X</span>.) If you want to share your custom dictionary, you can upload it to +<a +href="http://www.ctan.org/" >CTAN</a>. +</p><!--l. 888--><p class="indent" > If you are using <span +class="ecss-1000">babel</span><a + id="dx1-6028"></a> and don’t want to use the <span +class="ecss-1000">translator</span><a + id="dx1-6029"></a> interface, you can +suppress it using the package option <span +class="ecss-1000">translate=false</span><a + id="dx1-6030"></a>, and either load <span +class="ecss-1000">glossaries-babel</span><a + id="dx1-6031"></a> +after <span +class="ecss-1000">glossaries </span>or specify you’re own translations. For example: + + + +</p> + <div class="verbatim" id="verbatim-11"> +\documentclass[british]{article} + <br />\usepackage{babel} + <br />\usepackage[translate=false]{glossaries} + <br />\usepackage{glossaries-babel} +</div> +<!--l. 899--><p class="nopar" > or: + + + +</p> + <div class="verbatim" id="verbatim-12"> +\documentclass[british]{article} + <br />\usepackage{babel} + <br />\usepackage[translate=false]{glossaries} + <br />\addto\captionsbritish{% + <br />    \renewcommand*{\glossaryname}{List of Terms}% + <br />    \renewcommand*{\acronymname}{List of Acronyms}% + <br />    \renewcommand*{\entryname}{Notation}% + <br />    \renewcommand*{\descriptionname}{Description}% + <br />    \renewcommand*{\symbolname}{Symbol}% + <br />    \renewcommand*{\pagelistname}{Page List}% + <br />    \renewcommand*{\glssymbolsgroupname}{Symbols}% + <br />    \renewcommand*{\glsnumbersgroupname}{Numbers}% + <br />} +</div> +<!--l. 917--><p class="nopar" > +</p><!--l. 919--><p class="indent" > If you are using <span +class="ecss-1000">polyglossia</span><a + id="dx1-6032"></a> instead of <span +class="ecss-1000">babel</span><a + id="dx1-6033"></a>, <span +class="ecss-1000">glossaries-polyglossia</span><a + id="dx1-6034"></a> will automatically +be loaded unless you specify the package option <span +class="ecss-1000">translate=false</span><a + id="dx1-6035"></a>. +</p><!--l. 923--><p class="indent" > Note that <a + id="dx1-6036"></a><a +href="#glo:xindy"><span +class="ectt-1000">xindy</span><a + id="dx1-6037"></a></a> provides much better multi-lingual support than <a + id="dx1-6038"></a><a +href="#glo:makeindex"><span +class="ectt-1000">makeindex</span><a + id="dx1-6039"></a></a>, so it’s +recommended that you use <a + id="dx1-6040"></a><span +class="ectt-1000">xindy</span><a + id="dx1-6041"></a> if you have glossary entries that contain diacritics or +non-Roman letters. See <a +href="#x1-3400011">§11 </a><a +href="#x1-3400011">Xindy<!--tex4ht:ref: sec:xindy --></a> for further details. +</p> +<!--l. 929--><p class="noindent" ><a +href="#top">Top</a></p><h4 class="subsectionHead"><span class="titlemark">1.3 </span> <a + id="x1-70001.3"></a>Generating the Associated Glossary Files</h4> +<!--l. 932--><p class="noindent" >In order to generate a sorted glossary with compact location lists, it is necessary to use +an external indexing application as an intermediate step. It is this application that +creates the file containing the code that typesets the glossary. If this step is omitted, the +glossaries will not appear in your document. The two indexing applications that are +most commonly used with <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span +class="E">E</span>X</span></span> are <a + id="dx1-7001"></a><a +href="#glo:makeindex"><span +class="ectt-1000">makeindex</span><a + id="dx1-7002"></a></a> and <a + id="dx1-7003"></a><a +href="#glo:xindy"><span +class="ectt-1000">xindy</span><a + id="dx1-7004"></a></a>. As from version 1.17, +the <span +class="ecss-1000">glossaries </span>package can be used with either of these applications. Previous versions +were designed to be used with <a + id="dx1-7005"></a><span +class="ectt-1000">makeindex</span><a + id="dx1-7006"></a> only. Note that <a + id="dx1-7007"></a><span +class="ectt-1000">xindy</span><a + id="dx1-7008"></a> has much better +multi-lingual support than <a + id="dx1-7009"></a><span +class="ectt-1000">makeindex</span><a + id="dx1-7010"></a>, so <a + id="dx1-7011"></a><span +class="ectt-1000">xindy</span><a + id="dx1-7012"></a> is recommended if you’re not writing +in English. Commands that only have an effect when <a + id="dx1-7013"></a><span +class="ectt-1000">xindy</span><a + id="dx1-7014"></a> is used are described in <a +href="#x1-3400011">§11 +</a><a +href="#x1-3400011">Xindy<!--tex4ht:ref: sec:xindy --></a>. +</p><!--l. 947--><p class="indent" > The <span +class="ecss-1000">glossaries </span>package comes with the Perl script <a + id="dx1-7015"></a><a +href="#glo:makeglossaries"><span +class="ectt-1000">makeglossaries</span><a + id="dx1-7016"></a></a> which will run +<a + id="dx1-7017"></a><a +href="#glo:makeindex"><span +class="ectt-1000">makeindex</span><a + id="dx1-7018"></a></a> or <a + id="dx1-7019"></a><a +href="#glo:xindy"><span +class="ectt-1000">xindy</span><a + id="dx1-7020"></a></a> on all the glossary files using a customized style file (which is +created by <span +class="ectt-1000">\makeglossaries</span><a + id="dx1-7021"></a>). See <a +href="#x1-80001.3.1">§1.3.1 </a><a +href="#x1-80001.3.1">Using the makeglossaries Perl Script<!--tex4ht:ref: sec:makeglossariesapp --></a> for +further details. Perl is stable, cross-platform, open source software that is used by +a number of <span class="TEX">T<span +class="E">E</span>X</span>-related applications. Further information is available at +<a +href="http://www.perl.org/about.html" class="url" ><span +class="ectt-1000">http://www.perl.org/about.html</span></a>. The advantages of using <a + id="dx1-7022"></a><span +class="ectt-1000">makeglossaries</span><a + id="dx1-7023"></a>: +</p> + + + + <ul class="itemize1"> + <li class="itemize">It automatically detects whether to use <a + id="dx1-7024"></a><span +class="ectt-1000">makeindex</span><a + id="dx1-7025"></a> or <a + id="dx1-7026"></a><span +class="ectt-1000">xindy</span><a + id="dx1-7027"></a> and sets the + relevant application switches. + </li> + <li class="itemize">One call of <a + id="dx1-7028"></a><span +class="ectt-1000">makeglossaries</span><a + id="dx1-7029"></a> will run <a + id="dx1-7030"></a><span +class="ectt-1000">makeindex</span><a + id="dx1-7031"></a>/<a + id="dx1-7032"></a><span +class="ectt-1000">xindy</span><a + id="dx1-7033"></a> for each glossary + type. + </li> + <li class="itemize">If things go wrong, <a + id="dx1-7034"></a><a +href="#glo:makeglossaries"><span +class="ectt-1000">makeglossaries</span><a + id="dx1-7035"></a></a> will scan the messages from <a + id="dx1-7036"></a><a +href="#glo:makeindex"><span +class="ectt-1000">makeindex</span><a + id="dx1-7037"></a></a> + or <a + id="dx1-7038"></a><a +href="#glo:xindy"><span +class="ectt-1000">xindy</span><a + id="dx1-7039"></a></a> and attempt to diagnose the problem in relation to the <span +class="ecss-1000">glossaries</span> + package. This will hopefully provide more helpful messages in some cases. If + it can’t diagnose the problem, you will have to read the relevant transcript + file and see if you can work it out from the <a + id="dx1-7040"></a><span +class="ectt-1000">makeindex</span><a + id="dx1-7041"></a> or <a + id="dx1-7042"></a><span +class="ectt-1000">xindy</span><a + id="dx1-7043"></a> messages. + </li></ul> +<!--l. 973--><p class="indent" > Whilst it is strongly recommended that you use the <a + id="dx1-7044"></a><a +href="#glo:makeglossaries"><span +class="ectt-1000">makeglossaries</span><a + id="dx1-7045"></a></a> script, it is +possible to use the <span +class="ecss-1000">glossaries </span>package without having Perl installed. In which case, +if you have used the <span +class="ecss-1000">xindy</span><a + id="dx1-7046"></a> package option, you will need to use <a + id="dx1-7047"></a><a +href="#glo:xindy"><span +class="ectt-1000">xindy</span><a + id="dx1-7048"></a></a> (see +<a +href="#x1-90001.3.2">§1.3.2 </a><a +href="#x1-90001.3.2">Using xindy explicitly<!--tex4ht:ref: sec:xindyapp --></a>), otherwise you will need to use <a + id="dx1-7049"></a><a +href="#glo:makeindex"><span +class="ectt-1000">makeindex</span><a + id="dx1-7050"></a></a> (see +<a +href="#x1-100001.3.3">§1.3.3 </a><a +href="#x1-100001.3.3">Using makeindex explicitly<!--tex4ht:ref: sec:makeindexapp --></a>). Note that some commands and package +options have no effect if you don’t use <a + id="dx1-7051"></a><span +class="ectt-1000">makeglossaries</span><a + id="dx1-7052"></a>. These are listed in +<a +href="#x1-70813">table 3</a>. +</p><!--l. 983--><p class="indent" > Note that if any of your entries use an entry that is not referenced outside the +glossary, you will need to do an additional <a + id="dx1-7053"></a><a +href="#glo:makeglossaries"><span +class="ectt-1000">makeglossaries</span><a + id="dx1-7054"></a></a>, <a + id="dx1-7055"></a><a +href="#glo:makeindex"><span +class="ectt-1000">makeindex</span><a + id="dx1-7056"></a></a> or +<a + id="dx1-7057"></a><a +href="#glo:xindy"><span +class="ectt-1000">xindy</span><a + id="dx1-7058"></a></a> run, as appropriate. For example, suppose you have defined the following +entries:<span class="footnote-mark"><a +href="#fn2x0" id="fn2x0-bk"><sup class="textsuperscript">2</sup></a></span><a + id="x1-7059f2"></a> + + + +</p> + <div class="verbatim" id="verbatim-13"> +\newglossaryentry{citrusfruit}{name={citrus fruit}, + <br />description={fruit of any citrus tree. (See also + <br />\gls{orange})}} + <br />\newglossaryentry{orange}{name={orange}, + <br />description={an orange coloured fruit.}} +</div> +<!--l. 998--><p class="nopar" > and suppose you have <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\gls{citrusfruit}</span></span></span> in your document but don’t reference the +<span +class="ectt-1000">orange </span>entry, then the <span +class="ectt-1000">orange </span>entry won’t appear in your glossary until you first +create the glossary and then do another run of <a + id="dx1-7063"></a><a +href="#glo:makeglossaries"><span +class="ectt-1000">makeglossaries</span><a + id="dx1-7064"></a></a>, <a + id="dx1-7065"></a><a +href="#glo:makeindex"><span +class="ectt-1000">makeindex</span><a + id="dx1-7066"></a></a> or +<a + id="dx1-7067"></a><a +href="#glo:xindy"><span +class="ectt-1000">xindy</span><a + id="dx1-7068"></a></a>. For example, if the document is called <span +class="ectt-1000">myDoc.tex</span>, then you must do: +<spacer type=vertical size=10><span class="obeylines-h"> + <br /><span +class="ectt-1000">latex myDoc</span> + <br /><span +class="ectt-1000">makeglossaries myDoc</span> + <br /><span +class="ectt-1000">latex myDoc</span> + <br /><span +class="ectt-1000">makeglossaries myDoc</span> + <br /><span +class="ectt-1000">latex myDoc</span></span> +</p><!--l. 1012--><p class="indent" > <spacer type=vertical size=10> +</p><!--l. 1014--><p class="indent" > Likewise, an additional <a + id="dx1-7069"></a><a +href="#glo:makeglossaries"><span +class="ectt-1000">makeglossaries</span><a + id="dx1-7070"></a></a> and <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span +class="E">E</span>X</span></span> run may be required if the +document pages shift with re-runs. For example, if the page numbering is not reset after +the table of contents, the insertion of the table of contents on the second <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span +class="E">E</span>X</span></span> run +may push glossary entries across page boundaries, which means that the <a + id="dx1-7071"></a><a +href="#glo:numberlist">number list<a + id="dx1-7072"></a>s</a> in +the glossary may need updating. +</p><!--l. 1022--><p class="indent" > The examples in this document assume that you are accessing <a + id="dx1-7073"></a><a +href="#glo:makeglossaries"><span +class="ectt-1000">makeglossaries</span><a + id="dx1-7074"></a></a>, <a + id="dx1-7075"></a><a +href="#glo:xindy"><span +class="ectt-1000">xindy</span><a + id="dx1-7076"></a></a> +or <a + id="dx1-7077"></a><a +href="#glo:makeindex"><span +class="ectt-1000">makeindex</span><a + id="dx1-7078"></a></a> via a terminal. Windows users can use the MSDOS Prompt which is +usually accessed via the <span +class="ecss-1000">Start->All Programs </span>menu or <span +class="ecss-1000">Start->All Programs->Accessories</span> +menu. +</p><!--l. 1028--><p class="indent" > Alternatively, your text editor may have the facility to create a function that will +call the required application. The article <a +href="http://www.latex-community.org/index.php?option=com_content&view=article&id=263:glossaries-nomenclature-lists-of-symbols-and-acronyms&catid=55:latex-general&Itemid=114" >“Glossaries, Nomenclature, List of Symbols +and Acronyms”</a> in the <a +href="http://www.latex-community.org/" ><span class="LATEX">L<span class="A">A</span><span class="TEX">T<span +class="E">E</span>X</span></span> Community’s</a> Know How section describes how to +do this for TeXnicCenter, and the thread <a +href="http://groups.google.com/group/comp.text.tex/browse_thread/thread/edd83831b81b0759?hl=en" >“Executing Glossaries’ makeindex +from a WinEdt macro”</a> on the <span +class="ectt-1000">comp.text.tex </span>newsgroup describes how to +do it for WinEdt. For other editors see the editor’s user manual for further +details. +</p><!--l. 1040--><p class="indent" > If any problems occur, remember to check the transcript files (e.g. <span +class="ectt-1000">.glg</span><a + id="dx1-7079"></a> or <span +class="ectt-1000">.alg</span><a + id="dx1-7080"></a>) for +messages. +</p> + <div class="table"> + + + +<!--l. 1043--><p class="indent" > <a + id="x1-70813"></a></p><hr class="float" /><div class="float" +> + + + + <div class="caption" +><span class="id">Table 3: </span><span +class="content">Commands and package options that have no effect when using <span +class="ectt-1000">xindy</span> +or <span +class="ectt-1000">makeindex </span>explicitly</span></div><!--tex4ht:label?: x1-70813 --> +<div class="tabular"> <table id="TBL-4" class="tabular" +cellspacing="0" cellpadding="0" +><colgroup id="TBL-4-1g"><col +id="TBL-4-1" /><col +id="TBL-4-2" /><col +id="TBL-4-3" /></colgroup><tr + style="vertical-align:baseline;" id="TBL-4-1-"><td style="white-space:nowrap; text-align:left;" id="TBL-4-1-1" +class="td01"><span +class="ecbx-1000">Command or Package Option </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-4-1-2" +class="td11"><a + id="dx1-7082"></a><a +href="#glo:makeindex"><span +class="ectt-1000">makeindex</span><a + id="dx1-7083"></a></a></td><td style="white-space:nowrap; text-align:left;" id="TBL-4-1-3" +class="td10"><a + id="dx1-7084"></a><a +href="#glo:xindy"><span +class="ectt-1000">xindy</span><a + id="dx1-7085"></a></a> </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-4-2-"><td style="white-space:nowrap; text-align:left;" id="TBL-4-2-1" +class="td01"><span +class="ecss-1000">order=letter</span><a + id="dx1-7086"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-4-2-2" +class="td11">use <span +class="ectt-1000">-l </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-4-2-3" +class="td10">use <span +class="ectt-1000">-M ord/letorder </span></td> +</tr><tr + style="vertical-align:baseline;" id="TBL-4-3-"><td style="white-space:nowrap; text-align:left;" id="TBL-4-3-1" +class="td01"><span +class="ecss-1000">order=word</span><a + id="dx1-7087"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-4-3-2" +class="td11">default </td><td style="white-space:nowrap; text-align:left;" id="TBL-4-3-3" +class="td10">default </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-4-4-"><td style="white-space:nowrap; text-align:left;" id="TBL-4-4-1" +class="td01"><span +class="ecss-1000">xindy</span><a + id="dx1-7088"></a>={<span +class="ecss-1000">language=</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">lang</span><span +class="cmsy-10">⟩</span><span +class="ecss-1000">,codename=</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">code</span><span +class="cmsy-10">⟩</span>}</td><td style="white-space:nowrap; text-align:left;" id="TBL-4-4-2" +class="td11">N/A </td><td style="white-space:nowrap; text-align:left;" id="TBL-4-4-3" +class="td10">use <span +class="ectt-1000">-L </span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">lang</span><span +class="cmsy-10">⟩ </span><span +class="ectt-1000">-C </span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">code</span><span +class="cmsy-10">⟩</span></td> +</tr><tr + style="vertical-align:baseline;" id="TBL-4-5-"><td style="white-space:nowrap; text-align:left;" id="TBL-4-5-1" +class="td01"><span +class="ectt-1000">\GlsSetXdyLanguage</span><a + id="dx1-7089"></a><span +class="ectt-1000">{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">lang</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">} </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-4-5-2" +class="td11">N/A </td><td style="white-space:nowrap; text-align:left;" id="TBL-4-5-3" +class="td10">use <span +class="ectt-1000">-L </span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">lang</span><span +class="cmsy-10">⟩ </span></td> +</tr><tr + style="vertical-align:baseline;" id="TBL-4-6-"><td style="white-space:nowrap; text-align:left;" id="TBL-4-6-1" +class="td01"><span +class="ectt-1000">\GlsSetXdyCodePage</span><a + id="dx1-7090"></a><span +class="ectt-1000">{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">code</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">} </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-4-6-2" +class="td11">N/A </td><td style="white-space:nowrap; text-align:left;" id="TBL-4-6-3" +class="td10">use <span +class="ectt-1000">-C </span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">code</span><span +class="cmsy-10">⟩ </span></td></tr></table> +</div> + + + + </div><hr class="endfloat" /> + </div> +<!--l. 1065--><p class="noindent" ><a +href="#top">Top</a></p><h5 class="subsubsectionHead"><span class="titlemark">1.3.1 </span> <a + id="x1-80001.3.1"></a>Using the makeglossaries Perl Script</h5> +<!--l. 1068--><p class="noindent" >The <a + id="dx1-8001"></a><a +href="#glo:makeglossaries"><span +class="ectt-1000">makeglossaries</span><a + id="dx1-8002"></a></a> script picks up the relevant information from the auxiliary (<span +class="ectt-1000">.aux</span><a + id="dx1-8003"></a>) +file and will either call <a + id="dx1-8004"></a><a +href="#glo:xindy"><span +class="ectt-1000">xindy</span><a + id="dx1-8005"></a></a> or <a + id="dx1-8006"></a><a +href="#glo:makeindex"><span +class="ectt-1000">makeindex</span><a + id="dx1-8007"></a></a>, depending on the supplied information. +Therefore, you only need to pass the document’s name without the extension to +<a + id="dx1-8008"></a><span +class="ectt-1000">makeglossaries</span><a + id="dx1-8009"></a>. For example, if your document is called <span +class="ectt-1000">myDoc.tex</span>, type the +following in your terminal: <spacer type=vertical size=10><span class="obeylines-h"> + <br /><span +class="ectt-1000">latex myDoc</span> + <br /><span +class="ectt-1000">makeglossaries myDoc</span> + <br /><span +class="ectt-1000">latex myDoc</span></span> +</p><!--l. 1079--><p class="indent" > <spacer type=vertical size=10> +You may need to explicitly load <a + id="dx1-8010"></a><a +href="#glo:makeglossaries"><span +class="ectt-1000">makeglossaries</span><a + id="dx1-8011"></a></a> into Perl: <spacer type=vertical size=10><span class="obeylines-h"> + <br /><span +class="ectt-1000">perl makeglossaries myDoc</span></span> +</p><!--l. 1083--><p class="indent" > <spacer type=vertical size=10> +There is a batch file called <span +class="ectt-1000">makeglossaries.bat </span>which does this for Windows users, +but you must have Perl installed to be able to use it. +</p><!--l. 1088--><p class="indent" > The <a + id="dx1-8012"></a><a +href="#glo:makeglossaries"><span +class="ectt-1000">makeglossaries</span><a + id="dx1-8013"></a></a> script contains POD (Plain Old Documentation). If you +want, you can create a man page for <a + id="dx1-8014"></a><span +class="ectt-1000">makeglossaries</span><a + id="dx1-8015"></a> using <span +class="ectt-1000">pod2man</span><a + id="dx1-8016"></a> and +move the resulting file onto the man path. Alternatively do <span +class="ectt-1000">makeglossaries</span> +<span +class="ectt-1000">--help </span>for a list of all options or <span +class="ectt-1000">makeglossaries --version </span>for the version +number. +</p><!--l. 1095--><p class="indent" > <div class="important" title="Important Note"> When upgrading the <span +class="ecss-1000">glossaries </span>package, make sure you also upgrade your version of +<a + id="dx1-8017"></a><a +href="#glo:makeglossaries"><span +class="ectt-1000">makeglossaries</span><a + id="dx1-8018"></a></a>. The current version is 2.02. </div> +</p><!--l. 1099--><p class="noindent" > +</p><!--l. 1101--><p class="noindent" > +</p> +<!--l. 1101--><p class="noindent" ><a +href="#top">Top</a></p><h5 class="subsubsectionHead"><span class="titlemark">1.3.2 </span> <a + id="x1-90001.3.2"></a>Using xindy explicitly</h5> +<!--l. 1104--><p class="noindent" >If you want to use <a + id="dx1-9001"></a><a +href="#glo:xindy"><span +class="ectt-1000">xindy</span><a + id="dx1-9002"></a></a> to process the glossary files, you must make sure you have +used the <span +class="ecss-1000">xindy</span><a + id="dx1-9003"></a> package option: + + + +</p> + <div class="verbatim" id="verbatim-14"> +\usepackage[xindy]{glossaries} +</div> +<!--l. 1109--><p class="nopar" > This is required regardless of whether you use <a + id="dx1-9004"></a><a +href="#glo:xindy"><span +class="ectt-1000">xindy</span><a + id="dx1-9005"></a></a> explicitly or whether it’s called +implicitly via <a + id="dx1-9006"></a><a +href="#glo:makeglossaries"><span +class="ectt-1000">makeglossaries</span><a + id="dx1-9007"></a></a>. This causes the glossary entries to be written in raw +<a + id="dx1-9008"></a><span +class="ectt-1000">xindy</span><a + id="dx1-9009"></a> format, so you need to use <span +class="ectt-1000">-I xindy </span><span +class="ecti-1000">not </span><span +class="ectt-1000">-I tex</span>. +</p><!--l. 1116--><p class="indent" > To run <a + id="dx1-9010"></a><a +href="#glo:xindy"><span +class="ectt-1000">xindy</span><a + id="dx1-9011"></a></a> type the following in your terminal (all on one line): <spacer type=vertical size=10><span class="obeylines-h"> + <br /><span +class="ectt-1000">xindy -L </span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">language</span><span +class="cmsy-10">⟩ </span><span +class="ectt-1000">-C </span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">encoding</span><span +class="cmsy-10">⟩ </span><span +class="ectt-1000">-I xindy -M </span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">style</span><span +class="cmsy-10">⟩ </span><span +class="ectt-1000">-t </span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">base</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">.glg -o</span> +<span +class="cmsy-10">⟨</span><span +class="ecti-1000">base</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">.gls </span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">base</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">.glo</span></span> +</p><!--l. 1120--><p class="indent" > <spacer type=vertical size=10> +where <span +class="cmsy-10">⟨</span><span +class="ecti-1000">language</span><span +class="cmsy-10">⟩ </span>is the required language name, <span +class="cmsy-10">⟨</span><span +class="ecti-1000">encoding</span><span +class="cmsy-10">⟩ </span>is the encoding, <span +class="cmsy-10">⟨</span><span +class="ecti-1000">base</span><span +class="cmsy-10">⟩ </span>is +the name of the document without the <span +class="ectt-1000">.tex</span><a + id="dx1-9012"></a> extension and <span +class="cmsy-10">⟨</span><span +class="ecti-1000">style</span><span +class="cmsy-10">⟩ </span>is the name of +the <a + id="dx1-9013"></a><a +href="#glo:xindy"><span +class="ectt-1000">xindy</span><a + id="dx1-9014"></a></a> style file without the <span +class="ectt-1000">.xdy</span><a + id="dx1-9015"></a> extension. The default name for this +style file is <span +class="cmsy-10">⟨</span><span +class="ecti-1000">base</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">.xdy</span><a + id="dx1-9016"></a> but can be changed via <span +class="ectt-1000">\setStyleFile</span><a + id="dx1-9017"></a><span +class="ectt-1000">{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">style</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}</span>. You +may need to specify the full path name depending on the current working +directory. If any of the file names contain spaces, you must delimit them using +double-quotes. +</p><!--l. 1131--><p class="indent" > For example, if your document is called <span +class="ectt-1000">myDoc.tex </span>and you are using UTF8 +encoding in English, then type the following in your terminal: <spacer type=vertical size=10><span class="obeylines-h"> + <br /><span +class="ectt-1000">xindy -L english -C utf8 -I xindy -M myDoc -t myDoc.glg -o myDoc.gls</span> +<span +class="ectt-1000">myDoc.glo</span></span> +</p><!--l. 1136--><p class="indent" > <spacer type=vertical size=10> +</p><!--l. 1138--><p class="indent" > Note that this just creates the main glossary. You need to do the same for each of +the other glossaries (including the list of acronyms if you have used the <span +class="ecss-1000">acronym</span><a + id="dx1-9018"></a> +package option), substituting <span +class="ectt-1000">.glg</span><a + id="dx1-9019"></a>, <span +class="ectt-1000">.gls</span><a + id="dx1-9020"></a> and <span +class="ectt-1000">.glo</span><a + id="dx1-9021"></a> with the relevant extensions. For +example, if you have used the <span +class="ecss-1000">acronym</span><a + id="dx1-9022"></a> package option, then you would need to do: +<spacer type=vertical size=10><span class="obeylines-h"> + <br /><span +class="ectt-1000">xindy -L english -C utf8 -I xindy -M myDoc -t myDoc.alg -o myDoc.acr</span> +<span +class="ectt-1000">myDoc.acn</span></span> +</p><!--l. 1147--><p class="indent" > <spacer type=vertical size=10> +For additional glossaries, the extensions are those supplied when you created the +glossary with <span +class="ectt-1000">\newglossary</span><a + id="dx1-9023"></a>. +</p><!--l. 1151--><p class="indent" > Note that if you use <a + id="dx1-9024"></a><a +href="#glo:makeglossaries"><span +class="ectt-1000">makeglossaries</span><a + id="dx1-9025"></a></a> instead, you can replace all those calls to +<a + id="dx1-9026"></a><a +href="#glo:xindy"><span +class="ectt-1000">xindy</span><a + id="dx1-9027"></a></a> with just one call to <a + id="dx1-9028"></a><span +class="ectt-1000">makeglossaries</span><a + id="dx1-9029"></a>: <spacer type=vertical size=10><span class="obeylines-h"> + <br /><span +class="ectt-1000">makeglossaries myDoc</span></span> +</p><!--l. 1156--><p class="indent" > <spacer type=vertical size=10> +Note also that some commands and package options have no effect if you use <a + id="dx1-9030"></a><a +href="#glo:xindy"><span +class="ectt-1000">xindy</span><a + id="dx1-9031"></a></a> +explicitly instead of using <a + id="dx1-9032"></a><span +class="ectt-1000">makeglossaries</span><a + id="dx1-9033"></a>. These are listed in <a +href="#x1-70813">table 3</a>. +</p><!--l. 1163--><p class="noindent" > + + + +</p> +<!--l. 1163--><p class="noindent" ><a +href="#top">Top</a></p><h5 class="subsubsectionHead"><span class="titlemark">1.3.3 </span> <a + id="x1-100001.3.3"></a>Using makeindex explicitly</h5> +<!--l. 1166--><p class="noindent" >If you want to use <a + id="dx1-10001"></a><a +href="#glo:makeindex"><span +class="ectt-1000">makeindex</span><a + id="dx1-10002"></a></a> explicitly, you must make sure that you haven’t used the +<span +class="ecss-1000">xindy</span><a + id="dx1-10003"></a> package option or the glossary entries will be written in the wrong format. To run +<a + id="dx1-10004"></a><span +class="ectt-1000">makeindex</span><a + id="dx1-10005"></a>, type the following in your terminal: <spacer type=vertical size=10><span class="obeylines-h"> + <br /><span +class="ectt-1000">makeindex -s </span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">style</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">.ist -t </span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">base</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">.glg -o </span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">base</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">.gls </span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">base</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">.glo</span></span> +</p><!--l. 1173--><p class="indent" > <spacer type=vertical size=10> +where <span +class="cmsy-10">⟨</span><span +class="ecti-1000">base</span><span +class="cmsy-10">⟩ </span>is the name of your document without the <span +class="ectt-1000">.tex</span><a + id="dx1-10006"></a> extension and +<span +class="cmsy-10">⟨</span><span +class="ecti-1000">style</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">.ist</span><a + id="dx1-10007"></a> is the name of the <a + id="dx1-10008"></a><a +href="#glo:makeindex"><span +class="ectt-1000">makeindex</span><a + id="dx1-10009"></a></a> style file. By default, this is <span +class="cmsy-10">⟨</span><span +class="ecti-1000">base</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">.ist</span><a + id="dx1-10010"></a>, +but may be changed via <span +class="ectt-1000">\setStyleFile</span><a + id="dx1-10011"></a><span +class="ectt-1000">{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">style</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}</span>. Note that there are other +options, such as <span +class="ectt-1000">-l </span>(letter ordering). See the <a + id="dx1-10012"></a><span +class="ectt-1000">makeindex</span><a + id="dx1-10013"></a> manual for further +details. +</p><!--l. 1182--><p class="indent" > For example, if your document is called <span +class="ectt-1000">myDoc.tex</span>, then type the following at the +terminal: <spacer type=vertical size=10><span class="obeylines-h"> + <br /><span +class="ectt-1000">makeindex -s myDoc.ist -t myDoc.glg -o myDoc.gls myDoc.glo</span></span> +</p><!--l. 1186--><p class="indent" > <spacer type=vertical size=10> +Note that this only creates the main glossary. If you have additional glossaries (for +example, if you have used the <span +class="ecss-1000">acronym</span><a + id="dx1-10014"></a> package option) then you must call <a + id="dx1-10015"></a><a +href="#glo:makeindex"><span +class="ectt-1000">makeindex</span><a + id="dx1-10016"></a></a> +for each glossary, substituting <span +class="ectt-1000">.glg</span><a + id="dx1-10017"></a>, <span +class="ectt-1000">.gls</span><a + id="dx1-10018"></a> and <span +class="ectt-1000">.glo</span><a + id="dx1-10019"></a> with the relevant extensions. For +example, if you have used the <span +class="ecss-1000">acronym</span><a + id="dx1-10020"></a> package option, then you need to type the +following in your terminal: <spacer type=vertical size=10><span class="obeylines-h"> + <br /><span +class="ectt-1000">makeindex -s myDoc.ist -t myDoc.alg -o myDoc.acr myDoc.acn</span></span> +</p><!--l. 1197--><p class="indent" > <spacer type=vertical size=10> +For additional glossaries, the extensions are those supplied when you created the +glossary with <span +class="ectt-1000">\newglossary</span><a + id="dx1-10021"></a>. +</p><!--l. 1201--><p class="indent" > Note that if you use <a + id="dx1-10022"></a><a +href="#glo:makeglossaries"><span +class="ectt-1000">makeglossaries</span><a + id="dx1-10023"></a></a> instead, you can replace all those calls to +<a + id="dx1-10024"></a><a +href="#glo:makeindex"><span +class="ectt-1000">makeindex</span><a + id="dx1-10025"></a></a> with just one call to <a + id="dx1-10026"></a><span +class="ectt-1000">makeglossaries</span><a + id="dx1-10027"></a>: <spacer type=vertical size=10><span class="obeylines-h"> + <br /><span +class="ectt-1000">makeglossaries myDoc</span></span> +</p><!--l. 1206--><p class="indent" > <spacer type=vertical size=10> +Note also that some commands and package options have no effect if you use +<a + id="dx1-10028"></a><span +class="ectt-1000">makeindex</span><a + id="dx1-10029"></a> explicitly instead of using <a + id="dx1-10030"></a><a +href="#glo:makeglossaries"><span +class="ectt-1000">makeglossaries</span><a + id="dx1-10031"></a></a>. These are listed in +<a +href="#x1-70813">table 3</a>. +</p><!--l. 1213--><p class="noindent" > +</p> +<!--l. 1213--><p class="noindent" ><a +href="#top">Top</a></p><h5 class="subsubsectionHead"><span class="titlemark">1.3.4 </span> <a + id="x1-110001.3.4"></a>Note to Front-End and Script Developers</h5> +<!--l. 1215--><p class="noindent" >The information needed to determine whether to use <a + id="dx1-11001"></a><a +href="#glo:xindy"><span +class="ectt-1000">xindy</span><a + id="dx1-11002"></a></a> or <a + id="dx1-11003"></a><a +href="#glo:makeindex"><span +class="ectt-1000">makeindex</span><a + id="dx1-11004"></a></a> and the +information needed to call those applications is stored in the auxiliary file. This +information can be gathered by a front-end, editor or script to make the glossaries +where appropriate. This section describes how the information is stored in the auxiliary +file. +</p><!--l. 1222--><p class="indent" > The file extensions used by each defined glossary are given by +</p><!--l. 1223--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\@newglossary</span><span +class="ectt-0900"> </span></span><a + id="dx1-11005"></a> <span +class="ectt-1000">\@newglossary{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">log</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">out-ext</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">in-ext</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">} </span></div><hr> +</p><!--l. 1225--><p class="noindent" > + + + +where <span +class="cmsy-10">⟨</span><span +class="ecti-1000">in-ext</span><span +class="cmsy-10">⟩ </span>is the extension of the <span +class="ecti-1000">indexing application’s </span>input file (the output file +from the <span +class="ecss-1000">glossaries </span>package’s point of view), <span +class="cmsy-10">⟨</span><span +class="ecti-1000">out-ext</span><span +class="cmsy-10">⟩ </span>is the extension of the <span +class="ecti-1000">indexing</span> +<span +class="ecti-1000">application’s </span>output file (the input file from the <span +class="ecss-1000">glossaries </span>package’s point of view) and +<span +class="cmsy-10">⟨</span><span +class="ecti-1000">log</span><span +class="cmsy-10">⟩ </span>is the extension of the indexing application’s transcript file. The label for the +glossary is also given for information purposes only, but is not required by the indexing +applications. For example, the information for the main glossary is written +as: + + + +</p> + <div class="verbatim" id="verbatim-15"> +\@newglossary{main}{glg}{gls}{glo} +</div> +<!--l. 1237--><p class="nopar" > +</p><!--l. 1239--><p class="indent" > The indexing application’s style file is specified by +</p><!--l. 1240--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\@istfilename</span><span +class="ectt-0900"> </span></span><a + id="dx1-11006"></a> <span +class="ectt-1000">\@istfilename{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">filename</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">} </span></div><hr> +</p><!--l. 1242--><p class="noindent" > +The file extension indicates whether to use <a + id="dx1-11007"></a><a +href="#glo:makeindex"><span +class="ectt-1000">makeindex</span><a + id="dx1-11008"></a></a> (<span +class="ectt-1000">.ist</span><a + id="dx1-11009"></a>) or <a + id="dx1-11010"></a><a +href="#glo:xindy"><span +class="ectt-1000">xindy</span><a + id="dx1-11011"></a></a> (<span +class="ectt-1000">.xdy</span><a + id="dx1-11012"></a>). Note +that the glossary information is formatted differently depending on which +indexing application is supposed to be used, so it’s important to call the correct +one. +</p><!--l. 1249--><p class="indent" > Word or letter ordering is specified by: +</p><!--l. 1250--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\@glsorder</span><span +class="ectt-0900"> </span></span><a + id="dx1-11013"></a> <span +class="ectt-1000">\@glsorder{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">order</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">} </span></div><hr> +</p><!--l. 1252--><p class="noindent" > +where <span +class="cmsy-10">⟨</span><span +class="ecti-1000">order</span><span +class="cmsy-10">⟩ </span>can be either <span +class="ectt-1000">word </span>or <span +class="ectt-1000">letter</span>. +</p><!--l. 1255--><p class="indent" > If <a + id="dx1-11014"></a><a +href="#glo:xindy"><span +class="ectt-1000">xindy</span><a + id="dx1-11015"></a></a> should be used, the language and code page for each glossary is specified +by +</p><!--l. 1257--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\@xdylanguage</span><span +class="ectt-0900"> </span></span><a + id="dx1-11016"></a><span class="marginpar"><span +class="ectt-0900">\@gls@codepage</span><span +class="ectt-0900"> </span></span><a + id="dx1-11017"></a> <span +class="ectt-1000">\@xdylanguage{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">language</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}</span><br +class="newline" /><span +class="ectt-1000">\@gls@codepage{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">code</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">} </span></div><hr> +</p><!--l. 1260--><p class="noindent" > +where <span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩ </span>identifies the glossary, <span +class="cmsy-10">⟨</span><span +class="ecti-1000">language</span><span +class="cmsy-10">⟩ </span>is the root language (e.g. <span +class="ectt-1000">english</span>) and +<span +class="cmsy-10">⟨</span><span +class="ecti-1000">code</span><span +class="cmsy-10">⟩ </span>is the encoding (e.g. <span +class="ectt-1000">utf8</span>). These commands are omitted if <a + id="dx1-11018"></a><a +href="#glo:makeindex"><span +class="ectt-1000">makeindex</span><a + id="dx1-11019"></a></a> should +be used. +</p><!--l. 1267--><p class="noindent" > +</p> +<!--l. 1267--><p class="noindent" ><a +href="#top">Top</a></p><h3 class="sectionHead"><span class="titlemark">2 </span> <a + id="x1-120002"></a>Package Options</h3> +<!--l. 1270--><p class="noindent" >This section describes the available <span +class="ecss-1000">glossaries </span>package options. +</p><!--l. 1272--><p class="noindent" > +</p> +<!--l. 1272--><p class="noindent" ><a +href="#top">Top</a></p><h4 class="subsectionHead"><span class="titlemark">2.1 </span> <a + id="x1-130002.1"></a>General Options</h4> +<!--l. 1275--><p class="noindent" > + </p><dl class="description"><dt class="description"> +<span +class="ecsx-1000">nowarn</span><a + id="dx1-13001"></a> </dt><dd +class="description">This suppresses all warnings generated by the <span +class="ecss-1000">glossaries </span>package. + </dd><dt class="description"> +<span +class="ecsx-1000">nomain</span><a + id="dx1-13002"></a> </dt><dd +class="description">This suppresses the creation of the main glossary. Note that if you use + this option, you must create another glossary in which to put all your entries + + + + (either via the <span +class="ecss-1000">acronym</span><a + id="dx1-13003"></a> package option described in <a +href="#x1-170002.5">§2.5 </a><a +href="#x1-170002.5">Acronym Options<!--tex4ht:ref: sec:pkgopts-acronym --></a> + or via <span +class="ectt-1000">\newglossary</span><a + id="dx1-13004"></a> described in <a +href="#x1-3800012">§12 </a><a +href="#x1-3800012">Defining New Glossaries<!--tex4ht:ref: sec:newglossary --></a>). + </dd><dt class="description"> +<span +class="ecsx-1000">sanitize</span><a + id="dx1-13005"></a> </dt><dd +class="description">This is a <span +class="cmsy-10">⟨</span><span +class="ecti-1000">key</span><span +class="cmsy-10">⟩</span>=<span +class="cmsy-10">⟨</span><span +class="ecti-1000">value</span><span +class="cmsy-10">⟩ </span>option whose value is also a <span +class="cmsy-10">⟨</span><span +class="ecti-1000">key</span><span +class="cmsy-10">⟩</span>=<span +class="cmsy-10">⟨</span><span +class="ecti-1000">value</span><span +class="cmsy-10">⟩ </span>list. By + default, the <span +class="ecss-1000">glossaries </span>package <a + id="dx1-13006"></a><a +href="#glo:sanitize">sanitize<a + id="dx1-13007"></a>s</a> the values of the <span +class="ecss-1000">name</span><a + id="dx1-13008"></a>, <span +class="ecss-1000">description</span><a + id="dx1-13009"></a> and + <span +class="ecss-1000">symbol</span><a + id="dx1-13010"></a> keys used when defining a new glossary entry. This means that you can use + fragile commands in those keys, but it may lead to unexpected results if you try + to display these values within the document text. This sanitization can be + switched off using the <span +class="ecss-1000">sanitize</span><a + id="dx1-13011"></a> package option. For example, to switch off the + sanitization for the <span +class="ecss-1000">description</span><a + id="dx1-13012"></a> and <span +class="ecss-1000">name</span><a + id="dx1-13013"></a> keys, but not for the <span +class="ecss-1000">symbol</span><a + id="dx1-13014"></a> key, + do: + + + + <div class="verbatim" id="verbatim-16"> + \usepackage[sanitize={name=false,description=false,% +  <br />symbol=true}]{glossaries} +</div> + <!--l. 1301--><p class="nopar" > You can use <span +class="ecss-1000">sanitize=none</span><a + id="dx1-13015"></a> as a shortcut for<br +class="newline" /><span +class="ecss-1000">sanitize={name=false,description=false,symbol=false}</span>. + </p><!--l. 1305--><p class="noindent" ><div class="important" title="Important Note"><span +class="ecbx-1000">Note</span>: this sanitization only applies to the <span +class="ecss-1000">name</span><a + id="dx1-13016"></a>, <span +class="ecss-1000">description</span><a + id="dx1-13017"></a> and <span +class="ecss-1000">symbol</span><a + id="dx1-13018"></a> keys. It + doesn’t apply to any of the other keys (except the <span +class="ecss-1000">sort</span><a + id="dx1-13019"></a> key which is always + <a + id="dx1-13020"></a><a +href="#glo:sanitize">sanitized<a + id="dx1-13021"></a></a> if <span +class="ecss-1000">sort=standard</span><a + id="dx1-13022"></a> is in effect) so fragile commands contained in the value + of the other keys must always be protected using <span +class="ectt-1000">\protect</span>. Since the + value of the <span +class="ecss-1000">text</span><a + id="dx1-13023"></a> key is obtained from the <span +class="ecss-1000">name</span><a + id="dx1-13024"></a> key, you will still need to + protect fragile commands in the <span +class="ecss-1000">name</span><a + id="dx1-13025"></a> key if you don’t use the <span +class="ecss-1000">text</span><a + id="dx1-13026"></a> key. + </div> + </p><!--l. 1314--><p class="noindent" > + </p></dd><dt class="description"> +<span +class="ecsx-1000">savewrites</span><a + id="dx1-13027"></a> </dt><dd +class="description">This is a boolean option to minimises the number of write registers used by + the <span +class="ecss-1000">glossaries </span>package. (Default is <span +class="ecss-1000">savewrites=false</span><a + id="dx1-13028"></a>.) There are only a limited + number of write registers, and if you have a large number of glossaries or if you + are using a class or other packages that create a lot of external files, you may + exceed the maximum number of available registers. If <span +class="ecss-1000">savewrites</span><a + id="dx1-13029"></a> is set, the + glossary information will be stored in token registers until the end of the + document when they will be written to the external files. If you run out of token + registers, you can use <span +class="ecss-1000">etex</span><a + id="dx1-13030"></a>. + <!--l. 1327--><p class="noindent" ><div class="important" title="Important Note"> If you want to use <span class="TEX">T<span +class="E">E</span>X</span>’s <span +class="ectt-1000">\write18</span><a + id="dx1-13031"></a> mechanism to call <a + id="dx1-13032"></a><a +href="#glo:makeindex"><span +class="ectt-1000">makeindex</span><a + id="dx1-13033"></a></a> or <a + id="dx1-13034"></a><a +href="#glo:xindy"><span +class="ectt-1000">xindy</span><a + id="dx1-13035"></a></a> from + your document and use <span +class="ecss-1000">savewrites</span><a + id="dx1-13036"></a>, you must create the external files with + <span +class="ectt-1000">\glswritefiles </span>before you call <a + id="dx1-13037"></a><span +class="ectt-1000">makeindex</span><a + id="dx1-13038"></a>/<a + id="dx1-13039"></a><span +class="ectt-1000">xindy</span><a + id="dx1-13040"></a>. Also set <span +class="ectt-1000">\glswritefiles </span>to + nothing or <span +class="ectt-1000">\relax </span>before the end of the document to avoid rewriting the files. For + example: + + + +</p> + <div class="verbatim" id="verbatim-17"> + \glswritefiles +  <br />\write18{makeindex -s \istfilename\space -t \jobname.glg +  <br />-o \jobname.gls \jobname} +  <br />\let\glswritefiles\relax +</div> + <!--l. 1339--><p class="nopar" > </div> + </p><!--l. 1340--><p class="noindent" > + </p></dd><dt class="description"> +<span +class="ecsx-1000">translate</span><a + id="dx1-13041"></a> </dt><dd +class="description">This is a boolean option. The default is <span +class="ecss-1000">true</span><a + id="dx1-13042"></a> if <span +class="ecss-1000">babel</span><a + id="dx1-13043"></a>, <span +class="ecss-1000">polyglossia</span><a + id="dx1-13044"></a> or <span +class="ecss-1000">translator</span><a + id="dx1-13045"></a> + have been loaded, otherwise the default value is <span +class="ecss-1000">false</span><a + id="dx1-13046"></a>. + <!--l. 1347--><p class="noindent" > + </p><dl class="description"><dt class="description"> + <span +class="ecsx-1000">translate=true</span><a + id="dx1-13047"></a> </dt><dd +class="description">If <span +class="ecss-1000">babel</span><a + id="dx1-13048"></a> has been loaded and the <span +class="ecss-1000">translator</span><a + id="dx1-13049"></a> package is + installed, <span +class="ecss-1000">translator</span><a + id="dx1-13050"></a> will be loaded and the translations will be provided + by the <span +class="ecss-1000">translator</span><a + id="dx1-13051"></a> package interface. You can modify the translations by + providing your own dictionary. If the <span +class="ecss-1000">translator</span><a + id="dx1-13052"></a> package isn’t installed + and <span +class="ecss-1000">babel</span><a + id="dx1-13053"></a> is loaded, the <span +class="ecss-1000">glossaries-babel</span><a + id="dx1-13054"></a> package will be loaded and the + translations will be provided using <span +class="ecss-1000">babel</span>’s <span +class="ectt-1000">\addto\caption</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">language</span><span +class="cmsy-10">⟩</span> + mechanism. If <span +class="ecss-1000">polyglossia</span><a + id="dx1-13055"></a> has been loaded, <span +class="ecss-1000">glossaries-polyglossia</span><a + id="dx1-13056"></a> will be + loaded. + </dd><dt class="description"> + <span +class="ecsx-1000">translate=false</span><a + id="dx1-13057"></a> </dt><dd +class="description">Don’t provide translations, even if <span +class="ecss-1000">babel</span><a + id="dx1-13058"></a> or <span +class="ecss-1000">polyglossia</span><a + id="dx1-13059"></a> has + been loaded. You can then provide you’re own translations or explicitly + load <span +class="ecss-1000">glossaries-babel</span><a + id="dx1-13060"></a> or <span +class="ecss-1000">glossaries-polyglossia</span><a + id="dx1-13061"></a>.</dd></dl> + <!--l. 1366--><p class="noindent" >See <a +href="#x1-60001.2.1">§1.2.1 </a><a +href="#x1-60001.2.1">Changing the Fixed Names<!--tex4ht:ref: sec:fixednames --></a> for further details. + </p></dd><dt class="description"> +<span +class="ecsx-1000">hyperfirst</span><a + id="dx1-13062"></a> </dt><dd +class="description">This is a boolean option that specifies whether each term has a hyperlink on + <a + id="dx1-13063"></a><a +href="#glo:firstuse">first use</a>. The default is <span +class="ecss-1000">hyperfirst=true</span><a + id="dx1-13064"></a> (terms on <a + id="dx1-13065"></a><a +href="#glo:firstuse">first use</a> have a hyperlink, + unless explicitly suppressed using starred versions of commands such as + <span +class="ectt-1000">\gls*</span><a + id="dx1-13066"></a>). + </dd></dl> + + + +<!--l. 1376--><p class="noindent" > +</p> +<!--l. 1376--><p class="noindent" ><a +href="#top">Top</a></p><h4 class="subsectionHead"><span class="titlemark">2.2 </span> <a + id="x1-140002.2"></a>Sectioning and TOC Options</h4> +<!--l. 1379--><p class="noindent" > + </p><dl class="description"><dt class="description"> +<span +class="ecsx-1000">toc</span><a + id="dx1-14001"></a> </dt><dd +class="description">Add the glossaries to the table of contents. Note that an extra <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span +class="E">E</span>X</span></span> run is + required with this option. Alternatively, you can switch this function on and off + using + <!--l. 1383--><p class="noindent" ><hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\glstoctrue</span><span +class="ectt-0900"> </span></span><a + id="dx1-14002"></a> <span +class="ectt-1000">\glstoctrue </span></div><hr> + </p><!--l. 1385--><p class="noindent" > + and + </p><!--l. 1387--><p class="noindent" ><hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\glstocfalse</span><span +class="ectt-0900"> </span></span><a + id="dx1-14003"></a> <span +class="ectt-1000">\glstocfalse </span></div><hr> + </p><!--l. 1389--><p class="noindent" > + </p></dd><dt class="description"> +<span +class="ecsx-1000">numberline</span><a + id="dx1-14004"></a> </dt><dd +class="description">When used with <span +class="ecss-1000">toc</span><a + id="dx1-14005"></a>, this will add <span +class="ectt-1000">\numberline</span><a + id="dx1-14006"></a><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">{}</span></span></span> in the final + argument of <span +class="ectt-1000">\addcontentsline</span><a + id="dx1-14007"></a>. This will align the table of contents + entry with the numbered section titles. Note that this option has no + effect if the <span +class="ecss-1000">toc</span><a + id="dx1-14008"></a> option is omitted. If <span +class="ecss-1000">toc</span><a + id="dx1-14009"></a> is used without <span +class="ecss-1000">numberline</span><a + id="dx1-14010"></a>, the + title will be aligned with the section numbers rather than the section + titles. + </dd><dt class="description"> +<span +class="ecsx-1000">section</span><a + id="dx1-14011"></a> </dt><dd +class="description">This is a <span +class="cmsy-10">⟨</span><span +class="ecti-1000">key</span><span +class="cmsy-10">⟩</span>=<span +class="cmsy-10">⟨</span><span +class="ecti-1000">value</span><span +class="cmsy-10">⟩ </span>option. Its value should be the name of a sectional unit + (e.g. chapter). This will make the glossaries appear in the named sectional + unit, otherwise each glossary will appear in a chapter, if chapters exist, + otherwise in a section. Unnumbered sectional units will be used by default. + Example: + + + + <div class="verbatim" id="verbatim-18"> + \usepackage[section=subsection]{glossaries} +</div> + <!--l. 1407--><p class="nopar" > You can omit the value if you want to use sections, i.e.  + + + +</p> + <div class="verbatim" id="verbatim-19"> + \usepackage[section]{glossaries} +</div> + <!--l. 1411--><p class="nopar" > is equivalent to + + + +</p> + <div class="verbatim" id="verbatim-20"> + \usepackage[section=section]{glossaries} +</div> + <!--l. 1415--><p class="nopar" > You can change this value later in the document using + </p><!--l. 1417--><p class="noindent" ><hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\setglossarysection</span><span +class="ectt-0900"> </span></span><a + id="dx1-14012"></a> <span +class="ectt-1000">\setglossarysection{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">name</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">} </span></div><hr> + </p><!--l. 1419--><p class="noindent" > + where <span +class="cmsy-10">⟨</span><span +class="ecti-1000">name</span><span +class="cmsy-10">⟩ </span>is the sectional unit. + </p><!--l. 1422--><p class="noindent" >The start of each glossary adds information to the page header via + </p><!--l. 1423--><p class="noindent" ><hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\glossarymark</span><span +class="ectt-0900"> </span></span><a + id="dx1-14013"></a> <span +class="ectt-1000">\glossarymark{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">glossary title</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">} </span></div><hr> + </p><!--l. 1425--><p class="noindent" > + This defaults to <span +class="ectt-1000">\@mkboth </span>unless <span +class="ecss-1000">memoir</span><a + id="dx1-14014"></a> is loaded, but you may need to redefine + it. For example, to only change the right header: + + + +</p> + <div class="verbatim" id="verbatim-21"> + \renewcommand{\glossarymark}[1]{\markright{#1}} +</div> + <!--l. 1431--><p class="nopar" > or to prevent it from changing the headers: + + + +</p> + <div class="verbatim" id="verbatim-22"> + \renewcommand{\glossarymark}[1]{} +</div> + <!--l. 1435--><p class="nopar" > + </p><!--l. 1437--><p class="noindent" >Occasionally you may find that another package defines <span +class="ectt-1000">\cleardoublepage </span>when + it is not required. This may cause an unwanted blank page to appear before each + glossary. This can be fixed by redefining <span +class="ectt-1000">\glsclearpage</span><a + id="dx1-14015"></a>: + + + +</p> + <div class="verbatim" id="verbatim-23"> + \renewcommand*{\glsclearpage}{\clearpage} +</div> + <!--l. 1443--><p class="nopar" > + </p></dd><dt class="description"> +<span +class="ecsx-1000">numberedsection</span><a + id="dx1-14016"></a> </dt><dd +class="description">The glossaries are placed in unnumbered sectional units by + default, but this can be changed using <span +class="ecss-1000">numberedsection</span><a + id="dx1-14017"></a>. This option + can take three possible values: <span +class="ecss-1000">false</span><a + id="dx1-14018"></a> (no number, i.e. use starred form), + <span +class="ecss-1000">nolabel</span><a + id="dx1-14019"></a> (numbered, i.e. unstarred form, but not labelled) and <span +class="ecss-1000">autolabel</span><a + id="dx1-14020"></a> + (numbered with automatic labelling). If <span +class="ecss-1000">numberedsection=autolabel</span><a + id="dx1-14021"></a> is used, + each glossary is given a label that matches the glossary type, so the + main (default) glossary is labelled <span +class="ectt-1000">main</span>, the list of acronyms is labelled + <span +class="ectt-1000">acronym</span><span class="footnote-mark"><a +href="#fn3x0" id="fn3x0-bk"><sup class="textsuperscript">3</sup></a></span><a + id="x1-14022f3"></a> + and additional glossaries are labelled using the value specified in the first + mandatory argument to <span +class="ectt-1000">\newglossary</span>. For example, if you load <span +class="ecss-1000">glossaries</span> + using: + + + + <div class="verbatim" id="verbatim-24"> + \usepackage[section,numberedsection=autolabel]{glossaries} +</div> + <!--l. 1463--><p class="nopar" > then each glossary will appear in a numbered section, and can be referenced using + something like: + + + +</p> + <div class="verbatim" id="verbatim-25"> + The main glossary is in section~\ref{main} and the list of +  <br />acronyms is in section~\ref{acronym}. +</div> + <!--l. 1469--><p class="nopar" > If you can’t decide whether to have the acronyms in the main glossary or a + separate list of acronyms, you can use <span +class="ectt-1000">\acronymtype</span><a + id="dx1-14024"></a> which is set to <span +class="ectt-1000">main </span>if the + <span +class="ecss-1000">acronym</span><a + id="dx1-14025"></a> option is not used and is set to <span +class="ectt-1000">acronym </span>if the <span +class="ecss-1000">acronym</span><a + id="dx1-14026"></a> option is used. + For example: + + + +</p> + <div class="verbatim" id="verbatim-26"> + The list of acronyms is in section~\ref{\acronymtype}. +</div> + <!--l. 1477--><p class="nopar" > + </p><!--l. 1479--><p class="noindent" >As from version 1.14, you can add a prefix to the label by redefining + </p><!--l. 1481--><p class="noindent" ><hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\glsautoprefix</span><span +class="ectt-0900"> </span></span><a + id="dx1-14027"></a> <span +class="ectt-1000">\glsautoprefix </span></div><hr> + </p><!--l. 1483--><p class="noindent" > + For example: + + + +</p> + <div class="verbatim" id="verbatim-27"> + \renewcommand*{\glsautoprefix}{glo:} +</div> + <!--l. 1487--><p class="nopar" > will add <span +class="ectt-1000">glo: </span>to the automatically generated label, so you can then, for example, + refer to the list of acronyms as follows: + + + +</p> + <div class="verbatim" id="verbatim-28"> + The list of acronyms is in section~\ref{glo:\acronymtype}. +</div> + <!--l. 1492--><p class="nopar" > Or, if you are undecided on a prefix: + + + +</p> + <div class="verbatim" id="verbatim-29"> + The list of acronyms is in section~\ref{\glsautoprefix\acronymtype}. +</div> + <!--l. 1496--><p class="nopar" > +</p> + </dd></dl> +<!--l. 1500--><p class="noindent" > +</p> +<!--l. 1500--><p class="noindent" ><a +href="#top">Top</a></p><h4 class="subsectionHead"><span class="titlemark">2.3 </span> <a + id="x1-150002.3"></a>Glossary Appearance Options</h4> +<!--l. 1503--><p class="noindent" > + </p><dl class="description"><dt class="description"> +<span +class="ecsx-1000">entrycounter</span><a + id="dx1-15001"></a> </dt><dd +class="description">This is a boolean option. (Default is <span +class="ecss-1000">entrycounter=false</span><a + id="dx1-15002"></a>.) If set, each + main (level 0) glossary entry will be numbered when using the standard + glossary styles. This option creates the counter <span class="marginpar"><span +class="ectt-0900">glossaryentry</span><span +class="ectt-0900"> </span></span><a + id="dx1-15003"></a><a + id="dx1-15004"></a><span +class="ecss-1000">glossaryentry</span>. + <!--l. 1510--><p class="noindent" >If you use this option, you can reference the entry number within the document + using + </p><!--l. 1512--><p class="noindent" ><hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\glsrefentry</span><span +class="ectt-0900"> </span></span><a + id="dx1-15005"></a> <span +class="ectt-1000">\glsrefentry{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">} </span></div><hr> + </p><!--l. 1514--><p class="noindent" > + where <span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩ </span>is the label associated with that glossary entry. + </p><!--l. 1517--><p class="noindent" ><div class="important" title="Important Note"> If you use <span +class="ectt-1000">\glsrefentry</span>, you must run <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span +class="E">E</span>X</span></span> twice after creating the glossary + files using <a + id="dx1-15006"></a><a +href="#glo:makeglossaries"><span +class="ectt-1000">makeglossaries</span><a + id="dx1-15007"></a></a>, <a + id="dx1-15008"></a><a +href="#glo:makeindex"><span +class="ectt-1000">makeindex</span><a + id="dx1-15009"></a></a> or <a + id="dx1-15010"></a><a +href="#glo:xindy"><span +class="ectt-1000">xindy</span><a + id="dx1-15011"></a></a> to ensure the cross-references + are up-to-date. </div> + </p><!--l. 1522--><p class="noindent" > + </p></dd><dt class="description"> +<span +class="ecsx-1000">counterwithin</span><a + id="dx1-15012"></a> </dt><dd +class="description">This is a <span +class="cmsy-10">⟨</span><span +class="ecti-1000">key</span><span +class="cmsy-10">⟩</span>=<span +class="cmsy-10">⟨</span><span +class="ecti-1000">value</span><span +class="cmsy-10">⟩ </span>option where <span +class="cmsy-10">⟨</span><span +class="ecti-1000">value</span><span +class="cmsy-10">⟩ </span>is the name of a counter. If + used, this option will automatically set <span +class="ecss-1000">entrycounter=true</span><a + id="dx1-15013"></a> and the <span +class="ecss-1000">glossaryentry</span><a + id="dx1-15014"></a> + counter will be reset every time <span +class="cmsy-10">⟨</span><span +class="ecti-1000">value</span><span +class="cmsy-10">⟩ </span>is incremented. + <!--l. 1530--><p class="noindent" ><div class="important" title="Important Note"> The <span +class="ecss-1000">glossaryentry</span><a + id="dx1-15015"></a> counter isn’t automatically reset at the start of each + glossary, except when glossary section numbering is on and the counter + used by <span +class="ecss-1000">counterwithin</span><a + id="dx1-15016"></a> is the same as the counter used in the glossary’s + sectioning command. If you want the counter reset at the start of each + glossary, you can redefine <span +class="ectt-1000">\glossarypreamble</span><a + id="dx1-15017"></a> so that it sets <span +class="ecss-1000">glossaryentry</span><a + id="dx1-15018"></a> to + zero: + + + +</p> + <div class="verbatim" id="verbatim-30"> + \renewcommand{\glossarypreamble}{% +  <br />  \setcounter{glossaryentry}{0}% +  <br />} +</div> + <!--l. 1541--><p class="nopar" > </div> + </p><!--l. 1542--><p class="noindent" > + </p></dd><dt class="description"> +<span +class="ecsx-1000">subentrycounter</span><a + id="dx1-15019"></a> </dt><dd +class="description">This is a boolean option. (Default is <span +class="ecss-1000">subentrycounter=false</span><a + id="dx1-15020"></a>.) If set, + each level 1 glossary entry will be numbered when using the standard glossary + styles. This option creates the counter <span class="marginpar"><span +class="ectt-0900">glossarysubentry</span><span +class="ectt-0900"> </span></span><a + id="dx1-15021"></a><a + id="dx1-15022"></a><span +class="ecss-1000">glossarysubentry</span>. The + counter is reset with each main (level 0) entry. Note that this package option is + independent of <span +class="ecss-1000">entrycounter</span><a + id="dx1-15023"></a>. You can reference the number within the document + using <span +class="ectt-1000">\glsrefentry</span><a + id="dx1-15024"></a><span +class="ectt-1000">{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">} </span>where <span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩ </span>is the label associated with the + sub-entry. (See above.) + </dd><dt class="description"> +<span +class="ecsx-1000">style</span><a + id="dx1-15025"></a> </dt><dd +class="description">This is a <span +class="cmsy-10">⟨</span><span +class="ecti-1000">key</span><span +class="cmsy-10">⟩</span>=<span +class="cmsy-10">⟨</span><span +class="ecti-1000">value</span><span +class="cmsy-10">⟩ </span>option. (Default is <span +class="ecss-1000">style=list</span><a + id="dx1-15026"></a>.) Its value should be the + name of the glossary style to use. This key may only be used for styles defined in + <span +class="ecss-1000">glossary-list</span><a + id="dx1-15027"></a>, <span +class="ecss-1000">glossary-long</span><a + id="dx1-15028"></a>, <span +class="ecss-1000">glossary-super</span><a + id="dx1-15029"></a> or <span +class="ecss-1000">glossary-tree</span><a + id="dx1-15030"></a>. (See <a +href="#x1-4500015">§15 </a><a +href="#x1-4500015">Glossary + Styles<!--tex4ht:ref: sec:styles --></a>.) + </dd><dt class="description"> +<span +class="ecsx-1000">nolong</span><a + id="dx1-15031"></a> </dt><dd +class="description">This prevents the <span +class="ecss-1000">glossaries </span>package from automatically loading <span +class="ecss-1000">glossary-long</span><a + id="dx1-15032"></a> + (which means that the <span +class="ecss-1000">longtable</span><a + id="dx1-15033"></a> package also won’t be loaded). This reduces + overhead by not defining unwanted styles and commands. Note that if you use + this option, you won’t be able to use any of the glossary styles defined in the + <span +class="ecss-1000">glossary-long </span>package. + </dd><dt class="description"> +<span +class="ecsx-1000">nosuper</span><a + id="dx1-15034"></a> </dt><dd +class="description">This prevents the <span +class="ecss-1000">glossaries </span>package from automatically loading <span +class="ecss-1000">glossary-super</span><a + id="dx1-15035"></a> + (which means that the <span +class="ecss-1000">supertabular</span><a + id="dx1-15036"></a> package also won’t be loaded). This reduces + overhead by not defining unwanted styles and commands. Note that if you use + this option, you won’t be able to use any of the glossary styles defined in the + <span +class="ecss-1000">glossary-super </span>package. + </dd><dt class="description"> +<span +class="ecsx-1000">nolist</span><a + id="dx1-15037"></a> </dt><dd +class="description">This prevents the <span +class="ecss-1000">glossaries </span>package from automatically loading <span +class="ecss-1000">glossary-list</span><a + id="dx1-15038"></a>. + This reduces overhead by not defining unwanted styles. Note that if + you use this option, you won’t be able to use any of the glossary styles + defined in the <span +class="ecss-1000">glossary-list </span>package. Note that since the default style is <span +class="ecss-1000">list</span><a + id="dx1-15039"></a>, + + + + you will also need to use the <span +class="ecss-1000">style</span><a + id="dx1-15040"></a> option to set the style to something + else. + </dd><dt class="description"> +<span +class="ecsx-1000">notree</span><a + id="dx1-15041"></a> </dt><dd +class="description">This prevents the <span +class="ecss-1000">glossaries </span>package from automatically loading <span +class="ecss-1000">glossary-tree</span><a + id="dx1-15042"></a>. + This reduces overhead by not defining unwanted styles. Note that if you use this + option, you won’t be able to use any of the glossary styles defined in the + <span +class="ecss-1000">glossary-tree </span>package. + </dd><dt class="description"> +<span +class="ecsx-1000">nostyles</span><a + id="dx1-15043"></a> </dt><dd +class="description">This prevents all the predefined styles from being loaded. This option is + provided in the event that the user has custom styles that are not dependent on + the styles provided by the <span +class="ecss-1000">glossaries </span>package. Note that if you use this + option, you can’t use the <span +class="ecss-1000">style</span><a + id="dx1-15044"></a> package option. Instead you must either use + <span +class="ectt-1000">\glossarystyle</span><a + id="dx1-15045"></a><span +class="ectt-1000">{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">style</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">} </span>or the <span +class="ecss-1000">style</span><a + id="dx1-15046"></a> key in the optional argument to + <span +class="ectt-1000">\printglossary</span><a + id="dx1-15047"></a>. + </dd><dt class="description"> +<span +class="ecsx-1000">nonumberlist</span><a + id="dx1-15048"></a> </dt><dd +class="description">This option will suppress the associated <a + id="dx1-15049"></a><a +href="#glo:numberlist">number list<a + id="dx1-15050"></a>s</a> in the glossaries + (see also <a +href="#x1-250005">§5 </a><a +href="#x1-250005">Number lists<!--tex4ht:ref: sec:numberlists --></a>). + </dd><dt class="description"> +<span +class="ecsx-1000">seeautonumberlist</span><a + id="dx1-15051"></a> </dt><dd +class="description">If you suppress the <a + id="dx1-15052"></a><a +href="#glo:numberlist">number list<a + id="dx1-15053"></a>s</a> with <span +class="ecss-1000">nonumberlist</span><a + id="dx1-15054"></a>, described above, + this will also suppress any cross-referencing information supplied by the <span +class="ecss-1000">see</span><a + id="dx1-15055"></a> key in + <span +class="ectt-1000">\newglossaryentry</span><a + id="dx1-15056"></a> or <span +class="ectt-1000">\glssee</span><a + id="dx1-15057"></a>. If you use <span +class="ecss-1000">seeautonumberlist</span><a + id="dx1-15058"></a>, the <span +class="ecss-1000">see</span><a + id="dx1-15059"></a> key will + automatically implement <span +class="ecss-1000">nonumberlist=false</span><a + id="dx1-15060"></a> for that entry. (Note this + doesn’t affect <span +class="ectt-1000">\glssee</span>.) For further details see <a +href="#x1-300008">§8 </a><a +href="#x1-300008">Cross-Referencing + Entries<!--tex4ht:ref: sec:crossref --></a>. + </dd><dt class="description"> +<span +class="ecsx-1000">counter</span><a + id="dx1-15061"></a> </dt><dd +class="description">This is a <span +class="cmsy-10">⟨</span><span +class="ecti-1000">key</span><span +class="cmsy-10">⟩</span>=<span +class="cmsy-10">⟨</span><span +class="ecti-1000">value</span><span +class="cmsy-10">⟩ </span>option. (Default is <span +class="ecss-1000">counter=page</span><a + id="dx1-15062"></a>.) The value should be + the name of the default counter to use in the <a + id="dx1-15063"></a><a +href="#glo:numberlist">number list<a + id="dx1-15064"></a>s</a> (see <a +href="#x1-250005">§5 </a><a +href="#x1-250005">Number + lists<!--tex4ht:ref: sec:numberlists --></a>). + </dd></dl> +<!--l. 1620--><p class="noindent" > +</p> +<!--l. 1620--><p class="noindent" ><a +href="#top">Top</a></p><h4 class="subsectionHead"><span class="titlemark">2.4 </span> <a + id="x1-160002.4"></a>Sorting Options</h4> +<!--l. 1623--><p class="noindent" > + </p><dl class="description"><dt class="description"> +<span +class="ecsx-1000">sort</span><a + id="dx1-16001"></a> </dt><dd +class="description">This is a <span +class="cmsy-10">⟨</span><span +class="ecti-1000">key</span><span +class="cmsy-10">⟩</span>=<span +class="cmsy-10">⟨</span><span +class="ecti-1000">value</span><span +class="cmsy-10">⟩ </span>option where the option can only have one of the + following values: + + + + <ul class="itemize1"> + <li class="itemize"><span +class="ecss-1000">standard</span><a + id="dx1-16002"></a> : entries are sorted according to the value of the <span +class="ecss-1000">sort</span><a + id="dx1-16003"></a> key used in + <span +class="ectt-1000">\newglossaryentry</span><a + id="dx1-16004"></a> (if present) or the <span +class="ecss-1000">name</span><a + id="dx1-16005"></a> key (if <span +class="ecss-1000">sort</span><a + id="dx1-16006"></a> key is missing); + </li> + <li class="itemize"><span +class="ecss-1000">def</span><a + id="dx1-16007"></a> : entries are sorted in the order in which they were defined (the <span +class="ecss-1000">sort</span><a + id="dx1-16008"></a> + key in <span +class="ectt-1000">\newglossaryentry </span>is ignored); + </li> + <li class="itemize"><span +class="ecss-1000">use</span><a + id="dx1-16009"></a> : entries are sorted according to the order in which they are used in + the document (the <span +class="ecss-1000">sort</span><a + id="dx1-16010"></a> key in <span +class="ectt-1000">\newglossaryentry </span>is ignored).</li></ul> + <!--l. 1642--><p class="noindent" >The default is <span +class="ecss-1000">sort=standard</span><a + id="dx1-16011"></a>. + </p></dd><dt class="description"> +<span +class="ecsx-1000">order</span><a + id="dx1-16012"></a> </dt><dd +class="description">This may take two values: <span +class="ecss-1000">word</span><a + id="dx1-16013"></a> or <span +class="ecss-1000">letter</span><a + id="dx1-16014"></a>. The default is word ordering. + <!--l. 1648--><p class="noindent" ><div class="important" title="Important Note"> Note that the <span +class="ecss-1000">order</span><a + id="dx1-16015"></a> option has no effect if you don’t use <a + id="dx1-16016"></a><a +href="#glo:makeglossaries"><span +class="ectt-1000">makeglossaries</span><a + id="dx1-16017"></a></a>. + </div> + </p><!--l. 1651--><p class="noindent" > + </p></dd><dt class="description"> +<span +class="ecsx-1000">makeindex</span><a + id="dx1-16018"></a> </dt><dd +class="description">(Default) The glossary information and indexing style file will be written in + <a + id="dx1-16019"></a><a +href="#glo:makeindex"><span +class="ectt-1000">makeindex</span><a + id="dx1-16020"></a></a> format. If you use <a + id="dx1-16021"></a><a +href="#glo:makeglossaries"><span +class="ectt-1000">makeglossaries</span><a + id="dx1-16022"></a></a>, it will automatically detect that it + needs to call <a + id="dx1-16023"></a><span +class="ectt-1000">makeindex</span><a + id="dx1-16024"></a>. If you don’t use <a + id="dx1-16025"></a><span +class="ectt-1000">makeglossaries</span><a + id="dx1-16026"></a>, you need to remember + to use <a + id="dx1-16027"></a><span +class="ectt-1000">makeindex</span><a + id="dx1-16028"></a> not <a + id="dx1-16029"></a><a +href="#glo:xindy"><span +class="ectt-1000">xindy</span><a + id="dx1-16030"></a></a>. The indexing style file will been given a <span +class="ectt-1000">.ist</span><a + id="dx1-16031"></a> + extension. + </dd><dt class="description"> +<span +class="ecsx-1000">xindy</span><a + id="dx1-16032"></a> </dt><dd +class="description">The glossary information and indexing style file will be written in <a + id="dx1-16033"></a><a +href="#glo:xindy"><span +class="ectt-1000">xindy</span><a + id="dx1-16034"></a></a> format. + If you use <a + id="dx1-16035"></a><a +href="#glo:makeglossaries"><span +class="ectt-1000">makeglossaries</span><a + id="dx1-16036"></a></a>, it will automatically detect that it needs to call + <a + id="dx1-16037"></a><span +class="ectt-1000">xindy</span><a + id="dx1-16038"></a>. If you don’t use <a + id="dx1-16039"></a><span +class="ectt-1000">makeglossaries</span><a + id="dx1-16040"></a>, you need to remember to use + <a + id="dx1-16041"></a><span +class="ectt-1000">xindy</span><a + id="dx1-16042"></a> not <a + id="dx1-16043"></a><a +href="#glo:makeindex"><span +class="ectt-1000">makeindex</span><a + id="dx1-16044"></a></a>. The indexing style file will been given a <span +class="ectt-1000">.xdy</span><a + id="dx1-16045"></a> + extension. + <!--l. 1668--><p class="noindent" >The <span +class="ecss-1000">xindy</span><a + id="dx1-16046"></a> package option may additionally have a value that is a <span +class="cmsy-10">⟨</span><span +class="ecti-1000">key</span><span +class="cmsy-10">⟩</span>=<span +class="cmsy-10">⟨</span><span +class="ecti-1000">value</span><span +class="cmsy-10">⟩</span> + comma-separated list to override the language and codepage. For example: + + + +</p> + <div class="verbatim" id="verbatim-31"> + \usepackage[xindy={language=english,codepage=utf8}]{glossaries} +</div> + <!--l. 1673--><p class="nopar" > You can also specify whether you want a number group in the glossary. This + defaults to true, but can be suppressed. For example: + + + +</p> + <div class="verbatim" id="verbatim-32"> + \usepackage[xindy={glsnumbers=false}]{glossaries} +</div> + <!--l. 1678--><p class="nopar" > See <a +href="#x1-3400011">§11 </a><a +href="#x1-3400011">Xindy<!--tex4ht:ref: sec:xindy --></a> for further details on using <a + id="dx1-16047"></a><a +href="#glo:xindy"><span +class="ectt-1000">xindy</span><a + id="dx1-16048"></a></a> with the <span +class="ecss-1000">glossaries</span> + package. +</p> + </dd></dl> +<!--l. 1684--><p class="noindent" > +</p> +<!--l. 1684--><p class="noindent" ><a +href="#top">Top</a></p><h4 class="subsectionHead"><span class="titlemark">2.5 </span> <a + id="x1-170002.5"></a>Acronym Options</h4> +<!--l. 1687--><p class="noindent" > + </p><dl class="description"><dt class="description"> +<span +class="ecsx-1000">acronym</span><a + id="dx1-17001"></a> </dt><dd +class="description">This creates a new glossary with the label <span +class="ectt-1000">acronym</span>. This is equivalent + to: + + + + <div class="verbatim" id="verbatim-33"> + \newglossary[alg]{acronym}{acr}{acn}{\acronymname} +</div> + <!--l. 1692--><p class="nopar" > If the <span +class="ecss-1000">acronym</span><a + id="dx1-17002"></a> package option is used, <span +class="ectt-1000">\acronymtype</span><a + id="dx1-17003"></a> is set to <span +class="ectt-1000">acronym </span>otherwise it is set + to <span +class="ectt-1000">main</span>.<span class="footnote-mark"><a +href="#fn4x0" id="fn4x0-bk"><sup class="textsuperscript">4</sup></a></span><a + id="x1-17004f4"></a> + Entries that are defined using <span +class="ectt-1000">\newacronym</span><a + id="dx1-17009"></a> are placed in the glossary whose + label is given by <span +class="ectt-1000">\acronymtype</span><a + id="dx1-17010"></a>, unless another glossary is explicitly + specified. + </p></dd><dt class="description"> +<span +class="ecsx-1000">acronymlists</span><a + id="dx1-17011"></a> </dt><dd +class="description">By default, only the <span +class="ectt-1000">\acronymtype </span>glossary is considered to be a list of + acronyms. If you have other lists of acronyms, you can specify them as a + comma-separated list in the value of <span +class="ecss-1000">acronymlists</span><a + id="dx1-17012"></a>. For example, if you use the + <span +class="ecss-1000">acronym</span><a + id="dx1-17013"></a> package option but you also want the <span +class="ectt-1000">main </span>glossary to also contain a list + of acronyms, you can do: + + + + <div class="verbatim" id="verbatim-34"> + \usepackage[acronym,acronymlists={main}]{glossaries} +</div> + <!--l. 1711--><p class="nopar" > No check is performed to determine if the listed glossaries exist, so you can add + glossaries you haven’t defined yet. For example: + + + +</p> + <div class="verbatim" id="verbatim-35"> + \usepackage[acronym,acronymlists={main,acronym2}]{glossaries} +  <br />\newglossary[alg2]{acronym2}{acr2}{acn2}{Statistical Acronyms} +</div> + <!--l. 1717--><p class="nopar" > + </p></dd><dt class="description"> +<span +class="ecsx-1000">description</span><a + id="dx1-17014"></a> </dt><dd +class="description">This option changes the definition of <span +class="ectt-1000">\newacronym</span><a + id="dx1-17015"></a> to allow a description. + This option has no effect if you defined your own custom acronym style. See <a +href="#x1-3900013">§13 + </a><a +href="#x1-3900013">Acronyms<!--tex4ht:ref: sec:acronyms --></a> for further details. + </dd><dt class="description"> +<span +class="ecsx-1000">footnote</span><a + id="dx1-17016"></a> </dt><dd +class="description">This option changes the definition of <span +class="ectt-1000">\newacronym</span><a + id="dx1-17017"></a> and the way that + acronyms are displayed. This option has no effect if you defined your own custom + acronym style. See <a +href="#x1-3900013">§13 </a><a +href="#x1-3900013">Acronyms<!--tex4ht:ref: sec:acronyms --></a> for further details. + </dd><dt class="description"> +<span +class="ecsx-1000">smallcaps</span><a + id="dx1-17018"></a> </dt><dd +class="description">This option changes the definition of <span +class="ectt-1000">\newacronym</span><a + id="dx1-17019"></a> and the way that + acronyms are displayed. This option may have no effect if you defined your own + custom acronym style. See <a +href="#x1-3900013">§13 </a><a +href="#x1-3900013">Acronyms<!--tex4ht:ref: sec:acronyms --></a> for further details. + </dd><dt class="description"> +<span +class="ecsx-1000">smaller</span><a + id="dx1-17020"></a> </dt><dd +class="description">This option changes the definition of <span +class="ectt-1000">\newacronym</span><a + id="dx1-17021"></a> and the way that acronyms + are displayed. If you use this option, you will need to include the <span +class="ecss-1000">relsize</span><a + id="dx1-17022"></a> package or + otherwise define <span +class="ectt-1000">\textsmaller</span><a + id="dx1-17023"></a> or redefine <span +class="ectt-1000">\acronymfont</span><a + id="dx1-17024"></a>. This option may have + no effect if you defined your own custom acronym style. See <a +href="#x1-3900013">§13 </a><a +href="#x1-3900013">Acronyms<!--tex4ht:ref: sec:acronyms --></a> for + further details. + </dd><dt class="description"> +<span +class="ecsx-1000">dua</span><a + id="dx1-17025"></a> </dt><dd +class="description">This option changes the definition of <span +class="ectt-1000">\newacronym</span><a + id="dx1-17026"></a> so that acronyms are always + expanded. This option has no effect if you defined your own custom acronym + style. See <a +href="#x1-3900013">§13 </a><a +href="#x1-3900013">Acronyms<!--tex4ht:ref: sec:acronyms --></a> for further details. + </dd><dt class="description"> +<span +class="ecsx-1000">shortcuts</span><a + id="dx1-17027"></a> </dt><dd +class="description">This option provides shortcut commands for acronyms. See <a +href="#x1-3900013">§13 </a><a +href="#x1-3900013">Acronyms<!--tex4ht:ref: sec:acronyms --></a> for + further details. + </dd></dl> + + + +<!--l. 1751--><p class="noindent" > +</p> +<!--l. 1751--><p class="noindent" ><a +href="#top">Top</a></p><h3 class="sectionHead"><span class="titlemark">3 </span> <a + id="x1-180003"></a>Setting Up</h3> +<!--l. 1754--><p class="noindent" >The command +</p><!--l. 1755--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\makeglossaries</span><span +class="ectt-0900"> </span></span><a + id="dx1-18001"></a> <span +class="ectt-1000">\makeglossaries </span></div><hr> +</p><!--l. 1757--><p class="noindent" > +must be placed in the preamble in order to create the customised <a + id="dx1-18002"></a><a +href="#glo:makeindex"><span +class="ectt-1000">makeindex</span><a + id="dx1-18003"></a></a> (<span +class="ectt-1000">.ist</span><a + id="dx1-18004"></a>) or +<a + id="dx1-18005"></a><a +href="#glo:xindy"><span +class="ectt-1000">xindy</span><a + id="dx1-18006"></a></a> (<span +class="ectt-1000">.xdy</span><a + id="dx1-18007"></a>) style file and to ensure that glossary entries are written to the +appropriate output files. If you omit <span +class="ectt-1000">\makeglossaries </span>none of the glossaries will be +created. +</p><!--l. 1764--><p class="indent" > <div class="important" title="Important Note"> Note that some of the commands provided by the <span +class="ecss-1000">glossaries </span>package must be placed +before <span +class="ectt-1000">\makeglossaries </span>as they are required when creating the customised style file. If +you attempt to use those commands after <span +class="ectt-1000">\makeglossaries </span>you will generate an error. +</div> +</p><!--l. 1770--><p class="noindent" > +</p><!--l. 1772--><p class="indent" > You can suppress the creation of the customised <a + id="dx1-18008"></a><a +href="#glo:xindy"><span +class="ectt-1000">xindy</span><a + id="dx1-18009"></a></a> or <a + id="dx1-18010"></a><a +href="#glo:makeindex"><span +class="ectt-1000">makeindex</span><a + id="dx1-18011"></a></a> style file +using +</p><!--l. 1774--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\noist</span><span +class="ectt-0900"> </span></span><a + id="dx1-18012"></a> <span +class="ectt-1000">\noist </span></div><hr> +</p><!--l. 1776--><p class="noindent" > +Note that this command must be used before <span +class="ectt-1000">\makeglossaries</span>. +</p><!--l. 1778--><p class="indent" > <div class="important" title="Important Note"> Note that if you have a custom <span +class="ectt-1000">.xdy</span><a + id="dx1-18013"></a> file created when using <span +class="ecss-1000">glossaries </span>version 2.07 +or below, you will need to use the <span +class="ecss-1000">compatible-2.07</span><a + id="dx1-18014"></a> package option with it. +</div> +</p><!--l. 1782--><p class="noindent" > +</p><!--l. 1784--><p class="indent" > The default name for the customised style file is given by <span +class="ectt-1000">\jobname</span><a + id="dx1-18015"></a><span +class="ectt-1000">.ist</span><a + id="dx1-18016"></a> +(for <a + id="dx1-18017"></a><a +href="#glo:makeindex"><span +class="ectt-1000">makeindex</span><a + id="dx1-18018"></a></a>) or <span +class="ectt-1000">\jobname</span><a + id="dx1-18019"></a><span +class="ectt-1000">.xdy</span><a + id="dx1-18020"></a> (for <a + id="dx1-18021"></a><a +href="#glo:xindy"><span +class="ectt-1000">xindy</span><a + id="dx1-18022"></a></a>). This name may be changed +using: +</p><!--l. 1788--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\setStyleFile</span><span +class="ectt-0900"> </span></span><a + id="dx1-18023"></a> <span +class="ectt-1000">\setStyleFile{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">name</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">} </span></div><hr> +</p><!--l. 1790--><p class="noindent" > +where <span +class="cmsy-10">⟨</span><span +class="ecti-1000">name</span><span +class="cmsy-10">⟩ </span>is the name of the style file without the extension. Note that this +command must be used before <span +class="ectt-1000">\makeglossaries</span>. +</p><!--l. 1795--><p class="indent" > Each glossary entry is assigned a <a + id="dx1-18024"></a><a +href="#glo:numberlist">number list<a + id="dx1-18025"></a></a> that lists all the locations in the +document where that entry was used. By default, the location refers to the page number +but this may be overridden using the <span +class="ecss-1000">counter</span><a + id="dx1-18026"></a> package option. The default form of +the location number assumes a full stop compositor (e.g. 1.2), but if your +location numbers use a different compositor (e.g. 1-2) you need to set this +using +</p><!--l. 1802--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\glsSetCompositor</span><span +class="ectt-0900"> </span></span><a + id="dx1-18027"></a> <span +class="ectt-1000">\glsSetCompositor{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">symbol</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">} </span></div><hr> +</p><!--l. 1804--><p class="noindent" > +For example: + + + +</p> + <div class="verbatim" id="verbatim-36"> +\glsSetCompositor{-} +</div> +<!--l. 1808--><p class="nopar" > Note that this command must be used before <span +class="ectt-1000">\makeglossaries</span>. +</p><!--l. 1811--><p class="indent" > If you use <a + id="dx1-18028"></a><a +href="#glo:xindy"><span +class="ectt-1000">xindy</span><a + id="dx1-18029"></a></a>, you can have a different compositor for page numbers starting +with an uppercase alphabetical character using: +</p><!--l. 1813--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\glsSetAlphaCompositor</span><span +class="ectt-0900"> </span></span><a + id="dx1-18030"></a> <span +class="ectt-1000">\glsSetAlphaCompositor{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">symbol</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">} </span></div><hr> +</p><!--l. 1815--><p class="noindent" > +Note that this command has no effect if you haven’t used the <span +class="ecss-1000">xindy</span><a + id="dx1-18031"></a> package option. For +example, if you want <a + id="dx1-18032"></a><a +href="#glo:numberlist">number list<a + id="dx1-18033"></a>s</a> containing a mixture of A-1 and 2.3 style formats, +then do: + + + +</p> + <div class="verbatim" id="verbatim-37"> +\glsSetCompositor{.}\glsSetAlphaCompositor{-} +</div> +<!--l. 1822--><p class="nopar" > See <a +href="#x1-250005">§5 </a><a +href="#x1-250005">Number lists<!--tex4ht:ref: sec:numberlists --></a> for further information about <a + id="dx1-18034"></a><a +href="#glo:numberlist">number list<a + id="dx1-18035"></a>s</a>. +</p><!--l. 1826--><p class="noindent" > +</p> +<!--l. 1826--><p class="noindent" ><a +href="#top">Top</a></p><h3 class="sectionHead"><span class="titlemark">4 </span> <a + id="x1-190004"></a>Defining Glossary Entries</h3> +<!--l. 1829--><p class="noindent" >All glossary entries must be defined before they are used, so it is better to define them in the preamble +to ensure this.<span class="footnote-mark"><a +href="#fn5x0" id="fn5x0-bk"><sup class="textsuperscript">5</sup></a></span><a + id="x1-19001f5"></a> +However only those entries that occur in the document (using any of the commands +described in <a +href="#x1-260006">§6 </a><a +href="#x1-260006">Links to Glossary Entries<!--tex4ht:ref: sec:glslink --></a>, <a +href="#x1-290007">§7 </a><a +href="#x1-290007">Adding an Entry to the Glossary Without +Generating Text<!--tex4ht:ref: sec:glsadd --></a> or <a +href="#x1-300008">§8 </a><a +href="#x1-300008">Cross-Referencing Entries<!--tex4ht:ref: sec:crossref --></a>) will appear in the glossary. Each time +an entry is used in this way, a line is added to an associated glossary file (<span +class="ectt-1000">.glo</span><a + id="dx1-19005"></a>), which +then needs to be converted into a corresponding <span +class="ectt-1000">.gls</span><a + id="dx1-19006"></a> file which contains the typeset +glossary which is input by <span +class="ectt-1000">\printglossary</span><a + id="dx1-19007"></a> or <span +class="ectt-1000">\printglossaries</span><a + id="dx1-19008"></a>. The Perl script +<a + id="dx1-19009"></a><a +href="#glo:makeglossaries"><span +class="ectt-1000">makeglossaries</span><a + id="dx1-19010"></a></a> can be used to call <a + id="dx1-19011"></a><a +href="#glo:makeindex"><span +class="ectt-1000">makeindex</span><a + id="dx1-19012"></a></a> or <a + id="dx1-19013"></a><a +href="#glo:xindy"><span +class="ectt-1000">xindy</span><a + id="dx1-19014"></a></a>, using a customised indexing +style file, for each of the glossaries that are defined in the document. <span +class="ecbx-1000">Note that there</span> +<span +class="ecbx-1000">should be no need for you to explicitly edit or input any of these external</span> +<span +class="ecbx-1000">files.</span><span class="footnote-mark"><a +href="#fn6x0" id="fn6x0-bk"><sup class="textsuperscript">6</sup></a></span><a + id="x1-19015f6"></a> +See <a +href="#x1-70001.3">§1.3 </a><a +href="#x1-70001.3">Generating the Associated Glossary Files<!--tex4ht:ref: sec:makeglossaries --></a> for further details. +</p><!--l. 1851--><p class="indent" > New glossary entries are defined using the command: +</p><!--l. 1852--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\newglossaryentry</span><span +class="ectt-0900"> </span></span><a + id="dx1-19017"></a> <span +class="ectt-1000">\newglossaryentry{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">key-val list</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">} </span></div><hr> +</p><!--l. 1854--><p class="noindent" > +The first argument, <span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩</span>, must be a unique label with which to identify this entry. +The second argument, <span +class="cmsy-10">⟨</span><span +class="ecti-1000">key-val list</span><span +class="cmsy-10">⟩</span>, is a <span +class="cmsy-10">⟨</span><span +class="ecti-1000">key</span><span +class="cmsy-10">⟩</span>=<span +class="cmsy-10">⟨</span><span +class="ecti-1000">value</span><span +class="cmsy-10">⟩ </span>list that supplies the relevant +information about this entry. There are two required fields: <span +class="ecss-1000">description</span><a + id="dx1-19018"></a> and either <span +class="ecss-1000">name</span><a + id="dx1-19019"></a> +or <span +class="ecss-1000">parent</span><a + id="dx1-19020"></a>. Available fields are listed below: +</p><!--l. 1862--><p class="indent" > + </p><dl class="description"><dt class="description"> +<span +class="ecsx-1000">name</span><a + id="dx1-19021"></a> </dt><dd +class="description">The name of the entry (as it will appear in the glossary). If this key is + omitted and the <span +class="ecss-1000">parent</span><a + id="dx1-19022"></a> key is supplied, this value will be the same as the + parent’s name. + </dd><dt class="description"> +<span +class="ecsx-1000">description</span><a + id="dx1-19023"></a> </dt><dd +class="description">A brief description of this term (to appear in the glossary). Within this + value, you can use + <!--l. 1869--><p class="noindent" ><hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\nopostdesc</span><span +class="ectt-0900"> </span></span><a + id="dx1-19024"></a> <span +class="ectt-1000">\nopostdesc </span></div><hr> + </p><!--l. 1871--><p class="noindent" > + to suppress the description terminator for this entry. For example, if this + + + + entry is a parent entry that doesn’t require a description, you can do + <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">description={\nopostdesc}</span></span></span>. If you want a paragraph break in the description + use + </p><!--l. 1877--><p class="noindent" ><hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\glspar</span><span +class="ectt-0900"> </span></span><a + id="dx1-19025"></a> <span +class="ectt-1000">\glspar </span></div><hr> + </p><!--l. 1879--><p class="noindent" > + However, note that not all glossary styles support multi-line descriptions. If you + are using one of the tabular-like glossary styles that permit multi-line + descriptions, use <span +class="ectt-1000">\newline</span><a + id="dx1-19026"></a> not <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\\</span></span></span> if you want to force a line break. + </p></dd><dt class="description"> +<span +class="ecsx-1000">parent</span><a + id="dx1-19027"></a> </dt><dd +class="description">The label of the parent entry. Note that the parent entry must be defined before + its sub-entries. See <a +href="#x1-210004.2">§4.2 </a><a +href="#x1-210004.2">Sub-Entries<!--tex4ht:ref: sec:subentries --></a> for further details. + </dd><dt class="description"> +<span +class="ecsx-1000">descriptionplural</span><a + id="dx1-19028"></a> </dt><dd +class="description">The plural form of the description (as passed to <span +class="ectt-1000">\glsdisplay</span><a + id="dx1-19029"></a> and + <span +class="ectt-1000">\glsdisplayfirst</span><a + id="dx1-19030"></a> by <span +class="ectt-1000">\glspl</span><a + id="dx1-19031"></a>, <span +class="ectt-1000">\Glspl</span><a + id="dx1-19032"></a> and <span +class="ectt-1000">\GLSpl</span><a + id="dx1-19033"></a>). If omitted, the value is set to + the same as the <span +class="ecss-1000">description</span><a + id="dx1-19034"></a> key. (Note that if you want the description to appear + in the main body of the document, you must switch off the description + <a + id="dx1-19035"></a><a +href="#glo:sanitize">sanitization<a + id="dx1-19036"></a></a> using the <span +class="ecss-1000">sanitize</span><a + id="dx1-19037"></a> package option described in <a +href="#x1-130002.1">§2.1 </a><a +href="#x1-130002.1">General + Options<!--tex4ht:ref: sec:pkgopts-general --></a>.) + </dd><dt class="description"> +<span +class="ecsx-1000">text</span><a + id="dx1-19038"></a> </dt><dd +class="description">How this entry will appear in the document text when using <span +class="ectt-1000">\gls</span><a + id="dx1-19039"></a> (or one of its + uppercase variants). If this field is omitted, the value of the <span +class="ecss-1000">name</span><a + id="dx1-19040"></a> key is + used. + </dd><dt class="description"> +<span +class="ecsx-1000">first</span><a + id="dx1-19041"></a> </dt><dd +class="description">How the entry will appear in the document text on <a + id="dx1-19042"></a><a +href="#glo:firstuse">first use</a> with <span +class="ectt-1000">\gls</span><a + id="dx1-19043"></a> (or one of + its uppercase variants). If this field is omitted, the value of the <span +class="ecss-1000">text</span><a + id="dx1-19044"></a> key is used. + Note that if you use <span +class="ectt-1000">\glspl</span><a + id="dx1-19045"></a>, <span +class="ectt-1000">\Glspl</span><a + id="dx1-19046"></a>, <span +class="ectt-1000">\GLSpl</span><a + id="dx1-19047"></a>, <span +class="ectt-1000">\glsdisp</span><a + id="dx1-19048"></a> before using <span +class="ectt-1000">\gls</span><a + id="dx1-19049"></a>, the + <span +class="ecss-1000">firstplural</span><a + id="dx1-19050"></a> value won’t be used with <span +class="ectt-1000">\gls</span><a + id="dx1-19051"></a>. + </dd><dt class="description"> +<span +class="ecsx-1000">plural</span><a + id="dx1-19052"></a> </dt><dd +class="description">How the entry will appear in the document text when using <span +class="ectt-1000">\glspl</span><a + id="dx1-19053"></a> (or one of its + uppercase variants). If this field is omitted, the value is obtained by appending + <span +class="ectt-1000">\glspluralsuffix</span><a + id="dx1-19054"></a> to the value of the <span +class="ecss-1000">text</span><a + id="dx1-19055"></a> field. The default value of + <span +class="ectt-1000">\glspluralsuffix</span><a + id="dx1-19056"></a> is the letter “s”. + </dd><dt class="description"> +<span +class="ecsx-1000">firstplural</span><a + id="dx1-19057"></a> </dt><dd +class="description">How the entry will appear in the document text on <a + id="dx1-19058"></a><a +href="#glo:firstuse">first use</a> with <span +class="ectt-1000">\glspl</span><a + id="dx1-19059"></a> (or + one of its uppercase variants). If this field is omitted, the value is obtained from + the <span +class="ecss-1000">plural</span><a + id="dx1-19060"></a> key, if the <span +class="ecss-1000">first</span><a + id="dx1-19061"></a> key is omitted, or by appending <span +class="ectt-1000">\glspluralsuffix</span><a + id="dx1-19062"></a> to + the value of the <span +class="ecss-1000">first</span><a + id="dx1-19063"></a> field, if the <span +class="ecss-1000">first</span><a + id="dx1-19064"></a> field is present. Note that if you use <span +class="ectt-1000">\gls</span><a + id="dx1-19065"></a>, + <span +class="ectt-1000">\Gls</span><a + id="dx1-19066"></a>, <span +class="ectt-1000">\GLS</span><a + id="dx1-19067"></a>, <span +class="ectt-1000">\glsdisp </span>before using <span +class="ectt-1000">\glspl</span><a + id="dx1-19068"></a>, the <span +class="ecss-1000">firstplural</span><a + id="dx1-19069"></a> value won’t be used with + <span +class="ectt-1000">\glspl</span><a + id="dx1-19070"></a>. + <!--l. 1925--><p class="noindent" ><span +class="ecbx-1000">Note: </span>prior to version 1.13, the default value of <span +class="ecss-1000">firstplural</span><a + id="dx1-19071"></a> was always taken by + appending “s” to the <span +class="ecss-1000">first</span><a + id="dx1-19072"></a> key, which meant that you had to specify both <span +class="ecss-1000">plural</span><a + id="dx1-19073"></a> and + <span +class="ecss-1000">firstplural</span><a + id="dx1-19074"></a>, even if you hadn’t used the <span +class="ecss-1000">first</span><a + id="dx1-19075"></a> key. + + + + </p></dd><dt class="description"> +<span +class="ecsx-1000">symbol</span><a + id="dx1-19076"></a> </dt><dd +class="description">This field is provided to allow the user to specify an associated symbol. If + omitted, the value is set to <span +class="ectt-1000">\relax</span>. Note that not all glossary styles display the + symbol. (If you want the symbol to appear in the main body of the document, you + must switch off the symbol <a + id="dx1-19077"></a><a +href="#glo:sanitize">sanitization<a + id="dx1-19078"></a></a> using the <span +class="ecss-1000">sanitize</span><a + id="dx1-19079"></a> package option described + in <a +href="#x1-130002.1">§2.1 </a><a +href="#x1-130002.1">General Options<!--tex4ht:ref: sec:pkgopts-general --></a>.) + </dd><dt class="description"> +<span +class="ecsx-1000">symbolplural</span><a + id="dx1-19080"></a> </dt><dd +class="description">This is the plural form of the symbol (as passed to <span +class="ectt-1000">\glsdisplay</span><a + id="dx1-19081"></a> and + <span +class="ectt-1000">\glsdisplayfirst</span><a + id="dx1-19082"></a> by <span +class="ectt-1000">\glspl</span><a + id="dx1-19083"></a>, <span +class="ectt-1000">\Glspl</span><a + id="dx1-19084"></a> and <span +class="ectt-1000">\GLSpl</span><a + id="dx1-19085"></a>). If omitted, the value is set to + the same as the <span +class="ecss-1000">symbol</span><a + id="dx1-19086"></a> key. + </dd><dt class="description"> +<span +class="ecsx-1000">sort</span><a + id="dx1-19087"></a> </dt><dd +class="description">This value indicates how <a + id="dx1-19088"></a><a +href="#glo:makeindex"><span +class="ectt-1000">makeindex</span><a + id="dx1-19089"></a></a> or <a + id="dx1-19090"></a><a +href="#glo:xindy"><span +class="ectt-1000">xindy</span><a + id="dx1-19091"></a></a> should sort this entry. If omitted, + the value is given by the <span +class="ecss-1000">name</span><a + id="dx1-19092"></a> field. In general, it’s best to use the <span +class="ecss-1000">sort</span><a + id="dx1-19093"></a> key if the + <span +class="ecss-1000">name</span><a + id="dx1-19094"></a> contains commands (e.g. <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\ensuremath{\alpha}</span></span></span>). Note that the package + options <span +class="ecss-1000">sort=def</span><a + id="dx1-19095"></a> and <span +class="ecss-1000">sort=use</span><a + id="dx1-19096"></a> override the <span +class="ecss-1000">sort</span><a + id="dx1-19097"></a> key in <span +class="ectt-1000">\newglossaryentry</span><a + id="dx1-19098"></a> (see + <a +href="#x1-160002.4">§2.4 </a><a +href="#x1-160002.4">Sorting Options<!--tex4ht:ref: sec:pkgopts-sort --></a>). + </dd><dt class="description"> +<span +class="ecsx-1000">type</span><a + id="dx1-19099"></a> </dt><dd +class="description">This specifies the label of the glossary in which this entry belongs. If omitted, + the default glossary is assumed unless <span +class="ectt-1000">\newacronym</span><a + id="dx1-19100"></a> is used (see <a +href="#x1-3900013">§13 + </a><a +href="#x1-3900013">Acronyms<!--tex4ht:ref: sec:acronyms --></a>). + </dd><dt class="description"> +<span +class="ecsx-1000">user1</span><a + id="dx1-19101"></a><span +class="ecbx-1000">, </span><span +class="ecbx-1000">…, </span><span +class="ecsx-1000">user6</span><a + id="dx1-19102"></a><a + id="dx1-19103"></a><a + id="dx1-19104"></a><a + id="dx1-19105"></a><a + id="dx1-19106"></a> </dt><dd +class="description">Six keys provided for any additional information the user may want to + specify. (For example an associated dimension or an alternative plural or some + other grammatical construct.) + </dd><dt class="description"> +<span +class="ecsx-1000">nonumberlist</span><a + id="dx1-19107"></a> </dt><dd +class="description">A boolean key. If the value is missing or is <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">true</span></span></span>, this will suppress the + <a + id="dx1-19108"></a><a +href="#glo:numberlist">number list<a + id="dx1-19109"></a></a> just for this entry. Conversely, if you have used the package option + <span +class="ecss-1000">nonumberlist</span><a + id="dx1-19110"></a>, you can activate the <a + id="dx1-19111"></a>number list<a + id="dx1-19112"></a> just for this entry with + <span +class="ecss-1000">nonumberlist=false</span><a + id="dx1-19113"></a>. (See <a +href="#x1-250005">§5 </a><a +href="#x1-250005">Number lists<!--tex4ht:ref: sec:numberlists --></a>.) + </dd><dt class="description"> +<span +class="ecsx-1000">see</span><a + id="dx1-19114"></a> </dt><dd +class="description">Cross-reference another entry. Using the <span +class="ecss-1000">see</span><a + id="dx1-19115"></a> key will automatically add this entry + to the glossary, but will not automatically add the cross-referenced entry. The + referenced entry should be supplied as the value to this key. If you want to + override the “see” tag, you can supply the new tag in square brackets before + the label. For example <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">see=[see</span><span +class="ectt-1000"> also]{anotherlabel}</span></span></span>. Note that if + you have suppressed the <a + id="dx1-19116"></a><a +href="#glo:numberlist">number list<a + id="dx1-19117"></a></a>, the cross-referencing information + won’t appear in the glossary. You can override this for individual glossary + entries using <span +class="ecss-1000">nonumberlist=false</span><a + id="dx1-19118"></a> (see above). Alternatively, you can use the + <span +class="ecss-1000">seeautonumberlist</span><a + id="dx1-19119"></a> package option. For further details, see <a +href="#x1-300008">§8 </a><a +href="#x1-300008">Cross-Referencing + Entries<!--tex4ht:ref: sec:crossref --></a>. + </dd></dl> + + + +<!--l. 1986--><p class="indent" > The following keys are reserved for <span +class="ectt-1000">\newacronym</span><a + id="dx1-19120"></a> (see <a +href="#x1-3900013">§13 </a><a +href="#x1-3900013">Acronyms<!--tex4ht:ref: sec:acronyms --></a>): <span +class="ecss-1000">long</span><a + id="dx1-19121"></a>, +<span +class="ecss-1000">longplural</span><a + id="dx1-19122"></a>, <span +class="ecss-1000">short</span><a + id="dx1-19123"></a> and <span +class="ecss-1000">shortplural</span><a + id="dx1-19124"></a>. +</p><!--l. 1990--><p class="indent" > Note that if the name starts with an accented letter or non-Roman character, you +must group the character, otherwise it will cause a problem for commands like <span +class="ectt-1000">\Gls</span><a + id="dx1-19125"></a> and +<span +class="ectt-1000">\Glspl</span><a + id="dx1-19126"></a>. For example: + + + +</p> + <div class="verbatim" id="verbatim-38"> +\newglossaryentry{elite}{name={{\’e}lite}, + <br />description={select group or class}} +</div> +<!--l. 1997--><p class="nopar" > Note that the same applies if you are using the <span +class="ecss-1000">inputenc</span><a + id="dx1-19127"></a> package: + + + +</p> + <div class="verbatim" id="verbatim-39"> +\newglossaryentry{elite}{name={{é}lite}, + <br />description={select group or class}} +</div> +<!--l. 2003--><p class="nopar" > Note that in both of the above examples, you will also need to supply the <span +class="ecss-1000">sort</span><a + id="dx1-19128"></a> key if +you are using <a + id="dx1-19129"></a><a +href="#glo:makeindex"><span +class="ectt-1000">makeindex</span><a + id="dx1-19130"></a></a> whereas <a + id="dx1-19131"></a><a +href="#glo:xindy"><span +class="ectt-1000">xindy</span><a + id="dx1-19132"></a></a> is usually able to sort accented letters +correctly. +</p><!--l. 2009--><p class="noindent" > +</p> +<!--l. 2009--><p class="noindent" ><a +href="#top">Top</a></p><h4 class="subsectionHead"><span class="titlemark">4.1 </span> <a + id="x1-200004.1"></a>Plurals</h4> +<!--l. 2010--><p class="noindent" >You may have noticed from above that you can specify the plural form when you define +a term. If you omit this, the plural will be obtained by appending +</p><!--l. 2013--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\glspluralsuffix</span><span +class="ectt-0900"> </span></span><a + id="dx1-20001"></a> <span +class="ectt-1000">\glspluralsuffix </span></div><hr> +</p><!--l. 2015--><p class="noindent" > +to the singular form. This command defaults to the letter “s”. For example: + + + +</p> + <div class="verbatim" id="verbatim-40"> +\newglossaryentry{cow}{name=cow,description={a fully grown + <br />female of any bovine animal}} +</div> +<!--l. 2021--><p class="nopar" > defines a new entry whose singular form is “cow” and plural form is “cows”. However, if +you are writing in archaic English, you may want to use “kine” as the plural form, in +which case you would have to do: + + + +</p> + <div class="verbatim" id="verbatim-41"> +\newglossaryentry{cow}{name=cow,plural=kine, + <br />description={a fully grown female of any bovine animal}} +</div> +<!--l. 2029--><p class="nopar" > +</p><!--l. 2031--><p class="indent" > If you are writing in a language that supports multiple plurals (for a given term) +then use the <span +class="ecss-1000">plural</span><a + id="dx1-20002"></a> key for one of them and one of the user keys to specify the other +plural form. For example: + + + +</p> + <div class="verbatim" id="verbatim-42"> +\newglossaryentry{cow}{name=cow,description={a fully grown + <br />female of any bovine animal (plural cows, archaic plural kine)}, + <br />user1={kine}} +</div> +<!--l. 2039--><p class="nopar" > You can then use <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\glspl{cow}</span></span></span> to produce “cows” and <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\glsuseri{cow}</span></span></span> to +produce “kine”. You can, of course, define an easy to remember synonym. For +example: + + + +</p> + <div class="verbatim" id="verbatim-43"> +\let\glsaltpl\glsuseri +</div> +<!--l. 2045--><p class="nopar" > Then you don’t have to remember which key you used to store the alternative +plural. +</p><!--l. 2049--><p class="indent" > If you are using a language that usually forms plurals by appending a different +letter, or sequence of letters, you can redefine <span +class="ectt-1000">\glspluralsuffix </span>as required. However, +this must be done <span +class="ecti-1000">before </span>the entries are defined. For languages that don’t form plurals +by simply appending a suffix, all the plural forms must be specified using the <span +class="ecss-1000">plural</span><a + id="dx1-20003"></a> key +(and the <span +class="ecss-1000">firstplural</span><a + id="dx1-20004"></a> key where necessary). +</p><!--l. 2057--><p class="noindent" > +</p> +<!--l. 2057--><p class="noindent" ><a +href="#top">Top</a></p><h4 class="subsectionHead"><span class="titlemark">4.2 </span> <a + id="x1-210004.2"></a>Sub-Entries</h4> +<!--l. 2060--><p class="noindent" >As from version 1.17, it is possible to specify sub-entries. These may be used to order +the glossary into categories, in which case the sub-entry will have a different name to its +parent entry, or it may be used to distinguish different definitions for the same word, in +which case the sub-entries will have the same name as the parent entry. Note that not +all glossary styles support hierarchical entries and may display all the entries in a flat +format. Of the styles that support sub-entries, some display the sub-entry’s name whilst +others don’t. Therefore you need to ensure that you use a suitable style. (See <a +href="#x1-4500015">§15 +</a><a +href="#x1-4500015">Glossary Styles<!--tex4ht:ref: sec:styles --></a> for a list of predefined styles.) As from version 3.0, level 1 +sub-entries are automatically numbered in the predefined styles if you use the +<span +class="ecss-1000">subentrycounter</span><a + id="dx1-21001"></a> package option (see <a +href="#x1-150002.3">§2.3 </a><a +href="#x1-150002.3">Glossary Appearance Options<!--tex4ht:ref: sec:pkgopts-printglos --></a> for further +details). +</p><!--l. 2075--><p class="indent" > Note that the parent entry will automatically be added to the glossary if any of its +child entries are used in the document. If the parent entry is not referenced in the +document, it will not have a <a + id="dx1-21002"></a><a +href="#glo:numberlist">number list<a + id="dx1-21003"></a></a>. Note also that <a + id="dx1-21004"></a><a +href="#glo:makeindex"><span +class="ectt-1000">makeindex</span><a + id="dx1-21005"></a></a> has a restriction on +the maximum sub-entry depth. +</p><!--l. 2081--><p class="noindent" > +</p> +<!--l. 2081--><p class="noindent" ><a +href="#top">Top</a></p><h5 class="subsubsectionHead"><span class="titlemark">4.2.1 </span> <a + id="x1-220004.2.1"></a>Hierarchical Categories</h5> +<!--l. 2083--><p class="noindent" >To arrange a glossary with hierarchical categories, you need to first define the category +and then define the sub-entries using the relevant category entry as the value of the +<span +class="ecss-1000">parent</span><a + id="dx1-22001"></a> key. For example, suppose I want a glossary of mathematical symbols that are +divided into Greek letters and Roman letters. Then I can define the categories as +follows: + + + +</p> + <div class="verbatim" id="verbatim-44"> +\newglossaryentry{greekletter}{name={Greek letters}, + <br />description={\nopostdesc}} + <br />\newglossaryentry{romanletter}{name={Roman letters}, + <br />description={\nopostdesc}} +</div> +<!--l. 2095--><p class="nopar" > +</p><!--l. 2097--><p class="indent" > Note that in this example, the category entries don’t need a description so I have set +the descriptions to <span +class="ectt-1000">\nopostdesc</span><a + id="dx1-22002"></a>. This gives a blank description and suppresses the +description terminator. +</p><!--l. 2102--><p class="indent" > I can now define my sub-entries as follows: + + + +</p> + <div class="verbatim" id="verbatim-45"> +\newglossaryentry{pi}{name={\ensuremath{\pi}},sort={pi}, + <br />description={ratio of the circumference of a circle to the diameter}, + <br />parent=greekletter} + <br />\newglossaryentry{C}{name={\ensuremath{C}},sort={C}, + <br />description={Euler’s constant}, + <br />parent=romanletter} +</div> +<!--l. 2111--><p class="nopar" > +</p><!--l. 2114--><p class="noindent" > +</p> +<!--l. 2114--><p class="noindent" ><a +href="#top">Top</a></p><h5 class="subsubsectionHead"><span class="titlemark">4.2.2 </span> <a + id="x1-230004.2.2"></a>Homographs</h5> +<!--l. 2116--><p class="noindent" >Sub-entries that have the same name as the parent entry, don’t need to have the <span +class="ecss-1000">name</span><a + id="dx1-23001"></a> +key. For example, the word “glossary” can mean a list of technical words or a collection +of glosses. In both cases the plural is “glossaries”. So first define the parent +entry: + + + +</p> + <div class="verbatim" id="verbatim-46"> +\newglossaryentry{glossary}{name=glossary, + <br />description={\nopostdesc}, + <br />plural={glossaries}} +</div> +<!--l. 2125--><p class="nopar" > Again, the parent entry has no description, so the description terminator needs to be +suppressed using <span +class="ectt-1000">\nopostdesc</span><a + id="dx1-23002"></a>. +</p><!--l. 2129--><p class="indent" > Now define the two different meanings of the word: + + + +</p> + <div class="verbatim" id="verbatim-47"> +\newglossaryentry{glossarylist}{ + <br />description={list of technical words}, + <br />sort={1}, + <br />parent={glossary}} + <br />\newglossaryentry{glossarycol}{ + <br />description={collection of glosses}, + <br />sort={2}, + <br />parent={glossary}} +</div> +<!--l. 2140--><p class="nopar" > Note that if I reference the parent entry, the location will be added to the parent’s +<a + id="dx1-23003"></a><a +href="#glo:numberlist">number list<a + id="dx1-23004"></a></a>, whereas if I reference any of the child entries, the location will be added to +the child entry’s number list. Note also that since the sub-entries have the same name, +the <span +class="ecss-1000">sort</span><a + id="dx1-23005"></a> key is required unless you are using the <span +class="ecss-1000">sort=use</span><a + id="dx1-23006"></a> or <span +class="ecss-1000">sort=def</span><a + id="dx1-23007"></a> package +options. You can use the <span +class="ecss-1000">subentrycounter</span><a + id="dx1-23008"></a> package option to automatically number +the first-level child entries. See <a +href="#x1-150002.3">§2.3 </a><a +href="#x1-150002.3">Glossary Appearance Options<!--tex4ht:ref: sec:pkgopts-printglos --></a> for further +details. +</p><!--l. 2151--><p class="indent" > In the above example, the plural form for both of the child entries is the same as the +parent entry, so the <span +class="ecss-1000">plural</span><a + id="dx1-23009"></a> key was not required for the child entries. However, +if the sub-entries have different plurals, they will need to be specified. For +example: + + + +</p> + <div class="verbatim" id="verbatim-48"> +\newglossaryentry{bravo}{name={bravo}, + <br />description={\nopostdesc}} + <br />\newglossaryentry{bravocry}{description={cry of approval (pl.\ bravos)}, + <br />sort={1}, + <br />plural={bravos}, + <br />parent=bravo} + <br />\newglossaryentry{bravoruffian}{description={hired ruffian or + <br />killer (pl.\ bravoes)}, + <br />sort={2}, + <br />plural={bravoes}, + <br />parent=bravo} +</div> +<!--l. 2169--><p class="nopar" > +</p><!--l. 2172--><p class="noindent" > +</p> +<!--l. 2172--><p class="noindent" ><a +href="#top">Top</a></p><h4 class="subsectionHead"><span class="titlemark">4.3 </span> <a + id="x1-240004.3"></a>Loading Entries From a File</h4> +<!--l. 2175--><p class="noindent" >You can store all your glossary entry definitions in another file and use: +</p><!--l. 2177--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\loadglsentries</span><span +class="ectt-0900"> </span></span><a + id="dx1-24001"></a> <span +class="ectt-1000">\loadglsentries[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">type</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">]{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">filename</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">} </span></div><hr> +</p><!--l. 2179--><p class="noindent" > +where <span +class="cmsy-10">⟨</span><span +class="ecti-1000">filename</span><span +class="cmsy-10">⟩ </span>is the name of the file containing all the <span +class="ectt-1000">\newglossaryentry</span><a + id="dx1-24002"></a> +commands. The optional argument <span +class="cmsy-10">⟨</span><span +class="ecti-1000">type</span><span +class="cmsy-10">⟩ </span>is the name of the glossary to which those +entries should belong, for those entries where the <span +class="ecss-1000">type</span><a + id="dx1-24003"></a> key has been omitted (or, more +specifically, for those entries whose type has been specified by <span +class="ectt-1000">\glsdefaulttype</span><a + id="dx1-24004"></a>, which +is what <span +class="ectt-1000">\newglossaryentry</span><a + id="dx1-24005"></a> uses by default). For example, suppose I have a file called +<span +class="ectt-1000">myentries.tex </span>which contains: + + + +</p> + <div class="verbatim" id="verbatim-49"> +\newglossaryentry{perl}{type=main, + <br />name={Perl}, + <br />description={A scripting language}} + <br />\newglossaryentry{tex}{name={\TeX}, + <br />description={A typesetting language},sort={TeX}} + <br />\newglossaryentry{html}{type=\glsdefaulttype, + <br />name={html}, + <br />description={A mark up language}} +</div> +<!--l. 2199--><p class="nopar" > and suppose in my document preamble I use the command: + + + +</p> + <div class="verbatim" id="verbatim-50"> +\loadglsentries[languages]{myentries} +</div> +<!--l. 2203--><p class="nopar" > then this will add the entries <span +class="ectt-1000">tex </span>and <span +class="ectt-1000">html </span>to the glossary whose type is given by +<span +class="ectt-1000">languages</span>, but the entry <span +class="ectt-1000">perl </span>will be added to the main glossary, since it explicitly +sets the type to <span +class="ectt-1000">main</span>. +</p><!--l. 2209--><p class="indent" > <span +class="ecbx-1000">Note: </span>if you use <span +class="ectt-1000">\newacronym</span><a + id="dx1-24006"></a> (see <a +href="#x1-3900013">§13 </a><a +href="#x1-3900013">Acronyms<!--tex4ht:ref: sec:acronyms --></a>) the type is set as +<span class="obeylines-h"><span class="verb"><span +class="ectt-1000">type=\acronymtype</span></span></span> unless you explicitly override it. For example, if my file +<span +class="ectt-1000">myacronyms.tex </span>contains: + + + +</p> + <div class="verbatim" id="verbatim-51"> +\newacronym{aca}{aca}{a contrived acronym} +</div> +<!--l. 2215--><p class="nopar" > then (supposing I have defined a new glossary type called <span +class="ectt-1000">altacronym</span>) + + + +</p> + <div class="verbatim" id="verbatim-52"> +\loadglsentries[altacronym]{myacronyms} +</div> +<!--l. 2220--><p class="nopar" > will add <span +class="ectt-1000">aca </span>to the glossary type <span +class="ectt-1000">acronym</span>, if the package option <span +class="ecss-1000">acronym</span><a + id="dx1-24007"></a> has been specified, +or will add <span +class="ectt-1000">aca </span>to the glossary type <span +class="ectt-1000">altacronym</span>, if the package option <span +class="ecss-1000">acronym</span><a + id="dx1-24008"></a> is not +specified.<span class="footnote-mark"><a +href="#fn7x0" id="fn7x0-bk"><sup class="textsuperscript">7</sup></a></span><a + id="x1-24009f7"></a> +</p><!--l. 2228--><p class="indent" > If you have used the <span +class="ecss-1000">acronym</span><a + id="dx1-24013"></a> package option, there are two possible solutions to this +problem: + </p><ol class="enumerate1" > + <li + class="enumerate" id="x1-24015x1">Change <span +class="ectt-1000">myacronyms.tex </span>so that entries are defined in the form: + + + + <div class="verbatim" id="verbatim-53"> + \newacronym[type=\glsdefaulttype]{aca}{aca}{a contrived acronym} +</div> + <!--l. 2235--><p class="nopar" > and do: + + + +</p> + <div class="verbatim" id="verbatim-54"> + \loadglsentries[altacronym]{myacronyms} +</div> + <!--l. 2239--><p class="nopar" > + </p></li> + <li + class="enumerate" id="x1-24017x2">Temporarily change <span +class="ectt-1000">\acronymtype </span>to the target glossary: + + + + <div class="verbatim" id="verbatim-55"> + \let\orgacronymtype\acronymtype +  <br />\def\acronymtype{altacronym} +  <br />\loadglsentries{myacronyms} +  <br />\let\acronymtype\orgacronymtype +</div> + <!--l. 2247--><p class="nopar" ></p></li></ol> +<!--l. 2250--><p class="indent" > Note that only those entries that have been used in the text will appear in the +relevant glossaries. Note also that <span +class="ectt-1000">\loadglsentries </span>may only be used in the +preamble. +</p><!--l. 2255--><p class="noindent" > +</p> +<!--l. 2255--><p class="noindent" ><a +href="#top">Top</a></p><h3 class="sectionHead"><span class="titlemark">5 </span> <a + id="x1-250005"></a>Number lists</h3> +<!--l. 2258--><p class="noindent" >Each entry in the glossary has an associated <a + id="dx1-25001"></a><a +href="#glo:numberlist">number list<a + id="dx1-25002"></a></a>. By default, these numbers +refer to the pages on which that entry has been used (using any of the commands +described in <a +href="#x1-260006">§6 </a><a +href="#x1-260006">Links to Glossary Entries<!--tex4ht:ref: sec:glslink --></a> and <a +href="#x1-290007">§7 </a><a +href="#x1-290007">Adding an Entry to the Glossary +Without Generating Text<!--tex4ht:ref: sec:glsadd --></a>). The number list can be suppressed using the <span +class="ecss-1000">nonumberlist</span><a + id="dx1-25003"></a> +package option, or an alternative counter can be set as the default using the +<span +class="ecss-1000">counter</span><a + id="dx1-25004"></a> package option. The number list is also referred to as the location +list<a + id="dx1-25005"></a>. +</p><!--l. 2268--><p class="indent" > Both <a + id="dx1-25006"></a><a +href="#glo:makeindex"><span +class="ectt-1000">makeindex</span><a + id="dx1-25007"></a></a> and <a + id="dx1-25008"></a><a +href="#glo:xindy"><span +class="ectt-1000">xindy</span><a + id="dx1-25009"></a></a> concatenate a sequence of 3 or more consecutive pages +into a range. With <a + id="dx1-25010"></a><span +class="ectt-1000">xindy</span><a + id="dx1-25011"></a> you can vary the minimum sequence length using +<span +class="ectt-1000">\GlsSetXdyMinRangeLength</span><a + id="dx1-25012"></a><span +class="ectt-1000">{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">n</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">} </span>where <span +class="cmsy-10">⟨</span><span +class="ecti-1000">n</span><span +class="cmsy-10">⟩ </span>is either an integer or the keyword <span +class="ectt-1000">none</span> +which indicates that there should be no range formation. +</p><!--l. 2275--><p class="indent" > <div class="important" title="Important Note"> Note that <span +class="ectt-1000">\GlsSetXdyMinRangeLength </span>must be used before <span +class="ectt-1000">\makeglossaries</span><a + id="dx1-25013"></a> and +has no effect if <span +class="ectt-1000">\noist</span><a + id="dx1-25014"></a> is used. </div> +</p><!--l. 2278--><p class="noindent" > +</p><!--l. 2280--><p class="indent" > With both <a + id="dx1-25015"></a><a +href="#glo:makeindex"><span +class="ectt-1000">makeindex</span><a + id="dx1-25016"></a></a> and <a + id="dx1-25017"></a><a +href="#glo:xindy"><span +class="ectt-1000">xindy</span><a + id="dx1-25018"></a></a>, you can replace the separator and the closing +number in the range using: +</p><!--l. 2282--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\glsSetSuffixF</span><span +class="ectt-0900"> </span></span><a + id="dx1-25019"></a> <span +class="ectt-1000">\glsSetSuffixF{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">suffix</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">} </span></div><hr> +</p><!--l. 2284--><p class="noindent" > +</p><!--l. 2285--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\glsSetSuffixFF</span><span +class="ectt-0900"> </span></span><a + id="dx1-25020"></a> <span +class="ectt-1000">\glsSetSuffixFF{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">suffix</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">} </span></div><hr> +</p><!--l. 2287--><p class="noindent" > +where the former command specifies the suffix to use for a 2 page list and the latter +specifies the suffix to use for longer lists. For example: + + + +</p> + <div class="verbatim" id="verbatim-56"> +\glsSetSuffixF{f.} + <br />\glsSetSuffixFF{ff.} +</div> +<!--l. 2294--><p class="nopar" > Note that if you use <a + id="dx1-25021"></a><a +href="#glo:xindy"><span +class="ectt-1000">xindy</span><a + id="dx1-25022"></a></a>, you will also need to set the minimum range length to 1 if +you want to change these suffixes: + + + +</p> + <div class="verbatim" id="verbatim-57"> +\GlsSetXdyMinRangeLength{1} +</div> +<!--l. 2300--><p class="nopar" > Note that if you use the <span +class="ecss-1000">hyperref</span><a + id="dx1-25023"></a> package, you will need to use <span +class="ectt-1000">\nohyperpage</span><a + id="dx1-25024"></a> in the +suffix to ensure that the hyperlinks work correctly. For example: + + + +</p> + <div class="verbatim" id="verbatim-58"> +\glsSetSuffixF{\nohyperpage{f.}} + <br />\glsSetSuffixFF{\nohyperpage{ff.}} +</div> +<!--l. 2307--><p class="nopar" > +</p><!--l. 2309--><p class="indent" > <div class="important" title="Important Note"> Note that <span +class="ectt-1000">\glsSetSuffixF </span>and <span +class="ectt-1000">\glsSetSuffixFF </span>must be used before +<span +class="ectt-1000">\makeglossaries</span><a + id="dx1-25025"></a> and have no effect if <span +class="ectt-1000">\noist</span><a + id="dx1-25026"></a> is used. </div> +</p><!--l. 2313--><p class="noindent" > +</p><!--l. 2316--><p class="noindent" > +</p> +<!--l. 2316--><p class="noindent" ><a +href="#top">Top</a></p><h3 class="sectionHead"><span class="titlemark">6 </span> <a + id="x1-260006"></a>Links to Glossary Entries</h3> +<!--l. 2319--><p class="noindent" >Once you have defined a glossary entry using <span +class="ectt-1000">\newglossaryentry</span><a + id="dx1-26001"></a>, you can refer to that +entry in the document using one of the commands listed in this section. The text which +appears at that point in the document when using one of these commands is referred to +as the <a + id="dx1-26002"></a><a +href="#glo:linktext">link text<a + id="dx1-26003"></a></a> (even if there are no hyperlinks). The commands in this section also add +a line to an external file that is used by <a + id="dx1-26004"></a><a +href="#glo:makeindex"><span +class="ectt-1000">makeindex</span><a + id="dx1-26005"></a></a> or <a + id="dx1-26006"></a><a +href="#glo:xindy"><span +class="ectt-1000">xindy</span><a + id="dx1-26007"></a></a> to generate the relevant +entry in the glossary. This information includes an associated location that +is added to the <a + id="dx1-26008"></a><a +href="#glo:numberlist">number list<a + id="dx1-26009"></a></a> for that entry. By default, the location refers to +the page number. For further information on number lists, see <a +href="#x1-250005">§5 </a><a +href="#x1-250005">Number +lists<!--tex4ht:ref: sec:numberlists --></a>. +</p><!--l. 2331--><p class="indent" > <div class="important" title="Important Note"> It is strongly recommended that you don’t use the commands defined in this section +in the arguments of sectioning or caption commands or any other command that has a +moving argument. </div> +</p><!--l. 2335--><p class="noindent" > +</p><!--l. 2337--><p class="indent" > The above warning is particularly important if you are using the <span +class="ecss-1000">glossaries </span>package +in conjunction with the <span +class="ecss-1000">hyperref</span><a + id="dx1-26010"></a> package. Instead, use one of the commands listed in <a +href="#x1-320009">§9 +</a><a +href="#x1-320009">Using Glossary Terms Without Links<!--tex4ht:ref: sec:glsnolink --></a> (such as <span +class="ectt-1000">\glsentrytext</span><a + id="dx1-26011"></a>) or provide an +alternative via the optional argument to the sectioning/caption command. +Examples: + + + +</p> + <div class="verbatim" id="verbatim-59"> +\section{An overview of \glsentrytext{perl}} + <br />\section[An overview of Perl]{An overview of \gls{perl}} +</div> +<!--l. 2346--><p class="nopar" > +</p><!--l. 2348--><p class="indent" > The way the <a + id="dx1-26012"></a><a +href="#glo:linktext">link text<a + id="dx1-26013"></a></a> is displayed depends on +</p><!--l. 2349--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\glstextformat</span><span +class="ectt-0900"> </span></span><a + id="dx1-26014"></a> <span +class="ectt-1000">\glstextformat{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">text</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">} </span></div><hr> +</p><!--l. 2351--><p class="noindent" > +For example, to make all <a + id="dx1-26015"></a><a +href="#glo:linktext">link text<a + id="dx1-26016"></a></a> appear in a sans-serif font, do: + + + +</p> + <div class="verbatim" id="verbatim-60"> +\renewcommand*{\glstextformat}[1]{\textsf{#1}} +</div> +<!--l. 2356--><p class="nopar" > +</p><!--l. 2358--><p class="indent" > Each entry has an associated conditional referred to as the <a + id="dx1-26017"></a><a +href="#glo:firstuseflag">first use flag</a>. This +determines whether <span +class="ectt-1000">\gls</span><a + id="dx1-26018"></a>, <span +class="ectt-1000">\glspl</span><a + id="dx1-26019"></a> (and their uppercase variants) should use +the value of the <span +class="ecss-1000">first</span><a + id="dx1-26020"></a> or <span +class="ecss-1000">text</span><a + id="dx1-26021"></a> keys. Note that an entry can be used without +affecting the <a + id="dx1-26022"></a><a +href="#glo:firstuseflag">first use flag</a> (for example, when used with <span +class="ectt-1000">\glslink</span>). See <a +href="#x1-4400014">§14 +</a><a +href="#x1-4400014">Unsetting and Resetting Entry Flags<!--tex4ht:ref: sec:glsunset --></a> for commands that unset or reset this +conditional. +</p><!--l. 2366--><p class="indent" > The command: +</p><!--l. 2367--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\glslink</span><span +class="ectt-0900"> </span></span><a + id="dx1-26023"></a> <span +class="ectt-1000">\glslink[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">options</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">]{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">text</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">} </span></div><hr> +</p><!--l. 2369--><p class="noindent" > +will place <span +class="ectt-1000">\glstextformat{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">text</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">} </span>in the document at that point and add a line into +the associated glossary file for the glossary entry given by <span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩</span>. If hyperlinks are +supported, <span +class="cmsy-10">⟨</span><span +class="ecti-1000">text</span><span +class="cmsy-10">⟩ </span>will be a hyperlink to the relevant line in the glossary. (Note that this +command doesn’t affect the <a + id="dx1-26024"></a><a +href="#glo:firstuseflag">first use flag</a>: use <span +class="ectt-1000">\glsdisp</span><a + id="dx1-26025"></a> instead.) The optional +argument <span +class="cmsy-10">⟨</span><span +class="ecti-1000">options</span><span +class="cmsy-10">⟩ </span>must be a <span +class="cmsy-10">⟨</span><span +class="ecti-1000">key</span><span +class="cmsy-10">⟩</span>=<span +class="cmsy-10">⟨</span><span +class="ecti-1000">value</span><span +class="cmsy-10">⟩ </span>list which can take any of the following +keys: +</p><!--l. 2379--><p class="indent" > + </p><dl class="description"><dt class="description"> +<span +class="ecsx-1000">format</span><a + id="dx1-26026"></a> </dt><dd +class="description">This specifies how to format the associated location number for this entry in + the glossary. This value is equivalent to the <a + id="dx1-26027"></a><a +href="#glo:makeindex"><span +class="ectt-1000">makeindex</span><a + id="dx1-26028"></a></a> encap value, + and (as with <span +class="ectt-1000">\index</span><a + id="dx1-26029"></a>) the value needs to be the name of a command + <span +class="ecti-1000">without </span>the initial backslash. As with <span +class="ectt-1000">\index</span><a + id="dx1-26030"></a>, the characters <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">(</span></span></span> and <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">)</span></span></span> can + also be used to specify the beginning and ending of a number range. + Again as with <span +class="ectt-1000">\index</span><a + id="dx1-26031"></a>, the command should be the name of a command + which takes an argument (which will be the associated location). Be + careful not to use a declaration (such as <span +class="ectt-1000">bfseries</span>) instead of a text block + command (such as <span +class="ectt-1000">textbf</span>) as the effect is not guaranteed to be localised. If + you want to apply more than one style to a given entry (e.g. <span +class="ecbx-1000">bold </span>and + <span +class="ecti-1000">italic</span>) you will need to create a command that applies both formats, + e.g.  + + + + <div class="verbatim" id="verbatim-61"> + \newcommand*{\textbfem}[1]{\textbf{\emph{#1}}} +</div> + <!--l. 2396--><p class="nopar" > and use that command. + </p><!--l. 2399--><p class="noindent" >In this document, the standard formats refer to the standard text block + commands such as <span +class="ectt-1000">\textbf</span><a + id="dx1-26032"></a> or <span +class="ectt-1000">\emph</span><a + id="dx1-26033"></a> or any of the commands listed in + <a +href="#x1-260474">table 4</a>. + </p><!--l. 2403--><p class="noindent" ><div class="important" title="Important Note"> If you use <a + id="dx1-26034"></a><a +href="#glo:xindy"><span +class="ectt-1000">xindy</span><a + id="dx1-26035"></a></a> instead of <a + id="dx1-26036"></a><a +href="#glo:makeindex"><span +class="ectt-1000">makeindex</span><a + id="dx1-26037"></a></a>, you must specify any non-standard formats + that you want to use with the <span +class="ecss-1000">format</span><a + id="dx1-26038"></a> key using <span +class="ectt-1000">\GlsAddXdyAttribute</span><a + id="dx1-26039"></a><span +class="ectt-1000">{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">name</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}</span>. + So if you use <a + id="dx1-26040"></a><span +class="ectt-1000">xindy</span><a + id="dx1-26041"></a> with the above example, you would need to add: + + + +</p> + <div class="verbatim" id="verbatim-62"> + \GlsAddXdyAttribute{textbfem} +</div> + <!--l. 2411--><p class="nopar" > See <a +href="#x1-3400011">§11 </a><a +href="#x1-3400011">Xindy<!--tex4ht:ref: sec:xindy --></a> for further details. </div> + </p><!--l. 2413--><p class="noindent" > + </p><!--l. 2415--><p class="noindent" >Note that unlike <span +class="ectt-1000">\index</span><a + id="dx1-26042"></a>, you can’t have anything following the command name, + such as an asterisk or arguments. If you want to cross-reference another entry, + either use the <span +class="ecss-1000">see</span><a + id="dx1-26043"></a> key when you define the entry or use <span +class="ectt-1000">\glssee</span><a + id="dx1-26044"></a> (described in <a +href="#x1-300008">§8 + </a><a +href="#x1-300008">Cross-Referencing Entries<!--tex4ht:ref: sec:crossref --></a>). + </p><!--l. 2422--><p class="noindent" >If you are using hyperlinks and you want to change the font of the hyperlinked + location, don’t use <span +class="ectt-1000">\hyperpage</span><a + id="dx1-26045"></a> (provided by the <span +class="ecss-1000">hyperref</span><a + id="dx1-26046"></a> package) as the + locations may not refer to a page number. Instead, the <span +class="ecss-1000">glossaries </span>package provides + number formats listed in <a +href="#x1-260474">table 4</a>. +</p> + <div class="table"> + <!--l. 2428--><p class="noindent" ><a + id="x1-260474"></a></p><hr class="float" /><div class="float" +> + <div class="caption" +><span class="id">Table 4: </span><span +class="content">Predefined Hyperlinked Location Formats</span></div><!--tex4ht:label?: x1-260474 --> +<div class="tabular"> <table id="TBL-5" class="tabular" +cellspacing="0" cellpadding="0" +><colgroup id="TBL-5-1g"><col +id="TBL-5-1" /><col +id="TBL-5-2" /></colgroup><tr + style="vertical-align:baseline;" id="TBL-5-1-"><td style="white-space:nowrap; text-align:left;" id="TBL-5-1-1" +class="td11"><span +class="ectt-1000">hyperrm</span><a + id="dx1-26048"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-5-1-2" +class="td11">serif hyperlink </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-5-2-"><td style="white-space:nowrap; text-align:left;" id="TBL-5-2-1" +class="td11"><span +class="ectt-1000">hypersf</span><a + id="dx1-26049"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-5-2-2" +class="td11">sans-serif hyperlink </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-5-3-"><td style="white-space:nowrap; text-align:left;" id="TBL-5-3-1" +class="td11"><span +class="ectt-1000">hypertt</span><a + id="dx1-26050"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-5-3-2" +class="td11">monospaced hyperlink </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-5-4-"><td style="white-space:nowrap; text-align:left;" id="TBL-5-4-1" +class="td11"><span +class="ectt-1000">hyperbf</span><a + id="dx1-26051"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-5-4-2" +class="td11">bold hyperlink </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-5-5-"><td style="white-space:nowrap; text-align:left;" id="TBL-5-5-1" +class="td11"><span +class="ectt-1000">hypermd</span><a + id="dx1-26052"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-5-5-2" +class="td11">medium weight hyperlink</td> +</tr><tr + style="vertical-align:baseline;" id="TBL-5-6-"><td style="white-space:nowrap; text-align:left;" id="TBL-5-6-1" +class="td11"><span +class="ectt-1000">hyperit</span><a + id="dx1-26053"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-5-6-2" +class="td11">italic hyperlink </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-5-7-"><td style="white-space:nowrap; text-align:left;" id="TBL-5-7-1" +class="td11"><span +class="ectt-1000">hypersl</span><a + id="dx1-26054"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-5-7-2" +class="td11">slanted hyperlink </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-5-8-"><td style="white-space:nowrap; text-align:left;" id="TBL-5-8-1" +class="td11"><span +class="ectt-1000">hyperup</span><a + id="dx1-26055"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-5-8-2" +class="td11">upright hyperlink </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-5-9-"><td style="white-space:nowrap; text-align:left;" id="TBL-5-9-1" +class="td11"><span +class="ectt-1000">hypersc</span><a + id="dx1-26056"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-5-9-2" +class="td11">small caps hyperlink </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-5-10-"><td style="white-space:nowrap; text-align:left;" id="TBL-5-10-1" +class="td11"><span +class="ectt-1000">hyperemph</span><a + id="dx1-26057"></a></td><td style="white-space:nowrap; text-align:left;" id="TBL-5-10-2" +class="td11">emphasized hyperlink </td></tr></table> +</div> + </div><hr class="endfloat" /> + </div> + <!--l. 2448--><p class="noindent" >Note that if the <span +class="ectt-1000">\hyperlink</span><a + id="dx1-26058"></a> command hasn’t been defined, the <span +class="ectt-1000">hyper</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">xx</span><span +class="cmsy-10">⟩</span> + formats are equivalent to the analogous <span +class="ectt-1000">text</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">xx</span><span +class="cmsy-10">⟩ </span>font commands (and <span +class="ectt-1000">hyperemph</span> + is equivalent to <span +class="ectt-1000">emph</span>). If you want to make a new format, you will need to define + a command which takes one argument and use that. For example, if you want the + location number to be in a bold sans-serif font, you can define a command called, + say, <span +class="ectt-1000">\hyperbsf</span><a + id="dx1-26059"></a>: + + + +</p> + <div class="verbatim" id="verbatim-63"> + \newcommand{\hyperbsf}[1]{\textbf{\hypersf{#1}}} +</div> + <!--l. 2458--><p class="nopar" > and then use <span +class="ectt-1000">hyperbsf </span>as the value for the <span +class="ecss-1000">format</span><a + id="dx1-26060"></a> key. (See also “Displaying + the glossary” in the documented code, <span +class="ectt-1000">glossaries.pdf</span>.) Remember + that if you use <a + id="dx1-26061"></a><a +href="#glo:xindy"><span +class="ectt-1000">xindy</span><a + id="dx1-26062"></a></a>, you will need to add this to the list of location + attributes: + + + +</p> + <div class="verbatim" id="verbatim-64"> + \GlsAddXdyAttribute{hyperbsf} +</div> + <!--l. 2466--><p class="nopar" > + </p></dd><dt class="description"> +<span +class="ecsx-1000">counter</span><a + id="dx1-26063"></a> </dt><dd +class="description">This specifies which counter to use for this location. This overrides the default + counter used by this entry. (See also <a +href="#x1-250005">§5 </a><a +href="#x1-250005">Number lists<!--tex4ht:ref: sec:numberlists --></a>.) + </dd><dt class="description"> +<span +class="ecsx-1000">hyper</span><a + id="dx1-26064"></a> </dt><dd +class="description">This is a boolean key which can be used to enable/disable the hyperlink to + the relevant entry in the glossary. (Note that setting <span +class="ectt-1000">hyper=true </span>will + have no effect if <span +class="ectt-1000">\hyperlink</span><a + id="dx1-26065"></a> has not been defined.) The default value is + <span +class="ectt-1000">hyper=true</span>. + </dd></dl> +<!--l. 2479--><p class="noindent" >There is also a starred version: +</p><!--l. 2480--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\glslink*</span><span +class="ectt-0900"> </span></span><a + id="dx1-26066"></a> <span +class="ectt-1000">\glslink*[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">options</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">]{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">text</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">} </span></div><hr> +</p><!--l. 2482--><p class="noindent" > +which is equivalent to <span +class="ectt-1000">\glslink</span>, except it sets <span +class="ectt-1000">hyper=false</span>. Similarly, all the following +commands described in this section also have a starred version that disables the +hyperlink. +</p><!--l. 2488--><p class="indent" > <div class="important" title="Important Note"> Don’t use commands like <span +class="ectt-1000">\glslink </span>or <span +class="ectt-1000">\gls </span>in the <span +class="cmsy-10">⟨</span><span +class="ecti-1000">text</span><span +class="cmsy-10">⟩ </span>argument of <span +class="ectt-1000">\glslink</span>. +</div> +</p><!--l. 2491--><p class="noindent" > +</p><!--l. 2493--><p class="indent" > The command: +</p><!--l. 2494--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\gls</span><span +class="ectt-0900"> </span></span><a + id="dx1-26067"></a> <span +class="ectt-1000">\gls[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">options</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">]{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">insert</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">] </span></div><hr> +</p><!--l. 2496--><p class="noindent" > +is the same as <span +class="ectt-1000">\glslink</span>, except that the <a + id="dx1-26068"></a><a +href="#glo:linktext">link text<a + id="dx1-26069"></a></a> is determined from the values of the +<span +class="ecss-1000">text</span><a + id="dx1-26070"></a> and <span +class="ecss-1000">first</span><a + id="dx1-26071"></a> keys supplied when the entry was defined using <span +class="ectt-1000">\newglossaryentry</span><a + id="dx1-26072"></a>. If +the entry has been marked as having been used<a + id="dx1-26073"></a>, the value of the <span +class="ecss-1000">text</span><a + id="dx1-26074"></a> key will be used, +otherwise the value of the <span +class="ecss-1000">first</span><a + id="dx1-26075"></a> key will be used. On completion, <span +class="ectt-1000">\gls </span>will mark the +entry’s <a + id="dx1-26076"></a><a +href="#glo:firstuseflag">first use flag</a> as used. +</p><!--l. 2506--><p class="indent" > There are two uppercase variants: +</p><!--l. 2507--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\Gls</span><span +class="ectt-0900"> </span></span><a + id="dx1-26077"></a> <span +class="ectt-1000">\Gls[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">options</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">]{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">insert</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">] </span></div><hr> +</p><!--l. 2509--><p class="noindent" > +and +</p><!--l. 2511--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\GLS</span><span +class="ectt-0900"> </span></span><a + id="dx1-26078"></a> <span +class="ectt-1000">\GLS[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">options</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">]{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">insert</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">] </span></div><hr> +</p><!--l. 2513--><p class="noindent" > +which make the first letter of the link text or all the link text uppercase, respectively. + + + +</p><!--l. 2517--><p class="indent" > The final optional argument <span +class="cmsy-10">⟨</span><span +class="ecti-1000">insert</span><span +class="cmsy-10">⟩</span>, allows you to insert some additional +text into the link text. By default, this will append <span +class="cmsy-10">⟨</span><span +class="ecti-1000">insert</span><span +class="cmsy-10">⟩ </span>at the end of the +link text, but this can be changed (see <a +href="#x1-270006.1">§6.1 </a><a +href="#x1-270006.1">Changing the format of the link +text<!--tex4ht:ref: sec:glsdisplay --></a>). +</p><!--l. 2522--><p class="indent" > The first optional argument <span +class="cmsy-10">⟨</span><span +class="ecti-1000">options</span><span +class="cmsy-10">⟩ </span>is the same as the optional argument to +<span +class="ectt-1000">\glslink</span><a + id="dx1-26079"></a>. As with <span +class="ectt-1000">\glslink</span><a + id="dx1-26080"></a>, these commands also have a starred version that disable +the hyperlink. +</p><!--l. 2526--><p class="indent" > <div class="important" title="Important Note"> Don’t use commands like <span +class="ectt-1000">\glslink </span>or <span +class="ectt-1000">\gls </span>in the <span +class="cmsy-10">⟨</span><span +class="ecti-1000">insert</span><span +class="cmsy-10">⟩ </span>argument of <span +class="ectt-1000">\gls </span>and +its variants. </div> +</p><!--l. 2529--><p class="noindent" > +</p><!--l. 2531--><p class="indent" > There are also analogous plural forms: +</p><!--l. 2532--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\glspl</span><span +class="ectt-0900"> </span></span><a + id="dx1-26081"></a> <span +class="ectt-1000">\glspl[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">options</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">]{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">insert</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">] </span></div><hr> +</p><!--l. 2534--><p class="noindent" > +</p><!--l. 2535--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\Glspl</span><span +class="ectt-0900"> </span></span><a + id="dx1-26082"></a> <span +class="ectt-1000">\Glspl[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">options</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">]{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">insert</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">] </span></div><hr> +</p><!--l. 2537--><p class="noindent" > +</p><!--l. 2538--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\GLSpl</span><span +class="ectt-0900"> </span></span><a + id="dx1-26083"></a> <span +class="ectt-1000">\GLSpl[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">options</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">]{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">insert</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">] </span></div><hr> +</p><!--l. 2540--><p class="noindent" > +These determine the link text from the <span +class="ecss-1000">plural</span><a + id="dx1-26084"></a> and <span +class="ecss-1000">firstplural</span><a + id="dx1-26085"></a> keys supplied when the +entry was first defined. As before, these commands also have a starred version that +disable the hyperlink. +</p><!--l. 2546--><p class="indent" > <div class="important" title="Important Note"> Be careful when you use glossary entries in math mode especially if you are using +<span +class="ecss-1000">hyperref</span><a + id="dx1-26086"></a> as it can affect the spacing of subscripts and superscripts. For example, +suppose you have defined the following entry: + + + +</p> + <div class="verbatim" id="verbatim-65"> +\newglossaryentry{Falpha}{name={F_\alpha},description=sample} +</div> +<!--l. 2553--><p class="nopar" > and later you use it in math mode: + + + +</p> + <div class="verbatim" id="verbatim-66"> +$\gls{Falpha}^2$ +</div> +<!--l. 2557--><p class="nopar" > This will result in <span +class="cmmi-10">F</span><sub><span +class="cmmi-7">α</span></sub><sup><span +class="cmr-7">2</span></sup> instead of <span +class="cmmi-10">F</span><sub><span +class="cmmi-7">α</span></sub><sup><span +class="cmr-7">2</span></sup>. In this situation it’s best to bring the +superscript into the hyperlink using the final <span +class="cmsy-10">⟨</span><span +class="ecti-1000">insert</span><span +class="cmsy-10">⟩ </span>optional argument: + + + +</p> + <div class="verbatim" id="verbatim-67"> +$\gls{Falpha}[^2]$ +</div> +<!--l. 2563--><p class="nopar" > </div> +</p><!--l. 2564--><p class="noindent" > +</p><!--l. 2566--><p class="indent" > Note that <span +class="ectt-1000">\glslink</span><a + id="dx1-26087"></a> doesn’t use or affect the <a + id="dx1-26088"></a><a +href="#glo:firstuseflag">first use flag</a>, nor does it use +<span +class="ectt-1000">\glsdisplay</span><a + id="dx1-26089"></a> or <span +class="ectt-1000">\glsdisplayfirst</span><a + id="dx1-26090"></a> (see <a +href="#x1-270006.1">§6.1 </a><a +href="#x1-270006.1">Changing the format of the link text<!--tex4ht:ref: sec:glsdisplay --></a>). +Instead, you can use: +</p><!--l. 2569--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\glsdisp</span><span +class="ectt-0900"> </span></span><a + id="dx1-26091"></a> <span +class="ectt-1000">\glsdisp[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">options</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">]{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">link text</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">} </span></div><hr> +</p><!--l. 2571--><p class="noindent" > +This behaves in the same way as <span +class="ectt-1000">\gls</span><a + id="dx1-26092"></a>, except that it uses <span +class="cmsy-10">⟨</span><span +class="ecti-1000">link text</span><span +class="cmsy-10">⟩ </span>instead of the +value of the <span +class="ecss-1000">first</span><a + id="dx1-26093"></a> or <span +class="ecss-1000">text</span><a + id="dx1-26094"></a> key. (Note that this command always sets <span +class="cmsy-10">⟨</span><span +class="ecti-1000">insert</span><span +class="cmsy-10">⟩ </span>to +nothing.) This command affects the <a + id="dx1-26095"></a><a +href="#glo:firstuseflag">first use flag</a>, and uses <span +class="ectt-1000">\glsdisplay</span><a + id="dx1-26096"></a> or +<span +class="ectt-1000">\glsdisplayfirst</span><a + id="dx1-26097"></a>. +</p><!--l. 2578--><p class="indent" > The command: +</p><!--l. 2579--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\glstext</span><span +class="ectt-0900"> </span></span><a + id="dx1-26098"></a> <span +class="ectt-1000">\glstext[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">options</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">]{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">insert</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">] </span></div><hr> +</p><!--l. 2581--><p class="noindent" > +is similar to <span +class="ectt-1000">\gls</span><a + id="dx1-26099"></a> except that it always uses the value of the <span +class="ecss-1000">text</span><a + id="dx1-26100"></a> key and +does not affect the <a + id="dx1-26101"></a><a +href="#glo:firstuseflag">first use flag</a>. Unlike <span +class="ectt-1000">\gls</span>, the inserted text <span +class="cmsy-10">⟨</span><span +class="ecti-1000">insert</span><span +class="cmsy-10">⟩ </span>is +always appended to the link text since <span +class="ectt-1000">\glstext </span>doesn’t use <span +class="ectt-1000">\glsdisplay</span><a + id="dx1-26102"></a> or +<span +class="ectt-1000">\glsdisplayfirst</span><a + id="dx1-26103"></a>. (The same is true for all the following commands described in this +section.) +</p><!--l. 2590--><p class="indent" > There are also analogous commands: +</p><!--l. 2591--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\Glstext</span><span +class="ectt-0900"> </span></span><a + id="dx1-26104"></a> <span +class="ectt-1000">\Glstext[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">options</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">]{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">text</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">insert</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">] </span></div><hr> +</p><!--l. 2593--><p class="noindent" > +</p><!--l. 2594--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\GLStext</span><span +class="ectt-0900"> </span></span><a + id="dx1-26105"></a> <span +class="ectt-1000">\GLStext[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">options</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">]{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">text</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">insert</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">] </span></div><hr> +</p><!--l. 2596--><p class="noindent" > +As before, these commands also have a starred version that disable the hyperlink. +</p><!--l. 2600--><p class="indent" > The command: +</p><!--l. 2601--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\glsfirst</span><span +class="ectt-0900"> </span></span><a + id="dx1-26106"></a> <span +class="ectt-1000">\glsfirst[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">options</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">]{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">insert</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">] </span></div><hr> +</p><!--l. 2603--><p class="noindent" > +is similar to <span +class="ectt-1000">\glstext </span>except that it always uses the value of the <span +class="ecss-1000">first</span><a + id="dx1-26107"></a> key. Again, +<span +class="cmsy-10">⟨</span><span +class="ecti-1000">insert</span><span +class="cmsy-10">⟩ </span>is always appended to the end of the link text and does not affect the <a + id="dx1-26108"></a><a +href="#glo:firstuseflag">first use +flag</a>. +</p><!--l. 2609--><p class="indent" > There are also analogous commands: +</p><!--l. 2610--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\Glsfirst</span><span +class="ectt-0900"> </span></span><a + id="dx1-26109"></a> <span +class="ectt-1000">\Glsfirst[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">options</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">]{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">text</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">insert</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">] </span></div><hr> +</p><!--l. 2612--><p class="noindent" > +</p><!--l. 2613--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\GLSfirst</span><span +class="ectt-0900"> </span></span><a + id="dx1-26110"></a> <span +class="ectt-1000">\GLSfirst[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">options</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">]{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">text</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">insert</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">] </span></div><hr> +</p><!--l. 2615--><p class="noindent" > +As before, these commands also have a starred version that disable the hyperlink. + + + +</p><!--l. 2619--><p class="indent" > The command: +</p><!--l. 2620--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\glsplural</span><span +class="ectt-0900"> </span></span><a + id="dx1-26111"></a> <span +class="ectt-1000">\glsplural[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">options</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">]{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">insert</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">] </span></div><hr> +</p><!--l. 2622--><p class="noindent" > +is similar to <span +class="ectt-1000">\glstext</span><a + id="dx1-26112"></a> except that it always uses the value of the <span +class="ecss-1000">plural</span><a + id="dx1-26113"></a> key. Again, +<span +class="cmsy-10">⟨</span><span +class="ecti-1000">insert</span><span +class="cmsy-10">⟩ </span>is always appended to the end of the link text and does not mark the entry as +having been used. +</p><!--l. 2628--><p class="indent" > There are also analogous commands: +</p><!--l. 2629--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\Glsplural</span><span +class="ectt-0900"> </span></span><a + id="dx1-26114"></a> <span +class="ectt-1000">\Glsplural[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">options</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">]{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">text</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">insert</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">] </span></div><hr> +</p><!--l. 2631--><p class="noindent" > +</p><!--l. 2632--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\GLSplural</span><span +class="ectt-0900"> </span></span><a + id="dx1-26115"></a> <span +class="ectt-1000">\GLSplural[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">options</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">]{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">text</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">insert</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">] </span></div><hr> +</p><!--l. 2634--><p class="noindent" > +As before, these commands also have a starred version that disable the hyperlink. +</p><!--l. 2638--><p class="indent" > The command: +</p><!--l. 2639--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\glsfirstplural</span><span +class="ectt-0900"> </span></span><a + id="dx1-26116"></a> <span +class="ectt-1000">\glsfirstplural[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">options</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">]{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">insert</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">] </span></div><hr> +</p><!--l. 2641--><p class="noindent" > +is similar to <span +class="ectt-1000">\glstext</span><a + id="dx1-26117"></a> except that it always uses the value of the <span +class="ecss-1000">firstplural</span><a + id="dx1-26118"></a> key. Again, +<span +class="cmsy-10">⟨</span><span +class="ecti-1000">insert</span><span +class="cmsy-10">⟩ </span>is always appended to the end of the link text and does not mark the entry as +having been used. +</p><!--l. 2647--><p class="indent" > There are also analogous commands: +</p><!--l. 2648--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\Glsfirstplural</span><span +class="ectt-0900"> </span></span><a + id="dx1-26119"></a> <span +class="ectt-1000">\Glsfirstplural[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">options</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">]{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">text</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">insert</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">] </span></div><hr> +</p><!--l. 2650--><p class="noindent" > +</p><!--l. 2651--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\GLSfirstplural</span><span +class="ectt-0900"> </span></span><a + id="dx1-26120"></a> <span +class="ectt-1000">\GLSfirstplural[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">options</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">]{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">text</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">insert</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">] </span></div><hr> +</p><!--l. 2653--><p class="noindent" > +As before, these commands also have a starred version that disable the hyperlink. +</p><!--l. 2657--><p class="indent" > The command: +</p><!--l. 2658--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\glsname</span><span +class="ectt-0900"> </span></span><a + id="dx1-26121"></a> <span +class="ectt-1000">\glsname[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">options</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">]{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">insert</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">] </span></div><hr> +</p><!--l. 2660--><p class="noindent" > +is similar to <span +class="ectt-1000">\glstext</span><a + id="dx1-26122"></a> except that it always uses the value of the <span +class="ecss-1000">name</span><a + id="dx1-26123"></a> key. Again, +<span +class="cmsy-10">⟨</span><span +class="ecti-1000">insert</span><span +class="cmsy-10">⟩ </span>is always appended to the end of the link text and does not mark the entry as +having been used. Note: if you want to use this command and the <span +class="ecss-1000">name</span><a + id="dx1-26124"></a> key contains +commands, you will have to disable the <a + id="dx1-26125"></a><a +href="#glo:sanitize">sanitization<a + id="dx1-26126"></a></a> of the <span +class="ecss-1000">name</span><a + id="dx1-26127"></a> key and protect fragile +commands. +</p><!--l. 2669--><p class="indent" > There are also analogous commands: +</p><!--l. 2670--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\Glsname</span><span +class="ectt-0900"> </span></span><a + id="dx1-26128"></a> <span +class="ectt-1000">\Glsname[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">options</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">]{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">text</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">insert</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">] </span></div><hr> +</p><!--l. 2672--><p class="noindent" > +</p><!--l. 2673--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\GLSname</span><span +class="ectt-0900"> </span></span><a + id="dx1-26129"></a> <span +class="ectt-1000">\GLSname[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">options</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">]{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">text</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">insert</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">] </span></div><hr> +</p><!--l. 2675--><p class="noindent" > +As before, these commands also have a starred version that disable the hyperlink. +</p><!--l. 2679--><p class="indent" > The command: +</p><!--l. 2680--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\glssymbol</span><span +class="ectt-0900"> </span></span><a + id="dx1-26130"></a> <span +class="ectt-1000">\glssymbol[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">options</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">]{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">insert</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">] </span></div><hr> +</p><!--l. 2682--><p class="noindent" > +is similar to <span +class="ectt-1000">\glstext</span><a + id="dx1-26131"></a> except that it always uses the value of the <span +class="ecss-1000">symbol</span><a + id="dx1-26132"></a> key. Again, +<span +class="cmsy-10">⟨</span><span +class="ecti-1000">insert</span><span +class="cmsy-10">⟩ </span>is always appended to the end of the link text and does not mark the entry as + + + +having been used. Note: if you want to use this command and the <span +class="ecss-1000">symbol</span><a + id="dx1-26133"></a> key contains +commands, you will have to disable the <a + id="dx1-26134"></a><a +href="#glo:sanitize">sanitization<a + id="dx1-26135"></a></a> of the <span +class="ecss-1000">symbol</span><a + id="dx1-26136"></a> key and protect +fragile commands. +</p><!--l. 2691--><p class="indent" > There are also analogous commands: +</p><!--l. 2692--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\Glssymbol</span><span +class="ectt-0900"> </span></span><a + id="dx1-26137"></a> <span +class="ectt-1000">\Glssymbol[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">options</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">]{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">text</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">insert</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">] </span></div><hr> +</p><!--l. 2694--><p class="noindent" > +</p><!--l. 2695--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\GLSsymbol</span><span +class="ectt-0900"> </span></span><a + id="dx1-26138"></a> <span +class="ectt-1000">\GLSsymbol[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">options</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">]{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">text</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">insert</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">] </span></div><hr> +</p><!--l. 2697--><p class="noindent" > +As before, these commands also have a starred version that disable the hyperlink. +</p><!--l. 2701--><p class="indent" > The command: +</p><!--l. 2702--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\glsdesc</span><span +class="ectt-0900"> </span></span><a + id="dx1-26139"></a> <span +class="ectt-1000">\glsdesc[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">options</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">]{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">insert</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">] </span></div><hr> +</p><!--l. 2704--><p class="noindent" > +is similar to <span +class="ectt-1000">\glstext</span><a + id="dx1-26140"></a> except that it always uses the value of the <span +class="ecss-1000">description</span><a + id="dx1-26141"></a> key. Again, +<span +class="cmsy-10">⟨</span><span +class="ecti-1000">insert</span><span +class="cmsy-10">⟩ </span>is always appended to the end of the link text and does not mark the entry as +having been used. Note: if you want to use this command and the <span +class="ecss-1000">description</span><a + id="dx1-26142"></a> key +contains commands, you will have to disable the <a + id="dx1-26143"></a><a +href="#glo:sanitize">sanitization<a + id="dx1-26144"></a></a> of the <span +class="ecss-1000">description</span><a + id="dx1-26145"></a> key and +protect fragile commands. +</p><!--l. 2713--><p class="indent" > There are also analogous commands: +</p><!--l. 2714--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\Glsdesc</span><span +class="ectt-0900"> </span></span><a + id="dx1-26146"></a> <span +class="ectt-1000">\Glsdesc[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">options</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">]{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">text</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">insert</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">] </span></div><hr> +</p><!--l. 2716--><p class="noindent" > +</p><!--l. 2717--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\GLSdesc</span><span +class="ectt-0900"> </span></span><a + id="dx1-26147"></a> <span +class="ectt-1000">\GLSdesc[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">options</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">]{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">text</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">insert</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">] </span></div><hr> +</p><!--l. 2719--><p class="noindent" > +As before, these commands also have a starred version that disable the hyperlink. +</p><!--l. 2723--><p class="indent" > The command: +</p><!--l. 2724--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\glsuseri</span><span +class="ectt-0900"> </span></span><a + id="dx1-26148"></a> <span +class="ectt-1000">\glsuseri[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">options</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">]{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">insert</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">] </span></div><hr> +</p><!--l. 2726--><p class="noindent" > +is similar to <span +class="ectt-1000">\glstext</span><a + id="dx1-26149"></a> except that it always uses the value of the <span +class="ecss-1000">user1</span><a + id="dx1-26150"></a> key. Again, +<span +class="cmsy-10">⟨</span><span +class="ecti-1000">insert</span><span +class="cmsy-10">⟩ </span>is always appended to the end of the link text and does not mark the entry as +having been used. +</p><!--l. 2732--><p class="indent" > There are also analogous commands: +</p><!--l. 2733--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\Glsuseri</span><span +class="ectt-0900"> </span></span><a + id="dx1-26151"></a> <span +class="ectt-1000">\Glsuseri[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">options</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">]{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">text</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">insert</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">] </span></div><hr> +</p><!--l. 2735--><p class="noindent" > +</p><!--l. 2736--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\GLSuseri</span><span +class="ectt-0900"> </span></span><a + id="dx1-26152"></a> <span +class="ectt-1000">\GLSuseri[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">options</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">]{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">text</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">insert</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">] </span></div><hr> +</p><!--l. 2738--><p class="noindent" > +As before, these commands also have a starred version that disable the hyperlink. +Similarly for the other user keys: +</p><!--l. 2741--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\glsuserii</span><span +class="ectt-0900"> </span></span><a + id="dx1-26153"></a> <span +class="ectt-1000">\glsuserii[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">options</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">]{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">text</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">insert</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">] </span></div><hr> +</p><!--l. 2743--><p class="noindent" > +</p><!--l. 2744--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\Glsuserii</span><span +class="ectt-0900"> </span></span><a + id="dx1-26154"></a> <span +class="ectt-1000">\Glsuserii[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">options</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">]{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">text</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">insert</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">] </span></div><hr> +</p><!--l. 2746--><p class="noindent" > +</p><!--l. 2747--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\GLSuserii</span><span +class="ectt-0900"> </span></span><a + id="dx1-26155"></a> <span +class="ectt-1000">\GLSuserii[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">options</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">]{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">text</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">insert</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">] </span></div><hr> + + + +</p><!--l. 2749--><p class="noindent" > +</p><!--l. 2750--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\glsuseriii</span><span +class="ectt-0900"> </span></span><a + id="dx1-26156"></a> <span +class="ectt-1000">\glsuseriii[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">options</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">]{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">text</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">insert</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">] </span></div><hr> +</p><!--l. 2752--><p class="noindent" > +</p><!--l. 2753--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\Glsuseriii</span><span +class="ectt-0900"> </span></span><a + id="dx1-26157"></a> <span +class="ectt-1000">\Glsuseriii[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">options</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">]{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">text</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">insert</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">] </span></div><hr> +</p><!--l. 2755--><p class="noindent" > +</p><!--l. 2756--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\GLSuseriii</span><span +class="ectt-0900"> </span></span><a + id="dx1-26158"></a> <span +class="ectt-1000">\GLSuseriii[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">options</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">]{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">text</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">insert</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">] </span></div><hr> +</p><!--l. 2758--><p class="noindent" > +</p><!--l. 2759--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\glsuseriv</span><span +class="ectt-0900"> </span></span><a + id="dx1-26159"></a> <span +class="ectt-1000">\glsuseriv[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">options</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">]{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">text</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">insert</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">] </span></div><hr> +</p><!--l. 2761--><p class="noindent" > +</p><!--l. 2762--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\Glsuseriv</span><span +class="ectt-0900"> </span></span><a + id="dx1-26160"></a> <span +class="ectt-1000">\Glsuseriv[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">options</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">]{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">text</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">insert</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">] </span></div><hr> +</p><!--l. 2764--><p class="noindent" > +</p><!--l. 2765--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\GLSuseriv</span><span +class="ectt-0900"> </span></span><a + id="dx1-26161"></a> <span +class="ectt-1000">\GLSuseriv[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">options</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">]{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">text</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">insert</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">] </span></div><hr> +</p><!--l. 2767--><p class="noindent" > +</p><!--l. 2768--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\glsuserv</span><span +class="ectt-0900"> </span></span><a + id="dx1-26162"></a> <span +class="ectt-1000">\glsuserv[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">options</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">]{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">text</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">insert</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">] </span></div><hr> +</p><!--l. 2770--><p class="noindent" > +</p><!--l. 2771--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\Glsuserv</span><span +class="ectt-0900"> </span></span><a + id="dx1-26163"></a> <span +class="ectt-1000">\Glsuserv[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">options</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">]{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">text</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">insert</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">] </span></div><hr> +</p><!--l. 2773--><p class="noindent" > +</p><!--l. 2774--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\GLSuserv</span><span +class="ectt-0900"> </span></span><a + id="dx1-26164"></a> <span +class="ectt-1000">\GLSuserv[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">options</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">]{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">text</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">insert</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">] </span></div><hr> +</p><!--l. 2776--><p class="noindent" > +</p><!--l. 2777--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\glsuservi</span><span +class="ectt-0900"> </span></span><a + id="dx1-26165"></a> <span +class="ectt-1000">\glsuservi[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">options</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">]{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">text</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">insert</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">] </span></div><hr> +</p><!--l. 2779--><p class="noindent" > +</p><!--l. 2780--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\Glsuservi</span><span +class="ectt-0900"> </span></span><a + id="dx1-26166"></a> <span +class="ectt-1000">\Glsuservi[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">options</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">]{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">text</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">insert</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">] </span></div><hr> +</p><!--l. 2782--><p class="noindent" > +</p><!--l. 2783--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\GLSuservi</span><span +class="ectt-0900"> </span></span><a + id="dx1-26167"></a> <span +class="ectt-1000">\GLSuservi[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">options</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">]{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">text</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">insert</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">] </span></div><hr> +</p><!--l. 2785--><p class="noindent" > +</p><!--l. 2787--><p class="noindent" > +</p> +<!--l. 2787--><p class="noindent" ><a +href="#top">Top</a></p><h4 class="subsectionHead"><span class="titlemark">6.1 </span> <a + id="x1-270006.1"></a>Changing the format of the link text</h4> +<!--l. 2790--><p class="noindent" >The format of the <a + id="dx1-27001"></a><a +href="#glo:linktext">link text<a + id="dx1-27002"></a></a> for <span +class="ectt-1000">\gls</span><a + id="dx1-27003"></a>, <span +class="ectt-1000">\glspl</span><a + id="dx1-27004"></a> and their uppercase variants is governed +by two commands: + + + +</p><!--l. 2792--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\glsdisplayfirst</span><span +class="ectt-0900"> </span></span><a + id="dx1-27005"></a> <span +class="ectt-1000">\glsdisplayfirst{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">first/first plural</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">description</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">symbol</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">insert</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}</span> +</div><hr> +</p><!--l. 2794--><p class="noindent" > +which is used the <a + id="dx1-27006"></a><a +href="#glo:firstuse">first time</a> a glossary entry is used in the text and +</p><!--l. 2797--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\glsdisplay</span><span +class="ectt-0900"> </span></span><a + id="dx1-27007"></a> <span +class="ectt-1000">\glsdisplay{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">text/plural</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">description</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">symbol</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">insert</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}</span> +</div><hr> +</p><!--l. 2799--><p class="noindent" > +which is used subsequently. Both commands take four arguments: the first is either the +singular or plural form given by the <span +class="ecss-1000">text</span><a + id="dx1-27008"></a>, <span +class="ecss-1000">plural</span><a + id="dx1-27009"></a>, <span +class="ecss-1000">first</span><a + id="dx1-27010"></a> or <span +class="ecss-1000">firstplural</span><a + id="dx1-27011"></a> keys (set when the +term was defined) depending on context; the second argument is the term’s +description (as supplied by the <span +class="ecss-1000">description</span><a + id="dx1-27012"></a> or <span +class="ecss-1000">descriptionplural</span><a + id="dx1-27013"></a> keys); the third +argument is the symbol associated with the term (as supplied by the <span +class="ecss-1000">symbol</span><a + id="dx1-27014"></a> or +<span +class="ecss-1000">symbolplural</span><a + id="dx1-27015"></a> keys) and the fourth argument is the additional text supplied in the final +optional argument to <span +class="ectt-1000">\gls</span><a + id="dx1-27016"></a> or <span +class="ectt-1000">\glspl</span><a + id="dx1-27017"></a> (or their uppercase variants). The default +definitions of <span +class="ectt-1000">\glsdisplay </span>and <span +class="ectt-1000">\glsdisplayfirst </span>simply print the first argument +immediately followed by the fourth argument. The remaining arguments are +ignored. +</p><!--l. 2815--><p class="indent" > <div class="important" title="Important Note"> Care needs to be taken when redefining <span +class="ectt-1000">\glsdisplay </span>and <span +class="ectt-1000">\glsdisplayfirst </span>as +commands like <span +class="ectt-1000">\Gls</span><a + id="dx1-27018"></a> will expand the displayed text before applying <span +class="ectt-1000">\makefirstuc</span><a + id="dx1-27019"></a>. If +you want to use formatting commands, it’s best to define a robust version that deals +with all the formatting. For example, suppose you want the text to appear in bold +italic, it’s best to do something like: + + + +</p> + <div class="verbatim" id="verbatim-68"> +\DeclareRobustCommand{\textbfit}[1]{\emph{\bfseries #1}} + <br />\renewcommand{\glsdisplay}[4]{\textbfit{#1#4}} +</div> +<!--l. 2825--><p class="nopar" > See the <span +class="ecss-1000">mfirstuc</span><a + id="dx1-27020"></a> documentation for further details on the limitations of <span +class="ectt-1000">\makefirstuc</span><a + id="dx1-27021"></a>. +</div> +</p><!--l. 2828--><p class="noindent" > +</p><!--l. 2830--><p class="indent" > If required, you can access the label for the given entry via +</p><!--l. 2831--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\glslabel</span><span +class="ectt-0900"> </span></span><a + id="dx1-27022"></a> <span +class="ectt-1000">\glslabel </span></div><hr> +</p><!--l. 2833--><p class="noindent" > +so it is possible to use this label in the definition of <span +class="ectt-1000">\glsdisplay </span>or <span +class="ectt-1000">\glsdisplayfirst</span> +to supply additional information using any of the commands described in <a +href="#x1-320009">§9 </a><a +href="#x1-320009">Using +Glossary Terms Without Links<!--tex4ht:ref: sec:glsnolink --></a>, if required. +</p><!--l. 2839--><p class="indent" > Note that <span +class="ectt-1000">\glsdisplay </span>and <span +class="ectt-1000">\glsdisplayfirst </span>are not used by <span +class="ectt-1000">\glslink</span><a + id="dx1-27023"></a>. If you +want to supply your own link text, you need to use <span +class="ectt-1000">\glsdisp</span><a + id="dx1-27024"></a> instead. +</p><!--l. 2843--><p class="indent" > For example, suppose you want a glossary of measurements and units, you can use +the <span +class="ecss-1000">symbol</span><a + id="dx1-27025"></a> key to store the unit: + + + +</p> + <div class="verbatim" id="verbatim-69"> +\newglossaryentry{distance}{name=distance, + <br />description={The length between two points}, + <br />symbol={km}} +</div> +<!--l. 2849--><p class="nopar" > and now suppose you want <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\gls{distance}</span></span></span> to produce “distance (km)” on <a + id="dx1-27026"></a><a +href="#glo:firstuse">first use</a>, +then you can redefine <span +class="ectt-1000">\glsdisplayfirst </span>as follows: + + + +</p> + <div class="verbatim" id="verbatim-70"> +\renewcommand{\glsdisplayfirst}[4]{#1#4 (#3)} +</div> +<!--l. 2855--><p class="nopar" > Note that the additional text is placed after <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">#1</span></span></span>, so <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\gls{distance}[’s]</span></span></span> will +produce “distance’s (km)” rather than “distance (km)’s” which looks a bit +odd (even though it may be in the context of “the distance (km) is measured +between the two points” — but in this instance it would be better not to use a +contraction). +</p><!--l. 2863--><p class="indent" > Note also that all of the <a + id="dx1-27027"></a><a +href="#glo:linktext">link text<a + id="dx1-27028"></a></a> will be formatted according to <span +class="ectt-1000">\glstextformat</span><a + id="dx1-27029"></a> +(described earlier). So if you do, say: + + + +</p> + <div class="verbatim" id="verbatim-71"> +\renewcommand{\glstextformat}[1]{\textbf{#1}} + <br />\renewcommand{\glsdisplayfirst}[4]{#1#4 (#3)} +</div> +<!--l. 2868--><p class="nopar" > then <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\gls{distance}</span></span></span> will produce “<span +class="ecbx-1000">distance (km)</span>”. +</p><!--l. 2871--><p class="indent" > If you have multiple glossaries, changing <span +class="ectt-1000">\glsdisplayfirst </span>and <span +class="ectt-1000">\glsdisplay </span>will +change the way entries for all of the glossaries appear when using the commands <span +class="ectt-1000">\gls</span><a + id="dx1-27030"></a>, +<span +class="ectt-1000">\glspl</span><a + id="dx1-27031"></a>, their uppercase variants and <span +class="ectt-1000">\glsdisp</span><a + id="dx1-27032"></a>. If you only want the change to affect +entries for a given glossary, then you need to use +</p><!--l. 2877--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\defglsdisplay</span><span +class="ectt-0900"> </span></span><a + id="dx1-27033"></a> <span +class="ectt-1000">\defglsdisplay[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">type</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">]{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">definition</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">} </span></div><hr> +</p><!--l. 2879--><p class="noindent" > +and +</p><!--l. 2881--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\defglsdisplayfirst</span><span +class="ectt-0900"> </span></span><a + id="dx1-27034"></a> <span +class="ectt-1000">\defglsdisplayfirst[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">type</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">]{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">definition</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">} </span></div><hr> +</p><!--l. 2883--><p class="noindent" > +instead of redefining <span +class="ectt-1000">\glsdisplay </span>and <span +class="ectt-1000">\glsdisplayfirst</span>. +</p><!--l. 2886--><p class="indent" > Both <span +class="ectt-1000">\defglsdisplay </span>and <span +class="ectt-1000">\defglsdisplayfirst </span>take +two arguments: the first (which is optional) is the glossary’s +label<span class="footnote-mark"><a +href="#fn8x0" id="fn8x0-bk"><sup class="textsuperscript">8</sup></a></span><a + id="x1-27035f8"></a> +and the second is how the term should be displayed when it is invoked using commands +<span +class="ectt-1000">\gls</span>, <span +class="ectt-1000">\glspl</span>, their uppercase variants and <span +class="ectt-1000">\glsdisp</span>. This is similar to the way +<span +class="ectt-1000">\glsdisplayfirst </span>was redefined above. +</p><!--l. 2895--><p class="indent" > For example, suppose you have created a new glossary called <span +class="ectt-1000">notation </span>and you +want to change the way the entry is displayed on <a + id="dx1-27036"></a><a +href="#glo:firstuse">first use</a> so that it includes the +symbol, you can do: + + + +</p> + <div class="verbatim" id="verbatim-72"> +\defglsdisplayfirst[notation]{#1#4 (denoted #3)} +</div> +<!--l. 2900--><p class="nopar" > Now suppose you have defined an entry as follows: + + + +</p> + <div class="verbatim" id="verbatim-73"> +\newglossaryentry{set}{type=notation, + <br />  name=set, + <br />  description={A collection of objects}, + <br />  symbol={$S$} + <br />} +</div> +<!--l. 2908--><p class="nopar" > The <a + id="dx1-27037"></a><a +href="#glo:firstuse">first time</a> you reference this entry it will be displayed as: “set (denoted <span +class="cmmi-10">S</span>)” +(assuming <span +class="ectt-1000">\gls</span><a + id="dx1-27038"></a> was used). +</p><!--l. 2912--><p class="indent" > Remember that if you use the <span +class="ecss-1000">symbol</span><a + id="dx1-27039"></a> key, you need to use a glossary style that +displays the symbol, as many of the styles ignore it. In addition, if you want either the +description or symbol to appear in the <a + id="dx1-27040"></a><a +href="#glo:linktext">link text<a + id="dx1-27041"></a></a>, you will have to disable the +<a + id="dx1-27042"></a><a +href="#glo:sanitize">sanitization<a + id="dx1-27043"></a></a> of these keys and protect fragile commands. +</p><!--l. 2919--><p class="noindent" > +</p> +<!--l. 2919--><p class="noindent" ><a +href="#top">Top</a></p><h4 class="subsectionHead"><span class="titlemark">6.2 </span> <a + id="x1-280006.2"></a>Enabling and disabling hyperlinks to glossary entries</h4> +<!--l. 2921--><p class="noindent" >If you load the <span +class="ecss-1000">hyperref</span><a + id="dx1-28001"></a> or <span +class="ecss-1000">html</span><a + id="dx1-28002"></a> packages prior to loading the <span +class="ecss-1000">glossaries </span>package, +commands such as <span +class="ectt-1000">\glslink</span><a + id="dx1-28003"></a> and <span +class="ectt-1000">\gls</span><a + id="dx1-28004"></a>, described above, will automatically have +hyperlinks to the relevant glossary entry, unless the <span +class="ecss-1000">hyper</span><a + id="dx1-28005"></a> option has been set to <span +class="ectt-1000">false</span>. +You can disable or enable links using: +</p><!--l. 2926--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\glsdisablehyper</span><span +class="ectt-0900"> </span></span><a + id="dx1-28006"></a> <span +class="ectt-1000">\glsdisablehyper </span></div><hr> +</p><!--l. 2928--><p class="noindent" > +and +</p><!--l. 2930--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\glsenablehyper</span><span +class="ectt-0900"> </span></span><a + id="dx1-28007"></a> <span +class="ectt-1000">\glsenablehyper </span></div><hr> +</p><!--l. 2932--><p class="noindent" > +respectively. The effect can be localised by placing the commands within a group. Note +that you should only use <span +class="ectt-1000">\glsenablehyper </span>if the commands <span +class="ectt-1000">\hyperlink</span><a + id="dx1-28008"></a> and +<span +class="ectt-1000">\hypertarget</span><a + id="dx1-28009"></a> have been defined (for example, by the <span +class="ecss-1000">hyperref</span><a + id="dx1-28010"></a> package). +</p><!--l. 2938--><p class="indent" > You can disable just the <a + id="dx1-28011"></a><a +href="#glo:firstuse">first use</a> links using the package option <span +class="ecss-1000">hyperfirst=false</span><a + id="dx1-28012"></a>. +Note that this option only affects commands that recognise the <a + id="dx1-28013"></a><a +href="#glo:firstuseflag">first use flag</a>, for +example <span +class="ectt-1000">\gls</span><a + id="dx1-28014"></a>, <span +class="ectt-1000">\glspl</span><a + id="dx1-28015"></a> and <span +class="ectt-1000">\glsdisp</span><a + id="dx1-28016"></a> but not <span +class="ectt-1000">\glslink</span><a + id="dx1-28017"></a>. +</p><!--l. 2944--><p class="noindent" > +</p> +<!--l. 2944--><p class="noindent" ><a +href="#top">Top</a></p><h3 class="sectionHead"><span class="titlemark">7 </span> <a + id="x1-290007"></a>Adding an Entry to the Glossary Without Generating Text</h3> +<!--l. 2947--><p class="noindent" >It is possible to add a line in the glossary file without generating any text at that point +in the document using: +</p><!--l. 2949--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\glsadd</span><span +class="ectt-0900"> </span></span><a + id="dx1-29001"></a> <span +class="ectt-1000">\glsadd[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">options</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">]{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">} </span></div><hr> + + + +</p><!--l. 2951--><p class="noindent" > +This is similar to <span +class="ectt-1000">\glslink</span><a + id="dx1-29002"></a>, only it doesn’t produce any text (so therefore, +there is no <span +class="ecss-1000">hyper</span><a + id="dx1-29003"></a> key available in <span +class="cmsy-10">⟨</span><span +class="ecti-1000">options</span><span +class="cmsy-10">⟩ </span>but all the other options that can +be used with <span +class="ectt-1000">\glslink</span><a + id="dx1-29004"></a> can be passed to <span +class="ectt-1000">\glsadd</span>). For example, to add a +page range to the glossary number list for the entry whose label is given by +<span +class="ectt-1000">set</span>: + + + +</p> + <div class="verbatim" id="verbatim-74"> +\glsadd[format=(]{set} + <br />Lots of text about sets spanning many pages. + <br />\glsadd[format=)]{set} +</div> +<!--l. 2962--><p class="nopar" > +</p><!--l. 2964--><p class="indent" > To add all entries that have been defined, use: +</p><!--l. 2965--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\glsaddall</span><span +class="ectt-0900"> </span></span><a + id="dx1-29005"></a> <span +class="ectt-1000">\glsaddall[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">options</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">] </span></div><hr> +</p><!--l. 2967--><p class="noindent" > +The optional argument is the same as for <span +class="ectt-1000">\glsadd</span>, except there is also a key +<span +class="ecss-1000">types</span><a + id="dx1-29006"></a> which can be used to specify which glossaries to use. This should be a +comma separated list. For example, if you only want to add all the entries +belonging to the list of acronyms (specified by the glossary type <span +class="ectt-1000">\acronymtype</span><a + id="dx1-29007"></a>) +and a list of notation (specified by the glossary type <span +class="ectt-1000">notation</span>) then you can +do: + + + +</p> + <div class="verbatim" id="verbatim-75"> +\glsaddall[types={\acronymtype,notation}] +</div> +<!--l. 2978--><p class="nopar" > +</p><!--l. 2980--><p class="indent" > <div class="important" title="Important Note"> Note that <span +class="ectt-1000">\glsadd </span>and <span +class="ectt-1000">\glsaddall </span>add the current location to the number list. In +the case of <span +class="ectt-1000">\glsaddall</span>, all entries in the glossary will have the same location +in the number list. If you want to use <span +class="ectt-1000">\glsaddall</span>, it’s best to suppress the +number list with the <span +class="ecss-1000">nonumberlist</span><a + id="dx1-29008"></a> package option. (See sections <a +href="#x1-150002.3">2.3<!--tex4ht:ref: sec:pkgopts-printglos --></a> and <a +href="#x1-250005">5<!--tex4ht:ref: sec:numberlists --></a>.) +</div> +</p><!--l. 2987--><p class="noindent" > +</p><!--l. 2989--><p class="indent" > The sample file <a +href="#x1-40001.1"><span +class="ectt-1000">sample-dual.tex</span></a> makes use of <span +class="ectt-1000">\glsadd </span>to allow for an entry that +should appear both in the main glossary and in the list of acronyms. This example sets +up the list of acronyms using the <span +class="ecss-1000">acronym</span><a + id="dx1-29009"></a> package option: + + + +</p> + <div class="verbatim" id="verbatim-76"> +\usepackage[acronym]{glossaries} +</div> +<!--l. 2995--><p class="nopar" > A new command is then defined to make it easier to define dual entries: + + + +</p> + <div class="verbatim" id="verbatim-77"> +\newcommand*{\newdualentry}[5][]{% + <br />  \newglossaryentry{main-#2}{name={#4},% + <br />  text={#3\protect\glsadd{#2}},% + <br />  description={#5},% + <br />  #1 + <br />  }% + <br />  \newacronym{#2}{#3\protect\glsadd{main-#2}}{#4} + <br />} +</div> +<!--l. 3007--><p class="nopar" > This has the following syntax: +</p><!--l. 3010--><p class="indent" > <hr><div title="Definition"><span +class="ectt-1000">\newdualentry</span><a + id="dx1-29010"></a><span +class="ectt-1000">[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">options</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">]{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">abbrv</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">long</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">description</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">} </span></div><hr> +</p><!--l. 3011--><p class="noindent" > +You can then define a new dual entry: + + + +</p> + <div class="verbatim" id="verbatim-78"> +\newdualentry{svm}% label + <br />  {SVM}% abbreviation + <br />  {support vector machine}% long form + <br />  {Statistical pattern recognition technique}% description +</div> +<!--l. 3018--><p class="nopar" > Now you can reference the acronym with <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\gls{svm}</span></span></span> or you can reference the entry in +the main glossary with <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\gls{main-svm}</span></span></span>. +</p><!--l. 3022--><p class="noindent" > +</p> +<!--l. 3022--><p class="noindent" ><a +href="#top">Top</a></p><h3 class="sectionHead"><span class="titlemark">8 </span> <a + id="x1-300008"></a>Cross-Referencing Entries</h3> +<!--l. 3025--><p class="noindent" >There are several ways of cross-referencing entries in the glossary: +</p><!--l. 3028--><p class="indent" > + </p><ol class="enumerate1" > + <li + class="enumerate" id="x1-30002x1">You can use commands such as <span +class="ectt-1000">\gls</span><a + id="dx1-30003"></a> in the entries description. For example: + + + + <div class="verbatim" id="verbatim-79"> + \newglossaryentry{apple}{name=apple, +  <br />description={firm, round fruit. See also \gls{pear}}} +</div> + <!--l. 3034--><p class="nopar" > Note that with this method, if you don’t use the cross-referenced term in the + main part of the document, you will need two runs of <a + id="dx1-30004"></a><a +href="#glo:makeglossaries"><span +class="ectt-1000">makeglossaries</span><a + id="dx1-30005"></a></a>: + + + +</p> + <div class="verbatim" id="verbatim-80"> + latex filename +  <br />makeglossaries filename +  <br />latex filename +  <br />makeglossaries filename +  <br />latex filename +</div> + <!--l. 3044--><p class="nopar" > + </p><!--l. 3046--><p class="noindent" ><div class="important" title="Important Note"> If you switch off the description <a + id="dx1-30006"></a><a +href="#glo:sanitize">sanitization<a + id="dx1-30007"></a></a>, you must protect fragile commands + like <span +class="ectt-1000">\gls</span><a + id="dx1-30008"></a>: + + + +</p> + <div class="verbatim" id="verbatim-81"> + \newglossaryentry{apple}{name=apple, +  <br />description={firm, round fruit. See also +  <br />\protect\gls{pear}}} +</div> + <!--l. 3054--><p class="nopar" > </div> + </p><!--l. 3055--><p class="noindent" > + </p></li> + <li + class="enumerate" id="x1-30010x2">As described in <a +href="#x1-190004">§4 </a><a +href="#x1-190004">Defining Glossary Entries<!--tex4ht:ref: sec:newglosentry --></a>, you can use the <span +class="ecss-1000">see</span><a + id="dx1-30011"></a> key when you + define the entry. For example: + + + + <div class="verbatim" id="verbatim-82"> + \newglossaryentry{MaclaurinSeries}{name={Maclaurin series}, +  <br />description={Series expansion}, +  <br />see={TaylorsTheorem}} +</div> + <!--l. 3063--><p class="nopar" > Note that in this case, the entry with the <span +class="ecss-1000">see</span><a + id="dx1-30012"></a> key will automatically be added to + the glossary, but the cross-referenced entry won’t. You therefore need to ensure + that you use the cross-referenced term with the commands described in <a +href="#x1-260006">§6 </a><a +href="#x1-260006">Links + to Glossary Entries<!--tex4ht:ref: sec:glslink --></a> or <a +href="#x1-290007">§7 </a><a +href="#x1-290007">Adding an Entry to the Glossary Without Generating + Text<!--tex4ht:ref: sec:glsadd --></a>. + </p><!--l. 3070--><p class="noindent" >The “see” tag is produce using <span +class="ectt-1000">\seename</span><a + id="dx1-30013"></a>, but can be overridden in specific + instances using square brackets at the start of the <span +class="ecss-1000">see</span><a + id="dx1-30014"></a> value. For example: + + + +</p> + <div class="verbatim" id="verbatim-83"> + \newglossaryentry{MaclaurinSeries}{name={Maclaurin series}, +  <br />description={Series expansion}, +  <br />see=[see also]{TaylorsTheorem}} +</div> + <!--l. 3077--><p class="nopar" > + </p></li> + <li + class="enumerate" id="x1-30016x3">After you have defined the entry, use + <!--l. 3080--><p class="noindent" ><hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\glssee</span><span +class="ectt-0900"> </span></span><a + id="dx1-30017"></a> <span +class="ectt-1000">\glssee[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">tag</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">]{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">xr label list</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">} </span></div><hr> + </p><!--l. 3082--><p class="noindent" > + where <span +class="cmsy-10">⟨</span><span +class="ecti-1000">xr label list</span><span +class="cmsy-10">⟩ </span>is a comma-separated list of entry labels to be + cross-referenced, <span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩ </span>is the label of the entry doing the cross-referencing + and <span +class="cmsy-10">⟨</span><span +class="ecti-1000">tag</span><span +class="cmsy-10">⟩ </span>is the “see” tag. (The default value of <span +class="cmsy-10">⟨</span><span +class="ecti-1000">tag</span><span +class="cmsy-10">⟩ </span>is <span +class="ectt-1000">\seename</span><a + id="dx1-30018"></a>.) For + example: + + + +</p> + <div class="verbatim" id="verbatim-84"> + \glssee[see also]{series}{FourierSeries,TaylorsTheorem} +</div> + <!--l. 3090--><p class="nopar" > Note that this automatically adds the entry given by <span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩ </span>to the glossary but + doesn’t add the cross-referenced entries (specified by <span +class="cmsy-10">⟨</span><span +class="ecti-1000">xr label list</span><span +class="cmsy-10">⟩</span>) to the + glossary.</p></li></ol> +<!--l. 3096--><p class="indent" > In both cases 2 and 3 above, the cross-referenced information appears in the +<a + id="dx1-30019"></a><a +href="#glo:numberlist">number list<a + id="dx1-30020"></a></a>, whereas in case 1, the cross-referenced information appears in the +description. (See the <a +href="#x1-40001.1"><span +class="ectt-1000">sample-crossref.tex</span></a> example file that comes with this package.) +This means that in cases 2 and 3, the cross-referencing information won’t appear if you +have suppressed the <a + id="dx1-30021"></a>number list<a + id="dx1-30022"></a>. In this case, you will need to activate the <a + id="dx1-30023"></a>number list<a + id="dx1-30024"></a> +for the given entries using <span +class="ecss-1000">nonumberlist=false</span><a + id="dx1-30025"></a>. Alternatively, if you just use the <span +class="ecss-1000">see</span><a + id="dx1-30026"></a> key +instead of <span +class="ectt-1000">\glssee</span><a + id="dx1-30027"></a>, you can automatically activate the <a + id="dx1-30028"></a>number list<a + id="dx1-30029"></a> using the +<span +class="ecss-1000">seeautonumberlist</span><a + id="dx1-30030"></a> package option. +</p><!--l. 3108--><p class="noindent" > +</p> +<!--l. 3108--><p class="noindent" ><a +href="#top">Top</a></p><h4 class="subsectionHead"><span class="titlemark">8.1 </span> <a + id="x1-310008.1"></a>Customising Cross-reference Text</h4> +<!--l. 3110--><p class="noindent" >When you use either the <span +class="ecss-1000">see</span><a + id="dx1-31001"></a> key or the command <span +class="ectt-1000">\glssee</span>, the cross-referencing +information will be typeset in the glossary according to: +</p><!--l. 3113--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\glsseeformat</span><span +class="ectt-0900"> </span></span><a + id="dx1-31002"></a> <span +class="ectt-1000">\glsseeformat[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">tag</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">]{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">label-list</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">location</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">} </span></div><hr> +</p><!--l. 3115--><p class="noindent" > +The default definition of <span +class="ectt-1000">\glsseeformat </span>is: <spacer type=vertical size=10><span class="obeylines-h"> + <br /><span +class="ectt-1000">\emph{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">tag</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">} \glsseelist{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">label-list</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}</span> + <br /><spacer type=vertical size=10></span> +Note that the location is always ignored.<span class="footnote-mark"><a +href="#fn9x0" id="fn9x0-bk"><sup class="textsuperscript">9</sup></a></span><a + id="x1-31003f9"></a> +For example, if you want the tag to appear in bold, you can +do:<span class="footnote-mark"><a +href="#fn10x0" id="fn10x0-bk"><sup class="textsuperscript">10</sup></a></span><a + id="x1-31006f10"></a> + + + +</p> + <div class="verbatim" id="verbatim-85"> +\renewcommand*{\glsseeformat}[3][\seename]{\textbf{#1} \glsseelist{#2}} +</div> +<!--l. 3130--><p class="nopar" > +</p><!--l. 3133--><p class="indent" > The list of labels is dealt with by <span +class="ectt-1000">\glsseelist</span>, which iterates through the list and +typesets each entry in the label. The entries are separated by +</p><!--l. 3136--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\glsseesep</span><span +class="ectt-0900"> </span></span><a + id="dx1-31009"></a> <span +class="ectt-1000">\glsseesep </span></div><hr> +</p><!--l. 3138--><p class="noindent" > +or (for the last pair) +</p><!--l. 3140--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\glsseelastsep</span><span +class="ectt-0900"> </span></span><a + id="dx1-31010"></a> <span +class="ectt-1000">\glsseelastsep </span></div><hr> +</p><!--l. 3142--><p class="noindent" > +These default to <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">,\space</span></span></span> and <span +class="ectt-1000">\space\andname</span><a + id="dx1-31011"></a><span +class="ectt-1000">\space </span>respectively. The list entry text +is displayed using: +</p><!--l. 3146--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\glsseeitemformat</span><span +class="ectt-0900"> </span></span><a + id="dx1-31012"></a> <span +class="ectt-1000">\glsseeitemformat{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">} </span></div><hr> +</p><!--l. 3148--><p class="noindent" > +This defaults to +<span +class="ectt-1000">\glsentrytext</span><a + id="dx1-31013"></a><span +class="ectt-1000">{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}</span>.<span class="footnote-mark"><a +href="#fn11x0" id="fn11x0-bk"><sup class="textsuperscript">11</sup></a></span><a + id="x1-31014f11"></a> +For example, to make the cross-referenced list use small caps: + + + +</p> + <div class="verbatim" id="verbatim-86"> +\renewcommand{\glsseeitemformat}[1]{\textsc{\glsentrytext{#1}}} +</div> +<!--l. 3155--><p class="nopar" > +</p><!--l. 3157--><p class="indent" > <div class="important" title="Important Note"> You can use <span +class="ectt-1000">\glsseeformat</span><a + id="dx1-31018"></a> and <span +class="ectt-1000">\glsseelist</span><a + id="dx1-31019"></a> in the main body of the text, but +they won’t automatically add the cross-referenced entries to the glossary. If you want +them added with that location, you can do: + + + +</p> + <div class="verbatim" id="verbatim-87"> +Some information (see also + <br />\glsseelist{FourierSeries,TaylorsTheorem}% + <br />\glsadd{FourierSeries}\glsadd{TaylorsTheorem}). +</div> +<!--l. 3166--><p class="nopar" > </div> +</p><!--l. 3167--><p class="noindent" > +</p><!--l. 3169--><p class="noindent" > +</p> +<!--l. 3169--><p class="noindent" ><a +href="#top">Top</a></p><h3 class="sectionHead"><span class="titlemark">9 </span> <a + id="x1-320009"></a>Using Glossary Terms Without Links</h3> +<!--l. 3172--><p class="noindent" >The commands described in this section display entry details without adding any +information to the glossary. They don’t use <span +class="ectt-1000">\glstextformat</span><a + id="dx1-32001"></a>, they don’t have any +optional arguments, they don’t affect the <a + id="dx1-32002"></a><a +href="#glo:firstuseflag">first use flag</a> and, apart from <span +class="ectt-1000">\glshyperlink</span><a + id="dx1-32003"></a>, +they don’t produce hyperlinks. +</p><!--l. 3177--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\glsentryname</span><span +class="ectt-0900"> </span></span><a + id="dx1-32004"></a> <span +class="ectt-1000">\glsentryname{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">} </span></div><hr> +</p><!--l. 3179--><p class="noindent" > +</p><!--l. 3180--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\Glsentryname</span><span +class="ectt-0900"> </span></span><a + id="dx1-32005"></a> <span +class="ectt-1000">\Glsentryname{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">} </span></div><hr> +</p><!--l. 3182--><p class="noindent" > +These commands display the name of the glossary entry given by <span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩</span>, as specified by +the <span +class="ecss-1000">name</span><a + id="dx1-32006"></a> key. <span +class="ectt-1000">\Glsentryname </span>makes the first letter uppercase. +</p><!--l. 3186--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\glsentrytext</span><span +class="ectt-0900"> </span></span><a + id="dx1-32007"></a> <span +class="ectt-1000">\glsentrytext{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">} </span></div><hr> +</p><!--l. 3188--><p class="noindent" > +</p><!--l. 3189--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\Glsentrytext</span><span +class="ectt-0900"> </span></span><a + id="dx1-32008"></a> <span +class="ectt-1000">\Glsentrytext{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">} </span></div><hr> +</p><!--l. 3191--><p class="noindent" > +These commands display the subsequent use text for the glossary entry given +by <span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩</span>, as specified by the <span +class="ecss-1000">text</span><a + id="dx1-32009"></a> key. <span +class="ectt-1000">\Glsentrytext </span>makes the first letter +uppercase. +</p><!--l. 3195--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\glsentryplural</span><span +class="ectt-0900"> </span></span><a + id="dx1-32010"></a> <span +class="ectt-1000">\glsentryplural{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">} </span></div><hr> +</p><!--l. 3197--><p class="noindent" > +</p><!--l. 3198--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\Glsentryplural</span><span +class="ectt-0900"> </span></span><a + id="dx1-32011"></a> <span +class="ectt-1000">\Glsentryplural{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">} </span></div><hr> +</p><!--l. 3200--><p class="noindent" > +These commands display the subsequent use plural text for the glossary entry given by +<span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩</span>, as specified by the <span +class="ecss-1000">plural</span><a + id="dx1-32012"></a> key. <span +class="ectt-1000">\Glsentryplural </span>makes the first letter +uppercase. +</p><!--l. 3205--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\glsentryfirst</span><span +class="ectt-0900"> </span></span><a + id="dx1-32013"></a> <span +class="ectt-1000">\glsentryfirst{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">} </span></div><hr> + + + +</p><!--l. 3207--><p class="noindent" > +</p><!--l. 3208--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\Glsentryfirst</span><span +class="ectt-0900"> </span></span><a + id="dx1-32014"></a> <span +class="ectt-1000">\Glsentryfirst{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">} </span></div><hr> +</p><!--l. 3210--><p class="noindent" > +These commands display the <a + id="dx1-32015"></a><a +href="#glo:firstusetext">first use text</a> for the glossary entry given by +<span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩</span>, as specified by the <span +class="ecss-1000">first</span><a + id="dx1-32016"></a> key. <span +class="ectt-1000">\Glsentryfirst </span>makes the first letter +uppercase. +</p><!--l. 3214--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\glsentryfirstplural</span><span +class="ectt-0900"> </span></span><a + id="dx1-32017"></a> <span +class="ectt-1000">\glsentryfirstplural{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">} </span></div><hr> +</p><!--l. 3216--><p class="noindent" > +</p><!--l. 3217--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\Glsentryfirstplural</span><span +class="ectt-0900"> </span></span><a + id="dx1-32018"></a> <span +class="ectt-1000">\Glsentryfirstplural{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">} </span></div><hr> +</p><!--l. 3219--><p class="noindent" > +These commands display the plural form of the <a + id="dx1-32019"></a><a +href="#glo:firstusetext">first use text</a> for the glossary entry +given by <span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩</span>, as specified by the <span +class="ecss-1000">firstplural</span><a + id="dx1-32020"></a> key. <span +class="ectt-1000">\Glsentryfirstplural </span>makes the +first letter uppercase. +</p><!--l. 3224--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\glsentrydesc</span><span +class="ectt-0900"> </span></span><a + id="dx1-32021"></a> <span +class="ectt-1000">\glsentrydesc{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">} </span></div><hr> +</p><!--l. 3226--><p class="noindent" > +</p><!--l. 3227--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\Glsentrydesc</span><span +class="ectt-0900"> </span></span><a + id="dx1-32022"></a> <span +class="ectt-1000">\Glsentrydesc{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">} </span></div><hr> +</p><!--l. 3229--><p class="noindent" > +These commands display the description for the glossary entry given by <span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩</span>. +<span +class="ectt-1000">\Glsentrydesc </span>makes the first letter uppercase. +</p><!--l. 3232--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\glsentrydescplural</span><span +class="ectt-0900"> </span></span><a + id="dx1-32023"></a> <span +class="ectt-1000">\glsentrydescplural{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">} </span></div><hr> +</p><!--l. 3234--><p class="noindent" > +</p><!--l. 3235--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\Glsentrydescplural</span><span +class="ectt-0900"> </span></span><a + id="dx1-32024"></a> <span +class="ectt-1000">\Glsentrydescplural{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">} </span></div><hr> +</p><!--l. 3237--><p class="noindent" > +These commands display the plural description for the glossary entry given by <span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩</span>. +<span +class="ectt-1000">\Glsentrydescplural </span>makes the first letter uppercase. +</p><!--l. 3241--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\glsentrysymbol</span><span +class="ectt-0900"> </span></span><a + id="dx1-32025"></a> <span +class="ectt-1000">\glsentrysymbol{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">} </span></div><hr> +</p><!--l. 3243--><p class="noindent" > +</p><!--l. 3244--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\Glsentrysymbol</span><span +class="ectt-0900"> </span></span><a + id="dx1-32026"></a> <span +class="ectt-1000">\Glsentrysymbol{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">} </span></div><hr> +</p><!--l. 3246--><p class="noindent" > +These commands display the symbol for the glossary entry given by <span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩</span>. +<span +class="ectt-1000">\Glsentrysymbol </span>makes the first letter uppercase. +</p><!--l. 3249--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\glsentrysymbolplural</span><span +class="ectt-0900"> </span></span><a + id="dx1-32027"></a> <span +class="ectt-1000">\glsentrysymbolplural{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">} </span></div><hr> +</p><!--l. 3251--><p class="noindent" > +</p><!--l. 3252--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\Glsentrysymbolplural</span><span +class="ectt-0900"> </span></span><a + id="dx1-32028"></a> <span +class="ectt-1000">\Glsentrysymbolplural{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">} </span></div><hr> +</p><!--l. 3254--><p class="noindent" > +These commands display the plural symbol for the glossary entry given by <span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩</span>. +<span +class="ectt-1000">\Glsentrysymbolplural </span>makes the first letter uppercase. +</p><!--l. 3258--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\glsentryuseri</span><span +class="ectt-0900"> </span></span><a + id="dx1-32029"></a> <span +class="ectt-1000">\glsentryuseri{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">} </span></div><hr> +</p><!--l. 3260--><p class="noindent" > + + + +</p><!--l. 3261--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\Glsentryuseri</span><span +class="ectt-0900"> </span></span><a + id="dx1-32030"></a> <span +class="ectt-1000">\Glsentryuseri{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">} </span></div><hr> +</p><!--l. 3263--><p class="noindent" > +</p><!--l. 3264--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\glsentryuserii</span><span +class="ectt-0900"> </span></span><a + id="dx1-32031"></a> <span +class="ectt-1000">\glsentryuserii{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">} </span></div><hr> +</p><!--l. 3266--><p class="noindent" > +</p><!--l. 3267--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\Glsentryuserii</span><span +class="ectt-0900"> </span></span><a + id="dx1-32032"></a> <span +class="ectt-1000">\Glsentryuserii{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">} </span></div><hr> +</p><!--l. 3269--><p class="noindent" > +</p><!--l. 3270--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\glsentryuseriii</span><span +class="ectt-0900"> </span></span><a + id="dx1-32033"></a> <span +class="ectt-1000">\glsentryuseriii{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">} </span></div><hr> +</p><!--l. 3272--><p class="noindent" > +</p><!--l. 3273--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\Glsentryuseriii</span><span +class="ectt-0900"> </span></span><a + id="dx1-32034"></a> <span +class="ectt-1000">\Glsentryuseriii{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">} </span></div><hr> +</p><!--l. 3275--><p class="noindent" > +</p><!--l. 3276--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\glsentryuseriv</span><span +class="ectt-0900"> </span></span><a + id="dx1-32035"></a> <span +class="ectt-1000">\glsentryuseriv{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">} </span></div><hr> +</p><!--l. 3278--><p class="noindent" > +</p><!--l. 3279--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\Glsentryuseriv</span><span +class="ectt-0900"> </span></span><a + id="dx1-32036"></a> <span +class="ectt-1000">\Glsentryuseriv{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">} </span></div><hr> +</p><!--l. 3281--><p class="noindent" > +</p><!--l. 3282--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\glsentryuserv</span><span +class="ectt-0900"> </span></span><a + id="dx1-32037"></a> <span +class="ectt-1000">\glsentryuserv{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">} </span></div><hr> +</p><!--l. 3284--><p class="noindent" > +</p><!--l. 3285--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\Glsentryuserv</span><span +class="ectt-0900"> </span></span><a + id="dx1-32038"></a> <span +class="ectt-1000">\Glsentryuserv{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">} </span></div><hr> +</p><!--l. 3287--><p class="noindent" > +</p><!--l. 3288--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\glsentryuservi</span><span +class="ectt-0900"> </span></span><a + id="dx1-32039"></a> <span +class="ectt-1000">\glsentryuservi{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">} </span></div><hr> +</p><!--l. 3290--><p class="noindent" > +</p><!--l. 3291--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\Glsentryuservi</span><span +class="ectt-0900"> </span></span><a + id="dx1-32040"></a> <span +class="ectt-1000">\Glsentryuservi{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">} </span></div><hr> +</p><!--l. 3293--><p class="noindent" > +These commands display the value of the user keys for the glossary entry given by +<span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩</span>. +</p><!--l. 3296--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\glshyperlink</span><span +class="ectt-0900"> </span></span><a + id="dx1-32041"></a> <span +class="ectt-1000">\glshyperlink[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">link text</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">]{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">} </span></div><hr> +</p><!--l. 3298--><p class="noindent" > +This command provides a hyperlink to the glossary entry given by <span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩ </span><span +class="ecbx-1000">but does not add</span> +<span +class="ecbx-1000">any information to the glossary file</span>. The link text is given by <span +class="ectt-1000">\glsentrytext</span><a + id="dx1-32042"></a><span +class="ectt-1000">{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">} </span>by +default<span class="footnote-mark"><a +href="#fn12x0" id="fn12x0-bk"><sup class="textsuperscript">12</sup></a></span><a + id="x1-32043f12"></a>, +but can be overridden using the optional argument. +</p><!--l. 3306--><p class="indent" > <div class="important" title="Important Note"> If you use <span +class="ectt-1000">\glshyperlink</span>, you need to ensure that the relevant entry has been +added to the glossary using any of the commands described in <a +href="#x1-260006">§6 </a><a +href="#x1-260006">Links to Glossary +Entries<!--tex4ht:ref: sec:glslink --></a> or <a +href="#x1-290007">§7 </a><a +href="#x1-290007">Adding an Entry to the Glossary Without Generating Text<!--tex4ht:ref: sec:glsadd --></a> otherwise you +will end up with an undefined link. </div> +</p><!--l. 3311--><p class="noindent" > + + + +</p><!--l. 3313--><p class="indent" > For further information see “Displaying entry details without adding information to +the glossary” in the documented code (<span +class="ectt-1000">glossaries.pdf</span>). +</p><!--l. 3317--><p class="noindent" > +</p> +<!--l. 3317--><p class="noindent" ><a +href="#top">Top</a></p><h3 class="sectionHead"><span class="titlemark">10 </span> <a + id="x1-3300010"></a>Displaying a glossary</h3> +<!--l. 3320--><p class="noindent" >The command +</p><!--l. 3321--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\printglossaries</span><span +class="ectt-0900"> </span></span><a + id="dx1-33001"></a> <span +class="ectt-1000">\printglossaries </span></div><hr> +</p><!--l. 3323--><p class="noindent" > +will display all the glossaries in the order in which they were defined. Note that no +glossaries will appear until you have either used the Perl script <a + id="dx1-33002"></a><a +href="#glo:makeglossaries"><span +class="ectt-1000">makeglossaries</span><a + id="dx1-33003"></a></a> or have +directly used <a + id="dx1-33004"></a><a +href="#glo:makeindex"><span +class="ectt-1000">makeindex</span><a + id="dx1-33005"></a></a> or <a + id="dx1-33006"></a><a +href="#glo:xindy"><span +class="ectt-1000">xindy</span><a + id="dx1-33007"></a></a> (as described in <a +href="#x1-70001.3">§1.3 </a><a +href="#x1-70001.3">Generating the Associated +Glossary Files<!--tex4ht:ref: sec:makeglossaries --></a>). If the glossary still does not appear after you re-<span class="LATEX">L<span class="A">A</span><span class="TEX">T<span +class="E">E</span>X</span></span> your +document, check the <a + id="dx1-33008"></a><span +class="ectt-1000">makeindex</span><a + id="dx1-33009"></a>/<a + id="dx1-33010"></a><span +class="ectt-1000">xindy</span><a + id="dx1-33011"></a> log files to see if there is a problem. Remember +that you also need to use the command <span +class="ectt-1000">\makeglossaries</span><a + id="dx1-33012"></a> in the preamble to enable the +glossaries. +</p><!--l. 3334--><p class="indent" > An individual glossary can be displayed using: +</p><!--l. 3335--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\printglossary</span><span +class="ectt-0900"> </span></span><a + id="dx1-33013"></a> <span +class="ectt-1000">\printglossary[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">options</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">] </span></div><hr> +</p><!--l. 3337--><p class="noindent" > +where <span +class="cmsy-10">⟨</span><span +class="ecti-1000">options</span><span +class="cmsy-10">⟩ </span>is a <span +class="cmsy-10">⟨</span><span +class="ecti-1000">key</span><span +class="cmsy-10">⟩</span>=<span +class="cmsy-10">⟨</span><span +class="ecti-1000">value</span><span +class="cmsy-10">⟩ </span>list of options. The following keys are available: + </p><dl class="description"><dt class="description"> +<span +class="ecsx-1000">type</span><a + id="dx1-33014"></a> </dt><dd +class="description">The value of this key specifies which glossary to print. If omitted, the default + glossary is assumed. For example, to print the list of acronyms: + + + + <div class="verbatim" id="verbatim-88"> + \printglossary[type=\acronymtype] +</div> + <!--l. 3346--><p class="nopar" > + </p></dd><dt class="description"> +<span +class="ecsx-1000">title</span><a + id="dx1-33015"></a> </dt><dd +class="description">This is the glossary’s title (overriding the title specified when the glossary was + defined). + </dd><dt class="description"> +<span +class="ecsx-1000">toctitle</span><a + id="dx1-33016"></a> </dt><dd +class="description">This is the title to use for the table of contents (if the <span +class="ecss-1000">toc</span><a + id="dx1-33017"></a> package option has + been used). It may also be used for the page header, depending on the page style. + If omitted, the value of <span +class="ecss-1000">title</span><a + id="dx1-33018"></a> is used. + </dd><dt class="description"> +<span +class="ecsx-1000">style</span><a + id="dx1-33019"></a> </dt><dd +class="description">This specifies which glossary style to use for this glossary, overriding the effect of + the <span +class="ecss-1000">style</span><a + id="dx1-33020"></a> package option or <span +class="ectt-1000">\glossarystyle</span><a + id="dx1-33021"></a>. + </dd><dt class="description"> +<span +class="ecsx-1000">numberedsection</span><a + id="dx1-33022"></a> </dt><dd +class="description">This specifies whether to use a numbered section for this glossary, + overriding the effect of the <span +class="ecss-1000">numberedsection</span><a + id="dx1-33023"></a> package option. This key has the same + syntax as the <span +class="ecss-1000">numberedsection</span><a + id="dx1-33024"></a> package option, described in <a +href="#x1-140002.2">§2.2 </a><a +href="#x1-140002.2">Sectioning and + TOC Options<!--tex4ht:ref: sec:pkgopts-sec --></a>. + </dd><dt class="description"> +<span +class="ecsx-1000">nonumberlist</span><a + id="dx1-33025"></a> </dt><dd +class="description">This is a boolean key. If true (<span class="obeylines-h"><span class="verb"><span +class="ectt-1000">nonumberlist=true</span></span></span>) the numberlist is + suppressed for this glossary. If false (<span class="obeylines-h"><span class="verb"><span +class="ectt-1000">nonumberlist=false</span></span></span>) the numberlist is + displayed for this glossary. If no value is supplied, true is assumed. + </dd></dl> +<!--l. 3376--><p class="indent" > By default, the glossary is started either by <span +class="ectt-1000">\chapter*</span><a + id="dx1-33026"></a> or by <span +class="ectt-1000">\section*</span><a + id="dx1-33027"></a>, depending +on whether or not <span +class="ectt-1000">\chapter</span><a + id="dx1-33028"></a> is defined. This can be overridden by the <span +class="ecss-1000">section</span><a + id="dx1-33029"></a> package +option or the <span +class="ectt-1000">\setglossarysection</span><a + id="dx1-33030"></a> command. Numbered sectional units can be +obtained using the <span +class="ecss-1000">numberedsection</span><a + id="dx1-33031"></a> package option. Each glossary sets the page header +via the command <span +class="ectt-1000">\glossarymark</span><a + id="dx1-33032"></a>. If this mechanism is unsuitable for your chosen class +file or page style package, you will need to redefine <span +class="ectt-1000">\glossarymark</span><a + id="dx1-33033"></a>. Further +information about these options and commands is given in <a +href="#x1-140002.2">§2.2 </a><a +href="#x1-140002.2">Sectioning and TOC +Options<!--tex4ht:ref: sec:pkgopts-sec --></a>. +</p><!--l. 3387--><p class="indent" > Information can be added to the start of the glossary (after the title and before the +main body of the glossary) by redefining +</p><!--l. 3389--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\glossarypreamble</span><span +class="ectt-0900"> </span></span><a + id="dx1-33034"></a> <span +class="ectt-1000">\glossarypreamble </span></div><hr> +</p><!--l. 3391--><p class="noindent" > +For example: + + + +</p> + <div class="verbatim" id="verbatim-89"> +\renewcommand{\glossarypreamble}{Numbers in italic indicate + <br />primary definitions.} +</div> +<!--l. 3396--><p class="nopar" > This needs to be done before the glossary is displayed using <span +class="ectt-1000">\printglossaries </span>or +<span +class="ectt-1000">\printglossary</span>. Note that if you want a different preamble for each glossary, you will +need to use a separate <span +class="ectt-1000">\printglossary </span>for each glossary and change the definition of +<span +class="ectt-1000">\glossarypreamble </span>between each glossary. For example: + + + +</p> + <div class="verbatim" id="verbatim-90"> +\renewcommand{\glossarypreamble}{Numbers in italic indicate + <br />primary definitions.} + <br />\printglossary + <br />\renewcommand{\glossarypreamble}{} + <br />\printglossary[type=acronym] +</div> +<!--l. 3409--><p class="nopar" > Alternatively, you can do something like: + + + +</p> + <div class="verbatim" id="verbatim-91"> +\renewcommand{\glossarypreamble}{Numbers in italic indicate + <br />primary definitions.\gdef\glossarypreamble{}} + <br />\printglossaries +</div> +<!--l. 3415--><p class="nopar" > which will print the preamble text for the first glossary and change the preamble to do +nothing for subsequent glossaries. (Note that <span +class="ectt-1000">\gdef </span>is required as the glossary is placed +within a group.) +</p><!--l. 3421--><p class="indent" > There is an analogous command called +</p><!--l. 3422--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\glossarypostamble</span><span +class="ectt-0900"> </span></span><a + id="dx1-33035"></a> <span +class="ectt-1000">\glossarypostamble </span></div><hr> +</p><!--l. 3424--><p class="noindent" > +which is placed at the end of each glossary. +</p><!--l. 3427--><p class="indent" > For example: suppose you are using the <span +class="ecss-1000">superheaderborder</span><a + id="dx1-33036"></a> +style<span class="footnote-mark"><a +href="#fn13x0" id="fn13x0-bk"><sup class="textsuperscript">13</sup></a></span><a + id="x1-33037f13"></a>, +and you want the glossary to be in two columns, but after the glossary you want to +switch back to one column mode, you could do: + + + +</p> + <div class="verbatim" id="verbatim-92"> +\renewcommand*{\glossarysection}[2][]{% + <br />  \twocolumn[{\section*{#2}}]% + <br />  \setlength\glsdescwidth{0.6\linewidth}% + <br />  \glossarymark{\glossarytoctitle}% + <br />} + <br />\renewcommand*{\glossarypostamble}{\onecolumn} +</div> +<!--l. 3441--><p class="nopar" > +</p><!--l. 3443--><p class="indent" > Within each glossary, each entry name is formatted according to +</p><!--l. 3444--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\glsnamefont</span><span +class="ectt-0900"> </span></span><a + id="dx1-33041"></a> <span +class="ectt-1000">\glsnamefont{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">name</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">} </span></div><hr> +</p><!--l. 3446--><p class="noindent" > +which takes one argument: the entry name. This command is always used regardless of +the glossary style. By default, <span +class="ectt-1000">\glsnamefont </span>simply displays its argument in whatever +the surrounding font happens to be. This means that in the list-like glossary styles +(defined in the <span +class="ecss-1000">glossary-list</span><a + id="dx1-33042"></a> style file) the name will appear in bold, since the name is +placed in the optional argument of <span +class="ectt-1000">\item</span>, whereas in the tabular styles (defined in the +<span +class="ecss-1000">glossary-long</span><a + id="dx1-33043"></a> and <span +class="ecss-1000">glossary-super</span><a + id="dx1-33044"></a> style files) the name will appear in the normal font. The +hierarchical glossary styles (defined in the <span +class="ecss-1000">glossary-tree</span><a + id="dx1-33045"></a> style file) also set the name in +bold. +</p><!--l. 3459--><p class="indent" > For example, suppose you want all the entry names to appear in medium weight +small caps, then you can do: + + + +</p> + <div class="verbatim" id="verbatim-93"> +\renewcommand{\glsnamefont}[1]{\textsc{\mdseries #1}} +</div> +<!--l. 3463--><p class="nopar" > +</p><!--l. 3466--><p class="noindent" > +</p> +<!--l. 3466--><p class="noindent" ><a +href="#top">Top</a></p><h3 class="sectionHead"><span class="titlemark">11 </span> <a + id="x1-3400011"></a>Xindy</h3> +<!--l. 3469--><p class="noindent" >If you want to use <a + id="dx1-34001"></a><a +href="#glo:xindy"><span +class="ectt-1000">xindy</span><a + id="dx1-34002"></a></a> to sort the glossary, you must use the package option +<span +class="ecss-1000">xindy</span><a + id="dx1-34003"></a>: + + + +</p> + <div class="verbatim" id="verbatim-94"> +\usepackage[xindy]{glossaries} +</div> +<!--l. 3473--><p class="nopar" > This ensures that the glossary information is written in <a + id="dx1-34004"></a><span +class="ectt-1000">xindy</span><a + id="dx1-34005"></a> syntax. +</p><!--l. 3477--><p class="indent" > <a +href="#x1-70001.3">§1.3 </a><a +href="#x1-70001.3">Generating the Associated Glossary Files<!--tex4ht:ref: sec:makeglossaries --></a> covers how to use the external +indexing application. This section covers the commands provided by the <span +class="ecss-1000">glossaries</span> +package that allow you to adjust the <a + id="dx1-34006"></a><a +href="#glo:xindy"><span +class="ectt-1000">xindy</span><a + id="dx1-34007"></a></a> style file (<span +class="ectt-1000">.xdy</span><a + id="dx1-34008"></a>) and parameters. +</p><!--l. 3482--><p class="indent" > To assist writing information to the <a + id="dx1-34009"></a><a +href="#glo:xindy"><span +class="ectt-1000">xindy</span><a + id="dx1-34010"></a></a> style file, the <span +class="ecss-1000">glossaries </span>package provides +the following commands: +</p><!--l. 3485--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\glsopenbrace</span><span +class="ectt-0900"> </span></span><a + id="dx1-34011"></a> <span +class="ectt-1000">\glsopenbrace </span></div><hr> +</p><!--l. 3487--><p class="noindent" > +</p><!--l. 3488--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\glsclosebrace</span><span +class="ectt-0900"> </span></span><a + id="dx1-34012"></a> <span +class="ectt-1000">\glsclosebrace </span></div><hr> +</p><!--l. 3490--><p class="noindent" > +which produce an open and closing brace. (This is needed because <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\{</span></span></span> and <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\}</span></span></span> don’t +expand to a simple brace character when written to a file.) +</p><!--l. 3495--><p class="indent" > In addition, if you are using a package that makes the double quote character active +(e.g. <span +class="ecss-1000">ngerman</span><a + id="dx1-34013"></a>) you can use: +</p><!--l. 3497--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\glsquote</span><span +class="ectt-0900"> </span></span><a + id="dx1-34014"></a> <span +class="ectt-1000">\glsquote{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">text</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">} </span></div><hr> +</p><!--l. 3499--><p class="noindent" > +which will produce <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">"</span></span></span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">text</span><span +class="cmsy-10">⟩</span><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">"</span></span></span>. Alternatively, you can use <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\string"</span></span></span> to write the +double-quote character. This document assumes that the double quote character has +not been made active, so the examples just use <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">"</span></span></span> for clarity. +</p><!--l. 3505--><p class="indent" > If you want greater control over the <a + id="dx1-34015"></a><a +href="#glo:xindy"><span +class="ectt-1000">xindy</span><a + id="dx1-34016"></a></a> style file than is available through the +<span class="LATEX">L<span class="A">A</span><span class="TEX">T<span +class="E">E</span>X</span></span> commands provided by the <span +class="ecss-1000">glossaries </span>package, you will need to edit the <a + id="dx1-34017"></a><span +class="ectt-1000">xindy</span><a + id="dx1-34018"></a> +style file. In which case, you must use <span +class="ectt-1000">\noist</span><a + id="dx1-34019"></a> to prevent the style file from being +overwritten by the <span +class="ecss-1000">glossaries </span>package. For additional information about <a + id="dx1-34020"></a><span +class="ectt-1000">xindy</span><a + id="dx1-34021"></a>, read the +<a + id="dx1-34022"></a><span +class="ectt-1000">xindy</span><a + id="dx1-34023"></a> documentation. +</p><!--l. 3513--><p class="noindent" > +</p> +<!--l. 3513--><p class="noindent" ><a +href="#top">Top</a></p><h4 class="subsectionHead"><span class="titlemark">11.1 </span> <a + id="x1-3500011.1"></a>Language and Encodings</h4> +<!--l. 3514--><p class="noindent" >When you use <a + id="dx1-35001"></a><a +href="#glo:xindy"><span +class="ectt-1000">xindy</span><a + id="dx1-35002"></a></a>, you need to specify the language and encoding used +(unless you have written your own custom <a + id="dx1-35003"></a><span +class="ectt-1000">xindy</span><a + id="dx1-35004"></a> style file that defines the +relevant alphabet and sort rules). If you use <a + id="dx1-35005"></a><a +href="#glo:makeglossaries"><span +class="ectt-1000">makeglossaries</span><a + id="dx1-35006"></a></a>, this information is +obtained from the document’s auxiliary (<span +class="ectt-1000">.aux</span><a + id="dx1-35007"></a>) file. The <span +class="ecss-1000">glossaries </span>package +attempts to find the root language, but in the event that it gets it wrong or +if <a + id="dx1-35008"></a><span +class="ectt-1000">xindy</span><a + id="dx1-35009"></a> doesn’t support that language, then you can specify the language +using: +</p><!--l. 3523--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\GlsSetXdyLanguage</span><span +class="ectt-0900"> </span></span><a + id="dx1-35010"></a> <span +class="ectt-1000">\GlsSetXdyLanguage[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">glossary type</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">]{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">language</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}</span> +</div><hr> + + + +</p><!--l. 3525--><p class="noindent" > +where <span +class="cmsy-10">⟨</span><span +class="ecti-1000">language</span><span +class="cmsy-10">⟩ </span>is the name of the language. The optional argument can be used if +you have multiple glossaries in different languages. If <span +class="cmsy-10">⟨</span><span +class="ecti-1000">glossary type</span><span +class="cmsy-10">⟩ </span>is omitted, it will +be applied to all glossaries, otherwise the language setting will only be applied to the +glossary given by <span +class="cmsy-10">⟨</span><span +class="ecti-1000">glossary type</span><span +class="cmsy-10">⟩</span>. +</p><!--l. 3533--><p class="indent" > If the <span +class="ecss-1000">inputenc</span><a + id="dx1-35011"></a> package is used, the encoding will be obtained from the +value of <span +class="ectt-1000">\inputencodingname</span><a + id="dx1-35012"></a>. Alternatively, you can specify the encoding +using: +</p><!--l. 3536--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\GlsSetXdyCodePage</span><span +class="ectt-0900"> </span></span><a + id="dx1-35013"></a> <span +class="ectt-1000">\GlsSetXdyCodePage{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">code</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">} </span></div><hr> +</p><!--l. 3538--><p class="noindent" > +where <span +class="cmsy-10">⟨</span><span +class="ecti-1000">code</span><span +class="cmsy-10">⟩ </span>is the name of the encoding. For example: + + + +</p> + <div class="verbatim" id="verbatim-95"> +\GlsSetXdyCodePage{utf8} +</div> +<!--l. 3542--><p class="nopar" > +</p><!--l. 3544--><p class="indent" > Note that you can also specify the language and encoding using the package option +<span class="obeylines-h"><span class="verb"><span +class="ectt-1000">xindy={language=</span></span></span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">lang</span><span +class="cmsy-10">⟩</span><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">,codepage=</span></span></span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">code</span><span +class="cmsy-10">⟩</span><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">}</span></span></span>. For example: + + + +</p> + <div class="verbatim" id="verbatim-96"> +\usepackage[xindy={language=english,codepage=utf8}]{glossaries} +</div> +<!--l. 3550--><p class="nopar" > +</p><!--l. 3552--><p class="indent" > If you write your own custom <a + id="dx1-35014"></a><a +href="#glo:xindy"><span +class="ectt-1000">xindy</span><a + id="dx1-35015"></a></a> style file that includes the language settings, +you need to set the language to nothing: + + + +</p> + <div class="verbatim" id="verbatim-97"> +\GlsSetXdyLanguage{} +</div> +<!--l. 3557--><p class="nopar" > (and remember to use <span +class="ectt-1000">\noist</span><a + id="dx1-35016"></a> to prevent the style file from being overwritten). +</p><!--l. 3561--><p class="indent" > <div class="important" title="Important Note"> The commands <span +class="ectt-1000">\GlsSetXdyLanguage </span>and <span +class="ectt-1000">\GlsSetXdyCodePage </span>have no effect if +you don’t use <a + id="dx1-35017"></a><a +href="#glo:makeglossaries"><span +class="ectt-1000">makeglossaries</span><a + id="dx1-35018"></a></a>. If you call <a + id="dx1-35019"></a><a +href="#glo:xindy"><span +class="ectt-1000">xindy</span><a + id="dx1-35020"></a></a> without <a + id="dx1-35021"></a><span +class="ectt-1000">makeglossaries</span><a + id="dx1-35022"></a> you need to +remember to set the language and encoding using the <span +class="ectt-1000">-L </span>and <span +class="ectt-1000">-C </span>switches. +</div> +</p><!--l. 3567--><p class="noindent" > +</p><!--l. 3570--><p class="noindent" > +</p> +<!--l. 3570--><p class="noindent" ><a +href="#top">Top</a></p><h4 class="subsectionHead"><span class="titlemark">11.2 </span> <a + id="x1-3600011.2"></a>Locations and Number lists</h4> +<!--l. 3573--><p class="noindent" >If you use <span +class="ecss-1000">xindy</span><a + id="dx1-36001"></a>, the <span +class="ecss-1000">glossaries </span>package needs to know which counters you will be using +in the <a + id="dx1-36002"></a><a +href="#glo:numberlist">number list<a + id="dx1-36003"></a></a> in order to correctly format the <a + id="dx1-36004"></a><a +href="#glo:xindy"><span +class="ectt-1000">xindy</span><a + id="dx1-36005"></a></a> style file. Counters specified +using the <span +class="ecss-1000">counter</span><a + id="dx1-36006"></a> package option or the <span +class="cmsy-10">⟨</span><span +class="ecti-1000">counter</span><span +class="cmsy-10">⟩ </span>option of <span +class="ectt-1000">\newglossary</span><a + id="dx1-36007"></a> are +automatically taken care of, but if you plan to use a different counter in the <span +class="ecss-1000">counter</span><a + id="dx1-36008"></a> key +for commands like <span +class="ectt-1000">\glslink</span><a + id="dx1-36009"></a>, then you need to identify these counters <span +class="ecti-1000">before</span> +<span +class="ectt-1000">\makeglossaries</span><a + id="dx1-36010"></a> using: +</p><!--l. 3581--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\GlsAddXdyCounters</span><span +class="ectt-0900"> </span></span><a + id="dx1-36011"></a> <span +class="ectt-1000">\GlsAddXdyCounters{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">counter list</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">} </span></div><hr> +</p><!--l. 3583--><p class="noindent" > +where <span +class="cmsy-10">⟨</span><span +class="ecti-1000">counter list</span><span +class="cmsy-10">⟩ </span>is a comma-separated list of counter names. +</p><!--l. 3586--><p class="indent" > The most likely attributes used in the <span +class="ecss-1000">format</span><a + id="dx1-36012"></a> key (<span +class="ectt-1000">textrm</span><a + id="dx1-36013"></a>, <span +class="ectt-1000">hyperrm</span><a + id="dx1-36014"></a> etc) are +automatically added to the <a + id="dx1-36015"></a><a +href="#glo:xindy"><span +class="ectt-1000">xindy</span><a + id="dx1-36016"></a></a> style file, but if you want to use another attribute, +you need to add it using: +</p><!--l. 3590--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\GlsAddXdyAttribute</span><span +class="ectt-0900"> </span></span><a + id="dx1-36017"></a> <span +class="ectt-1000">\GlsAddXdyAttribute{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">name</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">} </span></div><hr> +</p><!--l. 3592--><p class="noindent" > +where <span +class="cmsy-10">⟨</span><span +class="ecti-1000">name</span><span +class="cmsy-10">⟩ </span>is the name of the attribute, as used in the <span +class="ecss-1000">format</span><a + id="dx1-36018"></a> key. For example, +suppose I want a bold, italic, hyperlinked location. I first need to define a command +that will do this: + + + +</p> + <div class="verbatim" id="verbatim-98"> +\newcommand*{\hyperbfit}[1]{\textit{\hyperbf{#1}}} +</div> +<!--l. 3599--><p class="nopar" > but with <a + id="dx1-36019"></a><a +href="#glo:xindy"><span +class="ectt-1000">xindy</span><a + id="dx1-36020"></a></a>, I also need to add this as an allowed attribute: + + + +</p> + <div class="verbatim" id="verbatim-99"> +\GlsAddXdyAttribute{hyperbfit} +</div> +<!--l. 3604--><p class="nopar" > +</p><!--l. 3606--><p class="indent" > <div class="important" title="Important Note"> Note that <span +class="ectt-1000">\GlsAddXdyAttribute </span>has no effect if <span +class="ectt-1000">\noist</span><a + id="dx1-36021"></a> is used or if +<span +class="ectt-1000">\makeglossaries</span><a + id="dx1-36022"></a> is omitted. <span +class="ectt-1000">\GlsAddXdyAttribute </span>must be used before +<span +class="ectt-1000">\makeglossaries</span><a + id="dx1-36023"></a>. Additionally, <span +class="ectt-1000">\GlsAddXdyCounters </span>must come before +<span +class="ectt-1000">\GlsAddXdyAttribute</span>. </div> +</p><!--l. 3612--><p class="noindent" > +</p><!--l. 3614--><p class="indent" > If the location numbers don’t get expanded to a simple Arabic or Roman number or +a letter from a, …, z or A, …, Z, then you need to add a location style in the appropriate +format using +</p><!--l. 3617--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\GlsAddXdyLocation</span><span +class="ectt-0900"> </span></span><a + id="dx1-36024"></a> <span +class="ectt-1000">\GlsAddXdyLocation[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">prefix-location</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">]{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">name</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">definition</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}</span> +</div><hr> +</p><!--l. 3619--><p class="noindent" > +where <span +class="cmsy-10">⟨</span><span +class="ecti-1000">name</span><span +class="cmsy-10">⟩ </span>is the name of the format and <span +class="cmsy-10">⟨</span><span +class="ecti-1000">definition</span><span +class="cmsy-10">⟩ </span>is the <a + id="dx1-36025"></a><a +href="#glo:xindy"><span +class="ectt-1000">xindy</span><a + id="dx1-36026"></a></a> definition. The +optional argument <span +class="cmsy-10">⟨</span><span +class="ecti-1000">prefix-location</span><span +class="cmsy-10">⟩ </span>is needed if <span +class="ectt-1000">\theH</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">counter</span><span +class="cmsy-10">⟩ </span>either isn’t defined or is +different from <span +class="ectt-1000">\the</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">counter</span><span +class="cmsy-10">⟩</span>. +</p><!--l. 3625--><p class="indent" > <div class="important" title="Important Note"> Note that <span +class="ectt-1000">\GlsAddXdyLocation </span>has no effect if <span +class="ectt-1000">\noist</span><a + id="dx1-36027"></a> is used or +if <span +class="ectt-1000">\makeglossaries</span><a + id="dx1-36028"></a> is omitted. <span +class="ectt-1000">\GlsAddXdyLocation </span>must be used before +<span +class="ectt-1000">\makeglossaries</span><a + id="dx1-36029"></a>. </div> +</p><!--l. 3629--><p class="noindent" > +</p><!--l. 3631--><p class="indent" > For example, suppose I decide to use a somewhat eccentric numbering system for +sections that redefines <span +class="ectt-1000">\thesection </span>as follows: + + + +</p> + <div class="verbatim" id="verbatim-100"> +\renewcommand*{\thesection}{[\thechapter]\arabic{section}} +</div> +<!--l. 3635--><p class="nopar" > If I haven’t done <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">counter=section</span></span></span> in the package option, I need to specify that the +counter will be used as a location number: + + + +</p> + <div class="verbatim" id="verbatim-101"> +\GlsAddXdyCounters{section} +</div> +<!--l. 3641--><p class="nopar" > Next I need to add the location style (<span +class="ectt-1000">\thechapter </span>is assumed to be the standard +<span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\arabic{chapter}</span></span></span>): + + + +</p> + <div class="verbatim" id="verbatim-102"> +\GlsAddXdyLocation{section}{:sep "[" "arabic-numbers" :sep "]" + <br />  "arabic-numbers" + <br />} +</div> +<!--l. 3648--><p class="nopar" > Note that if I have further decided to use the <span +class="ecss-1000">hyperref</span><a + id="dx1-36030"></a> package and want to redefine +<span +class="ectt-1000">\theHsection </span>as: + + + +</p> + <div class="verbatim" id="verbatim-103"> +\renewcommand*{\theHsection}{\thepart.\thesection} + <br />\renewcommand*{\thepart}{\Roman{part}} +</div> +<!--l. 3654--><p class="nopar" > then I need to modify the <span +class="ectt-1000">\GlsAddXdyLocation </span>code above to: + + + +</p> + <div class="verbatim" id="verbatim-104"> +\GlsAddXdyLocation["roman-numbers-uppercase"]{section}{:sep "[" + <br />  "arabic-numbers" :sep "]" "arabic-numbers" + <br />} +</div> +<!--l. 3660--><p class="nopar" > Since <span +class="ectt-1000">\Roman</span><a + id="dx1-36031"></a> will result in an empty string if the counter is zero, it’s a good idea to +add an extra location to catch this: + + + +</p> + <div class="verbatim" id="verbatim-105"> +\GlsAddXdyLocation{zero.section}{:sep "[" + <br />  "arabic-numbers" :sep "]" "arabic-numbers" + <br />} +</div> +<!--l. 3667--><p class="nopar" > The above example is illustrated in the accompanying sample file <a +href="#x1-40001.1"><span +class="ectt-1000">samplexdy2.tex</span></a>. +</p><!--l. 3671--><p class="indent" > Another example: suppose you want the page numbers written as words rather than +digits and you use the <span +class="ecss-1000">fmtcount</span><a + id="dx1-36032"></a> package to do this. You can redefine <span +class="ectt-1000">\thepage</span><a + id="dx1-36033"></a> as +follows: + + + +</p> + <div class="verbatim" id="verbatim-106"> +\renewcommand*{\thepage}{\Numberstring{page}} +</div> +<!--l. 3676--><p class="nopar" > This gets expanded to <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\protect</span><span +class="ectt-1000"> \Numberstringnum</span><span +class="ectt-1000"> </span></span></span><span +class="ectt-1000">{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">n</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">} </span>where <span +class="cmsy-10">⟨</span><span +class="ecti-1000">n</span><span +class="cmsy-10">⟩ </span>is the Arabic +page number. This means that you need to define a new location that has that +form: + + + +</p> + <div class="verbatim" id="verbatim-107"> +\GlsAddXdyLocation{Numberstring}{:sep "\string\protect\space + <br />  \string\Numberstringnum\space\glsopenbrace" + <br />  "arabic-numbers" :sep "\glsclosebrace"} +</div> +<!--l. 3684--><p class="nopar" > Note that it’s necessary to use <span +class="ectt-1000">\space </span>to indicate that spaces also appear +in the format, since, unlike <span class="TEX">T<span +class="E">E</span>X</span>, <a + id="dx1-36034"></a><a +href="#glo:xindy"><span +class="ectt-1000">xindy</span><a + id="dx1-36035"></a></a> doesn’t ignore spaces after control +sequences. +</p><!--l. 3689--><p class="indent" > <span +class="ectt-1000">\GlsAddXdyLocation{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">name</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">definition</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">} </span>will define commands +</p><!--l. 3691--><p class="indent" > <hr><div title="Definition"><span +class="ectt-1000">\glsX</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">counter</span><span +class="cmsy-10">⟩</span><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">X</span></span></span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">name</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">Hprefix</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">location</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">} </span></div><hr> +</p><!--l. 3692--><p class="noindent" > +for each counter that has been identified either by the <span +class="ecss-1000">counter</span><a + id="dx1-36036"></a> package option, the +<span +class="cmsy-10">⟨</span><span +class="ecti-1000">counter</span><span +class="cmsy-10">⟩ </span>option for <span +class="ectt-1000">\newglossary</span><a + id="dx1-36037"></a> or in the argument of <span +class="ectt-1000">\GlsAddXdyCounters</span><a + id="dx1-36038"></a>. +</p><!--l. 3697--><p class="indent" > The first argument <span +class="cmsy-10">⟨</span><span +class="ecti-1000">Hprefix</span><span +class="cmsy-10">⟩ </span>is only relevant when used with the <span +class="ecss-1000">hyperref</span><a + id="dx1-36039"></a> package +and indicates that <span +class="ectt-1000">\the</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">Hcounter</span><span +class="cmsy-10">⟩ </span>is given by <span +class="ectt-1000">\Hprefix</span><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">.</span></span></span><span +class="ectt-1000">\the</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">counter</span><span +class="cmsy-10">⟩</span>. The sample +file <a +href="#x1-40001.1"><span +class="ectt-1000">samplexdy.tex</span></a>, which comes with the <span +class="ecss-1000">glossaries </span>package, uses the default <span +class="ecss-1000">page</span><a + id="dx1-36040"></a> +counter for locations, and it uses the default <span +class="ectt-1000">\glsnumberformat</span><a + id="dx1-36041"></a> and a custom +<span +class="ectt-1000">\hyperbfit </span>format. A new <a + id="dx1-36042"></a><a +href="#glo:xindy"><span +class="ectt-1000">xindy</span><a + id="dx1-36043"></a></a> location called <span +class="ectt-1000">Numberstring</span>, as illustrated above, is +defined to make the page numbers appear as “One”, “Two”, etc. In order for the location +numbers to hyperlink to the relevant pages, I need to redefine the necessary +<span +class="ectt-1000">\glsX</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">counter</span><span +class="cmsy-10">⟩</span><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">X</span></span></span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">format</span><span +class="cmsy-10">⟩ </span>commands: + + + +</p> + <div class="verbatim" id="verbatim-108"> +\renewcommand{\glsXpageXglsnumberformat}[2]{% + <br /> \linkpagenumber#2% + <br />} + <br />\renewcommand{\glsXpageXhyperbfit}[2]{% + <br /> \textbf{\em\linkpagenumber#2}% + <br />} + <br />\newcommand{\linkpagenumber}[3]{\hyperlink{page.#3}{#1#2{#3}}} +</div> +<!--l. 3718--><p class="nopar" > +</p><!--l. 3720--><p class="indent" > In the <a + id="dx1-36044"></a><a +href="#glo:numberlist">number list<a + id="dx1-36045"></a></a>, the locations are sorted according to type. The default ordering is: +<span +class="ectt-1000">roman-page-numbers </span>(e.g. i), <span +class="ectt-1000">arabic-page-numbers </span>(e.g. 1), <span +class="ectt-1000">arabic-section-numbers</span> +(e.g. 1.1 if the compositor is a full stop or 1-1 if the compositor is a +hyphen<span class="footnote-mark"><a +href="#fn14x0" id="fn14x0-bk"><sup class="textsuperscript">14</sup></a></span><a + id="x1-36046f14"></a>), +<span +class="ectt-1000">alpha-page-numbers </span>(e.g. a), <span +class="ectt-1000">Roman-page-numbers </span>(e.g. I), +<span +class="ectt-1000">Alpha-page-numbers </span>(e.g. A), <span +class="ectt-1000">Appendix-page-numbers </span>(e.g. A.1 if +the Alpha compositor is a full stop or A-1 if the Alpha compositor is a +hyphen<span class="footnote-mark"><a +href="#fn15x0" id="fn15x0-bk"><sup class="textsuperscript">15</sup></a></span><a + id="x1-36048f15"></a>), +user defined location names (as specified by <span +class="ectt-1000">\GlsAddXdyLocation</span><a + id="dx1-36050"></a> in the order in which +they were defined), <span +class="ectt-1000">see </span>(cross-referenced entries). This ordering can be changed +using: +</p><!--l. 3736--><p class="indent" > <span class="marginpar"><span +class="ectt-0900">\GlsSetXdyLocationClassOrder</span><span +class="ectt-0900"> </span></span><a + id="dx1-36051"></a> +</p><!--l. 3738--><p class="indent" > <hr><div title="Definition"><span +class="ectt-1000">\GlsSetXdyLocationClassOrder{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">location names</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">} </span></div><hr> +</p><!--l. 3739--><p class="noindent" > +where each location name is delimited by double quote marks and separated by white +space. For example: + + + +</p> + <div class="verbatim" id="verbatim-109"> +\GlsSetXdyLocationClassOrder{ + <br />  "arabic-page-numbers" + <br />  "arabic-section-numbers" + <br />  "roman-page-numbers" + <br />  "Roman-page-numbers" + <br />  "alpha-page-numbers" + <br />  "Alpha-page-numbers" + <br />  "Appendix-page-numbers" + <br />  "see" + <br />} +</div> +<!--l. 3753--><p class="nopar" > +</p><!--l. 3755--><p class="indent" > +<div class="important" title="Important Note">Note +that +<span +class="ectt-1000">\GlsSetXdyLocationClassOrder</span> +has +no +effect +if +<span +class="ectt-1000">\noist</span><a + id="dx1-36052"></a> +is +used +or +if +<span +class="ectt-1000">\makeglossaries</span><a + id="dx1-36053"></a> +is +omitted. +<span +class="ectt-1000">\GlsSetXdyLocationClassOrder</span> +must +be +used +before +<span +class="ectt-1000">\makeglossaries</span><a + id="dx1-36054"></a>. +</div> +</p><!--l. 3760--><p class="noindent" > +</p><!--l. 3762--><p class="indent" > If a <a + id="dx1-36055"></a><a +href="#glo:numberlist">number list<a + id="dx1-36056"></a></a> consists of a sequence of consecutive numbers, the range will be +concatenated. The number of consecutive locations that causes a range formation +defaults to 2, but can be changed using: +</p><!--l. 3766--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\GlsSetXdyMinRangeLength</span><span +class="ectt-0900"> </span></span><a + id="dx1-36057"></a> <span +class="ectt-1000">\GlsSetXdyMinRangeLength{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">n</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">} </span></div><hr> + + + +</p><!--l. 3768--><p class="noindent" > +For example: + + + +</p> + <div class="verbatim" id="verbatim-110"> +\GlsSetXdyMinRangeLength{3} +</div> +<!--l. 3772--><p class="nopar" > The argument may also be the keyword <span +class="ectt-1000">none</span>, to indicate that there should +be no range formations. See the <a + id="dx1-36058"></a><a +href="#glo:xindy"><span +class="ectt-1000">xindy</span><a + id="dx1-36059"></a></a> manual for further details on range +formations. +</p><!--l. 3777--><p class="indent" > <div class="important" title="Important Note"> Note that <span +class="ectt-1000">\GlsSetXdyMinRangeLength </span>has no effect if <span +class="ectt-1000">\noist</span><a + id="dx1-36060"></a> is used or if +<span +class="ectt-1000">\makeglossaries</span><a + id="dx1-36061"></a> is omitted. <span +class="ectt-1000">\GlsSetXdyMinRangeLength </span>must be used before +<span +class="ectt-1000">\makeglossaries</span><a + id="dx1-36062"></a>. </div> +</p><!--l. 3782--><p class="noindent" > +</p><!--l. 3784--><p class="indent" > See <a +href="#x1-250005">§5 </a><a +href="#x1-250005">Number lists<!--tex4ht:ref: sec:numberlists --></a> for further details. +</p><!--l. 3787--><p class="noindent" > +</p> +<!--l. 3787--><p class="noindent" ><a +href="#top">Top</a></p><h4 class="subsectionHead"><span class="titlemark">11.3 </span> <a + id="x1-3700011.3"></a>Glossary Groups</h4> +<!--l. 3789--><p class="noindent" >The glossary is divided into groups according to the first letter of the sort key. The +<span +class="ecss-1000">glossaries </span>package also adds a number group by default, unless you suppress it in the +<span +class="ecss-1000">xindy</span><a + id="dx1-37001"></a> package option. For example: + + + +</p> + <div class="verbatim" id="verbatim-111"> +\usepackage[xindy={glsnumbers=false}]{glossaries} +</div> +<!--l. 3795--><p class="nopar" > Any entry that doesn’t go in one of the letter groups or the number group is placed in +the default group. +</p><!--l. 3799--><p class="indent" > If you have a number group, the default behaviour is to locate it before the “A” +letter group. If you are not using a Roman alphabet, you can change this +using: +</p><!--l. 3803--><p class="indent" > <span class="marginpar"><span +class="ectt-0900">\GlsSetXdyFirstLetterAfterDigits</span><span +class="ectt-0900"> </span></span><a + id="dx1-37002"></a> +</p><!--l. 3805--><p class="indent" > <hr><div title="Definition"><span +class="ectt-1000">\GlsSetXdyFirstLetterAfterDigits{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">letter</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">} </span></div><hr> +</p><!--l. 3806--><p class="noindent" > +</p><!--l. 3808--><p class="indent" > +<div class="important" title="Important Note">Note +that +<span +class="ectt-1000">\GlsSetXdyFirstLetterAfterDigits</span> +has +no +effect +if +<span +class="ectt-1000">\noist</span><a + id="dx1-37003"></a> +is +used +or +if +<span +class="ectt-1000">\makeglossaries</span><a + id="dx1-37004"></a> +is +omitted. +<span +class="ectt-1000">\GlsSetXdyFirstLetterAfterDigits</span> +must +be +used +before +<span +class="ectt-1000">\makeglossaries</span><a + id="dx1-37005"></a>. +</div> +</p><!--l. 3813--><p class="noindent" > +</p><!--l. 3816--><p class="noindent" > +</p> + + + +<!--l. 3816--><p class="noindent" ><a +href="#top">Top</a></p><h3 class="sectionHead"><span class="titlemark">12 </span> <a + id="x1-3800012"></a>Defining New Glossaries</h3> +<!--l. 3819--><p class="noindent" >A new glossary can be defined using: +</p><!--l. 3820--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\newglossary</span><span +class="ectt-0900"> </span></span><a + id="dx1-38001"></a> <span +class="ectt-1000">\newglossary[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">log-ext</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">]{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">name</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">in-ext</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">out-ext</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">title</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">counter</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">]</span> +</div><hr> +</p><!--l. 3822--><p class="noindent" > +where <span +class="cmsy-10">⟨</span><span +class="ecti-1000">name</span><span +class="cmsy-10">⟩ </span>is the label to assign to this glossary. The arguments <span +class="cmsy-10">⟨</span><span +class="ecti-1000">in-ext</span><span +class="cmsy-10">⟩</span> +and <span +class="cmsy-10">⟨</span><span +class="ecti-1000">out-ext</span><span +class="cmsy-10">⟩ </span>specify the extensions to give to the input and output files for +that glossary, <span +class="cmsy-10">⟨</span><span +class="ecti-1000">title</span><span +class="cmsy-10">⟩ </span>is the default title for this new glossary and the final +optional argument <span +class="cmsy-10">⟨</span><span +class="ecti-1000">counter</span><span +class="cmsy-10">⟩ </span>specifies which counter to use for the associated +<a + id="dx1-38002"></a><a +href="#glo:numberlist">number list<a + id="dx1-38003"></a>s</a> (see also <a +href="#x1-250005">§5 </a><a +href="#x1-250005">Number lists<!--tex4ht:ref: sec:numberlists --></a>). The first optional argument specifies the +extension for the <a + id="dx1-38004"></a><a +href="#glo:makeindex"><span +class="ectt-1000">makeindex</span><a + id="dx1-38005"></a></a> or <a + id="dx1-38006"></a><a +href="#glo:xindy"><span +class="ectt-1000">xindy</span><a + id="dx1-38007"></a></a> transcript file (this information is only +used by <a + id="dx1-38008"></a><a +href="#glo:makeglossaries"><span +class="ectt-1000">makeglossaries</span><a + id="dx1-38009"></a></a> which picks up the information from the auxiliary +file). +</p><!--l. 3834--><p class="indent" > Note that the main (default) glossary is automatically created as: + + + +</p> + <div class="verbatim" id="verbatim-112"> +\newglossary{main}{gls}{glo}{\glossaryname} +</div> +<!--l. 3837--><p class="nopar" > so it can be identified by the label <span +class="ectt-1000">main </span>(unless the <span +class="ecss-1000">nomain</span><a + id="dx1-38010"></a> package option is used). +Using the <span +class="ecss-1000">acronym</span><a + id="dx1-38011"></a> package option is equivalent to: + + + +</p> + <div class="verbatim" id="verbatim-113"> +\newglossary[alg]{acronym}{acr}{acn}{\acronymname} +</div> +<!--l. 3843--><p class="nopar" > so it can be identified by the label <span +class="ectt-1000">acronym</span>. If you are not sure whether the <span +class="ecss-1000">acronym</span><a + id="dx1-38012"></a> +option has been used, you can identify the list of acronyms by the command +<span class="marginpar"><span +class="ectt-0900">\acronymtype</span><span +class="ectt-0900"> </span></span><a + id="dx1-38013"></a><span +class="ectt-1000">\acronymtype </span>which is set to <span +class="ectt-1000">acronym</span>, if the <span +class="ecss-1000">acronym</span><a + id="dx1-38014"></a> option has been +used, otherwise it is set to <span +class="ectt-1000">main</span>. Note that if you are using the main glossary as your +list of acronyms, you need to declare it as a list of acronyms using the package option +<span +class="ecss-1000">acronymlists</span><a + id="dx1-38015"></a>. +</p><!--l. 3854--><p class="indent" > <div class="important" title="Important Note"> All glossaries must be defined before <span +class="ectt-1000">\makeglossaries</span><a + id="dx1-38016"></a> to ensure that the relevant +output files are opened. </div> +</p><!--l. 3857--><p class="noindent" > +</p><!--l. 3860--><p class="noindent" > +</p> +<!--l. 3860--><p class="noindent" ><a +href="#top">Top</a></p><h3 class="sectionHead"><span class="titlemark">13 </span> <a + id="x1-3900013"></a>Acronyms</h3> +<!--l. 3863--><p class="noindent" >You may have noticed in <a +href="#x1-190004">§4 </a><a +href="#x1-190004">Defining Glossary Entries<!--tex4ht:ref: sec:newglosentry --></a> that when you specify a new +entry, you can specify alternate text to use when the term is <a + id="dx1-39001"></a><a +href="#glo:firstuse">first used</a> in the document. +This provides a useful means to define acronyms. For convenience, the <span +class="ecss-1000">glossaries </span>package +defines the command: +</p><!--l. 3868--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\newacronym</span><span +class="ectt-0900"> </span></span><a + id="dx1-39002"></a> <span +class="ectt-1000">\newacronym[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">key-val list</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">]{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">abbrv</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">long</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">} </span></div><hr> +</p><!--l. 3871--><p class="noindent" > +</p><!--l. 3873--><p class="indent" > This uses <span +class="ectt-1000">\newglossaryentry</span><a + id="dx1-39003"></a> to create an entry with the given label in the glossary +given by <span +class="ectt-1000">\acronymtype</span><a + id="dx1-39004"></a>. Amongst other things, it sets up the <span +class="ecss-1000">first</span><a + id="dx1-39005"></a> and <span +class="ecss-1000">text</span><a + id="dx1-39006"></a> keys and, +depending on the acronym style, may also use <span +class="ectt-1000">\defdisplayfirst</span><a + id="dx1-39007"></a> and <span +class="ectt-1000">\defdisplay</span><a + id="dx1-39008"></a> +(see <a +href="#x1-270006.1">§6.1 </a><a +href="#x1-270006.1">Changing the format of the link text<!--tex4ht:ref: sec:glsdisplay --></a>). +</p><!--l. 3879--><p class="indent" > The optional argument <span +class="ectt-1000">{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">key-val list</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">} </span>allows you to specify keys such as <span +class="ecss-1000">description</span><a + id="dx1-39009"></a> +(when used with the <span +class="ecss-1000">description</span><a + id="dx1-39010"></a> package option, described below) or you can override +plural forms of <span +class="cmsy-10">⟨</span><span +class="ecti-1000">abbrv</span><span +class="cmsy-10">⟩ </span>or <span +class="cmsy-10">⟨</span><span +class="ecti-1000">long</span><span +class="cmsy-10">⟩ </span>using the <span +class="ecss-1000">shortplural</span><a + id="dx1-39011"></a> or <span +class="ecss-1000">longplural</span><a + id="dx1-39012"></a> keys. For +example: + + + +</p> + <div class="verbatim" id="verbatim-114"> +\newacronym[longplural={diagonal matrices}]{dm}{DM}{diagonal + <br />matrix} +</div> +<!--l. 3888--><p class="nopar" > If the <a + id="dx1-39013"></a><a +href="#glo:firstuse">first use</a> uses the plural form, <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\glspl{dm}</span></span></span> will display: diagonal matrices +(DMs). +</p><!--l. 3893--><p class="indent" > The following package options are available to change the acronym style: +</p><!--l. 3896--><p class="indent" > + </p><dl class="description"><dt class="description"> +<span +class="ecsx-1000">description</span><a + id="dx1-39014"></a> </dt><dd +class="description">With this package option, the <span +class="ecss-1000">description</span><a + id="dx1-39015"></a> key needs to be set in the + optional argument <span +class="cmsy-10">⟨</span><span +class="ecti-1000">key-val list</span><span +class="cmsy-10">⟩ </span>of <span +class="ectt-1000">\newacronym</span>. (If this package option isn’t + used, the long form <span +class="cmsy-10">⟨</span><span +class="ecti-1000">long</span><span +class="cmsy-10">⟩ </span>is put in the <span +class="ecss-1000">description</span><a + id="dx1-39016"></a> key.) + </dd><dt class="description"> +<span +class="ecsx-1000">footnote</span><a + id="dx1-39017"></a> </dt><dd +class="description">With this package option, on <a + id="dx1-39018"></a><a +href="#glo:firstuse">first use</a> the long form <span +class="cmsy-10">⟨</span><span +class="ecti-1000">long</span><span +class="cmsy-10">⟩ </span>is placed in a + footnote. By default the long form in the footnote will link to the relevant + entry in the glossary or list of acronyms. You can prevent this link by + doing: + + + + <div class="verbatim" id="verbatim-115"> + \let\acrfootnote\acrnolinkfootnote +</div> + <!--l. 3910--><p class="nopar" > + </p></dd><dt class="description"> +<span +class="ecsx-1000">smallcaps</span><a + id="dx1-39019"></a> </dt><dd +class="description">With this package option, the short form <span +class="cmsy-10">⟨</span><span +class="ecti-1000">abbrv</span><span +class="cmsy-10">⟩ </span>is typeset using + <span +class="ectt-1000">\textsc</span><a + id="dx1-39020"></a>. (Recall that <span +class="ectt-1000">\textsc </span>converts lower case characters into small + capitals and leaves upper case characters as they are. Therefore, you + need to have lower case characters in <span +class="cmsy-10">⟨</span><span +class="ecti-1000">abbrv</span><span +class="cmsy-10">⟩ </span>for this option to have an + effect.) + </dd><dt class="description"> +<span +class="ecsx-1000">smaller</span><a + id="dx1-39021"></a> </dt><dd +class="description">This is similar to <span +class="ecss-1000">smallcaps</span><a + id="dx1-39022"></a>, except that <span +class="ectt-1000">\textsmaller</span><a + id="dx1-39023"></a> is used instead of + <span +class="ectt-1000">\textsc</span><a + id="dx1-39024"></a>. Note that the <span +class="ecss-1000">glossaries </span>package doesn’t define <span +class="ectt-1000">\textsmaller</span><a + id="dx1-39025"></a> nor does it + load any package that does so. If you use this option, you must make sure + <span +class="ectt-1000">\textsmaller</span><a + id="dx1-39026"></a> is defined (for example by loading <span +class="ecss-1000">relsize</span><a + id="dx1-39027"></a>). + </dd><dt class="description"> +<span +class="ecsx-1000">dua</span><a + id="dx1-39028"></a> </dt><dd +class="description">This option will set both the <span +class="ecss-1000">first</span><a + id="dx1-39029"></a> and <span +class="ecss-1000">text</span><a + id="dx1-39030"></a> keys to the long form <span +class="cmsy-10">⟨</span><span +class="ecti-1000">long</span><span +class="cmsy-10">⟩</span>.</dd></dl> +<!--l. 3931--><p class="indent" > If you want to define your own custom acronym style, see <a +href="#x1-4200013.3">§13.3 </a><a +href="#x1-4200013.3">Defining A Custom +Acronym Style<!--tex4ht:ref: sec:customacronym --></a>. +</p><!--l. 3934--><p class="indent" > <div class="important" title="Important Note"> If you try using <span +class="ectt-1000">\newglossaryentry</span><a + id="dx1-39031"></a> for entries in a designated list of acronyms in +combination with any of the above named package options you are likely to get +unexpected results such as empty brackets or empty footnotes. +</p><!--l. 3940--><p class="indent" > If you don’t intend to use <span +class="ectt-1000">\newacronym</span><a + id="dx1-39032"></a> you should skip this section] and not use the +above package options. </div> +</p><!--l. 3942--><p class="noindent" > +</p><!--l. 3944--><p class="indent" > As mentioned in <a +href="#x1-140002.2">§2.2 </a><a +href="#x1-140002.2">Sectioning and TOC Options<!--tex4ht:ref: sec:pkgopts-sec --></a>, the command <span +class="ectt-1000">\acronymtype</span><a + id="dx1-39033"></a> is +the name of the glossary in which the acronyms should appear. If the <span +class="ecss-1000">acronym</span><a + id="dx1-39034"></a> package +option has been used, this will be <span +class="ectt-1000">acronym</span>, otherwise it will be <span +class="ectt-1000">main</span>. The acronyms can +then be used in exactly the same way as any other glossary entry. If you want more +than one list of acronyms, you must identify the others using the package options +<span +class="ecss-1000">acronymlists</span><a + id="dx1-39035"></a>. This ensures that options such as <span +class="ecss-1000">footnote</span><a + id="dx1-39036"></a> and <span +class="ecss-1000">smallcaps</span><a + id="dx1-39037"></a> work for the +additional lists of acronyms. +</p><!--l. 3954--><p class="indent" > +<div class="important" title="Important Note">Since +<span +class="ectt-1000">\newacronym</span> +sets +<span class="obeylines-h"><span class="verb"><span +class="ectt-1000">type=\acronymtype</span></span></span>, +if + + + +you +want +to +load +a +file +containing +acronym +definitions +using +<span +class="ectt-1000">\loadglsentries</span><a + id="dx1-39038"></a><span +class="ectt-1000">[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">type</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">]{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">filename</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}</span>, +the +optional +argument +<span +class="cmsy-10">⟨</span><span +class="ecti-1000">type</span><span +class="cmsy-10">⟩</span> +will +not +have +an +effect +unless +you +explicitly +set +the +type +as +<span class="obeylines-h"><span class="verb"><span +class="ectt-1000">type=\glsdefaulttype</span></span></span> +in +the +optional +argument +to +<span +class="ectt-1000">\newacronym</span><a + id="dx1-39039"></a>. +See +<a +href="#x1-240004.3">§4.3 +</a><a +href="#x1-240004.3">Loading +Entries +From +a +File<!--tex4ht:ref: sec:loadglsentries --></a>. +</div> +</p><!--l. 3961--><p class="noindent" > +</p><!--l. 3963--><p class="indent" > Since <span +class="ectt-1000">\newacronym</span><a + id="dx1-39040"></a> uses <span +class="ectt-1000">\newglossaryentry</span><a + id="dx1-39041"></a>, you can use commands like <span +class="ectt-1000">\gls</span><a + id="dx1-39042"></a> and +<span +class="ectt-1000">\glsreset</span><a + id="dx1-39043"></a> as with any other glossary entry. + + + +</p><!--l. 3967--><p class="indent" > For example, the following defines the acronym IDN: + + + +</p> + <div class="verbatim" id="verbatim-116"> +\newacronym{idn}{IDN}{identification number} +</div> +<!--l. 3970--><p class="nopar" > <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\gls{idn}</span></span></span> will produce “identification number (IDN)” on <a + id="dx1-39044"></a><a +href="#glo:firstuse">first use</a> and “IDN” on +subsequent uses. If you want to use the <span +class="ecss-1000">smallcaps</span><a + id="dx1-39045"></a> package option, you need to use lower +case characters for the shortened form: + + + +</p> + <div class="verbatim" id="verbatim-117"> +\newacronym{idn}{idn}{identification number} +</div> +<!--l. 3977--><p class="nopar" > Now <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\gls{idn}</span></span></span> will produce “identification number (<span +class="eccc-1000"><span +class="small-caps">I</span><span +class="small-caps">D</span><span +class="small-caps">N</span></span>)” on <a + id="dx1-39046"></a><a +href="#glo:firstuse">first use</a> and “<span +class="eccc-1000">IDN</span>” on +subsequent uses. +</p><!--l. 3982--><p class="indent" > If you use any of the package options <span +class="ecss-1000">smallcaps</span><a + id="dx1-39047"></a>, <span +class="ecss-1000">smaller</span><a + id="dx1-39048"></a>, <span +class="ecss-1000">description</span><a + id="dx1-39049"></a> or <span +class="ecss-1000">footnote</span><a + id="dx1-39050"></a>, the +short form <span +class="cmsy-10">⟨</span><span +class="ecti-1000">abbrv</span><span +class="cmsy-10">⟩ </span>will be displayed in the document using: +</p><!--l. 3985--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\acronymfont</span><span +class="ectt-0900"> </span></span><a + id="dx1-39051"></a> <span +class="ectt-1000">\acronymfont{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">text</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">} </span></div><hr> +</p><!--l. 3987--><p class="noindent" > +and +</p><!--l. 3989--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\firstacronymfont</span><span +class="ectt-0900"> </span></span><a + id="dx1-39052"></a> <span +class="ectt-1000">\firstacronymfont{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">text</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">} </span></div><hr> +</p><!--l. 3991--><p class="noindent" > +where <span +class="ectt-1000">\firstacronymfont </span>is applied on <a + id="dx1-39053"></a><a +href="#glo:firstuse">first use</a> and <span +class="ectt-1000">\acronymfont </span>is applied on +subsequent use. Note that if you don’t use any of the above package options, changing +the definition of <span +class="ectt-1000">\acronymfont </span>or <span +class="ectt-1000">\firstacronymfont </span>will have no effect. In this case, +the recommended route is to use either the <span +class="ecss-1000">smaller</span><a + id="dx1-39054"></a> or the <span +class="ecss-1000">smallcaps</span><a + id="dx1-39055"></a> package option and +redefine <span +class="ectt-1000">\acronymfont </span>and <span +class="ectt-1000">\firstacronymfont </span>as required. (The <span +class="ecss-1000">smallcaps</span><a + id="dx1-39056"></a> option sets +the default plural suffix in an upright font to cancel the effect of <span +class="ectt-1000">\textsc</span><a + id="dx1-39057"></a>, +whereas <span +class="ecss-1000">smaller</span><a + id="dx1-39058"></a> sets the suffix in the surrounding font.) For example, if you want +acronyms in a normal font on <a + id="dx1-39059"></a><a +href="#glo:firstuse">first use</a> and emphasized on subsequent use, +do: + + + +</p> + <div class="verbatim" id="verbatim-118"> +\usepackage[smaller]{glossaries} + <br />\renewcommand*{\firstacronymfont}[1]{#1} + <br />\renewcommand*{\acronymfont}[1]{\emph{#1}} +</div> +<!--l. 4008--><p class="nopar" > (Note that it is for this reason that the <span +class="ecss-1000">relsize</span><a + id="dx1-39060"></a> package is not automatically loaded +when selecting the <span +class="ecss-1000">smaller</span><a + id="dx1-39061"></a> package option.) +</p><!--l. 4013--><p class="indent" > There are commands analogous to <span +class="ectt-1000">\glstext</span><a + id="dx1-39062"></a> (described in <a +href="#x1-260006">§6 </a><a +href="#x1-260006">Links to Glossary +Entries<!--tex4ht:ref: sec:glslink --></a>) that allow you to access just the short form, just the long form or the full form, +without affecting the <a + id="dx1-39063"></a><a +href="#glo:firstuseflag">first use flag</a>. (Note that the full form isn’t necessarily the same as +the text produced on <a + id="dx1-39064"></a><a +href="#glo:firstuse">first use</a>.) +</p><!--l. 4019--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\acrshort</span><span +class="ectt-0900"> </span></span><a + id="dx1-39065"></a> <span +class="ectt-1000">\acrshort[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">options</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">]{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">insert</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">] </span></div><hr> +</p><!--l. 4021--><p class="noindent" > +This displays the short form for the entry given by <span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩</span>. The optional arguments are +the same as those for <span +class="ectt-1000">\glstext</span><a + id="dx1-39066"></a>. There is also a starred version to suppress the +hyperlink. There are also analogous upper case variants: +</p><!--l. 4026--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\Acrshort</span><span +class="ectt-0900"> </span></span><a + id="dx1-39067"></a> <span +class="ectt-1000">\Acrshort[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">options</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">]{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">insert</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">] </span></div><hr> +</p><!--l. 4028--><p class="noindent" > +</p><!--l. 4029--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\ACRshort</span><span +class="ectt-0900"> </span></span><a + id="dx1-39068"></a> <span +class="ectt-1000">\ACRshort[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">options</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">]{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">insert</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">] </span></div><hr> +</p><!--l. 4031--><p class="noindent" > +</p><!--l. 4033--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\acrlong</span><span +class="ectt-0900"> </span></span><a + id="dx1-39069"></a> <span +class="ectt-1000">\acrlong[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">options</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">]{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">insert</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">] </span></div><hr> +</p><!--l. 4035--><p class="noindent" > +This displays the long form for the entry given by <span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩</span>. The optional arguments are +the same as before. There is also a starred version to suppress the hyperlink. There are +also analogous upper case variants: +</p><!--l. 4040--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\Acrlong</span><span +class="ectt-0900"> </span></span><a + id="dx1-39070"></a> <span +class="ectt-1000">\Acrlong[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">options</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">]{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">insert</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">] </span></div><hr> +</p><!--l. 4042--><p class="noindent" > +</p><!--l. 4043--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\ACRshort</span><span +class="ectt-0900"> </span></span><a + id="dx1-39071"></a> <span +class="ectt-1000">\ACRlong[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">options</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">]{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">insert</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">] </span></div><hr> +</p><!--l. 4045--><p class="noindent" > +</p><!--l. 4047--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\acrfull</span><span +class="ectt-0900"> </span></span><a + id="dx1-39072"></a> <span +class="ectt-1000">\acrfull[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">options</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">]{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">insert</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">] </span></div><hr> +</p><!--l. 4049--><p class="noindent" > +This is equivalent to: <span class="marginpar"><span +class="ectt-0900">\acrfullformat</span><span +class="ectt-0900"> </span></span><a + id="dx1-39073"></a><span +class="ectt-1000">\acrfullformat</span><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">{</span></span></span><span +class="ectt-1000">\acrlong</span><a + id="dx1-39074"></a><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">}{</span></span></span><span +class="ectt-1000">\acrshort</span><a + id="dx1-39075"></a><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">}</span></span></span>. This +defaults to <span +class="cmsy-10">⟨</span><span +class="ecti-1000">long</span><span +class="cmsy-10">⟩ </span>(<span +class="ectt-1000">\acronymfont</span><a + id="dx1-39076"></a><span +class="ectt-1000">{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">short</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}</span>) regardless of the package options. There are +also analogous upper case variants: +</p><!--l. 4055--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\Acrfull</span><span +class="ectt-0900"> </span></span><a + id="dx1-39077"></a> <span +class="ectt-1000">\Acrfull[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">options</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">]{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">insert</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">] </span></div><hr> +</p><!--l. 4057--><p class="noindent" > +</p><!--l. 4058--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\ACRfull</span><span +class="ectt-0900"> </span></span><a + id="dx1-39078"></a> <span +class="ectt-1000">\ACRfull[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">options</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">]{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">insert</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">] </span></div><hr> + + + +</p><!--l. 4060--><p class="noindent" > +</p><!--l. 4062--><p class="indent" > If you find the above commands too cumbersome to write, you can use +the <span +class="ecss-1000">shortcuts</span><a + id="dx1-39079"></a> package option to activate the shorter command names listed in +<a +href="#x1-390805">table 5</a>. +</p> + <div class="table"> + + + +<!--l. 4066--><p class="indent" > <a + id="x1-390805"></a></p><hr class="float" /><div class="float" +> + + + + <div class="caption" +><span class="id">Table 5: </span><span +class="content">Synonyms provided by the package option <span +class="ecss-1000">shortcuts</span><a + id="dx1-39081"></a></span></div><!--tex4ht:label?: x1-390805 --> +<div class="tabular"> <table id="TBL-6" class="tabular" +cellspacing="0" cellpadding="0" +><colgroup id="TBL-6-1g"><col +id="TBL-6-1" /><col +id="TBL-6-2" /></colgroup><tr + style="vertical-align:baseline;" id="TBL-6-1-"><td style="white-space:nowrap; text-align:left;" id="TBL-6-1-1" +class="td11"><span +class="ecbx-1000">Shortcut Command</span></td><td style="white-space:nowrap; text-align:left;" id="TBL-6-1-2" +class="td11"><span +class="ecbx-1000">Equivalent Command</span></td> +</tr><tr + style="vertical-align:baseline;" id="TBL-6-2-"><td style="white-space:nowrap; text-align:left;" id="TBL-6-2-1" +class="td11"><span +class="ectt-1000">\acs</span><a + id="dx1-39082"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-6-2-2" +class="td11"><span +class="ectt-1000">\acrshort</span><a + id="dx1-39083"></a> </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-6-3-"><td style="white-space:nowrap; text-align:left;" id="TBL-6-3-1" +class="td11"><span +class="ectt-1000">\Acs</span><a + id="dx1-39084"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-6-3-2" +class="td11"><span +class="ectt-1000">\Acrshort</span><a + id="dx1-39085"></a> </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-6-4-"><td style="white-space:nowrap; text-align:left;" id="TBL-6-4-1" +class="td11"><span +class="ectt-1000">\acsp</span><a + id="dx1-39086"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-6-4-2" +class="td11"><span +class="ectt-1000">\acrshortpl</span><a + id="dx1-39087"></a> </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-6-5-"><td style="white-space:nowrap; text-align:left;" id="TBL-6-5-1" +class="td11"><span +class="ectt-1000">\Acsp</span><a + id="dx1-39088"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-6-5-2" +class="td11"><span +class="ectt-1000">\Acrshortpl</span><a + id="dx1-39089"></a> </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-6-6-"><td style="white-space:nowrap; text-align:left;" id="TBL-6-6-1" +class="td11"><span +class="ectt-1000">\acl</span><a + id="dx1-39090"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-6-6-2" +class="td11"><span +class="ectt-1000">\acrlong</span><a + id="dx1-39091"></a> </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-6-7-"><td style="white-space:nowrap; text-align:left;" id="TBL-6-7-1" +class="td11"><span +class="ectt-1000">\Acl</span><a + id="dx1-39092"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-6-7-2" +class="td11"><span +class="ectt-1000">\Acrlong</span><a + id="dx1-39093"></a> </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-6-8-"><td style="white-space:nowrap; text-align:left;" id="TBL-6-8-1" +class="td11"><span +class="ectt-1000">\aclp</span><a + id="dx1-39094"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-6-8-2" +class="td11"><span +class="ectt-1000">\acrlongpl</span><a + id="dx1-39095"></a> </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-6-9-"><td style="white-space:nowrap; text-align:left;" id="TBL-6-9-1" +class="td11"><span +class="ectt-1000">\Aclp</span><a + id="dx1-39096"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-6-9-2" +class="td11"><span +class="ectt-1000">\Acrlongpl</span><a + id="dx1-39097"></a> </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-6-10-"><td style="white-space:nowrap; text-align:left;" id="TBL-6-10-1" +class="td11"><span +class="ectt-1000">\acf</span><a + id="dx1-39098"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-6-10-2" +class="td11"><span +class="ectt-1000">\acrfull</span><a + id="dx1-39099"></a> </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-6-11-"><td style="white-space:nowrap; text-align:left;" id="TBL-6-11-1" +class="td11"><span +class="ectt-1000">\Acf</span><a + id="dx1-39100"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-6-11-2" +class="td11"><span +class="ectt-1000">\Acrfull</span><a + id="dx1-39101"></a> </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-6-12-"><td style="white-space:nowrap; text-align:left;" id="TBL-6-12-1" +class="td11"><span +class="ectt-1000">\acfp</span><a + id="dx1-39102"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-6-12-2" +class="td11"><span +class="ectt-1000">\acrfullpl</span><a + id="dx1-39103"></a> </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-6-13-"><td style="white-space:nowrap; text-align:left;" id="TBL-6-13-1" +class="td11"><span +class="ectt-1000">\Acfp</span><a + id="dx1-39104"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-6-13-2" +class="td11"><span +class="ectt-1000">\Acrfullpl</span><a + id="dx1-39105"></a> </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-6-14-"><td style="white-space:nowrap; text-align:left;" id="TBL-6-14-1" +class="td11"><span +class="ectt-1000">\ac</span><a + id="dx1-39106"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-6-14-2" +class="td11"><span +class="ectt-1000">\gls</span><a + id="dx1-39107"></a> </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-6-15-"><td style="white-space:nowrap; text-align:left;" id="TBL-6-15-1" +class="td11"><span +class="ectt-1000">\Ac</span><a + id="dx1-39108"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-6-15-2" +class="td11"><span +class="ectt-1000">\Gls</span><a + id="dx1-39109"></a> </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-6-16-"><td style="white-space:nowrap; text-align:left;" id="TBL-6-16-1" +class="td11"><span +class="ectt-1000">\acp</span><a + id="dx1-39110"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-6-16-2" +class="td11"><span +class="ectt-1000">\glspl</span><a + id="dx1-39111"></a> </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-6-17-"><td style="white-space:nowrap; text-align:left;" id="TBL-6-17-1" +class="td11"><span +class="ectt-1000">\Acp</span><a + id="dx1-39112"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-6-17-2" +class="td11"><span +class="ectt-1000">\Glspl</span><a + id="dx1-39113"></a> </td></tr></table> +</div> + + + + </div><hr class="endfloat" /> + </div> +<!--l. 4092--><p class="indent" > It is also possible to access the long and short forms without adding information to +the glossary using commands analogous to <span +class="ectt-1000">\glsentrytext</span><a + id="dx1-39114"></a> (described in <a +href="#x1-320009">§9 </a><a +href="#x1-320009">Using +Glossary Terms Without Links<!--tex4ht:ref: sec:glsnolink --></a>). +</p><!--l. 4096--><p class="indent" > The long form can be accessed using: +</p><!--l. 4097--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\glsentrylong</span><span +class="ectt-0900"> </span></span><a + id="dx1-39115"></a> <span +class="ectt-1000">\glsentrylong{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">} </span></div><hr> +</p><!--l. 4099--><p class="noindent" > +or, with the first letter converted to upper case: +</p><!--l. 4101--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\Glsentrylong</span><span +class="ectt-0900"> </span></span><a + id="dx1-39116"></a> <span +class="ectt-1000">\Glsentrylong{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">} </span></div><hr> +</p><!--l. 4103--><p class="noindent" > +Plural forms: +</p><!--l. 4105--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\glsentrylongpl</span><span +class="ectt-0900"> </span></span><a + id="dx1-39117"></a> <span +class="ectt-1000">\glsentrylongpl{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">} </span></div><hr> +</p><!--l. 4107--><p class="noindent" > +</p><!--l. 4108--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\Glsentrylongpl</span><span +class="ectt-0900"> </span></span><a + id="dx1-39118"></a> <span +class="ectt-1000">\Glsentrylongpl{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">} </span></div><hr> +</p><!--l. 4110--><p class="noindent" > +</p><!--l. 4112--><p class="indent" > Similarly, to access the short form: +</p><!--l. 4113--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\glsentryshort</span><span +class="ectt-0900"> </span></span><a + id="dx1-39119"></a> <span +class="ectt-1000">\glsentryshort{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">} </span></div><hr> +</p><!--l. 4115--><p class="noindent" > +or, with the first letter converted to upper case: +</p><!--l. 4117--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\Glsentryshort</span><span +class="ectt-0900"> </span></span><a + id="dx1-39120"></a> <span +class="ectt-1000">\Glsentryshort{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">} </span></div><hr> +</p><!--l. 4119--><p class="noindent" > +Plural forms: +</p><!--l. 4121--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\glsentryshortpl</span><span +class="ectt-0900"> </span></span><a + id="dx1-39121"></a> <span +class="ectt-1000">\glsentryshortpl{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">} </span></div><hr> +</p><!--l. 4123--><p class="noindent" > +</p><!--l. 4124--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\Glsentryshortpl</span><span +class="ectt-0900"> </span></span><a + id="dx1-39122"></a> <span +class="ectt-1000">\Glsentryshortpl{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">} </span></div><hr> +</p><!--l. 4126--><p class="noindent" > +</p><!--l. 4128--><p class="indent" > And the full form, <span +class="cmsy-10">⟨</span><span +class="ecti-1000">long</span><span +class="cmsy-10">⟩ </span>(<span +class="cmsy-10">⟨</span><span +class="ecti-1000">short</span><span +class="cmsy-10">⟩</span>), can be obtained using: +</p><!--l. 4130--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\glsentryfull</span><span +class="ectt-0900"> </span></span><a + id="dx1-39123"></a> <span +class="ectt-1000">\glsentryfull{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">} </span></div><hr> +</p><!--l. 4132--><p class="noindent" > +</p><!--l. 4133--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\Glsentryfull</span><span +class="ectt-0900"> </span></span><a + id="dx1-39124"></a> <span +class="ectt-1000">\Glsentryfull{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">} </span></div><hr> +</p><!--l. 4135--><p class="noindent" > +</p><!--l. 4136--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\glsentryfullpl</span><span +class="ectt-0900"> </span></span><a + id="dx1-39125"></a> <span +class="ectt-1000">\glsentryfullpl{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">} </span></div><hr> +</p><!--l. 4138--><p class="noindent" > +</p><!--l. 4139--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\Glsentryfullpl</span><span +class="ectt-0900"> </span></span><a + id="dx1-39126"></a> <span +class="ectt-1000">\Glsentryfullpl{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">} </span></div><hr> +</p><!--l. 4141--><p class="noindent" > + + + +</p> +<!--l. 4143--><p class="noindent" ><a +href="#top">Top</a></p><h4 class="subsectionHead"><span class="titlemark">13.1 </span> <a + id="x1-4000013.1"></a>Predefined Acronym Styles</h4> +<!--l. 4145--><p class="noindent" >Some of the acronym-related package options may be combined. Listed below are the +effects of different combinations. If you use an invalid combination, you’ll get an error +message. +</p><!--l. 4149--><p class="indent" > + </p><dl class="description"><dt class="description"> +<span +class="ecsx-1000">description</span><a + id="dx1-40001"></a><span +class="ecbx-1000">,</span><span +class="ecsx-1000">footnote</span><a + id="dx1-40002"></a> </dt><dd +class="description">When these two package options are used together, the <a + id="dx1-40003"></a><a +href="#glo:firstuse">first + use</a> displays the entry as: <spacer type=vertical size=10><span class="obeylines-h"> + <br /><span +class="ectt-1000">\firstacronymfont{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">abbrv</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">insert</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">\footnote{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">long</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}</span> + <br /><spacer type=vertical size=10></span> + while subsequent use displays the entry as: <spacer type=vertical size=10><span class="obeylines-h"> + <br /><span +class="ectt-1000">\acronymfont{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">abbrv</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">insert</span><span +class="cmsy-10">⟩</span> + <br /><spacer type=vertical size=10></span> + where <span +class="cmsy-10">⟨</span><span +class="ecti-1000">insert</span><span +class="cmsy-10">⟩ </span>indicates the text supplied in the final optional argument to <span +class="ectt-1000">\gls</span><a + id="dx1-40004"></a>, + <span +class="ectt-1000">\glspl</span><a + id="dx1-40005"></a> or their uppercase variants. + </dd><dt class="description"> +<span +class="ecsx-1000">dua</span><a + id="dx1-40006"></a> </dt><dd +class="description">The <span +class="ecss-1000">dua</span><a + id="dx1-40007"></a> package option always makes <span +class="ectt-1000">\gls</span><a + id="dx1-40008"></a> display the expanded form and so may + not be used with <span +class="ecss-1000">footnote</span><a + id="dx1-40009"></a>, <span +class="ecss-1000">smaller</span><a + id="dx1-40010"></a> or <span +class="ecss-1000">smallcaps</span><a + id="dx1-40011"></a>. Both <a + id="dx1-40012"></a><a +href="#glo:firstuse">first use</a> and subsequent use + displays the entry in the form: <spacer type=vertical size=10><span class="obeylines-h"> + <br /><span +class="cmsy-10">⟨</span><span +class="ecti-1000">long</span><span +class="cmsy-10">⟩⟨</span><span +class="ecti-1000">insert</span><span +class="cmsy-10">⟩</span> + <br /><spacer type=vertical size=10></span> + You can, however, access the short form using <span +class="ectt-1000">\acrshort</span><a + id="dx1-40013"></a> and its variants. + </dd><dt class="description"> +<span +class="ecsx-1000">description</span><a + id="dx1-40014"></a> </dt><dd +class="description">This package option displays the entry on <a + id="dx1-40015"></a><a +href="#glo:firstuse">first use</a> as: <spacer type=vertical size=10><span class="obeylines-h"> + <br /><span +class="cmsy-10">⟨</span><span +class="ecti-1000">long</span><span +class="cmsy-10">⟩⟨</span><span +class="ecti-1000">insert</span><span +class="cmsy-10">⟩ </span>(<span +class="ectt-1000">\firstacronymfont</span><a + id="dx1-40016"></a><span +class="ectt-1000">{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">abbrv</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}</span>) + <br /><spacer type=vertical size=10></span> + while subsequent use displays the entry as: <spacer type=vertical size=10><span class="obeylines-h"> + <br /><span +class="ectt-1000">\acronymfont{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">abbrv</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">insert</span><span +class="cmsy-10">⟩</span> + <br /><spacer type=vertical size=10></span> + <!--l. 4185--><p class="noindent" >Note that with this option, you need to specify the description using the + <span +class="ecss-1000">description</span><a + id="dx1-40017"></a> key in the optional argument of <span +class="ectt-1000">\newacronym</span><a + id="dx1-40018"></a>. + </p></dd><dt class="description"> +<span +class="ecsx-1000">footnote</span><a + id="dx1-40019"></a> </dt><dd +class="description">This package option displays the entry on <a + id="dx1-40020"></a><a +href="#glo:firstuse">first use</a> as: <spacer type=vertical size=10><span class="obeylines-h"> + <br /><span +class="ectt-1000">\firstacronymfont{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">abbrv</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">insert</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">\footnote{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">long</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}</span> + <br /><spacer type=vertical size=10></span> + while subsequent use displays the entry as: <spacer type=vertical size=10><span class="obeylines-h"> + + + + <br /><span +class="ectt-1000">\acronymfont{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">abbrv</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">insert</span><span +class="cmsy-10">⟩</span> + <br /><spacer type=vertical size=10></span> + Acronyms will be sorted according to the short form. + <!--l. 4200--><p class="noindent" >Note that on <a + id="dx1-40021"></a><a +href="#glo:firstuse">first use</a>, it is the long form in the footnote that links to the relevant + glossary entry (where hyperlinks are enabled), whereas on subsequent use, the + acronym links to the relevant glossary entry. You can suppress the long form link + by setting: + + + +</p> + <div class="verbatim" id="verbatim-119"> + \let\acrfootnote\acrnolinkfootnote +</div> + <!--l. 4206--><p class="nopar" > + </p></dd><dt class="description"> +<span +class="ecsx-1000">smallcaps</span><a + id="dx1-40022"></a> </dt><dd +class="description">If neither the <span +class="ecss-1000">footnote</span><a + id="dx1-40023"></a> nor <span +class="ecss-1000">description</span><a + id="dx1-40024"></a> options have been set, this option + displays the entry on <a + id="dx1-40025"></a><a +href="#glo:firstuse">first use</a> as: <spacer type=vertical size=10><span class="obeylines-h"> + <br /><span +class="cmsy-10">⟨</span><span +class="ecti-1000">long</span><span +class="cmsy-10">⟩⟨</span><span +class="ecti-1000">insert</span><span +class="cmsy-10">⟩ </span>(<span +class="ectt-1000">\firstacronymfont</span><a + id="dx1-40026"></a><span +class="ectt-1000">{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">abbrv</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}</span>) + <br /><spacer type=vertical size=10></span> + while subsequent use displays the entry as: <spacer type=vertical size=10><span class="obeylines-h"> + <br /><span +class="ectt-1000">\acronymfont{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">abbrv</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">insert</span><span +class="cmsy-10">⟩</span> + <br /><spacer type=vertical size=10></span> + where <span +class="ectt-1000">\acronymfont</span><a + id="dx1-40027"></a> is set to <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\textsc{#1}</span></span></span>. + <!--l. 4220--><p class="noindent" ><div class="important" title="Important Note"> Note that since the acronym is displayed using <span +class="ectt-1000">\textsc</span><a + id="dx1-40028"></a>, the short form, <span +class="cmsy-10">⟨</span><span +class="ecti-1000">abbrv</span><span +class="cmsy-10">⟩</span>, + should be specified in lower case. </div> + </p><!--l. 4225--><p class="noindent" > + </p></dd><dt class="description"> +<span +class="ecsx-1000">smaller</span><a + id="dx1-40029"></a> </dt><dd +class="description">If neither the <span +class="ecss-1000">footnote</span><a + id="dx1-40030"></a> nor <span +class="ecss-1000">description</span><a + id="dx1-40031"></a> options have been set, this option + displays the entry on <a + id="dx1-40032"></a><a +href="#glo:firstuse">first use</a> as: <spacer type=vertical size=10><span class="obeylines-h"> + <br /><span +class="cmsy-10">⟨</span><span +class="ecti-1000">long</span><span +class="cmsy-10">⟩⟨</span><span +class="ecti-1000">insert</span><span +class="cmsy-10">⟩ </span>(<span +class="ectt-1000">\firstacronymfont</span><a + id="dx1-40033"></a><span +class="ectt-1000">{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">abbrv</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}</span>) + <br /><spacer type=vertical size=10></span> + while subsequent use displays the entry as: <spacer type=vertical size=10><span class="obeylines-h"> + <br /><span +class="ectt-1000">\acronymfont</span><a + id="dx1-40034"></a><span +class="ectt-1000">{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">abbrv</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">insert</span><span +class="cmsy-10">⟩</span> + <br /><spacer type=vertical size=10></span> + where <span +class="ectt-1000">\acronymfont</span><a + id="dx1-40035"></a> is set to + <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\textsmaller{#1}</span></span></span>.<span class="footnote-mark"><a +href="#fn16x0" id="fn16x0-bk"><sup class="textsuperscript">16</sup></a></span><a + id="x1-40036f16"></a> + The entries will be sorted according to the short form. + <!--l. 4243--><p class="noindent" ><div class="important" title="Important Note"> Remember to load a package that defines <span +class="ectt-1000">\textsmaller</span><a + id="dx1-40040"></a> (such as <span +class="ecss-1000">relsize</span><a + id="dx1-40041"></a>) if you + want to use this option, unless you want to redefine <span +class="ectt-1000">\acronymfont</span><a + id="dx1-40042"></a> to use some + other formatting command. </div> + </p><!--l. 4247--><p class="noindent" > + + + + </p></dd><dt class="description"> +<span +class="ecbx-1000">None of the above</span> </dt><dd +class="description">If none of the package options <span +class="ecss-1000">smallcaps</span><a + id="dx1-40043"></a>, <span +class="ecss-1000">smaller</span><a + id="dx1-40044"></a>, <span +class="ecss-1000">footnote</span><a + id="dx1-40045"></a>, + <span +class="ecss-1000">dua</span><a + id="dx1-40046"></a> or <span +class="ecss-1000">description</span><a + id="dx1-40047"></a> are used, then on <a + id="dx1-40048"></a><a +href="#glo:firstuse">first use</a> the entry is displayed as: + <spacer type=vertical size=10><span class="obeylines-h"> + <br /><span +class="cmsy-10">⟨</span><span +class="ecti-1000">long</span><span +class="cmsy-10">⟩ </span>(<span +class="cmsy-10">⟨</span><span +class="ecti-1000">abbrv</span><span +class="cmsy-10">⟩</span>)<span +class="cmsy-10">⟨</span><span +class="ecti-1000">insert</span><span +class="cmsy-10">⟩</span> + <br /><spacer type=vertical size=10></span> + while subsequent use displays the entry as: <spacer type=vertical size=10><span class="obeylines-h"> + <br /><span +class="cmsy-10">⟨</span><span +class="ecti-1000">abbrv</span><span +class="cmsy-10">⟩⟨</span><span +class="ecti-1000">insert</span><span +class="cmsy-10">⟩</span> + <br /><spacer type=vertical size=10></span> + Entries will be sorted according to the short form.</dd></dl> +<!--l. 4263--><p class="noindent" > +</p> +<!--l. 4263--><p class="noindent" ><a +href="#top">Top</a></p><h4 class="subsectionHead"><span class="titlemark">13.2 </span> <a + id="x1-4100013.2"></a>Displaying the List of Acronyms</h4> +<!--l. 4265--><p class="noindent" >The list of acronyms is just like any other type of glossary and can be displayed on its +own using <span +class="ectt-1000">\printglossary</span><a + id="dx1-41001"></a><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">[type=\acronymtype]</span></span></span> or with all the other glossaries +using <span +class="ectt-1000">\printglossaries</span><a + id="dx1-41002"></a>. However, care must be taken to choose a glossary +style that’s appropriate to your acronym style. The different acronym-related +package options store different information in the <span +class="ecss-1000">name</span><a + id="dx1-41003"></a>, <span +class="ecss-1000">description</span><a + id="dx1-41004"></a> and <span +class="ecss-1000">symbol</span><a + id="dx1-41005"></a> +keys. +</p><!--l. 4274--><p class="indent" > <a +href="#x1-410136">Table 6</a> lists the package options that govern the acronym styles and how the +information is stored in the keys used when displaying the glossary. Note that the +<span +class="ecss-1000">description</span><a + id="dx1-41006"></a> package option uses the following command in the <span +class="ecss-1000">name</span><a + id="dx1-41007"></a>: +</p><!--l. 4278--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\acrnameformat</span><span +class="ectt-0900"> </span></span><a + id="dx1-41008"></a> <span +class="ectt-1000">\acrnameformat{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">abbrv</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">long</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">} </span></div><hr> +</p><!--l. 4280--><p class="noindent" > +This defaults to just <span +class="ectt-1000">\acronymfont{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">abbrv</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}</span>. +</p><!--l. 4283--><p class="indent" > For example, if I use the package options <span +class="ecss-1000">description</span><a + id="dx1-41009"></a> and <span +class="ecss-1000">footnote</span><a + id="dx1-41010"></a>, then the name +field will contain the abbreviation and the symbol field will contain the long form. If I +then use the <span +class="ecss-1000">long4col</span><a + id="dx1-41011"></a> style, each entry in the list of acronyms will appear in the form: +<spacer type=vertical size=10><span class="obeylines-h"> + <br /><span +class="ectt-1000">\acronymfont</span><a + id="dx1-41012"></a><span +class="ectt-1000">{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">abbrv</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">} </span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">description</span><span +class="cmsy-10">⟩⟨</span><span +class="ecti-1000">long</span><span +class="cmsy-10">⟩</span> + <br /><span +class="cmsy-10">⟨</span><span +class="ecti-1000">location list</span><span +class="cmsy-10">⟩</span> + <br /><spacer type=vertical size=10></span> +Alternatively, you can define your own custom style (see <a +href="#x1-5200016">§16 </a><a +href="#x1-5200016">Defining your own glossary +style<!--tex4ht:ref: sec:newglossarystyle --></a> for further details). +</p> + <div class="table"> + + + +<!--l. 4295--><p class="indent" > <a + id="x1-410136"></a></p><hr class="float" /><div class="float" +> + + + + <div class="caption" +><span class="id">Table 6: </span><span +class="content">Package options governing <span +class="ectt-1000">\newacronym </span>and how the information is +stored</span></div><!--tex4ht:label?: x1-410136 --> +<div class="center" +> +<!--l. 4299--><p class="noindent" > +</p> +<div class="tabular"> <table id="TBL-7" class="tabular" +cellspacing="0" cellpadding="0" +><colgroup id="TBL-7-1g"><col +id="TBL-7-1" /><col +id="TBL-7-2" /><col +id="TBL-7-3" /><col +id="TBL-7-4" /><col +id="TBL-7-5" /></colgroup><tr + style="vertical-align:baseline;" id="TBL-7-1-"><td style="white-space:nowrap; text-align:left;" id="TBL-7-1-1" +class="td11"><span +class="ecbx-1000">Package Option</span></td><td style="white-space:nowrap; text-align:left;" id="TBL-7-1-2" +class="td11"><span +class="ecss-1000">name</span><a + id="dx1-41014"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-7-1-3" +class="td11"><span +class="ecss-1000">description</span><a + id="dx1-41015"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-7-1-4" +class="td11"><span +class="ecss-1000">symbol</span><a + id="dx1-41016"></a> </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-7-2-"><td style="white-space:nowrap; text-align:left;" id="TBL-7-2-1" +class="td11"><span +class="ecss-1000">description</span><a + id="dx1-41017"></a>,<span +class="ecss-1000">footnote</span><a + id="dx1-41018"></a></td><td style="white-space:nowrap; text-align:left;" id="TBL-7-2-2" +class="td11"><span +class="ectt-1000">\acronymfont</span><a + id="dx1-41019"></a><span +class="ectt-1000">{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">abbrv</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">} </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-7-2-3" +class="td11">user supplied</td><td style="white-space:nowrap; text-align:left;" id="TBL-7-2-4" +class="td11"><span +class="cmsy-10">⟨</span><span +class="ecti-1000">long</span><span +class="cmsy-10">⟩ </span></td> +</tr><tr + style="vertical-align:baseline;" id="TBL-7-3-"><td style="white-space:nowrap; text-align:left;" id="TBL-7-3-1" +class="td11"><span +class="ecss-1000">description</span><a + id="dx1-41020"></a>,<span +class="ecss-1000">dua</span><a + id="dx1-41021"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-7-3-2" +class="td11"><span +class="cmsy-10">⟨</span><span +class="ecti-1000">long</span><span +class="cmsy-10">⟩ </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-7-3-3" +class="td11">user supplied</td><td style="white-space:nowrap; text-align:left;" id="TBL-7-3-4" +class="td11"><span +class="cmsy-10">⟨</span><span +class="ecti-1000">abbrv</span><span +class="cmsy-10">⟩</span></td> +</tr><tr + style="vertical-align:baseline;" id="TBL-7-4-"><td style="white-space:nowrap; text-align:left;" id="TBL-7-4-1" +class="td11"><span +class="ecss-1000">description</span><a + id="dx1-41022"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-7-4-2" +class="td11"><span +class="ectt-1000">\acrnameformat</span><a + id="dx1-41023"></a><span +class="ectt-1000">{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">abbrv</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">long</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}</span></td><td style="white-space:nowrap; text-align:left;" id="TBL-7-4-3" +class="td11">user supplied</td><td style="white-space:nowrap; text-align:left;" id="TBL-7-4-4" +class="td11"><span +class="cmsy-10">⟨</span><span +class="ecti-1000">abbrv</span><span +class="cmsy-10">⟩</span></td> +</tr><tr + style="vertical-align:baseline;" id="TBL-7-5-"><td style="white-space:nowrap; text-align:left;" id="TBL-7-5-1" +class="td11"><span +class="ecss-1000">footnote</span><a + id="dx1-41024"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-7-5-2" +class="td11"><span +class="ectt-1000">\acronymfont</span><a + id="dx1-41025"></a><span +class="ectt-1000">{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">abbrv</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">} </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-7-5-3" +class="td11"><span +class="cmsy-10">⟨</span><span +class="ecti-1000">long</span><span +class="cmsy-10">⟩ </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-7-5-4" +class="td11"> </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-7-6-"><td style="white-space:nowrap; text-align:left;" id="TBL-7-6-1" +class="td11"><span +class="ecss-1000">smallcaps</span><a + id="dx1-41026"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-7-6-2" +class="td11"><span +class="ectt-1000">\acronymfont</span><a + id="dx1-41027"></a><span +class="ectt-1000">{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">abbrv</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">} </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-7-6-3" +class="td11"><span +class="cmsy-10">⟨</span><span +class="ecti-1000">long</span><span +class="cmsy-10">⟩ </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-7-6-4" +class="td11"><span +class="cmsy-10">⟨</span><span +class="ecti-1000">abbrv</span><span +class="cmsy-10">⟩</span></td> +</tr><tr + style="vertical-align:baseline;" id="TBL-7-7-"><td style="white-space:nowrap; text-align:left;" id="TBL-7-7-1" +class="td11"><span +class="ecss-1000">smaller</span><a + id="dx1-41028"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-7-7-2" +class="td11"><span +class="ectt-1000">\acronymfont</span><a + id="dx1-41029"></a><span +class="ectt-1000">{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">abbrv</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">} </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-7-7-3" +class="td11"><span +class="cmsy-10">⟨</span><span +class="ecti-1000">long</span><span +class="cmsy-10">⟩ </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-7-7-4" +class="td11"><span +class="cmsy-10">⟨</span><span +class="ecti-1000">abbrv</span><span +class="cmsy-10">⟩</span></td> +</tr><tr + style="vertical-align:baseline;" id="TBL-7-8-"><td style="white-space:nowrap; text-align:left;" id="TBL-7-8-1" +class="td11"><span +class="ecss-1000">dua</span><a + id="dx1-41030"></a> </td><td style="white-space:nowrap; text-align:left;" id="TBL-7-8-2" +class="td11"><span +class="cmsy-10">⟨</span><span +class="ecti-1000">abbrv</span><span +class="cmsy-10">⟩ </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-7-8-3" +class="td11"><span +class="cmsy-10">⟨</span><span +class="ecti-1000">long</span><span +class="cmsy-10">⟩ </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-7-8-4" +class="td11"><span +class="cmsy-10">⟨</span><span +class="ecti-1000">abbrv</span><span +class="cmsy-10">⟩</span></td> +</tr><tr + style="vertical-align:baseline;" id="TBL-7-9-"><td style="white-space:nowrap; text-align:left;" id="TBL-7-9-1" +class="td11">None of the above </td><td style="white-space:nowrap; text-align:left;" id="TBL-7-9-2" +class="td11"><span +class="cmsy-10">⟨</span><span +class="ecti-1000">abbrv</span><span +class="cmsy-10">⟩ </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-7-9-3" +class="td11"><span +class="cmsy-10">⟨</span><span +class="ecti-1000">long</span><span +class="cmsy-10">⟩ </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-7-9-4" +class="td11"> </td></tr></table> +</div></div> + + + + </div><hr class="endfloat" /> + </div> +<!--l. 4340--><p class="noindent" ><a +href="#top">Top</a></p><h4 class="subsectionHead"><span class="titlemark">13.3 </span> <a + id="x1-4200013.3"></a>Defining A Custom Acronym Style</h4> +<!--l. 4343--><p class="noindent" >You may find that the predefined acronyms styles that come with the <span +class="ecss-1000">glossaries </span>package +don’t suit your requirements. In this case you can define your own style. This is done by +redefining the following commands: +</p><!--l. 4347--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\CustomAcronymFields</span><span +class="ectt-0900"> </span></span><a + id="dx1-42001"></a> <span +class="ectt-1000">\CustomAcronymFields </span></div><hr> +</p><!--l. 4349--><p class="noindent" > +This command sets up the keys for <span +class="ectt-1000">\newglossaryentry</span><a + id="dx1-42002"></a> when you define an acronym +using <span +class="ectt-1000">\newacronym</span><a + id="dx1-42003"></a>. Within the definition of <span +class="ectt-1000">\CustomAcronymFields</span>, you may use +<span +class="ectt-1000">\the\glslongtok</span><a + id="dx1-42004"></a> to access the long form, <span +class="ectt-1000">\the\glsshorttok</span><a + id="dx1-42005"></a> to access the short form +and <span +class="ectt-1000">\the\glslabeltok</span><a + id="dx1-42006"></a> to access the label. This command is typically used to set the +<span +class="ecss-1000">name</span><a + id="dx1-42007"></a>, <span +class="ecss-1000">first</span><a + id="dx1-42008"></a>, <span +class="ecss-1000">firstplural</span><a + id="dx1-42009"></a>, <span +class="ecss-1000">text</span><a + id="dx1-42010"></a> and <span +class="ecss-1000">plural</span><a + id="dx1-42011"></a> keys. It may also be used to set the <span +class="ecss-1000">symbol</span><a + id="dx1-42012"></a> or +<span +class="ecss-1000">description</span><a + id="dx1-42013"></a> keys depending on your requirements. +</p><!--l. 4360--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\SetCustomDisplayStyle</span><span +class="ectt-0900"> </span></span><a + id="dx1-42014"></a> <span +class="ectt-1000">\SetCustomDisplayStyle{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">type</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">} </span></div><hr> +</p><!--l. 4362--><p class="noindent" > +This is used to set up the display style for the glossary given by <span +class="cmsy-10">⟨</span><span +class="ecti-1000">type</span><span +class="cmsy-10">⟩</span>. This should +typically just use <span +class="ectt-1000">\defglsdisplayfirst</span><a + id="dx1-42015"></a> and <span +class="ectt-1000">\defglsdisplay</span><a + id="dx1-42016"></a>. +</p><!--l. 4367--><p class="indent" > Once you have redefined <span +class="ectt-1000">\CustomAcronymFields </span>and <span +class="ectt-1000">\SetCustomDisplayStyle</span>, +you must then switch to this style using +</p><!--l. 4369--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\SetCustomStyle</span><span +class="ectt-0900"> </span></span><a + id="dx1-42017"></a> <span +class="ectt-1000">\SetCustomStyle </span></div><hr> +</p><!--l. 4371--><p class="noindent" > +Note that you may still use the <span +class="ecss-1000">shortcuts</span><a + id="dx1-42018"></a> package option with your custom +style. +</p><!--l. 4375--><p class="indent" > <div class="important" title="Important Note"> If you omit <span +class="ectt-1000">\SetCustomStyle</span>, or use it before you redefine <span +class="ectt-1000">\CustomAcronymFields</span> +and <span +class="ectt-1000">\SetCustomDisplayStyle</span>, your new style won’t be correctly implemented. You +must set up the custom style before defining new acronyms. The acronyms must be +defined using <span +class="ectt-1000">\newacronym</span><a + id="dx1-42019"></a> not <span +class="ectt-1000">\newglossaryentry</span><a + id="dx1-42020"></a>. </div> +</p><!--l. 4381--><p class="noindent" > +</p><!--l. 4383--><p class="indent" > As an example, suppose I want my acronym on <a + id="dx1-42021"></a><a +href="#glo:firstuse">first use</a> to have the short form in +the text and the long form with the description in a footnote. Suppose also that I want +the short form to be put in small caps in the main body of the document, but I +want it in normal capitals in the list of acronyms. In my list of acronyms, +I want the long form as the name with the short form in brackets followed +by the description. That is, in the text I want <span +class="ectt-1000">\gls</span><a + id="dx1-42022"></a> on <a + id="dx1-42023"></a><a +href="#glo:firstuse">first use</a> to display: +<spacer type=vertical size=10><span class="obeylines-h"> + <br /><span +class="ectt-1000">\textsc</span><a + id="dx1-42024"></a><span +class="ectt-1000">{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">abbrv</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}\footnote</span><span class="verb"><span +class="ectt-1000">{</span></span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">long</span><span +class="cmsy-10">⟩</span>: <span +class="cmsy-10">⟨</span><span +class="ecti-1000">description</span><span +class="cmsy-10">⟩</span><span class="verb"><span +class="ectt-1000">}</span></span> + <br /><spacer type=vertical size=10></span> +on subsequent use: <spacer type=vertical size=10><span class="obeylines-h"> + <br /><span +class="ectt-1000">\textsc</span><a + id="dx1-42025"></a><span +class="ectt-1000">{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">abbrv</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}</span> + <br /><spacer type=vertical size=10></span> +and in the list of acronyms, each entry will be displayed in the form: <spacer type=vertical size=10><span class="obeylines-h"> + + + + <br /><span +class="cmsy-10">⟨</span><span +class="ecti-1000">long</span><span +class="cmsy-10">⟩ </span>(<span +class="cmsy-10">⟨</span><span +class="ecti-1000">short</span><span +class="cmsy-10">⟩</span>) <span +class="cmsy-10">⟨</span><span +class="ecti-1000">description</span><span +class="cmsy-10">⟩</span> + <br /><spacer type=vertical size=10></span> +</p><!--l. 4404--><p class="indent" > First, I need to redefine <span +class="ectt-1000">\CustomAcronymFields</span><a + id="dx1-42026"></a> so that <span +class="ectt-1000">\newacronym</span><a + id="dx1-42027"></a> will correctly +set the <span +class="ecss-1000">name</span><a + id="dx1-42028"></a>, <span +class="ecss-1000">text</span><a + id="dx1-42029"></a> and <span +class="ecss-1000">plural</span><a + id="dx1-42030"></a> keys. I want the long form to be stored in the +<span +class="ecss-1000">name</span><a + id="dx1-42031"></a> and the short form to be stored in <span +class="ecss-1000">text</span><a + id="dx1-42032"></a>. In addition, I’m going to set the +<span +class="ecss-1000">symbol</span><a + id="dx1-42033"></a> to the short form in upper case so that it will appear in the list of +acronyms. + + + +</p> + <div class="verbatim" id="verbatim-120"> +\renewcommand*{\CustomAcronymFields}{% + <br />  name={\the\glslongtok},% + <br />  symbol={\MakeUppercase{\the\glsshorttok}},% + <br />  text={\textsc{\the\glsshorttok}},% + <br />  plural={\textsc{\the\glsshorttok}\noexpand\acrpluralsuffix}% + <br />} +</div> +<!--l. 4419--><p class="nopar" > +</p><!--l. 4421--><p class="indent" > When using <span +class="ectt-1000">\newacronym</span><a + id="dx1-42034"></a>, the short and long forms are stored in the <span +class="ecss-1000">short</span><a + id="dx1-42035"></a> and <span +class="ecss-1000">long</span><a + id="dx1-42036"></a> +keys, and the plural forms are stored in <span +class="ecss-1000">shortplural</span><a + id="dx1-42037"></a> and <span +class="ecss-1000">longplural</span><a + id="dx1-42038"></a>. So when I use +<span +class="ectt-1000">\defglsdisplayfirst</span><a + id="dx1-42039"></a> and <span +class="ectt-1000">\defglsdisplay</span><a + id="dx1-42040"></a>, I can use <span +class="ectt-1000">\glsentrylong</span><a + id="dx1-42041"></a> to access the +long form. Recall from <a +href="#x1-270006.1">§6.1 </a><a +href="#x1-270006.1">Changing the format of the link text<!--tex4ht:ref: sec:glsdisplay --></a>, that the optional +argument to <span +class="ectt-1000">\defglsdisplayfirst</span><a + id="dx1-42042"></a> and <span +class="ectt-1000">\defglsdisplay</span><a + id="dx1-42043"></a> indicates the glossary +type. This is passed to <span +class="ectt-1000">\SetCustomDisplayStyle</span><a + id="dx1-42044"></a>. The mandatory argument +sets up the definition of <span +class="ectt-1000">\glsdisplayfirst</span><a + id="dx1-42045"></a> and <span +class="ectt-1000">\glsdisplay</span><a + id="dx1-42046"></a> for the given +glossary, where the first argument corresponds to the <span +class="ecss-1000">first</span><a + id="dx1-42047"></a>, <span +class="ecss-1000">firstplural</span><a + id="dx1-42048"></a>, <span +class="ecss-1000">text</span><a + id="dx1-42049"></a> or +<span +class="ecss-1000">plural</span><a + id="dx1-42050"></a>, as appropriate, the second argument corresponds to the <span +class="ecss-1000">description</span><a + id="dx1-42051"></a>, +the third corresponds to the <span +class="ecss-1000">symbol</span><a + id="dx1-42052"></a> and the fourth argument is the inserted +text. + + + +</p> + <div class="verbatim" id="verbatim-121"> +\renewcommand*{\SetCustomDisplayStyle}[1]{% + <br />  \defglsdisplayfirst[#1]{##1##4\protect\footnote{% + <br />    \glsentrylong{\glslabel}: ##2% + <br />  }} + <br />  \defglsdisplay[#1]{##1##4}% + <br />} +</div> +<!--l. 4444--><p class="nopar" > +</p><!--l. 4446--><p class="indent" > Since we have a definition inside a definition, <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">#1</span></span></span> refers to the argument of +<span +class="ectt-1000">\SetCustomDisplayStyle</span><a + id="dx1-42053"></a>, and <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">##1</span></span></span>, …, <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">##4</span></span></span>, refer to the arguments of <span +class="ectt-1000">\glsdisplayfirst</span><a + id="dx1-42054"></a> +and <span +class="ectt-1000">\glsdisplay</span><a + id="dx1-42055"></a>. +</p><!--l. 4451--><p class="indent" > Now that I’ve redefined <span +class="ectt-1000">\CustomAcronymFields</span><a + id="dx1-42056"></a> and <span +class="ectt-1000">\SetCustomDisplayStyle</span><a + id="dx1-42057"></a>, I +can set this style using + + + +</p> + <div class="verbatim" id="verbatim-122"> +\SetCustomStyle +</div> +<!--l. 4455--><p class="nopar" > and now I can define my acronyms: + + + +</p> + <div class="verbatim" id="verbatim-123"> +\newacronym[description={set of tags for use in developing hypertext + <br />documents}]{html}{html}{Hyper Text Markup Language} + <br />\newacronym[description={language used to describe the layout of a + <br />document written in a markup language}]{css}{css}{Cascading Style + <br />Sheet} +</div> +<!--l. 4464--><p class="nopar" > +</p><!--l. 4466--><p class="indent" > Note that since I’ve used the description in the main body of the text, I need to +switch off the sanitization otherwise any commands within the description won’t get +interpreted. Also I want to use the <span +class="ecss-1000">hyperref</span><a + id="dx1-42058"></a> package, but this will cause a problem on +<a + id="dx1-42059"></a><a +href="#glo:firstuse">first use</a> as I’ll get nested hyperlinks, so I need to switch off the hyperlinks on <a + id="dx1-42060"></a><a +href="#glo:firstuse">first use</a>. +In addition, I want to use a glossary style that displays the symbol. Therefore, in my +preamble I have: + + + +</p> + <div class="verbatim" id="verbatim-124"> +\usepackage[colorlinks]{hyperref} + <br />\usepackage[acronym,         % create list of acronyms + <br />            nomain,          % don’t need main glossary for this example + <br />            style=tree,      % need a style that displays the symbol + <br />            hyperfirst=false,% don’t hyperlink first use + <br />            sanitize=none    % switch off sanitization as description + <br />                             % will be used in the main text + <br />            ]{glossaries} +</div> +<!--l. 4483--><p class="nopar" > +</p><!--l. 4485--><p class="indent" > Note that I haven’t used the <span +class="ecss-1000">description</span><a + id="dx1-42061"></a> or <span +class="ecss-1000">footnote</span><a + id="dx1-42062"></a> package options. +</p><!--l. 4488--><p class="noindent" > +</p> +<!--l. 4488--><p class="noindent" ><a +href="#top">Top</a></p><h4 class="subsectionHead"><span class="titlemark">13.4 </span> <a + id="x1-4300013.4"></a>Upgrading From the glossary Package</h4> +<!--l. 4490--><p class="noindent" >Users of the obsolete <span +class="ecss-1000">glossary</span><a + id="dx1-43001"></a> package may recall that the syntax used to define new +acronyms has changed with the replacement <span +class="ecss-1000">glossaries </span>package. In addition, the old +<span +class="ecss-1000">glossary</span><a + id="dx1-43002"></a> package created the command <span +class="ectt-1000">\</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">acr-name</span><span +class="cmsy-10">⟩ </span>when defining the acronym +<span +class="cmsy-10">⟨</span><span +class="ecti-1000">acr-name</span><span +class="cmsy-10">⟩</span>. +</p><!--l. 4496--><p class="indent" > In order to facilitate migrating from the old package to the new one, the <span +class="ecss-1000">glossaries</span> +package<span class="footnote-mark"><a +href="#fn17x0" id="fn17x0-bk"><sup class="textsuperscript">17</sup></a></span><a + id="x1-43003f17"></a> +provides the command: +</p><!--l. 4499--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\oldacronym</span><span +class="ectt-0900"> </span></span><a + id="dx1-43004"></a> <span +class="ectt-1000">\oldacronym[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">]{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">abbrv</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">long</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">key-val list</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">} </span></div><hr> +</p><!--l. 4501--><p class="noindent" > +This uses the same syntax as the <span +class="ecss-1000">glossary</span><a + id="dx1-43005"></a> package’s method of defining acronyms. It is +equivalent to:<br +class="newline" /> <span +class="ectt-1000">\newacronym</span><a + id="dx1-43006"></a><span +class="ectt-1000">[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">key-val list</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">]{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">abbrv</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">long</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}</span><br +class="newline" /> In addition, <span +class="ectt-1000">\oldacronym</span><a + id="dx1-43007"></a> also defines the commands <span +class="ectt-1000">\</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩</span>, which is equivalent to +<span +class="ectt-1000">\gls</span><a + id="dx1-43008"></a><span +class="ectt-1000">{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}</span>, and <span +class="ectt-1000">\</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">*</span>, which is equivalent to <span +class="ectt-1000">\Gls</span><a + id="dx1-43009"></a><span +class="ectt-1000">{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}</span>. If <span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩ </span>is omitted, +<span +class="cmsy-10">⟨</span><span +class="ecti-1000">abbrv</span><span +class="cmsy-10">⟩ </span>is used. Since commands names must consist only of alphabetical characters, +<span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩ </span>must also only consist of alphabetical characters. Note that <span +class="ectt-1000">\</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩ </span>doesn’t +allow you to use the first optional argument of <span +class="ectt-1000">\gls</span><a + id="dx1-43010"></a> or <span +class="ectt-1000">\Gls</span><a + id="dx1-43011"></a> — you will need to +explicitly use <span +class="ectt-1000">\gls</span><a + id="dx1-43012"></a> or <span +class="ectt-1000">\Gls</span><a + id="dx1-43013"></a> to change the settings. +</p><!--l. 4516--><p class="indent" > <div class="important" title="Important Note"> Recall that, in general, <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span +class="E">E</span>X</span></span> ignores spaces following command names +consisting of alphabetical characters. This is also true for <span +class="ectt-1000">\</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩ </span>unless you +additionally load the <span +class="ecss-1000">xspace</span><a + id="dx1-43014"></a> package. </div> +</p><!--l. 4521--><p class="noindent" > + + + +</p><!--l. 4523--><p class="indent" > The <span +class="ecss-1000">glossaries </span>package doesn’t load the <span +class="ecss-1000">xspace</span><a + id="dx1-43015"></a> package since there are both +advantages and disadvantages to using <span +class="ectt-1000">\xspace</span><a + id="dx1-43016"></a> in <span +class="ectt-1000">\</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩</span>. If you don’t use the <span +class="ecss-1000">xspace</span><a + id="dx1-43017"></a> +package you need to explicitly force a space using <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\␣</span></span></span> (backslash space) however you can +follow <span +class="ectt-1000">\</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩ </span>with additional text in square brackets (the final optional argument to +<span +class="ectt-1000">\gls</span><a + id="dx1-43018"></a>). If you use the <span +class="ecss-1000">xspace</span><a + id="dx1-43019"></a> package you don’t need to escape the spaces but you +can’t use the optional argument to insert text (you will have to explicitly use +<span +class="ectt-1000">\gls</span><a + id="dx1-43020"></a>). +</p><!--l. 4534--><p class="indent" > To illustrate this, suppose I define the acronym “abc” as follows: + + + +</p> + <div class="verbatim" id="verbatim-125"> +\oldacronym{abc}{example acronym}{} +</div> +<!--l. 4538--><p class="nopar" > This will create the command <span +class="ectt-1000">\abc </span>and its starred version <span +class="ectt-1000">\abc*</span>. <a +href="#x1-430237">Table 7</a> illustrates +the effect of <span +class="ectt-1000">\abc </span>(on subsequent use) according to whether or not the <span +class="ecss-1000">xspace</span><a + id="dx1-43021"></a> package +has been loaded. As can be seen from the final row in the table, the <span +class="ecss-1000">xspace</span><a + id="dx1-43022"></a> package +prevents the optional argument from being recognised. +</p> + <div class="table"> + + + +<!--l. 4546--><p class="indent" > <a + id="x1-430237"></a></p><hr class="float" /><div class="float" +> + + + + <div class="caption" +><span class="id">Table 7: </span><span +class="content">The effect of using <span +class="ecss-1000">xspace </span>with <span +class="ectt-1000">\oldacronym</span></span></div><!--tex4ht:label?: x1-430237 --> +<div class="tabular"> <table id="TBL-8" class="tabular" +cellspacing="0" cellpadding="0" +><colgroup id="TBL-8-1g"><col +id="TBL-8-1" /><col +id="TBL-8-2" /><col +id="TBL-8-3" /></colgroup><tr + style="vertical-align:baseline;" id="TBL-8-1-"><td style="white-space:nowrap; text-align:left;" id="TBL-8-1-1" +class="td11"><span +class="ecbx-1000">Code </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-8-1-2" +class="td11"><span +class="ecbx-1000">With </span><span +class="ecsx-1000">xspace</span></td><td style="white-space:nowrap; text-align:left;" id="TBL-8-1-3" +class="td11"><span +class="ecbx-1000">Without </span><span +class="ecsx-1000">xspace</span></td> +</tr><tr + style="vertical-align:baseline;" id="TBL-8-2-"><td style="white-space:nowrap; text-align:left;" id="TBL-8-2-1" +class="td11"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\abc.</span></span></span> </td><td style="white-space:nowrap; text-align:left;" id="TBL-8-2-2" +class="td11">abc. </td><td style="white-space:nowrap; text-align:left;" id="TBL-8-2-3" +class="td11">abc. </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-8-3-"><td style="white-space:nowrap; text-align:left;" id="TBL-8-3-1" +class="td11"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\abc</span><span +class="ectt-1000"> xyz</span></span></span> </td><td style="white-space:nowrap; text-align:left;" id="TBL-8-3-2" +class="td11">abc xyz </td><td style="white-space:nowrap; text-align:left;" id="TBL-8-3-3" +class="td11">abcxyz </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-8-4-"><td style="white-space:nowrap; text-align:left;" id="TBL-8-4-1" +class="td11"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\abc\</span><span +class="ectt-1000"> xyz</span></span></span> </td><td style="white-space:nowrap; text-align:left;" id="TBL-8-4-2" +class="td11">abc xyz </td><td style="white-space:nowrap; text-align:left;" id="TBL-8-4-3" +class="td11">abc xyz </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-8-5-"><td style="white-space:nowrap; text-align:left;" id="TBL-8-5-1" +class="td11"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\abc*</span><span +class="ectt-1000"> xyz</span></span></span> </td><td style="white-space:nowrap; text-align:left;" id="TBL-8-5-2" +class="td11">Abc xyz </td><td style="white-space:nowrap; text-align:left;" id="TBL-8-5-3" +class="td11">Abc xyz </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-8-6-"><td style="white-space:nowrap; text-align:left;" id="TBL-8-6-1" +class="td11"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\abc[’s]</span><span +class="ectt-1000"> xyz</span></span></span></td><td style="white-space:nowrap; text-align:left;" id="TBL-8-6-2" +class="td11">abc [’s] xyz </td><td style="white-space:nowrap; text-align:left;" id="TBL-8-6-3" +class="td11">abc’s xyz </td></tr></table> +</div> + + + + </div><hr class="endfloat" /> + </div> +<!--l. 4566--><p class="noindent" ><a +href="#top">Top</a></p><h3 class="sectionHead"><span class="titlemark">14 </span> <a + id="x1-4400014"></a>Unsetting and Resetting Entry Flags</h3> +<!--l. 4569--><p class="noindent" >When using <span +class="ectt-1000">\gls</span><a + id="dx1-44001"></a>, <span +class="ectt-1000">\glspl</span><a + id="dx1-44002"></a> and their uppercase variants it is possible that you may want +to use the value given by the <span +class="ecss-1000">first</span><a + id="dx1-44003"></a> key, even though you have already <a + id="dx1-44004"></a><a +href="#glo:firstuse">used</a> the glossary +entry. Conversely, you may want to use the value given by the <span +class="ecss-1000">text</span><a + id="dx1-44005"></a> key, even though you +haven’t used the glossary entry. The former can be achieved by one of the following +commands: +</p><!--l. 4575--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\glsreset</span><span +class="ectt-0900"> </span></span><a + id="dx1-44006"></a> <span +class="ectt-1000">\glsreset{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">} </span></div><hr> +</p><!--l. 4577--><p class="noindent" > +</p><!--l. 4578--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\glslocalreset</span><span +class="ectt-0900"> </span></span><a + id="dx1-44007"></a> <span +class="ectt-1000">\glslocalreset{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">} </span></div><hr> +</p><!--l. 4580--><p class="noindent" > +while the latter can be achieved by one of the following commands: +</p><!--l. 4582--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\glsunset</span><span +class="ectt-0900"> </span></span><a + id="dx1-44008"></a> <span +class="ectt-1000">\glsunset{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">} </span></div><hr> +</p><!--l. 4584--><p class="noindent" > +</p><!--l. 4585--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\glslocalunset</span><span +class="ectt-0900"> </span></span><a + id="dx1-44009"></a> <span +class="ectt-1000">\glslocalunset{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">} </span></div><hr> +</p><!--l. 4587--><p class="noindent" > +You can also reset or unset all entries for a given glossary or list of glossaries +using: +</p><!--l. 4590--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\glsresetall</span><span +class="ectt-0900"> </span></span><a + id="dx1-44010"></a> <span +class="ectt-1000">\glsresetall[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">glossary list</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">] </span></div><hr> +</p><!--l. 4592--><p class="noindent" > +</p><!--l. 4593--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\glslocalresetall</span><span +class="ectt-0900"> </span></span><a + id="dx1-44011"></a> <span +class="ectt-1000">\glslocalresetall[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">glossary list</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">] </span></div><hr> +</p><!--l. 4595--><p class="noindent" > +</p><!--l. 4596--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\glsunsetall</span><span +class="ectt-0900"> </span></span><a + id="dx1-44012"></a> <span +class="ectt-1000">\glsunsetall[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">glossary list</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">] </span></div><hr> +</p><!--l. 4598--><p class="noindent" > +</p><!--l. 4599--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\glslocalunsetall</span><span +class="ectt-0900"> </span></span><a + id="dx1-44013"></a> <span +class="ectt-1000">\glslocalunsetall[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">glossary list</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">] </span></div><hr> +</p><!--l. 4601--><p class="noindent" > +where <span +class="cmsy-10">⟨</span><span +class="ecti-1000">glossary list</span><span +class="cmsy-10">⟩ </span>is a comma-separated list of glossary labels. If omitted, all defined +glossaries are assumed. For example, to reset all entries in the main glossary and the list +of acronyms: + + + +</p> + <div class="verbatim" id="verbatim-126"> +\glsresetall[main,acronym] +</div> +<!--l. 4608--><p class="nopar" > +</p><!--l. 4610--><p class="indent" > You can determine whether an entry’s <a + id="dx1-44014"></a><a +href="#glo:firstuseflag">first use flag</a> is set using: +</p><!--l. 4611--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\ifglsused</span><span +class="ectt-0900"> </span></span><a + id="dx1-44015"></a> <span +class="ectt-1000">\ifglsused{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">true part</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">false part</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">} </span></div><hr> +</p><!--l. 4613--><p class="noindent" > +where <span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩ </span>is the label of the required entry. If the entry has been used, <span +class="cmsy-10">⟨</span><span +class="ecti-1000">true part</span><span +class="cmsy-10">⟩</span> +will be done, otherwise <span +class="cmsy-10">⟨</span><span +class="ecti-1000">false part</span><span +class="cmsy-10">⟩ </span>will be done. +</p><!--l. 4619--><p class="noindent" > +</p> +<!--l. 4619--><p class="noindent" ><a +href="#top">Top</a></p><h3 class="sectionHead"><span class="titlemark">15 </span> <a + id="x1-4500015"></a>Glossary Styles</h3> +<!--l. 4621--><p class="noindent" >The <span +class="ecss-1000">glossaries </span>package comes with some pre-defined glossary styles. Note that the styles +are suited to different types of glossaries: some styles ignore the associated symbol; +some styles are not designed for hierarchical entries, so they display sub-entries in the +same way as they display top level entries; some styles are designed for homographs, so +they ignore the name for sub-entries. You should therefore pick a style that suits your +type of glossary. See <a +href="#x1-450048">table 8</a> for a summary of the available styles. The predefined styles +can accommodate numbered level 0 (main) and level 1 entries. See the package options +<span +class="ecss-1000">entrycounter</span><a + id="dx1-45001"></a>, <span +class="ecss-1000">counterwithin</span><a + id="dx1-45002"></a> and <span +class="ecss-1000">subentrycounter</span><a + id="dx1-45003"></a> described in <a +href="#x1-150002.3">§2.3 </a><a +href="#x1-150002.3">Glossary Appearance +Options<!--tex4ht:ref: sec:pkgopts-printglos --></a>. +</p> + <div class="table"> + + + +<!--l. 4635--><p class="indent" > <a + id="x1-450048"></a></p><hr class="float" /><div class="float" +> + + + + <div class="caption" +><span class="id">Table 8: </span><span +class="content">Glossary Styles. An asterisk in the style name indicates anything that +matches that doesn’t match any previously listed style (e.g. <span +class="ectt-1000">long3col* </span>matches +<span +class="ecss-1000">long3col</span><a + id="dx1-45005"></a>, <span +class="ecss-1000">long3colheader</span><a + id="dx1-45006"></a>, <span +class="ecss-1000">long3colborder</span><a + id="dx1-45007"></a> and <span +class="ecss-1000">long3colheaderborder</span><a + id="dx1-45008"></a>). A maximum +level of 0 indicates a flat glossary (sub-entries are displayed in the same way as +main entries). Where the maximum level is given as — there is no limit, but +note that <a + id="dx1-45009"></a><a +href="#glo:makeindex"><span +class="ectt-1000">makeindex</span><a + id="dx1-45010"></a></a> imposes a limit of 2 sub-levels. If the homograph column is +checked, then the name is not displayed for sub-entries. If the symbol column is +checked, then the symbol will be displayed.</span></div><!--tex4ht:label?: x1-450048 --> +<div class="tabular"> <table id="TBL-9" class="tabular" +cellspacing="0" cellpadding="0" +><colgroup id="TBL-9-1g"><col +id="TBL-9-1" /><col +id="TBL-9-2" /><col +id="TBL-9-3" /><col +id="TBL-9-4" /></colgroup><tr + style="vertical-align:baseline;" id="TBL-9-1-"><td style="white-space:nowrap; text-align:left;" id="TBL-9-1-1" +class="td11"><span +class="ecbx-1000">Style </span></td><td style="white-space:nowrap; text-align:center;" id="TBL-9-1-2" +class="td11"><span +class="ecbx-1000">Maximum Level</span></td><td style="white-space:nowrap; text-align:center;" id="TBL-9-1-3" +class="td11"><span +class="ecbx-1000">Homograph</span></td><td style="white-space:nowrap; text-align:center;" id="TBL-9-1-4" +class="td11"><span +class="ecbx-1000">Symbol</span></td> +</tr><tr + style="vertical-align:baseline;" id="TBL-9-2-"><td style="white-space:nowrap; text-align:left;" id="TBL-9-2-1" +class="td11"><span +class="ectt-1000">listdotted </span></td><td style="white-space:nowrap; text-align:center;" id="TBL-9-2-2" +class="td11"> 0 </td><td style="white-space:nowrap; text-align:center;" id="TBL-9-2-3" +class="td11"> </td><td style="white-space:nowrap; text-align:center;" id="TBL-9-2-4" +class="td11"> </td></tr><tr + style="vertical-align:baseline;" id="TBL-9-3-"><td style="white-space:nowrap; text-align:left;" id="TBL-9-3-1" +class="td11"><span +class="ectt-1000">sublistdotted </span></td><td style="white-space:nowrap; text-align:center;" id="TBL-9-3-2" +class="td11"> 1 </td><td style="white-space:nowrap; text-align:center;" id="TBL-9-3-3" +class="td11"> </td><td style="white-space:nowrap; text-align:center;" id="TBL-9-3-4" +class="td11"></td> +</tr><tr + style="vertical-align:baseline;" id="TBL-9-4-"><td style="white-space:nowrap; text-align:left;" id="TBL-9-4-1" +class="td11"><span +class="ectt-1000">list* </span></td><td style="white-space:nowrap; text-align:center;" id="TBL-9-4-2" +class="td11"> 1 </td><td style="white-space:nowrap; text-align:center;" id="TBL-9-4-3" +class="td11"> <span +class="pzdr-">✓ </span></td><td style="white-space:nowrap; text-align:center;" id="TBL-9-4-4" +class="td11"> </td></tr><tr + style="vertical-align:baseline;" id="TBL-9-5-"><td style="white-space:nowrap; text-align:left;" id="TBL-9-5-1" +class="td11"><span +class="ectt-1000">altlist* </span></td><td style="white-space:nowrap; text-align:center;" id="TBL-9-5-2" +class="td11"> 1 </td><td style="white-space:nowrap; text-align:center;" id="TBL-9-5-3" +class="td11"> +<span +class="pzdr-">✓ </span></td><td style="white-space:nowrap; text-align:center;" id="TBL-9-5-4" +class="td11"> </td></tr><tr + style="vertical-align:baseline;" id="TBL-9-6-"><td style="white-space:nowrap; text-align:left;" id="TBL-9-6-1" +class="td11"><span +class="ectt-1000">long*3col* </span></td><td style="white-space:nowrap; text-align:center;" id="TBL-9-6-2" +class="td11"> 1 </td><td style="white-space:nowrap; text-align:center;" id="TBL-9-6-3" +class="td11"> +<span +class="pzdr-">✓ </span></td><td style="white-space:nowrap; text-align:center;" id="TBL-9-6-4" +class="td11"> </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-9-7-"><td style="white-space:nowrap; text-align:left;" id="TBL-9-7-1" +class="td11"><span +class="ectt-1000">long4col* </span></td><td style="white-space:nowrap; text-align:center;" id="TBL-9-7-2" +class="td11"> 1 </td><td style="white-space:nowrap; text-align:center;" id="TBL-9-7-3" +class="td11"> <span +class="pzdr-">✓ </span></td><td style="white-space:nowrap; text-align:center;" id="TBL-9-7-4" +class="td11"> <span +class="pzdr-">✓ </span></td> +</tr><tr + style="vertical-align:baseline;" id="TBL-9-8-"><td style="white-space:nowrap; text-align:left;" id="TBL-9-8-1" +class="td11"><span +class="ectt-1000">altlong*4col* </span></td><td style="white-space:nowrap; text-align:center;" id="TBL-9-8-2" +class="td11"> 1 </td><td style="white-space:nowrap; text-align:center;" id="TBL-9-8-3" +class="td11"> <span +class="pzdr-">✓ </span></td><td style="white-space:nowrap; text-align:center;" id="TBL-9-8-4" +class="td11"> <span +class="pzdr-">✓ </span></td> +</tr><tr + style="vertical-align:baseline;" id="TBL-9-9-"><td style="white-space:nowrap; text-align:left;" id="TBL-9-9-1" +class="td11"><span +class="ectt-1000">long* </span></td><td style="white-space:nowrap; text-align:center;" id="TBL-9-9-2" +class="td11"> 1 </td><td style="white-space:nowrap; text-align:center;" id="TBL-9-9-3" +class="td11"> <span +class="pzdr-">✓ </span></td><td style="white-space:nowrap; text-align:center;" id="TBL-9-9-4" +class="td11"> </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-9-10-"><td style="white-space:nowrap; text-align:left;" id="TBL-9-10-1" +class="td11"><span +class="ectt-1000">super*3col* </span></td><td style="white-space:nowrap; text-align:center;" id="TBL-9-10-2" +class="td11"> 1 </td><td style="white-space:nowrap; text-align:center;" id="TBL-9-10-3" +class="td11"> <span +class="pzdr-">✓ </span></td><td style="white-space:nowrap; text-align:center;" id="TBL-9-10-4" +class="td11"> </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-9-11-"><td style="white-space:nowrap; text-align:left;" id="TBL-9-11-1" +class="td11"><span +class="ectt-1000">super4col* </span></td><td style="white-space:nowrap; text-align:center;" id="TBL-9-11-2" +class="td11"> 1 </td><td style="white-space:nowrap; text-align:center;" id="TBL-9-11-3" +class="td11"> <span +class="pzdr-">✓ </span></td><td style="white-space:nowrap; text-align:center;" id="TBL-9-11-4" +class="td11"> <span +class="pzdr-">✓ </span></td> +</tr><tr + style="vertical-align:baseline;" id="TBL-9-12-"><td style="white-space:nowrap; text-align:left;" id="TBL-9-12-1" +class="td11"><span +class="ectt-1000">altsuper*4col*</span></td><td style="white-space:nowrap; text-align:center;" id="TBL-9-12-2" +class="td11"> 1 </td><td style="white-space:nowrap; text-align:center;" id="TBL-9-12-3" +class="td11"> <span +class="pzdr-">✓ </span></td><td style="white-space:nowrap; text-align:center;" id="TBL-9-12-4" +class="td11"> <span +class="pzdr-">✓ </span></td> +</tr><tr + style="vertical-align:baseline;" id="TBL-9-13-"><td style="white-space:nowrap; text-align:left;" id="TBL-9-13-1" +class="td11"><span +class="ectt-1000">super* </span></td><td style="white-space:nowrap; text-align:center;" id="TBL-9-13-2" +class="td11"> 1 </td><td style="white-space:nowrap; text-align:center;" id="TBL-9-13-3" +class="td11"> <span +class="pzdr-">✓ </span></td><td style="white-space:nowrap; text-align:center;" id="TBL-9-13-4" +class="td11"> </td> +</tr><tr + style="vertical-align:baseline;" id="TBL-9-14-"><td style="white-space:nowrap; text-align:left;" id="TBL-9-14-1" +class="td11"><span +class="ectt-1000">index* </span></td><td style="white-space:nowrap; text-align:center;" id="TBL-9-14-2" +class="td11"> 2 </td><td style="white-space:nowrap; text-align:center;" id="TBL-9-14-3" +class="td11"> </td><td style="white-space:nowrap; text-align:center;" id="TBL-9-14-4" +class="td11"> <span +class="pzdr-">✓ </span></td> +</tr><tr + style="vertical-align:baseline;" id="TBL-9-15-"><td style="white-space:nowrap; text-align:left;" id="TBL-9-15-1" +class="td11"><span +class="ectt-1000">treenoname* </span></td><td style="white-space:nowrap; text-align:center;" id="TBL-9-15-2" +class="td11"> — </td><td style="white-space:nowrap; text-align:center;" id="TBL-9-15-3" +class="td11"> <span +class="pzdr-">✓ </span></td><td style="white-space:nowrap; text-align:center;" id="TBL-9-15-4" +class="td11"> <span +class="pzdr-">✓ </span></td> +</tr><tr + style="vertical-align:baseline;" id="TBL-9-16-"><td style="white-space:nowrap; text-align:left;" id="TBL-9-16-1" +class="td11"><span +class="ectt-1000">tree* </span></td><td style="white-space:nowrap; text-align:center;" id="TBL-9-16-2" +class="td11"> — </td><td style="white-space:nowrap; text-align:center;" id="TBL-9-16-3" +class="td11"> </td><td style="white-space:nowrap; text-align:center;" id="TBL-9-16-4" +class="td11"> <span +class="pzdr-">✓ </span></td> +</tr><tr + style="vertical-align:baseline;" id="TBL-9-17-"><td style="white-space:nowrap; text-align:left;" id="TBL-9-17-1" +class="td11"><span +class="ectt-1000">alttree* </span></td><td style="white-space:nowrap; text-align:center;" id="TBL-9-17-2" +class="td11"> — </td><td style="white-space:nowrap; text-align:center;" id="TBL-9-17-3" +class="td11"> </td><td style="white-space:nowrap; text-align:center;" id="TBL-9-17-4" +class="td11"> <span +class="pzdr-">✓ </span></td></tr></table></div> + + + + </div><hr class="endfloat" /> + </div> +<!--l. 4674--><p class="indent" > The glossary style can be set using the <span +class="ecss-1000">style</span><a + id="dx1-45011"></a> key in the optional argument to +<span +class="ectt-1000">\printglossary</span><a + id="dx1-45012"></a> or using the command: +</p><!--l. 4676--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\glossarystyle</span><span +class="ectt-0900"> </span></span><a + id="dx1-45013"></a> <span +class="ectt-1000">\glossarystyle{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">style-name</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">} </span></div><hr> +</p><!--l. 4678--><p class="noindent" > +Some of the glossary styles may also be set using the <span +class="ecss-1000">style</span><a + id="dx1-45014"></a> package option, it depends if +the package in which they are defined is automatically loaded by the <span +class="ecss-1000">glossaries</span> +package. +</p><!--l. 4683--><p class="indent" > The tabular-like styles that allow multi-line descriptions and page lists use the +length <span class="marginpar"><span +class="ectt-0900">\glsdescwidth</span><span +class="ectt-0900"> </span></span><a + id="dx1-45015"></a><span +class="ectt-1000">\glsdescwidth </span>to set the width of the description column and +the length <span class="marginpar"><span +class="ectt-0900">\glspagelistwidth</span><span +class="ectt-0900"> </span></span><a + id="dx1-45016"></a><span +class="ectt-1000">\glspagelistwidth </span>to set the width of the page list +column.<span class="footnote-mark"><a +href="#fn18x0" id="fn18x0-bk"><sup class="textsuperscript">18</sup></a></span><a + id="x1-45017f18"></a> +These will need to be changed using <span +class="ectt-1000">\setlength </span>if the glossary is too wide. Note that +the <span +class="ecss-1000">long4col</span><a + id="dx1-45021"></a> and <span +class="ecss-1000">super4col</span><a + id="dx1-45022"></a> styles (and their header and border variations) don’t use +these lengths as they are designed for single line entries. Instead you should use the +analogous <span +class="ecss-1000">altlong4col</span><a + id="dx1-45023"></a> and <span +class="ecss-1000">altsuper4col</span><a + id="dx1-45024"></a> styles. If you want to explicitly create a line-break +within a multi-line description in a tabular-like style you should use <span +class="ectt-1000">\newline</span><a + id="dx1-45025"></a> instead +of <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\\</span></span></span>. +</p><!--l. 4701--><p class="indent" > Note that if you use the <span +class="ecss-1000">style</span><a + id="dx1-45026"></a> key in the optional argument to <span +class="ectt-1000">\printglossary</span><a + id="dx1-45027"></a>, it +will override any previous style settings for the given glossary, so if, for example, you +do + + + +</p> + <div class="verbatim" id="verbatim-127"> +\renewcommand*{\glsgroupskip}{} + <br />\printglossary[style=long] +</div> +<!--l. 4708--><p class="nopar" > then the new definition of <span +class="ectt-1000">\glsgroupskip</span><a + id="dx1-45028"></a> will not have an affect for this glossary, as +<span +class="ectt-1000">\glsgroupskip </span>is redefined by <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">style=long</span></span></span>. Likewise, <span +class="ectt-1000">\glossarystyle</span><a + id="dx1-45029"></a> will also +override any previous style definitions, so, again + + + +</p> + <div class="verbatim" id="verbatim-128"> +\renewcommand*{\glsgroupskip}{} + <br />\glossarystyle{long} +</div> +<!--l. 4716--><p class="nopar" > will reset <span +class="ectt-1000">\glsgroupskip </span>back to its default definition for the named glossary style +(<span +class="ecss-1000">long</span><a + id="dx1-45030"></a> in this case). If you want to modify the styles, either use <span +class="ectt-1000">\newglossarystyle</span><a + id="dx1-45031"></a> +(described in the next section) or make the modifications after <span +class="ectt-1000">\glossarystyle</span><a + id="dx1-45032"></a>, +e.g.: + + + +</p> + <div class="verbatim" id="verbatim-129"> +\glossarystyle{long} + <br />\renewcommand*{\glsgroupskip}{} +</div> +<!--l. 4725--><p class="nopar" > +</p><!--l. 4727--><p class="indent" > All the styles except for the three- and four-column styles and the <span +class="ecss-1000">listdotted</span><a + id="dx1-45033"></a> style use +the command +</p><!--l. 4729--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\glspostdescription</span><span +class="ectt-0900"> </span></span><a + id="dx1-45034"></a> <span +class="ectt-1000">\glspostdescription </span></div><hr> +</p><!--l. 4731--><p class="noindent" > +after the description. This simply displays a full stop by default. To eliminate this +full stop (or replace it with something else, say, a comma) you will need to +redefine <span +class="ectt-1000">\glspostdescription </span>before the glossary is displayed. Alternatively, +you can suppress it for a given entry by placing <span +class="ectt-1000">\nopostdesc</span><a + id="dx1-45035"></a> in the entry’s +description. +</p> +<!--l. 4738--><p class="noindent" ><a +href="#top">Top</a></p><h4 class="subsectionHead"><span class="titlemark">15.1 </span> <a + id="x1-4600015.1"></a>List Styles</h4> +<!--l. 4741--><p class="noindent" >The styles described in this section are all defined in the package <span +class="ecss-1000">glossary-list</span><a + id="dx1-46001"></a>. Since they +all use the <span +class="ecss-1000">description</span><a + id="dx1-46002"></a><a + id="dx1-46003"></a> environment, they are governed by the same parameters as that +environment. These styles all ignore the entry’s symbol. Note that these styles +will automatically be available unless you use the <span +class="ecss-1000">nolist</span><a + id="dx1-46004"></a> or <span +class="ecss-1000">nostyles</span><a + id="dx1-46005"></a> package +options. +</p><!--l. 4748--><p class="indent" > + </p><dl class="description"><dt class="description"> +<span +class="ecbx-1000">list</span> </dt><dd +class="description">The <span +class="ecss-1000">list</span><a + id="dx1-46006"></a> style uses the <span +class="ecss-1000">description</span><a + id="dx1-46007"></a><a + id="dx1-46008"></a> environment. The entry name is placed in + the optional argument of the <span +class="ectt-1000">\item</span><a + id="dx1-46009"></a> command (so it will appear in bold by + default). The description follows, and then the associated <a + id="dx1-46010"></a><a +href="#glo:numberlist">number list<a + id="dx1-46011"></a></a> for that + entry. The symbol is ignored. If the entry has child entries, the description + and number list follows (but not the name) for each child entry. Groups are + separated using <span +class="ectt-1000">\indexspace</span><a + id="dx1-46012"></a>. + </dd><dt class="description"> +<span +class="ecbx-1000">listgroup</span> </dt><dd +class="description">The <span +class="ecss-1000">listgroup</span><a + id="dx1-46013"></a> style is like <span +class="ecss-1000">list</span><a + id="dx1-46014"></a> but the glossary groups have headings. + </dd><dt class="description"> +<span +class="ecbx-1000">listhypergroup</span> </dt><dd +class="description">The <span +class="ecss-1000">listhypergroup</span><a + id="dx1-46015"></a> style is like <span +class="ecss-1000">listgroup</span><a + id="dx1-46016"></a> but has a navigation line at + the start of the glossary with links to each group that is present in the glossary. + This requires an additional run through <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span +class="E">E</span>X</span></span> to ensure the group + information is up to date. In the navigation line, each group is separated + by + <!--l. 4766--><p class="noindent" ><hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\glshypernavsep</span><span +class="ectt-0900"> </span></span><a + id="dx1-46017"></a> <span +class="ectt-1000">\glshypernavsep </span></div><hr> + + + + </p><!--l. 4768--><p class="noindent" > + which defaults to a vertical bar with a space on either side. For example, to + simply have a space separating each group, do: + + + +</p> + <div class="verbatim" id="verbatim-130"> + \renewcommand*{\glshypernavsep}{\space} +</div> + <!--l. 4773--><p class="nopar" > + </p><!--l. 4775--><p class="noindent" >Note that the hyper-navigation line is now (as from version 1.14) set inside the + optional argument to <span +class="ectt-1000">\item</span><a + id="dx1-46018"></a> instead of after it to prevent a spurious + space at the start. This can be changed by redefining <span +class="ectt-1000">\glossaryheader</span><a + id="dx1-46019"></a>, + but note that this needs to be done <span +class="ecti-1000">after </span>the glossary style has been + set. + </p></dd><dt class="description"> +<span +class="ecbx-1000">altlist</span> </dt><dd +class="description">The <span +class="ecss-1000">altlist</span><a + id="dx1-46020"></a> style is like <span +class="ecss-1000">list</span><a + id="dx1-46021"></a> but the description starts on the line following the + name. (As with the <span +class="ecss-1000">list</span><a + id="dx1-46022"></a> style, the symbol is ignored.) Each child entry starts a new + line, but as with the <span +class="ecss-1000">list</span><a + id="dx1-46023"></a> style, the name associated with each child entry is + ignored. + </dd><dt class="description"> +<span +class="ecbx-1000">altlistgroup</span> </dt><dd +class="description">The <span +class="ecss-1000">altlistgroup</span><a + id="dx1-46024"></a> style is like <span +class="ecss-1000">altlist</span><a + id="dx1-46025"></a> but the glossary groups have + headings. + </dd><dt class="description"> +<span +class="ecbx-1000">altlisthypergroup</span> </dt><dd +class="description">The <span +class="ecss-1000">altlisthypergroup</span><a + id="dx1-46026"></a> style is like <span +class="ecss-1000">altlistgroup</span><a + id="dx1-46027"></a> but has a set of links + to the glossary groups. The navigation line is the same as that for <span +class="ecss-1000">listhypergroup</span><a + id="dx1-46028"></a>, + described above. + </dd><dt class="description"> +<span +class="ecbx-1000">listdotted</span> </dt><dd +class="description">This style uses the <span +class="ecss-1000">description</span><a + id="dx1-46029"></a><a + id="dx1-46030"></a> + environment.<span class="footnote-mark"><a +href="#fn19x0" id="fn19x0-bk"><sup class="textsuperscript">19</sup></a></span><a + id="x1-46031f19"></a> + Each entry starts with <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\item[]</span></span></span>, followed by the name followed by a dotted line, + followed by the description. Note that this style ignores both the <a + id="dx1-46032"></a><a +href="#glo:numberlist">number list<a + id="dx1-46033"></a></a> and + the symbol. The length + <!--l. 4800--><p class="noindent" ><hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\glslistdottedwidth</span><span +class="ectt-0900"> </span></span><a + id="dx1-46034"></a> <span +class="ectt-1000">\glslistdottedwidth </span></div><hr> + </p><!--l. 4802--><p class="noindent" > + governs where the description should start. This is a flat style, so child entries are + formatted in the same way as the parent entries. + </p></dd><dt class="description"> +<span +class="ecbx-1000">sublistdotted</span> </dt><dd +class="description">This is a variation on the <span +class="ecss-1000">listdotted</span><a + id="dx1-46035"></a> style designed for hierarchical + glossaries. The main entries have just the name displayed. The sub entries are + displayed in the same manner as <span +class="ecss-1000">listdotted</span><a + id="dx1-46036"></a>.</dd></dl> + + + +<!--l. 4813--><p class="noindent" > +</p> +<!--l. 4813--><p class="noindent" ><a +href="#top">Top</a></p><h4 class="subsectionHead"><span class="titlemark">15.2 </span> <a + id="x1-4700015.2"></a>Longtable Styles</h4> +<!--l. 4816--><p class="noindent" >The styles described in this section are all defined in the package <span +class="ecss-1000">glossary-long</span><a + id="dx1-47001"></a>. Since +they all use the <span +class="ecss-1000">longtable</span><a + id="dx1-47002"></a><a + id="dx1-47003"></a> environment, they are governed by the same parameters +as that environment. Note that these styles will automatically be available +unless you use the <span +class="ecss-1000">nolong</span><a + id="dx1-47004"></a> or <span +class="ecss-1000">nostyles</span><a + id="dx1-47005"></a> package options. These styles fully justify +the description and page list columns. If you want ragged right formatting +instead, use the analogous styles described in <a +href="#x1-4800015.3">§15.3 </a><a +href="#x1-4800015.3">Longtable Styles (Ragged +Right)<!--tex4ht:ref: sec:longraggedstyles --></a>. +</p><!--l. 4826--><p class="indent" > + </p><dl class="description"><dt class="description"> +<span +class="ecbx-1000">long</span> </dt><dd +class="description">The <span +class="ecss-1000">long</span><a + id="dx1-47006"></a> style uses the <span +class="ecss-1000">longtable</span><a + id="dx1-47007"></a><a + id="dx1-47008"></a> environment (defined by the <span +class="ecss-1000">longtable</span><a + id="dx1-47009"></a> + package). It has two columns: the first column contains the entry’s name and + the second column contains the description followed by the <a + id="dx1-47010"></a><a +href="#glo:numberlist">number list<a + id="dx1-47011"></a></a>. The + entry’s symbol is ignored. Sub groups are separated with a blank row. The + width of the first column is governed by the widest entry in that column. + The width of the second column is governed by the length <span +class="ectt-1000">\glsdescwidth</span><a + id="dx1-47012"></a>. + Child entries have a similar format to the parent entries except that their + name is suppressed. + </dd><dt class="description"> +<span +class="ecbx-1000">longborder</span> </dt><dd +class="description">The <span +class="ecss-1000">longborder</span><a + id="dx1-47013"></a> style is like <span +class="ecss-1000">long</span><a + id="dx1-47014"></a> but has horizontal and vertical lines + around it. + </dd><dt class="description"> +<span +class="ecbx-1000">longheader</span> </dt><dd +class="description">The <span +class="ecss-1000">longheader</span><a + id="dx1-47015"></a> style is like <span +class="ecss-1000">long</span><a + id="dx1-47016"></a> but has a header row. + </dd><dt class="description"> +<span +class="ecbx-1000">longheaderborder</span> </dt><dd +class="description">The <span +class="ecss-1000">longheaderborder</span><a + id="dx1-47017"></a> style is like <span +class="ecss-1000">longheader</span><a + id="dx1-47018"></a> but has + horizontal and vertical lines around it. + </dd><dt class="description"> +<span +class="ecbx-1000">long3col</span> </dt><dd +class="description">The <span +class="ecss-1000">long3col</span><a + id="dx1-47019"></a> style is like <span +class="ecss-1000">long</span><a + id="dx1-47020"></a> but has three columns. The first column + contains the entry’s name, the second column contains the description and + the third column contains the <a + id="dx1-47021"></a><a +href="#glo:numberlist">number list<a + id="dx1-47022"></a></a>. The entry’s symbol is ignored. The + width of the first column is governed by the widest entry in that column, the + width of the second column is governed by the length <span +class="ectt-1000">\glsdescwidth</span><a + id="dx1-47023"></a>, and + the width of the third column is governed by the length <span +class="ectt-1000">\glspagelistwidth</span><a + id="dx1-47024"></a>. + </dd><dt class="description"> +<span +class="ecbx-1000">long3colborder</span> </dt><dd +class="description">The <span +class="ecss-1000">long3colborder</span><a + id="dx1-47025"></a> style is like the <span +class="ecss-1000">long3col</span><a + id="dx1-47026"></a> style but has + horizontal and vertical lines around it. + </dd><dt class="description"> +<span +class="ecbx-1000">long3colheader</span> </dt><dd +class="description">The <span +class="ecss-1000">long3colheader</span><a + id="dx1-47027"></a> style is like <span +class="ecss-1000">long3col</span><a + id="dx1-47028"></a> but has a header row. + + + + </dd><dt class="description"> +<span +class="ecbx-1000">long3colheaderborder</span> </dt><dd +class="description">The <span +class="ecss-1000">long3colheaderborder</span><a + id="dx1-47029"></a> style is like <span +class="ecss-1000">long3colheader</span><a + id="dx1-47030"></a> but + has horizontal and vertical lines around it. + </dd><dt class="description"> +<span +class="ecbx-1000">long4col</span> </dt><dd +class="description">The <span +class="ecss-1000">long4col</span><a + id="dx1-47031"></a> style is like <span +class="ecss-1000">long3col</span><a + id="dx1-47032"></a> but has an additional column in which + the entry’s associated symbol appears. This style is used for brief single line + descriptions. The column widths are governed by the widest entry in the + given column. Use <span +class="ecss-1000">altlong4col</span><a + id="dx1-47033"></a> for multi-line descriptions. + </dd><dt class="description"> +<span +class="ecbx-1000">long4colborder</span> </dt><dd +class="description">The <span +class="ecss-1000">long4colborder</span><a + id="dx1-47034"></a> style is like the <span +class="ecss-1000">long4col</span><a + id="dx1-47035"></a> style but has + horizontal and vertical lines around it. + </dd><dt class="description"> +<span +class="ecbx-1000">long4colheader</span> </dt><dd +class="description">The <span +class="ecss-1000">long4colheader</span><a + id="dx1-47036"></a> style is like <span +class="ecss-1000">long4col</span><a + id="dx1-47037"></a> but has a header row. + </dd><dt class="description"> +<span +class="ecbx-1000">long4colheaderborder</span> </dt><dd +class="description">The <span +class="ecss-1000">long4colheaderborder</span><a + id="dx1-47038"></a> style is like <span +class="ecss-1000">long4colheader</span><a + id="dx1-47039"></a> but + has horizontal and vertical lines around it. + </dd><dt class="description"> +<span +class="ecbx-1000">altlong4col</span> </dt><dd +class="description">The <span +class="ecss-1000">altlong4col</span><a + id="dx1-47040"></a> style is like <span +class="ecss-1000">long4col</span><a + id="dx1-47041"></a> but allows multi-line descriptions + and page lists. The width of the description column is governed by the length + <span +class="ectt-1000">\glsdescwidth</span><a + id="dx1-47042"></a> and the width of the page list column is governed by the + length <span +class="ectt-1000">\glspagelistwidth</span><a + id="dx1-47043"></a>. The widths of the name and symbol columns + are governed by the widest entry in the given column. + </dd><dt class="description"> +<span +class="ecbx-1000">altlong4colborder</span> </dt><dd +class="description">The <span +class="ecss-1000">altlong4colborder</span><a + id="dx1-47044"></a> style is like the <span +class="ecss-1000">long4colborder</span><a + id="dx1-47045"></a> but + allows multi-line descriptions and page lists. + </dd><dt class="description"> +<span +class="ecbx-1000">altlong4colheader</span> </dt><dd +class="description">The <span +class="ecss-1000">altlong4colheader</span><a + id="dx1-47046"></a> style is like <span +class="ecss-1000">long4colheader</span><a + id="dx1-47047"></a> but allows + multi-line descriptions and page lists. + </dd><dt class="description"> +<span +class="ecbx-1000">altlong4colheaderborder</span> </dt><dd +class="description">The <span +class="ecss-1000">altlong4colheaderborder</span><a + id="dx1-47048"></a> + style is like <span +class="ecss-1000">long4colheaderborder</span><a + id="dx1-47049"></a> but allows multi-line descriptions and page + lists.</dd></dl> +<!--l. 4909--><p class="noindent" > +</p> +<!--l. 4909--><p class="noindent" ><a +href="#top">Top</a></p><h4 class="subsectionHead"><span class="titlemark">15.3 </span> <a + id="x1-4800015.3"></a>Longtable Styles (Ragged Right)</h4> + + + +<!--l. 4912--><p class="noindent" >The styles described in this section are all defined in the package <span +class="ecss-1000">glossary-longragged</span><a + id="dx1-48001"></a>. +These styles are analogous to those defined in <span +class="ecss-1000">glossary-long</span><a + id="dx1-48002"></a> but the multiline +columns are left justified instead of fully justified. Since these styles all use +the <span +class="ecss-1000">longtable</span><a + id="dx1-48003"></a><a + id="dx1-48004"></a> environment, they are governed by the same parameters as that +environment. The <span +class="ecss-1000">glossary-longragged</span><a + id="dx1-48005"></a> package additionally requires the <span +class="ecss-1000">array</span><a + id="dx1-48006"></a> +package. Note that these styles will only be available if you explicitly load +<span +class="ecss-1000">glossary-longragged</span><a + id="dx1-48007"></a>: + + + +</p> + <div class="verbatim" id="verbatim-131"> +\usepackage{glossaries} + <br />\usepackage{glossary-longragged} +</div> +<!--l. 4924--><p class="nopar" > Note that you can’t set these styles using the <span +class="ecss-1000">style</span><a + id="dx1-48008"></a> package option since the styles +aren’t defined until after the <span +class="ecss-1000">glossaries </span>package has been loaded. +</p><!--l. 4929--><p class="indent" > + </p><dl class="description"><dt class="description"> +<span +class="ecbx-1000">longragged</span> </dt><dd +class="description">The <span +class="ecss-1000">longragged</span><a + id="dx1-48009"></a> style has two columns: the first column contains the + entry’s name and the second column contains the (left-justified) description + followed by the <a + id="dx1-48010"></a><a +href="#glo:numberlist">number list<a + id="dx1-48011"></a></a>. The entry’s symbol is ignored. Sub groups are + separated with a blank row. The width of the first column is governed by the + widest entry in that column. The width of the second column is governed by + the length <span +class="ectt-1000">\glsdescwidth</span><a + id="dx1-48012"></a>. Child entries have a similar format to the parent + entries except that their name is suppressed. + </dd><dt class="description"> +<span +class="ecbx-1000">longraggedborder</span> </dt><dd +class="description">The <span +class="ecss-1000">longraggedborder</span><a + id="dx1-48013"></a> style is like <span +class="ecss-1000">longragged</span><a + id="dx1-48014"></a> but has + horizontal and vertical lines around it. + </dd><dt class="description"> +<span +class="ecbx-1000">longraggedheader</span> </dt><dd +class="description">The <span +class="ecss-1000">longraggedheader</span><a + id="dx1-48015"></a> style is like <span +class="ecss-1000">longragged</span><a + id="dx1-48016"></a> but has a header + row. + </dd><dt class="description"> +<span +class="ecbx-1000">longraggedheaderborder</span> </dt><dd +class="description">The + <span +class="ecss-1000">longraggedheaderborder</span><a + id="dx1-48017"></a> style is like <span +class="ecss-1000">longraggedheader</span><a + id="dx1-48018"></a> but has horizontal and + vertical lines around it. + </dd><dt class="description"> +<span +class="ecbx-1000">longragged3col</span> </dt><dd +class="description">The <span +class="ecss-1000">longragged3col</span><a + id="dx1-48019"></a> style is like <span +class="ecss-1000">longragged</span><a + id="dx1-48020"></a> but has three + columns. The first column contains the entry’s name, the second column + contains the (left justified) description and the third column contains the + (left justified) <a + id="dx1-48021"></a><a +href="#glo:numberlist">number list<a + id="dx1-48022"></a></a>. The entry’s symbol is ignored. The width of the + first column is governed by the widest entry in that column, the width of + the second column is governed by the length <span +class="ectt-1000">\glsdescwidth</span><a + id="dx1-48023"></a>, and the width + of the third column is governed by the length <span +class="ectt-1000">\glspagelistwidth</span><a + id="dx1-48024"></a>. + </dd><dt class="description"> +<span +class="ecbx-1000">longragged3colborder</span> </dt><dd +class="description">The <span +class="ecss-1000">longragged3colborder</span><a + id="dx1-48025"></a> style is like the <span +class="ecss-1000">longragged3col</span><a + id="dx1-48026"></a> + style but has horizontal and vertical lines around it. + </dd><dt class="description"> +<span +class="ecbx-1000">longragged3colheader</span> </dt><dd +class="description">The <span +class="ecss-1000">longragged3colheader</span><a + id="dx1-48027"></a> style is like <span +class="ecss-1000">longragged3col</span><a + id="dx1-48028"></a> but + has a header row. + + + + </dd><dt class="description"> +<span +class="ecbx-1000">longragged3colheaderborder</span> </dt><dd +class="description">The <span +class="ecss-1000">longragged3colheaderborder</span><a + id="dx1-48029"></a> style is like + <span +class="ecss-1000">longragged3colheader</span><a + id="dx1-48030"></a> but has horizontal and vertical lines around it. + </dd><dt class="description"> +<span +class="ecbx-1000">altlongragged4col</span> </dt><dd +class="description">The <span +class="ecss-1000">altlongragged4col</span><a + id="dx1-48031"></a> style is like <span +class="ecss-1000">longragged3col</span><a + id="dx1-48032"></a> but has an + additional column in which the entry’s associated symbol appears. The width + of the description column is governed by the length <span +class="ectt-1000">\glsdescwidth</span><a + id="dx1-48033"></a> and the + width of the page list column is governed by the length <span +class="ectt-1000">\glspagelistwidth</span><a + id="dx1-48034"></a>. + The widths of the name and symbol columns are governed by the widest + entry in the given column. + </dd><dt class="description"> +<span +class="ecbx-1000">altlongragged4colborder</span> </dt><dd +class="description">The + <span +class="ecss-1000">altlongragged4colborder</span><a + id="dx1-48035"></a> style is like the <span +class="ecss-1000">altlongragged4col</span><a + id="dx1-48036"></a> but has horizontal + and vertical lines around it. + </dd><dt class="description"> +<span +class="ecbx-1000">altlongragged4colheader</span> </dt><dd +class="description">The <span +class="ecss-1000">altlongragged4colheader</span><a + id="dx1-48037"></a> style is like + <span +class="ecss-1000">altlongragged4col</span><a + id="dx1-48038"></a> but has a header row. + </dd><dt class="description"> +<span +class="ecbx-1000">altlongragged4colheaderborder</span> </dt><dd +class="description">The <span +class="ecss-1000">altlongragged4colheaderborder</span><a + id="dx1-48039"></a> style is like + <span +class="ecss-1000">altlongragged4colheader</span><a + id="dx1-48040"></a> but has horizontal and vertical lines around it. + </dd></dl> +<!--l. 4996--><p class="noindent" > +</p> +<!--l. 4996--><p class="noindent" ><a +href="#top">Top</a></p><h4 class="subsectionHead"><span class="titlemark">15.4 </span> <a + id="x1-4900015.4"></a>Supertabular Styles</h4> +<!--l. 4999--><p class="noindent" >The styles described in this section are all defined in the package <span +class="ecss-1000">glossary-super</span><a + id="dx1-49001"></a>. Since +they all use the <span +class="ecss-1000">supertabular</span><a + id="dx1-49002"></a><a + id="dx1-49003"></a> environment, they are governed by the same parameters +as that environment. Note that these styles will automatically be available +unless you use the <span +class="ecss-1000">nosuper</span><a + id="dx1-49004"></a> or <span +class="ecss-1000">nostyles</span><a + id="dx1-49005"></a> package options. In general, the <span +class="ecss-1000">longtable</span><a + id="dx1-49006"></a><a + id="dx1-49007"></a> +environment is better, but there are some circumstances where it is better to use +<span +class="ecss-1000">supertabular</span><a + id="dx1-49008"></a><a + id="dx1-49009"></a>.<span class="footnote-mark"><a +href="#fn20x0" id="fn20x0-bk"><sup class="textsuperscript">20</sup></a></span><a + id="x1-49010f20"></a> +These styles fully justify the description and page list columns. If you want ragged right +formatting instead, use the analogous styles described in <a +href="#x1-5000015.5">§15.5 </a><a +href="#x1-5000015.5">Supertabular Styles +(Ragged Right)<!--tex4ht:ref: sec:superraggedstyles --></a>. +</p><!--l. 5011--><p class="indent" > + </p><dl class="description"><dt class="description"> +<span +class="ecbx-1000">super</span> </dt><dd +class="description">The <span +class="ecss-1000">super</span><a + id="dx1-49012"></a> style uses the <span +class="ecss-1000">supertabular</span><a + id="dx1-49013"></a><a + id="dx1-49014"></a> environment (defined by the + <span +class="ecss-1000">supertabular</span><a + id="dx1-49015"></a> package). It has two columns: the first column contains the + entry’s name and the second column contains the description followed by the + <a + id="dx1-49016"></a><a +href="#glo:numberlist">number list<a + id="dx1-49017"></a></a>. The entry’s symbol is ignored. Sub groups are separated with + + + + a blank row. The width of the first column is governed by the widest entry + in that column. The width of the second column is governed by the length + <span +class="ectt-1000">\glsdescwidth</span><a + id="dx1-49018"></a>. Child entries have a similar format to the parent entries + except that their name is suppressed. + </dd><dt class="description"> +<span +class="ecbx-1000">superborder</span> </dt><dd +class="description">The <span +class="ecss-1000">superborder</span><a + id="dx1-49019"></a> style is like <span +class="ecss-1000">super</span><a + id="dx1-49020"></a> but has horizontal and vertical + lines around it. + </dd><dt class="description"> +<span +class="ecbx-1000">superheader</span> </dt><dd +class="description">The <span +class="ecss-1000">superheader</span><a + id="dx1-49021"></a> style is like <span +class="ecss-1000">super</span><a + id="dx1-49022"></a> but has a header row. + </dd><dt class="description"> +<span +class="ecbx-1000">superheaderborder</span> </dt><dd +class="description">The <span +class="ecss-1000">superheaderborder</span><a + id="dx1-49023"></a> style is like <span +class="ecss-1000">superheader</span><a + id="dx1-49024"></a> but has + horizontal and vertical lines around it. + </dd><dt class="description"> +<span +class="ecbx-1000">super3col</span> </dt><dd +class="description">The <span +class="ecss-1000">super3col</span><a + id="dx1-49025"></a> style is like <span +class="ecss-1000">super</span><a + id="dx1-49026"></a> but has three columns. The + first column contains the entry’s name, the second column contains the + description and the third column contains the <a + id="dx1-49027"></a><a +href="#glo:numberlist">number list<a + id="dx1-49028"></a></a>. The entry’s + symbol is ignored. The width of the first column is governed by the widest + entry in that column. The width of the second column is governed by the + length <span +class="ectt-1000">\glsdescwidth</span><a + id="dx1-49029"></a>. The width of the third column is governed by the + length <span +class="ectt-1000">\glspagelistwidth</span><a + id="dx1-49030"></a>. + </dd><dt class="description"> +<span +class="ecbx-1000">super3colborder</span> </dt><dd +class="description">The <span +class="ecss-1000">super3colborder</span><a + id="dx1-49031"></a> style is like the <span +class="ecss-1000">super3col</span><a + id="dx1-49032"></a> style but has + horizontal and vertical lines around it. + </dd><dt class="description"> +<span +class="ecbx-1000">super3colheader</span> </dt><dd +class="description">The <span +class="ecss-1000">super3colheader</span><a + id="dx1-49033"></a> style is like <span +class="ecss-1000">super3col</span><a + id="dx1-49034"></a> but has a header + row. + </dd><dt class="description"> +<span +class="ecbx-1000">super3colheaderborder</span> </dt><dd +class="description">The <span +class="ecss-1000">super3colheaderborder</span><a + id="dx1-49035"></a> style is like <span +class="ecss-1000">super3colheader</span><a + id="dx1-49036"></a> + but has horizontal and vertical lines around it. + </dd><dt class="description"> +<span +class="ecbx-1000">super4col</span> </dt><dd +class="description">The <span +class="ecss-1000">super4col</span><a + id="dx1-49037"></a> style is like <span +class="ecss-1000">super3col</span><a + id="dx1-49038"></a> but has an additional column in + which the entry’s associated symbol appears. This style is designed for entries + with brief single line descriptions. The column widths are governed by the + widest entry in the given column. Use <span +class="ecss-1000">altsuper4col</span><a + id="dx1-49039"></a> for multi-line descriptions. + </dd><dt class="description"> +<span +class="ecbx-1000">super4colborder</span> </dt><dd +class="description">The <span +class="ecss-1000">super4colborder</span><a + id="dx1-49040"></a> style is like the <span +class="ecss-1000">super4col</span><a + id="dx1-49041"></a> style but has + horizontal and vertical lines around it. + </dd><dt class="description"> +<span +class="ecbx-1000">super4colheader</span> </dt><dd +class="description">The <span +class="ecss-1000">super4colheader</span><a + id="dx1-49042"></a> style is like <span +class="ecss-1000">super4col</span><a + id="dx1-49043"></a> but has a header + row. + + + + </dd><dt class="description"> +<span +class="ecbx-1000">super4colheaderborder</span> </dt><dd +class="description">The <span +class="ecss-1000">super4colheaderborder</span><a + id="dx1-49044"></a> style is like <span +class="ecss-1000">super4colheader</span><a + id="dx1-49045"></a> + but has horizontal and vertical lines around it. + </dd><dt class="description"> +<span +class="ecbx-1000">altsuper4col</span> </dt><dd +class="description">The <span +class="ecss-1000">altsuper4col</span><a + id="dx1-49046"></a> style is like <span +class="ecss-1000">super4col</span><a + id="dx1-49047"></a> but allows multi-line + descriptions and page lists. The width of the description column is governed + by the length <span +class="ectt-1000">\glsdescwidth</span><a + id="dx1-49048"></a> and the width of the page list column is + governed by the length <span +class="ectt-1000">\glspagelistwidth</span><a + id="dx1-49049"></a>. The width of the name and + symbol columns is governed by the widest entry in the given column. + </dd><dt class="description"> +<span +class="ecbx-1000">altsuper4colborder</span> </dt><dd +class="description">The <span +class="ecss-1000">altsuper4colborder</span><a + id="dx1-49050"></a> style is like the <span +class="ecss-1000">super4colborder</span><a + id="dx1-49051"></a> style + but allows multi-line descriptions and page lists. + </dd><dt class="description"> +<span +class="ecbx-1000">altsuper4colheader</span> </dt><dd +class="description">The <span +class="ecss-1000">altsuper4colheader</span><a + id="dx1-49052"></a> style is like <span +class="ecss-1000">super4colheader</span><a + id="dx1-49053"></a> but + allows multi-line descriptions and page lists. + </dd><dt class="description"> +<span +class="ecbx-1000">altsuper4colheaderborder</span> </dt><dd +class="description">The <span +class="ecss-1000">altsuper4colheaderborder</span><a + id="dx1-49054"></a> style is like + <span +class="ecss-1000">super4colheaderborder</span><a + id="dx1-49055"></a> but allows multi-line descriptions and page lists.</dd></dl> +<!--l. 5095--><p class="noindent" > +</p> +<!--l. 5095--><p class="noindent" ><a +href="#top">Top</a></p><h4 class="subsectionHead"><span class="titlemark">15.5 </span> <a + id="x1-5000015.5"></a>Supertabular Styles (Ragged Right)</h4> +<!--l. 5098--><p class="noindent" >The styles described in this section are all defined in the package <span +class="ecss-1000">glossary-superragged</span><a + id="dx1-50001"></a>. +These styles are analogous to those defined in <span +class="ecss-1000">glossary-super</span><a + id="dx1-50002"></a> but the multiline +columns are left justified instead of fully justified. Since these styles all use the +<span +class="ecss-1000">supertabular</span><a + id="dx1-50003"></a><a + id="dx1-50004"></a> environment, they are governed by the same parameters as that +environment. The <span +class="ecss-1000">glossary-superragged</span><a + id="dx1-50005"></a> package additionally requires the <span +class="ecss-1000">array</span><a + id="dx1-50006"></a> +package. Note that these styles will only be available if you explicitly load +<span +class="ecss-1000">glossary-superragged</span><a + id="dx1-50007"></a>: + + + +</p> + <div class="verbatim" id="verbatim-132"> +\usepackage{glossaries} + <br />\usepackage{glossary-superragged} +</div> +<!--l. 5110--><p class="nopar" > Note that you can’t set these styles using the <span +class="ecss-1000">style</span><a + id="dx1-50008"></a> package option since the styles +aren’t defined until after the <span +class="ecss-1000">glossaries </span>package has been loaded. +</p><!--l. 5115--><p class="indent" > + </p><dl class="description"><dt class="description"> +<span +class="ecbx-1000">superragged</span> </dt><dd +class="description">The <span +class="ecss-1000">superragged</span><a + id="dx1-50009"></a> style uses the <span +class="ecss-1000">supertabular</span><a + id="dx1-50010"></a><a + id="dx1-50011"></a> environment (defined by + the <span +class="ecss-1000">supertabular</span><a + id="dx1-50012"></a> package). It has two columns: the first column contains the + entry’s name and the second column contains the (left justified) description + followed by the <a + id="dx1-50013"></a><a +href="#glo:numberlist">number list<a + id="dx1-50014"></a></a>. The entry’s symbol is ignored. Sub groups are + separated with a blank row. The width of the first column is governed by the + widest entry in that column. The width of the second column is governed by + the length <span +class="ectt-1000">\glsdescwidth</span><a + id="dx1-50015"></a>. Child entries have a similar format to the parent + entries except that their name is suppressed. + </dd><dt class="description"> +<span +class="ecbx-1000">superraggedborder</span> </dt><dd +class="description">The <span +class="ecss-1000">superraggedborder</span><a + id="dx1-50016"></a> style is like <span +class="ecss-1000">superragged</span><a + id="dx1-50017"></a> but has + horizontal and vertical lines around it. + </dd><dt class="description"> +<span +class="ecbx-1000">superraggedheader</span> </dt><dd +class="description">The <span +class="ecss-1000">superraggedheader</span><a + id="dx1-50018"></a> style is like <span +class="ecss-1000">superragged</span><a + id="dx1-50019"></a> but has a + header row. + </dd><dt class="description"> +<span +class="ecbx-1000">superraggedheaderborder</span> </dt><dd +class="description">The <span +class="ecss-1000">superraggedheaderborder</span><a + id="dx1-50020"></a> style is like + <span +class="ecss-1000">superraggedheader</span><a + id="dx1-50021"></a> but has horizontal and vertical lines around it. + </dd><dt class="description"> +<span +class="ecbx-1000">superragged3col</span> </dt><dd +class="description">The <span +class="ecss-1000">superragged3col</span><a + id="dx1-50022"></a> style is like <span +class="ecss-1000">superragged</span><a + id="dx1-50023"></a> but has three + columns. The first column contains the entry’s name, the second column + contains the (left justified) description and the third column contains the + (left justified) <a + id="dx1-50024"></a><a +href="#glo:numberlist">number list<a + id="dx1-50025"></a></a>. The entry’s symbol is ignored. The width of the + first column is governed by the widest entry in that column. The width of + the second column is governed by the length <span +class="ectt-1000">\glsdescwidth</span><a + id="dx1-50026"></a>. The width of + the third column is governed by the length <span +class="ectt-1000">\glspagelistwidth</span><a + id="dx1-50027"></a>. + </dd><dt class="description"> +<span +class="ecbx-1000">superragged3colborder</span> </dt><dd +class="description">The <span +class="ecss-1000">superragged3colborder</span><a + id="dx1-50028"></a> style + is like the <span +class="ecss-1000">superragged3col</span><a + id="dx1-50029"></a> style but has horizontal and vertical lines around + it. + + + + </dd><dt class="description"> +<span +class="ecbx-1000">superragged3colheader</span> </dt><dd +class="description">The <span +class="ecss-1000">superragged3colheader</span><a + id="dx1-50030"></a> style is like <span +class="ecss-1000">superragged3col</span><a + id="dx1-50031"></a> + but has a header row. + </dd><dt class="description"> +<span +class="ecbx-1000">superragged3colheaderborder</span> </dt><dd +class="description">The <span +class="ecss-1000">superragged3colheaderborder</span><a + id="dx1-50032"></a> style is like + <span +class="ecss-1000">superragged3colheader</span><a + id="dx1-50033"></a> but has horizontal and vertical lines around it. + </dd><dt class="description"> +<span +class="ecbx-1000">altsuperragged4col</span> </dt><dd +class="description">The <span +class="ecss-1000">altsuperragged4col</span><a + id="dx1-50034"></a> style is like <span +class="ecss-1000">superragged3col</span><a + id="dx1-50035"></a> but has + an additional column in which the entry’s associated symbol appears. The + column widths for the name and symbol column are governed by the widest + entry in the given column. + </dd><dt class="description"> +<span +class="ecbx-1000">altsuperragged4colborder</span> </dt><dd +class="description">The <span +class="ecss-1000">altsuperragged4colborder</span><a + id="dx1-50036"></a> style is like the + <span +class="ecss-1000">altsuperragged4col</span><a + id="dx1-50037"></a> style but has horizontal and vertical lines around it. + </dd><dt class="description"> +<span +class="ecbx-1000">altsuperragged4colheader</span> </dt><dd +class="description">The <span +class="ecss-1000">altsuperragged4colheader</span><a + id="dx1-50038"></a> style is like + <span +class="ecss-1000">altsuperragged4col</span><a + id="dx1-50039"></a> but has a header row. + </dd><dt class="description"> +<span +class="ecbx-1000">altsuperragged4colheaderborder</span> </dt><dd +class="description">The <span +class="ecss-1000">altsuperragged4colheaderborder</span><a + id="dx1-50040"></a> style is + like <span +class="ecss-1000">altsuperragged4colheader</span><a + id="dx1-50041"></a> but has horizontal and vertical lines around it. + </dd></dl> +<!--l. 5183--><p class="noindent" > +</p> +<!--l. 5183--><p class="noindent" ><a +href="#top">Top</a></p><h4 class="subsectionHead"><span class="titlemark">15.6 </span> <a + id="x1-5100015.6"></a>Tree-Like Styles</h4> +<!--l. 5186--><p class="noindent" >The styles described in this section are all defined in the package <span +class="ecss-1000">glossary-tree</span><a + id="dx1-51001"></a>. These +styles are designed for hierarchical glossaries but can also be used with glossaries that +don’t have sub-entries. These styles will display the entry’s symbol if it exists. Note that +these styles will automatically be available unless you use the <span +class="ecss-1000">notree</span><a + id="dx1-51002"></a> or <span +class="ecss-1000">nostyles</span><a + id="dx1-51003"></a> package +options. +</p><!--l. 5194--><p class="indent" > + </p><dl class="description"><dt class="description"> +<span +class="ecbx-1000">index</span> </dt><dd +class="description">The <span +class="ecss-1000">index</span><a + id="dx1-51004"></a> style is similar to the way indices are usually formatted in that + it has a hierarchical structure up to three levels (the main level plus two + sub-levels). The name is typeset in bold, and if the symbol is present it is + set in parentheses after the name and before the description. Sub-entries are + indented and also include the name, the symbol in brackets (if present) and + the description. Groups are separated using <span +class="ectt-1000">\indexspace</span><a + id="dx1-51005"></a>. + + + + </dd><dt class="description"> +<span +class="ecbx-1000">indexgroup</span> </dt><dd +class="description">The <span +class="ecss-1000">indexgroup</span><a + id="dx1-51006"></a> style is similar to the <span +class="ecss-1000">index</span><a + id="dx1-51007"></a> style except that each + group has a heading. + </dd><dt class="description"> +<span +class="ecbx-1000">indexhypergroup</span> </dt><dd +class="description">The <span +class="ecss-1000">indexhypergroup</span><a + id="dx1-51008"></a> style is like <span +class="ecss-1000">indexgroup</span><a + id="dx1-51009"></a> but has a set of + links to the glossary groups. The navigation line is the same as that for + <span +class="ecss-1000">listhypergroup</span><a + id="dx1-51010"></a>, described above. + </dd><dt class="description"> +<span +class="ecbx-1000">tree</span> </dt><dd +class="description">The <span +class="ecss-1000">tree</span><a + id="dx1-51011"></a> style is similar to the <span +class="ecss-1000">index</span><a + id="dx1-51012"></a> style except that it can have arbitrary + levels. (Note that <a + id="dx1-51013"></a><a +href="#glo:makeindex"><span +class="ectt-1000">makeindex</span><a + id="dx1-51014"></a></a> is limited to three levels, so you will need to + use <a + id="dx1-51015"></a><a +href="#glo:xindy"><span +class="ectt-1000">xindy</span><a + id="dx1-51016"></a></a> if you want more than three levels.) Each sub-level is indented by + <span class="marginpar"><span +class="ectt-0900">\glstreeindent</span><span +class="ectt-0900"> </span></span><a + id="dx1-51017"></a><span +class="ectt-1000">\glstreeindent</span>. Note that the name, symbol (if present) + and description are placed in the same paragraph block. If you want the + name to be apart from the description, use the <span +class="ecss-1000">alttree</span><a + id="dx1-51018"></a> style instead. (See + below.) + </dd><dt class="description"> +<span +class="ecbx-1000">treegroup</span> </dt><dd +class="description">The <span +class="ecss-1000">treegroup</span><a + id="dx1-51019"></a> style is similar to the <span +class="ecss-1000">tree</span><a + id="dx1-51020"></a> style except that each group + has a heading. + </dd><dt class="description"> +<span +class="ecbx-1000">treehypergroup</span> </dt><dd +class="description">The <span +class="ecss-1000">treehypergroup</span><a + id="dx1-51021"></a> style is like <span +class="ecss-1000">treegroup</span><a + id="dx1-51022"></a> but has a set of links to + the glossary groups. The navigation line is the same as that for <span +class="ecss-1000">listhypergroup</span><a + id="dx1-51023"></a>, + described above. + </dd><dt class="description"> +<span +class="ecbx-1000">treenoname</span> </dt><dd +class="description">The <span +class="ecss-1000">treenoname</span><a + id="dx1-51024"></a> style is like the <span +class="ecss-1000">tree</span><a + id="dx1-51025"></a> style except that the name for + each sub-entry is ignored. + </dd><dt class="description"> +<span +class="ecbx-1000">treenonamegroup</span> </dt><dd +class="description">The <span +class="ecss-1000">treenonamegroup</span><a + id="dx1-51026"></a> style is similar to the <span +class="ecss-1000">treenoname</span><a + id="dx1-51027"></a> style + except that each group has a heading. + </dd><dt class="description"> +<span +class="ecbx-1000">treenonamehypergroup</span> </dt><dd +class="description">The <span +class="ecss-1000">treenonamehypergroup</span><a + id="dx1-51028"></a> + style is like <span +class="ecss-1000">treenonamegroup</span><a + id="dx1-51029"></a> but has a set of links to the glossary groups. + The navigation line is the same as that for <span +class="ecss-1000">listhypergroup</span><a + id="dx1-51030"></a>, described above. + </dd><dt class="description"> +<span +class="ecbx-1000">alttree</span> </dt><dd +class="description">The <span +class="ecss-1000">alttree</span><a + id="dx1-51031"></a> style is similar to the <span +class="ecss-1000">tree</span><a + id="dx1-51032"></a> style except that the indentation for each + level is determined by the width of the text specified by + <!--l. 5246--><p class="noindent" ><hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\glssetwidest</span><span +class="ectt-0900"> </span></span><a + id="dx1-51033"></a> <span +class="ectt-1000">\glssetwidest[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">level</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">]{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">text</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">} </span></div><hr> + </p><!--l. 5248--><p class="noindent" > + The optional argument <span +class="cmsy-10">⟨</span><span +class="ecti-1000">level</span><span +class="cmsy-10">⟩ </span>indicates the level, where 0 indicates the top-most + level, 1 indicates the first level sub-entries, etc. If <span +class="ectt-1000">\glssetwidest </span>hasn’t been + used for a given sub-level, the level 0 widest text is used instead. If <span +class="cmsy-10">⟨</span><span +class="ecti-1000">level</span><span +class="cmsy-10">⟩ </span>is + omitted, 0 is assumed. + + + + </p><!--l. 5255--><p class="noindent" >For each level, the name is placed to the left of the paragraph block containing the + symbol (optional) and the description. If the symbol is present, it is placed in + parentheses before the description. + </p></dd><dt class="description"> +<span +class="ecbx-1000">alttreegroup</span> </dt><dd +class="description">The <span +class="ecss-1000">alttreegroup</span><a + id="dx1-51034"></a> is like the <span +class="ecss-1000">alttree</span><a + id="dx1-51035"></a> style except that each group has a + heading. + </dd><dt class="description"> +<span +class="ecbx-1000">alttreehypergroup</span> </dt><dd +class="description">The <span +class="ecss-1000">alttreehypergroup</span><a + id="dx1-51036"></a> style is like <span +class="ecss-1000">alttreegroup</span><a + id="dx1-51037"></a> but has a set of + links to the glossary groups. The navigation line is the same as that for + <span +class="ecss-1000">listhypergroup</span><a + id="dx1-51038"></a>, described above. + </dd></dl> +<!--l. 5270--><p class="noindent" > +</p> +<!--l. 5270--><p class="noindent" ><a +href="#top">Top</a></p><h3 class="sectionHead"><span class="titlemark">16 </span> <a + id="x1-5200016"></a>Defining your own glossary style</h3> +<!--l. 5273--><p class="noindent" >If the predefined styles don’t fit your requirements, you can define your own style +using: +</p><!--l. 5275--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\newglossarystyle</span><span +class="ectt-0900"> </span></span><a + id="dx1-52001"></a> <span +class="ectt-1000">\newglossarystyle{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">name</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">definitions</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">} </span></div><hr> +</p><!--l. 5277--><p class="noindent" > +where <span +class="cmsy-10">⟨</span><span +class="ecti-1000">name</span><span +class="cmsy-10">⟩ </span>is the name of the new glossary style (to be used in <span +class="ectt-1000">\glossarystyle</span>). +The second argument <span +class="cmsy-10">⟨</span><span +class="ecti-1000">definitions</span><span +class="cmsy-10">⟩ </span>needs to redefine all of the following: +</p><!--l. 5282--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">theglossary</span><span +class="ectt-0900"> </span></span><a + id="dx1-52002"></a><a + id="dx1-52003"></a> <span +class="ecss-1000">theglossary</span><a + id="dx1-52004"></a><a + id="dx1-52005"></a> </div><hr> +</p><!--l. 5284--><p class="noindent" > +This environment defines how the main body of the glossary should be typeset. Note +that this does not include the section heading, the glossary preamble (defined by +<span +class="ectt-1000">\glossarypreamble</span><a + id="dx1-52006"></a>) or the glossary postamble (defined by <span +class="ectt-1000">\glossarypostamble</span><a + id="dx1-52007"></a>). For +example, the <span +class="ecss-1000">list</span><a + id="dx1-52008"></a> style uses the <span +class="ecss-1000">description</span><a + id="dx1-52009"></a><a + id="dx1-52010"></a> environment, so the <span +class="ecss-1000">theglossary</span><a + id="dx1-52011"></a><a + id="dx1-52012"></a> environment +is simply redefined to begin and end the <span +class="ecss-1000">description</span><a + id="dx1-52013"></a><a + id="dx1-52014"></a> environment. +</p><!--l. 5293--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\glossaryheader</span><span +class="ectt-0900"> </span></span><a + id="dx1-52015"></a> <span +class="ectt-1000">\glossaryheader </span></div><hr> +</p><!--l. 5295--><p class="noindent" > +This macro indicates what to do at the start of the main body of the glossary. Note +that this is not the same as <span +class="ectt-1000">\glossarypreamble</span><a + id="dx1-52016"></a>, which should not be affected by +changes in the glossary style. The <span +class="ecss-1000">list</span><a + id="dx1-52017"></a> glossary style redefines <span +class="ectt-1000">\glossaryheader</span><a + id="dx1-52018"></a> to do +nothing, whereas the <span +class="ecss-1000">longheader</span><a + id="dx1-52019"></a> glossary style redefines <span +class="ectt-1000">\glossaryheader </span>to do a +header row. +</p><!--l. 5303--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\glsgroupheading</span><span +class="ectt-0900"> </span></span><a + id="dx1-52020"></a> <span +class="ectt-1000">\glsgroupheading{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">} </span></div><hr> +</p><!--l. 5305--><p class="noindent" > +This macro indicates what to do at the start of each logical block within the main body +of the glossary. If you use <a + id="dx1-52021"></a><a +href="#glo:makeindex"><span +class="ectt-1000">makeindex</span><a + id="dx1-52022"></a></a> the glossary is sub-divided into a maximum of +twenty-eight logical blocks that are determined by the first character of the <span +class="ecss-1000">sort</span><a + id="dx1-52023"></a> key (or +<span +class="ecss-1000">name</span><a + id="dx1-52024"></a> key if the <span +class="ecss-1000">sort</span><a + id="dx1-52025"></a> key is omitted). The sub-divisions are in the following order: +symbols, numbers, A, …, Z. If you use <a + id="dx1-52026"></a><a +href="#glo:xindy"><span +class="ectt-1000">xindy</span><a + id="dx1-52027"></a></a>, the sub-divisions depend on the language + + + +settings. +</p><!--l. 5316--><p class="indent" > Note that the argument to <span +class="ectt-1000">\glsgroupheading </span>is a label <span +class="ecti-1000">not </span>the group title. The +group title can be obtained via +</p><!--l. 5319--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\glsgetgrouptitle</span><span +class="ectt-0900"> </span></span><a + id="dx1-52028"></a> <span +class="ectt-1000">\glsgetgrouptitle{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">} </span></div><hr> +</p><!--l. 5321--><p class="noindent" > +This obtains the title as follows: if <span +class="ectt-1000">\</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">groupname </span>exists, this is taken to be the title, +otherwise the title is just <span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩</span>. +</p><!--l. 5326--><p class="indent" > A navigation hypertarget can be created using +</p><!--l. 5327--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\glsnavhypertarget</span><span +class="ectt-0900"> </span></span><a + id="dx1-52029"></a> <span +class="ectt-1000">\glsnavhypertarget{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">text</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">} </span></div><hr> +</p><!--l. 5329--><p class="noindent" > +For further details about <span +class="ectt-1000">\glsnavhypertarget</span>, see the documented code +(<span +class="ectt-1000">glossaries.pdf</span>). +</p><!--l. 5334--><p class="indent" > Most of the predefined glossary styles redefine <span +class="ectt-1000">\glsgroupheading </span>to simply +ignore its argument. The <span +class="ecss-1000">listhypergroup</span><a + id="dx1-52030"></a> style redefines <span +class="ectt-1000">\glsgroupheading </span>as +follows: + + + +</p> + <div class="verbatim" id="verbatim-133"> +\renewcommand*{\glsgroupheading}[1]{% + <br />\item[\glsnavhypertarget{##1}{\glsgetgrouptitle{##1}}]} +</div> +<!--l. 5340--><p class="nopar" > See also <span +class="ectt-1000">\glsgroupskip </span>below. (Note that command definitions within +<span +class="ectt-1000">\newglossarystyle</span><a + id="dx1-52031"></a> must use <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">##1</span></span></span> instead of <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">#1</span></span></span> etc.) +</p><!--l. 5344--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\glsgroupskip</span><span +class="ectt-0900"> </span></span><a + id="dx1-52032"></a> <span +class="ectt-1000">\glsgroupskip </span></div><hr> +</p><!--l. 5346--><p class="noindent" > +This macro determines what to do after one logical group but before the header for the +next logical group. The <span +class="ecss-1000">list</span><a + id="dx1-52033"></a> glossary style simply redefines <span +class="ectt-1000">\glsgroupskip </span>to be +<span +class="ectt-1000">\indexspace</span><a + id="dx1-52034"></a>, whereas the tabular-like styles redefine <span +class="ectt-1000">\glsgroupskip </span>to produce a +blank row. +</p><!--l. 5353--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\glossaryentryfield</span><span +class="ectt-0900"> </span></span><a + id="dx1-52035"></a> <span +class="ectt-1000">\glossaryentryfield{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">formatted name</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">description</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}</span> +<span +class="ectt-1000">{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">symbol</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">number list</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">} </span></div><hr> +</p><!--l. 5356--><p class="noindent" > +This macro indicates what to do for a given glossary entry. Note that <span +class="cmsy-10">⟨</span><span +class="ecti-1000">formatted name</span><span +class="cmsy-10">⟩</span> +will always be in the form <span +class="ectt-1000">\glsnamefont</span><a + id="dx1-52036"></a><span +class="ectt-1000">{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">name</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}</span>. This allows the user to set a given +font for the entry name, regardless of the glossary style used. Note that <span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩ </span>is the +label used when the glossary entry was defined via either <span +class="ectt-1000">\newglossaryentry</span><a + id="dx1-52037"></a> or +<span +class="ectt-1000">\newacronym</span><a + id="dx1-52038"></a>. +</p><!--l. 5364--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\glsentryitem</span><span +class="ectt-0900"> </span></span><a + id="dx1-52039"></a> <span +class="ectt-1000">\glsentryitem{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">} </span></div><hr> +</p><!--l. 5366--><p class="noindent" > +This macro will increment and display the associated counter for the main (level 0) +entries if the <span +class="ecss-1000">entrycounter</span><a + id="dx1-52040"></a> or <span +class="ecss-1000">counterwithin</span><a + id="dx1-52041"></a> package options have been used. This macro +is typically called by <span +class="ectt-1000">\glossaryentryfield </span>before <span +class="ectt-1000">\glstarget</span>. The format of the +counter is controlled by the macro +</p><!--l. 5372--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\glsentrycounterlabel</span><span +class="ectt-0900"> </span></span><a + id="dx1-52042"></a> <span +class="ectt-1000">\glsentrycounterlabel </span></div><hr> +</p><!--l. 5374--><p class="noindent" > +</p><!--l. 5376--><p class="indent" > Each time you use a glossary entry it creates a hyperlink (if hyperlinks are enabled) +to the relevant line in the glossary. Your new glossary style must therefore +redefine <span +class="ectt-1000">\glossaryentryfield </span>to set the appropriate target. This is done +using +</p><!--l. 5381--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\glstarget</span><span +class="ectt-0900"> </span></span><a + id="dx1-52043"></a> <span +class="ectt-1000">\glstarget{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">text</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">} </span></div><hr> +</p><!--l. 5383--><p class="noindent" > +where <span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩ </span>is the entry’s label. Note that you don’t need to worry about whether the +<span +class="ecss-1000">hyperref</span><a + id="dx1-52044"></a> package has been loaded, as <span +class="ectt-1000">\glstarget </span>won’t create a target if <span +class="ectt-1000">\hypertarget</span> +hasn’t been defined. +</p><!--l. 5389--><p class="indent" > For example, the <span +class="ecss-1000">list</span><a + id="dx1-52045"></a> style defines <span +class="ectt-1000">\glossaryentryfield </span>as follows: + + + +</p> + <div class="verbatim" id="verbatim-134"> +\renewcommand*{\glossaryentryfield}[5]{% + <br />\item[\glsentryitem{##1}\glstarget{##1}{##2}] + <br />  ##3\glspostdescription \space ##5} +</div> +<!--l. 5395--><p class="nopar" > +</p><!--l. 5397--><p class="indent" > Note also that <span +class="cmsy-10">⟨</span><span +class="ecti-1000">number list</span><span +class="cmsy-10">⟩ </span>will always be of the form<br +class="newline" /> +</p><!--l. 5399--><p class="indent" > <hr><div title="Definition"><span +class="ectt-1000">\glossaryentrynumbers</span><a + id="dx1-52046"></a><span +class="ectt-1000">{\relax</span><br +class="newline" /><span +class="ectt-1000">\setentrycounter</span><a + id="dx1-52047"></a><span +class="ectt-1000">[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">Hprefix</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">]{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">counter name</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">format cmd</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">number(s)</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}}</span> +</div><hr> +</p><!--l. 5401--><p class="noindent" > +where <span +class="cmsy-10">⟨</span><span +class="ecti-1000">number(s)</span><span +class="cmsy-10">⟩ </span>may contain <span +class="ectt-1000">\delimN</span><a + id="dx1-52048"></a> (to delimit individual numbers) and/or +<span +class="ectt-1000">\delimR</span><a + id="dx1-52049"></a> (to indicate a range of numbers). There may be multiple occurrences of +<span +class="ectt-1000">\setentrycounter</span><a + id="dx1-52050"></a><span +class="ectt-1000">[</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">Hprefix</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">]{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">counter name</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">format cmd</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">number(s)</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}</span>, +but note that the entire number list is enclosed within the argument of +<span +class="ectt-1000">\glossaryentrynumbers</span><a + id="dx1-52051"></a>. The user can redefine this to change the way the entire +number list is formatted, regardless of the glossary style. However the most common use +of <span +class="ectt-1000">\glossaryentrynumbers</span><a + id="dx1-52052"></a> is to provide a means of suppressing the number list +altogether. (In fact, the <span +class="ecss-1000">nonumberlist</span><a + id="dx1-52053"></a> option redefines <span +class="ectt-1000">\glossaryentrynumbers</span><a + id="dx1-52054"></a> to +ignore its argument.) Therefore, when you define a new glossary style, you don’t +need to worry about whether the user has specified the <span +class="ecss-1000">nonumberlist</span><a + id="dx1-52055"></a> package +option. +</p><!--l. 5418--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\glossarysubentryfield</span><span +class="ectt-0900"> </span></span><a + id="dx1-52056"></a> <span +class="ectt-1000">\glossarysubentryfield{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">level</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">formatted</span> +<span +class="ecti-1000">name</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">} {</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">description</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">symbol</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">}{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">number list</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">} </span></div><hr> +</p><!--l. 5421--><p class="noindent" > +This is new to version 1.17, and is used to display sub-entries. The first argument, +<span +class="cmsy-10">⟨</span><span +class="ecti-1000">level</span><span +class="cmsy-10">⟩</span>, indicates the sub-entry level. This must be an integer from 1 (first sub-level) +onwards. The remaining arguments are analogous to those for <span +class="ectt-1000">\glossaryentryfield</span><a + id="dx1-52057"></a> +described above. +</p><!--l. 5428--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\glssubentryitem</span><span +class="ectt-0900"> </span></span><a + id="dx1-52058"></a> <span +class="ectt-1000">\glssubentryitem{</span><span +class="cmsy-10">⟨</span><span +class="ecti-1000">label</span><span +class="cmsy-10">⟩</span><span +class="ectt-1000">} </span></div><hr> +</p><!--l. 5430--><p class="noindent" > +This macro will increment and display the associated counter for the level 1 entries if +the <span +class="ecss-1000">subentrycounter</span><a + id="dx1-52059"></a> package options have been used. This macro is typically called by +<span +class="ectt-1000">\glossarysubentryfield </span>before <span +class="ectt-1000">\glstarget</span><a + id="dx1-52060"></a>. The format of the counter is controlled +by the macro +</p><!--l. 5436--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\glssubentrycounterlabel</span><span +class="ectt-0900"> </span></span><a + id="dx1-52061"></a> <span +class="ectt-1000">\glssubentrycounterlabel </span></div><hr> +</p><!--l. 5438--><p class="noindent" > +</p><!--l. 5440--><p class="indent" > Note that <span +class="ectt-1000">\printglossary</span><a + id="dx1-52062"></a> (which <span +class="ectt-1000">\printglossaries</span><a + id="dx1-52063"></a> calls) sets +</p><!--l. 5442--><p class="indent" > <hr><div title="Definition"><span class="marginpar"><span +class="ectt-0900">\currentglossary</span><span +class="ectt-0900"> </span></span><a + id="dx1-52064"></a> <span +class="ectt-1000">\currentglossary </span></div><hr> +</p><!--l. 5444--><p class="noindent" > +to the current glossary label, so it’s possible to create a glossary style that varies + + + +according to the glossary type. +</p><!--l. 5448--><p class="indent" > For further details of these commands, see “Displaying the glossary” in the +documented code (<span +class="ectt-1000">glossaries.pdf</span>). +</p><!--l. 5452--><p class="noindent" > +</p> +<!--l. 5452--><p class="noindent" ><a +href="#top">Top</a></p><h4 class="subsectionHead"><span class="titlemark">16.1 </span> <a + id="x1-5300016.1"></a>Example: creating a completely new style</h4> +<!--l. 5454--><p class="noindent" >If you want a completely new style, you will need to redefine all of the commands and +the environment listed above. +</p><!--l. 5457--><p class="indent" > For example, suppose you want each entry to start with a bullet point. This means +that the glossary should be placed in the <span +class="ecss-1000">itemize</span><a + id="dx1-53001"></a><a + id="dx1-53002"></a> environment, so <span +class="ecss-1000">theglossary</span><a + id="dx1-53003"></a><a + id="dx1-53004"></a> should +start and end that environment. Let’s also suppose that you don’t want anything +between the glossary groups (so <span +class="ectt-1000">\glsgroupheading</span><a + id="dx1-53005"></a> and <span +class="ectt-1000">\glsgroupskip</span><a + id="dx1-53006"></a> should do +nothing) and suppose you don’t want anything to appear immediately after +<span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\begin{theglossary}</span></span></span> (so <span +class="ectt-1000">\glossaryheader</span><a + id="dx1-53007"></a> should do nothing). In addition, let’s +suppose the symbol should appear in brackets after the name, followed by the +description and last of all the <a + id="dx1-53008"></a><a +href="#glo:numberlist">number list<a + id="dx1-53009"></a></a> should appear within square brackets at +the end. Then you can create this new glossary style, called, say, <span +class="ectt-1000">mylist</span>, as +follows: + + + +</p> + <div class="verbatim" id="verbatim-135"> + \newglossarystyle{mylist}{% + <br /> % put the glossary in the itemize environment: + <br /> \renewenvironment{theglossary}{\begin{itemize}}{\end{itemize}}% + <br /> % have nothing after \begin{theglossary}: + <br /> \renewcommand*{\glossaryheader}{}% + <br /> % have nothing between glossary groups: + <br /> \renewcommand*{\glsgroupheading}[1]{}% + <br /> \renewcommand*{\glsgroupskip}{}% + <br /> % set how each entry should appear: + <br /> \renewcommand*{\glossaryentryfield}[5]{% + <br /> \item % bullet point + <br /> \glstarget{##1}{##2}% the entry name + <br /> \space (##4)% the symbol in brackets + <br /> \space ##3% the description + <br /> \space [##5]% the number list in square brackets + <br /> }% + <br /> % set how sub-entries appear: + <br /> \renewcommand*{\glossarysubentryfield}[6]{% + <br />   \glossaryentryfield{##2}{##3}{##4}{##5}{##6}}% + <br /> } +</div> +<!--l. 5490--><p class="nopar" > Note that this style creates a flat glossary, where sub-entries are displayed in exactly +the same way as the top level entries. It also hasn’t used <span +class="ectt-1000">\glsentryitem</span><a + id="dx1-53010"></a> or +<span +class="ectt-1000">\glssubentryitem</span><a + id="dx1-53011"></a> so it won’t be affected by the <span +class="ecss-1000">entrycounter</span><a + id="dx1-53012"></a>, <span +class="ecss-1000">counterwithin</span><a + id="dx1-53013"></a> or +<span +class="ecss-1000">subentrycounter</span><a + id="dx1-53014"></a> package options. +</p><!--l. 5498--><p class="noindent" > +</p> +<!--l. 5498--><p class="noindent" ><a +href="#top">Top</a></p><h4 class="subsectionHead"><span class="titlemark">16.2 </span> <a + id="x1-5400016.2"></a>Example: creating a new glossary style based on an existing style</h4> +<!--l. 5500--><p class="noindent" >If you want to define a new style that is a slightly modified version of an existing style, +you can use <span +class="ectt-1000">\glossarystyle</span><a + id="dx1-54001"></a> within the second argument of <span +class="ectt-1000">\newglossarystyle</span><a + id="dx1-54002"></a> +followed by whatever alterations you require. For example, suppose you want a style like +the <span +class="ecss-1000">list</span><a + id="dx1-54003"></a> style but you don’t want the extra vertical space created by <span +class="ectt-1000">\indexspace</span><a + id="dx1-54004"></a> +between groups, then you can create a new glossary style called, say, <span +class="ectt-1000">mylist </span>as +follows: + + + +</p> + <div class="verbatim" id="verbatim-136"> +\newglossarystyle{mylist}{% + <br />\glossarystyle{list}% base this style on the list style + <br />\renewcommand{\glsgroupskip}{}% make nothing happen between groups + <br />} +</div> +<!--l. 5513--><p class="nopar" > +</p><!--l. 5517--><p class="noindent" > +</p> +<!--l. 5517--><p class="noindent" ><a +href="#top">Top</a></p><h4 class="subsectionHead"><span class="titlemark">16.3 </span> <a + id="x1-5500016.3"></a>Example: creating a glossary style that uses the <span +class="ecss-1000">user1</span>, …, <span +class="ecss-1000">user6</span> +keys</h4> +<!--l. 5519--><p class="noindent" >Since <span +class="ectt-1000">\glossaryentryfield</span><a + id="dx1-55001"></a> and <span +class="ectt-1000">\glossarysubentryfield</span><a + id="dx1-55002"></a> provide the label for the +entry, it’s also possible to access the values of the generic user keys, such as <span +class="ecss-1000">user1</span><a + id="dx1-55003"></a>. For +example, suppose each entry not only has an associated symbol, but also units (stored +in <span +class="ecss-1000">user1</span><a + id="dx1-55004"></a>) and dimension (stored in <span +class="ecss-1000">user2</span><a + id="dx1-55005"></a>). Then you can define a glossary style that +displays each entry in a <span +class="ecss-1000">longtable</span><a + id="dx1-55006"></a><a + id="dx1-55007"></a> as follows: + + + +</p> + <div class="verbatim" id="verbatim-137"> +\newglossarystyle{long6col}{% + <br /> % put the glossary in a longtable environment: + <br /> \renewenvironment{theglossary}% + <br />  {\begin{longtable}{lp{\glsdescwidth}cccp{\glspagelistwidth}}}% + <br />  {\end{longtable}}% + <br /> % Set the table’s header: + <br /> \renewcommand*{\glossaryheader}{% + <br />  \bfseries Term & \bfseries Description & \bfseries Symbol & + <br />  \bfseries Units & \bfseries Dimensions & \bfseries Page List + <br />  \\\endhead}% + <br /> % No heading between groups: + <br />  \renewcommand*{\glsgroupheading}[1]{}% + <br /> % Main (level 0) entries displayed in a row optionally numbered: + <br />  \renewcommand*{\glossaryentryfield}[5]{% + <br />    \glsentryitem{##1}% Entry number if required + <br />    \glstarget{##1}{##2}% Name + <br />    & ##3% Description + <br />    & ##4% Symbol + <br />    & \glsentryuseri{##1}% Units + <br />    & \glsentryuserii{##1}% Dimensions + <br />    & ##5% Page list + <br />    \\% end of row + <br />  }% + <br /> % Similarly for sub-entries (no sub-entry numbers): + <br /> \renewcommand*{\glossarysubentryfield}[6]{% + <br />    % ignoring first argument (sub-level) + <br />    \glstarget{##2}{##3}% Name + <br />    & ##4% Description + <br />    & ##5% Symbol + <br />    & \glsentryuseri{##2}% Units + <br />    & \glsentryuserii{##2}% Dimensions + <br />    & ##6% Page list + <br />    \\% end of row + <br />  }% + <br /> % Nothing between groups: + <br /> \renewcommand*{\glsgroupskip}{}% + <br />} +</div> +<!--l. 5564--><p class="nopar" > +</p><!--l. 5567--><p class="noindent" > +</p> +<!--l. 5567--><p class="noindent" ><a +href="#top">Top</a></p><h3 class="sectionHead"><span class="titlemark">17 </span> <a + id="x1-5600017"></a>Accessibility Support</h3> + + + +<!--l. 5568--><p class="noindent" >Limited accessibility support is provided by the accompanying <span +class="ecss-1000">glossaries-accsupp</span><a + id="dx1-56001"></a> +package, but note that this package is experimental and it requires the <span +class="ecss-1000">accsupp</span><a + id="dx1-56002"></a> package +which is also listed as experimental. This package defines additional keys that may be +used when defining glossary entries. The keys are as follows: + </p><dl class="description"><dt class="description"> +<span +class="ecsx-1000">access</span><a + id="dx1-56003"></a> </dt><dd +class="description">The replacement text corresponding to the <span +class="ecss-1000">name</span><a + id="dx1-56004"></a> key. + </dd><dt class="description"> +<span +class="ecsx-1000">textaccess</span><a + id="dx1-56005"></a> </dt><dd +class="description">The replacement text corresponding to the <span +class="ecss-1000">text</span><a + id="dx1-56006"></a> key. + </dd><dt class="description"> +<span +class="ecsx-1000">firstaccess</span><a + id="dx1-56007"></a> </dt><dd +class="description">The replacement text corresponding to the <span +class="ecss-1000">first</span><a + id="dx1-56008"></a> key. + </dd><dt class="description"> +<span +class="ecsx-1000">pluralaccess</span><a + id="dx1-56009"></a> </dt><dd +class="description">The replacement text corresponding to the <span +class="ecss-1000">plural</span><a + id="dx1-56010"></a> key. + </dd><dt class="description"> +<span +class="ecsx-1000">firstpluralaccess</span><a + id="dx1-56011"></a> </dt><dd +class="description">The replacement text corresponding to the <span +class="ecss-1000">firstplural</span><a + id="dx1-56012"></a> key. + </dd><dt class="description"> +<span +class="ecsx-1000">symbolaccess</span><a + id="dx1-56013"></a> </dt><dd +class="description">The replacement text corresponding to the <span +class="ecss-1000">symbol</span><a + id="dx1-56014"></a> key. + </dd><dt class="description"> +<span +class="ecsx-1000">symbolpluralaccess</span><a + id="dx1-56015"></a> </dt><dd +class="description">The replacement text corresponding to the <span +class="ecss-1000">symbolplural</span><a + id="dx1-56016"></a> key. + </dd><dt class="description"> +<span +class="ecsx-1000">descriptionaccess</span><a + id="dx1-56017"></a> </dt><dd +class="description">The replacement text corresponding to the <span +class="ecss-1000">description</span><a + id="dx1-56018"></a> key. + </dd><dt class="description"> +<span +class="ecsx-1000">descriptionpluralaccess</span><a + id="dx1-56019"></a> </dt><dd +class="description">The replacement text corresponding to the + <span +class="ecss-1000">descriptionplural</span><a + id="dx1-56020"></a> key. + </dd><dt class="description"> +<span +class="ecsx-1000">longaccess</span><a + id="dx1-56021"></a> </dt><dd +class="description">The replacement text corresponding to the <span +class="ecss-1000">long</span><a + id="dx1-56022"></a> key (used by + <span +class="ectt-1000">\newacronym</span><a + id="dx1-56023"></a>). + </dd><dt class="description"> +<span +class="ecsx-1000">shortaccess</span><a + id="dx1-56024"></a> </dt><dd +class="description">The replacement text corresponding to the <span +class="ecss-1000">short</span><a + id="dx1-56025"></a> key (used by + <span +class="ectt-1000">\newacronym</span><a + id="dx1-56026"></a>). + </dd><dt class="description"> +<span +class="ecsx-1000">longpluralaccess</span><a + id="dx1-56027"></a> </dt><dd +class="description">The replacement text corresponding to the <span +class="ecss-1000">longplural</span><a + id="dx1-56028"></a> key (used + by <span +class="ectt-1000">\newacronym</span><a + id="dx1-56029"></a>). + </dd><dt class="description"> +<span +class="ecsx-1000">shortpluralaccess</span><a + id="dx1-56030"></a> </dt><dd +class="description">The replacement text corresponding to the <span +class="ecss-1000">shortplural</span><a + id="dx1-56031"></a> key (used + by <span +class="ectt-1000">\newacronym</span><a + id="dx1-56032"></a>). + </dd></dl> +<!--l. 5615--><p class="noindent" >For example: + + + +</p> + <div class="verbatim" id="verbatim-138"> +\newglossaryentry{tex}{name={\TeX},description={Document preparation + <br />language},access={TeX}} +</div> +<!--l. 5619--><p class="nopar" > Now <span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\gls{tex}</span></span></span> will be equivalent to + + + +</p> + <div class="verbatim" id="verbatim-139"> +\BeginAccSupp{ActualText=TeX}\TeX\EndAccSupp{} +</div> +<!--l. 5623--><p class="nopar" > The sample file <a +href="#x1-40001.1"><span +class="ectt-1000">sampleaccsupp.tex</span></a> illustrates the <span +class="ecss-1000">glossaries-accsupp</span><a + id="dx1-56033"></a> package. +</p><!--l. 5627--><p class="indent" > See the documented code (<span +class="ectt-1000">glossaries.pdf</span>) for further details. It is recommended +that you also read the <span +class="ecss-1000">accsupp</span><a + id="dx1-56034"></a> documentation. +</p><!--l. 5631--><p class="noindent" > +</p> +<!--l. 5631--><p class="noindent" ><a +href="#top">Top</a></p><h3 class="sectionHead"><span class="titlemark">18 </span> <a + id="x1-5700018"></a>Troubleshooting</h3> +<!--l. 5634--><p class="noindent" >The <span +class="ecss-1000">glossaries </span>package comes with a minimal file called <span +class="ectt-1000">minimalgls.tex </span>which can be +used for testing. This should be located in the <span +class="ectt-1000">samples </span>subdirectory (folder) of the +<span +class="ecss-1000">glossaries </span>documentation directory. The location varies according to your operating +system and <span class="TEX">T<span +class="E">E</span>X</span> installation. For example, on my Linux partition it can be +found in <span +class="ectt-1000">/usr/local/texlive/2008/texmf-dist/doc/latex/glossaries/</span>. +Further information on debugging <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span +class="E">E</span>X</span></span> code is available at +<a +href="http://theoval.cmp.uea.ac.uk/~nlct/latex/minexample/" class="url" ><span +class="ectt-1000">http://theoval.cmp.uea.ac.uk/~nlct/latex/minexample/</span></a>. +</p><!--l. 5644--><p class="indent" > Below is a list of the most frequently asked questions. For other queries, consult the <span +class="ecss-1000">glossaries</span> +FAQ at <a +href="http://theoval.cmp.uea.ac.uk/~nlct/latex/packages/faq/glossariesfaq.html" class="url" ><span +class="ectt-1000">http://theoval.cmp.uea.ac.uk/~nlct/latex/packages/faq/glossariesfaq.html</span></a>. +</p><!--l. 5648--><p class="indent" > + </p><ol class="enumerate1" > + <li + class="enumerate" id="x1-57002x1"><span +class="ecbx-1000">Q. </span>I get the error message: + + + + <div class="verbatim" id="verbatim-140"> + Missing \begin{document} +</div> + <!--l. 5652--><p class="nopar" > + </p><!--l. 5654--><p class="noindent" ><span +class="ecbx-1000">A. </span>Check you are using an up to date version of the <span +class="ecss-1000">xkeyval</span><a + id="dx1-57003"></a> package. + </p></li> + <li + class="enumerate" id="x1-57005x2"><span +class="ecbx-1000">Q. </span>When I use <a + id="dx1-57006"></a><a +href="#glo:xindy"><span +class="ectt-1000">xindy</span><a + id="dx1-57007"></a></a>, I get the following error message: + + + + <div class="verbatim" id="verbatim-141"> + ERROR: CHAR: index 0 should be less than the length of the string +</div> + <!--l. 5661--><p class="nopar" > + </p><!--l. 5663--><p class="noindent" ><span +class="ecbx-1000">A.</span> <a + id="dx1-57008"></a><a +href="#glo:xindy"><span +class="ectt-1000">xindy</span><a + id="dx1-57009"></a></a> discards all commands and braces from the sort string. If your sort + string (either specified by the <span +class="ecss-1000">sort</span><a + id="dx1-57010"></a> key or the <span +class="ecss-1000">name</span><a + id="dx1-57011"></a> key) only consists of + commands, this will be treated by <a + id="dx1-57012"></a><span +class="ectt-1000">xindy</span><a + id="dx1-57013"></a> as an empty sort string, which produces + an error message in newer versions of <a + id="dx1-57014"></a><span +class="ectt-1000">xindy</span><a + id="dx1-57015"></a>. For example, the following will cause + a problem: + + + +</p> + <div class="verbatim" id="verbatim-142"> + \newglossaryentry{alpha}{name={\ensuremath{\alpha}}, +  <br />  description=alpha} +</div> + <!--l. 5672--><p class="nopar" > Either use a different sort key for the entry, for example: + + + +</p> + <div class="verbatim" id="verbatim-143"> + \newglossaryentry{alpha}{sort=alpha, +  <br />  name={\ensuremath{\alpha}}, +  <br />  description=alpha} +</div> + <!--l. 5678--><p class="nopar" > or, if all entries are like this, you may prefer to use the <span +class="ecss-1000">sort=use</span><a + id="dx1-57016"></a> or <span +class="ecss-1000">sort=def</span><a + id="dx1-57017"></a> + package options. See <a +href="#x1-160002.4">§2.4 </a><a +href="#x1-160002.4">Sorting Options<!--tex4ht:ref: sec:pkgopts-sort --></a> for further details of the <span +class="ecss-1000">sort</span><a + id="dx1-57018"></a> + option. + </p></li> + <li + class="enumerate" id="x1-57020x3"><span +class="ecbx-1000">Q. </span>I’ve used the <span +class="ecss-1000">smallcaps</span><a + id="dx1-57021"></a> option, but the acronyms are displayed in normal sized + upper case letters. + <!--l. 5687--><p class="noindent" ><span +class="ecbx-1000">A. </span>The <span +class="ecss-1000">smallcaps</span><a + id="dx1-57022"></a> package option uses <span +class="ectt-1000">\textsc</span><a + id="dx1-57023"></a> to typeset the acronyms. This + command converts lower case letters to small capitals, while upper case letters + remain their usual size. Therefore you need to specify the acronym in lower case + letters. + </p></li> + <li + class="enumerate" id="x1-57025x4"><span +class="ecbx-1000">Q. </span>My acronyms won’t break across a line when they’re expanded. + <!--l. 5695--><p class="noindent" ><span +class="ecbx-1000">A. </span>PDF<span class="LATEX">L<span class="A">A</span><span class="TEX">T<span +class="E">E</span>X</span></span> can break hyperlinks across a line, but <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span +class="E">E</span>X</span></span> can’t. If you + can’t use PDF<span class="LATEX">L<span class="A">A</span><span class="TEX">T<span +class="E">E</span>X</span></span> then disable the <a + id="dx1-57026"></a><a +href="#glo:firstuse">first use</a> links using the package option + <span +class="ecss-1000">hyperfirst=false</span><a + id="dx1-57027"></a>. + </p></li> + <li + class="enumerate" id="x1-57029x5"><span +class="ecbx-1000">Q. </span>How do I change the font that the acronyms are displayed in? + <!--l. 5701--><p class="noindent" ><span +class="ecbx-1000">A. </span>The easiest way to do this is to specify the <span +class="ecss-1000">smaller</span><a + id="dx1-57030"></a> package option and redefine + <span +class="ectt-1000">\acronymfont</span><a + id="dx1-57031"></a> to use the required typesetting command. For example, suppose + you would like the acronyms displayed in a sans-serif font, then you can + do: + + + +</p> + <div class="verbatim" id="verbatim-144"> + \usepackage[smaller]{glossaries} +  <br />\renewcommand*{\acronymfont}[1]{\textsf{#1}} +</div> + <!--l. 5708--><p class="nopar" > + </p></li> + <li + class="enumerate" id="x1-57033x6"><span +class="ecbx-1000">Q. </span>How do I change the font that the acronyms are displayed in on <a + id="dx1-57034"></a><a +href="#glo:firstuse">first + use</a>? + <!--l. 5713--><p class="noindent" ><span +class="ecbx-1000">A. </span>The easiest way to do this is to specify the <span +class="ecss-1000">smaller</span><a + id="dx1-57035"></a> package option and redefine + <span +class="ectt-1000">\firstacronymfont</span><a + id="dx1-57036"></a> to use the required command. Note that if you don’t want + the acronym on subsequent use to use <span +class="ectt-1000">\textsmaller</span><a + id="dx1-57037"></a>, you will also need to + redefine <span +class="ectt-1000">\acronymfont</span><a + id="dx1-57038"></a>, as above. For example to make the acronym emphasized + on <a + id="dx1-57039"></a><a +href="#glo:firstuse">first use</a>, but use the surrounding font for subsequent use, you can + do: + + + +</p> + <div class="verbatim" id="verbatim-145"> + \usepackage[smaller]{glossaries} +  <br />\renewcommand*{\firstacronymfont}[1]{\emph{#1}} +  <br />\renewcommand*{\acronymfont}[1]{#1} +</div> + <!--l. 5723--><p class="nopar" > + </p></li> + <li + class="enumerate" id="x1-57041x7"><span +class="ecbx-1000">Q. </span>I don’t have Perl installed, do I have to use <a + id="dx1-57042"></a><a +href="#glo:makeglossaries"><span +class="ectt-1000">makeglossaries</span><a + id="dx1-57043"></a></a>? + <!--l. 5728--><p class="noindent" ><span +class="ecbx-1000">A. </span>Although it is strongly recommended that you use <a + id="dx1-57044"></a><a +href="#glo:makeglossaries"><span +class="ectt-1000">makeglossaries</span><a + id="dx1-57045"></a></a>, you don’t + have to use it. For further details, read <a +href="#x1-90001.3.2">§1.3.2 </a><a +href="#x1-90001.3.2">Using xindy explicitly<!--tex4ht:ref: sec:xindyapp --></a> or <a +href="#x1-100001.3.3">§1.3.3 + </a><a +href="#x1-100001.3.3">Using makeindex explicitly<!--tex4ht:ref: sec:makeindexapp --></a>, depending on whether you want to use <a + id="dx1-57046"></a><a +href="#glo:xindy"><span +class="ectt-1000">xindy</span><a + id="dx1-57047"></a></a> or + <a + id="dx1-57048"></a><a +href="#glo:makeindex"><span +class="ectt-1000">makeindex</span><a + id="dx1-57049"></a></a>. + </p></li> + <li + class="enumerate" id="x1-57051x8"><span +class="ecbx-1000">Q. </span>I’m used to using the <span +class="ecss-1000">glossary </span>package: are there any instructions on migrating + from the <span +class="ecss-1000">glossary</span><a + id="dx1-57052"></a> package to the <span +class="ecss-1000">glossaries </span>package? + <!--l. 5737--><p class="noindent" ><span +class="ecbx-1000">A. </span>Read <a +href="glossary2glossaries.html" >“Upgrading from the glossary package to the glossaries package”</a> which + should be available from the same location as this document. + </p></li> + <li + class="enumerate" id="x1-57054x9"><span +class="ecbx-1000">Q. </span>I’m using <span +class="ecss-1000">babel</span><a + id="dx1-57055"></a> but the fixed names haven’t been translated. + <!--l. 5744--><p class="noindent" ><span +class="ecbx-1000">A. </span>The <span +class="ecss-1000">glossaries </span>package currently only supports the following languages: + Brazilian Portuguese, Danish, Dutch, English, French, German, Irish, Italian, + Hungarian, Polish, Serbian and Spanish. If you want to add another language, + send me the translations, and I’ll add them to the next version. + </p><!--l. 5750--><p class="noindent" >If you are using one of the above languages, but the text hasn’t been translated, + try adding the <span +class="ecss-1000">translator</span><a + id="dx1-57056"></a> package with the required languages explicitly (before + you load the <span +class="ecss-1000">glossaries </span>package). For example: + + + +</p> + <div class="verbatim" id="verbatim-146"> + \usepackage[ngerman]{babel} +  <br />\usepackage[ngerman]{translator} +  <br />\usepackage{glossaries} +</div> + <!--l. 5758--><p class="nopar" > Alternatively, you can add the language as a global option to the class file. Check + the <span +class="ecss-1000">translator </span>package documentation for further details. + </p></li> + <li + class="enumerate" id="x1-57058x10"><span +class="ecbx-1000">Q. </span>My acronyms contain strange characters when I use commands like + <span +class="ectt-1000">\acrlong</span><a + id="dx1-57059"></a>. + <!--l. 5766--><p class="noindent" ><span +class="ecbx-1000">A. </span>Switch off the sanitization: + + + +</p> + <div class="verbatim" id="verbatim-147"> + \usepackage[sanitize=none]{glossaries} +</div> + <!--l. 5769--><p class="nopar" > and protect fragile commands. + </p></li> + <li + class="enumerate" id="x1-57061x11"><span +class="ecbx-1000">Q. </span>Weird characters appear when I use <span +class="ectt-1000">\glsentryname</span><a + id="dx1-57062"></a> or <span +class="ectt-1000">\glsname</span><a + id="dx1-57063"></a>. + <!--l. 5775--><p class="noindent" ><span +class="ecbx-1000">A. </span>Either use <span +class="ectt-1000">\glsentrytext</span><a + id="dx1-57064"></a> or <span +class="ectt-1000">\glstext</span><a + id="dx1-57065"></a>, respectively, or switch off the + sanitization for the <span +class="ecss-1000">name</span><a + id="dx1-57066"></a> key: + + + +</p> + <div class="verbatim" id="verbatim-148"> + \usepackage[sanitize={name=false}]{glossaries} +</div> + <!--l. 5780--><p class="nopar" > and protect fragile commands. + </p></li> + <li + class="enumerate" id="x1-57068x12"><span +class="ecbx-1000">Q. </span>Weird characters appear when I try to display an entry’s description. + <!--l. 5786--><p class="noindent" ><span +class="ecbx-1000">A. </span>Switch off the sanitization for the <span +class="ecss-1000">description</span><a + id="dx1-57069"></a> key: + + + +</p> + <div class="verbatim" id="verbatim-149"> + \usepackage[sanitize={description=false}]{glossaries} +</div> + <!--l. 5790--><p class="nopar" > and protect fragile commands. + </p></li> + <li + class="enumerate" id="x1-57071x13"><span +class="ecbx-1000">Q. </span>My glossaries haven’t appeared. + <!--l. 5795--><p class="noindent" ><span +class="ecbx-1000">A. </span>Remember to do the following: </p> + <ul class="itemize1"> + <li class="itemize">Add <span +class="ectt-1000">\makeglossaries</span><a + id="dx1-57072"></a> to the document preamble. + </li> + <li class="itemize">Use either <span +class="ectt-1000">\printglossary</span><a + id="dx1-57073"></a> for each glossary that has been defined or + <span +class="ectt-1000">\printglossaries</span><a + id="dx1-57074"></a>. + </li> + <li class="itemize">Use the commands listed in <a +href="#x1-260006">§6 </a><a +href="#x1-260006">Links to Glossary Entries<!--tex4ht:ref: sec:glslink --></a>, <a +href="#x1-290007">§7 </a><a +href="#x1-290007">Adding an + Entry to the Glossary Without Generating Text<!--tex4ht:ref: sec:glsadd --></a> or <a +href="#x1-300008">§8 </a><a +href="#x1-300008">Cross-Referencing + Entries<!--tex4ht:ref: sec:crossref --></a> for each entry that you want to appear in the glossary. + </li> + <li class="itemize">Run <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span +class="E">E</span>X</span></span> on your document, then run <a + id="dx1-57075"></a><a +href="#glo:makeglossaries"><span +class="ectt-1000">makeglossaries</span><a + id="dx1-57076"></a></a>, then run + <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span +class="E">E</span>X</span></span> on your document again. If you want the glossaries to appear + in the table of contents, you will need an extra <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span +class="E">E</span>X</span></span> run. If any + of your entries cross-reference an entry that’s not referenced in the + main body of the document, you will need to run <a + id="dx1-57077"></a><span +class="ectt-1000">makeglossaries</span><a + id="dx1-57078"></a> + (see <a +href="#x1-70001.3">§1.3 </a><a +href="#x1-70001.3">Generating the Associated Glossary Files<!--tex4ht:ref: sec:makeglossaries --></a>) after the second + <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span +class="E">E</span>X</span></span> run, followed by another <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span +class="E">E</span>X</span></span> run.</li></ul> + <!--l. 5815--><p class="noindent" >Check the log files (<span +class="ectt-1000">.log</span><a + id="dx1-57079"></a>, <span +class="ectt-1000">.glg</span><a + id="dx1-57080"></a> etc) for any warnings. + </p></li> + <li + class="enumerate" id="x1-57082x14"><span +class="ecbx-1000">Q. </span>It is possible to change the rules used to sort the glossary entries? + <!--l. 5821--><p class="noindent" ><span +class="ecbx-1000">A. </span>If it’s for an individual entry, then you can use the entry’s <span +class="ecss-1000">sort</span><a + id="dx1-57083"></a> key to sort it + according to a different term. If it’s for the entire alphabet, then you will + need to use <a + id="dx1-57084"></a><a +href="#glo:xindy"><span +class="ectt-1000">xindy</span><a + id="dx1-57085"></a></a> (instead of <a + id="dx1-57086"></a><a +href="#glo:makeindex"><span +class="ectt-1000">makeindex</span><a + id="dx1-57087"></a></a>) and use an appropriate <a + id="dx1-57088"></a><span +class="ectt-1000">xindy</span><a + id="dx1-57089"></a> + language module. Writing <a + id="dx1-57090"></a><span +class="ectt-1000">xindy</span><a + id="dx1-57091"></a> modules or styles is beyond the scope + of this manual. Further information about <a + id="dx1-57092"></a><span +class="ectt-1000">xindy</span><a + id="dx1-57093"></a> can be found at the + <a +href="http://xindy.sourceforge.net/" >Xindy Web Site</a>. There is also a link to the <a + id="dx1-57094"></a><span +class="ectt-1000">xindy</span><a + id="dx1-57095"></a> mailing list from that + site. + </p><!--l. 5831--><p class="noindent" >If you want to sort according to order of definition or order of use, use the <span +class="ecss-1000">sort</span><a + id="dx1-57096"></a> + package option described in <a +href="#x1-160002.4">§2.4 </a><a +href="#x1-160002.4">Sorting Options<!--tex4ht:ref: sec:pkgopts-sort --></a>. +</p> + </li></ol> + + + + + + +<!--l. 5838--><p class="indent" > <a + id="likesection.2"></a><a + id="Q1-1-67"></a> +</p> +<!--l. 2--><p class="noindent" ><a +href="#top">Top</a></p><h3 class="likesectionHead"><a + id="x1-5800018"></a>Index</h3> +<!--l. 4--><p class="noindent" > <span +class="ecbx-1000">Symbols</span> +</p> + <div class="theindex"><span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\@gls@codepage</span></span></span>  <a +href="glossaries-user.html#dx1-11017" ><span +class="ecti-1000">1</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\@glsorder</span></span></span>  <a +href="glossaries-user.html#dx1-11013" ><span +class="ecti-1000">2</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\@istfilename</span></span></span>  <a +href="glossaries-user.html#dx1-11006" ><span +class="ecti-1000">3</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\@newglossary</span></span></span>  <a +href="glossaries-user.html#dx1-11005" ><span +class="ecti-1000">4</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\@xdylanguage</span></span></span>  <a +href="glossaries-user.html#dx1-11016" ><span +class="ecti-1000">5</span></a> <br /></span> +<p class="theindex"> <span +class="ecbx-1000">A</span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\Ac</span></span></span>  <a +href="glossaries-user.html#dx1-39108" >6</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\ac</span></span></span>  <a +href="glossaries-user.html#dx1-39106" >7</a> <br /></span> +<span class="index-item"><span +class="ecss-1000">accsupp </span>package  <a +href="glossaries-user.html#dx1-56002" >8</a>, <a +href="glossaries-user.html#dx1-56034" >9</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\Acf</span></span></span>  <a +href="glossaries-user.html#dx1-39100" >10</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\acf</span></span></span>  <a +href="glossaries-user.html#dx1-39098" >11</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\Acfp</span></span></span>  <a +href="glossaries-user.html#dx1-39104" >12</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\acfp</span></span></span>  <a +href="glossaries-user.html#dx1-39102" >13</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\Acl</span></span></span>  <a +href="glossaries-user.html#dx1-39092" >14</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\acl</span></span></span>  <a +href="glossaries-user.html#dx1-39090" >15</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\Aclp</span></span></span>  <a +href="glossaries-user.html#dx1-39096" >16</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\aclp</span></span></span>  <a +href="glossaries-user.html#dx1-39094" >17</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\Acp</span></span></span>  <a +href="glossaries-user.html#dx1-39112" >18</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\acp</span></span></span>  <a +href="glossaries-user.html#dx1-39110" >19</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\ACRfull</span></span></span>  <a +href="glossaries-user.html#dx1-39078" ><span +class="ecti-1000">20</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\Acrfull</span></span></span>  <a +href="glossaries-user.html#dx1-39077" ><span +class="ecti-1000">21</span></a>, <a +href="glossaries-user.html#dx1-39101" >22</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\acrfull</span></span></span>  <a +href="glossaries-user.html#dx1-39072" ><span +class="ecti-1000">23</span></a>, <a +href="glossaries-user.html#dx1-39099" >24</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\acrfullformat</span></span></span>  <a +href="glossaries-user.html#dx1-39073" ><span +class="ecti-1000">25</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\Acrfullpl</span></span></span>  <a +href="glossaries-user.html#dx1-39105" >26</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\acrfullpl</span></span></span>  <a +href="glossaries-user.html#dx1-39103" >27</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\Acrlong</span></span></span>  <a +href="glossaries-user.html#dx1-39070" ><span +class="ecti-1000">28</span></a>, <a +href="glossaries-user.html#dx1-39093" >29</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\acrlong</span></span></span>  <a +href="glossaries-user.html#dx1-39069" ><span +class="ecti-1000">30</span></a>, <a +href="glossaries-user.html#dx1-39074" >31</a>, <a +href="glossaries-user.html#dx1-39091" >32</a>, <a +href="glossaries-user.html#dx1-57059" >33</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\Acrlongpl</span></span></span>  <a +href="glossaries-user.html#dx1-39097" >34</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\acrlongpl</span></span></span>  <a +href="glossaries-user.html#dx1-39095" >35</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\acrnameformat</span></span></span>  <a +href="glossaries-user.html#dx1-41008" ><span +class="ecti-1000">36</span></a>, <a +href="glossaries-user.html#dx1-41023" >37</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\acronymfont</span></span></span>  <a +href="glossaries-user.html#dx1-17024" >38</a>, <a +href="glossaries-user.html#dx1-39051" ><span +class="ecti-1000">39</span></a>, <a +href="glossaries-user.html#dx1-39076" >40</a>, <a +href="glossaries-user.html#dx1-40027" >41</a>, <a +href="glossaries-user.html#dx1-40034" >42</a>, <a +href="glossaries-user.html#dx1-40035" >43</a>, <a +href="glossaries-user.html#dx1-40042" >44</a>, <a +href="glossaries-user.html#dx1-41012" >45</a>, <a +href="glossaries-user.html#dx1-41019" >46</a>, <a +href="glossaries-user.html#dx1-41025" >47</a>, <a +href="glossaries-user.html#dx1-41027" >48</a>, <a +href="glossaries-user.html#dx1-41029" >49</a>, <a +href="glossaries-user.html#dx1-57031" >50</a>, <a +href="glossaries-user.html#dx1-57038" >51</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\acronymname</span></span></span>  <a +href="glossaries-user.html#dx1-6015" >52</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\acronymtype</span></span></span>  <a +href="glossaries-user.html#dx1-14024" >53</a>, <a +href="glossaries-user.html#dx1-17003" >54</a>, <a +href="glossaries-user.html#dx1-17010" >55</a>, <a +href="glossaries-user.html#dx1-29007" >56</a>, <a +href="glossaries-user.html#dx1-38013" ><span +class="ecti-1000">57</span></a>, <a +href="glossaries-user.html#dx1-39004" >58</a>, <a +href="glossaries-user.html#dx1-39033" >59</a>, <a +href="glossaries-user.html#dx1-17005" >60</a>, <a +href="glossaries-user.html#dx1-24010" >61</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\ACRshort</span></span></span>  <a +href="glossaries-user.html#dx1-39068" ><span +class="ecti-1000">62</span></a>, <a +href="glossaries-user.html#dx1-39071" ><span +class="ecti-1000">63</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\Acrshort</span></span></span>  <a +href="glossaries-user.html#dx1-39067" ><span +class="ecti-1000">64</span></a>, <a +href="glossaries-user.html#dx1-39085" >65</a> <br /></span> + + + +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\acrshort</span></span></span>  <a +href="glossaries-user.html#dx1-39065" ><span +class="ecti-1000">66</span></a>, <a +href="glossaries-user.html#dx1-39075" >67</a>, <a +href="glossaries-user.html#dx1-39083" >68</a>, <a +href="glossaries-user.html#dx1-40013" >69</a>, <a +href="glossaries-user.html#dx1-3004" >70</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\Acrshortpl</span></span></span>  <a +href="glossaries-user.html#dx1-39089" >71</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\acrshortpl</span></span></span>  <a +href="glossaries-user.html#dx1-39087" >72</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\Acs</span></span></span>  <a +href="glossaries-user.html#dx1-39084" >73</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\acs</span></span></span>  <a +href="glossaries-user.html#dx1-39082" >74</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\Acsp</span></span></span>  <a +href="glossaries-user.html#dx1-39088" >75</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\acsp</span></span></span>  <a +href="glossaries-user.html#dx1-39086" >76</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\addcontentsline</span></span></span>  <a +href="glossaries-user.html#dx1-14007" >77</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\andname</span></span></span>  <a +href="glossaries-user.html#dx1-31011" >78</a> <br /></span> +<span class="index-item"><span +class="ecss-1000">array </span>package  <a +href="glossaries-user.html#dx1-48006" >79</a>, <a +href="glossaries-user.html#dx1-50006" >80</a> <br /></span> +</p><p class="theindex"> <span +class="ecbx-1000">B</span> +<span class="index-item"><span +class="ecss-1000">babel </span>package  <a +href="glossaries-user.html#dx1-6001" >81</a>, <a +href="glossaries-user.html#dx1-6003" >82</a>, <a +href="glossaries-user.html#dx1-6009" >83</a>, <a +href="glossaries-user.html#dx1-6023" >84</a>, <a +href="glossaries-user.html#dx1-6028" >85</a>, <a +href="glossaries-user.html#dx1-6033" >86</a>, <a +href="glossaries-user.html#dx1-13043" >87</a>, <a +href="glossaries-user.html#dx1-13048" >88</a>, <a +href="glossaries-user.html#dx1-13053" >89</a>, <a +href="glossaries-user.html#dx1-13058" >90</a>, <a +href="glossaries-user.html#dx1-57055" >91</a> <br /></span> +<span class="index-item"><span +class="ecss-1000">beamer </span>package  <a +href="glossaries-user.html#dx1-6027" >92</a> <br /></span> +</p><p class="theindex"> <span +class="ecbx-1000">C</span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\chapter</span></span></span>  <a +href="glossaries-user.html#dx1-33028" >93</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\chapter*</span></span></span>  <a +href="glossaries-user.html#dx1-33026" >94</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\currentglossary</span></span></span>  <a +href="glossaries-user.html#dx1-52064" ><span +class="ecti-1000">95</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\CustomAcronymFields</span></span></span>  <a +href="glossaries-user.html#dx1-42001" ><span +class="ecti-1000">96</span></a>, <a +href="glossaries-user.html#dx1-42026" >97</a>, <a +href="glossaries-user.html#dx1-42056" >98</a> <br /></span> +</p><p class="theindex"> <span +class="ecbx-1000">D</span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\defdisplay</span></span></span>  <a +href="glossaries-user.html#dx1-39008" >99</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\defdisplayfirst</span></span></span>  <a +href="glossaries-user.html#dx1-39007" >100</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\defglsdisplay</span></span></span>  <a +href="glossaries-user.html#dx1-27033" ><span +class="ecti-1000">101</span></a>, <a +href="glossaries-user.html#dx1-42016" >102</a>, <a +href="glossaries-user.html#dx1-42040" >103</a>, <a +href="glossaries-user.html#dx1-42043" >104</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\defglsdisplayfirst</span></span></span>  <a +href="glossaries-user.html#dx1-27034" ><span +class="ecti-1000">105</span></a>, <a +href="glossaries-user.html#dx1-42015" >106</a>, <a +href="glossaries-user.html#dx1-42039" >107</a>, <a +href="glossaries-user.html#dx1-42042" >108</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\delimN</span></span></span>  <a +href="glossaries-user.html#dx1-52048" >109</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\delimR</span></span></span>  <a +href="glossaries-user.html#dx1-52049" >110</a> <br /></span> +<span class="index-item"><span +class="ectt-1000">description </span>(environment)  <a +href="glossaries-user.html#dx1-46002" >111</a>, <a +href="glossaries-user.html#dx1-46007" >112</a>, <a +href="glossaries-user.html#dx1-46029" >113</a>, <a +href="glossaries-user.html#dx1-52009" >114</a>, <a +href="glossaries-user.html#dx1-52013" >115</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\descriptionname</span></span></span>  <a +href="glossaries-user.html#dx1-6018" >116</a> <br /></span> +</p><p class="theindex"> <span +class="ecbx-1000">E</span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\emph</span></span></span>  <a +href="glossaries-user.html#dx1-26033" >117</a> <br /></span> +<span class="index-item">entry location  <a +href="glossaries-user.html#dx1-2006" ><span +class="ecbx-1000">118</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\entryname</span></span></span>  <a +href="glossaries-user.html#dx1-6017" >119</a> <br /></span> +<span class="index-item">environments:<br /></span> +<span class="index-subitem">    <span +class="ectt-1000">description</span>  <a +href="glossaries-user.html#dx1-46003" >120</a>, <a +href="glossaries-user.html#dx1-46008" >121</a>, <a +href="glossaries-user.html#dx1-46030" >122</a>, <a +href="glossaries-user.html#dx1-52010" >123</a>, <a +href="glossaries-user.html#dx1-52014" >124</a> <br /></span> +<span class="index-subitem">    <span +class="ectt-1000">equation</span>  <a +href="glossaries-user.html#dx1-4033" >125</a> <br /></span> +<span class="index-subitem">    <span +class="ectt-1000">itemize</span>  <a +href="glossaries-user.html#dx1-53002" >126</a> <br /></span> +<span class="index-subitem">    <span +class="ectt-1000">longtable</span>  <a +href="glossaries-user.html#dx1-47003" >127</a>, <a +href="glossaries-user.html#dx1-47008" >128</a>, <a +href="glossaries-user.html#dx1-48004" >129</a>, <a +href="glossaries-user.html#dx1-49007" >130</a>, <a +href="glossaries-user.html#dx1-55007" >131</a>, <a +href="glossaries-user.html#dx1-33040" >132</a> <br /></span> +<span class="index-subitem">    <span +class="ectt-1000">supertabular</span>  <a +href="glossaries-user.html#dx1-49003" >133</a>, <a +href="glossaries-user.html#dx1-49009" >134</a>, <a +href="glossaries-user.html#dx1-49014" >135</a>, <a +href="glossaries-user.html#dx1-50004" >136</a>, <a +href="glossaries-user.html#dx1-50011" >137</a> <br /></span> +<span class="index-subitem">    <span +class="ectt-1000">theglossary</span>  <a +href="glossaries-user.html#dx1-52003" ><span +class="ecti-1000">138</span></a>, <a +href="glossaries-user.html#dx1-52005" >139</a>, <a +href="glossaries-user.html#dx1-52012" >140</a>, <a +href="glossaries-user.html#dx1-53004" >141</a> <br /></span> + + + +<span class="index-item"><span +class="ectt-1000">equation </span>(environment)  <a +href="glossaries-user.html#dx1-4032" >142</a> <br /></span> +<span class="index-item"><span +class="ecss-1000">etex </span>package  <a +href="glossaries-user.html#dx1-13030" >143</a> <br /></span> +</p><p class="theindex"> <span +class="ecbx-1000">F</span> +<span class="index-item">file types<br /></span> +<span class="index-subitem">    <span +class="ectt-1000">.alg</span>  <a +href="glossaries-user.html#dx1-7080" >144</a> <br /></span> +<span class="index-subitem">    <span +class="ectt-1000">.aux</span>  <a +href="glossaries-user.html#dx1-8003" >145</a>, <a +href="glossaries-user.html#dx1-35007" >146</a> <br /></span> +<span class="index-subitem">    <span +class="ectt-1000">.glg</span>  <a +href="glossaries-user.html#dx1-7079" >147</a>, <a +href="glossaries-user.html#dx1-9019" >148</a>, <a +href="glossaries-user.html#dx1-10017" >149</a>, <a +href="glossaries-user.html#dx1-57080" >150</a> <br /></span> +<span class="index-subitem">    <span +class="ectt-1000">.glo</span>  <a +href="glossaries-user.html#dx1-9021" >151</a>, <a +href="glossaries-user.html#dx1-10019" >152</a>, <a +href="glossaries-user.html#dx1-19005" >153</a> <br /></span> +<span class="index-subitem">    <span +class="ectt-1000">.gls</span>  <a +href="glossaries-user.html#dx1-9020" >154</a>, <a +href="glossaries-user.html#dx1-10018" >155</a>, <a +href="glossaries-user.html#dx1-19006" >156</a> <br /></span> +<span class="index-subitem">    <span +class="ectt-1000">.ist</span>  <a +href="glossaries-user.html#dx1-10007" >157</a>, <a +href="glossaries-user.html#dx1-10010" >158</a>, <a +href="glossaries-user.html#dx1-11009" >159</a>, <a +href="glossaries-user.html#dx1-16031" >160</a>, <a +href="glossaries-user.html#dx1-18004" >161</a>, <a +href="glossaries-user.html#dx1-18016" >162</a> <br /></span> +<span class="index-subitem">    <span +class="ectt-1000">.log</span>  <a +href="glossaries-user.html#dx1-57079" >163</a> <br /></span> +<span class="index-subitem">    <span +class="ectt-1000">.tex</span>  <a +href="glossaries-user.html#dx1-9012" >164</a>, <a +href="glossaries-user.html#dx1-10006" >165</a> <br /></span> +<span class="index-subitem">    <span +class="ectt-1000">.xdy</span>  <a +href="glossaries-user.html#dx1-9015" >166</a>, <a +href="glossaries-user.html#dx1-9016" >167</a>, <a +href="glossaries-user.html#dx1-11012" >168</a>, <a +href="glossaries-user.html#dx1-16045" >169</a>, <a +href="glossaries-user.html#dx1-18007" >170</a>, <a +href="glossaries-user.html#dx1-18013" >171</a>, <a +href="glossaries-user.html#dx1-18020" >172</a>, <a +href="glossaries-user.html#dx1-34008" >173</a> <br /></span> +<span class="index-item">first use  <a +href="glossaries-user.html#dx1-2007" >174</a> <br /></span> +<span class="index-subitem">    flag  <a +href="glossaries-user.html#dx1-2015" >175</a>, <a +href="glossaries-user.html#dx1-26073" >176</a> <br /></span> +<span class="index-subitem">    text  <a +href="glossaries-user.html#dx1-2017" >177</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\firstacronymfont</span></span></span>  <a +href="glossaries-user.html#dx1-39052" ><span +class="ecti-1000">178</span></a>, <a +href="glossaries-user.html#dx1-40016" >179</a>, <a +href="glossaries-user.html#dx1-40026" >180</a>, <a +href="glossaries-user.html#dx1-40033" >181</a>, <a +href="glossaries-user.html#dx1-57036" >182</a> <br /></span> +<span class="index-item"><span +class="ecss-1000">flowfram </span>package  <a +href="glossaries-user.html#dx1-49011" >183</a> <br /></span> +<span class="index-item"><span +class="ecss-1000">fmtcount </span>package  <a +href="glossaries-user.html#dx1-36032" >184</a> <br /></span> +</p><p class="theindex"> <span +class="ecbx-1000">G</span> +<span class="index-item"><span +class="ecss-1000">german </span>package  <a +href="glossaries-user.html#dx1-6008" >185</a> <br /></span> +<span class="index-item"><span +class="ecss-1000">glossaries </span>package  <a +href="glossaries-user.html#dx1-2028" >186</a> <br /></span> +<span class="index-item"><span +class="ecss-1000">glossaries-accsupp </span>package  <a +href="glossaries-user.html#dx1-4088" >187</a>, <a +href="glossaries-user.html#dx1-56001" >188</a>, <a +href="glossaries-user.html#dx1-56033" >189</a> <br /></span> +<span class="index-item"><span +class="ecss-1000">glossaries-babel </span>package  <a +href="glossaries-user.html#dx1-6031" >190</a>, <a +href="glossaries-user.html#dx1-13054" >191</a>, <a +href="glossaries-user.html#dx1-13060" >192</a> <br /></span> +<span class="index-item"><span +class="ecss-1000">glossaries-polyglossia </span>package  <a +href="glossaries-user.html#dx1-6034" >193</a>, <a +href="glossaries-user.html#dx1-13056" >194</a>, <a +href="glossaries-user.html#dx1-13061" >195</a> <br /></span> +<span class="index-item">glossary counters:<br /></span> +<span class="index-subitem">    <span +class="ectt-1000">glossaryentry</span>  <a +href="glossaries-user.html#dx1-15004" ><span +class="ecti-1000">196</span></a> <br /></span> +<span class="index-subitem">    <span +class="ectt-1000">glossarysubentry</span>  <a +href="glossaries-user.html#dx1-15022" ><span +class="ecti-1000">197</span></a> <br /></span> +<span class="index-item"><span +class="ecss-1000">glossary </span>package  <a +href="glossaries-user.html#dx1-2" >198</a>, <a +href="glossaries-user.html#dx1-3005" >199</a>, <a +href="glossaries-user.html#dx1-43001" >200</a>, <a +href="glossaries-user.html#dx1-43002" >201</a>, <a +href="glossaries-user.html#dx1-43005" >202</a>, <a +href="glossaries-user.html#dx1-57052" >203</a> <br /></span> +<span class="index-item">glossary styles:<br /></span> +<span class="index-subitem">    <span +class="ectt-1000">altlist</span>  <a +href="glossaries-user.html#dx1-46020" >204</a>, <a +href="glossaries-user.html#dx1-46025" >205</a> <br /></span> +<span class="index-subitem">    <span +class="ectt-1000">altlistgroup</span>  <a +href="glossaries-user.html#dx1-46024" >206</a>, <a +href="glossaries-user.html#dx1-46027" >207</a> <br /></span> +<span class="index-subitem">    <span +class="ectt-1000">altlisthypergroup</span>  <a +href="glossaries-user.html#dx1-46026" >208</a> <br /></span> +<span class="index-subitem">    <span +class="ectt-1000">altlong4col</span>  <a +href="glossaries-user.html#dx1-45023" >209</a>, <a +href="glossaries-user.html#dx1-47033" >210</a>, <a +href="glossaries-user.html#dx1-47040" >211</a> <br /></span> +<span class="index-subitem">    <span +class="ectt-1000">altlong4colborder</span>  <a +href="glossaries-user.html#dx1-47044" >212</a> <br /></span> +<span class="index-subitem">    <span +class="ectt-1000">altlong4colheader</span>  <a +href="glossaries-user.html#dx1-47046" >213</a> <br /></span> +<span class="index-subitem">    <span +class="ectt-1000">altlong4colheaderborder</span>  <a +href="glossaries-user.html#dx1-47048" >214</a> <br /></span> +<span class="index-subitem">    <span +class="ectt-1000">altlongragged4col</span>  <a +href="glossaries-user.html#dx1-48031" >215</a>, <a +href="glossaries-user.html#dx1-48036" >216</a>, <a +href="glossaries-user.html#dx1-48038" >217</a> <br /></span> +<span class="index-subitem">    <span +class="ectt-1000">altlongragged4colborder</span>  <a +href="glossaries-user.html#dx1-48035" >218</a> <br /></span> +<span class="index-subitem">    <span +class="ectt-1000">altlongragged4colheader</span>  <a +href="glossaries-user.html#dx1-48037" >219</a>, <a +href="glossaries-user.html#dx1-48040" >220</a> <br /></span> +<span class="index-subitem">    <span +class="ectt-1000">altlongragged4colheaderborder</span>  <a +href="glossaries-user.html#dx1-48039" >221</a> <br /></span> +<span class="index-subitem">    <span +class="ectt-1000">altsuper4col</span>  <a +href="glossaries-user.html#dx1-45024" >222</a>, <a +href="glossaries-user.html#dx1-49039" >223</a>, <a +href="glossaries-user.html#dx1-49046" >224</a> <br /></span> + + + +<span class="index-subitem">    <span +class="ectt-1000">altsuper4colborder</span>  <a +href="glossaries-user.html#dx1-49050" >225</a> <br /></span> +<span class="index-subitem">    <span +class="ectt-1000">altsuper4colheader</span>  <a +href="glossaries-user.html#dx1-49052" >226</a> <br /></span> +<span class="index-subitem">    <span +class="ectt-1000">altsuper4colheaderborder</span>  <a +href="glossaries-user.html#dx1-49054" >227</a> <br /></span> +<span class="index-subitem">    <span +class="ectt-1000">altsuperragged4col</span>  <a +href="glossaries-user.html#dx1-50034" >228</a>, <a +href="glossaries-user.html#dx1-50037" >229</a>, <a +href="glossaries-user.html#dx1-50039" >230</a> <br /></span> +<span class="index-subitem">    <span +class="ectt-1000">altsuperragged4colborder</span>  <a +href="glossaries-user.html#dx1-50036" >231</a> <br /></span> +<span class="index-subitem">    <span +class="ectt-1000">altsuperragged4colheader</span>  <a +href="glossaries-user.html#dx1-50038" >232</a>, <a +href="glossaries-user.html#dx1-50041" >233</a> <br /></span> +<span class="index-subitem">    <span +class="ectt-1000">altsuperragged4colheaderborder</span>  <a +href="glossaries-user.html#dx1-50040" >234</a> <br /></span> +<span class="index-subitem">    <span +class="ectt-1000">alttree</span>  <a +href="glossaries-user.html#dx1-51018" >235</a>, <a +href="glossaries-user.html#dx1-51031" >236</a>, <a +href="glossaries-user.html#dx1-51035" >237</a> <br /></span> +<span class="index-subitem">    <span +class="ectt-1000">alttreegroup</span>  <a +href="glossaries-user.html#dx1-51034" >238</a>, <a +href="glossaries-user.html#dx1-51037" >239</a> <br /></span> +<span class="index-subitem">    <span +class="ectt-1000">alttreehypergroup</span>  <a +href="glossaries-user.html#dx1-51036" >240</a> <br /></span> +<span class="index-subitem">    <span +class="ectt-1000">index</span>  <a +href="glossaries-user.html#dx1-51004" >241</a>, <a +href="glossaries-user.html#dx1-51007" >242</a>, <a +href="glossaries-user.html#dx1-51012" >243</a> <br /></span> +<span class="index-subitem">    <span +class="ectt-1000">indexgroup</span>  <a +href="glossaries-user.html#dx1-51006" >244</a>, <a +href="glossaries-user.html#dx1-51009" >245</a> <br /></span> +<span class="index-subitem">    <span +class="ectt-1000">indexhypergroup</span>  <a +href="glossaries-user.html#dx1-51008" >246</a> <br /></span> +<span class="index-subitem">    <span +class="ectt-1000">list</span>  <a +href="glossaries-user.html#dx1-15039" >247</a>, <a +href="glossaries-user.html#dx1-46006" >248</a>, <a +href="glossaries-user.html#dx1-46014" >249</a>, <a +href="glossaries-user.html#dx1-46021" >250</a>, <a +href="glossaries-user.html#dx1-46022" >251</a>, <a +href="glossaries-user.html#dx1-46023" >252</a>, <a +href="glossaries-user.html#dx1-52008" >253</a>, <a +href="glossaries-user.html#dx1-52017" >254</a>, <a +href="glossaries-user.html#dx1-52033" >255</a>, <a +href="glossaries-user.html#dx1-52045" >256</a>, <a +href="glossaries-user.html#dx1-54003" >257</a> <br /></span> +<span class="index-subitem">    <span +class="ectt-1000">listdotted</span>  <a +href="glossaries-user.html#dx1-45033" >258</a>, <a +href="glossaries-user.html#dx1-46035" >259</a>, <a +href="glossaries-user.html#dx1-46036" >260</a> <br /></span> +<span class="index-subitem">    <span +class="ectt-1000">listgroup</span>  <a +href="glossaries-user.html#dx1-46013" >261</a>, <a +href="glossaries-user.html#dx1-46016" >262</a> <br /></span> +<span class="index-subitem">    <span +class="ectt-1000">listhypergroup</span>  <a +href="glossaries-user.html#dx1-46015" >263</a>, <a +href="glossaries-user.html#dx1-46028" >264</a>, <a +href="glossaries-user.html#dx1-51010" >265</a>, <a +href="glossaries-user.html#dx1-51023" >266</a>, <a +href="glossaries-user.html#dx1-51030" >267</a>, <a +href="glossaries-user.html#dx1-51038" >268</a>, <a +href="glossaries-user.html#dx1-52030" >269</a> <br /></span> +<span class="index-subitem">    <span +class="ectt-1000">long</span>  <a +href="glossaries-user.html#dx1-45030" >270</a>, <a +href="glossaries-user.html#dx1-47006" >271</a>, <a +href="glossaries-user.html#dx1-47014" >272</a>, <a +href="glossaries-user.html#dx1-47016" >273</a>, <a +href="glossaries-user.html#dx1-47020" >274</a> <br /></span> +<span class="index-subitem">    <span +class="ectt-1000">long3col</span>  <a +href="glossaries-user.html#dx1-45005" >275</a>, <a +href="glossaries-user.html#dx1-47019" >276</a>, <a +href="glossaries-user.html#dx1-47026" >277</a>, <a +href="glossaries-user.html#dx1-47028" >278</a>, <a +href="glossaries-user.html#dx1-47032" >279</a> <br /></span> +<span class="index-subitem">    <span +class="ectt-1000">long3colborder</span>  <a +href="glossaries-user.html#dx1-45007" >280</a>, <a +href="glossaries-user.html#dx1-47025" >281</a> <br /></span> +<span class="index-subitem">    <span +class="ectt-1000">long3colheader</span>  <a +href="glossaries-user.html#dx1-45006" >282</a>, <a +href="glossaries-user.html#dx1-47027" >283</a>, <a +href="glossaries-user.html#dx1-47030" >284</a> <br /></span> +<span class="index-subitem">    <span +class="ectt-1000">long3colheaderborder</span>  <a +href="glossaries-user.html#dx1-45008" >285</a>, <a +href="glossaries-user.html#dx1-47029" >286</a> <br /></span> +<span class="index-subitem">    <span +class="ectt-1000">long4col</span>  <a +href="glossaries-user.html#dx1-41011" >287</a>, <a +href="glossaries-user.html#dx1-45021" >288</a>, <a +href="glossaries-user.html#dx1-47031" >289</a>, <a +href="glossaries-user.html#dx1-47035" >290</a>, <a +href="glossaries-user.html#dx1-47037" >291</a>, <a +href="glossaries-user.html#dx1-47041" >292</a> <br /></span> +<span class="index-subitem">    <span +class="ectt-1000">long4colborder</span>  <a +href="glossaries-user.html#dx1-47034" >293</a>, <a +href="glossaries-user.html#dx1-47045" >294</a> <br /></span> +<span class="index-subitem">    <span +class="ectt-1000">long4colheader</span>  <a +href="glossaries-user.html#dx1-47036" >295</a>, <a +href="glossaries-user.html#dx1-47039" >296</a>, <a +href="glossaries-user.html#dx1-47047" >297</a> <br /></span> +<span class="index-subitem">    <span +class="ectt-1000">long4colheaderborder</span>  <a +href="glossaries-user.html#dx1-47038" >298</a>, <a +href="glossaries-user.html#dx1-47049" >299</a> <br /></span> +<span class="index-subitem">    <span +class="ectt-1000">longborder</span>  <a +href="glossaries-user.html#dx1-47013" >300</a> <br /></span> +<span class="index-subitem">    <span +class="ectt-1000">longheader</span>  <a +href="glossaries-user.html#dx1-47015" >301</a>, <a +href="glossaries-user.html#dx1-47018" >302</a>, <a +href="glossaries-user.html#dx1-52019" >303</a> <br /></span> +<span class="index-subitem">    <span +class="ectt-1000">longheaderborder</span>  <a +href="glossaries-user.html#dx1-47017" >304</a>, <a +href="glossaries-user.html#dx1-33038" >305</a> <br /></span> +<span class="index-subitem">    <span +class="ectt-1000">longragged</span>  <a +href="glossaries-user.html#dx1-48009" >306</a>, <a +href="glossaries-user.html#dx1-48014" >307</a>, <a +href="glossaries-user.html#dx1-48016" >308</a>, <a +href="glossaries-user.html#dx1-48020" >309</a> <br /></span> +<span class="index-subitem">    <span +class="ectt-1000">longragged3col</span>  <a +href="glossaries-user.html#dx1-48019" >310</a>, <a +href="glossaries-user.html#dx1-48026" >311</a>, <a +href="glossaries-user.html#dx1-48028" >312</a>, <a +href="glossaries-user.html#dx1-48032" >313</a> <br /></span> +<span class="index-subitem">    <span +class="ectt-1000">longragged3colborder</span>  <a +href="glossaries-user.html#dx1-48025" >314</a> <br /></span> +<span class="index-subitem">    <span +class="ectt-1000">longragged3colheader</span>  <a +href="glossaries-user.html#dx1-48027" >315</a>, <a +href="glossaries-user.html#dx1-48030" >316</a> <br /></span> +<span class="index-subitem">    <span +class="ectt-1000">longragged3colheaderborder</span>  <a +href="glossaries-user.html#dx1-48029" >317</a> <br /></span> +<span class="index-subitem">    <span +class="ectt-1000">longraggedborder</span>  <a +href="glossaries-user.html#dx1-48013" >318</a> <br /></span> +<span class="index-subitem">    <span +class="ectt-1000">longraggedheader</span>  <a +href="glossaries-user.html#dx1-48015" >319</a>, <a +href="glossaries-user.html#dx1-48018" >320</a> <br /></span> +<span class="index-subitem">    <span +class="ectt-1000">longraggedheaderborder</span>  <a +href="glossaries-user.html#dx1-48017" >321</a> <br /></span> +<span class="index-subitem">    <span +class="ectt-1000">super</span>  <a +href="glossaries-user.html#dx1-49012" >322</a>, <a +href="glossaries-user.html#dx1-49020" >323</a>, <a +href="glossaries-user.html#dx1-49022" >324</a>, <a +href="glossaries-user.html#dx1-49026" >325</a> <br /></span> +<span class="index-subitem">    <span +class="ectt-1000">super3col</span>  <a +href="glossaries-user.html#dx1-49025" >326</a>, <a +href="glossaries-user.html#dx1-49032" >327</a>, <a +href="glossaries-user.html#dx1-49034" >328</a>, <a +href="glossaries-user.html#dx1-49038" >329</a> <br /></span> +<span class="index-subitem">    <span +class="ectt-1000">super3colborder</span>  <a +href="glossaries-user.html#dx1-49031" >330</a> <br /></span> +<span class="index-subitem">    <span +class="ectt-1000">super3colheader</span>  <a +href="glossaries-user.html#dx1-49033" >331</a>, <a +href="glossaries-user.html#dx1-49036" >332</a> <br /></span> +<span class="index-subitem">    <span +class="ectt-1000">super3colheaderborder</span>  <a +href="glossaries-user.html#dx1-49035" >333</a> <br /></span> +<span class="index-subitem">    <span +class="ectt-1000">super4col</span>  <a +href="glossaries-user.html#dx1-45022" >334</a>, <a +href="glossaries-user.html#dx1-49037" >335</a>, <a +href="glossaries-user.html#dx1-49041" >336</a>, <a +href="glossaries-user.html#dx1-49043" >337</a>, <a +href="glossaries-user.html#dx1-49047" >338</a> <br /></span> +<span class="index-subitem">    <span +class="ectt-1000">super4colborder</span>  <a +href="glossaries-user.html#dx1-49040" >339</a>, <a +href="glossaries-user.html#dx1-49051" >340</a> <br /></span> +<span class="index-subitem">    <span +class="ectt-1000">super4colheader</span>  <a +href="glossaries-user.html#dx1-49042" >341</a>, <a +href="glossaries-user.html#dx1-49045" >342</a>, <a +href="glossaries-user.html#dx1-49053" >343</a> <br /></span> +<span class="index-subitem">    <span +class="ectt-1000">super4colheaderborder</span>  <a +href="glossaries-user.html#dx1-49044" >344</a>, <a +href="glossaries-user.html#dx1-49055" >345</a> <br /></span> + + + +<span class="index-subitem">    <span +class="ectt-1000">superborder</span>  <a +href="glossaries-user.html#dx1-49019" >346</a> <br /></span> +<span class="index-subitem">    <span +class="ectt-1000">superheader</span>  <a +href="glossaries-user.html#dx1-49021" >347</a>, <a +href="glossaries-user.html#dx1-49024" >348</a> <br /></span> +<span class="index-subitem">    <span +class="ectt-1000">superheaderborder</span>  <a +href="glossaries-user.html#dx1-33036" >349</a>, <a +href="glossaries-user.html#dx1-49023" >350</a> <br /></span> +<span class="index-subitem">    <span +class="ectt-1000">superragged</span>  <a +href="glossaries-user.html#dx1-50009" >351</a>, <a +href="glossaries-user.html#dx1-50017" >352</a>, <a +href="glossaries-user.html#dx1-50019" >353</a>, <a +href="glossaries-user.html#dx1-50023" >354</a> <br /></span> +<span class="index-subitem">    <span +class="ectt-1000">superragged3col</span>  <a +href="glossaries-user.html#dx1-50022" >355</a>, <a +href="glossaries-user.html#dx1-50029" >356</a>, <a +href="glossaries-user.html#dx1-50031" >357</a>, <a +href="glossaries-user.html#dx1-50035" >358</a> <br /></span> +<span class="index-subitem">    <span +class="ectt-1000">superragged3colborder</span>  <a +href="glossaries-user.html#dx1-50028" >359</a> <br /></span> +<span class="index-subitem">    <span +class="ectt-1000">superragged3colheader</span>  <a +href="glossaries-user.html#dx1-50030" >360</a>, <a +href="glossaries-user.html#dx1-50033" >361</a> <br /></span> +<span class="index-subitem">    <span +class="ectt-1000">superragged3colheaderborder</span>  <a +href="glossaries-user.html#dx1-50032" >362</a> <br /></span> +<span class="index-subitem">    <span +class="ectt-1000">superraggedborder</span>  <a +href="glossaries-user.html#dx1-50016" >363</a> <br /></span> +<span class="index-subitem">    <span +class="ectt-1000">superraggedheader</span>  <a +href="glossaries-user.html#dx1-50018" >364</a>, <a +href="glossaries-user.html#dx1-50021" >365</a> <br /></span> +<span class="index-subitem">    <span +class="ectt-1000">superraggedheaderborder</span>  <a +href="glossaries-user.html#dx1-50020" >366</a> <br /></span> +<span class="index-subitem">    <span +class="ectt-1000">tree</span>  <a +href="glossaries-user.html#dx1-51011" >367</a>, <a +href="glossaries-user.html#dx1-51020" >368</a>, <a +href="glossaries-user.html#dx1-51025" >369</a>, <a +href="glossaries-user.html#dx1-51032" >370</a> <br /></span> +<span class="index-subitem">    <span +class="ectt-1000">treegroup</span>  <a +href="glossaries-user.html#dx1-51019" >371</a>, <a +href="glossaries-user.html#dx1-51022" >372</a> <br /></span> +<span class="index-subitem">    <span +class="ectt-1000">treehypergroup</span>  <a +href="glossaries-user.html#dx1-51021" >373</a> <br /></span> +<span class="index-subitem">    <span +class="ectt-1000">treenoname</span>  <a +href="glossaries-user.html#dx1-51024" >374</a>, <a +href="glossaries-user.html#dx1-51027" >375</a> <br /></span> +<span class="index-subitem">    <span +class="ectt-1000">treenonamegroup</span>  <a +href="glossaries-user.html#dx1-51026" >376</a>, <a +href="glossaries-user.html#dx1-51029" >377</a> <br /></span> +<span class="index-subitem">    <span +class="ectt-1000">treenonamehypergroup</span>  <a +href="glossaries-user.html#dx1-51028" >378</a> <br /></span> +<span class="index-item"><span +class="ecss-1000">glossary-list </span>package  <a +href="glossaries-user.html#dx1-15027" >379</a>, <a +href="glossaries-user.html#dx1-15038" >380</a>, <a +href="glossaries-user.html#dx1-33042" >381</a>, <a +href="glossaries-user.html#dx1-46001" >382</a> <br /></span> +<span class="index-item"><span +class="ecss-1000">glossary-long </span>package  <a +href="glossaries-user.html#dx1-15028" >383</a>, <a +href="glossaries-user.html#dx1-15032" >384</a>, <a +href="glossaries-user.html#dx1-33043" >385</a>, <a +href="glossaries-user.html#dx1-47001" >386</a>, <a +href="glossaries-user.html#dx1-48002" >387</a> <br /></span> +<span class="index-item"><span +class="ecss-1000">glossary-longragged </span>package  <a +href="glossaries-user.html#dx1-48001" >388</a>, <a +href="glossaries-user.html#dx1-48005" >389</a>, <a +href="glossaries-user.html#dx1-48007" >390</a> <br /></span> +<span class="index-item"><span +class="ecss-1000">glossary-super </span>package  <a +href="glossaries-user.html#dx1-15029" >391</a>, <a +href="glossaries-user.html#dx1-15035" >392</a>, <a +href="glossaries-user.html#dx1-33044" >393</a>, <a +href="glossaries-user.html#dx1-49001" >394</a>, <a +href="glossaries-user.html#dx1-50002" >395</a> <br /></span> +<span class="index-item"><span +class="ecss-1000">glossary-superragged </span>package  <a +href="glossaries-user.html#dx1-50001" >396</a>, <a +href="glossaries-user.html#dx1-50005" >397</a>, <a +href="glossaries-user.html#dx1-50007" >398</a> <br /></span> +<span class="index-item"><span +class="ecss-1000">glossary-tree </span>package  <a +href="glossaries-user.html#dx1-15030" >399</a>, <a +href="glossaries-user.html#dx1-15042" >400</a>, <a +href="glossaries-user.html#dx1-33045" >401</a>, <a +href="glossaries-user.html#dx1-51001" >402</a> <br /></span> +<span class="index-item"><span +class="ectt-1000">glossaryentry </span>(counter)  <a +href="glossaries-user.html#dx1-15003" ><span +class="ecti-1000">403</span></a> <br /></span> +<span class="index-item"><span +class="ecss-1000">glossaryentry </span>counter  <a +href="glossaries-user.html#dx1-15014" >404</a>, <a +href="glossaries-user.html#dx1-15015" >405</a>, <a +href="glossaries-user.html#dx1-15018" >406</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\glossaryentryfield</span></span></span>  <a +href="glossaries-user.html#dx1-52035" ><span +class="ecti-1000">407</span></a>, <a +href="glossaries-user.html#dx1-52057" >408</a>, <a +href="glossaries-user.html#dx1-55001" >409</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\glossaryentrynumbers</span></span></span>  <a +href="glossaries-user.html#dx1-52046" >410</a>, <a +href="glossaries-user.html#dx1-52051" >411</a>, <a +href="glossaries-user.html#dx1-52052" >412</a>, <a +href="glossaries-user.html#dx1-52054" >413</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\glossaryheader</span></span></span>  <a +href="glossaries-user.html#dx1-46019" >414</a>, <a +href="glossaries-user.html#dx1-52015" ><span +class="ecti-1000">415</span></a>, <a +href="glossaries-user.html#dx1-52018" >416</a>, <a +href="glossaries-user.html#dx1-53007" >417</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\glossarymark</span></span></span>  <a +href="glossaries-user.html#dx1-14013" ><span +class="ecti-1000">418</span></a>, <a +href="glossaries-user.html#dx1-33032" >419</a>, <a +href="glossaries-user.html#dx1-33033" >420</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\glossaryname</span></span></span>  <a +href="glossaries-user.html#dx1-6014" >421</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\glossarypostamble</span></span></span>  <a +href="glossaries-user.html#dx1-33035" ><span +class="ecti-1000">422</span></a>, <a +href="glossaries-user.html#dx1-52007" >423</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\glossarypreamble</span></span></span>  <a +href="glossaries-user.html#dx1-15017" >424</a>, <a +href="glossaries-user.html#dx1-33034" ><span +class="ecti-1000">425</span></a>, <a +href="glossaries-user.html#dx1-52006" >426</a>, <a +href="glossaries-user.html#dx1-52016" >427</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\glossarystyle</span></span></span>  <a +href="glossaries-user.html#dx1-15045" >428</a>, <a +href="glossaries-user.html#dx1-33021" >429</a>, <a +href="glossaries-user.html#dx1-45013" ><span +class="ecti-1000">430</span></a>, <a +href="glossaries-user.html#dx1-45029" >431</a>, <a +href="glossaries-user.html#dx1-45032" >432</a>, <a +href="glossaries-user.html#dx1-54001" >433</a> <br /></span> +<span class="index-item"><span +class="ectt-1000">glossarysubentry </span>(counter)  <a +href="glossaries-user.html#dx1-15021" ><span +class="ecti-1000">434</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\glossarysubentryfield</span></span></span>  <a +href="glossaries-user.html#dx1-52056" ><span +class="ecti-1000">435</span></a>, <a +href="glossaries-user.html#dx1-55002" >436</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\GLS</span></span></span>  <a +href="glossaries-user.html#dx1-2010" >437</a>, <a +href="glossaries-user.html#dx1-19067" >438</a>, <a +href="glossaries-user.html#dx1-26078" ><span +class="ecti-1000">439</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\Gls</span></span></span>  <a +href="glossaries-user.html#dx1-2009" >440</a>, <a +href="glossaries-user.html#dx1-5014" >441</a>, <a +href="glossaries-user.html#dx1-19066" >442</a>, <a +href="glossaries-user.html#dx1-19125" >443</a>, <a +href="glossaries-user.html#dx1-26077" ><span +class="ecti-1000">444</span></a>, <a +href="glossaries-user.html#dx1-27018" >445</a>, <a +href="glossaries-user.html#dx1-39109" >446</a>, <a +href="glossaries-user.html#dx1-43009" >447</a>, <a +href="glossaries-user.html#dx1-43011" >448</a>, <a +href="glossaries-user.html#dx1-43013" >449</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\gls</span></span></span>  <a +href="glossaries-user.html#dx1-2008" >450</a>, <a +href="glossaries-user.html#dx1-2024" >451</a>, <a +href="glossaries-user.html#dx1-19039" >452</a>, <a +href="glossaries-user.html#dx1-19043" >453</a>, <a +href="glossaries-user.html#dx1-19049" >454</a>, <a +href="glossaries-user.html#dx1-19051" >455</a>, <a +href="glossaries-user.html#dx1-19065" >456</a>, <a +href="glossaries-user.html#dx1-26018" >457</a>, <a +href="glossaries-user.html#dx1-26067" ><span +class="ecti-1000">458</span></a>, <a +href="glossaries-user.html#dx1-26092" >459</a>, <a +href="glossaries-user.html#dx1-26099" >460</a>, <a +href="glossaries-user.html#dx1-27003" >461</a>, <a +href="glossaries-user.html#dx1-27016" >462</a>, <a +href="glossaries-user.html#dx1-27030" >463</a>, <a +href="glossaries-user.html#dx1-27038" >464</a>, <a +href="glossaries-user.html#dx1-28004" >465</a>, <a +href="glossaries-user.html#dx1-28014" >466</a>, <a +href="glossaries-user.html#dx1-30003" >467</a>, <a +href="glossaries-user.html#dx1-30008" >468</a>, <a +href="glossaries-user.html#dx1-39042" >469</a>, <a +href="glossaries-user.html#dx1-39107" >470</a>, <a +href="glossaries-user.html#dx1-40004" >471</a>, <a +href="glossaries-user.html#dx1-40008" >472</a>, <a +href="glossaries-user.html#dx1-42022" >473</a>, <a +href="glossaries-user.html#dx1-43008" >474</a>, <a +href="glossaries-user.html#dx1-43010" >475</a>, <a +href="glossaries-user.html#dx1-43012" >476</a>, <a +href="glossaries-user.html#dx1-43018" >477</a>, <a +href="glossaries-user.html#dx1-43020" >478</a>, <a +href="glossaries-user.html#dx1-44001" >479</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\gls*</span></span></span>  <a +href="glossaries-user.html#dx1-13066" >480</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\glsadd</span></span></span>  <a +href="glossaries-user.html#dx1-29001" ><span +class="ecti-1000">481</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\glsaddall</span></span></span>  <a +href="glossaries-user.html#dx1-4023" >482</a>, <a +href="glossaries-user.html#dx1-29005" ><span +class="ecti-1000">483</span></a> <br /></span> +<span class="index-item"><span +class="ectt-1000">\glsaddall </span>options<br /></span> +<span class="index-subitem">    <span +class="ecss-1000">types</span>  <a +href="glossaries-user.html#dx1-29006" >484</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\GlsAddXdyAttribute</span></span></span>  <a +href="glossaries-user.html#dx1-26039" >485</a>, <a +href="glossaries-user.html#dx1-36017" ><span +class="ecti-1000">486</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\GlsAddXdyCounters</span></span></span>  <a +href="glossaries-user.html#dx1-36011" ><span +class="ecti-1000">487</span></a>, <a +href="glossaries-user.html#dx1-36038" >488</a> <br /></span> + + + +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\GlsAddXdyLocation</span></span></span>  <a +href="glossaries-user.html#dx1-36024" ><span +class="ecti-1000">489</span></a>, <a +href="glossaries-user.html#dx1-36050" >490</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\glsautoprefix</span></span></span>  <a +href="glossaries-user.html#dx1-14027" ><span +class="ecti-1000">491</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\glsclearpage</span></span></span>  <a +href="glossaries-user.html#dx1-14015" >492</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\glsclosebrace</span></span></span>  <a +href="glossaries-user.html#dx1-34012" ><span +class="ecti-1000">493</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\glsdefaulttype</span></span></span>  <a +href="glossaries-user.html#dx1-24004" >494</a>, <a +href="glossaries-user.html#dx1-17006" >495</a>, <a +href="glossaries-user.html#dx1-17008" >496</a>, <a +href="glossaries-user.html#dx1-24011" >497</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\GLSdesc</span></span></span>  <a +href="glossaries-user.html#dx1-26147" ><span +class="ecti-1000">498</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\Glsdesc</span></span></span>  <a +href="glossaries-user.html#dx1-26146" ><span +class="ecti-1000">499</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\glsdesc</span></span></span>  <a +href="glossaries-user.html#dx1-26139" ><span +class="ecti-1000">500</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\glsdescwidth</span></span></span>  <a +href="glossaries-user.html#dx1-45015" ><span +class="ecti-1000">501</span></a>, <a +href="glossaries-user.html#dx1-47012" >502</a>, <a +href="glossaries-user.html#dx1-47023" >503</a>, <a +href="glossaries-user.html#dx1-47042" >504</a>, <a +href="glossaries-user.html#dx1-48012" >505</a>, <a +href="glossaries-user.html#dx1-48023" >506</a>, <a +href="glossaries-user.html#dx1-48033" >507</a>, <a +href="glossaries-user.html#dx1-49018" >508</a>, <a +href="glossaries-user.html#dx1-49029" >509</a>, <a +href="glossaries-user.html#dx1-49048" >510</a>, <a +href="glossaries-user.html#dx1-50015" >511</a>, <a +href="glossaries-user.html#dx1-50026" >512</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\glsdisablehyper</span></span></span>  <a +href="glossaries-user.html#dx1-28006" ><span +class="ecti-1000">513</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\glsdisp</span></span></span>  <a +href="glossaries-user.html#dx1-2014" >514</a>, <a +href="glossaries-user.html#dx1-2022" >515</a>, <a +href="glossaries-user.html#dx1-19048" >516</a>, <a +href="glossaries-user.html#dx1-26025" >517</a>, <a +href="glossaries-user.html#dx1-26091" ><span +class="ecti-1000">518</span></a>, <a +href="glossaries-user.html#dx1-27024" >519</a>, <a +href="glossaries-user.html#dx1-27032" >520</a>, <a +href="glossaries-user.html#dx1-28016" >521</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\glsdisplay</span></span></span>  <a +href="glossaries-user.html#dx1-19029" >522</a>, <a +href="glossaries-user.html#dx1-19081" >523</a>, <a +href="glossaries-user.html#dx1-26089" >524</a>, <a +href="glossaries-user.html#dx1-26096" >525</a>, <a +href="glossaries-user.html#dx1-26102" >526</a>, <a +href="glossaries-user.html#dx1-27007" ><span +class="ecti-1000">527</span></a>, <a +href="glossaries-user.html#dx1-42046" >528</a>, <a +href="glossaries-user.html#dx1-42055" >529</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\glsdisplayfirst</span></span></span>  <a +href="glossaries-user.html#dx1-19030" >530</a>, <a +href="glossaries-user.html#dx1-19082" >531</a>, <a +href="glossaries-user.html#dx1-26090" >532</a>, <a +href="glossaries-user.html#dx1-26097" >533</a>, <a +href="glossaries-user.html#dx1-26103" >534</a>, <a +href="glossaries-user.html#dx1-27005" ><span +class="ecti-1000">535</span></a>, <a +href="glossaries-user.html#dx1-42045" >536</a>, <a +href="glossaries-user.html#dx1-42054" >537</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\glsenablehyper</span></span></span>  <a +href="glossaries-user.html#dx1-28007" ><span +class="ecti-1000">538</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\glsentrycounterlabel</span></span></span>  <a +href="glossaries-user.html#dx1-52042" ><span +class="ecti-1000">539</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\Glsentrydesc</span></span></span>  <a +href="glossaries-user.html#dx1-32022" ><span +class="ecti-1000">540</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\glsentrydesc</span></span></span>  <a +href="glossaries-user.html#dx1-32021" ><span +class="ecti-1000">541</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\Glsentrydescplural</span></span></span>  <a +href="glossaries-user.html#dx1-32024" ><span +class="ecti-1000">542</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\glsentrydescplural</span></span></span>  <a +href="glossaries-user.html#dx1-32023" ><span +class="ecti-1000">543</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\Glsentryfirst</span></span></span>  <a +href="glossaries-user.html#dx1-32014" ><span +class="ecti-1000">544</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\glsentryfirst</span></span></span>  <a +href="glossaries-user.html#dx1-32013" ><span +class="ecti-1000">545</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\Glsentryfirstplural</span></span></span>  <a +href="glossaries-user.html#dx1-32018" ><span +class="ecti-1000">546</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\glsentryfirstplural</span></span></span>  <a +href="glossaries-user.html#dx1-32017" ><span +class="ecti-1000">547</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\Glsentryfull</span></span></span>  <a +href="glossaries-user.html#dx1-39124" ><span +class="ecti-1000">548</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\glsentryfull</span></span></span>  <a +href="glossaries-user.html#dx1-39123" ><span +class="ecti-1000">549</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\Glsentryfullpl</span></span></span>  <a +href="glossaries-user.html#dx1-39126" ><span +class="ecti-1000">550</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\glsentryfullpl</span></span></span>  <a +href="glossaries-user.html#dx1-39125" ><span +class="ecti-1000">551</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\glsentryitem</span></span></span>  <a +href="glossaries-user.html#dx1-52039" ><span +class="ecti-1000">552</span></a>, <a +href="glossaries-user.html#dx1-53010" >553</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\Glsentrylong</span></span></span>  <a +href="glossaries-user.html#dx1-39116" ><span +class="ecti-1000">554</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\glsentrylong</span></span></span>  <a +href="glossaries-user.html#dx1-39115" ><span +class="ecti-1000">555</span></a>, <a +href="glossaries-user.html#dx1-42041" >556</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\Glsentrylongpl</span></span></span>  <a +href="glossaries-user.html#dx1-39118" ><span +class="ecti-1000">557</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\glsentrylongpl</span></span></span>  <a +href="glossaries-user.html#dx1-39117" ><span +class="ecti-1000">558</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\Glsentryname</span></span></span>  <a +href="glossaries-user.html#dx1-32005" ><span +class="ecti-1000">559</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\glsentryname</span></span></span>  <a +href="glossaries-user.html#dx1-5022" >560</a>, <a +href="glossaries-user.html#dx1-32004" ><span +class="ecti-1000">561</span></a>, <a +href="glossaries-user.html#dx1-57062" >562</a>, <a +href="glossaries-user.html#dx1-32044" >563</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\Glsentryplural</span></span></span>  <a +href="glossaries-user.html#dx1-32011" ><span +class="ecti-1000">564</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\glsentryplural</span></span></span>  <a +href="glossaries-user.html#dx1-32010" ><span +class="ecti-1000">565</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\Glsentryshort</span></span></span>  <a +href="glossaries-user.html#dx1-39120" ><span +class="ecti-1000">566</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\glsentryshort</span></span></span>  <a +href="glossaries-user.html#dx1-39119" ><span +class="ecti-1000">567</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\Glsentryshortpl</span></span></span>  <a +href="glossaries-user.html#dx1-39122" ><span +class="ecti-1000">568</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\glsentryshortpl</span></span></span>  <a +href="glossaries-user.html#dx1-39121" ><span +class="ecti-1000">569</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\Glsentrysymbol</span></span></span>  <a +href="glossaries-user.html#dx1-32026" ><span +class="ecti-1000">570</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\glsentrysymbol</span></span></span>  <a +href="glossaries-user.html#dx1-32025" ><span +class="ecti-1000">571</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\Glsentrysymbolplural</span></span></span>  <a +href="glossaries-user.html#dx1-32028" ><span +class="ecti-1000">572</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\glsentrysymbolplural</span></span></span>  <a +href="glossaries-user.html#dx1-32027" ><span +class="ecti-1000">573</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\Glsentrytext</span></span></span>  <a +href="glossaries-user.html#dx1-32008" ><span +class="ecti-1000">574</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\glsentrytext</span></span></span>  <a +href="glossaries-user.html#dx1-5020" >575</a>, <a +href="glossaries-user.html#dx1-26011" >576</a>, <a +href="glossaries-user.html#dx1-31013" >577</a>, <a +href="glossaries-user.html#dx1-32007" ><span +class="ecti-1000">578</span></a>, <a +href="glossaries-user.html#dx1-32042" >579</a>, <a +href="glossaries-user.html#dx1-39114" >580</a>, <a +href="glossaries-user.html#dx1-57064" >581</a> <br /></span> + + + +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\Glsentryuseri</span></span></span>  <a +href="glossaries-user.html#dx1-32030" ><span +class="ecti-1000">582</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\glsentryuseri</span></span></span>  <a +href="glossaries-user.html#dx1-32029" ><span +class="ecti-1000">583</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\Glsentryuserii</span></span></span>  <a +href="glossaries-user.html#dx1-32032" ><span +class="ecti-1000">584</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\glsentryuserii</span></span></span>  <a +href="glossaries-user.html#dx1-32031" ><span +class="ecti-1000">585</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\Glsentryuseriii</span></span></span>  <a +href="glossaries-user.html#dx1-32034" ><span +class="ecti-1000">586</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\glsentryuseriii</span></span></span>  <a +href="glossaries-user.html#dx1-32033" ><span +class="ecti-1000">587</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\Glsentryuseriv</span></span></span>  <a +href="glossaries-user.html#dx1-32036" ><span +class="ecti-1000">588</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\glsentryuseriv</span></span></span>  <a +href="glossaries-user.html#dx1-32035" ><span +class="ecti-1000">589</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\Glsentryuserv</span></span></span>  <a +href="glossaries-user.html#dx1-32038" ><span +class="ecti-1000">590</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\glsentryuserv</span></span></span>  <a +href="glossaries-user.html#dx1-32037" ><span +class="ecti-1000">591</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\Glsentryuservi</span></span></span>  <a +href="glossaries-user.html#dx1-32040" ><span +class="ecti-1000">592</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\glsentryuservi</span></span></span>  <a +href="glossaries-user.html#dx1-32039" ><span +class="ecti-1000">593</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\GLSfirst</span></span></span>  <a +href="glossaries-user.html#dx1-26110" ><span +class="ecti-1000">594</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\Glsfirst</span></span></span>  <a +href="glossaries-user.html#dx1-26109" ><span +class="ecti-1000">595</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\glsfirst</span></span></span>  <a +href="glossaries-user.html#dx1-26106" ><span +class="ecti-1000">596</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\GLSfirstplural</span></span></span>  <a +href="glossaries-user.html#dx1-26120" ><span +class="ecti-1000">597</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\Glsfirstplural</span></span></span>  <a +href="glossaries-user.html#dx1-26119" ><span +class="ecti-1000">598</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\glsfirstplural</span></span></span>  <a +href="glossaries-user.html#dx1-26116" ><span +class="ecti-1000">599</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\glsgetgrouptitle</span></span></span>  <a +href="glossaries-user.html#dx1-52028" ><span +class="ecti-1000">600</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\glsgroupheading</span></span></span>  <a +href="glossaries-user.html#dx1-52020" ><span +class="ecti-1000">601</span></a>, <a +href="glossaries-user.html#dx1-53005" >602</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\glsgroupskip</span></span></span>  <a +href="glossaries-user.html#dx1-2001" >603</a>, <a +href="glossaries-user.html#dx1-4018" >604</a>, <a +href="glossaries-user.html#dx1-45028" >605</a>, <a +href="glossaries-user.html#dx1-52032" ><span +class="ecti-1000">606</span></a>, <a +href="glossaries-user.html#dx1-53006" >607</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\glshyperlink</span></span></span>  <a +href="glossaries-user.html#dx1-32003" >608</a>, <a +href="glossaries-user.html#dx1-32041" ><span +class="ecti-1000">609</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\glshypernavsep</span></span></span>  <a +href="glossaries-user.html#dx1-46017" ><span +class="ecti-1000">610</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\glslabel</span></span></span>  <a +href="glossaries-user.html#dx1-27022" ><span +class="ecti-1000">611</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\glslabeltok</span></span></span>  <a +href="glossaries-user.html#dx1-42006" >612</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\glslink</span></span></span>  <a +href="glossaries-user.html#dx1-26023" ><span +class="ecti-1000">613</span></a>, <a +href="glossaries-user.html#dx1-26079" >614</a>, <a +href="glossaries-user.html#dx1-26080" >615</a>, <a +href="glossaries-user.html#dx1-26087" >616</a>, <a +href="glossaries-user.html#dx1-27023" >617</a>, <a +href="glossaries-user.html#dx1-28003" >618</a>, <a +href="glossaries-user.html#dx1-28017" >619</a>, <a +href="glossaries-user.html#dx1-29002" >620</a>, <a +href="glossaries-user.html#dx1-29004" >621</a>, <a +href="glossaries-user.html#dx1-36009" >622</a> <br /></span> +<span class="index-item"><span +class="ectt-1000">\glslink </span>options<br /></span> +<span class="index-subitem">    <span +class="ecss-1000">counter</span>  <a +href="glossaries-user.html#dx1-26063" >623</a>, <a +href="glossaries-user.html#dx1-36008" >624</a> <br /></span> +<span class="index-subitem">    <span +class="ecss-1000">format</span>  <a +href="glossaries-user.html#dx1-26026" >625</a>, <a +href="glossaries-user.html#dx1-26038" >626</a>, <a +href="glossaries-user.html#dx1-36012" >627</a>, <a +href="glossaries-user.html#dx1-36018" >628</a> <br /></span> +<span class="index-subitem">    <span +class="ecss-1000">hyper</span>  <a +href="glossaries-user.html#dx1-26064" >629</a>, <a +href="glossaries-user.html#dx1-28005" >630</a>, <a +href="glossaries-user.html#dx1-29003" >631</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\glslink*</span></span></span>  <a +href="glossaries-user.html#dx1-26066" ><span +class="ecti-1000">632</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\glslistdottedwidth</span></span></span>  <a +href="glossaries-user.html#dx1-46034" ><span +class="ecti-1000">633</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\glslocalreset</span></span></span>  <a +href="glossaries-user.html#dx1-44007" ><span +class="ecti-1000">634</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\glslocalresetall</span></span></span>  <a +href="glossaries-user.html#dx1-44011" ><span +class="ecti-1000">635</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\glslocalunset</span></span></span>  <a +href="glossaries-user.html#dx1-44009" ><span +class="ecti-1000">636</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\glslocalunsetall</span></span></span>  <a +href="glossaries-user.html#dx1-44013" ><span +class="ecti-1000">637</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\glslongtok</span></span></span>  <a +href="glossaries-user.html#dx1-42004" >638</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\GLSname</span></span></span>  <a +href="glossaries-user.html#dx1-26129" ><span +class="ecti-1000">639</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\Glsname</span></span></span>  <a +href="glossaries-user.html#dx1-26128" ><span +class="ecti-1000">640</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\glsname</span></span></span>  <a +href="glossaries-user.html#dx1-5023" >641</a>, <a +href="glossaries-user.html#dx1-26121" ><span +class="ecti-1000">642</span></a>, <a +href="glossaries-user.html#dx1-57063" >643</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\glsnamefont</span></span></span>  <a +href="glossaries-user.html#dx1-33041" ><span +class="ecti-1000">644</span></a>, <a +href="glossaries-user.html#dx1-52036" >645</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\glsnavhypertarget</span></span></span>  <a +href="glossaries-user.html#dx1-52029" ><span +class="ecti-1000">646</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\glsnumberformat</span></span></span>  <a +href="glossaries-user.html#dx1-36041" >647</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\glsnumbersgroupname</span></span></span>  <a +href="glossaries-user.html#dx1-6022" >648</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\glsopenbrace</span></span></span>  <a +href="glossaries-user.html#dx1-34011" ><span +class="ecti-1000">649</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\glspagelistwidth</span></span></span>  <a +href="glossaries-user.html#dx1-45016" ><span +class="ecti-1000">650</span></a>, <a +href="glossaries-user.html#dx1-47024" >651</a>, <a +href="glossaries-user.html#dx1-47043" >652</a>, <a +href="glossaries-user.html#dx1-48024" >653</a>, <a +href="glossaries-user.html#dx1-48034" >654</a>, <a +href="glossaries-user.html#dx1-49030" >655</a>, <a +href="glossaries-user.html#dx1-49049" >656</a>, <a +href="glossaries-user.html#dx1-50027" >657</a> <br /></span> + + + +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\glspar</span></span></span>  <a +href="glossaries-user.html#dx1-19025" ><span +class="ecti-1000">658</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\GLSpl</span></span></span>  <a +href="glossaries-user.html#dx1-2013" >659</a>, <a +href="glossaries-user.html#dx1-19033" >660</a>, <a +href="glossaries-user.html#dx1-19047" >661</a>, <a +href="glossaries-user.html#dx1-19085" >662</a>, <a +href="glossaries-user.html#dx1-26083" ><span +class="ecti-1000">663</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\Glspl</span></span></span>  <a +href="glossaries-user.html#dx1-2012" >664</a>, <a +href="glossaries-user.html#dx1-19032" >665</a>, <a +href="glossaries-user.html#dx1-19046" >666</a>, <a +href="glossaries-user.html#dx1-19084" >667</a>, <a +href="glossaries-user.html#dx1-19126" >668</a>, <a +href="glossaries-user.html#dx1-26082" ><span +class="ecti-1000">669</span></a>, <a +href="glossaries-user.html#dx1-39113" >670</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\glspl</span></span></span>  <a +href="glossaries-user.html#dx1-2011" >671</a>, <a +href="glossaries-user.html#dx1-19031" >672</a>, <a +href="glossaries-user.html#dx1-19045" >673</a>, <a +href="glossaries-user.html#dx1-19053" >674</a>, <a +href="glossaries-user.html#dx1-19059" >675</a>, <a +href="glossaries-user.html#dx1-19068" >676</a>, <a +href="glossaries-user.html#dx1-19070" >677</a>, <a +href="glossaries-user.html#dx1-19083" >678</a>, <a +href="glossaries-user.html#dx1-26019" >679</a>, <a +href="glossaries-user.html#dx1-26081" ><span +class="ecti-1000">680</span></a>, <a +href="glossaries-user.html#dx1-27004" >681</a>, <a +href="glossaries-user.html#dx1-27017" >682</a>, <a +href="glossaries-user.html#dx1-27031" >683</a>, <a +href="glossaries-user.html#dx1-28015" >684</a>, <a +href="glossaries-user.html#dx1-39111" >685</a>, <a +href="glossaries-user.html#dx1-40005" >686</a>, <a +href="glossaries-user.html#dx1-44002" >687</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\GLSplural</span></span></span>  <a +href="glossaries-user.html#dx1-26115" ><span +class="ecti-1000">688</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\Glsplural</span></span></span>  <a +href="glossaries-user.html#dx1-26114" ><span +class="ecti-1000">689</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\glsplural</span></span></span>  <a +href="glossaries-user.html#dx1-26111" ><span +class="ecti-1000">690</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\glspluralsuffix</span></span></span>  <a +href="glossaries-user.html#dx1-19054" >691</a>, <a +href="glossaries-user.html#dx1-19056" >692</a>, <a +href="glossaries-user.html#dx1-19062" >693</a>, <a +href="glossaries-user.html#dx1-20001" ><span +class="ecti-1000">694</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\glspostdescription</span></span></span>  <a +href="glossaries-user.html#dx1-45034" ><span +class="ecti-1000">695</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\glsquote</span></span></span>  <a +href="glossaries-user.html#dx1-34014" ><span +class="ecti-1000">696</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\glsrefentry</span></span></span>  <a +href="glossaries-user.html#dx1-4044" >697</a>, <a +href="glossaries-user.html#dx1-15005" ><span +class="ecti-1000">698</span></a>, <a +href="glossaries-user.html#dx1-15024" >699</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\glsreset</span></span></span>  <a +href="glossaries-user.html#dx1-39043" >700</a>, <a +href="glossaries-user.html#dx1-44006" ><span +class="ecti-1000">701</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\glsresetall</span></span></span>  <a +href="glossaries-user.html#dx1-44010" ><span +class="ecti-1000">702</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\glssee</span></span></span>  <a +href="glossaries-user.html#dx1-15057" >703</a>, <a +href="glossaries-user.html#dx1-26044" >704</a>, <a +href="glossaries-user.html#dx1-30017" ><span +class="ecti-1000">705</span></a>, <a +href="glossaries-user.html#dx1-30027" >706</a>, <a +href="glossaries-user.html#dx1-3002" >707</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\glsseeformat</span></span></span>  <a +href="glossaries-user.html#dx1-2002" >708</a>, <a +href="glossaries-user.html#dx1-31002" ><span +class="ecti-1000">709</span></a>, <a +href="glossaries-user.html#dx1-31018" >710</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\glsseeitemformat</span></span></span>  <a +href="glossaries-user.html#dx1-31012" ><span +class="ecti-1000">711</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\glsseelastsep</span></span></span>  <a +href="glossaries-user.html#dx1-31010" ><span +class="ecti-1000">712</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\glsseelist</span></span></span>  <a +href="glossaries-user.html#dx1-2005" >713</a>, <a +href="glossaries-user.html#dx1-31019" >714</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\glsseesep</span></span></span>  <a +href="glossaries-user.html#dx1-31009" ><span +class="ecti-1000">715</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\glsSetAlphaCompositor</span></span></span>  <a +href="glossaries-user.html#dx1-18030" ><span +class="ecti-1000">716</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\glsSetCompositor</span></span></span>  <a +href="glossaries-user.html#dx1-18027" ><span +class="ecti-1000">717</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\glsSetSuffixF</span></span></span>  <a +href="glossaries-user.html#dx1-25019" ><span +class="ecti-1000">718</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\glsSetSuffixFF</span></span></span>  <a +href="glossaries-user.html#dx1-25020" ><span +class="ecti-1000">719</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\glssetwidest</span></span></span>  <a +href="glossaries-user.html#dx1-51033" ><span +class="ecti-1000">720</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\GlsSetXdyCodePage</span></span></span>  <a +href="glossaries-user.html#dx1-7090" >721</a>, <a +href="glossaries-user.html#dx1-35013" ><span +class="ecti-1000">722</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\GlsSetXdyFirstLetterAfterDigits</span></span></span>  <a +href="glossaries-user.html#dx1-37002" ><span +class="ecti-1000">723</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\GlsSetXdyLanguage</span></span></span>  <a +href="glossaries-user.html#dx1-7089" >724</a>, <a +href="glossaries-user.html#dx1-35010" ><span +class="ecti-1000">725</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\GlsSetXdyLocationClassOrder</span></span></span>  <a +href="glossaries-user.html#dx1-36051" ><span +class="ecti-1000">726</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\GlsSetXdyMinRangeLength</span></span></span>  <a +href="glossaries-user.html#dx1-25012" >727</a>, <a +href="glossaries-user.html#dx1-36057" ><span +class="ecti-1000">728</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\glsshorttok</span></span></span>  <a +href="glossaries-user.html#dx1-42005" >729</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\glssubentrycounterlabel</span></span></span>  <a +href="glossaries-user.html#dx1-52061" ><span +class="ecti-1000">730</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\glssubentryitem</span></span></span>  <a +href="glossaries-user.html#dx1-52058" ><span +class="ecti-1000">731</span></a>, <a +href="glossaries-user.html#dx1-53011" >732</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\GLSsymbol</span></span></span>  <a +href="glossaries-user.html#dx1-26138" ><span +class="ecti-1000">733</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\Glssymbol</span></span></span>  <a +href="glossaries-user.html#dx1-26137" ><span +class="ecti-1000">734</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\glssymbol</span></span></span>  <a +href="glossaries-user.html#dx1-26130" ><span +class="ecti-1000">735</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\glssymbolsgroupname</span></span></span>  <a +href="glossaries-user.html#dx1-6021" >736</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\glstarget</span></span></span>  <a +href="glossaries-user.html#dx1-52043" ><span +class="ecti-1000">737</span></a>, <a +href="glossaries-user.html#dx1-52060" >738</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\GLStext</span></span></span>  <a +href="glossaries-user.html#dx1-26105" ><span +class="ecti-1000">739</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\Glstext</span></span></span>  <a +href="glossaries-user.html#dx1-26104" ><span +class="ecti-1000">740</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\glstext</span></span></span>  <a +href="glossaries-user.html#dx1-5021" >741</a>, <a +href="glossaries-user.html#dx1-26098" ><span +class="ecti-1000">742</span></a>, <a +href="glossaries-user.html#dx1-26112" >743</a>, <a +href="glossaries-user.html#dx1-26117" >744</a>, <a +href="glossaries-user.html#dx1-26122" >745</a>, <a +href="glossaries-user.html#dx1-26131" >746</a>, <a +href="glossaries-user.html#dx1-26140" >747</a>, <a +href="glossaries-user.html#dx1-26149" >748</a>, <a +href="glossaries-user.html#dx1-39062" >749</a>, <a +href="glossaries-user.html#dx1-39066" >750</a>, <a +href="glossaries-user.html#dx1-57065" >751</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\glstextformat</span></span></span>  <a +href="glossaries-user.html#dx1-26014" ><span +class="ecti-1000">752</span></a>, <a +href="glossaries-user.html#dx1-27029" >753</a>, <a +href="glossaries-user.html#dx1-32001" >754</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\glstocfalse</span></span></span>  <a +href="glossaries-user.html#dx1-14003" ><span +class="ecti-1000">755</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\glstoctrue</span></span></span>  <a +href="glossaries-user.html#dx1-14002" ><span +class="ecti-1000">756</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\glstreeindent</span></span></span>  <a +href="glossaries-user.html#dx1-51017" ><span +class="ecti-1000">757</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\glsunset</span></span></span>  <a +href="glossaries-user.html#dx1-44008" ><span +class="ecti-1000">758</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\glsunsetall</span></span></span>  <a +href="glossaries-user.html#dx1-44012" ><span +class="ecti-1000">759</span></a> <br /></span> + + + +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\GLSuseri</span></span></span>  <a +href="glossaries-user.html#dx1-26152" ><span +class="ecti-1000">760</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\Glsuseri</span></span></span>  <a +href="glossaries-user.html#dx1-26151" ><span +class="ecti-1000">761</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\glsuseri</span></span></span>  <a +href="glossaries-user.html#dx1-26148" ><span +class="ecti-1000">762</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\GLSuserii</span></span></span>  <a +href="glossaries-user.html#dx1-26155" ><span +class="ecti-1000">763</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\Glsuserii</span></span></span>  <a +href="glossaries-user.html#dx1-26154" ><span +class="ecti-1000">764</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\glsuserii</span></span></span>  <a +href="glossaries-user.html#dx1-26153" ><span +class="ecti-1000">765</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\GLSuseriii</span></span></span>  <a +href="glossaries-user.html#dx1-26158" ><span +class="ecti-1000">766</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\Glsuseriii</span></span></span>  <a +href="glossaries-user.html#dx1-26157" ><span +class="ecti-1000">767</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\glsuseriii</span></span></span>  <a +href="glossaries-user.html#dx1-26156" ><span +class="ecti-1000">768</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\GLSuseriv</span></span></span>  <a +href="glossaries-user.html#dx1-26161" ><span +class="ecti-1000">769</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\Glsuseriv</span></span></span>  <a +href="glossaries-user.html#dx1-26160" ><span +class="ecti-1000">770</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\glsuseriv</span></span></span>  <a +href="glossaries-user.html#dx1-26159" ><span +class="ecti-1000">771</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\GLSuserv</span></span></span>  <a +href="glossaries-user.html#dx1-26164" ><span +class="ecti-1000">772</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\Glsuserv</span></span></span>  <a +href="glossaries-user.html#dx1-26163" ><span +class="ecti-1000">773</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\glsuserv</span></span></span>  <a +href="glossaries-user.html#dx1-26162" ><span +class="ecti-1000">774</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\GLSuservi</span></span></span>  <a +href="glossaries-user.html#dx1-26167" ><span +class="ecti-1000">775</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\Glsuservi</span></span></span>  <a +href="glossaries-user.html#dx1-26166" ><span +class="ecti-1000">776</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\glsuservi</span></span></span>  <a +href="glossaries-user.html#dx1-26165" ><span +class="ecti-1000">777</span></a> <br /></span> +</p><p class="theindex"> <span +class="ecbx-1000">H</span> +<span class="index-item"><span +class="ecss-1000">html </span>package  <a +href="glossaries-user.html#dx1-28002" >778</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\hyperbf</span></span></span>  <a +href="glossaries-user.html#dx1-26051" >779</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\hyperbsf</span></span></span>  <a +href="glossaries-user.html#dx1-26059" >780</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\hyperemph</span></span></span>  <a +href="glossaries-user.html#dx1-26057" >781</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\hyperit</span></span></span>  <a +href="glossaries-user.html#dx1-26053" >782</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\hyperlink</span></span></span>  <a +href="glossaries-user.html#dx1-26058" >783</a>, <a +href="glossaries-user.html#dx1-26065" >784</a>, <a +href="glossaries-user.html#dx1-28008" >785</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\hypermd</span></span></span>  <a +href="glossaries-user.html#dx1-26052" >786</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\hyperpage</span></span></span>  <a +href="glossaries-user.html#dx1-26045" >787</a> <br /></span> +<span class="index-item"><span +class="ecss-1000">hyperref </span>package  <a +href="glossaries-user.html#dx1-5" >788</a>, <a +href="glossaries-user.html#dx1-6" >789</a>, <a +href="glossaries-user.html#dx1-25023" >790</a>, <a +href="glossaries-user.html#dx1-26010" >791</a>, <a +href="glossaries-user.html#dx1-26046" >792</a>, <a +href="glossaries-user.html#dx1-26086" >793</a>, <a +href="glossaries-user.html#dx1-28001" >794</a>, <a +href="glossaries-user.html#dx1-28010" >795</a>, <a +href="glossaries-user.html#dx1-36030" >796</a>, <a +href="glossaries-user.html#dx1-36039" >797</a>, <a +href="glossaries-user.html#dx1-42058" >798</a>, <a +href="glossaries-user.html#dx1-52044" >799</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\hyperrm</span></span></span>  <a +href="glossaries-user.html#dx1-26048" >800</a>, <a +href="glossaries-user.html#dx1-36014" >801</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\hypersc</span></span></span>  <a +href="glossaries-user.html#dx1-26056" >802</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\hypersf</span></span></span>  <a +href="glossaries-user.html#dx1-26049" >803</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\hypersl</span></span></span>  <a +href="glossaries-user.html#dx1-26054" >804</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\hypertarget</span></span></span>  <a +href="glossaries-user.html#dx1-28009" >805</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\hypertt</span></span></span>  <a +href="glossaries-user.html#dx1-26050" >806</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\hyperup</span></span></span>  <a +href="glossaries-user.html#dx1-26055" >807</a> <br /></span> +</p><p class="theindex"> <span +class="ecbx-1000">I</span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\ifglsused</span></span></span>  <a +href="glossaries-user.html#dx1-44015" ><span +class="ecti-1000">808</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\index</span></span></span>  <a +href="glossaries-user.html#dx1-26029" >809</a>, <a +href="glossaries-user.html#dx1-26030" >810</a>, <a +href="glossaries-user.html#dx1-26031" >811</a>, <a +href="glossaries-user.html#dx1-26042" >812</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\indexspace</span></span></span>  <a +href="glossaries-user.html#dx1-46012" >813</a>, <a +href="glossaries-user.html#dx1-51005" >814</a>, <a +href="glossaries-user.html#dx1-52034" >815</a>, <a +href="glossaries-user.html#dx1-54004" >816</a> <br /></span> +<span class="index-item"><span +class="ecss-1000">inputenc </span>package  <a +href="glossaries-user.html#dx1-4055" >817</a>, <a +href="glossaries-user.html#dx1-5024" >818</a>, <a +href="glossaries-user.html#dx1-19127" >819</a>, <a +href="glossaries-user.html#dx1-35011" >820</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\inputencodingname</span></span></span>  <a +href="glossaries-user.html#dx1-35012" >821</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\item</span></span></span>  <a +href="glossaries-user.html#dx1-46009" >822</a>, <a +href="glossaries-user.html#dx1-46018" >823</a> <br /></span> + + + +<span class="index-item"><span +class="ectt-1000">itemize </span>(environment)  <a +href="glossaries-user.html#dx1-53001" >824</a> <br /></span> +</p><p class="theindex"> <span +class="ecbx-1000">J</span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\jobname</span></span></span>  <a +href="glossaries-user.html#dx1-18015" >825</a>, <a +href="glossaries-user.html#dx1-18019" >826</a> <br /></span> +</p><p class="theindex"> <span +class="ecbx-1000">L</span> +<span class="index-item">link text  <a +href="glossaries-user.html#dx1-2023" ><span +class="ecbx-1000">827</span></a>, <a +href="glossaries-user.html#dx1-26003" >828</a>, <a +href="glossaries-user.html#dx1-26013" >829</a>, <a +href="glossaries-user.html#dx1-26016" >830</a>, <a +href="glossaries-user.html#dx1-26069" >831</a>, <a +href="glossaries-user.html#dx1-27002" >832</a>, <a +href="glossaries-user.html#dx1-27028" >833</a>, <a +href="glossaries-user.html#dx1-27041" >834</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\loadglsentries</span></span></span>  <a +href="glossaries-user.html#dx1-24001" ><span +class="ecti-1000">835</span></a>, <a +href="glossaries-user.html#dx1-39038" >836</a>, <a +href="glossaries-user.html#dx1-19004" >837</a> <br /></span> +<span class="index-item">location list  <span +class="ecti-1000">see </span><a +href="glossaries-user.html#dx1-25005" >number list</a> <br /></span> +<span class="index-item"><span +class="ectt-1000">longtable </span>(environment)  <a +href="glossaries-user.html#dx1-47002" >839</a>, <a +href="glossaries-user.html#dx1-47007" >840</a>, <a +href="glossaries-user.html#dx1-48003" >841</a>, <a +href="glossaries-user.html#dx1-49006" >842</a>, <a +href="glossaries-user.html#dx1-55006" >843</a>, <a +href="glossaries-user.html#dx1-33039" >844</a> <br /></span> +<span class="index-item"><span +class="ecss-1000">longtable </span>package  <a +href="glossaries-user.html#dx1-15033" >845</a>, <a +href="glossaries-user.html#dx1-47009" >846</a> <br /></span> +</p><p class="theindex"> <span +class="ecbx-1000">M</span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\makefirstuc</span></span></span>  <a +href="glossaries-user.html#dx1-27019" >847</a>, <a +href="glossaries-user.html#dx1-27021" >848</a>, <a +href="glossaries-user.html#dx1-40039" >849</a> <br /></span> +<span class="index-item">makeglossaries  <a +href="glossaries-user.html#dx1-2027" ><span +class="ecbx-1000">850</span></a> <br /></span> +<span class="index-item"><span +class="ectt-1000">makeglossaries</span>  <a +href="glossaries-user.html#dx1-3007" >851</a>, <a +href="glossaries-user.html#dx1-3013" >852</a>, <a +href="glossaries-user.html#dx1-4007" >853</a>, <a +href="glossaries-user.html#dx1-4017" >854</a>, <a +href="glossaries-user.html#dx1-4027" >855</a>, <a +href="glossaries-user.html#dx1-4039" >856</a>, <a +href="glossaries-user.html#dx1-4048" >857</a>, <a +href="glossaries-user.html#dx1-4057" >858</a>, <a +href="glossaries-user.html#dx1-4061" >859</a>, <a +href="glossaries-user.html#dx1-4063" >860</a>, <a +href="glossaries-user.html#dx1-4068" >861</a>, <a +href="glossaries-user.html#dx1-4072" >862</a>, <a +href="glossaries-user.html#dx1-4082" >863</a>, <a +href="glossaries-user.html#dx1-4085" >864</a>, <a +href="glossaries-user.html#dx1-5026" >865</a>, <a +href="glossaries-user.html#dx1-5030" >866</a>, <a +href="glossaries-user.html#dx1-7016" >867</a>, <a +href="glossaries-user.html#dx1-7023" >868</a>, <a +href="glossaries-user.html#dx1-7029" >869</a>, <a +href="glossaries-user.html#dx1-7035" >870</a>, <a +href="glossaries-user.html#dx1-7045" >871</a>, <a +href="glossaries-user.html#dx1-7052" >872</a>, <a +href="glossaries-user.html#dx1-7054" >873</a>, <a +href="glossaries-user.html#dx1-7064" >874</a>, <a +href="glossaries-user.html#dx1-7070" >875</a>, <a +href="glossaries-user.html#dx1-7074" >876</a>, <a +href="glossaries-user.html#dx1-8002" >877</a>, <a +href="glossaries-user.html#dx1-8009" >878</a>, <a +href="glossaries-user.html#dx1-8011" >879</a>, <a +href="glossaries-user.html#dx1-8013" >880</a>, <a +href="glossaries-user.html#dx1-8015" >881</a>, <a +href="glossaries-user.html#dx1-8018" >882</a>, <a +href="glossaries-user.html#dx1-9007" >883</a>, <a +href="glossaries-user.html#dx1-9025" >884</a>, <a +href="glossaries-user.html#dx1-9029" >885</a>, <a +href="glossaries-user.html#dx1-9033" >886</a>, <a +href="glossaries-user.html#dx1-10023" >887</a>, <a +href="glossaries-user.html#dx1-10027" >888</a>, <a +href="glossaries-user.html#dx1-10031" >889</a>, <a +href="glossaries-user.html#dx1-15007" >890</a>, <a +href="glossaries-user.html#dx1-16017" >891</a>, <a +href="glossaries-user.html#dx1-16022" >892</a>, <a +href="glossaries-user.html#dx1-16026" >893</a>, <a +href="glossaries-user.html#dx1-16036" >894</a>, <a +href="glossaries-user.html#dx1-16040" >895</a>, <a +href="glossaries-user.html#dx1-19010" >896</a>, <a +href="glossaries-user.html#dx1-30005" >897</a>, <a +href="glossaries-user.html#dx1-33003" >898</a>, <a +href="glossaries-user.html#dx1-35006" >899</a>, <a +href="glossaries-user.html#dx1-35018" >900</a>, <a +href="glossaries-user.html#dx1-35022" >901</a>, <a +href="glossaries-user.html#dx1-38009" >902</a>, <a +href="glossaries-user.html#dx1-57043" >903</a>, <a +href="glossaries-user.html#dx1-57045" >904</a>, <a +href="glossaries-user.html#dx1-57076" >905</a>, <a +href="glossaries-user.html#dx1-57078" >906</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\makeglossaries</span></span></span>  <a +href="glossaries-user.html#dx1-7021" >907</a>, <a +href="glossaries-user.html#dx1-18001" ><span +class="ecti-1000">908</span></a>, <a +href="glossaries-user.html#dx1-25013" >909</a>, <a +href="glossaries-user.html#dx1-25025" >910</a>, <a +href="glossaries-user.html#dx1-33012" >911</a>, <a +href="glossaries-user.html#dx1-36010" >912</a>, <a +href="glossaries-user.html#dx1-36022" >913</a>, <a +href="glossaries-user.html#dx1-36023" >914</a>, <a +href="glossaries-user.html#dx1-36028" >915</a>, <a +href="glossaries-user.html#dx1-36029" >916</a>, <a +href="glossaries-user.html#dx1-36053" >917</a>, <a +href="glossaries-user.html#dx1-36054" >918</a>, <a +href="glossaries-user.html#dx1-36061" >919</a>, <a +href="glossaries-user.html#dx1-36062" >920</a>, <a +href="glossaries-user.html#dx1-37004" >921</a>, <a +href="glossaries-user.html#dx1-37005" >922</a>, <a +href="glossaries-user.html#dx1-38016" >923</a>, <a +href="glossaries-user.html#dx1-57072" >924</a> <br /></span> +<span class="index-item">makeindex  <a +href="glossaries-user.html#dx1-2033" ><span +class="ecbx-1000">925</span></a> <br /></span> +<span class="index-item"><span +class="ectt-1000">makeindex</span>  <a +href="glossaries-user.html#dx1-2032" >926</a>, <a +href="glossaries-user.html#dx1-3009" >927</a>, <a +href="glossaries-user.html#dx1-3015" >928</a>, <a +href="glossaries-user.html#dx1-4009" >929</a>, <a +href="glossaries-user.html#dx1-4011" >930</a>, <a +href="glossaries-user.html#dx1-4015" >931</a>, <a +href="glossaries-user.html#dx1-4025" >932</a>, <a +href="glossaries-user.html#dx1-4037" >933</a>, <a +href="glossaries-user.html#dx1-4050" >934</a>, <a +href="glossaries-user.html#dx1-4054" >935</a>, <a +href="glossaries-user.html#dx1-4076" >936</a>, <a +href="glossaries-user.html#dx1-4087" >937</a>, <a +href="glossaries-user.html#dx1-5004" >938</a>, <a +href="glossaries-user.html#dx1-5008" >939</a>, <a +href="glossaries-user.html#dx1-6039" >940</a>, <a +href="glossaries-user.html#dx1-7002" >941</a>, <a +href="glossaries-user.html#dx1-7006" >942</a>, <a +href="glossaries-user.html#dx1-7010" >943</a>, <a +href="glossaries-user.html#dx1-7018" >944</a>, <a +href="glossaries-user.html#dx1-7025" >945</a>, <a +href="glossaries-user.html#dx1-7031" >946</a>, <a +href="glossaries-user.html#dx1-7037" >947</a>, <a +href="glossaries-user.html#dx1-7041" >948</a>, <a +href="glossaries-user.html#dx1-7050" >949</a>, <a +href="glossaries-user.html#dx1-7056" >950</a>, <a +href="glossaries-user.html#dx1-7066" >951</a>, <a +href="glossaries-user.html#dx1-7078" >952</a>, <a +href="glossaries-user.html#dx1-7083" >953</a>, <a +href="glossaries-user.html#dx1-8007" >954</a>, <a +href="glossaries-user.html#dx1-10002" >955</a>, <a +href="glossaries-user.html#dx1-10005" >956</a>, <a +href="glossaries-user.html#dx1-10009" >957</a>, <a +href="glossaries-user.html#dx1-10013" >958</a>, <a +href="glossaries-user.html#dx1-10016" >959</a>, <a +href="glossaries-user.html#dx1-10025" >960</a>, <a +href="glossaries-user.html#dx1-10029" >961</a>, <a +href="glossaries-user.html#dx1-11004" >962</a>, <a +href="glossaries-user.html#dx1-11008" >963</a>, <a +href="glossaries-user.html#dx1-11019" >964</a>, <a +href="glossaries-user.html#dx1-13033" >965</a>, <a +href="glossaries-user.html#dx1-13038" >966</a>, <a +href="glossaries-user.html#dx1-15009" >967</a>, <a +href="glossaries-user.html#dx1-16020" >968</a>, <a +href="glossaries-user.html#dx1-16024" >969</a>, <a +href="glossaries-user.html#dx1-16028" >970</a>, <a +href="glossaries-user.html#dx1-16044" >971</a>, <a +href="glossaries-user.html#dx1-18003" >972</a>, <a +href="glossaries-user.html#dx1-18011" >973</a>, <a +href="glossaries-user.html#dx1-18018" >974</a>, <a +href="glossaries-user.html#dx1-19012" >975</a>, <a +href="glossaries-user.html#dx1-19089" >976</a>, <a +href="glossaries-user.html#dx1-19130" >977</a>, <a +href="glossaries-user.html#dx1-21005" >978</a>, <a +href="glossaries-user.html#dx1-25007" >979</a>, <a +href="glossaries-user.html#dx1-25016" >980</a>, <a +href="glossaries-user.html#dx1-26005" >981</a>, <a +href="glossaries-user.html#dx1-26028" >982</a>, <a +href="glossaries-user.html#dx1-26037" >983</a>, <a +href="glossaries-user.html#dx1-33005" >984</a>, <a +href="glossaries-user.html#dx1-33009" >985</a>, <a +href="glossaries-user.html#dx1-38005" >986</a>, <a +href="glossaries-user.html#dx1-45010" >987</a>, <a +href="glossaries-user.html#dx1-51014" >988</a>, <a +href="glossaries-user.html#dx1-52022" >989</a>, <a +href="glossaries-user.html#dx1-57049" >990</a>, <a +href="glossaries-user.html#dx1-57087" >991</a>, <a +href="glossaries-user.html#dx1-31005" >992</a> <br /></span> +<span class="index-item"><span +class="ecss-1000">memoir </span>class  <a +href="glossaries-user.html#dx1-14014" >993</a> <br /></span> +<span class="index-item"><span +class="ecss-1000">mfirstuc </span>package  <a +href="glossaries-user.html#dx1-3" >994</a>, <a +href="glossaries-user.html#dx1-4" >995</a>, <a +href="glossaries-user.html#dx1-27020" >996</a> <br /></span> +</p><p class="theindex"> <span +class="ecbx-1000">N</span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\newacronym</span></span></span>  <a +href="glossaries-user.html#dx1-4020" >997</a>, <a +href="glossaries-user.html#dx1-17009" >998</a>, <a +href="glossaries-user.html#dx1-17015" >999</a>, <a +href="glossaries-user.html#dx1-17017" >1000</a>, <a +href="glossaries-user.html#dx1-17019" >1001</a>, <a +href="glossaries-user.html#dx1-17021" >1002</a>, <a +href="glossaries-user.html#dx1-17026" >1003</a>, <a +href="glossaries-user.html#dx1-19100" >1004</a>, <a +href="glossaries-user.html#dx1-19120" >1005</a>, <a +href="glossaries-user.html#dx1-24006" >1006</a>, <a +href="glossaries-user.html#dx1-39002" ><span +class="ecti-1000">1007</span></a>, <a +href="glossaries-user.html#dx1-39032" >1008</a>, <a +href="glossaries-user.html#dx1-39039" >1009</a>, <a +href="glossaries-user.html#dx1-39040" >1010</a>, <a +href="glossaries-user.html#dx1-40018" >1011</a>, <a +href="glossaries-user.html#dx1-42003" >1012</a>, <a +href="glossaries-user.html#dx1-42019" >1013</a>, <a +href="glossaries-user.html#dx1-42027" >1014</a>, <a +href="glossaries-user.html#dx1-42034" >1015</a>, <a +href="glossaries-user.html#dx1-43006" >1016</a>, <a +href="glossaries-user.html#dx1-52038" >1017</a>, <a +href="glossaries-user.html#dx1-56023" >1018</a>, <a +href="glossaries-user.html#dx1-56026" >1019</a>, <a +href="glossaries-user.html#dx1-56029" >1020</a>, <a +href="glossaries-user.html#dx1-56032" >1021</a>, <a +href="glossaries-user.html#dx1-19003" >1022</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\newdualentry</span></span></span>  <a +href="glossaries-user.html#dx1-29010" >1023</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\newglossary</span></span></span>  <a +href="glossaries-user.html#dx1-9023" >1024</a>, <a +href="glossaries-user.html#dx1-10021" >1025</a>, <a +href="glossaries-user.html#dx1-13004" >1026</a>, <a +href="glossaries-user.html#dx1-36007" >1027</a>, <a +href="glossaries-user.html#dx1-36037" >1028</a>, <a +href="glossaries-user.html#dx1-38001" ><span +class="ecti-1000">1029</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\newglossaryentry</span></span></span>  <a +href="glossaries-user.html#dx1-2021" >1030</a>, <a +href="glossaries-user.html#dx1-4019" >1031</a>, <a +href="glossaries-user.html#dx1-15056" >1032</a>, <a +href="glossaries-user.html#dx1-16004" >1033</a>, <a +href="glossaries-user.html#dx1-19017" ><span +class="ecti-1000">1034</span></a>, <a +href="glossaries-user.html#dx1-19098" >1035</a>, <a +href="glossaries-user.html#dx1-24002" >1036</a>, <a +href="glossaries-user.html#dx1-24005" >1037</a>, <a +href="glossaries-user.html#dx1-26001" >1038</a>, <a +href="glossaries-user.html#dx1-26072" >1039</a>, <a +href="glossaries-user.html#dx1-39003" >1040</a>, <a +href="glossaries-user.html#dx1-39031" >1041</a>, <a +href="glossaries-user.html#dx1-39041" >1042</a>, <a +href="glossaries-user.html#dx1-42002" >1043</a>, <a +href="glossaries-user.html#dx1-42020" >1044</a>, <a +href="glossaries-user.html#dx1-52037" >1045</a>, <a +href="glossaries-user.html#dx1-19002" >1046</a> <br /></span> +<span class="index-item"><span +class="ectt-1000">\newglossaryentry </span>options<br /></span> +<span class="index-subitem">    <span +class="ecss-1000">access</span>  <a +href="glossaries-user.html#dx1-56003" >1047</a> <br /></span> +<span class="index-subitem">    <span +class="ecss-1000">description</span>  <a +href="glossaries-user.html#dx1-2039" >1048</a>, <a +href="glossaries-user.html#dx1-13009" >1049</a>, <a +href="glossaries-user.html#dx1-13012" >1050</a>, <a +href="glossaries-user.html#dx1-13017" >1051</a>, <a +href="glossaries-user.html#dx1-19018" >1052</a>, <a +href="glossaries-user.html#dx1-19023" >1053</a>, <a +href="glossaries-user.html#dx1-19034" >1054</a>, <a +href="glossaries-user.html#dx1-26141" >1055</a>, <a +href="glossaries-user.html#dx1-26142" >1056</a>, <a +href="glossaries-user.html#dx1-26145" >1057</a>, <a +href="glossaries-user.html#dx1-27012" >1058</a>, <a +href="glossaries-user.html#dx1-39009" >1059</a>, <a +href="glossaries-user.html#dx1-39015" >1060</a>, <a +href="glossaries-user.html#dx1-39016" >1061</a>, <a +href="glossaries-user.html#dx1-40017" >1062</a>, <a +href="glossaries-user.html#dx1-41004" >1063</a>, <a +href="glossaries-user.html#dx1-41015" >1064</a>, <a +href="glossaries-user.html#dx1-42013" >1065</a>, <a +href="glossaries-user.html#dx1-42051" >1066</a>, <a +href="glossaries-user.html#dx1-56018" >1067</a>, <a +href="glossaries-user.html#dx1-57069" >1068</a>, <a +href="glossaries-user.html#dx1-7062" >1069</a> <br /></span> +<span class="index-subitem">    <span +class="ecss-1000">descriptionaccess</span>  <a +href="glossaries-user.html#dx1-56017" >1070</a> <br /></span> +<span class="index-subitem">    <span +class="ecss-1000">descriptionplural</span>  <a +href="glossaries-user.html#dx1-19028" >1071</a>, <a +href="glossaries-user.html#dx1-27013" >1072</a>, <a +href="glossaries-user.html#dx1-56020" >1073</a> <br /></span> +<span class="index-subitem">    <span +class="ecss-1000">descriptionpluralaccess</span>  <a +href="glossaries-user.html#dx1-56019" >1074</a> <br /></span> +<span class="index-subitem">    <span +class="ecss-1000">first</span>  <a +href="glossaries-user.html#dx1-2019" >1075</a>, <a +href="glossaries-user.html#dx1-19041" >1076</a>, <a +href="glossaries-user.html#dx1-19061" >1077</a>, <a +href="glossaries-user.html#dx1-19063" >1078</a>, <a +href="glossaries-user.html#dx1-19064" >1079</a>, <a +href="glossaries-user.html#dx1-19072" >1080</a>, <a +href="glossaries-user.html#dx1-19075" >1081</a>, <a +href="glossaries-user.html#dx1-26020" >1082</a>, <a +href="glossaries-user.html#dx1-26071" >1083</a>, <a +href="glossaries-user.html#dx1-26075" >1084</a>, <a +href="glossaries-user.html#dx1-26093" >1085</a>, <a +href="glossaries-user.html#dx1-26107" >1086</a>, <a +href="glossaries-user.html#dx1-27010" >1087</a>, <a +href="glossaries-user.html#dx1-32016" >1088</a>, <a +href="glossaries-user.html#dx1-39005" >1089</a>, <a +href="glossaries-user.html#dx1-39029" >1090</a>, <a +href="glossaries-user.html#dx1-42008" >1091</a>, <a +href="glossaries-user.html#dx1-42047" >1092</a>, <a +href="glossaries-user.html#dx1-44003" >1093</a>, <a +href="glossaries-user.html#dx1-56008" >1094</a> <br /></span> +<span class="index-subitem">    <span +class="ecss-1000">firstaccess</span>  <a +href="glossaries-user.html#dx1-56007" >1095</a> <br /></span> +<span class="index-subitem">    <span +class="ecss-1000">firstplural</span>  <a +href="glossaries-user.html#dx1-2020" >1096</a>, <a +href="glossaries-user.html#dx1-19050" >1097</a>, <a +href="glossaries-user.html#dx1-19057" >1098</a>, <a +href="glossaries-user.html#dx1-19069" >1099</a>, <a +href="glossaries-user.html#dx1-19071" >1100</a>, <a +href="glossaries-user.html#dx1-19074" >1101</a>, <a +href="glossaries-user.html#dx1-20004" >1102</a>, <a +href="glossaries-user.html#dx1-26085" >1103</a>, <a +href="glossaries-user.html#dx1-26118" >1104</a>, <a +href="glossaries-user.html#dx1-27011" >1105</a>, <a +href="glossaries-user.html#dx1-32020" >1106</a>, <a +href="glossaries-user.html#dx1-42009" >1107</a>, <a +href="glossaries-user.html#dx1-42048" >1108</a>, <a +href="glossaries-user.html#dx1-56012" >1109</a> <br /></span> +<span class="index-subitem">    <span +class="ecss-1000">firstpluralaccess</span>  <a +href="glossaries-user.html#dx1-56011" >1110</a> <br /></span> + + + +<span class="index-subitem">    <span +class="ecss-1000">format</span>  <a +href="glossaries-user.html#dx1-26060" >1111</a> <br /></span> +<span class="index-subitem">    <span +class="ecss-1000">long</span>  <a +href="glossaries-user.html#dx1-19121" >1112</a>, <a +href="glossaries-user.html#dx1-42036" >1113</a>, <a +href="glossaries-user.html#dx1-56022" >1114</a> <br /></span> +<span class="index-subitem">    <span +class="ecss-1000">longaccess</span>  <a +href="glossaries-user.html#dx1-56021" >1115</a> <br /></span> +<span class="index-subitem">    <span +class="ecss-1000">longplural</span>  <a +href="glossaries-user.html#dx1-19122" >1116</a>, <a +href="glossaries-user.html#dx1-39012" >1117</a>, <a +href="glossaries-user.html#dx1-42038" >1118</a>, <a +href="glossaries-user.html#dx1-56028" >1119</a> <br /></span> +<span class="index-subitem">    <span +class="ecss-1000">longpluralaccess</span>  <a +href="glossaries-user.html#dx1-56027" >1120</a> <br /></span> +<span class="index-subitem">    <span +class="ecss-1000">name</span>  <a +href="glossaries-user.html#dx1-2038" >1121</a>, <a +href="glossaries-user.html#dx1-5017" >1122</a>, <a +href="glossaries-user.html#dx1-13008" >1123</a>, <a +href="glossaries-user.html#dx1-13013" >1124</a>, <a +href="glossaries-user.html#dx1-13016" >1125</a>, <a +href="glossaries-user.html#dx1-13024" >1126</a>, <a +href="glossaries-user.html#dx1-13025" >1127</a>, <a +href="glossaries-user.html#dx1-16005" >1128</a>, <a +href="glossaries-user.html#dx1-19019" >1129</a>, <a +href="glossaries-user.html#dx1-19021" >1130</a>, <a +href="glossaries-user.html#dx1-19040" >1131</a>, <a +href="glossaries-user.html#dx1-19092" >1132</a>, <a +href="glossaries-user.html#dx1-19094" >1133</a>, <a +href="glossaries-user.html#dx1-23001" >1134</a>, <a +href="glossaries-user.html#dx1-26123" >1135</a>, <a +href="glossaries-user.html#dx1-26124" >1136</a>, <a +href="glossaries-user.html#dx1-26127" >1137</a>, <a +href="glossaries-user.html#dx1-32006" >1138</a>, <a +href="glossaries-user.html#dx1-41003" >1139</a>, <a +href="glossaries-user.html#dx1-41007" >1140</a>, <a +href="glossaries-user.html#dx1-41014" >1141</a>, <a +href="glossaries-user.html#dx1-42007" >1142</a>, <a +href="glossaries-user.html#dx1-42028" >1143</a>, <a +href="glossaries-user.html#dx1-42031" >1144</a>, <a +href="glossaries-user.html#dx1-52024" >1145</a>, <a +href="glossaries-user.html#dx1-56004" >1146</a>, <a +href="glossaries-user.html#dx1-57011" >1147</a>, <a +href="glossaries-user.html#dx1-57066" >1148</a>, <a +href="glossaries-user.html#dx1-31015" >1149</a>, <a +href="glossaries-user.html#dx1-32045" >1150</a> <br /></span> +<span class="index-subitem">    <span +class="ecss-1000">nonumberlist</span>  <a +href="glossaries-user.html#dx1-19107" >1151</a> <br /></span> +<span class="index-subitem">    <span +class="ecss-1000">parent</span>  <a +href="glossaries-user.html#dx1-19020" >1152</a>, <a +href="glossaries-user.html#dx1-19022" >1153</a>, <a +href="glossaries-user.html#dx1-19027" >1154</a>, <a +href="glossaries-user.html#dx1-22001" >1155</a> <br /></span> +<span class="index-subitem">    <span +class="ecss-1000">plural</span>  <a +href="glossaries-user.html#dx1-19052" >1156</a>, <a +href="glossaries-user.html#dx1-19060" >1157</a>, <a +href="glossaries-user.html#dx1-19073" >1158</a>, <a +href="glossaries-user.html#dx1-20002" >1159</a>, <a +href="glossaries-user.html#dx1-20003" >1160</a>, <a +href="glossaries-user.html#dx1-23009" >1161</a>, <a +href="glossaries-user.html#dx1-26084" >1162</a>, <a +href="glossaries-user.html#dx1-26113" >1163</a>, <a +href="glossaries-user.html#dx1-27009" >1164</a>, <a +href="glossaries-user.html#dx1-32012" >1165</a>, <a +href="glossaries-user.html#dx1-42011" >1166</a>, <a +href="glossaries-user.html#dx1-42030" >1167</a>, <a +href="glossaries-user.html#dx1-42050" >1168</a>, <a +href="glossaries-user.html#dx1-56010" >1169</a> <br /></span> +<span class="index-subitem">    <span +class="ecss-1000">pluralaccess</span>  <a +href="glossaries-user.html#dx1-56009" >1170</a> <br /></span> +<span class="index-subitem">    <span +class="ecss-1000">see</span>  <a +href="glossaries-user.html#dx1-15055" >1171</a>, <a +href="glossaries-user.html#dx1-15059" >1172</a>, <a +href="glossaries-user.html#dx1-19114" >1173</a>, <a +href="glossaries-user.html#dx1-19115" >1174</a>, <a +href="glossaries-user.html#dx1-26043" >1175</a>, <a +href="glossaries-user.html#dx1-30011" >1176</a>, <a +href="glossaries-user.html#dx1-30012" >1177</a>, <a +href="glossaries-user.html#dx1-30014" >1178</a>, <a +href="glossaries-user.html#dx1-30026" >1179</a>, <a +href="glossaries-user.html#dx1-31001" >1180</a>, <a +href="glossaries-user.html#dx1-3003" >1181</a>, <a +href="glossaries-user.html#dx1-31008" >1182</a> <br /></span> +<span class="index-subitem">    <span +class="ecss-1000">short</span>  <a +href="glossaries-user.html#dx1-19123" >1183</a>, <a +href="glossaries-user.html#dx1-42035" >1184</a>, <a +href="glossaries-user.html#dx1-56025" >1185</a> <br /></span> +<span class="index-subitem">    <span +class="ecss-1000">shortaccess</span>  <a +href="glossaries-user.html#dx1-56024" >1186</a> <br /></span> +<span class="index-subitem">    <span +class="ecss-1000">shortplural</span>  <a +href="glossaries-user.html#dx1-19124" >1187</a>, <a +href="glossaries-user.html#dx1-39011" >1188</a>, <a +href="glossaries-user.html#dx1-42037" >1189</a>, <a +href="glossaries-user.html#dx1-56031" >1190</a> <br /></span> +<span class="index-subitem">    <span +class="ecss-1000">shortpluralaccess</span>  <a +href="glossaries-user.html#dx1-56030" >1191</a> <br /></span> +<span class="index-subitem">    <span +class="ecss-1000">sort</span>  <a +href="glossaries-user.html#dx1-13019" >1192</a>, <a +href="glossaries-user.html#dx1-16003" >1193</a>, <a +href="glossaries-user.html#dx1-16006" >1194</a>, <a +href="glossaries-user.html#dx1-16008" >1195</a>, <a +href="glossaries-user.html#dx1-16010" >1196</a>, <a +href="glossaries-user.html#dx1-19087" >1197</a>, <a +href="glossaries-user.html#dx1-19093" >1198</a>, <a +href="glossaries-user.html#dx1-19097" >1199</a>, <a +href="glossaries-user.html#dx1-19128" >1200</a>, <a +href="glossaries-user.html#dx1-23005" >1201</a>, <a +href="glossaries-user.html#dx1-52023" >1202</a>, <a +href="glossaries-user.html#dx1-52025" >1203</a>, <a +href="glossaries-user.html#dx1-57010" >1204</a>, <a +href="glossaries-user.html#dx1-57083" >1205</a> <br /></span> +<span class="index-subitem">    <span +class="ecss-1000">symbol</span>  <a +href="glossaries-user.html#dx1-2040" >1206</a>, <a +href="glossaries-user.html#dx1-13010" >1207</a>, <a +href="glossaries-user.html#dx1-13014" >1208</a>, <a +href="glossaries-user.html#dx1-13018" >1209</a>, <a +href="glossaries-user.html#dx1-19076" >1210</a>, <a +href="glossaries-user.html#dx1-19086" >1211</a>, <a +href="glossaries-user.html#dx1-26132" >1212</a>, <a +href="glossaries-user.html#dx1-26133" >1213</a>, <a +href="glossaries-user.html#dx1-26136" >1214</a>, <a +href="glossaries-user.html#dx1-27014" >1215</a>, <a +href="glossaries-user.html#dx1-27025" >1216</a>, <a +href="glossaries-user.html#dx1-27039" >1217</a>, <a +href="glossaries-user.html#dx1-41005" >1218</a>, <a +href="glossaries-user.html#dx1-41016" >1219</a>, <a +href="glossaries-user.html#dx1-42012" >1220</a>, <a +href="glossaries-user.html#dx1-42033" >1221</a>, <a +href="glossaries-user.html#dx1-42052" >1222</a>, <a +href="glossaries-user.html#dx1-56014" >1223</a> <br /></span> +<span class="index-subitem">    <span +class="ecss-1000">symbolaccess</span>  <a +href="glossaries-user.html#dx1-56013" >1224</a> <br /></span> +<span class="index-subitem">    <span +class="ecss-1000">symbolplural</span>  <a +href="glossaries-user.html#dx1-19080" >1225</a>, <a +href="glossaries-user.html#dx1-27015" >1226</a>, <a +href="glossaries-user.html#dx1-56016" >1227</a> <br /></span> +<span class="index-subitem">    <span +class="ecss-1000">symbolpluralaccess</span>  <a +href="glossaries-user.html#dx1-56015" >1228</a> <br /></span> +<span class="index-subitem">    <span +class="ecss-1000">text</span>  <a +href="glossaries-user.html#dx1-13023" >1229</a>, <a +href="glossaries-user.html#dx1-13026" >1230</a>, <a +href="glossaries-user.html#dx1-19038" >1231</a>, <a +href="glossaries-user.html#dx1-19044" >1232</a>, <a +href="glossaries-user.html#dx1-19055" >1233</a>, <a +href="glossaries-user.html#dx1-26021" >1234</a>, <a +href="glossaries-user.html#dx1-26070" >1235</a>, <a +href="glossaries-user.html#dx1-26074" >1236</a>, <a +href="glossaries-user.html#dx1-26094" >1237</a>, <a +href="glossaries-user.html#dx1-26100" >1238</a>, <a +href="glossaries-user.html#dx1-27008" >1239</a>, <a +href="glossaries-user.html#dx1-32009" >1240</a>, <a +href="glossaries-user.html#dx1-39006" >1241</a>, <a +href="glossaries-user.html#dx1-39030" >1242</a>, <a +href="glossaries-user.html#dx1-42010" >1243</a>, <a +href="glossaries-user.html#dx1-42029" >1244</a>, <a +href="glossaries-user.html#dx1-42032" >1245</a>, <a +href="glossaries-user.html#dx1-42049" >1246</a>, <a +href="glossaries-user.html#dx1-44005" >1247</a>, <a +href="glossaries-user.html#dx1-56006" >1248</a> <br /></span> +<span class="index-subitem">    <span +class="ecss-1000">textaccess</span>  <a +href="glossaries-user.html#dx1-56005" >1249</a> <br /></span> +<span class="index-subitem">    <span +class="ecss-1000">type</span>  <a +href="glossaries-user.html#dx1-19099" >1250</a>, <a +href="glossaries-user.html#dx1-24003" >1251</a> <br /></span> +<span class="index-subitem">    <span +class="ecss-1000">user1</span>  <a +href="glossaries-user.html#dx1-1001" >1252</a>, <a +href="glossaries-user.html#dx1-19101" >1253</a>, <a +href="glossaries-user.html#dx1-26150" >1254</a>, <a +href="glossaries-user.html#x1-5500016.3" >1255</a>, <a +href="glossaries-user.html#dx1-55003" >1256</a>, <a +href="glossaries-user.html#dx1-55004" >1257</a> <br /></span> +<span class="index-subitem">    <span +class="ecss-1000">user2</span>  <a +href="glossaries-user.html#dx1-19103" >1258</a>, <a +href="glossaries-user.html#dx1-55005" >1259</a> <br /></span> +<span class="index-subitem">    <span +class="ecss-1000">user3</span>  <a +href="glossaries-user.html#dx1-19104" >1260</a> <br /></span> +<span class="index-subitem">    <span +class="ecss-1000">user4</span>  <a +href="glossaries-user.html#dx1-19105" >1261</a> <br /></span> +<span class="index-subitem">    <span +class="ecss-1000">user5</span>  <a +href="glossaries-user.html#dx1-19106" >1262</a> <br /></span> +<span class="index-subitem">    <span +class="ecss-1000">user6</span>  <a +href="glossaries-user.html#dx1-1002" >1263</a>, <a +href="glossaries-user.html#dx1-19102" >1264</a>, <a +href="glossaries-user.html#x1-5500016.3" >1265</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\newglossarystyle</span></span></span>  <a +href="glossaries-user.html#dx1-45031" >1266</a>, <a +href="glossaries-user.html#dx1-52001" ><span +class="ecti-1000">1267</span></a>, <a +href="glossaries-user.html#dx1-52031" >1268</a>, <a +href="glossaries-user.html#dx1-54002" >1269</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\newline</span></span></span>  <a +href="glossaries-user.html#dx1-19026" >1270</a>, <a +href="glossaries-user.html#dx1-45025" >1271</a> <br /></span> +<span class="index-item"><span +class="ecss-1000">ngerman </span>package  <a +href="glossaries-user.html#dx1-6007" >1272</a>, <a +href="glossaries-user.html#dx1-34013" >1273</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\nohyperpage</span></span></span>  <a +href="glossaries-user.html#dx1-25024" >1274</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\noist</span></span></span>  <a +href="glossaries-user.html#dx1-4064" >1275</a>, <a +href="glossaries-user.html#dx1-18012" ><span +class="ecti-1000">1276</span></a>, <a +href="glossaries-user.html#dx1-25014" >1277</a>, <a +href="glossaries-user.html#dx1-25026" >1278</a>, <a +href="glossaries-user.html#dx1-34019" >1279</a>, <a +href="glossaries-user.html#dx1-35016" >1280</a>, <a +href="glossaries-user.html#dx1-36021" >1281</a>, <a +href="glossaries-user.html#dx1-36027" >1282</a>, <a +href="glossaries-user.html#dx1-36052" >1283</a>, <a +href="glossaries-user.html#dx1-36060" >1284</a>, <a +href="glossaries-user.html#dx1-37003" >1285</a>, <a +href="glossaries-user.html#dx1-19016" >1286</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\nopostdesc</span></span></span>  <a +href="glossaries-user.html#dx1-19024" ><span +class="ecti-1000">1287</span></a>, <a +href="glossaries-user.html#dx1-22002" >1288</a>, <a +href="glossaries-user.html#dx1-23002" >1289</a>, <a +href="glossaries-user.html#dx1-45035" >1290</a> <br /></span> +<span class="index-item">number list  <a +href="glossaries-user.html#dx1-2026" >1291</a>, <a +href="glossaries-user.html#dx1-2034" ><span +class="ecbx-1000">1292</span></a>, <a +href="glossaries-user.html#dx1-4022" >1293</a>, <a +href="glossaries-user.html#dx1-4035" >1294</a>, <a +href="glossaries-user.html#dx1-7072" >1295</a>, <a +href="glossaries-user.html#dx1-15050" >1296</a>, <a +href="glossaries-user.html#dx1-15053" >1297</a>, <a +href="glossaries-user.html#dx1-15064" >1298</a>, <a +href="glossaries-user.html#dx1-18025" >1299</a>, <a +href="glossaries-user.html#dx1-18033" >1300</a>, <a +href="glossaries-user.html#dx1-18035" >1301</a>, <a +href="glossaries-user.html#dx1-19109" >1302</a>, <a +href="glossaries-user.html#dx1-19112" >1303</a>, <a +href="glossaries-user.html#dx1-19117" >1304</a>, <a +href="glossaries-user.html#dx1-21003" >1305</a>, <a +href="glossaries-user.html#dx1-23004" >1306</a>, <a +href="glossaries-user.html#dx1-25002" >1307</a>, <a +href="glossaries-user.html#dx1-26009" >1308</a>, <a +href="glossaries-user.html#dx1-30020" >1309</a>, <a +href="glossaries-user.html#dx1-30022" >1310</a>, <a +href="glossaries-user.html#dx1-30024" >1311</a>, <a +href="glossaries-user.html#dx1-30029" >1312</a>, <a +href="glossaries-user.html#dx1-36003" >1313</a>, <a +href="glossaries-user.html#dx1-36045" >1314</a>, <a +href="glossaries-user.html#dx1-36056" >1315</a>, <a +href="glossaries-user.html#dx1-38003" >1316</a>, <a +href="glossaries-user.html#dx1-46011" >1317</a>, <a +href="glossaries-user.html#dx1-46033" >1318</a>, <a +href="glossaries-user.html#dx1-47011" >1319</a>, <a +href="glossaries-user.html#dx1-47022" >1320</a>, <a +href="glossaries-user.html#dx1-48011" >1321</a>, <a +href="glossaries-user.html#dx1-48022" >1322</a>, <a +href="glossaries-user.html#dx1-49017" >1323</a>, <a +href="glossaries-user.html#dx1-49028" >1324</a>, <a +href="glossaries-user.html#dx1-50014" >1325</a>, <a +href="glossaries-user.html#dx1-50025" >1326</a>, <a +href="glossaries-user.html#dx1-53009" >1327</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\numberline</span></span></span>  <a +href="glossaries-user.html#dx1-14006" >1328</a> <br /></span> +</p><p class="theindex"> <span +class="ecbx-1000">O</span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\oldacronym</span></span></span>  <a +href="glossaries-user.html#dx1-43004" ><span +class="ecti-1000">1329</span></a>, <a +href="glossaries-user.html#dx1-43007" >1330</a> <br /></span> +</p><p class="theindex"> <span +class="ecbx-1000">P</span> + + + +<span class="index-item">package options:<br /></span> +<span class="index-subitem">    <span +class="ecss-1000">acronym</span>  <a +href="glossaries-user.html#dx1-6016" >1331</a>, <a +href="glossaries-user.html#dx1-9018" >1332</a>, <a +href="glossaries-user.html#dx1-9022" >1333</a>, <a +href="glossaries-user.html#dx1-10014" >1334</a>, <a +href="glossaries-user.html#dx1-10020" >1335</a>, <a +href="glossaries-user.html#dx1-13003" >1336</a>, <a +href="glossaries-user.html#dx1-14025" >1337</a>, <a +href="glossaries-user.html#dx1-14026" >1338</a>, <a +href="glossaries-user.html#dx1-17001" >1339</a>, <a +href="glossaries-user.html#dx1-17002" >1340</a>, <a +href="glossaries-user.html#dx1-17013" >1341</a>, <a +href="glossaries-user.html#dx1-24007" >1342</a>, <a +href="glossaries-user.html#dx1-24008" >1343</a>, <a +href="glossaries-user.html#dx1-24013" >1344</a>, <a +href="glossaries-user.html#dx1-29009" >1345</a>, <a +href="glossaries-user.html#dx1-38011" >1346</a>, <a +href="glossaries-user.html#dx1-38012" >1347</a>, <a +href="glossaries-user.html#dx1-38014" >1348</a>, <a +href="glossaries-user.html#dx1-39034" >1349</a>, <a +href="glossaries-user.html#dx1-14023" >1350</a>, <a +href="glossaries-user.html#dx1-17007" >1351</a>, <a +href="glossaries-user.html#dx1-24012" >1352</a> <br /></span> +<span class="index-subitem">    <span +class="ecss-1000">acronymlists</span>  <a +href="glossaries-user.html#dx1-17011" >1353</a>, <a +href="glossaries-user.html#dx1-17012" >1354</a>, <a +href="glossaries-user.html#dx1-38015" >1355</a>, <a +href="glossaries-user.html#dx1-39035" >1356</a> <br /></span> +<span class="index-subitem">    <span +class="ecss-1000">compatible-2.07</span>  <a +href="glossaries-user.html#dx1-18014" >1357</a> <br /></span> +<span class="index-subitem">    <span +class="ecss-1000">counter</span>  <a +href="glossaries-user.html#dx1-15061" >1358</a>, <a +href="glossaries-user.html#dx1-18026" >1359</a>, <a +href="glossaries-user.html#dx1-25004" >1360</a>, <a +href="glossaries-user.html#dx1-36006" >1361</a>, <a +href="glossaries-user.html#dx1-36036" >1362</a> <br /></span> +<span class="index-subsubitem">        <span +class="ecss-1000">page</span>  <a +href="glossaries-user.html#dx1-15062" >1363</a> <br /></span> +<span class="index-subitem">    <span +class="ecss-1000">counterwithin</span>  <a +href="glossaries-user.html#dx1-15012" >1364</a>, <a +href="glossaries-user.html#dx1-15016" >1365</a>, <a +href="glossaries-user.html#dx1-45002" >1366</a>, <a +href="glossaries-user.html#dx1-52041" >1367</a>, <a +href="glossaries-user.html#dx1-53013" >1368</a> <br /></span> +<span class="index-subitem">    <span +class="ecss-1000">description</span>  <a +href="glossaries-user.html#dx1-17014" >1369</a>, <a +href="glossaries-user.html#dx1-39010" >1370</a>, <a +href="glossaries-user.html#dx1-39014" >1371</a>, <a +href="glossaries-user.html#dx1-39049" >1372</a>, <a +href="glossaries-user.html#dx1-40001" >1373</a>, <a +href="glossaries-user.html#dx1-40014" >1374</a>, <a +href="glossaries-user.html#dx1-40024" >1375</a>, <a +href="glossaries-user.html#dx1-40031" >1376</a>, <a +href="glossaries-user.html#dx1-40047" >1377</a>, <a +href="glossaries-user.html#dx1-41006" >1378</a>, <a +href="glossaries-user.html#dx1-41009" >1379</a>, <a +href="glossaries-user.html#dx1-41017" >1380</a>, <a +href="glossaries-user.html#dx1-41020" >1381</a>, <a +href="glossaries-user.html#dx1-41022" >1382</a>, <a +href="glossaries-user.html#dx1-42061" >1383</a> <br /></span> +<span class="index-subitem">    <span +class="ecss-1000">dua</span>  <a +href="glossaries-user.html#dx1-17025" >1384</a>, <a +href="glossaries-user.html#dx1-39028" >1385</a>, <a +href="glossaries-user.html#dx1-40006" >1386</a>, <a +href="glossaries-user.html#dx1-40007" >1387</a>, <a +href="glossaries-user.html#dx1-40046" >1388</a>, <a +href="glossaries-user.html#dx1-41021" >1389</a>, <a +href="glossaries-user.html#dx1-41030" >1390</a> <br /></span> +<span class="index-subitem">    <span +class="ecss-1000">entrycounter</span>  <a +href="glossaries-user.html#dx1-15001" >1391</a>, <a +href="glossaries-user.html#dx1-15023" >1392</a>, <a +href="glossaries-user.html#dx1-45001" >1393</a>, <a +href="glossaries-user.html#dx1-52040" >1394</a>, <a +href="glossaries-user.html#dx1-53012" >1395</a> <br /></span> +<span class="index-subsubitem">        <span +class="ecss-1000">false</span>  <a +href="glossaries-user.html#dx1-15002" >1396</a> <br /></span> +<span class="index-subsubitem">        <span +class="ecss-1000">true</span>  <a +href="glossaries-user.html#dx1-15013" >1397</a> <br /></span> +<span class="index-subitem">    <span +class="ecss-1000">footnote</span>  <a +href="glossaries-user.html#dx1-17016" >1398</a>, <a +href="glossaries-user.html#dx1-39017" >1399</a>, <a +href="glossaries-user.html#dx1-39036" >1400</a>, <a +href="glossaries-user.html#dx1-39050" >1401</a>, <a +href="glossaries-user.html#dx1-40002" >1402</a>, <a +href="glossaries-user.html#dx1-40009" >1403</a>, <a +href="glossaries-user.html#dx1-40019" >1404</a>, <a +href="glossaries-user.html#dx1-40023" >1405</a>, <a +href="glossaries-user.html#dx1-40030" >1406</a>, <a +href="glossaries-user.html#dx1-40045" >1407</a>, <a +href="glossaries-user.html#dx1-41010" >1408</a>, <a +href="glossaries-user.html#dx1-41018" >1409</a>, <a +href="glossaries-user.html#dx1-41024" >1410</a>, <a +href="glossaries-user.html#dx1-42062" >1411</a> <br /></span> +<span class="index-subitem">    <span +class="ecss-1000">hyperfirst</span>  <a +href="glossaries-user.html#dx1-13062" >1412</a> <br /></span> +<span class="index-subsubitem">        <span +class="ecss-1000">false</span>  <a +href="glossaries-user.html#dx1-28012" >1413</a>, <a +href="glossaries-user.html#dx1-57027" >1414</a> <br /></span> +<span class="index-subsubitem">        <span +class="ecss-1000">true</span>  <a +href="glossaries-user.html#dx1-13064" >1415</a> <br /></span> +<span class="index-subitem">    <span +class="ecss-1000">makeindex</span>  <a +href="glossaries-user.html#dx1-16018" >1416</a> <br /></span> +<span class="index-subitem">    <span +class="ecss-1000">nolist</span>  <a +href="glossaries-user.html#dx1-15037" >1417</a>, <a +href="glossaries-user.html#dx1-46004" >1418</a> <br /></span> +<span class="index-subitem">    <span +class="ecss-1000">nolong</span>  <a +href="glossaries-user.html#dx1-15031" >1419</a>, <a +href="glossaries-user.html#dx1-47004" >1420</a>, <a +href="glossaries-user.html#dx1-45018" >1421</a> <br /></span> +<span class="index-subitem">    <span +class="ecss-1000">nomain</span>  <a +href="glossaries-user.html#dx1-13002" >1422</a>, <a +href="glossaries-user.html#dx1-38010" >1423</a> <br /></span> +<span class="index-subitem">    <span +class="ecss-1000">nonumberlist</span>  <a +href="glossaries-user.html#dx1-2036" >1424</a>, <a +href="glossaries-user.html#dx1-15048" >1425</a>, <a +href="glossaries-user.html#dx1-15054" >1426</a>, <a +href="glossaries-user.html#dx1-19110" >1427</a>, <a +href="glossaries-user.html#dx1-25003" >1428</a>, <a +href="glossaries-user.html#dx1-29008" >1429</a>, <a +href="glossaries-user.html#dx1-52053" >1430</a>, <a +href="glossaries-user.html#dx1-52055" >1431</a> <br /></span> +<span class="index-subitem">    <span +class="ecss-1000">nostyles</span>  <a +href="glossaries-user.html#dx1-15043" >1432</a>, <a +href="glossaries-user.html#dx1-46005" >1433</a>, <a +href="glossaries-user.html#dx1-47005" >1434</a>, <a +href="glossaries-user.html#dx1-49005" >1435</a>, <a +href="glossaries-user.html#dx1-51003" >1436</a>, <a +href="glossaries-user.html#dx1-45020" >1437</a> <br /></span> +<span class="index-subitem">    <span +class="ecss-1000">nosuper</span>  <a +href="glossaries-user.html#dx1-15034" >1438</a>, <a +href="glossaries-user.html#dx1-49004" >1439</a>, <a +href="glossaries-user.html#dx1-45019" >1440</a> <br /></span> +<span class="index-subitem">    <span +class="ecss-1000">notree</span>  <a +href="glossaries-user.html#dx1-15041" >1441</a>, <a +href="glossaries-user.html#dx1-51002" >1442</a> <br /></span> +<span class="index-subitem">    <span +class="ecss-1000">nowarn</span>  <a +href="glossaries-user.html#dx1-13001" >1443</a> <br /></span> +<span class="index-subitem">    <span +class="ecss-1000">numberedsection</span>  <a +href="glossaries-user.html#dx1-14016" >1444</a>, <a +href="glossaries-user.html#dx1-14017" >1445</a>, <a +href="glossaries-user.html#dx1-33023" >1446</a>, <a +href="glossaries-user.html#dx1-33024" >1447</a>, <a +href="glossaries-user.html#dx1-33031" >1448</a> <br /></span> +<span class="index-subsubitem">        <span +class="ecss-1000">autolabel</span>  <a +href="glossaries-user.html#dx1-14020" >1449</a>, <a +href="glossaries-user.html#dx1-14021" >1450</a> <br /></span> +<span class="index-subsubitem">        <span +class="ecss-1000">false</span>  <a +href="glossaries-user.html#dx1-14018" >1451</a> <br /></span> +<span class="index-subsubitem">        <span +class="ecss-1000">nolabel</span>  <a +href="glossaries-user.html#dx1-14019" >1452</a> <br /></span> +<span class="index-subitem">    <span +class="ecss-1000">numberline</span>  <a +href="glossaries-user.html#dx1-14004" >1453</a>, <a +href="glossaries-user.html#dx1-14010" >1454</a> <br /></span> +<span class="index-subitem">    <span +class="ecss-1000">order</span>  <a +href="glossaries-user.html#dx1-16012" >1455</a>, <a +href="glossaries-user.html#dx1-16015" >1456</a> <br /></span> +<span class="index-subsubitem">        <span +class="ecss-1000">letter</span>  <a +href="glossaries-user.html#dx1-4046" >1457</a>, <a +href="glossaries-user.html#dx1-7086" >1458</a>, <a +href="glossaries-user.html#dx1-16014" >1459</a> <br /></span> +<span class="index-subsubitem">        <span +class="ecss-1000">word</span>  <a +href="glossaries-user.html#dx1-4045" >1460</a>, <a +href="glossaries-user.html#dx1-7087" >1461</a>, <a +href="glossaries-user.html#dx1-16013" >1462</a> <br /></span> +<span class="index-subitem">    <span +class="ecss-1000">sanitize</span>  <a +href="glossaries-user.html#dx1-2042" >1463</a>, <a +href="glossaries-user.html#dx1-13005" >1464</a>, <a +href="glossaries-user.html#dx1-13011" >1465</a>, <a +href="glossaries-user.html#dx1-19037" >1466</a>, <a +href="glossaries-user.html#dx1-19079" >1467</a> <br /></span> +<span class="index-subsubitem">        <span +class="ecss-1000">none</span>  <a +href="glossaries-user.html#dx1-13015" >1468</a> <br /></span> +<span class="index-subitem">    <span +class="ecss-1000">savewrites</span>  <a +href="glossaries-user.html#dx1-13027" >1469</a>, <a +href="glossaries-user.html#dx1-13029" >1470</a>, <a +href="glossaries-user.html#dx1-13036" >1471</a> <br /></span> +<span class="index-subsubitem">        <span +class="ecss-1000">false</span>  <a +href="glossaries-user.html#dx1-13028" >1472</a> <br /></span> +<span class="index-subitem">    <span +class="ecss-1000">section</span>  <a +href="glossaries-user.html#dx1-14011" >1473</a>, <a +href="glossaries-user.html#dx1-33029" >1474</a> <br /></span> +<span class="index-subitem">    <span +class="ecss-1000">seeautonumberlist</span>  <a +href="glossaries-user.html#dx1-15051" >1475</a>, <a +href="glossaries-user.html#dx1-15058" >1476</a>, <a +href="glossaries-user.html#dx1-19119" >1477</a>, <a +href="glossaries-user.html#dx1-30030" >1478</a> <br /></span> +<span class="index-subitem">    <span +class="ecss-1000">shortcuts</span>  <a +href="glossaries-user.html#dx1-17027" >1479</a>, <a +href="glossaries-user.html#dx1-39079" >1480</a>, <a +href="glossaries-user.html#dx1-39081" >1481</a>, <a +href="glossaries-user.html#dx1-42018" >1482</a> <br /></span> +<span class="index-subitem">    <span +class="ecss-1000">smallcaps</span>  <a +href="glossaries-user.html#dx1-17018" >1483</a>, <a +href="glossaries-user.html#dx1-39019" >1484</a>, <a +href="glossaries-user.html#dx1-39022" >1485</a>, <a +href="glossaries-user.html#dx1-39037" >1486</a>, <a +href="glossaries-user.html#dx1-39045" >1487</a>, <a +href="glossaries-user.html#dx1-39047" >1488</a>, <a +href="glossaries-user.html#dx1-39055" >1489</a>, <a +href="glossaries-user.html#dx1-39056" >1490</a>, <a +href="glossaries-user.html#dx1-40011" >1491</a>, <a +href="glossaries-user.html#dx1-40022" >1492</a>, <a +href="glossaries-user.html#dx1-40043" >1493</a>, <a +href="glossaries-user.html#dx1-41026" >1494</a>, <a +href="glossaries-user.html#dx1-57021" >1495</a>, <a +href="glossaries-user.html#dx1-57022" >1496</a> <br /></span> +<span class="index-subitem">    <span +class="ecss-1000">smaller</span>  <a +href="glossaries-user.html#dx1-17020" >1497</a>, <a +href="glossaries-user.html#dx1-39021" >1498</a>, <a +href="glossaries-user.html#dx1-39048" >1499</a>, <a +href="glossaries-user.html#dx1-39054" >1500</a>, <a +href="glossaries-user.html#dx1-39058" >1501</a>, <a +href="glossaries-user.html#dx1-39061" >1502</a>, <a +href="glossaries-user.html#dx1-40010" >1503</a>, <a +href="glossaries-user.html#dx1-40029" >1504</a>, <a +href="glossaries-user.html#dx1-40044" >1505</a>, <a +href="glossaries-user.html#dx1-41028" >1506</a>, <a +href="glossaries-user.html#dx1-57030" >1507</a>, <a +href="glossaries-user.html#dx1-57035" >1508</a> <br /></span> +<span class="index-subitem">    <span +class="ecss-1000">sort</span>  <a +href="glossaries-user.html#dx1-16001" >1509</a>, <a +href="glossaries-user.html#dx1-57018" >1510</a>, <a +href="glossaries-user.html#dx1-57096" >1511</a> <br /></span> + + + +<span class="index-subsubitem">        <span +class="ecss-1000">def</span>  <a +href="glossaries-user.html#dx1-16007" >1512</a>, <a +href="glossaries-user.html#dx1-19095" >1513</a>, <a +href="glossaries-user.html#dx1-23007" >1514</a>, <a +href="glossaries-user.html#dx1-57017" >1515</a> <br /></span> +<span class="index-subsubitem">        <span +class="ecss-1000">standard</span>  <a +href="glossaries-user.html#dx1-13022" >1516</a>, <a +href="glossaries-user.html#dx1-16002" >1517</a>, <a +href="glossaries-user.html#dx1-16011" >1518</a> <br /></span> +<span class="index-subsubitem">        <span +class="ecss-1000">use</span>  <a +href="glossaries-user.html#dx1-16009" >1519</a>, <a +href="glossaries-user.html#dx1-19096" >1520</a>, <a +href="glossaries-user.html#dx1-23006" >1521</a>, <a +href="glossaries-user.html#dx1-57016" >1522</a> <br /></span> +<span class="index-subitem">    <span +class="ecss-1000">style</span>  <a +href="glossaries-user.html#dx1-15025" >1523</a>, <a +href="glossaries-user.html#dx1-15040" >1524</a>, <a +href="glossaries-user.html#dx1-15044" >1525</a>, <a +href="glossaries-user.html#dx1-33020" >1526</a>, <a +href="glossaries-user.html#dx1-45014" >1527</a>, <a +href="glossaries-user.html#dx1-48008" >1528</a>, <a +href="glossaries-user.html#dx1-50008" >1529</a> <br /></span> +<span class="index-subsubitem">        <span +class="ecss-1000">list</span>  <a +href="glossaries-user.html#dx1-15026" >1530</a> <br /></span> +<span class="index-subitem">    <span +class="ecss-1000">subentrycounter</span>  <a +href="glossaries-user.html#dx1-15019" >1531</a>, <a +href="glossaries-user.html#dx1-21001" >1532</a>, <a +href="glossaries-user.html#dx1-23008" >1533</a>, <a +href="glossaries-user.html#dx1-45003" >1534</a>, <a +href="glossaries-user.html#dx1-52059" >1535</a>, <a +href="glossaries-user.html#dx1-53014" >1536</a> <br /></span> +<span class="index-subsubitem">        <span +class="ecss-1000">false</span>  <a +href="glossaries-user.html#dx1-15020" >1537</a> <br /></span> +<span class="index-subitem">    <span +class="ecss-1000">toc</span>  <a +href="glossaries-user.html#dx1-14001" >1538</a>, <a +href="glossaries-user.html#dx1-14005" >1539</a>, <a +href="glossaries-user.html#dx1-14008" >1540</a>, <a +href="glossaries-user.html#dx1-14009" >1541</a>, <a +href="glossaries-user.html#dx1-33017" >1542</a> <br /></span> +<span class="index-subitem">    <span +class="ecss-1000">translate</span>  <a +href="glossaries-user.html#dx1-13041" >1543</a> <br /></span> +<span class="index-subsubitem">        <span +class="ecss-1000">false</span>  <a +href="glossaries-user.html#dx1-6030" >1544</a>, <a +href="glossaries-user.html#dx1-6035" >1545</a>, <a +href="glossaries-user.html#dx1-13046" >1546</a>, <a +href="glossaries-user.html#dx1-13057" >1547</a> <br /></span> +<span class="index-subsubitem">        <span +class="ecss-1000">true</span>  <a +href="glossaries-user.html#dx1-13042" >1548</a>, <a +href="glossaries-user.html#dx1-13047" >1549</a> <br /></span> +<span class="index-subitem">    <span +class="ecss-1000">xindy</span>  <a +href="glossaries-user.html#dx1-4083" >1550</a>, <a +href="glossaries-user.html#dx1-5011" >1551</a>, <a +href="glossaries-user.html#dx1-7046" >1552</a>, <a +href="glossaries-user.html#dx1-7088" >1553</a>, <a +href="glossaries-user.html#dx1-9003" >1554</a>, <a +href="glossaries-user.html#dx1-10003" >1555</a>, <a +href="glossaries-user.html#dx1-16032" >1556</a>, <a +href="glossaries-user.html#dx1-16046" >1557</a>, <a +href="glossaries-user.html#dx1-18031" >1558</a>, <a +href="glossaries-user.html#dx1-34003" >1559</a>, <a +href="glossaries-user.html#dx1-36001" >1560</a>, <a +href="glossaries-user.html#dx1-37001" >1561</a> <br /></span> +<span class="index-item"><span +class="ecss-1000">page </span>counter  <a +href="glossaries-user.html#dx1-36040" >1562</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\pagelistname</span></span></span>  <a +href="glossaries-user.html#dx1-6020" >1563</a> <br /></span> +<span class="index-item"><span +class="ectt-1000">pod2man</span>  <a +href="glossaries-user.html#dx1-8016" >1564</a> <br /></span> +<span class="index-item"><span +class="ecss-1000">polyglossia </span>package  <a +href="glossaries-user.html#dx1-6002" >1565</a>, <a +href="glossaries-user.html#dx1-6032" >1566</a>, <a +href="glossaries-user.html#dx1-13044" >1567</a>, <a +href="glossaries-user.html#dx1-13055" >1568</a>, <a +href="glossaries-user.html#dx1-13059" >1569</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\printglossaries</span></span></span>  <a +href="glossaries-user.html#dx1-19008" >1570</a>, <a +href="glossaries-user.html#dx1-33001" ><span +class="ecti-1000">1571</span></a>, <a +href="glossaries-user.html#dx1-41002" >1572</a>, <a +href="glossaries-user.html#dx1-52063" >1573</a>, <a +href="glossaries-user.html#dx1-57074" >1574</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\printglossary</span></span></span>  <a +href="glossaries-user.html#dx1-15047" >1575</a>, <a +href="glossaries-user.html#dx1-19007" >1576</a>, <a +href="glossaries-user.html#dx1-33013" ><span +class="ecti-1000">1577</span></a>, <a +href="glossaries-user.html#dx1-41001" >1578</a>, <a +href="glossaries-user.html#dx1-45012" >1579</a>, <a +href="glossaries-user.html#dx1-45027" >1580</a>, <a +href="glossaries-user.html#dx1-52062" >1581</a>, <a +href="glossaries-user.html#dx1-57073" >1582</a> <br /></span> +<span class="index-item"><span +class="ectt-1000">\printglossary </span>options<br /></span> +<span class="index-subitem">    <span +class="ecss-1000">nonumberlist</span>  <a +href="glossaries-user.html#dx1-33025" >1583</a> <br /></span> +<span class="index-subitem">    <span +class="ecss-1000">numberedsection</span>  <a +href="glossaries-user.html#dx1-33022" >1584</a> <br /></span> +<span class="index-subitem">    <span +class="ecss-1000">style</span>  <a +href="glossaries-user.html#dx1-15046" >1585</a>, <a +href="glossaries-user.html#dx1-33019" >1586</a>, <a +href="glossaries-user.html#dx1-45011" >1587</a>, <a +href="glossaries-user.html#dx1-45026" >1588</a> <br /></span> +<span class="index-subitem">    <span +class="ecss-1000">title</span>  <a +href="glossaries-user.html#dx1-33015" >1589</a>, <a +href="glossaries-user.html#dx1-33018" >1590</a> <br /></span> +<span class="index-subitem">    <span +class="ecss-1000">toctitle</span>  <a +href="glossaries-user.html#dx1-33016" >1591</a> <br /></span> +<span class="index-subitem">    <span +class="ecss-1000">type</span>  <a +href="glossaries-user.html#dx1-33014" >1592</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\protect</span></span></span>  <a +href="glossaries-user.html#dx1-2041" >1593</a> <br /></span> +</p><p class="theindex"> <span +class="ecbx-1000">R</span> +<span class="index-item"><span +class="ecss-1000">relsize </span>package  <a +href="glossaries-user.html#dx1-17022" >1594</a>, <a +href="glossaries-user.html#dx1-39027" >1595</a>, <a +href="glossaries-user.html#dx1-39060" >1596</a>, <a +href="glossaries-user.html#dx1-40041" >1597</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\Roman</span></span></span>  <a +href="glossaries-user.html#dx1-36031" >1598</a> <br /></span> +</p><p class="theindex"> <span +class="ecbx-1000">S</span> +<span class="index-item">sanitize  <a +href="glossaries-user.html#dx1-2037" ><span +class="ecbx-1000">1599</span></a>, <a +href="glossaries-user.html#dx1-5019" >1600</a>, <a +href="glossaries-user.html#dx1-13007" >1601</a>, <a +href="glossaries-user.html#dx1-13021" >1602</a>, <a +href="glossaries-user.html#dx1-19036" >1603</a>, <a +href="glossaries-user.html#dx1-19078" >1604</a>, <a +href="glossaries-user.html#dx1-26126" >1605</a>, <a +href="glossaries-user.html#dx1-26135" >1606</a>, <a +href="glossaries-user.html#dx1-26144" >1607</a>, <a +href="glossaries-user.html#dx1-27043" >1608</a>, <a +href="glossaries-user.html#dx1-30007" >1609</a>, <a +href="glossaries-user.html#dx1-7061" >1610</a>, <a +href="glossaries-user.html#dx1-31017" >1611</a>, <a +href="glossaries-user.html#dx1-32047" >1612</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\section*</span></span></span>  <a +href="glossaries-user.html#dx1-33027" >1613</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\seename</span></span></span>  <a +href="glossaries-user.html#dx1-2003" >1614</a>, <a +href="glossaries-user.html#dx1-30013" >1615</a>, <a +href="glossaries-user.html#dx1-30018" >1616</a>, <a +href="glossaries-user.html#dx1-31007" >1617</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\setAlphaCompositor</span></span></span>  <a +href="glossaries-user.html#dx1-36049" >1618</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\setCompositor</span></span></span>  <a +href="glossaries-user.html#dx1-36047" >1619</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\SetCustomDisplayStyle</span></span></span>  <a +href="glossaries-user.html#dx1-42014" ><span +class="ecti-1000">1620</span></a>, <a +href="glossaries-user.html#dx1-42044" >1621</a>, <a +href="glossaries-user.html#dx1-42053" >1622</a>, <a +href="glossaries-user.html#dx1-42057" >1623</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\SetCustomStyle</span></span></span>  <a +href="glossaries-user.html#dx1-42017" ><span +class="ecti-1000">1624</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\setentrycounter</span></span></span>  <a +href="glossaries-user.html#dx1-52047" >1625</a>, <a +href="glossaries-user.html#dx1-52050" >1626</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\setglossarysection</span></span></span>  <a +href="glossaries-user.html#dx1-14012" ><span +class="ecti-1000">1627</span></a>, <a +href="glossaries-user.html#dx1-33030" >1628</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\setStyleFile</span></span></span>  <a +href="glossaries-user.html#dx1-9017" >1629</a>, <a +href="glossaries-user.html#dx1-10011" >1630</a>, <a +href="glossaries-user.html#dx1-18023" ><span +class="ecti-1000">1631</span></a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\smaller</span></span></span>  <a +href="glossaries-user.html#dx1-40037" >1632</a> <br /></span> +<span class="index-item"><span +class="ectt-1000">supertabular </span>(environment)  <a +href="glossaries-user.html#dx1-49002" >1633</a>, <a +href="glossaries-user.html#dx1-49008" >1634</a>, <a +href="glossaries-user.html#dx1-49013" >1635</a>, <a +href="glossaries-user.html#dx1-50003" >1636</a>, <a +href="glossaries-user.html#dx1-50010" >1637</a> <br /></span> + + + +<span class="index-item"><span +class="ecss-1000">supertabular </span>package  <a +href="glossaries-user.html#dx1-15036" >1638</a>, <a +href="glossaries-user.html#dx1-49015" >1639</a>, <a +href="glossaries-user.html#dx1-50012" >1640</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\symbolname</span></span></span>  <a +href="glossaries-user.html#dx1-6019" >1641</a> <br /></span> +</p><p class="theindex"> <span +class="ecbx-1000">T</span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\textbf</span></span></span>  <a +href="glossaries-user.html#dx1-26032" >1642</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\textrm</span></span></span>  <a +href="glossaries-user.html#dx1-36013" >1643</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\textsc</span></span></span>  <a +href="glossaries-user.html#dx1-39020" >1644</a>, <a +href="glossaries-user.html#dx1-39024" >1645</a>, <a +href="glossaries-user.html#dx1-39057" >1646</a>, <a +href="glossaries-user.html#dx1-40028" >1647</a>, <a +href="glossaries-user.html#dx1-42024" >1648</a>, <a +href="glossaries-user.html#dx1-42025" >1649</a>, <a +href="glossaries-user.html#dx1-57023" >1650</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\textsmaller</span></span></span>  <a +href="glossaries-user.html#dx1-17023" >1651</a>, <a +href="glossaries-user.html#dx1-39023" >1652</a>, <a +href="glossaries-user.html#dx1-39025" >1653</a>, <a +href="glossaries-user.html#dx1-39026" >1654</a>, <a +href="glossaries-user.html#dx1-40040" >1655</a>, <a +href="glossaries-user.html#dx1-57037" >1656</a>, <a +href="glossaries-user.html#dx1-40038" >1657</a> <br /></span> +<span class="index-item"><span +class="ectt-1000">theglossary </span>(environment)  <a +href="glossaries-user.html#dx1-52002" ><span +class="ecti-1000">1658</span></a>, <a +href="glossaries-user.html#dx1-52004" >1659</a>, <a +href="glossaries-user.html#dx1-52011" >1660</a>, <a +href="glossaries-user.html#dx1-53003" >1661</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\thepage</span></span></span>  <a +href="glossaries-user.html#dx1-36033" >1662</a> <br /></span> +<span class="index-item"><span +class="ecss-1000">translator </span>package  <a +href="glossaries-user.html#dx1-6004" >1663</a>, <a +href="glossaries-user.html#dx1-6005" >1664</a>, <a +href="glossaries-user.html#dx1-6006" >1665</a>, <a +href="glossaries-user.html#dx1-6010" >1666</a>, <a +href="glossaries-user.html#dx1-6012" >1667</a>, <a +href="glossaries-user.html#dx1-6024" >1668</a>, <a +href="glossaries-user.html#dx1-6025" >1669</a>, <a +href="glossaries-user.html#dx1-6026" >1670</a>, <a +href="glossaries-user.html#dx1-6029" >1671</a>, <a +href="glossaries-user.html#dx1-13045" >1672</a>, <a +href="glossaries-user.html#dx1-13049" >1673</a>, <a +href="glossaries-user.html#dx1-13050" >1674</a>, <a +href="glossaries-user.html#dx1-13051" >1675</a>, <a +href="glossaries-user.html#dx1-13052" >1676</a>, <a +href="glossaries-user.html#dx1-57056" >1677</a> <br /></span> +</p><p class="theindex"> <span +class="ecbx-1000">W</span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\write18</span></span></span>  <a +href="glossaries-user.html#dx1-13031" >1678</a> <br /></span> +</p><p class="theindex"> <span +class="ecbx-1000">X</span> +<span class="index-item">xindy  <a +href="glossaries-user.html#dx1-2043" ><span +class="ecbx-1000">1679</span></a> <br /></span> +<span class="index-item"><span +class="ectt-1000">xindy</span>  <a +href="glossaries-user.html#dx1-2030" >1680</a>, <a +href="glossaries-user.html#dx1-3011" >1681</a>, <a +href="glossaries-user.html#dx1-3017" >1682</a>, <a +href="glossaries-user.html#dx1-4052" >1683</a>, <a +href="glossaries-user.html#dx1-4059" >1684</a>, <a +href="glossaries-user.html#dx1-4066" >1685</a>, <a +href="glossaries-user.html#dx1-4070" >1686</a>, <a +href="glossaries-user.html#dx1-4074" >1687</a>, <a +href="glossaries-user.html#dx1-4078" >1688</a>, <a +href="glossaries-user.html#dx1-4080" >1689</a>, <a +href="glossaries-user.html#dx1-5002" >1690</a>, <a +href="glossaries-user.html#dx1-5006" >1691</a>, <a +href="glossaries-user.html#dx1-5010" >1692</a>, <a +href="glossaries-user.html#dx1-5028" >1693</a>, <a +href="glossaries-user.html#dx1-5032" >1694</a>, <a +href="glossaries-user.html#dx1-6037" >1695</a>, <a +href="glossaries-user.html#dx1-6041" >1696</a>, <a +href="glossaries-user.html#dx1-7004" >1697</a>, <a +href="glossaries-user.html#dx1-7008" >1698</a>, <a +href="glossaries-user.html#dx1-7012" >1699</a>, <a +href="glossaries-user.html#dx1-7014" >1700</a>, <a +href="glossaries-user.html#dx1-7020" >1701</a>, <a +href="glossaries-user.html#dx1-7027" >1702</a>, <a +href="glossaries-user.html#dx1-7033" >1703</a>, <a +href="glossaries-user.html#dx1-7039" >1704</a>, <a +href="glossaries-user.html#dx1-7043" >1705</a>, <a +href="glossaries-user.html#dx1-7048" >1706</a>, <a +href="glossaries-user.html#dx1-7058" >1707</a>, <a +href="glossaries-user.html#dx1-7068" >1708</a>, <a +href="glossaries-user.html#dx1-7076" >1709</a>, <a +href="glossaries-user.html#dx1-7085" >1710</a>, <a +href="glossaries-user.html#dx1-8005" >1711</a>, <a +href="glossaries-user.html#dx1-9002" >1712</a>, <a +href="glossaries-user.html#dx1-9005" >1713</a>, <a +href="glossaries-user.html#dx1-9009" >1714</a>, <a +href="glossaries-user.html#dx1-9011" >1715</a>, <a +href="glossaries-user.html#dx1-9014" >1716</a>, <a +href="glossaries-user.html#dx1-9027" >1717</a>, <a +href="glossaries-user.html#dx1-9031" >1718</a>, <a +href="glossaries-user.html#dx1-11002" >1719</a>, <a +href="glossaries-user.html#dx1-11011" >1720</a>, <a +href="glossaries-user.html#dx1-11015" >1721</a>, <a +href="glossaries-user.html#dx1-13035" >1722</a>, <a +href="glossaries-user.html#dx1-13040" >1723</a>, <a +href="glossaries-user.html#dx1-15011" >1724</a>, <a +href="glossaries-user.html#dx1-16030" >1725</a>, <a +href="glossaries-user.html#dx1-16034" >1726</a>, <a +href="glossaries-user.html#dx1-16038" >1727</a>, <a +href="glossaries-user.html#dx1-16042" >1728</a>, <a +href="glossaries-user.html#dx1-16048" >1729</a>, <a +href="glossaries-user.html#dx1-18006" >1730</a>, <a +href="glossaries-user.html#dx1-18009" >1731</a>, <a +href="glossaries-user.html#dx1-18022" >1732</a>, <a +href="glossaries-user.html#dx1-18029" >1733</a>, <a +href="glossaries-user.html#dx1-19014" >1734</a>, <a +href="glossaries-user.html#dx1-19091" >1735</a>, <a +href="glossaries-user.html#dx1-19132" >1736</a>, <a +href="glossaries-user.html#dx1-25009" >1737</a>, <a +href="glossaries-user.html#dx1-25011" >1738</a>, <a +href="glossaries-user.html#dx1-25018" >1739</a>, <a +href="glossaries-user.html#dx1-25022" >1740</a>, <a +href="glossaries-user.html#dx1-26007" >1741</a>, <a +href="glossaries-user.html#dx1-26035" >1742</a>, <a +href="glossaries-user.html#dx1-26041" >1743</a>, <a +href="glossaries-user.html#dx1-26062" >1744</a>, <a +href="glossaries-user.html#dx1-33007" >1745</a>, <a +href="glossaries-user.html#dx1-33011" >1746</a>, <a +href="glossaries-user.html#dx1-34002" >1747</a>, <a +href="glossaries-user.html#dx1-34005" >1748</a>, <a +href="glossaries-user.html#dx1-34007" >1749</a>, <a +href="glossaries-user.html#dx1-34010" >1750</a>, <a +href="glossaries-user.html#dx1-34016" >1751</a>, <a +href="glossaries-user.html#dx1-34018" >1752</a>, <a +href="glossaries-user.html#dx1-34021" >1753</a>, <a +href="glossaries-user.html#dx1-34023" >1754</a>, <a +href="glossaries-user.html#dx1-35002" >1755</a>, <a +href="glossaries-user.html#dx1-35004" >1756</a>, <a +href="glossaries-user.html#dx1-35009" >1757</a>, <a +href="glossaries-user.html#dx1-35015" >1758</a>, <a +href="glossaries-user.html#dx1-35020" >1759</a>, <a +href="glossaries-user.html#dx1-36005" >1760</a>, <a +href="glossaries-user.html#dx1-36016" >1761</a>, <a +href="glossaries-user.html#dx1-36020" >1762</a>, <a +href="glossaries-user.html#dx1-36026" >1763</a>, <a +href="glossaries-user.html#dx1-36035" >1764</a>, <a +href="glossaries-user.html#dx1-36043" >1765</a>, <a +href="glossaries-user.html#dx1-36059" >1766</a>, <a +href="glossaries-user.html#dx1-38007" >1767</a>, <a +href="glossaries-user.html#dx1-51016" >1768</a>, <a +href="glossaries-user.html#dx1-52027" >1769</a>, <a +href="glossaries-user.html#dx1-57007" >1770</a>, <a +href="glossaries-user.html#dx1-57009" >1771</a>, <a +href="glossaries-user.html#dx1-57013" >1772</a>, <a +href="glossaries-user.html#dx1-57015" >1773</a>, <a +href="glossaries-user.html#dx1-57047" >1774</a>, <a +href="glossaries-user.html#dx1-57085" >1775</a>, <a +href="glossaries-user.html#dx1-57089" >1776</a>, <a +href="glossaries-user.html#dx1-57091" >1777</a>, <a +href="glossaries-user.html#dx1-57093" >1778</a>, <a +href="glossaries-user.html#dx1-57095" >1779</a> <br /></span> +<span class="index-item"><span +class="ecss-1000">xkeyval </span>package  <a +href="glossaries-user.html#dx1-4003" >1780</a>, <a +href="glossaries-user.html#dx1-57003" >1781</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\xmakefirstuc</span></span></span>  <a +href="glossaries-user.html#dx1-2004" >1782</a> <br /></span> +<span class="index-item"><span class="obeylines-h"><span class="verb"><span +class="ectt-1000">\xspace</span></span></span>  <a +href="glossaries-user.html#dx1-43016" >1783</a> <br /></span> +<span class="index-item"><span +class="ecss-1000">xspace </span>package  <a +href="glossaries-user.html#dx1-43014" >1784</a>, <a +href="glossaries-user.html#dx1-43015" >1785</a>, <a +href="glossaries-user.html#dx1-43017" >1786</a>, <a +href="glossaries-user.html#dx1-43019" >1787</a>, <a +href="glossaries-user.html#dx1-43021" >1788</a>, <a +href="glossaries-user.html#dx1-43022" >1789</a> <br /></span> +</p></div> + + + + <div class="footnotes"><!--l. 289--><p class="indent" > <span class="footnote-mark"><a +href="#fn1x0-bk" id="fn1x0"><sup class="textsuperscript">1</sup></a></span><span +class="ecrm-0800">That is, if the term has been referenced using any of the commands described in </span><a +href="#x1-260006"><span +class="ecrm-0800">§6 </span></a><a +href="#x1-260006"><span +class="ecrm-0800">Links to</span> +<span +class="ecrm-0800">Glossary Entries</span><!--tex4ht:ref: sec:glslink --></a> <span +class="ecrm-0800">and </span><a +href="#x1-290007"><span +class="ecrm-0800">§7 </span></a><a +href="#x1-290007"><span +class="ecrm-0800">Adding an Entry to the Glossary Without Generating Text</span><!--tex4ht:ref: sec:glsadd --></a> <span +class="ecrm-0800">or via </span><span +class="ectt-0800">\glssee</span><a + id="dx1-3002"></a> <span +class="ecrm-0800">(or</span> +<span +class="ecrm-0800">the </span><span +class="ecss-0800">see</span><a + id="dx1-3003"></a> <span +class="ecrm-0800">key) or commands such as </span><span +class="ectt-0800">\acrshort</span><a + id="dx1-3004"></a><span +class="ecrm-0800">.</span></p> +<!--l. 990--><p class="indent" > <span class="footnote-mark"><a +href="#fn2x0-bk" id="fn2x0"><sup class="textsuperscript">2</sup></a></span><span +class="ecrm-0800">Note that I’m assuming the</span> <a + id="dx1-7060"></a><a +href="#glo:sanitize"><span +class="ecrm-0800">sanitization</span><a + id="dx1-7061"></a></a> <span +class="ecrm-0800">has been switched on for the </span><span +class="ecss-0800">description</span><a + id="dx1-7062"></a> <span +class="ecrm-0800">key, which is</span> +<span +class="ecrm-0800">why I haven’t used </span><span +class="ectt-0800">\protect\gls </span><span +class="ecrm-0800">in the description.</span></p> +<!--l. 1457--><p class="noindent" ><span class="footnote-mark"><a +href="#fn3x0-bk" id="fn3x0"><sup class="textsuperscript">3</sup></a></span><span +class="ecrm-0800">if the </span><span +class="ecss-0800">acronym</span><a + id="dx1-14023"></a> <span +class="ecrm-0800">option is used, otherwise the list of acronyms is the main glossary</span></p> +<!--l. 1698--><p class="noindent" ><span class="footnote-mark"><a +href="#fn4x0-bk" id="fn4x0"><sup class="textsuperscript">4</sup></a></span><span +class="ecrm-0800">Actually it sets </span><span +class="ectt-0800">\acronymtype</span><a + id="dx1-17005"></a> <span +class="ecrm-0800">to </span><span +class="ectt-0800">\glsdefaulttype</span><a + id="dx1-17006"></a> <span +class="ecrm-0800">if the </span><span +class="ecss-0800">acronym</span><a + id="dx1-17007"></a> <span +class="ecrm-0800">package option is not used, but</span> +<span +class="ectt-0800">\glsdefaulttype</span><a + id="dx1-17008"></a> <span +class="ecrm-0800">usually has the value </span><span +class="ectt-0800">main</span><span +class="ecrm-0800">.</span></p> +<!--l. 1833--><p class="indent" > <span class="footnote-mark"><a +href="#fn5x0-bk" id="fn5x0"><sup class="textsuperscript">5</sup></a></span><span +class="ecrm-0800">The only preamble restriction on </span><span +class="ectt-0800">\newglossaryentry</span><a + id="dx1-19002"></a> <span +class="ecrm-0800">and </span><span +class="ectt-0800">\newacronym</span><a + id="dx1-19003"></a> <span +class="ecrm-0800">was removed in version</span> +<span +class="ecrm-0800">1.13, but the restriction remains for </span><span +class="ectt-0800">\loadglsentries</span><a + id="dx1-19004"></a><span +class="ecrm-0800">.</span></p> +<!--l. 1848--><p class="indent" > <span class="footnote-mark"><a +href="#fn6x0-bk" id="fn6x0"><sup class="textsuperscript">6</sup></a></span><span +class="ecrm-0800">Except possibly the style file but then you’ll need to use </span><span +class="ectt-0800">\noist</span><a + id="dx1-19016"></a> <span +class="ecrm-0800">to prevent your changes from</span> +<span +class="ecrm-0800">being overwritten.</span></p> +<!--l. 2226--><p class="indent" > <span class="footnote-mark"><a +href="#fn7x0-bk" id="fn7x0"><sup class="textsuperscript">7</sup></a></span><span +class="ecrm-0800">This is because </span><span +class="ectt-0800">\acronymtype</span><a + id="dx1-24010"></a> <span +class="ecrm-0800">is set to </span><span +class="ectt-0800">\glsdefaulttype</span><a + id="dx1-24011"></a> <span +class="ecrm-0800">if the </span><span +class="ecss-0800">acronym</span><a + id="dx1-24012"></a> <span +class="ecrm-0800">package option is not</span> +<span +class="ecrm-0800">used.</span></p> +<!--l. 2890--><p class="indent" > <span class="footnote-mark"><a +href="#fn8x0-bk" id="fn8x0"><sup class="textsuperscript">8</sup></a></span><span +class="ectt-0800">main </span><span +class="ecrm-0800">for the main (default) glossary, </span><span +class="ectt-0800">\acronymtype </span><span +class="ecrm-0800">for the list of acronyms, or the name</span> +<span +class="ecrm-0800">supplied in the first mandatory argument to </span><span +class="ectt-0800">\newglossary </span><span +class="ecrm-0800">for additional glossaries.</span></p> +<!--l. 3122--><p class="indent" > <span class="footnote-mark"><a +href="#fn9x0-bk" id="fn9x0"><sup class="textsuperscript">9</sup></a></span><a + id="dx1-31004"></a><a +href="#glo:makeindex"><span +class="ectt-0800">makeindex</span><a + id="dx1-31005"></a></a> <span +class="ecrm-0800">will always assign a location number, even if it’s not needed, so it needs to be</span> +<span +class="ecrm-0800">discarded.</span></p><!--l. 3127--><p class="indent" > <span class="footnote-mark"><a +href="#fn10x0-bk" id="fn10x0"><sup class="textsuperscript">10</sup></a></span><span +class="ecrm-0800">Ifyou redefine </span><span +class="ectt-0800">\glsseeformat</span><span +class="ecrm-0800">, keep the default value of the optional argument as </span><span +class="ectt-0800">\seename</span><a + id="dx1-31007"></a> <span +class="ecrm-0800">as</span> +<span +class="ecrm-0800">both </span><span +class="ecss-0800">see</span><a + id="dx1-31008"></a> <span +class="ecrm-0800">and </span><span +class="ectt-0800">\glssee </span><span +class="ecrm-0800">explicitly write </span><span +class="ectt-0800">[\seename] </span><span +class="ecrm-0800">in the output file if no optional argument is</span> +<span +class="ecrm-0800">given.</span></p> +<!--l. 3151--><p class="indent" > <span class="footnote-mark"><a +href="#fn11x0-bk" id="fn11x0"><sup class="textsuperscript">11</sup></a></span><span +class="ecrm-0800">In versions before 3.0, </span><span +class="ectt-0800">\glsentryname </span><span +class="ecrm-0800">was used, but this can cause problems when the </span><span +class="ecss-0800">name</span><a + id="dx1-31015"></a> +<span +class="ecrm-0800">key is</span> <a + id="dx1-31016"></a><a +href="#glo:sanitize"><span +class="ecrm-0800">sanitized</span><a + id="dx1-31017"></a></a><span +class="ecrm-0800">.</span></p> +<!--l. 3304--><p class="indent" > <span class="footnote-mark"><a +href="#fn12x0-bk" id="fn12x0"><sup class="textsuperscript">12</sup></a></span><span +class="ecrm-0800">versions before 3.0 used </span><span +class="ectt-0800">\glsentryname</span><a + id="dx1-32044"></a> <span +class="ecrm-0800">as the default, but this can cause problems when </span><span +class="ecss-0800">name</span><a + id="dx1-32045"></a> +<span +class="ecrm-0800">has been</span> <a + id="dx1-32046"></a><a +href="#glo:sanitize"><span +class="ecrm-0800">sanitized</span><a + id="dx1-32047"></a></a><span +class="ecrm-0800">.</span></p><!--l. 3430--><p class="indent" > <span class="footnote-mark"><a +href="#fn13x0-bk" id="fn13x0"><sup class="textsuperscript">13</sup></a></span><span +class="ecrm-0800">you can’t use the </span><span +class="ecss-0800">longheaderborder</span><a + id="dx1-33038"></a> <span +class="ecrm-0800">style for this example as you can’t use the </span><span +class="ecss-0800">longtable</span><a + id="dx1-33039"></a><a + id="dx1-33040"></a> +<span +class="ecrm-0800">environment in two column mode.</span></p><!--l. 3725--><p class="indent" > <span class="footnote-mark"><a +href="#fn14x0-bk" id="fn14x0"><sup class="textsuperscript">14</sup></a></span><span +class="ecrm-0800">see </span><span +class="ectt-0800">\setCompositor</span><a + id="dx1-36047"></a> <span +class="ecrm-0800">described in </span><a +href="#x1-180003"><span +class="ecrm-0800">§3 </span></a><a +href="#x1-180003"><span +class="ecrm-0800">Setting Up</span><!--tex4ht:ref: sec:setup --></a></p> +<!--l. 3731--><p class="indent" > <span class="footnote-mark"><a +href="#fn15x0-bk" id="fn15x0"><sup class="textsuperscript">15</sup></a></span><span +class="ecrm-0800">see </span><span +class="ectt-0800">\setAlphaCompositor</span><a + id="dx1-36049"></a> <span +class="ecrm-0800">described in </span><a +href="#x1-180003"><span +class="ecrm-0800">§3 </span></a><a +href="#x1-180003"><span +class="ecrm-0800">Setting Up</span><!--tex4ht:ref: sec:setup --></a></p> +<!--l. 4240--><p class="noindent" ><span class="footnote-mark"><a +href="#fn16x0-bk" id="fn16x0"><sup class="textsuperscript">16</sup></a></span><span +class="ecrm-0800">not that this was change from using </span><span +class="ectt-0800">\smaller</span><a + id="dx1-40037"></a> <span +class="ecrm-0800">to </span><span +class="ectt-0800">\textsmaller</span><a + id="dx1-40038"></a> <span +class="ecrm-0800">as declarations cause a problem for</span> +<span +class="ectt-0800">\makefirstuc</span><a + id="dx1-40039"></a><span +class="ecrm-0800">.</span></p> +<!--l. 4497--><p class="indent" > <span class="footnote-mark"><a +href="#fn17x0-bk" id="fn17x0"><sup class="textsuperscript">17</sup></a></span><span +class="ecrm-0800">as from version 1.18</span></p><!--l. 4690--><p class="indent" > <span class="footnote-mark"><a +href="#fn18x0-bk" id="fn18x0"><sup class="textsuperscript">18</sup></a></span><span +class="ecrm-0800">these lengths will not be available if you use both the </span><span +class="ecss-0800">nolong</span><a + id="dx1-45018"></a> <span +class="ecrm-0800">and </span><span +class="ecss-0800">nosuper</span><a + id="dx1-45019"></a> <span +class="ecrm-0800">package</span> +<span +class="ecrm-0800">options or if you use the </span><span +class="ecss-0800">nostyles</span><a + id="dx1-45020"></a> <span +class="ecrm-0800">package option unless you explicitly load the relevant</span> +<span +class="ecrm-0800">package.</span></p> +<!--l. 4796--><p class="noindent" ><span class="footnote-mark"><a +href="#fn19x0-bk" id="fn19x0"><sup class="textsuperscript">19</sup></a></span><span +class="ecrm-0800">This style was supplied by Axel</span><span +class="ecrm-0800"> Menzel.</span></p> +<!--l. 5007--><p class="indent" > <span class="footnote-mark"><a +href="#fn20x0-bk" id="fn20x0"><sup class="textsuperscript">20</sup></a></span><span +class="ecrm-0800">e.g.</span><span +class="ecrm-0800"> with the </span><span +class="ecss-0800">flowfram</span><a + id="dx1-49011"></a> <span +class="ecrm-0800">package.</span></p> </div> + +</body></html> + + + + |