glossaries-extra (9sep17)

git-svn-id: svn://tug.org/texlive/trunk@45251 c570f23f-e606-0410-a88d-b1316a301751

1 files changed, 2427 insertions, 32 deletions

diff --git a/Master/texmf-dist/source/latex/glossaries-extra/glossaries-extra.dtx b/Master/texmf-dist/source/latex/glossaries-extra/glossaries-extra.dtx
index 7ae270bd46b..3ead78d314b 100644
--- a/Master/texmf-dist/source/latex/glossaries-extra/glossaries-extra.dtx
+++ b/Master/texmf-dist/source/latex/glossaries-extra/glossaries-extra.dtx
@@ -1,17 +1,20 @@
 %\iffalse
 % glossaries-extra.dtx generated using makedtx version 1.2 (c) Nicola Talbot
 % Command line args:
-%   -codetitle "Main Package Code (\\styfmt{glossaries-extra.sty})"
+%   -comment ".*\.tex"
+%   -comment ".*\.bib"
 %   -author "Nicola Talbot"
-%   -doc "glossaries-extra-codedoc.tex"
 %   -macrocode ".*\.tex"
+%   -macrocode ".*\.bib"
+%   -section "chapter"
+%   -codetitle "Main Package Code (\\styfmt{glossaries-extra.sty})"
+%   -doc "glossaries-extra-codedoc.tex"
 %   -src "glossaries-extra.sty\Z=>glossaries-extra.sty"
 %   -src "glossaries-extra-stylemods.sty\Z=>glossaries-extra-stylemods.sty"
 %   -src "(example-glossaries-.+\.tex)\Z=>\1"
-%   -comment ".*\.tex"
-%   -section "chapter"
+%   -src "(example-glossaries-.+\.bib)\Z=>\1"
 %   glossaries-extra
-% Created on 2017/8/10 15:55
+% Created on 2017/9/8 22:43
 %\fi
 %\iffalse
 %<*package>
@@ -121,7 +124,7 @@ governed by the \gloskey{first} and \gloskey{firstplural} keys of
 
 \setcounter{IndexColumns}{2}
 
-\CheckSum{17436}
+\CheckSum{17566}
 
 \newcommand*{\ifirstuse}{\iterm{first use}}
 \newcommand*{\firstuse}{\gls{firstuse}}
@@ -161,13 +164,13 @@ governed by the \gloskey{first} and \gloskey{firstplural} keys of
  \raggedright
 }
 
