summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/glossaries/glossaries-user-examples
diff options
context:
space:
mode:
Diffstat (limited to 'macros/latex/contrib/glossaries/glossaries-user-examples')
-rw-r--r--macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example001.pdfbin0 -> 23904 bytes
-rw-r--r--macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example001.pngbin0 -> 2989 bytes
-rw-r--r--macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example001.tex43
-rw-r--r--macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example002.pdfbin0 -> 36694 bytes
-rw-r--r--macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example002.pngbin0 -> 8172 bytes
-rw-r--r--macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example002.tex41
-rw-r--r--macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example003.pdfbin0 -> 36443 bytes
-rw-r--r--macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example003.pngbin0 -> 7702 bytes
-rw-r--r--macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example003.tex29
-rw-r--r--macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example004.pdfbin0 -> 36443 bytes
-rw-r--r--macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example004.pngbin0 -> 7702 bytes
-rw-r--r--macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example004.tex30
-rw-r--r--macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example005.pdfbin0 -> 36443 bytes
-rw-r--r--macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example005.pngbin0 -> 7702 bytes
-rw-r--r--macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example005.tex30
-rw-r--r--macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example006.pdfbin0 -> 36291 bytes
-rw-r--r--macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example006.pngbin0 -> 6850 bytes
-rw-r--r--macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example006.tex44
-rw-r--r--macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example007.pdfbin0 -> 37155 bytes
-rw-r--r--macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example007.pngbin0 -> 8774 bytes
-rw-r--r--macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example007.tex28
-rw-r--r--macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example008.pdfbin0 -> 62536 bytes
-rw-r--r--macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example008.pngbin0 -> 9443 bytes
-rw-r--r--macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example008.tex39
-rw-r--r--macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example022.pdfbin0 -> 15087 bytes
-rw-r--r--macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example022.pngbin0 -> 2509 bytes
-rw-r--r--macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example022.tex15
-rw-r--r--macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example023.pdfbin0 -> 14255 bytes
-rw-r--r--macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example023.pngbin0 -> 2838 bytes
-rw-r--r--macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example023.tex16
-rw-r--r--macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example024.pdfbin0 -> 14263 bytes
-rw-r--r--macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example024.pngbin0 -> 2825 bytes
-rw-r--r--macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example024.tex16
-rw-r--r--macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example025.pdfbin0 -> 10078 bytes
-rw-r--r--macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example025.pngbin0 -> 671 bytes
-rw-r--r--macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example025.tex12
-rw-r--r--macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example030.pdfbin0 -> 28091 bytes
-rw-r--r--macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example030.pngbin0 -> 9066 bytes
-rw-r--r--macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example030.tex31
39 files changed, 374 insertions, 0 deletions
diff --git a/macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example001.pdf b/macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example001.pdf
new file mode 100644
index 0000000000..64df5bcb16
--- /dev/null
+++ b/macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example001.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example001.png b/macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example001.png
new file mode 100644
index 0000000000..86a954b0f8
--- /dev/null
+++ b/macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example001.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example001.tex b/macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example001.tex
new file mode 100644
index 0000000000..f0d7f9cd06
--- /dev/null
+++ b/macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example001.tex
@@ -0,0 +1,43 @@
+% This file is embedded in glossaries-user.pdf
+% Example 1 Simple document with no glossary
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[12pt]{article}
+\pagestyle{empty}
+\usepackage[
+ sort=none % no sorting or indexing required
+ ] {glossaries}
+
+\newglossaryentry
+{cafe}% label
+ {% definition:
+ name={café},
+ description={small restaurant selling refreshments}
+}
+
+\setacronymstyle{long-short} \newacronym
+{html}% label
+ {HTML}% short form
+ {hypertext markup language}% long form
+
+
+\newglossaryentry
+{pi}% label
+ {% definition:
+ name={\ensuremath{\pi}},
+ description={Archimedes' Constant}
+}
+
+% This is a trivial example. For a real document I recommend you use siunitx for units
+ \newglossaryentry
+ {distance}% label
+ {% definition:
+ name={distance},
+ description={the length between two points},
+ symbol={m}
+ }
+\begin{document}
+First use: \gls{cafe}, \gls{html}, \gls{pi}. Next use: \gls{cafe}, \gls{html}, \gls{pi}.
+
+\Gls{distance} (\glsentrydesc{distance}) is measured in \glssymbol{distance}.
+\end{document}
diff --git a/macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example002.pdf b/macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example002.pdf
new file mode 100644
index 0000000000..916e8f3943
--- /dev/null
+++ b/macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example002.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example002.png b/macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example002.png
new file mode 100644
index 0000000000..16054de8c2
--- /dev/null
+++ b/macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example002.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example002.tex b/macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example002.tex
new file mode 100644
index 0000000000..dc1efc9266
--- /dev/null
+++ b/macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example002.tex
@@ -0,0 +1,41 @@
+% This file is embedded in glossaries-user.pdf
+% Example 2 Simple document with unsorted glossaries
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[12pt]{article}
+\pagestyle{empty}
+\usepackage[ sort=none,% no sorting or indexing required
+ abbreviations,% create list of abbreviations
+ symbols,% create list of symbols
+ postdot, % append a full stop after the descriptions
+ stylemods,style=index % set the default glossary style
+ ]{glossaries-extra}
+
+\newglossaryentry % glossaries.sty
+{cafe}% label
+ {% definition:
+ name={café},
+ description={small restaurant selling refreshments}
+}
+
+\setabbreviationstyle{long-short}% glossaries-extra.sty
+\newabbreviation % glossaries-extra.sty
+{html}% label
+ {HTML}% short form
+ {hypertext markup language}% long form
+ % requires glossaries-extra.sty 'symbols' option
+ \glsxtrnewsymbol [description={Archimedes' constant}]% options
+ {pi}% label
+ {\ensuremath{\pi}}% symbol
+ % This is a trivial example. For a real document I recommend you use siunitx for units
+ \newglossaryentry % glossaries.sty
+{distance}% label
+ {% definition:
+ name={distance}, description={the length between two points}, symbol={m} }
+\begin{document}
+First use: \gls{cafe}, \gls{html}, \gls{pi}. Next use: \gls{cafe}, \gls{html}, \gls{pi}.
+
+\Gls{distance} is measured in \glssymbol{distance}.
+\printunsrtglossaries % list all defined entries
+
+\end{document}
diff --git a/macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example003.pdf b/macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example003.pdf
new file mode 100644
index 0000000000..b9d14403be
--- /dev/null
+++ b/macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example003.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example003.png b/macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example003.png
new file mode 100644
index 0000000000..1b6a5d4fc8
--- /dev/null
+++ b/macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example003.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example003.tex b/macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example003.tex
new file mode 100644
index 0000000000..d8b41f23ae
--- /dev/null
+++ b/macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example003.tex
@@ -0,0 +1,29 @@
+% This file is embedded in glossaries-user.pdf
+% Example 3 Simple document that uses TeX\ to sort entries
+% arara: pdflatex
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[12pt]{article}
+\pagestyle{empty}
+\usepackage[style=indexgroup]{glossaries}
+\makenoidxglossaries % use TeX to sort
+ \newglossaryentry{parrot}{name={parrot},
+ description={a brightly coloured tropical bird}}
+\newglossaryentry{duck}{name={duck},
+ description={a waterbird}}
+\newglossaryentry{puffin}{name={puffin},
+ description={a seabird with a brightly coloured bill}}
+\newglossaryentry{penguin}{name={penguin},
+ description={a flightless black and white seabird}}
+% a symbol:
+ \newglossaryentry{alpha}{name={\ensuremath{\alpha}},
+ sort={alpha},description={a variable}}
+% an acronym:
+ \setacronymstyle{short-long}
+ \newacronym{arpanet}{ARPANET}{Advanced Research Projects Agency Network}
+\begin{document}
+\Gls{puffin}, \gls{duck} and \gls{parrot}.
+\gls{arpanet} and \gls{alpha}.
+Next use: \gls{arpanet}.
+\printnoidxglossary
+\end{document}
diff --git a/macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example004.pdf b/macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example004.pdf
new file mode 100644
index 0000000000..01bde654d7
--- /dev/null
+++ b/macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example004.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example004.png b/macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example004.png
new file mode 100644
index 0000000000..d991b85b99
--- /dev/null
+++ b/macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example004.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example004.tex b/macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example004.tex
new file mode 100644
index 0000000000..d174169dbf
--- /dev/null
+++ b/macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example004.tex
@@ -0,0 +1,30 @@
+% This file is embedded in glossaries-user.pdf
+% Example 4 Simple document that uses makeindex to sort entries
+% arara: pdflatex
+% arara: makeglossaries
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[12pt]{article}
+\pagestyle{empty}
+\usepackage[style=indexgroup]{glossaries}
+\makeglossaries % open \dglspl {indexingfile}
+ \newglossaryentry{parrot}{name={parrot},
+ description={a brightly coloured tropical bird}}
+\newglossaryentry{duck}{name={duck},
+ description={a waterbird}}
+\newglossaryentry{puffin}{name={puffin},
+ description={a seabird with a brightly coloured bill}}
+\newglossaryentry{penguin}{name={penguin},
+ description={a flightless black and white seabird}}
+% a symbol:
+ \newglossaryentry{alpha}{name={\ensuremath{\alpha}},
+ sort={alpha},description={a variable}}
+% an acronym:
+ \setacronymstyle{short-long}
+ \newacronym{arpanet}{ARPANET}{Advanced Research Projects Agency Network}
+\begin{document}
+\Gls{puffin}, \gls{duck} and \gls{parrot}.
+\gls{arpanet} and \gls{alpha}.
+Next use: \gls{arpanet}.
+\printglossary
+\end{document}
diff --git a/macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example005.pdf b/macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example005.pdf
new file mode 100644
index 0000000000..9e946198d6
--- /dev/null
+++ b/macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example005.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example005.png b/macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example005.png
new file mode 100644
index 0000000000..518a57b377
--- /dev/null
+++ b/macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example005.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example005.tex b/macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example005.tex
new file mode 100644
index 0000000000..e7f9eb535e
--- /dev/null
+++ b/macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example005.tex
@@ -0,0 +1,30 @@
+% This file is embedded in glossaries-user.pdf
+% Example 5 Simple document that uses xindy to sort entries
+% arara: pdflatex
+% arara: makeglossaries
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[12pt]{article}
+\pagestyle{empty}
+\usepackage[xindy,style=indexgroup]{glossaries}
+\makeglossaries % open \dglspl {indexingfile}
+ \newglossaryentry{parrot}{name={parrot},
+ description={a brightly coloured tropical bird}}
+\newglossaryentry{duck}{name={duck},
+ description={a waterbird}}
+\newglossaryentry{puffin}{name={puffin},
+ description={a seabird with a brightly coloured bill}}
+\newglossaryentry{penguin}{name={penguin},
+ description={a flightless black and white seabird}}
+% a symbol:
+ \newglossaryentry{alpha}{name={\ensuremath{\alpha}},
+ sort={alpha},description={a variable}}
+% an acronym:
+ \setacronymstyle{short-long}
+ \newacronym{arpanet}{ARPANET}{Advanced Research Projects Agency Network}
+\begin{document}
+\Gls{puffin}, \gls{duck} and \gls{parrot}.
+\gls{arpanet} and \gls{alpha}.
+Next use: \gls{arpanet}.
+\printglossary
+\end{document}
diff --git a/macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example006.pdf b/macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example006.pdf
new file mode 100644
index 0000000000..02283269eb
--- /dev/null
+++ b/macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example006.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example006.png b/macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example006.png
new file mode 100644
index 0000000000..c401aaa863
--- /dev/null
+++ b/macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example006.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example006.tex b/macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example006.tex
new file mode 100644
index 0000000000..e3a96d6606
--- /dev/null
+++ b/macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example006.tex
@@ -0,0 +1,44 @@
+% This file is embedded in glossaries-user.pdf
+% Example 6 Simple document that uses bib2gls to sort entries
+% arara: pdflatex
+% arara: bib2gls
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[12pt]{article}
+\pagestyle{empty}
+\begin{filecontents*}{sample-entries.bib}
+@entry{parrot,
+ name={parrot},
+ description={a brightly coloured tropical bird}
+}
+@entry{duck,
+ name={duck},
+ description={a waterbird}
+}
+@entry{puffin,
+ name={puffin},
+ description={a seabird with a brightly coloured bill}
+}
+@entry{penguin,
+ name={penguin},
+ description={a flightless black and white seabird}
+}
+@symbol{alpha,
+ name={\ensuremath{\alpha}},
+ description={a variable}
+}
+@abbreviation{arpanet,
+ short={ARPANET},
+ long={Advanced Research Projects Agency Network}
+}
+\end{filecontents*}
+\usepackage[record,style=indexgroup]{glossaries-extra}
+\setabbreviationstyle{short-long}
+\GlsXtrLoadResources[src={sample-entries}]% data in sample-entries.bib
+
+\begin{document}
+\Gls{puffin}, \gls{duck} and \gls{parrot}.
+\gls{arpanet} and \gls{alpha}.
+Next use: \gls{arpanet}.
+\printunsrtglossary
+\end{document}
diff --git a/macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example007.pdf b/macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example007.pdf
new file mode 100644
index 0000000000..25da6015a5
--- /dev/null
+++ b/macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example007.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example007.png b/macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example007.png
new file mode 100644
index 0000000000..0b07c4ff90
--- /dev/null
+++ b/macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example007.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example007.tex b/macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example007.tex
new file mode 100644
index 0000000000..d8ac491914
--- /dev/null
+++ b/macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example007.tex
@@ -0,0 +1,28 @@
+% This file is embedded in glossaries-user.pdf
+% Example 7 Simple document with an unsorted list of all defined entries
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[12pt]{article}
+\pagestyle{empty}
+\usepackage[style=indexgroup]{glossaries-extra}
+\newglossaryentry{parrot}{name={parrot},
+ description={a brightly coloured tropical bird}}
+\newglossaryentry{duck}{name={duck},
+ description={a waterbird}}
+\newglossaryentry{puffin}{name={puffin},
+ description={a seabird with a brightly coloured bill}}
+\newglossaryentry{penguin}{name={penguin},
+ description={a flightless black and white seabird}}
+% a symbol:
+ \newglossaryentry{alpha}{name={\ensuremath{\alpha}},
+ sort={alpha},description={a variable}}
+% an abbreviation:
+ \setabbreviationstyle{short-long}
+\newabbreviation{arpanet}{ARPANET}{Advanced Research Projects Agency Network}
+\begin{document}
+\Gls{puffin}, \gls{duck} and \gls{parrot}.
+\gls{arpanet} and \gls{alpha}.
+Next use: \gls{arpanet}.
+% entries are listed in order of definition
+ \printunsrtglossary
+\end{document}
diff --git a/macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example008.pdf b/macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example008.pdf
new file mode 100644
index 0000000000..d9ddc42525
--- /dev/null
+++ b/macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example008.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example008.png b/macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example008.png
new file mode 100644
index 0000000000..fe791c5a6d
--- /dev/null
+++ b/macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example008.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example008.tex b/macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example008.tex
new file mode 100644
index 0000000000..3b5e7f6f3e
--- /dev/null
+++ b/macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example008.tex
@@ -0,0 +1,39 @@
+% This file is embedded in glossaries-user.pdf
+% Example 8 Simple document with standalone entries
+% arara: pdflatex
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[12pt]{article}
+\pagestyle{empty}
+\usepackage[colorlinks]{hyperref}
+\usepackage[sort=none,
+ nostyles% <- no glossary styles are required
+ ]{glossaries-extra}
+
+\newglossaryentry{set}{name={set},
+ description={a collection of any kind of objects},
+ symbol={\ensuremath{\mathcal{S}}}
+}
+
+\newglossaryentry{function}{name={function},
+ description={a rule that assigns every element in the
+ domain \gls{set} to an element in the range \gls{set}},
+ symbol={\ensuremath{f(x)}} }
+\newcommand*{\termdef}[1]{%
+ \section{\glsxtrglossentry{#1} \glsentrysymbol{#1}}%
+ \begin{quote}\em\Glsentrydesc{#1}.\end{quote}%
+}
+\begin{document}
+\tableofcontents
+
+\section{Introduction}
+Sample document about \glspl{function} and \glspl{set}.
+
+\termdef{set}
+
+More detailed information about \glspl{set} with examples.
+
+\termdef{function}
+
+More detailed information about \glspl{function} with examples.
+\end{document}
diff --git a/macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example022.pdf b/macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example022.pdf
new file mode 100644
index 0000000000..d606a0faa2
--- /dev/null
+++ b/macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example022.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example022.png b/macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example022.png
new file mode 100644
index 0000000000..d61c4249f5
--- /dev/null
+++ b/macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example022.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example022.tex b/macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example022.tex
new file mode 100644
index 0000000000..1167f0968b
--- /dev/null
+++ b/macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example022.tex
@@ -0,0 +1,15 @@
+% This file is embedded in glossaries-user.pdf
+% Example 22 Simple document with acronyms
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[12pt]{article}
+\pagestyle{empty}
+\usepackage{glossaries}
+\setacronymstyle{long-short}
+\newacronym{html}{HTML}{hypertext markup language}
+\newacronym{xml}{XML}{extensible markup language}
+\begin{document}
+First use: \gls{html} and \gls{xml}.
+
+Next use: \gls{html} and \gls{xml}.
+\end{document}
diff --git a/macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example023.pdf b/macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example023.pdf
new file mode 100644
index 0000000000..7bc49fdd86
--- /dev/null
+++ b/macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example023.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example023.png b/macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example023.png
new file mode 100644
index 0000000000..09360faa5f
--- /dev/null
+++ b/macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example023.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example023.tex b/macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example023.tex
new file mode 100644
index 0000000000..2096c621d1
--- /dev/null
+++ b/macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example023.tex
@@ -0,0 +1,16 @@
+% This file is embedded in glossaries-user.pdf
+% Example 23 Defining and Using an Acronym
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[12pt]{article}
+\pagestyle{empty}
+\usepackage{glossaries}
+\setacronymstyle{long-short}
+\newacronym{idn}{IDN}{identification number}
+\begin{document}
+First use: \gls{idn}. Next use: \gls{idn}.
+
+\glsreset{idn}% reset first use
+ The \gls{idn}['s] prefix is a capital letter.
+Next use: the \gls{idn}['s] prefix is a capital letter.
+\end{document}
diff --git a/macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example024.pdf b/macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example024.pdf
new file mode 100644
index 0000000000..2a3bf61b6d
--- /dev/null
+++ b/macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example024.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example024.png b/macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example024.png
new file mode 100644
index 0000000000..8156859e0a
--- /dev/null
+++ b/macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example024.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example024.tex b/macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example024.tex
new file mode 100644
index 0000000000..bb48775a0d
--- /dev/null
+++ b/macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example024.tex
@@ -0,0 +1,16 @@
+% This file is embedded in glossaries-user.pdf
+% Example 24 Defining and Using an Acronym (Rollback)
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[12pt]{article}
+\pagestyle{empty}
+\usepackage{glossaries}[=v4.46]% rollback to v4.46
+ % no \setacronymstyle so old style used
+ \newacronym{idn}{IDN}{identification number}
+\begin{document}
+First use: \gls{idn}. Next use: \gls{idn}.
+
+\glsreset{idn}% reset first use
+ The \gls{idn}['s] prefix is a capital letter.
+Next use: the \gls{idn}['s] prefix is a capital letter.
+\end{document}
diff --git a/macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example025.pdf b/macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example025.pdf
new file mode 100644
index 0000000000..9e6f19d2b0
--- /dev/null
+++ b/macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example025.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example025.png b/macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example025.png
new file mode 100644
index 0000000000..958bd9b554
--- /dev/null
+++ b/macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example025.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example025.tex b/macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example025.tex
new file mode 100644
index 0000000000..e2bd177cae
--- /dev/null
+++ b/macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example025.tex
@@ -0,0 +1,12 @@
+% This file is embedded in glossaries-user.pdf
+% Example 25 Small-Caps Acronym
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[12pt]{article}
+\pagestyle{empty}
+\usepackage{glossaries}
+\setacronymstyle{long-sc-short}
+\newacronym{mathml}{MathML}{mathematical markup language}
+\begin{document}
+\acrshort{mathml}
+\end{document}
diff --git a/macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example030.pdf b/macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example030.pdf
new file mode 100644
index 0000000000..f0f00917ff
--- /dev/null
+++ b/macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example030.pdf
Binary files differ
diff --git a/macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example030.png b/macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example030.png
new file mode 100644
index 0000000000..ee722efde4
--- /dev/null
+++ b/macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example030.png
Binary files differ
diff --git a/macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example030.tex b/macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example030.tex
new file mode 100644
index 0000000000..00a5e2fe49
--- /dev/null
+++ b/macros/latex/contrib/glossaries/glossaries-user-examples/glossaries-user-example030.tex
@@ -0,0 +1,31 @@
+% This file is embedded in glossaries-user.pdf
+% Example 30 Don't index entries that are only used once
+% arara: pdflatex
+% arara: pdflatex
+% arara: makeglossaries
+% arara: pdflatex
+% arara: pdfcrop
+\documentclass[12pt]{article}
+\pagestyle{empty}
+\usepackage[colorlinks]{hyperref}
+\usepackage[acronym]{glossaries}
+\makeglossaries
+
+\glsenableentrycount
+
+\setacronymstyle{long-short}
+
+\newacronym{html}{HTML}{hypertext markup language}
+\newacronym{css}{CSS}{cascading style sheets}
+\newacronym{xml}{XML}{extensible markup language}
+\newacronym{sql}{SQL}{structured query language}
+\newacronym{rdbms}{RDBMS}{relational database management system}
+\newacronym{rdsms}{RDSMS}{relational data stream management system}
+\begin{document}
+These entries are only used once: \cgls{sql}, \cgls{rdbms},
+\cgls{xml}. These entries are used multiple times:
+\cgls{html}, \cgls{html}, \cgls{css}, \cgls{css}, \cgls{css},
+\cgls{rdsms}, \cgls{rdsms}.
+
+\printglossaries
+\end{document}