-\title{glossaries-extra.sty v1.18:
+\title{glossaries-extra.sty v1.19:
  documented code}
 \author{Nicola L.C. Talbot\\[10pt]
 Dickimaw Books\\
 \url{http://www.dickimaw-books.com/}}
 
-\date{2017-08-10}
+\date{2017-09-08}
 
 \begin{document}
 \DocInput{glossaries-extra.dtx}
@@ -212,7 +215,7 @@ Dickimaw Books\\
 %\section{Package Initialisation and Options}
 %    \begin{macrocode}
 \NeedsTeXFormat{LaTeX2e}
-\ProvidesPackage{glossaries-extra}[2017/08/10 v1.18 (NLCT)]
+\ProvidesPackage{glossaries-extra}[2017/09/08 v1.19 (NLCT)]
 %    \end{macrocode}
 % Requires \sty{xkeyval} to define package options.
 %    \begin{macrocode}
@@ -389,6 +392,22 @@ Dickimaw Books\\
 %    \end{macrocode}
 %\end{macro}
 %
+%\begin{macro}{\@glsxtr@defaultnumberformat}
+%\changes{1.19}{2017-09-09}{new}
+%    \begin{macrocode}
+\newcommand*{\@glsxtr@defaultnumberformat}{glsnumberformat}%
+%    \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\GlsXtrSetDefaultNumberFormat}
+%\changes{1.19}{2017-09-09}{new}
+%    \begin{macrocode}
+\newcommand*{\GlsXtrSetDefaultNumberFormat}[1]{%
+  \renewcommand*{\@glsxtr@defaultnumberformat}{#1}%
+}%
+%    \end{macrocode}
+%\end{macro}
+%
 %\begin{macro}{\@@glsxtr@record}
 %\changes{1.08}{2016-12-13}{new}
 %This is the actual code that does the recording
@@ -399,9 +418,10 @@ Dickimaw Books\\
 %    \begin{macrocode}
 \newcommand*{\@@glsxtr@record}[3]{%
  \begingroup
-   \def\@glsnumberformat{glsnumberformat}%
+   \let\@glsnumberformat\@glsxtr@defaultnumberformat
    \def\@glsxtr@thevalue{}%
    \def\@glsxtr@theHvalue{\@glsxtr@thevalue}%
+   \let\@glsxtr@org@theHvalue\@glsxtr@theHvalue
    \ifcsdef{glo@#2@counter}%
    {%
      \edef\@gls@counter{\csname glo@#2@counter\endcsname}%
@@ -424,11 +444,20 @@ Dickimaw Books\\
        \ifdefempty{\@glsxtr@thevalue}%
        {%
 %    \end{macrocode}
+%Key \gloskey[glsadd]{thevalue} hasn't been set, but check if
+%\gloskey[glsadd]{theHvalue} has been set. (Not particularly likely,
+%but allow for it.)
+%    \begin{macrocode}
+         \ifx\@glsxtr@org@theHvalue\@glsxtr@theHvalue
+         \else
+           \let\theHglsentrycounter\@glsxtr@theHvalue
+         \fi
+%    \end{macrocode}
 %Save the entry counter.
 %    \begin{macrocode}
          \glsxtr@saveentrycounter
 %    \end{macrocode}
-%Temporarily redefine \cs{@@do@@wrglossary} so we can use
+%Temporarily redefine \cs{@@do@@wrglossary} for use with
 %\cs{glsxtr@@do@wrglossary}.
 %    \begin{macrocode}
          \let\@@do@@wrglossary\@glsxtr@dorecord
@@ -436,13 +465,22 @@ Dickimaw Books\\
        {%
 %    \end{macrocode}
 %\gloskey[glsadd]{thevalue} has been set, so there's no need to
-%defer writing the location value.
+%defer writing the location value. (If it's dependent on the page
+%counter, the \gloskey[glslink]{counter} key should be set instead.)
 %    \begin{macrocode}
          \let\theglsentrycounter\@glsxtr@thevalue
-         \def\theHglsentrycounter{\@glsxtr@theHvalue}%
+         \let\theHglsentrycounter\@glsxtr@theHvalue
          \let\@@do@@wrglossary\@glsxtr@dorecordnodefer
        }%
-       \glsxtr@@do@wrglossary{#2}%
+       \ifx\@glsxtr@record@setting\@glsxtr@record@setting@alsoindex
+         \glsxtr@@do@wrglossary{#2}%
+       \else
+%    \end{macrocode}
+%No need to escape special characters, but need to save the label.
+%    \begin{macrocode}
+         \edef\@gls@label{\glsdetoklabel{#2}}%
+         \@@do@@wrglossary
+       \fi
      }%
    \fi
  \endgroup
@@ -453,24 +491,53 @@ Dickimaw Books\\
 %\begin{macro}{\@glsxtr@dorecord}
 %\changes{1.08}{2016-12-13}{new}
 %\changes{1.15}{2017-05-10}{corrected premature expansion of \cs{@glslocref}}
+%If \pkgopt[alsoindex]{record} is used, then \cs{@glslocref} may
+%have been escaped, but this isn't appropriate here.
+%\changes{1.19}{2017-09-09}{Use \cs{@glsrecordlocref} instead of \cs{@glslocref}}
 %    \begin{macrocode}
 \newcommand*\@glsxtr@dorecord{%
-   \protected@write\@auxout{\let\@glslocref\relax}{\string\glsxtr@record
+   \global\let\@glsrecordlocref\theglsentrycounter
+   \let\@glsxtr@orgprefix\@glo@counterprefix
+   \ifx\theglsentrycounter\theHglsentrycounter
+     \def\@glo@counterprefix{}%
+   \else
+     \edef\@do@gls@getcounterprefix{\noexpand\@gls@getcounterprefix
+       {\theglsentrycounter}{\theHglsentrycounter}%
+     }%
+     \@do@gls@getcounterprefix
+   \fi
+   \protected@write\@auxout{\let\@glsrecordlocref\relax}{\string\glsxtr@record
       {\@gls@label}{\@glo@counterprefix}{\@gls@counter}{\@glsnumberformat}%
-      {\@glslocref}}%
+      {\@glsrecordlocref}}%
    \@glsxtr@counterrecordhook
+   \let\@glo@counterprefix\@glsxtr@orgprefix
 }
 %    \end{macrocode}
 %\end{macro}
 %
 %\begin{macro}{\@glsxtr@dorecordnodefer}
 %\changes{1.16}{2017-06-15}{new}
-%As above, but don't defer expansion of location.
+%As above, but don't defer expansion of location. This uses
+%\cs{theglsentrycounter} directly for the location
+%rather than \cs{@glslocref} since there's no need to guard against
+%premature expansion of the page counter.
+%\changes{1.19}{2017-09-09}{Use \cs{theglsentrycounter} for the location
+%rather than \cs{@glslocref}}
 %    \begin{macrocode}
 \newcommand*\@glsxtr@dorecordnodefer{%
-   \protected@write\@auxout{}{\string\glsxtr@record
-      {\@gls@label}{\@glo@counterprefix}{\@gls@counter}{\@glsnumberformat}%
-      {\@glslocref}}%
+   \ifx\theglsentrycounter\theHglsentrycounter
+     \protected@write\@auxout{}{\string\glsxtr@record
+        {\@gls@label}{}{\@gls@counter}{\@glsnumberformat}%
+        {\theglsentrycounter}}%
+   \else
+    \edef\@do@gls@getcounterprefix{\noexpand\@gls@getcounterprefix
+      {\theglsentrycounter}{\theHglsentrycounter}%
+    }%
+    \@do@gls@getcounterprefix
+     \protected@write\@auxout{}{\string\glsxtr@record
+        {\@gls@label}{\@glo@counterprefix}{\@gls@counter}{\@glsnumberformat}%
+        {\theglsentrycounter}}%
+   \fi
    \@glsxtr@counterrecordhook
 }
 %    \end{macrocode}
@@ -597,6 +664,21 @@ Dickimaw Books\\
 %    \end{macrocode}
 %\end{macro}
 %
+%\begin{macro}{\@glsxtr@record@setting}
+%\changes{1.19}{2017-09-09}{new}
+%Keep track of the \pkgopt{record} package option.
+%    \begin{macrocode}
+\newcommand*{\@glsxtr@record@setting}{off}
+%    \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\@glsxtr@record@setting@alsoindex}
+%\changes{1.19}{2017-09-09}{new}
+%    \begin{macrocode}
+\newcommand*{\@glsxtr@record@setting@alsoindex}{alsoindex}
+%    \end{macrocode}
+%\end{macro}
+%
 %Now define the \pkgopt{record} package option.
 %\changes{1.08}{2016-12-13}{added \pkgopt{record} package option}
 %    \begin{macrocode}
@@ -604,6 +686,7 @@ Dickimaw Books\\
  {off,only,alsoindex}%
  [only]%
  {%
+   \let\@glsxtr@record@setting\val
    \ifcase\nr\relax
 %    \end{macrocode}
 %Don't record.
@@ -1562,6 +1645,43 @@ Dickimaw Books\\
 %    \end{macrocode}
 %\end{macro}
 %
+%\begin{macro}{\glsxtrifhasfield}
+%\changes{1.19}{2017-09-09}{new}
+%A simpler alternative to \cs{ifglshasfield} that doesn't complain
+%if the entry or the field doesn't exist. (No mapping is used.)
+%Grouping is added to the unstarred version allow for nested use.
+%    \begin{macrocode}
+\newrobustcmd{\glsxtrifhasfield}{%
+  \@ifstar{\s@glsxtrifhasfield}{\@glsxtrifhasfield}%
+}
+%    \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\@glsxtrifhasfield}
+%\changes{1.19}{2017-09-09}{new}
+%Unstarred version adds grouping.
+%    \begin{macrocode}
+\newcommand{\@glsxtrifhasfield}[4]{%
+  {\s@glsxtrifhasfield{#1}{#2}{#3}{#4}}%
+}
+%    \end{macrocode}
+%\end{macro}
+%
+%\begin{macro}{\s@glsxtrifhasfield}
+%\changes{1.19}{2017-09-09}{new}
+% Starred version omits grouping.
+%    \begin{macrocode}
+\newcommand{\s@glsxtrifhasfield}[4]{%
+  \letcs{\glscurrentfieldvalue}{glo@\glsdetoklabel{#2}@#1}%
+  \ifdef\glscurrentfieldvalue
+  {%
+   \ifdefempty\glscurrentfieldvalue{#4}{#3}%
+  }%
+  {#4}%
+}
+%    \end{macrocode}
+%\end{macro}
+%
 %\begin{macro}{\glsxtrusefield}
 %\changes{1.12}{2017-02-03}{new}
 %Provide a user-level alternative to \cs{@gls@entry@field}.
@@ -3320,6 +3440,16 @@ Dickimaw Books\\
   \fi
 }
 %    \end{macrocode}
+%\changes{1.19}{2017-09-09}{added \cs{glslink} option \texttt{thevalue}}
+%    \begin{macrocode}
+\define@key{glslink}{thevalue}{\def\@glsxtr@thevalue{#1}}
+%    \end{macrocode}
+%
+%\changes{1.19}{2017-09-09}{added \cs{glslink} option \texttt{theHvalue}}
+%    \begin{macrocode}
+\define@key{glslink}{theHvalue}{\def\@glsxtr@theHvalue{#1}}
+%    \end{macrocode}
+%
 %
 %\begin{macro}{\@gls@link}
 %\changes{1.14}{2017-04-18}{added redefinition}
@@ -3334,11 +3464,16 @@ Dickimaw Books\\
   \edef\glslabel{\glsdetoklabel{#2}}%
   \def\@gls@link@opts{#1}%
   \let\@gls@link@label\glslabel
-  \def\@glsnumberformat{glsnumberformat}%
+  \let\@glsnumberformat\@glsxtr@defaultnumberformat
   \edef\@gls@counter{\csname glo@\glslabel @counter\endcsname}%
   \edef\glstype{\csname glo@\glslabel @type\endcsname}%
   \let\org@ifKV@glslink@hyper\ifKV@glslink@hyper
 %    \end{macrocode}
+% Initialise thevalue and theHvalue (v1.19).
+%    \begin{macrocode}
+  \def\@glsxtr@thevalue{}%
+  \def\@glsxtr@theHvalue{\@glsxtr@thevalue}%
+%    \end{macrocode}
 % Initialise when indexing should occur (new to v1.14).
 %    \begin{macrocode}
   \glsxtrinitwrgloss
@@ -3351,7 +3486,18 @@ Dickimaw Books\\
   \do@gls@link@checkfirsthyper
   \setkeys{glslink}{#1}%
   \glslinkpostsetkeys
-  \@gls@saveentrycounter
+%    \end{macrocode}
+% Check \gloskey[glslink]{thevalue} and \gloskey[glslink]{theHvalue}
+% before saving (v1.19).
+%    \begin{macrocode}
+  \ifdefempty{\@glsxtr@thevalue}%
+  {%
+    \@gls@saveentrycounter
+  }%
+  {%
+    \let\theglsentrycounter\@glsxtr@thevalue
+    \def\theHglsentrycounter{\@glsxtr@theHvalue}%
+  }%
   \@gls@setsort{\glslabel}%
 %    \end{macrocode}
 % Do write if it should occur before the link text:
@@ -3401,7 +3547,7 @@ Dickimaw Books\\
   \@glsxtr@record{#1}{#2}{glossadd}%
   \glsdoifexists{#2}%
   {%
-    \def\@glsnumberformat{glsnumberformat}%
+    \let\@glsnumberformat\@glsxtr@defaultnumberformat
     \edef\@gls@counter{\csname glo@\glsdetoklabel{#2}@counter\endcsname}%
     \def\@glsxtr@thevalue{}%
     \def\@glsxtr@theHvalue{\@glsxtr@thevalue}%
@@ -4597,7 +4743,7 @@ Dickimaw Books\\
  \ifKV@glslink@noindex 
  \else
    \begingroup
-   \def\@glsnumberformat{glsnumberformat}%
+   \let\@glsnumberformat\@glsxtr@defaultnumberformat
    \edef\@gls@counter{\csname glo@\glsdetoklabel{\glslabel}@counter\endcsname}%
    \glsxtr@saveentrycounter
    \@@do@wrglossary{\glsxtralias{\glslabel}}%
@@ -4813,13 +4959,13 @@ Dickimaw Books\\
    \glsfieldfetch{\glslabel}{alias}{\gloaliaslabel}%
    \ifdefvoid\gloaliaslabel
    {%
-     \hyperlink{#1}{{\glsxtrprotectlinks#2}}%
+     \glsxtrhyperlink{#1}{{\glsxtrprotectlinks#2}}%
    }%
    {%
 %    \end{macrocode}
 %Redirect link to the alias target.
 %    \begin{macrocode}
-     \hyperlink
+     \glsxtrhyperlink
      {\glolinkprefix\glsdetoklabel{\gloaliaslabel}}%
      {{\glsxtrprotectlinks#2}}%
    }%
@@ -4827,6 +4973,24 @@ Dickimaw Books\\
 }
 %    \end{macrocode}
 %\end{macro}
+
+%\begin{macro}{\glsxtrhyperlink}
+%\changes{1.19}{2017-09-09}{new}
+%Allows integration with the base \styfmt{glossaries} package's
+%\pkgopt[showtargets]{debug} option.
+%    \begin{macrocode}
+\ifdef\@glsshowtarget
+{
+  \newcommand{\glsxtrhyperlink}[2]{%
+    \@glsshowtarget{#1}%
+    \hyperlink{#1}{#2}%
+  }%
+}
+{
+  \newcommand{\glsxtrhyperlink}[2]{\hyperlink{#1}{#2}}%
+}
+%    \end{macrocode}
+%\end{macro}
 %
 %\begin{macro}{\glsdisablehyper}
 %\changes{1.14}{2017-04-18}{added redefinition}
@@ -7227,7 +7391,7 @@ Dickimaw Books\\
 \newcommand*{\glsxtrlocationhyperlink}[3]{%
   \ifdefvoid\glsxtrsupplocationurl
   {%
-    \hyperlink{#1#2#3}{#3}%
+    \glsxtrhyperlink{#1#2#3}{#3}%
   }%
   {%
     \hyperref{\glsxtrsupplocationurl}{}{#1#2#3}{#3}%
@@ -7694,10 +7858,14 @@ Dickimaw Books\\
 %If the \pkgopt{automake} option is on, try running bib2gls if
 %the aux file exists.
 %\changes{1.14}{2017-04-18}{added check for automake}
+%\changes{1.19}{2017-09-09}{removed double-quotes around \cs{jobname}}
+%The double-quotes around \cs{jobname} have been removed (v1.19)
+%since \cs{jobname} will include double-quotes if the file name has
+%spaces.
 %    \begin{macrocode}
   \ifglsautomake
     \IfFileExists{\jobname.aux}%
-    {\immediate\write18{bib2gls "\jobname"}}{}%
+    {\immediate\write18{bib2gls \jobname}}{}%
 %    \end{macrocode}
 %If \cs{makeglossaries} is also used, allow makeindex/xindy to
 %also be run, otherwise disable the error message about requiring
@@ -9646,7 +9814,7 @@ Dickimaw Books\\
 % The argument is the entry's label.
 %    \begin{macrocode}
 \newcommand*{\glsxtrpostnamehook}[1]{%
-  \def\@glsnumberformat{glsnumberformat}%
+  \let\@glsnumberformat\@glsxtr@defaultnumberformat
   \glsxtrdoautoindexname{#1}{indexname}%
 %    \end{macrocode}
 % Allow categories to hook in here.
@@ -9717,8 +9885,13 @@ Dickimaw Books\\
 %    \begin{macrocode}
     \protected@edef\@glsxtr@attrval{\glsgetattribute{#1}{#2}}%
     \if@glsxtr@format@override
-      \ifdefstring{\@glsnumberformat}{glsnumberformat}{}%
-      {\let\@glsxtr@attrval\@glsnumberformat}%
+%    \end{macrocode}
+%\changes{1.19}{2017-09-09}{changed format test}
+%    \begin{macrocode}
+      \ifx\@glsnumberformat\@glsxtr@defaultnumberformat
+      \else
+        \let\@glsxtr@attrval\@glsnumberformat
+      \fi
     \fi
     \ifdefstring{\@glsxtr@attrval}{true}%
     {}%
@@ -18669,7 +18842,7 @@ Dickimaw Books\\
 % First identify package:
 %    \begin{macrocode}
 \NeedsTeXFormat{LaTeX2e}
-\ProvidesPackage{glossaries-extra-stylemods}[2017/08/10 v1.18 (NLCT)]
+\ProvidesPackage{glossaries-extra-stylemods}[2017/09/08 v1.19 (NLCT)]
 %    \end{macrocode}
 % Provide package options to automatically load required predefined
 % styles. The simplest method is to just test for the existence of
@@ -19830,5 +20003,2227 @@ Dickimaw Books\\
 %</example-glossaries-xr.tex>
 %    \end{macrocode}
 %\fi
+%\iffalse
+%    \begin{macrocode}
+%<*example-glossaries-acronym-desc.bib>
+%    \end{macrocode}
+%\fi
+%\iffalse
+%    \begin{macrocode}
+% Encoding: UTF-8
+@acronym{ndl,
+  description = {fringilla a, euismod sodales,
+  sollicitudin vel, wisi},
+  short = {NDL},
+  long = {nam dui ligula}
+}
+
+@acronym{mal,
+  description = {non justo},
+  short = {MAL},
+  long = {morbi auctor lorem}
+}
+
+@acronym{nll,
+  description = {pretium at, lobortis vitae, ultricies et,
+tellus},
+  short = {NLL},
+  long = {name lacus libero}
+}
+
+@acronym{da,
+  description = {tortor sed accumsan bibendum, erat ligula
+aliquet magna, vitae ornare odio metus a mi},
+  short = {DA},
+  long = {donec aliquet}
+}
+
+@acronym{mao,
+  description = {et nisl hendrerit mollis},
+  short = {MAO},
+  long = {morbi ac orci}
+}
+
+@acronym{sum,
+  description = {cras nec ante},
+  short = {SUM},
+  long = {suspendisse ut massa}
+}
+
+@acronym{pan,
+  description = {cum sociis natoque penatibus et magnis dis
+parturient montes, nascetur ridiculus mus},
+  short = {PAN},
+  long = {pellentesque a nulla}
+}
+
+@acronym{atu,
+  description = {nulla ullamcorper vestibulum 
+turpis},
+  short = {ATU},
+  long = {aliquam tincidunt urna}
+}
+
+@acronym{pclm,
+  description = {nulla malesuada porttitor diam},
+  short = {PCLM},
+  long = {pellentesque cursus luctus mauris}
+}
+
+%    \end{macrocode}
+%\fi
+%\iffalse
+%    \begin{macrocode}
+%</example-glossaries-acronym-desc.bib>
+%    \end{macrocode}
+%\fi
+%\iffalse
+%    \begin{macrocode}
+%<*example-glossaries-acronym.bib>
+%    \end{macrocode}
+%\fi
+%\iffalse
+%    \begin{macrocode}
+% Encoding: UTF-8
+@acronym{lid,
+  short = {LID},
+  long = {lorem ipsum dolor}
+}
+
+@acronym{stc,
+  short = {STC},
+  long = {sit amet consectetuer}
+}
+
+@acronym{aeu,
+  short = {AEU},
+  long = {adipiscing elit ut}
+}
+
+@acronym{pev,
+  short = {PEV},
+  long = {purus elit vestibulum}
+}
+
+@acronym{upa,
+  short = {UPA},
+  long = {ut placerat ac}
+}
+
+@acronym{avf,
+  short = {AVF},
+  long = {adipiscing vitae felis}
+}
+
+@acronym{cdg,
+  short = {CDG},
+  long = {curabitur dictum gravida}
+}
+
+@acronym{mna,
+  short = {MNA},
+  long = {mauris nam arcu}
+}
+
+@acronym{lne,
+  short = {LNE},
+  long = {libero nonummy eget}
+}
+
+@acronym{civ,
+  short = {CIV},
+  long = {consectetuer id vulputate}
+}
+
+@acronym{amd,
+  short = {AMD},
+  long = {a magna donec}
+}
+
+@acronym{vae,
+  short = {VAE},
+  long = {vehicula augue eu}
+}
+
+@acronym{nph,
+  short = {NPH},
+  long = {neque pellentesque habitant}
+}
+
+@acronym{mts,
+  short = {MTS},
+  long = {morbi tristique senectus}
+}
+
+@acronym{ene,
+  short = {ENE},
+  long = {et netus et}
+}
+
+@acronym{mfa,
+  short = {MFA},
+  long = {malesuada fames ac}
+}
+
+@acronym{tem,
+  short = {TEM},
+  long = {turpis egestas mauris}
+}
+
+@acronym{ulc,
+  short = {ULC},
+  long = {ut leo cras}
+}
+
+@acronym{vmr,
+  short = {VMR},
+  long = {viverra metus rhoncus}
+}
+
+@acronym{sne,
+  short = {SNE},
+  long = {sem nulla et}
+}
+
+@acronym{lvu,
+  short = {LVU},
+  long = {lectus vestibulum urna}
+}
+
+@acronym{fup,
+  short = {FUP},
+  long = {fringilla ultrices phasellus}
+}
+
+@acronym{ets,
+  short = {ETS},
+  long = {eu tellus sit}
+}
+
+@acronym{atg,
+  short = {ATG},
+  long = {amet tortor gravida}
+}
+
+@acronym{pis,
+  short = {PIS},
+  long = {placerat integer sapien}
+}
+
+@acronym{eii,
+  short = {EII},
+  long = {est iaculis in}
+}
+
+@acronym{pqv,
+  short = {PQV},
+  long = {pretium quis viverra}
+}
+
+@acronym{anp,
+  short = {ANP},
+  long = {ac nunc praesent}
+}
+
+@acronym{esv,
+  short = {ESV},
+  long = {eget sem vel}
+}
+
+@acronym{lub,
+  short = {LUB},
+  long = {leo ultrices bibendum}
+}
+
+@acronym{afm,
+  short = {AFM},
+  long = {aenean faucibus morbi}
+}
+
+@acronym{dnm,
+  short = {DNM},
+  long = {dolor nulla malesuada}
+}
+
+@acronym{epa,
+  short = {EPA},
+  long = {eu pulvinar at}
+}
+
+@acronym{man,
+  short = {MAC},
+  long = {mollis ac nulla}
+}
+
+@acronym{cas,
+  short = {CAS},
+  long = {curabitur auctor semper}
+}
+
+@acronym{ndv,
+  short = {NDV},
+  long = {nulla donec varius}
+}
+
+@acronym{oer,
+  short = {OER},
+  long = {orci eget risus}
+}
+
+@acronym{dnmc,
+  short = {DNMC},
+  long = {duis nibh mi congue}
+}
+
+@acronym{cea,
+  short = {CEA},
+  long = {congue eu accumsan}
+}
+
+@acronym{esq,
+  short = {ESQ},
+  long = {eleifend sagittis quis}
+}
+
+@acronym{dia,
+  short = {DIA},
+  long = {duis eget orci}
+}
+
+@acronym{sao,
+  short = {SAO},
+  long = {sit amet orci}
+}
+
+@acronym{drn,
+  short = {DRN},
+  long = {dignissim rutrum nam}
+}
+
+%    \end{macrocode}
+%\fi
+%\iffalse
+%    \begin{macrocode}
+%</example-glossaries-acronym.bib>
+%    \end{macrocode}
+%\fi
+%\iffalse
+%    \begin{macrocode}
+%<*example-glossaries-acronyms-lang.bib>
+%    \end{macrocode}
+%\fi
+%\iffalse
+%    \begin{macrocode}
+% Encoding: UTF-8
+@acronym{li,
+  user1 = {love itself},
+  short = {LI},
+  long = {lorem ipsum}
+}
+
+@acronym{np,
+  user1 = {produces none},
+  short = {NP},
+  long = {nulla pariatur}
+}
+
+@acronym{sic,
+  user1 = {blame belongs},
+  short = {SIC},
+  long = {sunt in culpa}
+}
+
+@acronym{esoc,
+  user1 = {blinded by
+desire},
+  short = {ESOC},
+  long = {excepturi sint obcaecati cupiditat}
+}
+
+@acronym{nmruu,
+  short = {NMRUU},
+  long = {nulla malesuada
+risus ut urna}
+}
+
+@acronym{di,
+  short = {DI},
+  long = {duis iaculi}
+}
+
+%    \end{macrocode}
+%\fi
+%\iffalse
+%    \begin{macrocode}
+%</example-glossaries-acronyms-lang.bib>
+%    \end{macrocode}
+%\fi
+%\iffalse
+%    \begin{macrocode}
+%<*example-glossaries-brief.bib>
+%    \end{macrocode}
+%\fi
+%\iffalse
+%    \begin{macrocode}
+% Encoding: UTF-8
+@entry{lorem,
+  name = {lorem},
+  description = {ipsum}
+}
+
+@entry{dolor,
+  name = {dolor},
+  description = {sit}
+}
+
+@entry{amet,
+  name = {amet},
+  description = {consectetuer}
+}
+
+@entry{adipiscing,
+  name = {adipiscing},
+  description = {elit}
+}
+
+@entry{ut,
+  name = {ut},
+  description = {purus}
+}
+
+@entry{elit,
+  name = {elit},
+  description = {vestibulum}
+}
+
+@entry{placerat,
+  name = {placerat},
+  description = {ac}
+}
+
+@entry{vitae,
+  name = {vitae},
+  description = {felis}
+}
+
+@entry{curabitur,
+  name = {curabitur},
+  description = {gravida}
+}
+
+@entry{mauris,
+  name = {mauris},
+  description = {nam}
+}
+
+@entry{arcu,
+  name = {arcu},
+  description = {libero}
+}
+
+@entry{nonummy,
+  name = {nonummy},
+  description = {eget}
+}
+
+@entry{consectetuer,
+  name = {consectetuer},
+  description = {id}
+}
+
+@entry{vulputate,
+  name = {vulputate},
+  description = {a magna}
+}
+
+@entry{donec,
+  name = {donec},
+  description = {vehicula}
+}
+
+@entry{augue,
+  name = {augue},
+  description = {eu neque}
+}
+
+@entry{pellentesque,
+  name = {pellentesque},
+  description = {habitant}
+}
+
+@entry{morbi,
+  name = {morbi},
+  description = {tristique}
+}
+
+@entry{senectus,
+  name = {senectus},
+  description = {et netus}
+}
+
+@entry{et,
+  name = {et},
+  description = {malesuada}
+}
+
+@entry{fames,
+  name = {fames},
+  description = {ac}
+}
+
+@entry{turpis,
+  name = {turpis},
+  description = {egestas}
+}
+
+@entry{leo,
+  name = {leo},
+  description = {cras}
+}
+
+@entry{viverra,
+  name = {viverra},
+  description = {metus}
+}
+
+@entry{rhoncus,
+  name = {rhoncus},
+  description = {sem}
+}
+
+@entry{nulla,
+  name = {nulla},
+  description = {et}
+}
+
+@entry{lectus,
+  name = {lectus},
+  description = {vestibulum}
+}
+
+@entry{urna,
+  name = {urna},
+  description = {fringilla}
+}
+
+@entry{ultrices,
+  name = {ultrices},
+  description = {phasellus}
+}
+
+@entry{eu,
+  name = {eu},
+  description = {tellus}
+}
+
+@entry{sit,
+  name = {sit},
+  description = {amet}
+}
+
+@entry{tortor,
+  name = {tortor},
+  description = {gravida}
+}
+
+@entry{integer,
+  name = {integer},
+  description = {sapien}
+}
+
+@entry{est,
+  name = {est},
+  description = {iaculis}
+}
+
+@entry{in,
+  name = {in},
+  description = {pretium}
+}
+
+@entry{quis,
+  name = {quis},
+  description = {viverra}
+}
+
+@entry{ac,
+  name = {ac},
+  description = {nunc}
+}
+
+@entry{praesent,
+  name = {praesent},
+  description = {eget}
+}
+
+@entry{sem,
+  name = {sem},
+  description = {vel leo}
+}
+
+@entry{bibendum,
+  name = {bibendum},
+  description = {ultrices}
+}
+
+@entry{aenean,
+  name = {aenean},
+  description = {faucibus}
+}
+
+@entry{malesuada,
+  name = {malesuada},
+  description = {eu}
+}
+
+@entry{pulvinar,
+  name = {pulvinar},
+  description = {at}
+}
+
+@entry{mollis,
+  name = {mollis},
+  description = {ac nulla}
+}
+
+@entry{auctor,
+  name = {auctor},
+  description = {semper}
+}
+
+@entry{varius,
+  name = {varius},
+  description = {orci}
+}
+
+@entry{eget,
+  name = {eget},
+  description = {risus}
+}
+
+@entry{duis,
+  name = {duis},
+  description = {nibh}
+}
+
+@entry{mi,
+  name = {mi},
+  description = {congue}
+}
+
+@entry{accumsan,
+  name = {accumsan},
+  description = {eleifend}
+}
+
+@entry{sagittis,
+  name = {sagittis},
+  description = {quis}
+}
+
+@entry{diam,
+  name = {diam},
+  description = {duis}
+}
+
+@entry{orci,
+  name = {orci},
+  description = {dignissim}
+}
+
+%    \end{macrocode}
+%\fi
+%\iffalse
+%    \begin{macrocode}
+%</example-glossaries-brief.bib>
+%    \end{macrocode}
+%\fi
+%\iffalse
+%    \begin{macrocode}
+%<*example-glossaries-childnoname.bib>
+%    \end{macrocode}
+%\fi
+%\iffalse
+%    \begin{macrocode}
+% Encoding: UTF-8
+@entry{scelerisque,
+  name = {scelerisque},
+  description = {at}
+}
+
+@entry{vestibulum,
+  parent = {scelerisque},
+  description = {eu, nulla}
+}
+
+@entry{utodionisl,
+  parent = {scelerisque},
+  description = {facilisis id}
+}
+
+@entry{molliset,
+  parent = {scelerisque},
+  description = {nec, enim}
+}
+
+@entry{aeneansem,
+  parent = {scelerisque},
+  description = {sem leo}
+}
+
+@entry{pellentesquesit,
+  parent = {scelerisque},
+  description = {sit amet}
+}
+
+@entry{sapien,
+  parent = {scelerisque},
+  description = {vehicula
+pellentesque}
+}
+
+@entry{consequat,
+  parent = {scelerisque},
+  description = {tellus
+et tortor}
+}
+
+@entry{uttempor,
+  name = {ut tempor},
+  description = {laoreet
+quam}
+}
+
+@entry{nullamid,
+  parent = {uttempor},
+  description = {wisi a
+libero}
+}
+
+@entry{tristique,
+  parent = {uttempor},
+  description = {semper}
+}
+
+@entry{nullamnislmassa,
+  parent = {uttempor},
+  description = {rutrum
+ut}
+}
+
+@entry{eleifend,
+  name = {eleifend},
+  description = {sit amet
+faucibus}
+}
+
+@entry{elementum,
+  parent = {eleifend},
+  description = {elementum}
+}
+
+@entry{urnasapien,
+  parent = {eleifend},
+  description = {urna sapien}
+}
+
+@entry{consectetuermauris,
+  name = {consectetuer},
+  description = {mauris}
+}
+
+@entry{quisegestas,
+  parent = {consectetuermauris},
+  description = {quis egestas}
+}
+
+@entry{leojusto,
+  parent = {consectetuermauris},
+  description = {leo
+justo}
+}
+
+@entry{nonrisus,
+  name = {non risus},
+  description = {morbi non
+felis}
+}
+
+@entry{aclibero,
+  parent = {nonrisus},
+  description = {ac libero}
+}
+
+@entry{vulputatefringilla,
+  parent = {nonrisus},
+  description = {vulputate
+fringilla}
+}
+
+@entry{maurislibero,
+  name = {mauris},
+  description = {libero eros}
+}
+
+@entry{lacinia,
+  parent = {maurislibero},
+  description = {lacinia
+non}
+}
+
+@entry{sodales,
+  parent = {maurislibero},
+  description = {sodales
+quis}
+}
+
+@entry{dapibus,
+  parent = {maurislibero},
+  description = {dapibus
+porttitor, pede}
+}
+
+@entry{class,
+  name = {class},
+  description = {aptent taciti}
+}
+
+@entry{sociosqu,
+  parent = {class},
+  description = {sociosqu}
+}
+
+@entry{adlitora,
+  parent = {class},
+  description = {ad litora}
+}
+
+@entry{torquent,
+  parent = {class},
+  description = {torquent per
+conubia}
+}
+
+@entry{nostra,
+  name = {nostra},
+  description = {per inceptos
+hymenaeos}
+}
+
+@entry{morbidapibus,
+  parent = {nostra},
+  description = {morbi
+dapibus}
+}
+
+@entry{mauriscondimentum,
+  parent = {nostra},
+  description = {mauris
+condimentum nulla}
+}
+
+@entry{cumsociis,
+  name = {cum sociis},
+  description = {natoque
+penatibus}
+}
+
+@entry{etmagnis,
+  parent = {cumsociis},
+  description = {et
+magnis}
+}
+
+@entry{disparturient,
+  parent = {cumsociis},
+  description = {dis
+parturient montes}
+}
+
+%    \end{macrocode}
+%\fi
+%\iffalse
+%    \begin{macrocode}
+%</example-glossaries-childnoname.bib>
+%    \end{macrocode}
+%\fi
+%\iffalse
+%    \begin{macrocode}
+%<*example-glossaries-cite.bib>
+%    \end{macrocode}
+%\fi
+%\iffalse
+%    \begin{macrocode}
+% Encoding: UTF-8
+@entry{fusce,
+  user1 = {article-minimal},
+  name = {fusce},
+  description = {suscipit cursus sem}
+}
+
+@entry{vivamus,
+  user1 = {article-full},
+  name = {vivamus},
+  description = {risus mi, egestas ac}
+}
+
+@entry{imperdiet,
+  user1 = {whole-journal},
+  name = {imperdiet},
+  description = {varius, faucibus quis, leo}
+}
+
+@entry{aenean2,
+  user1 = {inbook-minimal},
+  name = {aenean},
+  description = {tincidunt}
+}
+
+@entry{crasid,
+  user1 = {inbook-full},
+  name = {cras id},
+  description = {justo quis nibh scelerisque dignissim}
+}
+
+@entry{aliquam2,
+  user1 = {book-minimal},
+  name = {aliquam},
+  description = {sagittis elementum dolor}
+}
+
+@entry{aeneanconsectetuer,
+  user1 = {book-full},
+  name = {aenean consectetuer},
+  description = {justo in pede}
+}
+
+@entry{curabiturullamcorper,
+  user1 = {booklet-minimal},
+  name = {curabitur ullamcorper},
+  description = {ligula nec orci}
+}
+
+@entry{aliquampurus,
+  user1 = {booklet-full},
+  name = {aliquam purus},
+  description = {turpis, aliquam id}
+}
+
+@entry{ornarevitae,
+  user1 = {incollection-minimal},
+  name = {ornare vitae},
+  description = {porttitor non, wisi}
+}
+
+@entry{maecenasluctus,
+  user1 = {incollection-full},
+  name = {maecenas luctus},
+  description = {porta lorem}
+}
+
+@entry{donecvitae,
+  user1 = {manual-minimal},
+  name = {donec vitae},
+  description = {ligula eu ante pretium varius}
+}
+
+@entry{proin,
+  user1 = {manual-full},
+  name = {proin},
+  description = {tortor metus, convallis et}
+}
+
+@entry{hendrerit,
+  user1 = {mastersthesis-minimal},
+  name = {hendrerit},
+  description = {non, scelerisque in, urna}
+}
+
+@entry{crasquis,
+  user1 = {mastersthesis-full},
+  name = {cras qui},
+  description = {libero eu ligula bibendum tempor}
+}
+
+@entry{vivamustellus,
+  user1 = {misc-minimal},
+  name = {vivamus tellus},
+  description = {quam, malesuada eu, tempus sed, tempor sed, velit}
+}
+
+@entry{doneclacinia,
+  user1 = {misc-full},
+  name = {donec lacinia},
+  description = {auctor libero}
+}
+
+@entry{praesent2,
+  user1 = {inproceedings-minimal},
+  name = {praesent},
+  description = {sed neque id pede mollis rutrum}
+}
+
+@entry{vestibulum2,
+  user1 = {inproceedings-minimal,phdthesis-minimal},
+  name = {vestibulum},
+  description = {iaculis risus}
+}
+
+@entry{pellentesque2,
+  name = {pellentesque},
+  description = {lacus}
+}
+
+%    \end{macrocode}
+%\fi
+%\iffalse
+%    \begin{macrocode}
+%</example-glossaries-cite.bib>
+%    \end{macrocode}
+%\fi
+%\iffalse
+%    \begin{macrocode}
+%<*example-glossaries-images.bib>
+%    \end{macrocode}
+%\fi
+%\iffalse
+%    \begin{macrocode}
+% Encoding: UTF-8
+@entry{sedfeugiat,
+  user1 = {example-image},
+  name = {sed feugiat},
+  description = {Cum sociis natoque penatibus et magnis dis parturient montes,
+nascetur ridiculus mus. Ut pellentesque augue sed urna. Vestibulum
+diam eros, fringilla et, consectetuer eu, nonummy id, sapien. Nullam
+at lectus. In sagittis ultrices mauris. Curabitur malesuada erat sit
+amet massa. Fusce blandit. Aliquam erat volutpat.  Aliquam euismod.
+Aenean vel lectus.  Nunc imperdiet justo nec dolor.
+
+Etiam euismod. Fusce facilisis lacinia dui.  Suspendisse potenti. In
+mi erat, cursus id, nonummy sed, ullamcorper eget, sapien. Praesent
+pretium, magna in eleifend egestas, pede pede pretium lorem, quis
+consectetuer tortor sapien facilisis magna.  Mauris quis magna
+varius nulla scelerisque imperdiet. Aliquam non quam. Aliquam
+porttitor quam a lacus. Praesent vel arcu ut tortor cursus volutpat.
+In vitae pede quis diam bibendum placerat. Fusce elementum convallis
+neque. Sed dolor orci, scelerisque ac, dapibus nec, ultricies ut,
+mi. Duis nec dui quis leo sagittis commodo.
+}
+}
+
+@entry{aliquamlectus,
+  user1 = {example-image-a},
+  name = {aliquam lectus},
+  description = {Vivamus leo. Quisque ornare tellus ullamcorper nulla. Mauris
+porttitor pharetra tortor. Sed fringilla justo sed mauris. Mauris
+tellus. Sed non leo. Nullam elementum, magna in cursus sodales,
+augue est scelerisque sapien, venenatis congue nulla arcu et pede.
+Ut suscipit enim vel sapien.  Donec congue. Maecenas urna mi,
+suscipit in, placerat ut, vestibulum ut, massa. Fusce ultrices nulla
+et nisl.
+
+Etiam ac leo a risus tristique nonummy. Donec dignissim tincidunt
+nulla. Vestibulum rhoncus molestie odio. Sed lobortis, justo et
+pretium lobortis, mauris turpis condimentum augue, nec ultricies
+nibh arcu pretium enim. Nunc purus neque, placerat id, imperdiet
+sed, pellentesque nec, nisl. Vestibulum imperdiet neque non sem
+accumsan laoreet. In hac habitasse platea dictumst. Etiam
+condimentum facilisis libero. Suspendisse in elit quis nisl aliquam
+dapibus. Pellentesque auctor sapien. Sed egestas sapien nec lectus.
+Pellentesque vel dui vel neque bibendum viverra.  Aliquam porttitor
+nisl nec pede. Proin mattis libero vel turpis.  Donec rutrum mauris
+et libero. Proin euismod porta felis. Nam lobortis, metus quis
+elementum commodo, nunc lectus elementum mauris, eget vulputate
+ligula tellus eu neque. Vivamus eu dolor.
+}
+}
+
+@entry{nullainipsum,
+  user1 = {example-image-b},
+  name = {nulla in ipsum},
+  description = {Praesent eros nulla, congue vitae, euismod ut, commodo a, wisi.
+Pellentesque habitant morbi tristique senectus et netus et malesuada
+fames ac turpis egestas.  Aenean nonummy magna non leo. Sed felis
+erat, ullamcorper in, dictum non, ultricies ut, lectus. Proin vel
+arcu a odio lobortis euismod.  Vestibulum ante ipsum primis in
+faucibus orci luctus et ultrices posuere cubilia Curae; Proin ut
+est. Aliquam odio. Pellentesque massa turpis, cursus eu, euismod
+nec, tempor congue, nulla. Duis viverra gravida mauris. Cras
+tincidunt. Curabitur eros ligula, varius ut, pulvinar in, cursus
+faucibus, augue.
+
+Nulla mattis luctus nulla. Duis commodo velit at leo.  Aliquam
+vulputate magna et leo. Nam vestibulum ullamcorper leo.  Vestibulum
+condimentum rutrum mauris. Donec id mauris. Morbi molestie justo et
+pede. Vivamus eget turpis sed nisl cursus tempor.  Curabitur mollis
+sapien condimentum nunc. In wisi nisl, malesuada at, dignissim sit
+amet, lobortis in, odio. Aenean consequat arcu a ante. Pellentesque
+porta elit sit amet orci. Etiam at turpis nec elit ultricies
+imperdiet. Nulla facilisi. In hac habitasse platea dictumst.
+Suspendisse viverra aliquam risus. Nullam pede justo, molestie
+nonummy, scelerisque eu, facilisis vel, arcu.
+}
+}
+
+@entry{curabiturtellusmagna,
+  user1 = {example-image-c},
+  name = {curabitur tellus magna},
+  description = {Donec interdum. Praesent scelerisque.  Maecenas posuere sodales
+odio. Vivamus metus lacus, varius quis, imperdiet quis, rhoncus a,
+turpis. Etiam ligula arcu, elementum a, venenatis quis, sollicitudin
+sed, metus. Donec nunc pede, tincidunt in, venenatis vitae, faucibus
+vel, nibh. Pellentesque wisi. Nullam malesuada. Morbi ut tellus ut
+pede tincidunt porta. Lorem ipsum dolor sit amet, consectetuer
+adipiscing elit. Etiam congue neque id dolor.
+
+Donec et nisl at wisi luctus bibendum. Nam interdum tellus ac
+libero. Sed sem justo, laoreet vitae, fringilla at, adipiscing ut,
+nibh. Maecenas non sem quis tortor eleifend fermentum. Etiam id
+tortor ac mauris porta vulputate. Integer porta neque vitae massa.
+Maecenas tempus libero a libero posuere dictum.  Vestibulum ante
+ipsum primis in faucibus orci luctus et ultrices posuere cubilia
+Curae; Aenean quis mauris sed elit commodo placerat.  Class aptent
+taciti sociosqu ad litora torquent per conubia nostra, per inceptos
+hymenaeos. Vivamus rhoncus tincidunt libero. Etiam elementum pretium
+justo. Vivamus est. Morbi a tellus eget pede tristique commodo.
+Nulla nisl. Vestibulum sed nisl eu sapien cursus rutrum.
+}
+}
+
+@entry{nullanonmauris,
+  user1 = {example-image-16x10},
+  name = {nulla non mauris},
+  description = {Nullam varius. Etiam dignissim elementum metus. Vestibulum faucibus,
+metus sit amet mattis rhoncus, sapien dui laoreet odio, nec
+ultricies nibh augue a enim. Fusce in ligula. Quisque at magna et
+nulla commodo consequat.  Proin accumsan imperdiet sem. Nunc porta.
+Donec feugiat mi at justo.  Phasellus facilisis ipsum quis ante. In
+ac elit eget ipsum pharetra faucibus.  Maecenas viverra nulla in
+massa.
+
+Nulla ac nisl. Nullam urna nulla, ullamcorper in, interdum sit amet,
+gravida ut, risus. Aenean ac enim. In luctus.  Phasellus eu quam
+vitae turpis viverra pellentesque. Duis feugiat felis ut enim.
+Phasellus pharetra, sem id porttitor sodales, magna nunc aliquet
+nibh, nec blandit nisl mauris at pede. Suspendisse risus risus,
+lobortis eget, semper at, imperdiet sit amet, quam.  Quisque
+scelerisque dapibus nibh. Nam enim. Lorem ipsum dolor sit amet,
+consectetuer adipiscing elit. Nunc ut metus. Ut metus justo, auctor
+at, ultrices eu, sagittis ut, purus. Aliquam aliquam.
+}
+}
+
+@entry{etiampedemassa,
+  user1 = {example-image-10x16},
+  name = {etiam pede massa},
+  description = {Vestibulum luctus commodo lacus. Morbi lacus dui, tempor sed,
+euismod eget, condimentum at, tortor. Phasellus aliquet odio ac
+lacus tempor faucibus. Praesent sed sem. Praesent iaculis.  Cras
+rhoncus tellus sed justo ullamcorper sagittis.  Donec quis orci.
+Sed ut tortor quis tellus euismod tincidunt. Suspendisse congue nisl
+eu elit. Aliquam tortor diam, tempus id, tristique eget, sodales
+vel, nulla. Praesent tellus mi, condimentum sed, viverra at,
+consectetuer quis, lectus. In auctor vehicula orci. Sed pede sapien,
+euismod in, suscipit in, pharetra placerat, metus. Vivamus commodo
+dui non odio. Donec et felis.
+
+Etiam suscipit aliquam arcu. Aliquam sit amet est ac purus bibendum
+congue. Sed in eros. Morbi non orci.  Pellentesque mattis lacinia
+elit. Fusce molestie velit in ligula.  Nullam et orci vitae nibh
+vulputate auctor. Aliquam eget purus.  Nulla auctor wisi sed ipsum.
+Morbi porttitor tellus ac enim. Fusce ornare. Proin ipsum enim,
+tincidunt in, ornare venenatis, molestie a, augue. Donec vel pede in
+lacus sagittis porta. Sed hendrerit ipsum quis nisl.  Suspendisse
+quis massa ac nibh pretium cursus.  Sed sodales. Nam eu neque quis
+pede dignissim ornare. Maecenas eu purus ac urna tincidunt congue.
+}
+}
+
+@entry{donecetnisl,
+  user1 = {example-image-16x9},
+  name = {donec et nisl},
+  description = {Aenean dictum odio sit amet risus. Morbi purus. Nulla a est sit amet
+purus venenatis iaculis. Vivamus viverra purus vel magna. Donec in
+justo sed odio malesuada dapibus. Nunc ultrices aliquam nunc.
+Vivamus facilisis pellentesque velit. Nulla nunc velit, vulputate
+dapibus, vulputate id, mattis ac, justo. Nam mattis elit dapibus
+purus.  Quisque enim risus, congue non, elementum ut, mattis quis,
+sem.  Quisque elit.
+
+Maecenas non massa. Vestibulum pharetra nulla at lorem. Duis quis
+quam id lacus dapibus interdum. Nulla lorem.  Donec ut ante quis
+dolor bibendum condimentum. Etiam egestas tortor vitae lacus.
+Praesent cursus. Mauris bibendum pede at elit. Morbi et felis a
+lectus interdum facilisis. Sed suscipit gravida turpis.  Nulla at
+lectus. Vestibulum ante ipsum primis in faucibus orci luctus et
+ultrices posuere cubilia Curae; Praesent nonummy luctus nibh. Proin
+turpis nunc, congue eu, egestas ut, fringilla at, tellus. In hac
+habitasse platea dictumst.
+}
+}
+
+@entry{vivamuseutellus,
+  user1 = {example-image-9x16},
+  name = {vivamus eu tellus},
+  description = {Nam orci orci, malesuada id, gravida nec, ultricies vitae, erat.
+Donec risus turpis, luctus sit amet, interdum quis, porta sed,
+ipsum.  Suspendisse condimentum, tortor at egestas posuere, neque
+metus tempor orci, et tincidunt urna nunc a purus. Sed facilisis
+blandit tellus. Nunc risus sem, suscipit nec, eleifend quis, cursus
+quis, libero. Curabitur et dolor. Sed vitae sem. Cum sociis natoque
+penatibus et magnis dis parturient montes, nascetur ridiculus mus.
+Maecenas ante. Duis ullamcorper enim. Donec tristique enim eu leo.
+Nullam molestie elit eu dolor. Nullam bibendum, turpis vitae
+tristique gravida, quam sapien tempor lectus, quis pretium tellus
+purus ac quam. Nulla facilisi.
+
+Duis aliquet dui in est. Donec eget est. Nunc lectus odio, varius
+at, fermentum in, accumsan non, enim. Aliquam erat volutpat. Proin
+sit amet nulla ut eros consectetuer cursus.  Phasellus dapibus
+aliquam justo. Nunc laoreet. Donec consequat placerat magna. Duis
+pretium tincidunt justo. Sed sollicitudin vestibulum quam. Nam quis
+ligula. Vivamus at metus. Etiam imperdiet imperdiet pede. Aenean
+turpis. Fusce augue velit, scelerisque sollicitudin, dictum vitae,
+tempor et, pede. Donec wisi sapien, feugiat in, fermentum ut,
+sollicitudin adipiscing, metus.
+}
+}
+
+@entry{donecvelnibh,
+  user1 = {example-image-golden},
+  name = {donec vel nibh},
+  description = {Donec pede. Sed id quam id wisi laoreet suscipit. Nulla lectus
+dolor, aliquam ac, fringilla eget, mollis ut, orci. In pellentesque
+justo in ligula. Maecenas turpis. Donec eleifend leo at felis
+tincidunt consequat. Aenean turpis metus, malesuada sed, condimentum
+sit amet, auctor a, wisi. Pellentesque sapien elit, bibendum ac,
+posuere et, congue eu, felis. Vestibulum mattis libero quis metus
+scelerisque ultrices. Sed purus.
+
+Donec molestie, magna ut luctus ultrices, tellus arcu nonummy velit,
+sit amet pulvinar elit justo et mauris.  In pede.  Maecenas euismod
+elit eu erat. Aliquam augue wisi, facilisis congue, suscipit in,
+adipiscing et, ante. In justo. Cras lobortis neque ac ipsum. Nunc
+fermentum massa at ante. Donec orci tortor, egestas sit amet,
+ultrices eget, venenatis eget, mi.  Maecenas vehicula leo semper
+est. Mauris vel metus. Aliquam erat volutpat. In rhoncus sapien ac
+tellus. Pellentesque ligula.
+}
+}
+
+@entry{crasdapibus,
+  user1 = {example-image-golden-upright},
+  name = {cras dapibus},
+  description = {Aenean interdum nibh sed wisi. Praesent sollicitudin vulputate dui.
+Praesent iaculis viverra augue. Quisque in libero. Aenean gravida
+lorem vitae sem ullamcorper cursus. Nunc adipiscing rutrum ante.
+Nunc ipsum massa, faucibus sit amet, viverra vel, elementum semper,
+orci. Cras eros sem, vulputate et, tincidunt id, ultrices eget,
+magna. Nulla varius ornare odio. Donec accumsan mauris sit amet
+augue. Sed ligula lacus, laoreet non, aliquam sit amet, iaculis
+tempor, lorem. Suspendisse eros. Nam porta, leo sed congue tempor,
+felis est ultrices eros, id mattis velit felis non metus.  Curabitur
+vitae elit non mauris varius pretium. Aenean lacus sem, tincidunt
+ut, consequat quis, porta vitae, turpis. Nullam laoreet fermentum
+urna. Proin iaculis lectus.
+
+Sed mattis, erat sit amet gravida malesuada, elit augue egestas
+diam, tempus scelerisque nunc nisl vitae libero.  Sed consequat
+feugiat massa. Nunc porta, eros in eleifend varius, erat leo rutrum
+dui, non convallis lectus orci ut nibh. Sed lorem massa, nonummy
+quis, egestas id, condimentum at, nisl. Maecenas at nibh.  Aliquam
+et augue at nunc pellentesque ullamcorper. Duis nisl nibh, laoreet
+suscipit, convallis ut, rutrum id, enim. Phasellus odio.  Nulla
+nulla elit, molestie non, scelerisque at, vestibulum eu, nulla. Ut
+odio nisl, facilisis id, mollis et, scelerisque nec, enim.  Aenean
+sem leo, pellentesque sit amet, scelerisque sit amet, vehicula
+pellentesque, sapien.
+}
+}
+
+@entry{sedconsequat,
+  user1 = {example-image-1x1},
+  name = {sed consequat},
+  description = {Ut tempor laoreet quam. Nullam id wisi a libero tristique semper.
+Nullam nisl massa, rutrum ut, egestas semper, mollis id, leo. Nulla
+ac massa eu risus blandit mattis. Mauris ut nunc. In hac habitasse
+platea dictumst.  Aliquam eget tortor. Quisque dapibus pede in erat.
+Nunc enim. In dui nulla, commodo at, consectetuer nec, malesuada
+nec, elit. Aliquam ornare tellus eu urna. Sed nec metus. Cum sociis
+natoque penatibus et magnis dis parturient montes, nascetur
+ridiculus mus.  Pellentesque habitant morbi tristique senectus et
+netus et malesuada fames ac turpis egestas.
+
+Phasellus id magna. Duis malesuada interdum arcu.  Integer metus.
+Morbi pulvinar pellentesque mi. Suspendisse sed est eu magna
+molestie egestas. Quisque mi lorem, pulvinar eget, egestas quis,
+luctus at, ante. Proin auctor vehicula purus. Fusce ac nisl aliquam
+ante hendrerit pellentesque. Class aptent taciti sociosqu ad litora
+torquent per conubia nostra, per inceptos hymenaeos. Morbi wisi.
+Etiam arcu mauris, facilisis sed, eleifend non, nonummy ut, pede.
+Cras ut lacus tempor metus mollis placerat.  Vivamus eu tortor vel
+metus interdum malesuada.
+}
+}
+
+@entry{sedeleifend,
+  name = {sed eleifend},
+  description = {Morbi non felis ac libero vulputate fringilla. Mauris libero eros,
+lacinia non, sodales quis, dapibus porttitor, pede.  Class aptent
+taciti sociosqu ad litora torquent per conubia nostra, per inceptos
+hymenaeos. Morbi dapibus mauris condimentum nulla.  Cum sociis
+natoque penatibus et magnis dis parturient montes, nascetur
+ridiculus mus. Etiam sit amet erat. Nulla varius. Etiam tincidunt
+dui vitae turpis. Donec leo. Morbi vulputate convallis est.  Integer
+aliquet. Pellentesque aliquet sodales urna.
+}
+}
+
+%    \end{macrocode}
+%\fi
+%\iffalse
+%    \begin{macrocode}
+%</example-glossaries-images.bib>
+%    \end{macrocode}
+%\fi
+%\iffalse
+%    \begin{macrocode}
+%<*example-glossaries-long.bib>
+%    \end{macrocode}
+%\fi
+%\iffalse
+%    \begin{macrocode}
+% Encoding: UTF-8
+@entry{loremipsum,
+  name = {lorem ipsum},
+  description = {dolor sit amet, consectetuer adipiscing elit. Ut purus
+elit, vestibulum ut, placerat ac, adipiscing vitae, felis. Curabitur
+dictum gravida mauris.}
+}
+
+@entry{namearcu,
+  name = {name arcu},
+  description = {libero, nonummy eget, consectetuer id, vulputate a, magna. Donec
+vehicula augue eu neque. Pellentesque habitant morbi tristique
+senectus et netus et malesuada fames ac turpis egestas. Mauris ut
+leo.}
+}
+
+@entry{crasviverra,
+  name = {cras viverra},
+  description = {metus rhoncus sem. Nulla et lectus vestibulum
+urna fringilla ultrices.  Phasellus eu tellus sit amet tortor gravida
+placerat.}
+}
+
+@entry{integersapien,
+  name = {integer sapien},
+  description = {est, iaculis in, pretium quis, viverra ac,
+nunc. Praesent eget sem vel leo ultrices bibendum. Aenean
+faucibus.}
+}
+
+@entry{morbidolor,
+  name = {morbi dolor},
+  description = {nulla, malesuada eu, pulvinar at, mollis ac, nulla.
+Curabitur auctor semper nulla. Donec varius orci eget risus. Duis
+nibh mi, congue eu, accumsan eleifend, sagittis quis, diam. Duis
+eget orci sit amet orci dignissim rutrum.}
+}
+
+@entry{namdui,
+  name = {nam dui},
+  description = {ligula, fringilla a, euismod sodales,
+sollicitudin vel, wisi. Morbi auctor lorem non justo.}
+}
+
+@entry{namlacus,
+  name = {nam lacus},
+  description = {libero, pretium at, lobortis vitae, ultricies et,
+tellus. Donec aliquet, tortor sed accumsan bibendum, erat ligula aliquet magna,
+vitae ornare odio metus a mi.}
+}
+
+@entry{morbiac,
+  name = {morbi ac},
+  description = {orci et nisl hendrerit mollis. Suspendisse ut massa.
+Cras nec ante. Pellentesque a nulla.  Cum sociis natoque penatibus
+et magnis dis parturient montes, nascetur ridiculus mus.}
+}
+
+@entry{aliquam,
+  name = {aliquam},
+  description = {tincidunt urna. Nulla ullamcorper
+vestibulum turpis. Pellentesque cursus luctus mauris.}
+}
+
+@entry{nullamalesuada,
+  name = {nulla malesuada},
+  description = {porttitor diam. Donec felis erat, congue non, volutpat at, 
+tincidunt tristique, libero.  Vivamus viverra fermentum felis.}
+}
+
+@entry{donecnonummy,
+  name = {donec nonummy},
+  description = {pellentesque ante. Phasellus
+adipiscing semper elit. Proin fermentum massa ac quam. Sed diam
+turpis, molestie vitae, placerat a, molestie nec, leo.}
+}
+
+@entry{maecenaslacinia,
+  name = {maecenas lacinia},
+  description = {nam ipsum ligula, eleifend at, accumsan nec, suscipit
+a, ipsum. Morbi blandit ligula feugiat magna. Nunc eleifend consequat
+lorem.}
+}
+
+@entry{sedlacinia,
+  name = {sed lacinia},
+  description = {nulla vitae enim. Pellentesque tincidunt purus
+vel magna. Integer non enim. Praesent euismod nunc eu purus. Donec
+bibendum quam in tellus.}
+}
+
+%    \end{macrocode}
+%\fi
+%\iffalse
+%    \begin{macrocode}
+%</example-glossaries-long.bib>
+%    \end{macrocode}
+%\fi
+%\iffalse
+%    \begin{macrocode}
+%<*example-glossaries-multipar.bib>
+%    \end{macrocode}
+%\fi
+%\iffalse
+%    \begin{macrocode}
+% Encoding: UTF-8
+@entry{loremi-ii,
+  name = {lorem 1--2},
+  description = {Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Ut purus elit,
+vestibulum ut, placerat ac, adipiscing vitae, felis. Curabitur
+dictum gravida mauris. Nam arcu libero, nonummy eget, consectetuer
+id, vulputate a, magna. Donec vehicula augue eu neque. Pellentesque
+habitant morbi tristique senectus et netus et malesuada fames ac
+turpis egestas. Mauris ut leo. Cras viverra metus rhoncus sem. Nulla
+et lectus vestibulum urna fringilla ultrices.  Phasellus eu tellus
+sit amet tortor gravida placerat. Integer sapien est, iaculis in,
+pretium quis, viverra ac, nunc. Praesent eget sem vel leo ultrices
+bibendum. Aenean faucibus. Morbi dolor nulla, malesuada eu, pulvinar
+at, mollis ac, nulla.  Curabitur auctor semper nulla. Donec varius
+orci eget risus. Duis nibh mi, congue eu, accumsan eleifend,
+sagittis quis, diam. Duis eget orci sit amet orci dignissim rutrum.
+
+Nam dui ligula, fringilla a, euismod sodales, sollicitudin vel,
+wisi. Morbi auctor lorem non justo. Nam lacus libero, pretium at,
+lobortis vitae, ultricies et, tellus. Donec aliquet, tortor sed
+accumsan bibendum, erat ligula aliquet magna, vitae ornare odio
+metus a mi. Morbi ac orci et nisl hendrerit mollis. Suspendisse ut
+massa. Cras nec ante. Pellentesque a nulla.  Cum sociis natoque
+penatibus et magnis dis parturient montes, nascetur ridiculus mus.
+Aliquam tincidunt urna. Nulla ullamcorper vestibulum turpis.
+Pellentesque cursus luctus mauris.}
+}
+
+@entry{loremiii-iv,
+  name = {lorem 3--4},
+  description = {Nulla malesuada porttitor diam. Donec felis erat, congue non,
+volutpat at, tincidunt tristique, libero.  Vivamus viverra fermentum
+felis. Donec nonummy pellentesque ante.  Phasellus adipiscing semper
+elit. Proin fermentum massa ac quam. Sed diam turpis, molestie
+vitae, placerat a, molestie nec, leo. Maecenas lacinia. Nam ipsum
+ligula, eleifend at, accumsan nec, suscipit a, ipsum. Morbi blandit
+ligula feugiat magna. Nunc eleifend consequat lorem. Sed lacinia
+nulla vitae enim. Pellentesque tincidunt purus vel magna. Integer
+non enim. Praesent euismod nunc eu purus. Donec bibendum quam in
+tellus. Nullam cursus pulvinar lectus. Donec et mi.  Nam vulputate
+metus eu enim. Vestibulum pellentesque felis eu massa. 
+
+Quisque ullamcorper placerat ipsum. Cras nibh.  Morbi vel justo
+vitae lacus tincidunt ultrices. Lorem ipsum dolor sit amet,
+consectetuer adipiscing elit. In hac habitasse platea dictumst.
+Integer tempus convallis augue. Etiam facilisis. Nunc elementum
+fermentum wisi. Aenean placerat. Ut imperdiet, enim sed gravida
+sollicitudin, felis odio placerat quam, ac pulvinar elit purus eget
+enim. Nunc vitae tortor. Proin tempus nibh sit amet nisl.  Vivamus
+quis tortor vitae risus porta vehicula.}
+}
+
+@entry{loremv-vi,
+  name = {lorem 5--6},
+  description = {Fusce mauris. Vestibulum luctus nibh at lectus.  Sed bibendum, nulla
+a faucibus semper, leo velit ultricies tellus, ac venenatis arcu
+wisi vel nisl. Vestibulum diam. Aliquam pellentesque, augue quis
+sagittis posuere, turpis lacus congue quam, in hendrerit risus eros
+eget felis. Maecenas eget erat in sapien mattis porttitor.
+Vestibulum porttitor. Nulla facilisi. Sed a turpis eu lacus commodo
+facilisis. Morbi fringilla, wisi in dignissim interdum, justo lectus
+sagittis dui, et vehicula libero dui cursus dui. Mauris tempor
+ligula sed lacus. Duis cursus enim ut augue.  Cras ac magna. Cras
+nulla. Nulla egestas. Curabitur a leo. Quisque egestas wisi eget
+nunc. Nam feugiat lacus vel est. Curabitur consectetuer.%
+
+
+Suspendisse vel felis. Ut lorem lorem, interdum eu, tincidunt sit
+amet, laoreet vitae, arcu. Aenean faucibus pede eu ante. Praesent
+enim elit, rutrum at, molestie non, nonummy vel, nisl. Ut lectus
+eros, malesuada sit amet, fermentum eu, sodales cursus, magna. Donec
+eu purus. Quisque vehicula, urna sed ultricies auctor, pede lorem
+egestas dui, et convallis elit erat sed nulla.  Donec luctus.
+Curabitur et nunc. Aliquam dolor odio, commodo pretium, ultricies
+non, pharetra in, velit. Integer arcu est, nonummy in, fermentum
+faucibus, egestas vel, odio.}
+}
+
+@entry{loremvii-viii,
+  name = {lorem 7--8},
+  description = {Sed commodo posuere pede. Mauris ut est. Ut quis purus. Sed ac odio.
+Sed vehicula hendrerit sem. Duis non odio.  Morbi ut dui. Sed
+accumsan risus eget odio. In hac habitasse platea dictumst.
+Pellentesque non elit. Fusce sed justo eu urna porta tincidunt.
+Mauris felis odio, sollicitudin sed, volutpat a, ornare ac, erat.
+Morbi quis dolor. Donec pellentesque, erat ac sagittis semper, nunc
+dui lobortis purus, quis congue purus metus ultricies tellus. Proin
+et quam. Class aptent taciti sociosqu ad litora torquent per conubia
+nostra, per inceptos hymenaeos. Praesent sapien turpis, fermentum
+vel, eleifend faucibus, vehicula eu, lacus.
+
+Pellentesque habitant morbi tristique senectus et netus et malesuada
+fames ac turpis egestas. Donec odio elit, dictum in, hendrerit sit
+amet, egestas sed, leo. Praesent feugiat sapien aliquet odio.
+Integer vitae justo. Aliquam vestibulum fringilla lorem. Sed neque
+lectus, consectetuer at, consectetuer sed, eleifend ac, lectus.
+Nulla facilisi. Pellentesque eget lectus.  Proin eu metus. Sed
+porttitor. In hac habitasse platea dictumst.  Suspendisse eu lectus.
+Ut mi mi, lacinia sit amet, placerat et, mollis vitae, dui. Sed ante
+tellus, tristique ut, iaculis eu, malesuada ac, dui.  Mauris nibh
+leo, facilisis non, adipiscing quis, ultrices a, dui.}
+}
+
+@entry{loremix-x,
+  name = {lorem 9--10},
+  description = {Morbi luctus, wisi viverra faucibus pretium, nibh est placerat odio,
+nec commodo wisi enim eget quam. Quisque libero justo, consectetuer
+a, feugiat vitae, porttitor eu, libero.  Suspendisse sed mauris
+vitae elit sollicitudin malesuada. Maecenas ultricies eros sit amet
+ante. Ut venenatis velit. Maecenas sed mi eget dui varius euismod.
+Phasellus aliquet volutpat odio.  Vestibulum ante ipsum primis in
+faucibus orci luctus et ultrices posuere cubilia Curae; Pellentesque
+sit amet pede ac sem eleifend consectetuer. Nullam elementum, urna
+vel imperdiet sodales, elit ipsum pharetra ligula, ac pretium ante
+justo a nulla. Curabitur tristique arcu eu metus. Vestibulum lectus.
+Proin mauris. Proin eu nunc eu urna hendrerit faucibus. Aliquam
+auctor, pede consequat laoreet varius, eros tellus scelerisque quam,
+pellentesque hendrerit ipsum dolor sed augue. Nulla nec lacus.
+
+Suspendisse vitae elit. Aliquam arcu neque, ornare in, ullamcorper
+quis, commodo eu, libero. Fusce sagittis erat at erat tristique
+mollis. Maecenas sapien libero, molestie et, lobortis in, sodales
+eget, dui. Morbi ultrices rutrum lorem. Nam elementum ullamcorper
+leo. Morbi dui. Aliquam sagittis. Nunc placerat.  Pellentesque
+tristique sodales est. Maecenas imperdiet lacinia velit. Cras non
+urna. Morbi eros pede, suscipit ac, varius vel, egestas non, eros.
+Praesent malesuada, diam id pretium elementum, eros sem dictum
+tortor, vel consectetuer odio sem sed wisi.}
+}
+
+%    \end{macrocode}
+%\fi
+%\iffalse
+%    \begin{macrocode}
+%</example-glossaries-multipar.bib>
+%    \end{macrocode}
+%\fi
+%\iffalse
+%    \begin{macrocode}
+%<*example-glossaries-parent.bib>
+%    \end{macrocode}
+%\fi
+%\iffalse
+%    \begin{macrocode}
+% Encoding: UTF-8
+@entry{sedmattis,
+  name = {sed mattis},
+  description = {erat sit amet}
+}
+
+@entry{gravida,
+  parent = {sedmattis},
+  name = {gravida},
+  description = {malesuada}
+}
+
+@entry{elitaugue,
+  parent = {sedmattis},
+  name = {elit augue},
+  description = {egestas diam}
+}
+
+@entry{tempus,
+  parent = {sedmattis},
+  name = {tempus},
+  description = {scelerisque}
+}
+
+@entry{nunc,
+  name = {nunc},
+  description = {nisl vitae}
+}
+
+@entry{libero,
+  parent = {nunc},
+  name = {libero},
+  description = {sed
+consequat}
+}
+
+@entry{feugiat,
+  parent = {nunc},
+  name = {feugiat},
+  description = {massa}
+}
+
+@entry{porta,
+  parent = {nunc},
+  name = {porta},
+  description = {eros
+in eleifend}
+}
+
+@entry{variuserat,
+  parent = {nunc},
+  name = {varius erat},
+  description = {leo rutrum dui}
+}
+
+@entry{nonconvallis,
+  name = {non
+convallis},
+  description = {lectus orci ut nibh}
+}
+
+@entry{sedlorem,
+  parent = {nonconvallis},
+  name = {sedlorem},
+  description = {massa}
+}
+
+@entry{nonummyquis,
+  parent = {nonconvallis},
+  name = {nonummy
+quis},
+  description = {egestas id}
+}
+
+@entry{condimentum,
+  name = {condimentum},
+  description = {at
+nisl}
+}
+
+@entry{maecenas,
+  parent = {condimentum},
+  name = {maecenas},
+  description = {at nibh}
+}
+
+@entry{aliquamet,
+  name = {aliquam et},
+  description = {augue}
+}
+
+@entry{atnunc,
+  parent = {aliquamet},
+  name = {at nunc},
+  description = {pellentesque
+ullamcorper}
+}
+
+@entry{duisnisl,
+  parent = {atnunc},
+  name = {duisnisl},
+  description = {laoreet
+suscipit}
+}
+
+@entry{duisnibh,
+  parent = {atnunc},
+  name = {duisnibh},
+  description = {convallis ut}
+}
+
+@entry{rutrum,
+  name = {rutrum},
+  description = {id, enim}
+}
+
+@entry{phasellus,
+  parent = {rutrum},
+  name = {phasellus},
+  description = {odio}
+}
+
+@entry{nullanulla,
+  parent = {rutrum},
+  name = {nulla nulla},
+  description = {elit, molestie non}
+}
+
+%    \end{macrocode}
+%\fi
+%\iffalse
+%    \begin{macrocode}
+%</example-glossaries-parent.bib>
+%    \end{macrocode}
+%\fi
+%\iffalse
+%    \begin{macrocode}
+%<*example-glossaries-symbols.bib>
+%    \end{macrocode}
+%\fi
+%\iffalse
+%    \begin{macrocode}
+% Encoding: UTF-8
+@entry{alpha,
+  symbol = {\ensuremath{\alpha}},
+  name = {alpha},
+  description = {Quisque ullamcorper placerat ipsum.}
+}
+
+@entry{beta,
+  symbol = {\ensuremath{\beta}},
+  name = {beta},
+  description = {Cras nibh.}
+}
+
+@entry{gamma,
+  symbol = {\ensuremath{\gamma}},
+  name = {gamma},
+  description = {Morbi vel justo vitae lacus tincidunt ultrices.}
+}
+
+@entry{delta,
+  symbol = {\ensuremath{\delta}},
+  name = {delta},
+  description = {Lorem ipsum dolor sit amet, consectetuer adipiscing
+elit.}
+}
+
+@entry{epsilon,
+  symbol = {\ensuremath{\epsilon}},
+  name = {epsilon},
+  description = {In hac habitasse platea dictumst.}
+}
+
+@entry{zeta,
+  symbol = {\ensuremath{\zeta}},
+  name = {zeta},
+  description = {Integer tempus convallis augue.}
+}
+
+@entry{eta,
+  symbol = {\ensuremath{\eta}},
+  name = {eta},
+  description = {Etiam facilisis.}
+}
+
+@entry{theta,
+  symbol = {\ensuremath{\theta}},
+  name = {theta},
+  description = {Nunc elementum fermentum wisi.}
+}
+
+@entry{iota,
+  symbol = {\ensuremath{i}},
+  name = {iota},
+  description = {Aenean placerat.}
+}
+
+@entry{kappa,
+  symbol = {\ensuremath{\kappa}},
+  name = {kappa},
+  description = {Ut imperdiet, enim sed gravida sollicitudin, felis odio
+placerat quam, ac pulvinar elit purus eget enim.}
+}
+
+@entry{lambda,
+  symbol = {\ensuremath{\lambda}},
+  name = {lambda},
+  description = {Nunc vitae tortor.}
+}
+
+@entry{mu,
+  symbol = {\ensuremath{\mu}},
+  name = {mu},
+  description = {Proin tempus nibh sit amet nisl.}
+}
+
+@entry{nu,
+  symbol = {\ensuremath{\nu}},
+  name = {nu},
+  description = {Vivamus quis tortor vitae risus porta vehicula.}
+}
+
+@entry{xi,
+  symbol = {\ensuremath{\xi}},
+  name = {xi},
+  description = {Fusce mauris.}
+}
+
+@entry{pi,
+  symbol = {\ensuremath{\pi}},
+  name = {pi},
+  description = {Vestibulum luctus nibh at lectus.}
+}
+
+@entry{rho,
+  symbol = {\ensuremath{\rho}},
+  name = {rho},
+  description = {Sed bibendum, nulla a faucibus semper, leo velit
+ultricies tellus, ac venenatis arcu wisi vel nisl. Vestibulum diam.}
+}
+
+@entry{sigma,
+  symbol = {\ensuremath{\sigma}},
+  name = {sigma},
+  description = {Aliquam pellentesque, augue quis sagittis posuere,
+turpis lacus congue quam, in hendrerit risus eros eget felis.}
+}
+
+@entry{tau,
+  symbol = {\ensuremath{\tau}},
+  name = {tau},
+  description = {Maecenas eget erat in sapien mattis porttitor.}
+}
+
+@entry{upsilon,
+  symbol = {\ensuremath{\upsilon}},
+  name = {upsilon},
+  description = {Vestibulum porttitor.}
+}
+
+@entry{phi,
+  symbol = {\ensuremath{\phi}},
+  name = {phi},
+  description = {Nulla facilisi.}
+}
+
+@entry{chi,
+  symbol = {\ensuremath{\chi}},
+  name = {chi},
+  description = {Sed a turpis eu lacus commodo facilisis.}
+}
+
+@entry{psi,
+  symbol = {\ensuremath{\psi}},
+  name = {psi},
+  description = {Morbi fringilla, wisi in dignissim interdum, justo
+lectus sagittis dui, et vehicula libero dui cursus dui.}
+}
+
+@entry{omega,
+  symbol = {\ensuremath{\omega}},
+  name = {omega},
+  description = {Mauris tempor ligula sed lacus.}
+}
+
+%    \end{macrocode}
+%\fi
+%\iffalse
+%    \begin{macrocode}
+%</example-glossaries-symbols.bib>
+%    \end{macrocode}
+%\fi
+%\iffalse
+%    \begin{macrocode}
+%<*example-glossaries-url.bib>
+%    \end{macrocode}
+%\fi
+%\iffalse
+%    \begin{macrocode}
+% Encoding: UTF-8
+@entry{aenean-url,
+  user1 = {http://uk.tug.org/},
+  name = {aenean},
+  description = {adipiscing auctor est}
+}
+
+@entry{morbi-url,
+  user1 = {http://www.ctan.org/},
+  name = {morbi},
+  description = {quam arcu, malesuada sed, volutpat et, elementum sit
+amet, libero}
+}
+
+@entry{duis-url,
+  user1 = {http://www.tug.org/},
+  name = {duis},
+  description = {mattis}
+}
+
+@entry{sed-url,
+  user1 = {http://theoval.cmp.uea.ac.uk/\protect~nlct/},
+  name = {sed},
+  description = {cursus lectus quis odio (uses
+\texttt{\string\protect\string~})}
+}
+
+@entry{sed2-url,
+  user1 = {http://theoval.cmp.uea.ac.uk/\string~nlct/},
+  name = {sed},
+  description = {cursus lectus quis odio (uses
+\texttt{\string\string\string~})}
+}
+
+@entry{sed3-url,
+  user1 = {http://theoval.cmp.uea.ac.uk/\glstildechar nlct/},
+  name = {sed},
+  description = {cursus lectus quis odio (uses
+\texttt{\string\glstildechar})}
+}
+
+@entry{phasellus-url,
+  user1 = {http://theoval.cmp.uea.ac.uk/},
+  name = {phasellus},
+  description = {arcu (catcode change)}
+}
+
+@entry{phasellus2-url,
+  user1 = {http://theoval.cmp.uea.ac.uk/\%7Enlct
+},
+  name = {phasellus},
+  description = {arcu (uses \texttt{\string\%})}
+}
+
+@entry{phasellus3-url,
+  user1 = {http://theoval.cmp.uea.ac.uk/\glspercentchar 7Enlct
+},
+  name = {phasellus},
+  description = {arcu  (uses 
+ \texttt{\string\glspercentchar})}
+}
+
+%    \end{macrocode}
+%\fi
+%\iffalse
+%    \begin{macrocode}
+%</example-glossaries-url.bib>
+%    \end{macrocode}
+%\fi
+%\iffalse
+%    \begin{macrocode}
+%<*example-glossaries-xr.bib>
+%    \end{macrocode}
+%\fi
+%\iffalse
+%    \begin{macrocode}
+% Encoding: UTF-8
+@entry{lorem,
+  name = {lorem},
+  description = {ipsum}
+}
+
+@entry{alias-lorem,
+  name = {alias-lorem},
+  description = {ipsum},
+  alias = {lorem}
+}
+
+@entry{dolor,
+  name = {dolor},
+  description = {sit}
+}
+
+@entry{amet,
+  see = {dolor},
+  name = {amet},
+  description = {consectetuer}
+}
+
+@entry{adipiscing,
+  name = {adipiscing},
+  description = {elit}
+}
+
+@entry{ut,
+  name = {ut},
+  description = {purus}
+}
+
+@entry{elit,
+  name = {elit},
+  description = {vestibulum},
+  seealso = {adipiscing,ut}
+}
+
+@entry{placerat,
+  name = {placerat},
+  description = {ac}
+}
+
+@entry{vitae,
+  name = {vitae},
+  description = {felis}
+}
+
+@entry{curabitur,
+  name = {curabitur},
+  description = {gravida}
+}
+
+@entry{mauris,
+  name = {mauris},
+  description = {nam}
+}
+
+@entry{arcu,
+  name = {arcu},
+  description = {libero},
+  seealso = {placerat,vitae,curabitur}
+}
+
+@entry{nonummy,
+  name = {nonummy},
+  description = {eget},
+  seealso = {mauris}
+}
+
+@entry{consectetuer,
+  parent = {nonummy},
+  name = {consectetuer},
+  description = {id}
+}
+
+@entry{vulputate,
+  parent = {nonummy},
+  name = {vulputate},
+  description = {a magna}
+}
+
+@entry{donec,
+  name = {donec},
+  description = {vehicula}
+}
+
+@entry{augue,
+  name = {augue},
+  description = {eu neque}
+}
+
+@entry{pellentesque,
+  see = {augue},
+  name = {pellentesque},
+  description = {habitant}
+}
+
+@entry{morbi,
+  name = {morbi},
+  description = {tristique}
+}
+
+@entry{senectus,
+  name = {senectus},
+  description = {et netus}
+}
+
+@entry{et,
+  see = {vulputate},
+  name = {et},
+  description = {malesuada}
+}
+
+@entry{fames,
+  name = {fames},
+  description = {ac}
+}
+
+@entry{turpis,
+  name = {turpis},
+  description = {egestas},
+  seealso = {consectetuer}
+}
+
+@entry{leo,
+  name = {leo},
+  description = {cras}
+}
+
+@entry{viverra,
+  name = {viverra},
+  description = {metus}
+}
+
+@entry{rhoncus,
+  name = {rhoncus},
+  description = {sem}
+}
+
+@entry{nulla,
+  name = {nulla},
+  description = {et}
+}
+
+@entry{lectus,
+  name = {lectus},
+  description = {vestibulum}
+}
+
+@entry{urna,
+  parent = {lectus},
+  see = {nulla},
+  name = {urna},
+  description = {fringilla}
+}
+
+@entry{ultrices,
+  parent = {lectus},
+  name = {ultrices},
+  description = {phasellus}
+}
+
+@entry{eu,
+  parent = {lectus},
+  name = {eu},
+  description = {tellus}
+}
+
+@entry{alias-eu,
+  name = {alias-eu},
+  description = {tellus},
+  alias = {eu}
+}
+
+@entry{sit,
+  name = {sit},
+  description = {amet}
+}
+
+@entry{tortor,
+  name = {tortor},
+  description = {gravida}
+}
+
+@entry{integer,
+  name = {integer},
+  description = {sapien}
+}
+
+@entry{est,
+  name = {est},
+  description = {iaculis}
+}
+
+@entry{in,
+  name = {in},
+  description = {pretium},
+  seealso = {sit,tortor,est}
+}
+
+@entry{quis,
+  name = {quis},
+  description = {viverra}
+}
+
+@entry{ac,
+  name = {ac},
+  description = {nunc}
+}
+
+@entry{praesent,
+  name = {praesent},
+  description = {eget \gls{ac}}
+}
+
+@entry{sem,
+  name = {sem},
+  description = {vel leo
+\glshyperlink{quis}}
+}
+
+@entry{bibendum,
+  name = {bibendum},
+  description = {ultrices}
+}
+
+@entry{aenean,
+  name = {aenean},
+  description = {faucibus}
+}
+
+@entry{malesuada,
+  parent = {aenean},
+  name = {malesuada},
+  description = {eu}
+}
+
+@entry{pulvinar,
+  parent = {aenean},
+  name = {pulvinar},
+  description = {at}
+}
+
+@entry{mollis,
+  parent = {aenean},
+  name = {mollis},
+  description = {ac nulla}
+}
+
+@entry{auctor,
+  parent = {aenean},
+  name = {auctor},
+  description = {semper}
+}
+
+@entry{varius,
+  parent = {aenean},
+  name = {varius},
+  description = {orci}
+}
+
+@entry{eget,
+  name = {eget},
+  description = {risus}
+}
+
+@entry{duis,
+  name = {duis},
+  description = {nibh}
+}
+
+@entry{mi,
+  name = {mi},
+  description = {congue}
+}
+
+@entry{accumsan,
+  name = {accumsan},
+  description = {eleifend}
+}
+
+@entry{sagittis,
+  see = {eget},
+  name = {sagittis},
+  description = {quis}
+}
+
+@entry{diam,
+  name = {diam},
+  description = {duis}
+}
+
+@entry{orci,
+  name = {orci},
+  description = {dignissim},
+  seealso = {diam}
+}
+
+%    \end{macrocode}
+%\fi
+%\iffalse
+%    \begin{macrocode}
+%</example-glossaries-xr.bib>
+%    \end{macrocode}
+%\fi
 %\Finale
 \endinput