glossaries 1.04 (15aug07)

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

2 files changed, 648 insertions, 381 deletions

diff --git a/Master/texmf-dist/source/latex/glossaries/glossaries.dtx b/Master/texmf-dist/source/latex/glossaries/glossaries.dtx
index 641f6653224..1b3e061e121 100644
--- a/Master/texmf-dist/source/latex/glossaries/glossaries.dtx
+++ b/Master/texmf-dist/source/latex/glossaries/glossaries.dtx
@@ -1,13 +1,14 @@
 %\iffalse
-% glossaries.dtx generated using makedtx version 0.91b (c) Nicola Talbot
+% glossaries.dtx generated using makedtx version 0.93b (c) Nicola Talbot
 % Command line args:
 %   -src "glossaries.sty=>glossaries.sty"
 %   -src "(glossary-.+)\.(sty)\Z=>\1.\2"
 %   -doc "manual.tex"
 %   -author "Nicola Talbot"
+%   -codetitle "Documented Code"
 %   -dir "source"
 %   glossaries
-% Created on 2007/5/25 16:12
+% Created on 2007/8/3 17:26
 %\fi
 %\iffalse
 %<*package>
@@ -58,17 +59,19 @@
 \makeatother
 \RecordChanges
 \PageIndex
-\CheckSum{2807}
+\CheckSum{2821}
 \CodelineNumbered
+\newcommand*{\termdef}[1]{\emph{#1}\iterm{#1}}
+\newcommand*{\term}[1]{#1\iterm{#1}}
+\newcommand*{\iterm}[1]{\index{#1|main}}
 
 
-\newcommand{\cmdname}[1]{\texttt{\char`\\#1}}
 
 \newcommand*{\istkey}[1]{\texttt{#1}\index{makeindex=\texttt{makeindex}>#1=\texttt{#1}|hyperpage}}
 \newcommand*{\icmdname}[1]{\texttt{\char`\\#1}\SpecialMainIndex{#1}}
 \newcommand*{\appname}[1]{\texttt{#1}\index{#1=\texttt{#1}|hyperpage}}
 \newcommand*{\mkidxspch}{\index{makeindex=\texttt{makeindex}>special characters|hyperpage}}
-\newcommand*{\igloskey}[2][newglossaryentry]{\index{#1 options=\cmdname{#1} options>#2=\textsf{#2}|hyperpage}}
+\newcommand*{\igloskey}[2][newglossaryentry]{\index{#1 options=\cs{#1} options>#2=\textsf{#2}|hyperpage}}
 \newcommand*{\gloskey}[2][newglossaryentry]{\textsf{#2}\igloskey[#1]{#2}}
 \newcommand*{\pkgopt}[2][]{%
 \ifthenelse{\equal{#1}{}}{%
@@ -89,7 +92,7 @@
 %\MakeShortVerb{"}
 %\DeleteShortVerb{\|}
 %
-% \title{glossaries.sty v 1.02: \LaTeXe\ Package to Assist Generating Glossaries}
+% \title{glossaries.sty v 1.04: \LaTeXe\ Package to Assist Generating Glossaries}
 % \author{Nicola L.C. Talbot\\[10pt]
 %School of Computing Sciences\\
 %University of East Anglia\\
@@ -97,7 +100,7 @@
 %NR4 7TJ. United Kingdom.\\
 %\url{http://theoval.cmp.uea.ac.uk/~nlct/}}
 %
-% \date{25th May 2007}
+% \date{3rd August 2007}
 % \maketitle
 %\tableofcontents
 %
@@ -213,7 +216,7 @@
 %will be Notation.
 %
 %\item Any new glossaries must be defined before 
-%\cmdname{makeglossaries}
+%\cs{makeglossaries}
 %\begin{verbatim}
 %\documentclass{article}
 %\usepackage{glossaries}
@@ -365,9 +368,9 @@
 %
 %\item Other variations:
 %\begin{itemize}
-%\item \icmdname{Gls}\marg{label} : like \cmdname{gls},
+%\item \icmdname{Gls}\marg{label} : like \cs{gls},
 %but with first letter in upper case
-%\item \icmdname{GLS}\marg{label} : like \cmdname{gls},
+%\item \icmdname{GLS}\marg{label} : like \cs{gls},
 %but all upper case.
 %\item \icmdname{glspl}\marg{label} : use plural
 %\item \icmdname{Glspl}\marg{label} : use plural with
@@ -398,14 +401,14 @@
 %The primary definition of \glspl[format=textbf]{singmtx}.
 %\end{verbatim}
 %In this example the relevant glossary entry will have the
-%page number in bold (since it uses \cmdname{textbf}) but
+%page number in bold (since it uses \cs{textbf}) but
 %it will no longer have a hyperlink (if hyperlinks are enabled.)
 %
 %\item The \styname{glossaries} package provides commands to
 %change the font whilst ensuring that the number remains a
-%hyperlink. These are of the form \cmdname{hyper}\meta{xx} and
+%hyperlink. These are of the form \cs{hyper}\meta{xx} and
 %are equivalent to the standard font changing commands of the
-%form \cmdname{text}\meta{xx}, as well as \icmdname{hyperemph}
+%form \cs{text}\meta{xx}, as well as \icmdname{hyperemph}
 %(which uses \icmdname{emph}.) For example:
 %\begin{verbatim}
 %The primary definition of \glspl[format=hyperbf]{singmtx}.
@@ -548,29 +551,54 @@
 %\begin{verbatim}
 %\usepackage[section=section]{glossaries}
 %\end{verbatim}
+%Note that the starred form of the sectioning command is always used
+%since glossaries tend to be placed in unnumbered sections or chapters.
+%If you want the glossaries to appeared in a numbered section, you
+%will need to set \DescribeMacro{\glossarysection}\cs{glossarysection} 
+%to the relevant sectioning command. For example, to make the 
+%glossaries appear in numbered chapters, do:
+%\begin{verbatim}
+%\let\glossarysection\chapter
+%\end{verbatim}
 %
 %\item[\pkgopt{style}] This is a key=value option. Its value should
 %be the name of the glossary style to use.
 %
 %\item[\pkgopt{nonumberlist}] This option will suppress the 
-%associated number lists in the glossaries (see also 
+%associated number lists\iterm{number list} in the glossaries (see also 
 %\autoref{sec:numberlists}.)
 %
 %\item[\pkgopt{acronym}] Make a separate glossary for acronyms.
 %
 %\item[\pkgopt{counter}] This is a key=value option. The value should
-%be the name of the default counter to use in the number lists.
-%
-%\item[\pkgopt{sanitize}] This is a key=value option whose value
-%is a key=value list. By default, the \styname{glossaries} package
-%sanitizes the values of the \gloskey{name}, \gloskey{description}
-%and \gloskey{symbol} keys used when defining a new glossary
-%entry. This means that you don't need to worry about using fragile
-%commands when defining new glossary entries, but this may lead
-%to unexpected results if you try to display these values within
-%the document text. This sanitization can be switched off using
-%the \pkgopt{sanitize} package option. (See \autoref{sec:pkgopt}
-%and \autoref{sec:newentry} for further details.)
+%be the name of the default counter to use in the 
+%number lists\iterm{number list}.
+%
+%\hypertarget{sanitize}{}\relax
+%\item[\pkgopt{sanitize}] This is a key=value option whose value is a
+%key=value list. By default, the \styname{glossaries} package
+%sanitizes the values of the \gloskey{name}, \gloskey{description} and
+%\gloskey{symbol} keys used when defining a new glossary entry. This
+%may lead to unexpected results if you try to
+%display these values within the document text. This sanitization can
+%be switched off using the \pkgopt{sanitize} package option. (See
+%\autoref{sec:pkgopt} and \autoref{sec:newentry} for further details.)
+%For example, to switch off the sanitization for the 
+%\gloskey{description} and \gloskey{name} keys, but not for
+%the \gloskey{symbol} key, do:
+%\begin{verbatim}
+%\usepackage[sanitize={name=false,description=false,%
+%symbol=true}]{glossaries}
+%\end{verbatim}
+%
+%\textbf{Note}: this sanitization only applies to the \gloskey{name}, 
+%\gloskey{description} and \gloskey{symbol} keys. It doesn't apply
+%to any of the other keys (except the \gloskey{sort} key which is
+%always sanitized) so fragile commands contained in the value of
+%the other keys must always be protected using \cs{protect}.
+%Since the value of the \gloskey{text} key is obtained from the
+%\gloskey{name} key, you will still need to protect fragile commands
+%in the \gloskey{name} key if you don't use the \gloskey{text} key. 
 %
 %\end{description}
 %
@@ -589,14 +617,14 @@
 %defined in the document.
 %
 %\DescribeMacro{\makeglossaries}
-%The command \cmdname{makeglossaries} must be placed in the preamble,
+%The command \cs{makeglossaries} must be placed in the preamble,
 %in order to create the customised \appname{makeindex} style file,
 %and to ensure that glossary entries are written to the appropriate
 %output file.
 %
 %\DescribeMacro{\newglossaryentry}
 %New glossary entries are defined using the command:\\[10pt]
-%\cmdname{newglossaryentry}\marg{label}\marg{key-val list}\\[10pt]
+%\cs{newglossaryentry}\marg{label}\marg{key-val list}\\[10pt]
 %The first argument, \meta{label}, must be a unique label with which to
 %identify this entry. The second argument, \meta{key-val list},
 %is a key=value list that supplies the relevant information about this
@@ -627,7 +655,7 @@
 %field.
 %\item[{\gloskey{symbol}}] This field is provided to allow the user to
 %specify an associated symbol, but most glossary styles ignore
-%this value. If omitted, the value is set to \cmdname{relax}.
+%this value. If omitted, the value is set to \cs{relax}.
 %\item[{\gloskey{sort}}] This value indicates how \appname{makeindex} should
 %sort this entry. If omitted, the value of the \gloskey{name} field
 %is used. This value is equivalent to \appname{makeindex}'s ``actual''
@@ -639,9 +667,9 @@
 %\DescribeMacro{\loadglsentries}
 %You can store all your glossary entry definitions in another
 %file, and use:\\[10pt]
-%\cmdname{loadglsentries}\oarg{type}\marg{filename}\\[10pt]
+%\cs{loadglsentries}\oarg{type}\marg{filename}\\[10pt]
 %where \meta{filename} is the name of the file containing all the
-%\cmdname{newglossaryentry} commands. The optional argument
+%\cs{newglossaryentry} commands. The optional argument
 %\meta{type} is the name of the glossary to which those entries
 %should belong, for those entries where the \gloskey{type} key has 
 %been omitted. Note that only those entries that have been used
@@ -650,7 +678,8 @@
 %\subsection{Number lists}
 %\label{sec:numberlists}
 %
-%Each entry in the glossary has an associated number list. By default,
+%Each entry in the glossary has an associated \termdef{number list}. 
+%By default,
 %these numbers refer to the pages on which that entry has been used
 %(using any of the commands described in \autoref{sec:glslink}
 %and \autoref{sec:glsadd}.) The number list can be suppressed using
@@ -662,11 +691,22 @@
 %
 %Once you have defined a glossary entry using 
 %\icmdname{newglossaryentry}, you can refer to that entry in the
-%document using one of the commands listed in this section.
+%document using one of the commands listed in this section. The
+%text which appears at that point in the document when using 
+%one of these commands is referred to as the 
+%\termdef{link text} (even if there are no hyperlinks.)
+%
+%The way the \term{link text} is displayed 
+%depends on \DescribeMacro{\glstextformat}\cs{glstextformat}\marg{text}.
+%For example, to make all \term{link text} appear in a sans-serif
+%font, do:
+%\begin{verbatim}
+%\renewcommand*{\glstextformat}[1]{\textsf{#1}}
+%\end{verbatim}
 %
 %\DescribeMacro{\glslink}
 %The command:\\[10pt]
-%\cmdname{glslink}\oarg{options}\marg{label}\marg{text}\\[10pt]
+%\cs{glslink}\oarg{options}\marg{label}\marg{text}\\[10pt]
 %will place \meta{text} in the document at that point, and add
 %a line into the associated glossary file for the glossary entry
 %given by \meta{label}. If hyperlinks are supported, \meta{text}
@@ -678,13 +718,27 @@
 %\item[{\gloskey[glslink]{format}}] This specifies how to format
 %the associated number for this entry in the glossary. This value
 %is equivalent to the \appname{makeindex} encap value, and (as with
-%\cmdname{index}) the value needs to be the name of a 
+%\cs{index}) the value needs to be the name of a 
 %command \emph{without} the initial backslash. As with
-%\cmdname{index}, the characters "(" and ")" can also be used to 
+%\cs{index}, the characters "(" and ")" can also be used to 
 %specify the beginning and ending of a number range.
+%Again, as with \cs{index} the command should be the name of a 
+%command which takes an argument (which will be the associated number.)
+%Be careful not to use a declaration (such as \cs{bfseries}) instead of 
+%a text block command (such as \cs{textbf}) as the effect will not be
+%localised. If you want to apply more than one
+%style to a given entry (e.g.\ \textbf{bold} and \emph{italic}) you
+%will need to create a command that applies both formats, e.g.\ 
+%\begin{verbatim}
+%\newcommand*{\textbfem}[1]{\textbf{\emph{#1}}}
+%\end{verbatim}
+%and use that command. (Just as you would have to do with \cs{index}.)
 %
-%The \styname{glossaries} package provides the following number 
-%formats:
+%If you are using hyperlinks, and you want to change the font of the
+%hyperlink, don't use \cs{hyperpage} (provided by the \styname{hyperref}
+%package) as the numbers may not refer to a page number.
+%Instead, the \styname{glossaries} package provides the following 
+%number formats:
 %\begin{center}
 %\begin{tabular}{@{\sffamily}lp{0.8\linewidth}}
 %hyperrm & The number is a serif hyperlink to the relevant part of the 
@@ -709,13 +763,13 @@
 %part of the document\\
 %\end{tabular}
 %\end{center}
-%Note that if the \cmdname{hyperlink} command hasn't been defined,
+%Note that if the \cs{hyperlink} command hasn't been defined,
 %the "hyper"\meta{xx} formats are equivalent to the
-%analogous \cmdname{text}\meta{xx} font commands. If you want to
+%analogous \cs{text}\meta{xx} font commands. If you want to
 %make a new format, you will need to define a command which takes
 %one argument, for example, if you want the associated number in
 %the glossary to be in a bold sans-serif font, you can define a
-%command called, say, \cmdname{hyperbsf}:
+%command called, say, \cs{hyperbsf}:
 %\begin{verbatim}
 %\newcommand{\hyperbsf}[1]{\textbf{\hypersf{#1}}}
 %\end{verbatim}
@@ -729,28 +783,28 @@
 %\item[{\gloskey[glslink]{hyper}}] This is a boolean key which can
 %be used to enable/disable the hyperlink to the relevant entry
 %in the glossary. (Note that setting "hyper=true" will have no
-%effect if \cmdname{hyperlink} has not been defined.) The default
+%effect if \cs{hyperlink} has not been defined.) The default
 %value is "hyper=true".
 %
 %\end{description}
 %\DescribeMacro{\glslink*}
 %There is also a starred version:\\[10pt]
-%\cmdname{glslink*}\oarg{options}\marg{label}\marg{text}\\[10pt]
-%which is equivalent to \cmdname{glslink}, except it sets
+%\cs{glslink*}\oarg{options}\marg{label}\marg{text}\\[10pt]
+%which is equivalent to \cs{glslink}, except it sets
 %"hyper=false".
 %
 %\DescribeMacro{\gls}
 %The command:\\[10pt]
-%\cmdname{gls}\oarg{options}\marg{label}\oarg{insert}\\[10pt]
-%is the same as \cmdname{glslink}, except that the link text
+%\cs{gls}\oarg{options}\marg{label}\oarg{insert}\\[10pt]
+%is the same as \cs{glslink}, except that the \term{link text}
 %is determined from the values of the \gloskey{text} and 
 %\gloskey{first} keys supplied when the entry was defined using
 %\icmdname{newglossaryentry}. There are two uppercase variants:\\[10pt]
 %\DescribeMacro{\Gls}
-%\cmdname{Gls}\oarg{options}\marg{label}\oarg{insert}\\[10pt]
+%\cs{Gls}\oarg{options}\marg{label}\oarg{insert}\\[10pt]
 %and
 %\DescribeMacro{\GLS}
-%\cmdname{GLS}\oarg{options}\marg{label}\oarg{insert}\\[10pt]
+%\cs{GLS}\oarg{options}\marg{label}\oarg{insert}\\[10pt]
 %which make the first letter of the link, or all the link text,
 %uppercase, respectively.
 %
@@ -762,29 +816,38 @@
 %
 %There are also analogous plural forms:\\[10pt]
 %\DescribeMacro{\glspl}
-%\cmdname{glspl}\oarg{options}\marg{label}\oarg{insert}\\[10pt]
+%\cs{glspl}\oarg{options}\marg{label}\oarg{insert}\\[10pt]
 %\DescribeMacro{\Glspl}
-%\cmdname{Glspl}\oarg{options}\marg{label}\oarg{insert}\\[10pt]
+%\cs{Glspl}\oarg{options}\marg{label}\oarg{insert}\\[10pt]
 %\DescribeMacro{\GLSpl}
-%\cmdname{GLSpl}\oarg{options}\marg{label}\oarg{insert}\\[10pt]
+%\cs{GLSpl}\oarg{options}\marg{label}\oarg{insert}\\[10pt]
 %These determine the link text from the \gloskey{plural} and
 %\gloskey{firstplural} keys supplied when the entry was first
 %defined.
 %
+%To make the description or symbol also appear in the \term{link text},
+%you will need to redefine \cs{glsdisplayfirst} and \cs{glsdisplay}
+%or use the commands \cs{defglsdisplayfirst} and \cs{defglsdisplay}.
+%See \autoref{sec:code:glslink} for further details. (Note that if you
+%want either the description or symbol to appear in the 
+%\term{link text}, you will have to disable the 
+%\hyperlink{sanitize}{sanitization} of these 
+%keys, and protect fragile commands.)
+%
 %\subsection{Adding an entry to the glossary without generating text}
 %\label{sec:glsadd}
 %
 %\DescribeMacro{\glsadd}
 %It is also possible to add a line in the glossary file without
 %generating any text at that point in the document.\\[10pt]
-%\cmdname{glsadd}\oarg{options}\marg{label}\\[10pt]
+%\cs{glsadd}\oarg{options}\marg{label}\\[10pt]
 %This is similar to \icmdname{glslink}, only it doesn't produce
 %any text (so therefore, there is no \gloskey[glslink]{hyper} key
 %available in \meta{options}.)
 %
 %\DescribeMacro{\glsaddall}
 %To add a line for all entries that have been defined, use:\\[10pt]
-%\cmdname{glsaddall}\oarg{glossary list}\\[10pt]
+%\cs{glsaddall}\oarg{glossary list}\\[10pt]
 %If there are multiple glossaries, you can specify to add only
 %those entries which belong to the glossaries listed in
 %\meta{glossary list} (which must be a comma separated list of
@@ -793,7 +856,7 @@
 %\subsection{Displaying a glossary}
 %
 %\DescribeMacro{\printglossaries}
-%The command \cmdname{printglossaries} will display all the
+%The command \cs{printglossaries} will display all the
 %defined glossaries. Note that no glossaries will appear until
 %you have either used the Perl script \appname{makeglossaries}
 %or have directly used \appname{makeindex}. If the glossary still
@@ -802,7 +865,7 @@
 %
 %\DescribeMacro{\printglossary}
 %An individual glossary is displayed using:\\[10pt]
-%\cmdname{printglossary}\oarg{options}\\[10pt]
+%\cs{printglossary}\oarg{options}\\[10pt]
 %where \meta{options} is a key-val list of options. The following
 %keys are available:
 %\begin{description}
@@ -826,7 +889,7 @@
 %
 %\DescribeMacro{\newglossary}
 %A new glossary can be defined using:\\[10pt]
-%\cmdname{newglossary}\oarg{log-ext}\marg{name}\marg{in-ext}\marg{out-ext}\marg{title}\oarg{counter}\\[10pt]
+%\cs{newglossary}\oarg{log-ext}\marg{name}\marg{in-ext}\marg{out-ext}\marg{title}\oarg{counter}\\[10pt]
 %where \meta{name} is label to assign to this glossary. (Note that
 %the default glossary is labelled "main" and if you use the
 %\pkgopt{acronym} package option, there will also be a glossary
@@ -834,7 +897,8 @@
 %specify the extensions to give to the input and output files
 %for that glossary, \meta{title} is the default title for this
 %new glossary and the final optional argument \meta{counter} specifies
-%which counter to use for the associated number lists (see also
+%which counter to use for the associated 
+%number lists\iterm{number list} (see also
 %\autoref{sec:numberlists}.) The first optional argument specifies
 %the extension for the \appname{makeindex} transcript file (this 
 %information is only used by \appname{makeglossaries} which picks
@@ -848,10 +912,10 @@
 %the term is first used in the document, this provides a useful
 %means to define acronyms. The \styname{glossaries} package defines
 %the command:\\[10pt]
-%\cmdname{newacronym}\oarg{key-val list}\marg{label}\marg{abbrv}\marg{long}\\[10pt]
+%\cs{newacronym}\oarg{key-val list}\marg{label}\marg{abbrv}\marg{long}\\[10pt]
 %This is equivalent to:\vskip5pt
 %\begin{ttfamily}\obeylines
-%\cmdname{newglossaryentry}\textrm{\marg{label}}\{type=\cmdname{acronymtype},
+%\cs{newglossaryentry}\textrm{\marg{label}}\{type=\cs{acronymtype},
 %name=\textrm{\marg{abbrv}},
 %description=\textrm{\marg{long}},
 %text=\textrm{\marg{abbrv}},
@@ -861,7 +925,7 @@
 %\textrm{\meta{key-val list}}\}
 %\end{ttfamily}
 %\vskip5pt
-%The command \cmdname{acronymtype} is the name of the glossary
+%The command \cs{acronymtype} is the name of the glossary
 %in which the acronyms should appear. If the \pkgopt{acronym}
 %package option has been used, this will be "acronym", otherwise
 %it will be "main". The acronyms can then be used in exactly
@@ -873,7 +937,7 @@
 %\begin{description}
 %\item[list] The \glostyle{list} style uses the \envname{description}
 %environment. The entry name is placed in the optional argument
-%of the \cmdname{item} command (so it will appear in bold by
+%of the \cs{item} command (so it will appear in bold by
 %default). The description follows, and then the associated number
 %list for that entry.
 %
@@ -897,7 +961,7 @@
 %\item[long] The \glostyle{long} style uses the \envname{longtable}
 %environment. It has two columns, the first column contains the
 %entry's name, the second column contains the description followed
-%by the number list.
+%by the \term{number list}.
 %
 %\item[longborder] The \glostyle{longborder} style is like
 %\glostyle{long}, but has horizontal and vertical lines around it.
@@ -912,7 +976,7 @@
 %\item[long3col] The \glostyle{long3col} style is like
 %\glostyle{long} but has three columns. The first column contains
 %the entry's name, the second column contains the description
-%and the third column contains the number list.
+%and the third column contains the \term{number list}.
 %
 %\item[long3colborder] The \glostyle{long3colborder} style is like
 %the \glostyle{long3col} style but has horizontal and vertical
@@ -943,7 +1007,7 @@
 %\item[super] The \glostyle{super} style uses the \envname{supertabular}
 %environment. It has two columns, the first column contains the
 %entry's name, the second column contains the description followed
-%by the number list.
+%by the \term{number list}.
 %
 %\item[superborder] The \glostyle{superborder} style is like
 %\glostyle{super}, but has horizontal and vertical lines around it.
@@ -958,7 +1022,7 @@
 %\item[super3col] The \glostyle{super3col} style is like
 %\glostyle{super} but has three columns. The first column contains
 %the entry's name, the second column contains the description
-%and the third column contains the number list.
+%and the third column contains the \iterm{number list}.
 %
 %\item[super3colborder] The \glostyle{super3colborder} style is like
 %the \glostyle{super3col} style but has horizontal and vertical
@@ -991,16 +1055,24 @@
 %The glossary style can be set using the \pkgopt{style} package option,
 %or using the \gloskey[printglossary]{style} key in the optional
 %argument to \icmdname{printglossary}, or using the command:\\[10pt]
-%\cmdname{glossarystyle}\marg{style-name}\\[10pt]
+%\cs{glossarystyle}\marg{style-name}\\[10pt]
 %For further details on creating or modifying glossary styles see 
 %\autoref{sec:printglos} and \autoref{sec:styles}.
 %
+% \changes{1.03}{2007 July 4}{'glspostdescription added}
+%All the styles except for the three and four column styles use the
+%command \DescribeMacro{\glspostdescription}\cs{glspostdescription}
+%after the description. This simply displays a full stop by default.
+%To eliminate this full stop (or replace it with something else,
+%say a comma), you will need to redefine \cs{glspostdescription}
+%before the glossary is displayed.
+%
 % \StopEventually{\phantomsection\addcontentsline{toc}{section}{Index}\PrintIndex}
 %
 %
 %
 %
-%\section{The Code}
+%\section{Documented Code}
 %\iffalse
 %    \begin{macrocode}
 %<*glossaries.sty>
@@ -1008,9 +1080,10 @@
 %\fi
 %\label{sec:code}
 % \subsection{Package Definition}
+% This package requires \LaTeXe.
 %    \begin{macrocode}
 \NeedsTeXFormat{LaTeX2e}
-\ProvidesPackage{glossaries}[2007/05/25 v1.02 (NLCT)]
+\ProvidesPackage{glossaries}[2007/08/03 v1.04 (NLCT)]
 %    \end{macrocode}
 % Required packages:
 %    \begin{macrocode}
@@ -1027,15 +1100,16 @@
 \define@boolkey{glossaries.sty}[gls]{toc}[true]{}
 %    \end{macrocode}
 %
-%\DescribeMacro{\@@glossarysec}
 % The sectional unit used to start the glossary is stored in
-% \cmdname{@@glossarysec}. If chapters are defined, this
+% \cs{@@glossarysec}. If chapters are defined, this
 % is initialised to \texttt{chapter}, otherwise it is
 % initialised to \texttt{section}.
+%\begin{macro}{\@@glossarysec}
 %    \begin{macrocode}
 \@ifundefined{chapter}{\newcommand*{\@@glossarysec}{section}}{%
 \newcommand*{\@@glossarysec}{chapter}}
 %    \end{macrocode}
+%\end{macro}
 % The \pkgopt{section} key can be used to set the sectional unit.
 % If no unit is specified, use \texttt{section} as the default.
 % The starred form of the named sectional unit will be used.
@@ -1048,15 +1122,16 @@ subsection,subsubsection,paragraph,subparagraph}[section]{%
 \renewcommand*{\@@glossarysec}{#1}}
 %    \end{macrocode}
 %
-%\DescribeMacro{\@glossary@default@style}
 % The default glossary style is stored in 
-% \cmdname{@glossary@default@style}. This is initialised to
+% \cs{@glossary@default@style}. This is initialised to
 % \texttt{list}. (The \glostyle{list} style is
 % defined in the accompanying \styname{glossary-list} package
 % described in \autoref{sec:styles}.)
+%\begin{macro}{\@glossary@default@style}
 %    \begin{macrocode}
 \newcommand*{\@glossary@default@style}{list}
 %    \end{macrocode}
+%\end{macro}
 % The default glossary style can be changed using the \pkgopt{style}
 % package option. The value can be the name of any
 % defined glossary style. The glossary style is set at the beginning
@@ -1074,22 +1149,22 @@ subsection,subsubsection,paragraph,subparagraph}[section]{%
 % which that entry has been used, but it can also refer to any counter
 % used in the document (such as the section or equation counters).
 % The default number list format displays the number list ``as is'':
-%\DescribeMacro{\glossaryentrynumbers}
+%\begin{macro}{\glossaryentrynumbers}
 %    \begin{macrocode}
 \newcommand*{\glossaryentrynumbers}[1]{#1}
 %    \end{macrocode}
+%\end{macro}
 % Note that the entire number list for a given entry will be
-% passed to \cmdname{glossaryentrynumbers} so any font changes
+% passed to \cs{glossaryentrynumbers} so any font changes
 % will also be applied to the delimiters.
 % The \pkgopt{nonumberlist} package option suppresses the 
 % number lists (this simply redefines 
-% \cmdname{glossaryentrynumbers} to ignores its argument.)
+% \cs{glossaryentrynumbers} to ignores its argument.)
 %    \begin{macrocode}
 \DeclareOptionX{nonumberlist}{%
 \renewcommand*{\glossaryentrynumbers}[1]{}}
 %    \end{macrocode}
 %
-%\DescribeMacro{\glsdefaulttype}
 % Keep track of the default glossary. This is initialised to
 % the main glossary, but can be changed if for some reason
 % you want to make a secondary glossary the main glossary. This
@@ -1098,18 +1173,21 @@ subsection,subsubsection,paragraph,subparagraph}[section]{%
 % \gloskey{type}\igloskey[printglossary]{type} key in 
 %a key-value list.) This was mainly done so that 
 % \icmdname{loadglsentries} can temporarily change 
-% \cmdname{glsdefaulttype} while it loads a file containing
+% \cs{glsdefaulttype} while it loads a file containing
 % new glossary entries (see \autoref{sec:load}).
+%\begin{macro}{\glsdefaulttype}
 %    \begin{macrocode}
 \newcommand{\glsdefaulttype}{main}
 %    \end{macrocode}
-%\DescribeMacro{\acronymtype}
+%\end{macro}
 % Keep track of which glossary the acronyms are in. This is 
-% initialised to \cmdname{glsdefaulttype}, but is changed by
+% initialised to \cs{glsdefaulttype}, but is changed by
 % the \pkgopt{acronym} package option.
+%\begin{macro}{\acronymtype}
 %    \begin{macrocode}
 \newcommand{\acronymtype}{\glsdefaulttype}
 %    \end{macrocode}
+%\end{macro}
 % The \pkgopt{acronym} option sets an associated conditional 
 % which is used in \autoref{sec:acronym} to determine whether
 % or not to define a separate glossary for acronyms.
@@ -1117,18 +1195,19 @@ subsection,subsubsection,paragraph,subparagraph}[section]{%
 \define@boolkey{glossaries.sty}[gls]{acronym}[true]{}
 %    \end{macrocode}
 %
-%\DescribeMacro{\glscounter}
 % The default counter associated with the numbers in the glossary
-% is stored in \cmdname{glscounter}. This is initialised to the 
+% is stored in \cs{glscounter}. This is initialised to the 
 % page counter. This is used as the default counter when a
 % new glossary is defined, unless a different counter is specified
 % in the optional argument to \icmdname{newglossary} (see
 % \autoref{sec:newglos}).
+%\begin{macro}{\glscounter}
 %    \begin{macrocode}
 \newcommand{\glscounter}{page}
 %    \end{macrocode}
+%\end{macro}
 % The \pkgopt{counter} option changes the default counter. (This
-% just redefines \cmdname{glscounter}.)
+% just redefines \cs{glscounter}.)
 %    \begin{macrocode}
 \define@key{glossaries.sty}{counter}{%
 \renewcommand*{\glscounter}{#1}}
@@ -1161,11 +1240,21 @@ subsection,subsubsection,paragraph,subparagraph}[section]{%
 % for the symbol.
 %
 % The default values are defined as:
+%\begin{macro}{\@gls@sanitizedesc}
 %    \begin{macrocode}
 \newcommand*{\@gls@sanitizedesc}{\@onelevel@sanitize\@glo@desc}
+%    \end{macrocode}
+%\end{macro}
+%\begin{macro}{\@gls@sanitizename}
+%    \begin{macrocode}
 \newcommand*{\@gls@sanitizename}{\@onelevel@sanitize\@glo@name}
+%    \end{macrocode}
+%\end{macro}
+%\begin{macro}{\@gls@sanitizesymbol}
+%    \begin{macrocode}
 \newcommand*{\@gls@sanitizesymbol}{\@onelevel@sanitize\@glo@symbol}
 %    \end{macrocode}
+%\end{macro}
 % (There is no equivalent for the \gloskey{sort} key, since that
 % is only provided for the benefit of \appname{makeindex}, and
 % so will always be sanitized.)
@@ -1176,8 +1265,8 @@ subsection,subsubsection,paragraph,subparagraph}[section]{%
 % \texttt{true}.
 %
 % Firstly the \gloskey{description}. If set, it will redefine
-% \cmdname{@gls@sanitizedesc} to use \cmdname{@onelevel@sanitize},
-% otherwise \cmdname{@gls@sanitizedesc} will do nothing.
+% \cs{@gls@sanitizedesc} to use \cs{@onelevel@sanitize},
+% otherwise \cs{@gls@sanitizedesc} will do nothing.
 %    \begin{macrocode}
 \define@boolkey[gls]{sanitize}{description}[true]{%
 \ifgls@sanitize@description
@@ -1226,7 +1315,7 @@ name=true]{%
 %    \end{macrocode}
 %
 % If chapters are defined and the user has requested the
-% section counter as a package option, \cmdname{@chapter} will
+% section counter as a package option, \cs{@chapter} will
 % be modified so 
 % that it adds a \texttt{section.}\meta{n}\texttt{.0} target, 
 % otherwise entries placed before the first section of a chapter
@@ -1234,7 +1323,7 @@ name=true]{%
 %
 % The same problem will also occur if a lower sectional unit is
 % used, but this is less likely to happen. If it does, or if
-% you change \cmdname{glscounter} to "section" later, you
+% you change \cs{glscounter} to "section" later, you
 % will have to specify a different counter for the entries
 % that give rise to a \texttt{name}"{"\meta{section-level}"."\meta{n}".0}"
 % non-existent warning (e.g. "\gls[counter=chapter]{label}").
@@ -1249,125 +1338,156 @@ name=true]{%
 %\subsection{Default values}
 % This section sets up default values that are used by this
 % package. Some of the names may already be defined (e.g.\ by
-% \styname{babel}) so \cmdname{providecommand} is used.
+% \styname{babel}) so \cs{providecommand} is used.
 %
 % Main glossary title:
-%\DescribeMacro{\glossaryname}
+%\begin{macro}{\glossaryname}
 %    \begin{macrocode}
 \providecommand*{\glossaryname}{Glossary}
 %    \end{macrocode}
-%\DescribeMacro{\acronymname}
+%\end{macro}
 % The title for the "acronym" glossary type (which is defined if 
 % \pkgopt{acronym} package option is used) is given by
-% \cmdname{acronymname}. If the \pkgopt{acronym}
-% package option is not used, \cmdname{acronymname} won't be used.
+% \cs{acronymname}. If the \pkgopt{acronym}
+% package option is not used, \cs{acronymname} won't be used.
+%\begin{macro}{\acronymname}
 %    \begin{macrocode}
 \providecommand*{\acronymname}{Acronyms}
 %    \end{macrocode}
+%\end{macro}
 %
 % The following commands provide text for the headers used by 
 % some of the tabular-like glossary 
 % styles. Whether or not they get used in the glossary depends on
 % the glossary style.
-%\DescribeMacro{\entryname}
-%\DescribeMacro{\descriptionname}
-%\DescribeMacro{\symbolname}
-%\DescribeMacro{\pagelistname}
+%\begin{macro}{\entryname}
 %    \begin{macrocode}
 \providecommand*{\entryname}{Notation}
+%    \end{macrocode}
+%\end{macro}
+%\begin{macro}{\descriptionname}
+%    \begin{macrocode}
 \providecommand*{\descriptionname}{Description}
+%    \end{macrocode}
+%\end{macro}
+%\begin{macro}{\symbolname}
+%    \begin{macrocode}
 \providecommand*{\symbolname}{Symbol}
+%    \end{macrocode}
+%\end{macro}
+%\begin{macro}{\pagelistname}
+%    \begin{macrocode}
 \providecommand*{\pagelistname}{Page List}
 %    \end{macrocode}
+%\end{macro}
 % Labels for \appname{makeindex}'s symbol and number groups:
-%\DescribeMacro{\glssymbolsgroupname}\DescribeMacro{\glsnumbersgroupname}
+%\begin{macro}{\glssymbolsgroupname}
 %    \begin{macrocode}
 \providecommand*{\glssymbolsgroupname}{Symbols}
+%    \end{macrocode}
+%\end{macro}
+%\begin{macro}{\glsnumbersgroupname}
+%    \begin{macrocode}
 \providecommand*{\glsnumbersgroupname}{Numbers}
 %    \end{macrocode}
+%\end{macro}
+% The description terminator is given by \cs{glspostdescription}
+% (except for the 3 and 4 column styles). This is a full stop
+% by default:
+%\begin{macro}{\glspostdescription}
+%    \begin{macrocode}
+\newcommand*{\glspostdescription}{.}
+%    \end{macrocode}
+%\end{macro}
 %
-%\DescribeMacro{\istfilename}
 % The name of the \appname{makeindex} style file is given by
-% \cmdname{istfilename}. This file is 
+% \cs{istfilename}. This file is 
 % created by \icmdname{writeist} (which is used by 
 % \icmdname{makeglossaries}) so
 % redefining this command will only have an effect if it is 
 % done \emph{before} the \filetype{ist} file is created.
+%\begin{macro}{\istfilename}
 %    \begin{macrocode}
 \providecommand*{\istfilename}{\jobname.ist}
 %    \end{macrocode}
+%\end{macro}
 % The \appname{makeglossaries} Perl script picks up this name
 % from the auxiliary file and passes it to \appname{makeindex}
 % using the \texttt{-s} option. Since its not required by
-% \LaTeX, \cmdname{@istfilename} ignores its argument.
-%\DescribeMacro{\@istfilename}
+% \LaTeX, \cs{@istfilename} ignores its argument.
+%\begin{macro}{\@istfilename}
 %    \begin{macrocode}
 \newcommand*{\@istfilename}[1]{}
 %    \end{macrocode}
+%\end{macro}
 %
-%\DescribeMacro{\glscompositor}
 % This command is the value of the \istkey{page\_compositor}
 % \appname{makeindex} key. Again, any redefinition of this command 
-% must take place \emph{before} \cmdname{writeist} otherwise it 
+% must take place \emph{before} \cs{writeist} otherwise it 
 % will have no effect.
+%\begin{macro}{\glscompositor}
 %    \begin{macrocode}
 \newcommand{\glscompositor}{.}
 %    \end{macrocode}
+%\end{macro}
 % (The page compositor is usually defined as a dash when using
 % \appname{makeindex}, but most of the standard counters used
 % by \LaTeX\ use a full stop as the compositor, which is why I
 % have used it as the default.)
 %
-%\DescribeMacro{\glsnumberformat}
-% The command \cmdname{glsnumberformat} indicates the default
+% The command \cs{glsnumberformat} indicates the default
 % format for the page numbers in the glossary. (Note that this
 % is not the same as \icmdname{glossaryentrynumbers}, but applies
 % to individual numbers or groups of numbers within an entry's
 % associated number list.) If hyperlinks are defined, it will use
 % \icmdname{glshypernumber}, otherwise it will simply display its 
 % argument ``as is''.
+%\begin{macro}{\glsnumberformat}
 %    \begin{macrocode}
 \@ifundefined{hyperlink}{%
 \newcommand*{\glsnumberformat}[1]{#1}}{%
 \newcommand*{\glsnumberformat}[1]{\glshypernumber{#1}}}
 %    \end{macrocode}
-%\DescribeMacro{\delimN}
+%\end{macro}
 % Individual numbers in an entry's associated number list are
-% delimited using \cmdname{delimN} (which corresponds to the 
+% delimited using \cs{delimN} (which corresponds to the 
 % \istkey{delim\_n} \appname{makeindex} keyword.) The default value
 % is a comma followed by a space.
+%\begin{macro}{\delimN}
 %    \begin{macrocode}
 \newcommand{\delimN}{, }
 %    \end{macrocode}
-%\DescribeMacro{\delimR}
+%\end{macro}
 % A range of numbers within an entry's associated number list is
-% delimited using \cmdname{delimR} (which corresponds to the
+% delimited using \cs{delimR} (which corresponds to the
 % \istkey{delim\_r} \appname{makeindex} keyword.) The default is
 % an en-dash.
+%\begin{macro}{\delimR}
 %    \begin{macrocode}
 \newcommand{\delimR}{--}
 %    \end{macrocode}
+%\end{macro}
 %
-%\DescribeMacro{\glossarypreamble}
-% The glossary preamble is given by \cmdname{glossarypreamble}. This
+% The glossary preamble is given by \cs{glossarypreamble}. This
 % will appear after the glossary sectioning command, and before the
 % \envname{theglossary} environment. It is designed to allow the
 % user to add information pertaining to the glossary (e.g.\ ``page
 % numbers in italic indicate the primary definition'') therefore 
-% \cmdname{glossarypremable} shouldn't be affected by the glossary
+% \cs{glossarypremable} shouldn't be affected by the glossary
 % style. (So if you define your own glossary style, don't have it 
-% change \cmdname{glossarypreamble}.) The preamble is empty by
+% change \cs{glossarypreamble}.) The preamble is empty by
 % default. If you have multiple glossaries, and you want a 
 % different preamble for each glossary, you will need to use
 % \icmdname{printglossary} for each glossary type, instead of 
-% \icmdname{printglossaries}, and redefine \cmdname{glossarypreamble}
+% \icmdname{printglossaries}, and redefine \cs{glossarypreamble}
 % before each \icmdname{printglossary}.
+%\begin{macro}{\glossarypreamble}
 %    \begin{macrocode}
 \newcommand*{\glossarypreamble}{}
 %    \end{macrocode}
+%\end{macro}
 %
-%\DescribeMacro{\glossarypostamble}
-% The glossary postamble is given by \cmdname{glossarypostamble}.
+% The glossary postamble is given by \cs{glossarypostamble}.
 % This is provided to allow the user to
 % add something after the end of the \envname{theglossary}
 % environment (again, this shouldn't be affected by the
@@ -1379,17 +1499,19 @@ name=true]{%
 %\renewcommand{\glossarypostamble}{For a complete list of terms
 %see \cite{blah}\gdef\glossarypreamble{}}
 %\end{verbatim}
+%\begin{macro}{\glossarypostamble}
 %    \begin{macrocode}
 \newcommand*{\glossarypostamble}{}
 %    \end{macrocode}
+%\end{macro}
 %
-%\DescribeMacro{\glossarysection}
 % The sectioning command that starts a glossary is given by
-% \cmdname{glossarysection}. (This does not form part of the
+% \cs{glossarysection}. (This does not form part of the
 % glossary style, and so should not be changed by a glossary
 % style.) If \icmdname{phantomsection}
-% is defined, it uses \cmdname{\@p@glossarysection}, otherwise it
-% uses \cmdname{@glossarysection}.
+% is defined, it uses \cs{\@p@glossarysection}, otherwise it
+% uses \cs{@glossarysection}.
+%\begin{macro}{\glossarysection}
 %    \begin{macrocode}
 \newcommand*{\glossarysection}[2][\@gls@title]{%
 \def\@gls@title{#2}%
@@ -1397,162 +1519,175 @@ name=true]{%
 \@glossarysection{#1}{#2}}{\@p@glossarysection{#1}{#2}}%
 }
 %    \end{macrocode}
+%\end{macro}
 %
-% The required sectional unit is given by \cmdname{@@glossarysec}
+% The required sectional unit is given by \cs{@@glossarysec}
 % which was defined by the \pkgopt{section} package option. The
 % starred form of the command is chosen. If you want a numbered 
 % section for the glossary or if you don't want any sectional
-% command, you will need to redefine \cmdname{glossarysection}.
+% command, you will need to redefine \cs{glossarysection}.
 %
-%\DescribeMacro{\@glossarysection}
-%The command \cmdname{@glossarysection} indicates how to start
+%The command \cs{@glossarysection} indicates how to start
 % the glossary section if \icmdname{phantomsection} is not defined.
+%\begin{macro}{\@glossarysection}
 %    \begin{macrocode}
 \newcommand*{\@glossarysection}[2]{%
 \csname\@@glossarysec\endcsname*{#2}
 \@gls@toc{#1}{\@@glossarysec}}
 %    \end{macrocode}
+%\end{macro}
 %
-%\DescribeMacro{\@p@glossarysection}
-% As \cmdname{@glossarysection}, but put in 
-% \icmdname{phantomsection}, and swap where \cmdname{@gls@toc} goes. 
-% If using chapters do a \cmdname{clearpage}. This ensures that
+% As \cs{@glossarysection}, but put in 
+% \icmdname{phantomsection}, and swap where \cs{@gls@toc} goes. 
+% If using chapters do a \cs{clearpage}. This ensures that
 % the hyper link from the table of contents leads to the line above
 % the heading, rather than the line below it.
+%\begin{macro}{\@p@glossarysection}
 %    \begin{macrocode}
 \newcommand*{\@p@glossarysection}[2]{%
 \gls@doclearpage
 \phantomsection\@gls@toc{#1}{\@@glossarysec}%
 \csname\@@glossarysec\endcsname*{#2}}
 %    \end{macrocode}
+%\end{macro}
 %
-%\DescribeMacro{\gls@doclearpage}
-%The \cmdname{gls@doclearpage} command is used to issue a
-% \cmdname{clearpage} (or \cmdname{cleardoublepage}) depending
+%The \cs{gls@doclearpage} command is used to issue a
+% \cs{clearpage} (or \cs{cleardoublepage}) depending
 % on whether the glossary sectional unit is a chapter. If the
 % sectional unit is something else, do nothing.
+%\begin{macro}{\gls@doclearpage}
 %    \begin{macrocode}
 \newcommand{\gls@doclearpage}{%
 \ifthenelse{\equal{\@@glossarysec}{chapter}}{%
 \@ifundefined{cleardoublepage}{\clearpage}{\cleardoublepage}}{}%
 }
 %    \end{macrocode}
+%\end{macro}
 %
-%\DescribeMacro{\@gls@toc}
 % The glossary is added to the table of contents if glstoc flag set.
-% If it is set, \cmdname{@gls@toc} will add a line to the 
+% If it is set, \cs{@gls@toc} will add a line to the 
 % \filetype{toc} file, otherwise it will do nothing.
-% (The first argument to \cmdname{@gls@toc} is the title for the
+% (The first argument to \cs{@gls@toc} is the title for the
 % table of contents, the second argument is the sectioning type.) 
+%\begin{macro}{\@gls@toc}
 %    \begin{macrocode}
 \newcommand*{\@gls@toc}[2]{%
 \ifglstoc \addcontentsline{toc}{#2}{#1}\fi}
 %    \end{macrocode}
+%\end{macro}
 %
 %\subsection{Loops and conditionals}
-%\DescribeMacro{\forallglossaries}
 % To iterate through all glossaries (or comma-separated list of
 % glossary names given in optional argument) use:\\[10pt]
-% \cmdname{forallglossaries}\oarg{glossary list}\marg{cmd}\marg{code}\\[10pt]
+% \cs{forallglossaries}\oarg{glossary list}\marg{cmd}\marg{code}\\[10pt]
 % where \meta{cmd} is
 % a control sequence which will be set to the name of the
 % glossary in the current iteration.
+%\begin{macro}{\forallglossaries}
 %    \begin{macrocode}
 \newcommand*{\forallglossaries}[3][\@glo@types]{%
 \@for#2:=#1\do{\ifthenelse{\equal{#2}{}}{}{#3}}}
 %    \end{macrocode}
+%\end{macro}
 %
-%\DescribeMacro{\forglsentries}
 % To iterate through all entries in a given glossary use:\\[10pt]
-%\cmdname{forglsentries}\oarg{type}\marg{cmd}\marg{code}\\[10pt]
+%\cs{forglsentries}\oarg{type}\marg{cmd}\marg{code}\\[10pt]
 %where \meta{type} is the glossary label and \meta{cmd} is a
 % control sequence which will be set to the entry label in the
 % current iteration.
+%\begin{macro}{\forglsentries}
 %    \begin{macrocode}
 \newcommand*{\forglsentries}[3][\glsdefaulttype]{%
 \edef\@@glo@list{\csname glolist@#1\endcsname}%
 \@for#2:=\@@glo@list\do{%
 \ifthenelse{\equal{#2}{}}{}{#3}}}
 %    \end{macrocode}
+%\end{macro}
 %
-%\DescribeMacro{\forallglsentries}
 % To iterate through all glossary entries over all glossaries listed
 % in the optional argument (the default is all glossaries) use:\\[10pt] 
-% \cmdname{forallglsentries}\oarg{glossary list}\marg{cmd}\marg{code}\\[10pt]
-% Within \cmdname{forallglsentries}, the current glossary type
-% is given by \cmdname{@@this@glo@}.
+% \cs{forallglsentries}\oarg{glossary list}\marg{cmd}\marg{code}\\[10pt]
+% Within \cs{forallglsentries}, the current glossary type
+% is given by \cs{@@this@glo@}.
+%\begin{macro}{\forallglsentries}
 %    \begin{macrocode}
 \newcommand*{\forallglsentries}[3][\@glo@types]{%
 \expandafter\forallglossaries\expandafter[#1]{\@@this@glo@}{%
 \forglsentries[\@@this@glo@]{#2}{#3}}}
 %    \end{macrocode}
+%\end{macro}
 %
-%\DescribeMacro{\ifglossaryexists}
 % To check to see if a glossary exists use:\\[10pt]
-%\cmdname{ifglossaryexists}\marg{type}\marg{true-text}\marg{false-text}\\[10pt]
+%\cs{ifglossaryexists}\marg{type}\marg{true-text}\marg{false-text}\\[10pt]
 %where \meta{type} is the glossary's label.
+%\begin{macro}{\ifglossaryexists}
 %    \begin{macrocode}
 \newcommand{\ifglossaryexists}[3]{%
 \@ifundefined{@glotype@#1@out}{#3}{#2}}
 %    \end{macrocode}
+%\end{macro}
 %
-%\DescribeMacro{\ifglsentryexists}
 % To check to see if a glossary entry has been defined use:\\[10pt]
-% \cmdname{ifglsentryexists}\marg{label}\marg{true text}\marg{false text}\\[10pt]
+% \cs{ifglsentryexists}\marg{label}\marg{true text}\marg{false text}\\[10pt]
 %where \meta{label} is the entry's label.
+%\begin{macro}{\ifglsentryexists}
 %    \begin{macrocode}
 \newcommand{\ifglsentryexists}[3]{%
 \@ifundefined{glo@#1@name}{#3}{#2}}
 %    \end{macrocode}
+%\end{macro}
 %
-%\DescribeMacro{\ifglsused}
 % To determine if given glossary entry has been 
 % used in the document text yet use:\\[10pt]
-% \cmdname{ifglsused}\marg{label}\marg{true text}\marg{false text}\\[10pt]
+% \cs{ifglsused}\marg{label}\marg{true text}\marg{false text}\\[10pt]
 % where \meta{label} is the entry's label.
 % If true it will do \meta{true text}
 % otherwise it will do \meta{false text}.
+%\begin{macro}{\ifglsused}
 %    \begin{macrocode}
 \newcommand*{\ifglsused}[3]{\ifthenelse{\boolean{glo@#1@flag}}{#2}{#3}}
 %    \end{macrocode}
+%\end{macro}
 %The following two commands will cause an error if the given
 % condition fails:
 %
-%\DescribeMacro{\glsdoifexists}
-%\cmdname{glsdoifexists}\marg{label}\marg{code}\par
+%\cs{glsdoifexists}\marg{label}\marg{code}\par
 % Generate an error if entry specified by \meta{label} doesn't 
 % exists, otherwise do \meta{code}.
+%\begin{macro}{\glsdoifexists}
 %    \begin{macrocode}
 \newcommand{\glsdoifexists}[2]{\ifglsentryexists{#1}{#2}{%
 \PackageError{glossaries}{Glossary entry `#1' has not been
 defined.}{You need to define a glossary entry before you
 can use it.}}}
 %    \end{macrocode}
+%\end{macro}
 %
-%\DescribeMacro{\glsdoifnoexists}
-%\cmdname{glsdoifnoexists}\marg{label}\marg{code}\par
+%\cs{glsdoifnoexists}\marg{label}\marg{code}\par
 % The opposite: only do second argument if the entry doesn't
 % exists. Generate an error message if it exists.
+%\begin{macro}{\glsdoifnoexists}
 %    \begin{macrocode}
 \newcommand{\glsdoifnoexists}[2]{\ifglsentryexists{#1}{%
 \PackageError{glossaries}{Glossary entry `#1' has already
 been defined.}{}}{#2}}
 %    \end{macrocode}
+%\end{macro}
 %
 %\subsection{Defining new glossaries}\label{sec:newglos}
-%\DescribeMacro{\@glo@types}
 % A comma-separated list of glossary names is stored
-% in \cmdname{@glo@types}. When a new glossary type
+% in \cs{@glo@types}. When a new glossary type
 % is created, its identifying name is added to this list.
 % This is used by commands that iterate through all glossaries
 % (such as \icmdname{makeglossaries} and \icmdname{printglossaries}.)
+%\begin{macro}{\@glo@types}
 %    \begin{macrocode}
 \newcommand*{\@glo@types}{,}
 %    \end{macrocode}
+%\end{macro}
 %
-%\DescribeMacro{\newglossary}
-% A new glossary type is defined using \cmdname{newglossary}.
-% Syntax:\\[10pt]\cmdname{newglossary}\oarg{log-ext}\marg{name}\marg{in-ext}\marg{out-ext}%
+% A new glossary type is defined using \cs{newglossary}.
+% Syntax:\\[10pt]\cs{newglossary}\oarg{log-ext}\marg{name}\marg{in-ext}\marg{out-ext}%
 %\marg{title}\oarg{counter}\\[10pt]%
 % where \meta{log-ext} is the extension of the \appname{makeindex}
 % transcript file, \meta{in-ext} is the extension of the glossary 
@@ -1567,6 +1702,7 @@ been defined.}{}}{#2}}
 % script reads in the relevant extensions from the auxiliary file,
 % and passes the appropriate file names and switches to 
 % \appname{makeindex}.)
+%\begin{macro}{\newglossary}
 %    \begin{macrocode}
 \newcommand*{\newglossary}[5][glg]{%
 \ifglossaryexists{#2}{%
@@ -1594,7 +1730,7 @@ exists}%
 \protected@write\@auxout{}{\string\@newglossary{#2}{#1}{#3}{#4}}%
 %    \end{macrocode}
 % How to display this entry in the document text (uses
-% \cmdname{glsdisplay} and \cmdname{glsdisplayfirst} by
+% \cs{glsdisplay} and \cs{glsdisplayfirst} by
 % default). These can be redefined by the user later if required
 % (see \icmdname{defglsdisplay} and \icmdname{defglsdisplayfirst})
 %    \begin{macrocode}
@@ -1609,35 +1745,39 @@ exists}%
 %    \begin{macrocode}
 \@ifnextchar[{\@gls@setcounter{#2}}{\@gls@setcounter{#2}[\glscounter]}}}
 %    \end{macrocode}
+%\end{macro}
 % Only defined new glossaries in the preamble:
 %    \begin{macrocode}
 \@onlypreamble{\newglossary}
 %    \end{macrocode}
-%\DescribeMacro{\@newglossary}
-%\cmdname{@newglossary} is used to specify the file extensions
+%\cs{@newglossary} is used to specify the file extensions
 % for the \appname{makeindex} input, output and transcript files.
 % It is written to the auxiliary file by \icmdname{newglossary}.
-% Since it is not used by \LaTeX, \cmdname{@newglossary} simply
+% Since it is not used by \LaTeX, \cs{@newglossary} simply
 % ignores its arguments.
+%\begin{macro}{\@newglossary}
 %    \begin{macrocode}
 \newcommand*{\@newglossary}[4]{}
 %    \end{macrocode}
-%\DescribeMacro{\@gls@setcounter}
+%\end{macro}
 % Store counter to be used for given glossary type (the first
 % argument is the glossary label, the second argument is the name 
 % of the counter):
+%\begin{macro}{\@gls@setcounter}
 %    \begin{macrocode}
 \def\@gls@setcounter#1[#2]{%
 \expandafter\def\csname @glotype@#1@counter\endcsname{#2}%
 }
 %    \end{macrocode}
-%\DescribeMacro{\@gls@getcounter}
+%\end{macro}
 % Get counter associated with given glossary (the argument is
 % the glossary label):
+%\begin{macro}{\@gls@getcounter}
 %    \begin{macrocode}
 \newcommand*{\@gls@getcounter}[1]{%
 \csname @glotype@#1@counter\endcsname}
 %    \end{macrocode}
+%\end{macro}
 %
 % Define the main glossary. This will be the first glossary to
 % be displayed when using \icmdname{printglossaries}.
@@ -1646,7 +1786,7 @@ exists}%
 %    \end{macrocode}
 %
 %\subsection{Defining new entries}\label{sec:newentry}
-% New glossary entries are defined using \cmdname{newglossaryentry}.
+% New glossary entries are defined using \cs{newglossaryentry}.
 % This command requires a label and a key-value list that defines
 % the relevant information for that entry. The definition for these
 % keys follows. Note that the \gloskey{name},
@@ -1676,7 +1816,7 @@ exists}%
 % commands.) The \gloskey{description} key is required when
 % defining a new glossary entry. (Be careful not to make the
 % description too long, because \appname{makeindex} has a limited
-% buffer. \cmdname{@glo@desc} is defined to be a short command 
+% buffer. \cs{@glo@desc} is defined to be a short command 
 % to discourage lengthy descriptions
 % for this reason. If you do have a very long description, or if
 % you require paragraph breaks, define a separate command that 
@@ -1738,7 +1878,7 @@ exists}%
 %    \end{macrocode}
 %
 % The \gloskey{symbol} key is ignored by most of the predefined
-% glossary styles, and defaults to \cmdname{relax} if omitted. 
+% glossary styles, and defaults to \cs{relax} if omitted. 
 % It is provided for glossary styles that require an associated 
 % symbol, as well as a name and description. To make this value 
 % appear in the glossary, you need to redefine 
@@ -1771,12 +1911,12 @@ counter as its value}}{%
 \def\@glo@counter{#1}}}
 %    \end{macrocode}
 %
-%\DescribeMacro{\newglossaryentry}
-% Define \cmdname{newglossaryentry}%
+% Define \cs{newglossaryentry}%
 % \marg{label} \marg{key-val list}. 
 % There are two required fields in \meta{key-val list}: 
 % \gloskey{name} and 
 % \gloskey{description}. (See above.)
+%\begin{macro}{\newglossaryentry}
 %    \begin{macrocode}
 \DeclareRobustCommand{\newglossaryentry}[2]{%
 %    \end{macrocode}
@@ -1836,13 +1976,14 @@ in it}}{%
 %    \begin{macrocode}
 \expandafter\gdef\csname glo@#1@flagfalse\endcsname{%
 \expandafter\global\expandafter
-\let\csname ifglo@#1@flag\endcsname\iffalse}
+\let\csname ifglo@#1@flag\endcsname\iffalse}%
 \expandafter\gdef\csname glo@#1@flagtrue\endcsname{%
 \expandafter\global\expandafter
-\let\csname ifglo@#1@flag\endcsname\iftrue}
+\let\csname ifglo@#1@flag\endcsname\iftrue}%
 \csname glo@#1@flagfalse\endcsname
 }}
 %    \end{macrocode}
+%\end{macro}
 % Only defined new glossary entries in the preamble:
 %    \begin{macrocode}
 \@onlypreamble{\newglossaryentry}
@@ -1850,75 +1991,83 @@ in it}}{%
 %
 %\subsection{Resetting and unsetting entry flags}
 % Each glossary entry is assigned a conditional of the form
-%\cmdname{ifglo@}\meta{label}\texttt{@flag} which determines
+%\cs{ifglo@}\meta{label}\texttt{@flag} which determines
 % whether or not the entry has been used (see also 
 % \icmdname{ifglsused} defined below.) These flags can
 % be set and unset using the following macros:
 %
-%\DescribeMacro{\glsreset}
-% The command \cmdname{glsreset}\marg{label} can be used
+% The command \cs{glsreset}\marg{label} can be used
 % to set the entry flag to indicate that it hasn't been used yet. The
 % required argument is the entry label.
+%\begin{macro}{\glsreset}
 %    \begin{macrocode}
 \newcommand*{\glsreset}[1]{%
 \glsdoifexists{#1}{%
 \expandafter\global\csname glo@#1@flagfalse\endcsname}}
 %    \end{macrocode}
-%\DescribeMacro{\glslocalreset}
+%\end{macro}
 % As above, but with only a local effect:
+%\begin{macro}{\glslocalreset}
 %    \begin{macrocode}
 \newcommand*{\glslocalreset}[1]{%
 \glsdoifexists{#1}{%
 \expandafter\let\csname ifglo@#1@flag\endcsname\iffalse}}
 %    \end{macrocode}
-%\DescribeMacro{\glsunset}
-% The command \cmdname{glsunset}\marg{label} can be used to
+%\end{macro}
+% The command \cs{glsunset}\marg{label} can be used to
 % set the entry flag to indicate that it has been used. The required
 % argument is the entry label.
+%\begin{macro}{\glsunset}
 %    \begin{macrocode}
 \newcommand*{\glsunset}[1]{%
 \glsdoifexists{#1}{%
 \expandafter\global\csname glo@#1@flagtrue\endcsname}}
 %    \end{macrocode}
-%\DescribeMacro{\glslocalunset}
+%\end{macro}
 % As above, but with only a local effect:
+%\begin{macro}{\glslocalunset}
 %    \begin{macrocode}
 \newcommand*{\glslocalunset}[1]{%
 \glsdoifexists{#1}{%
 \expandafter\let\csname ifglo@#1@flag\endcsname\iftrue}}
 %    \end{macrocode}
-%\DescribeMacro{\glsresetall}
+%\end{macro}
 % Reset all entries for the named glossaries (supplied in a 
 % comma-separated list). 
-% Syntax: \cmdname{glsresetall}\oarg{glossary-list}
+% Syntax: \cs{glsresetall}\oarg{glossary-list}
+%\begin{macro}{\glsresetall}
 %    \begin{macrocode}
 \newcommand*{\glsresetall}[1][\@glo@types]{%
 \forallglsentries[#1]{\@glsentry}{%
 \glsreset{\@glsentry}}}
 %    \end{macrocode}
-%\DescribeMacro{\glslocalresetall}
+%\end{macro}
 % As above, but with only a local effect:
+%\begin{macro}{\glslocalresetall}
 %    \begin{macrocode}
 \newcommand*{\glslocalresetall}[1][\@glo@types]{%
 \forallglsentries[#1]{\@glsentry}{%
 \glslocalreset{\@glsentry}}}
 %    \end{macrocode}
-%\DescribeMacro{\glsunsetall}
+%\end{macro}
 % Unset all entries for the named glossaries (supplied in a 
 % comma-separated list). 
-% Syntax: \cmdname{glsunsetall}\oarg{glossary-list}
+% Syntax: \cs{glsunsetall}\oarg{glossary-list}
+%\begin{macro}{\glsunsetall}
 %    \begin{macrocode}
 \newcommand*{\glsunsetall}[1][\@glo@types]{%
 \forallglsentries[#1]{\@glsentry}{%
 \glsunset{\@glsentry}}}
 %    \end{macrocode}
-%\DescribeMacro{\glslocalunsetall}
+%\end{macro}
 % As above, but with only a local effect:
+%\begin{macro}{\glslocalunsetall}
 %    \begin{macrocode}
 \newcommand*{\glslocalunsetall}[1][\@glo@types]{%
 \forallglsentries[#1]{\@glsentry}{%
 \glslocalunset{\@glsentry}}}
 %    \end{macrocode}
+%\end{macro}
 %
 % \subsection{Loading files containing glossary entries}
 %\label{sec:load}
@@ -1926,9 +2075,8 @@ in it}}{%
 % These external files can contain \icmdname{newglossaryentry}
 % and \icmdname{newacronym} commands.\footnote{and any other valid 
 %\LaTeX\ code that can be used in the preamble.}\\[10pt]
-%\DescribeMacro{\loadglsentries}
-% \cmdname{loadglsentries}\oarg{type}\marg{filename}\\[10pt]
-% This command will input the file using \cmdname{input}.
+% \cs{loadglsentries}\oarg{type}\marg{filename}\\[10pt]
+% This command will input the file using \cs{input}.
 % The optional argument specifies to which glossary the
 % entries should be assigned if they haven't used the \gloskey{type}
 % key. If the optional argument is not specified, the default
@@ -1937,18 +2085,21 @@ in it}}{%
 % variants or \icmdname{glsadd} and \icmdname{glsaddall} 
 % will appear in the glossary.) The mandatory argument is 
 % the filename (with or without .tex extension.)
+%\begin{macro}{\loadglsentries}
 %    \begin{macrocode}
 \newcommand*{\loadglsentries}[2][\@gls@default]{%
 \let\@gls@default\glsdefaulttype
 \def\glsdefaulttype{#1}\input{#2}%
 \let\glsdefaulttype\@gls@default}
 %    \end{macrocode}
-% \cmdname{loadglsentries} can only be used in the preamble:
+%\end{macro}
+% \cs{loadglsentries} can only be used in the preamble:
 %    \begin{macrocode}
 \@onlypreamble{\loadglsentries}
 %    \end{macrocode}
 %
 %\subsection{Using glossary entries in the text}
+%\label{sec:code:glslink}
 %
 % Any term that has been defined using \icmdname{newglossaryentry}
 % (or \icmdname{newacronym}) can be displayed in the text 
@@ -1957,11 +2108,18 @@ in it}}{%
 % \icmdname{glslink}, the way the term appears in the text is
 % determined by \icmdname{glsdisplayfirst} (if it is the first
 % time the term has been used) or \icmdname{glsdisplay} (for
-% subsequent use.)
+% subsequent use.) Any formatting commands (such as \cs{textbf}
+% is governed by \icmdname{glstextformat}. By default this just 
+% displays the \term{link text} ``as is''.
+%\changes{1.04}{2007 Aug 3}{Added 'glstextformat}%
+%\begin{macro}{\glstextformat}
+%    \begin{macrocode}
+\newcommand*{\glstextformat}[1]{#1}
+%    \end{macrocode}
+%\end{macro}
 %
-%\DescribeMacro{\glsdisplayfirst}
 % The first time an entry is used, the way in which it is
-% displayed is governed by \cmdname{glsdisplayfirst}. This
+% displayed is governed by \cs{glsdisplayfirst}. This
 % takes four parameters: \verb|#1| will be the value
 % of the entry's \gloskey{first} or \gloskey{firstplural} key, 
 % \verb|#2| will be the value of the entry's \gloskey{description}
@@ -1970,58 +2128,63 @@ in it}}{%
 % argument to commands like \icmdname{gls} and \icmdname{glspl}.
 % The default is to display the first parameter followed by the
 % additional text.
+%\begin{macro}{\glsdisplayfirst}
 %    \begin{macrocode}
 \newcommand*{\glsdisplayfirst}[4]{#1#4}
 %    \end{macrocode}
+%\end{macro}
 %
-%\DescribeMacro{\glsdisplay}
 % After the first use, the entry is displayed according to
-% the format of \cmdname{glsdisplay}. Again, it takes four
+% the format of \cs{glsdisplay}. Again, it takes four
 % parameters: \verb|#1| will be the value of the
 % entry's \gloskey{text} or \gloskey{plural} key, 
 % \verb|#2| will be the value of the entry's \gloskey{description} 
 % key, \verb|#3| will be the value of the entry's \gloskey{symbol}
 % key and \verb|#4| is additional text supplied by the final optional
 % argument to commands like \icmdname{gls} and \icmdname{glspl}.
+%\begin{macro}{\glsdisplay}
 %    \begin{macrocode}
 \newcommand*{\glsdisplay}[4]{#1#4}
 %    \end{macrocode}
+%\end{macro}
 %
-% When a new glossary is created it uses \cmdname{glsdisplayfirst}
-% and \cmdname{glsdisplay} as the default way of displaying its
+% When a new glossary is created it uses \cs{glsdisplayfirst}
+% and \cs{glsdisplay} as the default way of displaying its
 % entry in the text. This can be changed for the entries belonging 
 % to an individual glossary using 
 % \icmdname{defglsdisplay} and \icmdname{defglsdisplayfirst}.
 %\\[10pt]
-%\DescribeMacro{\defglsdisplay}
-% \cmdname{defglsdisplay}\oarg{type}\marg{definition}\\[10pt]%
+% \cs{defglsdisplay}\oarg{type}\marg{definition}\\[10pt]%
 % The glossary type is given by \meta{type} (the default glossary
 % if omitted) and
 % \meta{definition} should have at most \verb|#1|, \verb|#2|,
 % \verb|#3| and \verb|#4|. These represent the same arguments
 % as those described for \icmdname{glsdisplay}.
+%\begin{macro}{\defglsdisplay}
 %    \begin{macrocode}
 \newcommand*{\defglsdisplay}[2][\glsdefaulttype]{%
 \expandafter\def\csname gls@#1@display\endcsname##1##2##3##4{#2}}
 %    \end{macrocode}
+%\end{macro}
 %\vskip5pt
-%\DescribeMacro{\defglsdisplayfirst}
-% \cmdname{defglsdisplayfirst}\oarg{type}\marg{definition}\\[10pt]%
+% \cs{defglsdisplayfirst}\oarg{type}\marg{definition}\\[10pt]%
 % The glossary type is given by \meta{type} (the default glossary
 % if omitted) and
 % \meta{definition} should have at most \verb|#1|, \verb|#2|,
 % \verb|#3| and \verb|#4|. These represent the same arguments
 % as those described for \icmdname{glsdisplayfirst}.
+%\begin{macro}{\defglsdisplayfirst}
 %    \begin{macrocode}
 \newcommand*{\defglsdisplayfirst}[2][\glsdefaulttype]{%
 \expandafter\def\csname gls@#1@displayfirst\endcsname##1##2##3##4{#2}}
 %    \end{macrocode}
+%\end{macro}
 %
 %\subsubsection{Links to glossary entries}
 % The links to glossary entries all have a first optional 
 % argument that can be used to change the format and counter
-% of the associated entry number. Except for \cmdname{glslink},
-% the commands like \cmdname{gls} have a final optional
+% of the associated entry number. Except for \cs{glslink},
+% the commands like \cs{gls} have a final optional
 % argument that can be used to insert additional text in the
 % link (this will usually be appended, but can be redefined using
 % \icmdname{defglsdisplay} and \icmdname{defglsdisplayfirst}). 
@@ -2061,30 +2224,34 @@ counter as its value}}{%
 \define@boolkey{glslink}{hyper}[true]{}
 %    \end{macrocode}
 %
-%\DescribeMacro{\glslink}
 %Syntax:\\[10pt]
-% \cmdname{glslink}\oarg{options}\marg{label}\marg{text}
+% \cs{glslink}\oarg{options}\marg{label}\marg{text}
 %\\[10pt]
 % Display \meta{text} in the document, and add the entry information
 % for \meta{label} into the relevant glossary. The optional
 % argument should be a key value list using the \texttt{glslink}
 % keys defined above.
 %
-% There is also a starred version:\DescribeMacro{\glslink*}\\[10pt]
-% \cmdname{glslink*}\oarg{options}\marg{label}\marg{text}\\[10pt]
+% There is also a starred version:\\[10pt]
+% \cs{glslink*}\oarg{options}\marg{label}\marg{text}\\[10pt]
 % which is equivalent to 
-% \cmdname{glslink}"[hyper=false,"\meta{options}"]"\marg{label}\marg{text}
+% \cs{glslink}"[hyper=false,"\meta{options}"]"\marg{label}\marg{text}
 %
 % First determine whether or not we are using the starred version:
+%\begin{macro}{\glslink}
 %    \begin{macrocode}
 \newcommand{\glslink}{%
 \@ifstar\@sgls@link\@gls@link}
 %    \end{macrocode}
+%\end{macro}
 % Define the starred version:
+%\begin{macro}{\@sgls@link}
 %    \begin{macrocode}
 \newcommand*{\@sgls@link}[1][]{\@gls@link[hyper=false,#1]}
 %    \end{macrocode}
+%\end{macro}
 % Define the un-starred version:
+%\begin{macro}{\@gls@link}
 %    \begin{macrocode}
 \newcommand*{\@gls@link}[3][]{%
 \glsdoifexists{#2}{%
@@ -2094,9 +2261,9 @@ counter as its value}}{%
 \setkeys{glslink}{#1}%
 \edef\theglsentrycounter{\csname the\@gls@counter\endcsname}%
 \ifKV@glslink@hyper
-\@glslink{glo:#2}{#3}%
+\@glslink{glo:#2}{\glstextformat{#3}}%
 \else
-#3\relax
+\glstextformat{#3}\relax
 \fi
 \protected@edef\@glo@sort{\csname glo@#2@sort\endcsname}%
 \@gls@checkmkidxchars\@glo@sort
@@ -2114,9 +2281,11 @@ counter as its value}}{%
 }{\@glo@symbol}\@gls@encapchar\@glo@numfmt}%
 }}
 %    \end{macrocode}
+%\end{macro}
 %\changes{1.01}{2007 May 17}{Added range facility in format key}%
 % Set the formatting information in the format required by 
 % \appname{makeindex}:
+%\begin{macro}{\@set@glo@numformat}
 %    \begin{macrocode}
 \def\@set@glo@numformat#1#2#3{%
 \expandafter\@glo@check@mkidxrangechar#3\@nil
@@ -2124,12 +2293,14 @@ counter as its value}}{%
 \expandafter\string\csname\@glo@suffix\endcsname}%
 \@gls@checkmkidxchars#1}
 %    \end{macrocode}
+%\end{macro}
 % Check to see if the given string starts with a ( or ). If it
-% does set \cmdname{@glo@prefix} to the starting character,
-% and \cmdname{@glo@suffix} to the rest (or "glsnumberformat"
+% does set \cs{@glo@prefix} to the starting character,
+% and \cs{@glo@suffix} to the rest (or "glsnumberformat"
 % if there is nothing else),
-% otherwise set \cmdname{@glo@prefix} to nothing and
-% \cmdname{@glo@suffix} to all of it.
+% otherwise set \cs{@glo@prefix} to nothing and
+% \cs{@glo@suffix} to all of it.
+%\begin{macro}{\@glo@check@mkidxrangechar}
 %    \begin{macrocode}
 \def\@glo@check@mkidxrangechar#1#2\@nil{%
 \if#1(\relax
@@ -2152,7 +2323,9 @@ counter as its value}}{%
   \fi
 \fi}
 %    \end{macrocode}
+%\end{macro}
 % Catch \appname{makeindex} special characters\mkidxspch:
+%\begin{macro}{\@gls@checkmkidxchars}
 %    \begin{macrocode}
 \newcommand{\@gls@checkmkidxchars}[1]{%
 \def\@gls@checkedmkidx{}%
@@ -2178,10 +2351,13 @@ counter as its value}}{%
 \expandafter\@gls@updatechecked\@gls@checkedmkidx{#1}%
 }
 %    \end{macrocode}
-% Update the control sequence and strip trailing \cmdname{@nil}:
+%\end{macro}
+% Update the control sequence and strip trailing \cs{@nil}:
+%\begin{macro}{\@gls@updatechecked}
 %    \begin{macrocode}
 \def\@gls@updatechecked#1\@nil#2{\def#2{#1}}
 %    \end{macrocode}
+%\end{macro}
 % Replace \verb|"| with \verb|""| since \verb|"| is a makeindex
 % special character\mkidxspch.
 %    \begin{macrocode}
@@ -2390,9 +2566,8 @@ counter as its value}}{%
 \@@gls@checkactual}
 %    \end{macrocode}
 %
-%\DescribeMacro{\@glslink}\DescribeMacro{\@glstarget}
 % If \icmdname{hyperlink}
-% is not defined, \cmdname{@glslink} and \cmdname{@glstarget}
+% is not defined, \cs{@glslink} and \cs{@glstarget}
 % ignore their first argument, and just do the second argument,
 % otherwise they are equivalent to \icmdname{hyperlink} and
 %\icmdname{hypertarget}.
@@ -2403,26 +2578,27 @@ counter as its value}}{%
 \gdef\@glstarget#1#2{\hypertarget{#1}{#2}}}
 %    \end{macrocode}
 %
-%\DescribeMacro{\glsdisablehyper}
-% Glossary hyperlinks can be disabled using \cmdname{glsdisablehyper}
+% Glossary hyperlinks can be disabled using \cs{glsdisablehyper}
 % (effect can be localised):
+%\begin{macro}{\glsdisablehyper}
 %    \begin{macrocode}
 \newcommand{\glsdisablehyper}{%
 \renewcommand*\@glslink[2]{##2}%
 \renewcommand*\@glstarget[2]{##2}}
 %    \end{macrocode}
-%\DescribeMacro{\glsenablehyper}
-% Glossary hyperlinks can be enabled using \cmdname{glsenablehyper}
+%\end{macro}
+% Glossary hyperlinks can be enabled using \cs{glsenablehyper}
 % (effect can be localised):
+%\begin{macro}{\glsenablehyper}
 %    \begin{macrocode}
 \newcommand{\glsenablehyper}{%
 \renewcommand*\@glslink[2]{\hyperlink{##1}{##2}}%
 \renewcommand*\@glstarget[2]{\hypertarget{##1}{##2}}}
 %    \end{macrocode}
+%\end{macro}
 %
-%\DescribeMacro{\gls}
 %Syntax:\\[10pt]
-% \cmdname{gls}\oarg{options}\marg{label}\oarg{insert text}\\[10pt]
+% \cs{gls}\oarg{options}\marg{label}\oarg{insert text}\\[10pt]
 % Link to glossary entry using singular form. The link text
 % is taken from the value of the \gloskey{text} or \gloskey{first}
 % keys used when the entry was defined.
@@ -2433,33 +2609,39 @@ counter as its value}}{%
 % After the mandatory argument, there is another optional argument 
 % to insert extra text in the link text (the location of the inserted
 % text is governed by \icmdname{glsdisplay} and 
-% \icmdname{glsdisplayfirst}). As with \cmdname{glslink}
+% \icmdname{glsdisplayfirst}). As with \cs{glslink}
 % there is a starred version which is the same as the unstarred 
 % version but with the \gloskey[glslink]{hyper} key set to \texttt{false}.
 % (Additional options can also be specified 
 % in the first optional argument.)
 %
 % First determine if we are using the starred form:
+%\begin{macro}{\gls}
 %    \begin{macrocode}
 \newcommand*{\gls}{\@ifstar\@sgls\@gls}
 %    \end{macrocode}
+%\end{macro}
 % Define the starred form:
+%\begin{macro}{\@sgls}
 %    \begin{macrocode}
 \newcommand*{\@sgls}[1][]{\@gls[hyper=false,#1]}
 %    \end{macrocode}
+%\end{macro}
 % Defined the un-starred form. Need to determine if there is
 % a final optional argument
+%\begin{macro}{\@gls}
 %    \begin{macrocode}
 \newcommand*{\@gls}[2][]{%
 \@ifnextchar[{\@gls@{#1}{#2}}{\@gls@{#1}{#2}[]}}
 %    \end{macrocode}
+%\end{macro}
 % Read in the final optional argument:
 %    \begin{macrocode}
 \def\@gls@#1#2[#3]{%
 \glsdoifexists{#2}{\edef\@glo@type{\glsentrytype{#2}}%
 %    \end{macrocode}
 % Determine what the link text should be (this is stored in 
-% \cmdname{@glo@text})
+% \cs{@glo@text})
 %    \begin{macrocode}
 \ifglsused{#2}{\protected@edef\@glo@text{%
 \csname gls@\@glo@type @display\endcsname
@@ -2468,7 +2650,7 @@ counter as its value}}{%
 \csname gls@\@glo@type @displayfirst\endcsname
 {\glsentryfirst{#2}}{\glsentrydesc{#2}}{\glsentrysymbol{#2}}{#3}}}%
 %    \end{macrocode}
-% Call \cmdname{@gls@link}
+% Call \cs{@gls@link}
 %    \begin{macrocode}
 \@gls@link[#1]{#2}{\@glo@text}%
 %    \end{macrocode}
@@ -2479,15 +2661,16 @@ counter as its value}}{%
 \xspace}
 %    \end{macrocode}
 %
-%\DescribeMacro{\Gls}
-% \cmdname{Gls} behaves like \cmdname{gls}, but the first letter
+% \cs{Gls} behaves like \cs{gls}, but the first letter
 % of the link text is converted to uppercase (note that if the
 % first letter has an accent, the accented letter will need to
 % be grouped when you define the entry.) It is mainly intended
 % for terms that start a sentence:
+%\begin{macro}{\Gls}
 %    \begin{macrocode}
 \newcommand*{\Gls}{\@ifstar\@sGls\@Gls}
 %    \end{macrocode}
+%\end{macro}
 % Define the starred form:
 %    \begin{macrocode}
 \newcommand*{\@sGls}[1][]{\@Gls[hyper=false,#1]}
@@ -2504,7 +2687,7 @@ counter as its value}}{%
 \glsdoifexists{#2}{\edef\@glo@type{\glsentrytype{#2}}%
 %    \end{macrocode}
 % Determine what the link text should be (this is stored in 
-% \cmdname{@glo@text})
+% \cs{@glo@text})
 %    \begin{macrocode}
 \ifglsused{#2}{\protected@edef\@glo@text{%
 \csname gls@\@glo@type @display\endcsname
@@ -2513,7 +2696,7 @@ counter as its value}}{%
 \csname gls@\@glo@type @displayfirst\endcsname
 {\glsentryfirst{#2}}{\glsentrydesc{#2}}{\glsentrysymbol{#2}}{#3}}}%
 %    \end{macrocode}
-% Call \cmdname{@gls@link}
+% Call \cs{@gls@link}
 %    \begin{macrocode}
 \@gls@link[#1]{#2}{\expandafter\MakeUppercase\@glo@text}%
 %    \end{macrocode}
@@ -2524,12 +2707,13 @@ counter as its value}}{%
 \xspace}
 %    \end{macrocode}
 %
-%\DescribeMacro{\GLS}
-% \cmdname{GLS} behaves like \icmdname{gls}, but the link
+% \cs{GLS} behaves like \icmdname{gls}, but the link
 % text is converted to uppercase:
+%\begin{macro}{\GLS}
 %    \begin{macrocode}
 \newcommand*{\GLS}{\@ifstar\@sGLS\@GLS}
 %    \end{macrocode}
+%\end{macro}
 % Define the starred form:
 %    \begin{macrocode}
 \newcommand*{\@sGLS}[1][]{\@GLS[hyper=false,#1]}
@@ -2546,7 +2730,7 @@ counter as its value}}{%
 \glsdoifexists{#2}{\edef\@glo@type{\glsentrytype{#2}}%
 %    \end{macrocode}
 % Determine what the link text should be (this is stored in 
-% \cmdname{@glo@text})
+% \cs{@glo@text})
 %    \begin{macrocode}
 \ifglsused{#2}{\protected@edef\@glo@text{%
 \csname gls@\@glo@type @display\endcsname
@@ -2555,7 +2739,7 @@ counter as its value}}{%
 \csname gls@\@glo@type @displayfirst\endcsname
 {\glsentryfirst{#2}}{\glsentrydesc{#2}}{\glsentrysymbol{#2}}{#3}}}%
 %    \end{macrocode}
-% Call \cmdname{@gls@link}
+% Call \cs{@gls@link}
 %    \begin{macrocode}
 \@gls@link[#1]{#2}{\MakeUppercase{\@glo@text}}%
 %    \end{macrocode}
@@ -2566,12 +2750,13 @@ counter as its value}}{%
 \xspace}
 %    \end{macrocode}
 %
-%\DescribeMacro{\glspl}
-% \cmdname{glspl} behaves in the same way as \icmdname{gls} except
+% \cs{glspl} behaves in the same way as \icmdname{gls} except
 % it uses the plural form.
+%\begin{macro}{\glspl}
 %    \begin{macrocode}
 \newcommand*{\glspl}{\@ifstar\@sglspl\@glspl}
 %    \end{macrocode}
+%\end{macro}
 % Define the starred form:
 %    \begin{macrocode}
 \newcommand*{\@sglspl}[1][]{\@glspl[hyper=false,#1]}
@@ -2588,7 +2773,7 @@ counter as its value}}{%
 \glsdoifexists{#2}{\edef\@glo@type{\glsentrytype{#2}}%
 %    \end{macrocode}
 % Determine what the link text should be (this is stored in 
-% \cmdname{@glo@text})
+% \cs{@glo@text})
 %    \begin{macrocode}
 \ifglsused{#2}{\protected@edef\@glo@text{%
 \csname gls@\@glo@type @display\endcsname
@@ -2597,7 +2782,7 @@ counter as its value}}{%
 \csname gls@\@glo@type @displayfirst\endcsname
 {\glsentryfirstplural{#2}}{\glsentrydesc{#2}}{\glsentrysymbol{#2}}{#3}}}%
 %    \end{macrocode}
-% Call \cmdname{@gls@link}
+% Call \cs{@gls@link}
 %    \begin{macrocode}
 \@gls@link[#1]{#2}{\@glo@text}%
 %    \end{macrocode}
@@ -2608,14 +2793,15 @@ counter as its value}}{%
 \xspace}
 %    \end{macrocode}
 %
-%\DescribeMacro{\Glspl}
-% \cmdname{Glspl} behaves in the same way as \icmdname{glspl}, except
+% \cs{Glspl} behaves in the same way as \icmdname{glspl}, except
 % that the first letter of the link text is converted to uppercase
 % (as with \icmdname{Gls}, if the first letter has an accent, it
 % will need to be grouped.)
+%\begin{macro}{\Glspl}
 %    \begin{macrocode}
 \newcommand*{\Glspl}{\@ifstar\@sGlspl\@Glspl}
 %    \end{macrocode}
+%\end{macro}
 % Define the starred form:
 %    \begin{macrocode}
 \newcommand*{\@sGlspl}[1][]{\@Glspl[hyper=false,#1]}
@@ -2632,7 +2818,7 @@ counter as its value}}{%
 \glsdoifexists{#2}{\edef\@glo@type{\glsentrytype{#2}}%
 %    \end{macrocode}
 % Determine what the link text should be (this is stored in 
-% \cmdname{@glo@text})
+% \cs{@glo@text})
 %    \begin{macrocode}
 \ifglsused{#2}{\protected@edef\@glo@text{%
 \csname gls@\@glo@type @display\endcsname
@@ -2641,7 +2827,7 @@ counter as its value}}{%
 \csname gls@\@glo@type @displayfirst\endcsname
 {\glsentryfirstplural{#2}}{\glsentrydesc{#2}}{\glsentrysymbol{#2}}{#3}}}%
 %    \end{macrocode}
-% Call \cmdname{@gls@link}
+% Call \cs{@gls@link}
 %    \begin{macrocode}
 \@gls@link[#1]{#2}{\expandafter\MakeUppercase\@glo@text}%
 %    \end{macrocode}
@@ -2652,12 +2838,13 @@ counter as its value}}{%
 \xspace}
 %    \end{macrocode}
 %
-%\DescribeMacro{\GLSpl}
-% \cmdname{GLSpl} behaves like \icmdname{glspl} except that all the
+% \cs{GLSpl} behaves like \icmdname{glspl} except that all the
 % link text is converted to uppercase.
+%\begin{macro}{\GLSpl}
 %    \begin{macrocode}
 \newcommand*{\GLSpl}{\@ifstar\@sGLSpl\@GLSpl}
 %    \end{macrocode}
+%\end{macro}
 % Define the starred form:
 %    \begin{macrocode}
 \newcommand*{\@sGLSpl}[1][]{\@GLSpl[hyper=false,#1]}
@@ -2674,7 +2861,7 @@ counter as its value}}{%
 \glsdoifexists{#2}{\edef\@glo@type{\glsentrytype{#2}}%
 %    \end{macrocode}
 % Determine what the link text should be (this is stored in 
-% \cmdname{@glo@text})
+% \cs{@glo@text})
 %    \begin{macrocode}
 \ifglsused{#2}{\protected@edef\@glo@text{%
 \csname gls@\@glo@type @display\endcsname
@@ -2683,7 +2870,7 @@ counter as its value}}{%
 \csname gls@\@glo@type @displayfirst\endcsname
 {\glsentryfirstplural{#2}}{\glsentrydesc{#2}}{\glsentrysymbol{#2}}{#3}}}%
 %    \end{macrocode}
-% Call \cmdname{@gls@link}
+% Call \cs{@gls@link}
 %    \begin{macrocode}
 \@gls@link[#1]{#2}{\MakeUppercase{\@glo@text}}%
 %    \end{macrocode}
@@ -2700,118 +2887,155 @@ counter as its value}}{%
 % These commands merely display entry information without adding
 % entries in the associated file or having hyperlinks.
 %
-%\DescribeMacro{\glsentryname}\DescribeMacro{\Glsentryname}
 % Get the entry name (as specified by the \gloskey{name} key
 % when the entry was defined.) The argument
 % is the label associated with the entry. Note that unless you
 % used \texttt{name=false} in the \pkgopt{sanitize} package option 
 % you may get unexpected results if the \gloskey{name} key contained 
 % any commands.
+%\begin{macro}{\glsentryname}
 %    \begin{macrocode}
 \newcommand*{\glsentryname}[1]{\csname glo@#1@name\endcsname}
+%    \end{macrocode}
+%\end{macro}
+%\begin{macro}{\Glsentryname}
+%    \begin{macrocode}
 \newcommand*{\Glsentryname}[1]{\expandafter
 \MakeUppercase\csname glo@#1@name\endcsname}
 %    \end{macrocode}
+%\end{macro}
 %
-%\DescribeMacro{\glsentrydesc}\DescribeMacro{\Glsentrydesc}
 % Get the entry description (as specified by the 
 % \gloskey{description} when the entry was defined.) The argument
 % is the label associated with the entry. Note that unless you
 % used \texttt{description=false} in the \pkgopt{sanitize} package 
 % option you may get unexpected results if the \gloskey{description} 
 % key contained any commands.
+%\begin{macro}{\glsentrydesc}
 %    \begin{macrocode}
 \newcommand*{\glsentrydesc}[1]{\csname glo@#1@desc\endcsname}
+%    \end{macrocode}
+%\end{macro}
+%\begin{macro}{\Glsentrydesc}
+%    \begin{macrocode}
 \newcommand*{\Glsentrydesc}[1]{\expandafter
 \MakeUppercase\csname glo@#1@desc\endcsname}
 %    \end{macrocode}
+%\end{macro}
 %
-%\DescribeMacro{\glsentrytext}\DescribeMacro{\Glsentrytext}
 % Get the entry text, as specified by the \gloskey{text} key when
 % the entry was defined. The argument
 % is the label associated with the entry:
+%\begin{macro}{\glsentrytext}
 %    \begin{macrocode}
 \newcommand*{\glsentrytext}[1]{\csname glo@#1@text\endcsname}
+%    \end{macrocode}
+%\end{macro}
+%\begin{macro}{\Glsentrytext}
+%    \begin{macrocode}
 \newcommand*{\Glsentrytext}[1]{\expandafter
 \MakeUppercase\csname glo@#1@text\endcsname}
 %    \end{macrocode}
+%\end{macro}
 %
-%\DescribeMacro{\glsentryplural}\DescribeMacro{\Glsentryplural}
 % Get the plural form:
+%\begin{macro}{\glsentryplural}
 %    \begin{macrocode}
 \newcommand*{\glsentryplural}[1]{\csname glo@#1@plural\endcsname}
+%    \end{macrocode}
+%\end{macro}
+%\begin{macro}{\Glsentryplural}
+%    \begin{macrocode}
 \newcommand*{\Glsentryplural}[1]{\expandafter
 \MakeUppercase\csname glo@#1@plural\endcsname}
 %    \end{macrocode}
+%\end{macro}
 %
-%\DescribeMacro{\glsentrysymbol}\DescribeMacro{\Glsentrysymbol}
 % Get the symbol associated with this entry. The argument
 % is the label associated with the entry. Note that unless you
 % used \texttt{symbol=false} in the \pkgopt{sanitize} package 
 % option you may get unexpected results if the \gloskey{symbol} 
 % key contained any commands.
+%\begin{macro}{\glsentrysymbol}
 %    \begin{macrocode}
 \newcommand*{\glsentrysymbol}[1]{\csname glo@#1@symbol\endcsname}
+%    \end{macrocode}
+%\end{macro}
+%\begin{macro}{\Glsentrysymbol}
+%    \begin{macrocode}
 \newcommand*{\Glsentrysymbol}[1]{\expandafter
 \MakeUppercase\csname glo@#1@symbol\endcsname}
 %    \end{macrocode}
+%\end{macro}
 %
-%\DescribeMacro{\glsentryfirst}\DescribeMacro{\Glsentryfirst}
 % Get the entry text to be used when the entry is first used in
 % the document (as specified by the \gloskey{first} key when
 % the entry was defined.)
+%\begin{macro}{\glsentryfirst}
 %    \begin{macrocode}
 \newcommand*{\glsentryfirst}[1]{\csname glo@#1@first\endcsname}
+%    \end{macrocode}
+%\end{macro}
+%\begin{macro}{\Glsentryfirst}
+%    \begin{macrocode}
 \newcommand*{\Glsentryfirst}[1]{\expandafter
 \MakeUppercase\csname glo@#1@first\endcsname}
 %    \end{macrocode}
+%\end{macro}
 %
-%\DescribeMacro{\glsentryfirstplural}\DescribeMacro{\Glsentryfirstplural}
 % Get the plural form (as specified by the \gloskey{firstplural}
 % key when the entry was defined.)
+%\begin{macro}{\glsentryfirstplural}
 %    \begin{macrocode}
 \newcommand*{\glsentryfirstplural}[1]{%
 \csname glo@#1@firstpl\endcsname}
+%    \end{macrocode}
+%\end{macro}
+%\begin{macro}{\Glsentryfirstplural}
+%    \begin{macrocode}
 \newcommand*{\Glsentryfirstplural}[1]{%
 \expandafter\MakeUppercase\csname glo@#1@firstpl\endcsname}
 %    \end{macrocode}
+%\end{macro}
 %
-%\DescribeMacro{\glsentrytype}
 % Display the glossary type with which this entry is associated
 % (as specified by the \gloskey{type} key used when the entry was 
 % defined)
+%\begin{macro}{\glsentrytype}
 %    \begin{macrocode}
 \newcommand*{\glsentrytype}[1]{\csname glo@#1@type\endcsname}
 %    \end{macrocode}
+%\end{macro}
 %
-%\DescribeMacro{\glsentrysort}
 % Display the sort text used for this entry. Note that the 
 % \gloskey{sort} key is sanitize, so unexpected results may 
 % occur if the \gloskey{sort} key contained commands.
+%\begin{macro}{\glsentrysort}
 %    \begin{macrocode}
 \newcommand*{\glsentrysort}[1]{\csname glo@#1@sort\endcsname}
 %    \end{macrocode}
+%\end{macro}
 %
 %\subsection{Adding an entry to the glossary without generating
 % text}
-% The following keys are provided for \cmdname{glsadd} and 
-% \cmdname{glsaddall}:
+% The following keys are provided for \cs{glsadd} and 
+% \cs{glsaddall}:
 %    \begin{macrocode}
 \define@key{glossadd}{counter}{\def\@glo@counter{#1}}
 \define@key{glossadd}{format}{\def\@glo@format{#1}}
 %    \end{macrocode}
-% This key is only used by \cmdname{glsaddall}:
+% This key is only used by \cs{glsaddall}:
 %    \begin{macrocode}
 \define@key{glossadd}{types}{\def\@glo@type{#1}}
 %    \end{macrocode}
 %\vskip5pt
-%\DescribeMacro{\glsadd}
-%\cmdname{glsadd}\oarg{options}\marg{label}\\[10pt]
+%\cs{glsadd}\oarg{options}\marg{label}\\[10pt]
 % Add a term to the glossary without generating any link text. 
 % The optional argument indicates which counter to use, 
 % and how to format it (using a key-value list)
 % the second argument is the entry label. Note that \meta{options}
 % only has two keys: \gloskey[glsadd]{counter} and \gloskey[glsadd]{format} (the \gloskey[glsaddall]{types} key will be ignored).
+%\begin{macro}{\glsadd}
 %    \begin{macrocode}
 \newcommand*{\glsadd}[2][]{%
 \glsdoifexists{#2}{%
@@ -2835,12 +3059,13 @@ counter as its value}}{%
 \@glo@numfmt}%
 }}
 %    \end{macrocode}
+%\end{macro}
 %\vskip5pt
-%\DescribeMacro{\glsaddall}
-%\cmdname{glsaddall}\oarg{glossary list}\\[10pt]
+%\cs{glsaddall}\oarg{glossary list}\\[10pt]
 % Add all terms defined for the listed glossaries (without displaying
 % any text.) If \gloskey[glsaddall]{types} key is omitted, apply to all
 % glossary types.
+%\begin{macro}{\glsaddall}
 %    \begin{macrocode}
 \newcommand*{\glsaddall}[1][]{%
 \def\@glo@type{\@glo@types}%
@@ -2849,10 +3074,10 @@ counter as its value}}{%
 \glsadd[#1]{\@glo@entry}}%
 }
 %    \end{macrocode}
+%\end{macro}
 %
 %\subsection{Creating associated files}
-%\DescribeMacro{\writeist}
-% The \cmdname{writeist} command creates the associated 
+% The \cs{writeist} command creates the associated 
 % customized \filetype{ist} \appname{makeindex} style file.
 % While defining this command, some characters have their 
 % catcodes temporarily changed to ensure they get written to 
@@ -2860,9 +3085,9 @@ counter as its value}}{%
 % actual character (usually "@") is redefined to be a "?", to allow 
 % internal commands to be written to the glossary file output file.
 %
-% The special characters\mkidxspch\ are stored in \cmdname{@gls@actualchar},
-% \cmdname{@gls@encapchar}, \cmdname{@glsl@levelchar} and
-% \cmdname{@gls@quotechar} to make them easier to use later,
+% The special characters\mkidxspch\ are stored in \cs{@gls@actualchar},
+% \cs{@gls@encapchar}, \cs{@glsl@levelchar} and
+% \cs{@gls@quotechar} to make them easier to use later,
 % but don't change these values, because the characters are
 % encoded in the command definitions that are used to escape
 % the special characters (which means that the user no longer
@@ -2883,6 +3108,7 @@ counter as its value}}{%
 % the lines. If you want to see the code in full, have a look at
 % \texttt{glossaries.sty}.
 %\changes{1.01}{2007 May 17}{Added spaces after 'delimN and 'delimR in ist file}%
+%\begin{macro}{\writeist}
 %    \begin{macrocode}
 \newwrite\istfile
 \bgroup
@@ -2922,20 +3148,21 @@ counter as its value}}{%
 \noist}
 \egroup
 %    \end{macrocode}
+%\end{macro}
 %
-%\DescribeMacro{\noist}
-%The command \cmdname{noist} will suppress the creation of
+%The command \cs{noist} will suppress the creation of
 % the \filetype{ist} file (it simply redefines 
-% \cmdname{writeist} to do nothing.) Obviously you need to use this
-% command before \cmdname{writeist} to have any effect. Since
-% the \filetype{ist} file should only be created once, \cmdname{noist}
-% is called at the end of \cmdname{writeist}.
+% \cs{writeist} to do nothing.) Obviously you need to use this
+% command before \cs{writeist} to have any effect. Since
+% the \filetype{ist} file should only be created once, \cs{noist}
+% is called at the end of \cs{writeist}.
+%\begin{macro}{\noist}
 %    \begin{macrocode}
 \newcommand{\noist}{\let\writeist\relax}
 %    \end{macrocode}
+%\end{macro}
 %
-%\DescribeMacro{\@makeglossary}
-% \cmdname{@makeglossary} is an internal command that takes an 
+% \cs{@makeglossary} is an internal command that takes an 
 % argument indicating the glossary type. This command will 
 % create the glossary file required by \appname{makeindex} for the
 % given glossary type, using the extension supplied by the
@@ -2944,12 +3171,13 @@ counter as its value}}{%
 % and create the customized \filetype{ist} \appname{makeindex} 
 % style file.) 
 %
-% Note that you can't use \cmdname{@makeglossary} for only some of the
-% defined glossaries. You either need to have a \cmdname{makeglossary}
+% Note that you can't use \cs{@makeglossary} for only some of the
+% defined glossaries. You either need to have a \cs{makeglossary}
 % for all glossaries or none (otherwise you will end up with a
 % situation where \TeX\ is trying to write to a non-existant
 % file.) The relevant glossary must be
-% defined prior to using \cmdname{@makeglossary}.
+% defined prior to using \cs{@makeglossary}.
+%\begin{macro}{\@makeglossary}
 %    \begin{macrocode}
 \newcommand*{\@makeglossary}[1]{%
 \ifglossaryexists{#1}{%
@@ -2964,13 +3192,14 @@ counter as its value}}{%
 Glossary type `#1' not defined}{New glossaries must be defined before
 using \string\makeglossary}}}
 %    \end{macrocode}
+%\end{macro}
 %
-%\DescribeMacro{\makeglossaries}
-% \cmdname{makeglossaries} will use \cmdname{@makeglossary}
+% \cs{makeglossaries} will use \cs{@makeglossary}
 % for each glossary type that has been defined.  New glossaries
-% need to be defined before using \cmdname{makeglossary}, so
-% have \cmdname{makeglossaries} redefine \cmdname{newglossary}
+% need to be defined before using \cs{makeglossary}, so
+% have \cs{makeglossaries} redefine \cs{newglossary}
 % to prevent it being used afterwards.
+%\begin{macro}{\makeglossaries}
 %    \begin{macrocode}
 \newcommand*{\makeglossaries}{%
 \@for\@glo@type:=\@glo@types\do{%
@@ -2984,66 +3213,72 @@ to move \string\makeglossaries\space after all your
 \let\@makeglossary\empty
 \let\makeglossary\empty}
 %    \end{macrocode}
+%\end{macro}
 %
-%\DescribeMacro{\makeglossary}
-% The \cmdname{makeglossary} command is redefined to be
-% identical to \cmdname{makeglossaries}. (This is done to 
+% The \cs{makeglossary} command is redefined to be
+% identical to \cs{makeglossaries}. (This is done to 
 % reinforce the message that you must either use 
-% \cmdname{@makeglossary} for all the glossaries or for none 
+% \cs{@makeglossary} for all the glossaries or for none 
 % of them.)
+%\begin{macro}{\makeglossary}
 %    \begin{macrocode}
 \let\makeglossary\makeglossaries
 %    \end{macrocode}
+%\end{macro}
 %
 %\subsection{Writing information to associated files}
-%\DescribeMacro{\glossary}
-% The \cmdname{glossary} command is redefined so that it takes an 
+% The \cs{glossary} command is redefined so that it takes an 
 % optional argument \meta{type} to specify the glossary type (use 
-% \cmdname{glsdefaulttype} glossary by default). 
+% \cs{glsdefaulttype} glossary by default). 
 % This shouldn't be used at user level
-% as \cmdname{glslink} sets the correct format. The associated 
-% number should be stored in \cmdname{theglsentrycounter}
-% before using \cmdname{glossary}.
+% as \cs{glslink} sets the correct format. The associated 
+% number should be stored in \cs{theglsentrycounter}
+% before using \cs{glossary}.
+%\begin{macro}{\glossary}
 %    \begin{macrocode}
 \renewcommand*{\glossary}[1][\glsdefaulttype]{%
 \@glossary[#1]}
 %    \end{macrocode}
+%\end{macro}
 %
-%\DescribeMacro{\@glossary}
-% Define internal \cmdname{@glossary} to ignore its argument.
-% This gets redefined in \cmdname{@makeglossary}.
+% Define internal \cs{@glossary} to ignore its argument.
+% This gets redefined in \cs{@makeglossary}.
+%\begin{macro}{\@glossary}
 %    \begin{macrocode}
 \def\@glossary[#1]{\@bsphack\begingroup\@sanitize\@index}
 %    \end{macrocode}
-%\DescribeMacro{@gls@renewglossary}
-% This is a convenience command to set \cmdname{@glossary}.
-% It is used by \cmdname{@makeglossary} and then redefined to
+%\end{macro}
+% This is a convenience command to set \cs{@glossary}.
+% It is used by \cs{@makeglossary} and then redefined to
 % do nothing, as it only needs to be done once.
+%\begin{macro}{@gls@renewglossary}
 %    \begin{macrocode}
 \newcommand{\@gls@renewglossary}{%
 \gdef\@glossary[##1]{\@bsphack\begingroup\@wrglossary{##1}}%
 \let\@gls@renewglossary\@empty
 }
 %    \end{macrocode}
-%\DescribeMacro{\@wrglossary}
-% The \cmdname{@wrglossary} command is redefined to have
+%\end{macro}
+% The \cs{@wrglossary} command is redefined to have
 % two arguments. The first argument is the glossary type, 
 % the second argument is the glossary entry 
-% (the format of which is set in \cmdname{glslink}.)
+% (the format of which is set in \cs{glslink}.)
+%\begin{macro}{\@wrglossary}
 %    \begin{macrocode}
 \renewcommand*{\@wrglossary}[2]{%
 \expandafter\protected@write\csname glo@#1@file\endcsname{}{%
 \string\glossaryentry{#2}{\theglsentrycounter}}\endgroup\@esphack}
 %    \end{macrocode}
+%\end{macro}
 %
 % \subsection{Displaying the glossary}\label{sec:printglos}
-%\DescribeMacro{\printglossary}
 % An individual glossary is displayed in the text using
-% \cmdname{printglossary}\oarg{key-val list}. If the 
+% \cs{printglossary}\oarg{key-val list}. If the 
 % \gloskey[printglossary]{type} key is omitted, the default glossary is displayed.
 % The optional argument can be used to specify an alternative
 % glossary, and can also be used to set the style, title and
 % entry in the table of contents. Available keys are defined below.
+%\begin{macro}{\printglossary}
 %    \begin{macrocode}
 \newcommand*{\printglossary}[1][type=\glsdefaulttype]{%
 \def\@glo@type{\glsdefaulttype}%
@@ -3058,23 +3293,25 @@ to move \string\makeglossaries\space after all your
 \egroup
 }
 %    \end{macrocode}
+%\end{macro}
 %
-%\DescribeMacro{\printglossaries}
-% This command will do \cmdname{printglossary}
+% The \cs{printglossaries} command will do \cs{printglossary}
 % for each glossary type that has been defined. It is better
-% to use \cmdname{printglossaries} rather than individual
-% \cmdname{printglossary} commands to ensure that you don't forget
+% to use \cs{printglossaries} rather than individual
+% \cs{printglossary} commands to ensure that you don't forget
 % any new glossaries you may have created. It also makes it easier to
 % chop and change the value of the \pkgopt{acronym} package option.
 % However, if you want to list the glossaries in a different order,
 % or if you want to set the title or table of contents entry, or
 % if you want to use different glossary styles for each glossary, you
-% will need to use \cmdname{printglossary} explicitly for each
+% will need to use \cs{printglossary} explicitly for each
 % glossary type.
+%\begin{macro}{\printglossaries}
 %    \begin{macrocode}
 \newcommand*{\printglossaries}{%
 \forallglossaries{\@@glo@type}{\printglossary[type=\@@glo@type]}}
 %    \end{macrocode}
+%\end{macro}
 % The keys that can be used in the optional argument to
 % \icmdname{printglossary} are as follows:
 % The \gloskey[printglossary]{type} key sets the glossary type.
@@ -3111,55 +3348,59 @@ style `#1' undefined}{}}{%
 \renewenvironment{theglossary}{}{}}
 %    \end{macrocode}
 %
-%\DescribeMacro{\glossaryheader}
-% The glossary header is given by \cmdname{glossaryheader}. 
+% The glossary header is given by \cs{glossaryheader}. 
 % This forms part of the glossary style, and
 % must indicate what should appear immediately after the start of the
 % \envname{theglossary} environment. (For example, if the glossary
 % uses a tabular-like environment, it may be used to set the
 % header row.) Note that if you don't want a header row, the glossary
-% style must redefine \cmdname{glossaryheader} to do nothing.
+% style must redefine \cs{glossaryheader} to do nothing.
+%\begin{macro}{\glossaryheader}
 %    \begin{macrocode}
 \newcommand*{\glossaryheader}{}
 %    \end{macrocode}
+%\end{macro}
 %\vskip5pt
-%\DescribeMacro{\glossaryentryfield}
-% \cmdname{glossaryentryfield}\marg{label}\marg{name}\marg{description}\marg{symbol}\marg{page-list}\\[10pt]
+% \cs{glossaryentryfield}\marg{label}\marg{name}\marg{description}\marg{symbol}\marg{page-list}\\[10pt]
 % This command governs how each entry row should be formatted 
 % in the glossary. Glossary styles need to redefine this command.
 % Most of the predefined styles ignore \meta{symbol}.
+%\begin{macro}{\glossaryentryfield}
 %    \begin{macrocode}
 \newcommand*{\glossaryentryfield}[5]{%
 \@glstarget{glo:#1}{#2} #4 #3. #5\par}
 %    \end{macrocode}
+%\end{macro}
 %
-%\DescribeMacro{\glsgroupskip}
 % Within each glossary, the entries form 28 distinct groups
 % which are determined by the first character of the \gloskey{sort} 
 % key. There will be a maximum of 28 groups: symbols, numbers,
 % and the 26 alphabetical groups A, \ldots, Z\@. 
-% The command \cmdname{glsgroupskip} 
+% The command \cs{glsgroupskip} 
 % specifies what to do between glossary groups. Glossary styles
-% must redefine this command. (Note that \cmdname{glsgroupskip}
+% must redefine this command. (Note that \cs{glsgroupskip}
 % only occurs between groups, not at the start or end of the
 % glossary.)
+%\begin{macro}{\glsgroupskip}
 %    \begin{macrocode}
 \newcommand*{\glsgroupskip}{}
 %    \end{macrocode}
+%\end{macro}
 %
-%\DescribeMacro{\glsgroupheading}
 % Each of the 28 glossary groups described above is preceded by a 
 % group heading.
-% This is formatted by the command \cmdname{glsgroupheading}
+% This is formatted by the command \cs{glsgroupheading}
 % which takes one argument which is the \emph{label} assigned to that
 % group (not the title). The corresponding labels are: \texttt{glssymbols},
 % \texttt{glsnumbers}, \texttt{A}, \ldots, \texttt{Z}. 
 % Glossary styles must redefined this command. (In between groups,
-% \cmdname{glsgroupheading} comes immediately after \cmdname{glsgroupskip}.)
+% \cs{glsgroupheading} comes immediately after \cs{glsgroupskip}.)
+%\begin{macro}{\glsgroupheading}
 %    \begin{macrocode}
 \newcommand*{\glsgroupheading}[1]{}
 %    \end{macrocode}
-% It is therefore possible to ``trick'' \appname{makeindex} into
+%\end{macro}
+% It is possible to ``trick'' \appname{makeindex} into
 % treating entries as though they belong to the same group, 
 % even if the terms don't start with the same letter, by
 % modifying the \gloskey{sort} key. For example, all entries 
@@ -3168,12 +3409,11 @@ style `#1' undefined}{}}{%
 % "a", while entries belonging to another group could be defined
 % so that the \gloskey{sort} key starts with a "b", and so on. If
 % you want each group to have a heading, you would then need to
-% modify the translation control sequences \cmdname{glsgetgrouptitle}
-% and \cmdname{glsgetgrouplabel} so that the label is translated
+% modify the translation control sequences \cs{glsgetgrouptitle}
+% and \cs{glsgetgrouplabel} so that the label is translated
 % into the required title (and vice-versa.)
 %\\[10pt]
-%\DescribeMacro{\glsgetgrouptitle}
-%\cmdname{glsgetgrouptitle}\marg{label}\\[10pt]
+%\cs{glsgetgrouptitle}\marg{label}\\[10pt]
 % This command produces the title for the glossary group
 % whose label is given by \meta{label}. By default, the group
 % labelled \texttt{glssymbols} produces 
@@ -3183,47 +3423,51 @@ style `#1' undefined}{}}{%
 % As mentioned above, the group labels are: \texttt{glssymbols}, \texttt{glsnumbers},
 % \texttt{A}, \ldots, \texttt{Z}\@. If you want to redefine
 % the group titles, you will need to redefine this command.
+%\begin{macro}{\glsgetgrouptitle}
 %    \begin{macrocode}
 \newcommand*{\glsgetgrouptitle}[1]{%
 \@ifundefined{#1groupname}{#1}{\csname #1groupname\endcsname}}
 %    \end{macrocode}
+%\end{macro}
 %\vskip5pt
-%\DescribeMacro{\glsgetgrouplabel}
-%\cmdname{glsgetgrouplabel}\marg{title}\\[10pt]
+%\cs{glsgetgrouplabel}\marg{title}\\[10pt]
 %This command does the reverse to the previous command. The
 % argument is the group title, and it produces the group label.
-% Note that if you redefine \cmdname{glsgetgrouptitle}, you
-% will also need to redefine \cmdname{glsgetgrouplabel}.
+% Note that if you redefine \cs{glsgetgrouptitle}, you
+% will also need to redefine \cs{glsgetgrouplabel}.
+%\begin{macro}{\glsgetgrouplabel}
 %    \begin{macrocode}
 \newcommand*{\glsgetgrouplabel}[1]{%
 \ifthenelse{\equals{#1}{\glssymbolsgroupname}}{glssymbols}{%
 \ifthenelse{\equals{#1}{\glsnumbersgroupname}}{glsnumbers}{#1}}}
 %    \end{macrocode}
+%\end{macro}
 %
-%\DescribeMacro{\setentrycounter}
-% The command \cmdname{setentrycounter} sets the entry's 
+% The command \cs{setentrycounter} sets the entry's 
 % associated counter (required by 
-% \cmdname{glshypernumber} etc.) \icmdname{glslink} and
+% \cs{glshypernumber} etc.) \icmdname{glslink} and
 % \icmdname{glsadd} encode the
 % \icmdname{glossary} argument so that the relevant counter is
 % set prior to the formatting command.
+%\begin{macro}{\setentrycounter}
 %    \begin{macrocode}
 \newcommand*{\setentrycounter}[1]{\def\glsentrycounter{#1}}
 %    \end{macrocode}
+%\end{macro}
 %
-%\DescribeMacro{\glossarystyle}
 % The current glossary style can be set using
-% \cmdname{glossarystyle}\marg{style}.
+% \cs{glossarystyle}\marg{style}.
+%\begin{macro}{\glossarystyle}
 %    \begin{macrocode}
 \newcommand*{\glossarystyle}[1]{%
 \@ifundefined{@glsstyle@#1}{\PackageError{glossaries}{Glossary 
 style `#1' undefined}{}}{%
 \csname @glsstyle@#1\endcsname}}
 %    \end{macrocode}
+%\end{macro}
 %
-%\DescribeMacro{\newglossarystyle}
 % New glossary styles can be defined using:\\[10pt]
-% \cmdname{newglossarystyle}\marg{name}\marg{definition}\\[10pt]
+% \cs{newglossarystyle}\marg{name}\marg{definition}\\[10pt]
 % The \meta{definition} argument should redefine 
 % \envname{theglossary}, \icmdname{glossaryheader}, 
 % \icmdname{glsgroupheading}, \icmdname{glossaryentryfield} and
@@ -3233,32 +3477,34 @@ style `#1' undefined}{}}{%
 % \icmdname{glossarypostamble}, as
 % the user should be able to switch between styles without affecting
 % the pre- and postambles.
+%\begin{macro}{\newglossarystyle}
 %    \begin{macrocode}
 \newcommand*{\newglossarystyle}[2]{%
 \@ifundefined{@glsstyle@#1}{%
 \expandafter\def\csname @glsstyle@#1\endcsname{#2}}{%
 \PackageError{glossaries}{Glossary style `#1' is already defined}{}}}
 %    \end{macrocode}
+%\end{macro}
 %
-%\DescribeMacro{\glsnamefont}
 % Glossary entries are encoded so that the second argument
 % to \icmdname{glossaryentryfield} is always specified as
-% \cmdname{glsnamefont}\marg{name}. This allows the
+% \cs{glsnamefont}\marg{name}. This allows the
 % user to change the font used to display the name term
 % without having to redefine \icmdname{glossaryentryfield}.
 % The default uses the surrounding font, so in the list type
 % styles (which place the name in the optional argument to
 % \icmdname{item}) the name will appear in bold.
+%\begin{macro}{\glsnamefont}
 %    \begin{macrocode}
 \newcommand*{\glsnamefont}[1]{#1}
 %    \end{macrocode}
+%\end{macro}
 %
-%\DescribeMacro{\glshypernumber}
 % Each glossary entry has an associated number list (usually page
 % numbers) that indicate where in the document the entry has been
 % used. The format for these number lists can be changed using the
 % \gloskey[glslink]{format}\igloskey[glsadd]{format} key in commands like \icmdname{glslink}.
-% The default format is given by \cmdname{glshypernumber}. This takes
+% The default format is given by \cs{glshypernumber}. This takes
 % a single argument which may be a single number, a number range
 % or a number list. The number ranges are delimited with 
 % \icmdname{delimR}, the number lists are delimited with 
@@ -3273,17 +3519,19 @@ style `#1' undefined}{}}{%
 % dash delimiters and only for the page counter, but this code needs
 % to be more general. So I have adapted the code used in the
 % \styname{hyperref} package.
+%\begin{macro}{\glshypernumber}
 %    \begin{macrocode}
 \@ifundefined{hyperlink}{%
 \def\glshypernumber#1{#1}}{%
 \def\glshypernumber#1{%
 \@delimR#1\delimR\delimR\\}}
 %    \end{macrocode}
-%\DescribeMacro{@delimR}
-% \cmdname{@delimR} displays a range of numbers for the counter 
+%\end{macro}
+% \cs{@delimR} displays a range of numbers for the counter 
 % whose name is given by 
-% \cmdname{@gls@counter} (which must be set prior to using
-% \cmdname{glshypernumber}.)
+% \cs{@gls@counter} (which must be set prior to using
+% \cs{glshypernumber}.)
+%\begin{macro}{\@delimR}
 %    \begin{macrocode}
 \def\@delimR#1\delimR #2\delimR #3\\{%
 \ifx\\#2\\%
@@ -3292,9 +3540,10 @@ style `#1' undefined}{}}{%
   \@gls@numberlink{#1}\delimR\@gls@numberlink{#2}%
 \fi}
 %    \end{macrocode}
-%\DescribeMacro{\@delimN}
-% \cmdname{@delimN} displays a list of individual numbers, 
+%\end{macro}
+% \cs{@delimN} displays a list of individual numbers, 
 % instead of a range:
+%\begin{macro}{\@delimN}
 %    \begin{macrocode}
 \def\@delimN#1{\@@delimN#1\delimN \delimN\\}
 \def\@@delimN#1\delimN #2\delimN#3\\{%
@@ -3305,10 +3554,11 @@ style `#1' undefined}{}}{%
 \fi
 }
 %    \end{macrocode}
+%\end{macro}
 % The following code is modified from hyperref's 
-% \cmdname{HyInd@pagelink} where
+% \cs{HyInd@pagelink} where
 % the name of the counter being used is given by 
-% \cmdname{@gls@counter}.
+% \cs{@gls@counter}.
 %    \begin{macrocode}
 \def\@gls@numberlink#1{%
 \begingroup
@@ -3338,46 +3588,56 @@ style `#1' undefined}{}}{%
 % appropriate font, and create a hyperlink, if hyperlinks are
 % supported. If hyperlinks are not supported, they will just
 % display their argument in the appropriate font.
-%\DescribeMacro{\hyperrm}
+%\begin{macro}{\hyperrm}
 %    \begin{macrocode}
 \newcommand*{\hyperrm}[1]{\textrm{\glshypernumber{#1}}}
 %    \end{macrocode}
-%\DescribeMacro{\hypersf}
+%\end{macro}
+%\begin{macro}{\hypersf}
 %    \begin{macrocode}
 \newcommand*{\hypersf}[1]{\textsf{\glshypernumber{#1}}}
 %    \end{macrocode}
-%\DescribeMacro{\hypertt}
+%\end{macro}
+%\begin{macro}{\hypertt}
 %    \begin{macrocode}
 \newcommand*{\hypertt}[1]{\texttt{\glshypernumber{#1}}}
 %    \end{macrocode}
-%\DescribeMacro{\hyperbf}
+%\end{macro}
+%\begin{macro}{\hyperbf}
 %    \begin{macrocode}
 \newcommand*{\hyperbf}[1]{\textbf{\glshypernumber{#1}}}
 %    \end{macrocode}
-%\DescribeMacro{\hypermd}
+%\end{macro}
+%\begin{macro}{\hypermd}
 %    \begin{macrocode}
 \newcommand*{\hypermd}[1]{\textmd{\glshypernumber{#1}}}
 %    \end{macrocode}
-%\DescribeMacro{\hyperit}
+%\end{macro}
+%\begin{macro}{\hyperit}
 %    \begin{macrocode}
 \newcommand*{\hyperit}[1]{\textit{\glshypernumber{#1}}}
 %    \end{macrocode}
-%\DescribeMacro{\hypersl}
+%\end{macro}
+%\begin{macro}{\hypersl}
 %    \begin{macrocode}
 \newcommand*{\hypersl}[1]{\textsl{\glshypernumber{#1}}}
 %    \end{macrocode}
-%\DescribeMacro{\hyperup}
+%\end{macro}
+%\begin{macro}{\hyperup}
 %    \begin{macrocode}
 \newcommand*{\hyperup}[1]{\textup{\glshypernumber{#1}}}
 %    \end{macrocode}
-%\DescribeMacro{\hypersc}
+%\end{macro}
+%\begin{macro}{\hypersc}
 %    \begin{macrocode}
 \newcommand*{\hypersc}[1]{\textsc{\glshypernumber{#1}}}
 %    \end{macrocode}
-%\DescribeMacro{\hyperemph}
+%\end{macro}
+%\begin{macro}{\hyperemph}
 %    \begin{macrocode}
 \newcommand*{\hyperemph}[1]{\emph{\glshypernumber{#1}}}
 %    \end{macrocode}
+%\end{macro}
 %
 %\subsection{Acronyms}\label{sec:acronym}
 %If the \pkgopt{acronym} package option is used, a 
@@ -3401,26 +3661,27 @@ style `#1' undefined}{}}{%
 \fi
 %    \end{macrocode}
 %\vskip5pt
-%\DescribeMacro{\newacronym}
-% \cmdname{newacronym}\oarg{key-val list}\marg{label}\marg{abbrev}\marg{long}\\[10pt]
+% \cs{newacronym}\oarg{key-val list}\marg{label}\marg{abbrev}\marg{long}\\[10pt]
 % This is a quick way of defining acronyms, all it does
 % is call \icmdname{newglossaryentry} with the appropriate
 % values. It sets the
 % glossary type to \icmdname{acronymtype} which will be
 % "acronym" if the package option \pkgopt{acronym} has
 % been used, otherwise it will be the default glossary.
-% Since \cmdname{newacronym} merely calls \icmdname{newglossaryentry},
+% Since \cs{newacronym} merely calls \icmdname{newglossaryentry},
 % the acronym is treated like any other glossary entry.
 %
 % If you prefer a different format, you
-% can redefine \cmdname{newacronym} as required. The optional 
+% can redefine \cs{newacronym} as required. The optional 
 % argument can be used to override any of the settings.
+%\begin{macro}{\newacronym}
 %    \begin{macrocode}
 \newcommand{\newacronym}[4][]{%
-\newglossaryentry{#2}{type=\acronymtype,
-name={#3},description={#4},text={#3},
+\newglossaryentry{#2}{type=\acronymtype,%
+name={#3},description={#4},text={#3},%
 first={#4 (#3)},plural={#3s},firstplural={#4s (#3s)},#1}}
 %    \end{macrocode}
+%\end{macro}
 % New acronyms can only be defined in the preamble:
 %    \begin{macrocode}
 \@onlypreamble{\newacronym}
@@ -3453,22 +3714,22 @@ first={#4 (#3)},plural={#3s},firstplural={#4s (#3s)},#1}}
 % \subsubsection{Glossary hyper-navigation definitions (glossary-hypernav package)}
 % Package Definition:
 %    \begin{macrocode}
-\ProvidesPackage{glossary-hypernav}[2007/05/16 v1.0 (NLCT)]
+\ProvidesPackage{glossary-hypernav}[2007/07/04 v1.01 (NLCT)]
 %    \end{macrocode}
 %
 % The commands defined in this package are provided to 
 % help navigate around the groups within a glossary 
 % (see \autoref{sec:printglos}.)
 % \icmdname{printglossary} (and \icmdname{printglossaries})
-% set \cmdname{@glo@type} to the label of the current
+% set \cs{@glo@type} to the label of the current
 % glossary. This is used to create a unique hypertarget in
 % the event of multiple glossaries.
 %\\[10pt]
-%\DescribeMacro{\glsnavhyperlink}
-% \cmdname{glsnavhyperlink}\oarg{type}\marg{label}\marg{text}\\[10pt]
+% \cs{glsnavhyperlink}\oarg{type}\marg{label}\marg{text}\\[10pt]
 % This command makes \meta{text} a hyperlink to the glossary group
 % whose label is given by \meta{label} for the glossary given
 % by \meta{type}.
+%\begin{macro}{\glsnavhyperlink}
 %    \begin{macrocode}
 \@ifundefined{hyperlink}{%
 \newcommand*{\glsnavhyperlink}[3][]{#3}}{%
@@ -3476,21 +3737,22 @@ first={#4 (#3)},plural={#3s},firstplural={#4s (#3s)},#1}}
 \edef\gls@grplabel{#2}\edef\@gls@grptitle{#3}%
 \hyperlink{glsn:#1@#2}{#3}}}
 %    \end{macrocode}
+%\end{macro}
 %\vskip5pt
-%\DescribeMacro{\glsnavhypertarget}
-% \cmdname{glsnavhypertarget}\oarg{type}\marg{label}\marg{text}\\[10pt]
+% \cs{glsnavhypertarget}\oarg{type}\marg{label}\marg{text}\\[10pt]
 % This command makes \meta{text} a hypertarget for the glossary group
 % whose label is given by \meta{label} in the glossary given
 % by \meta{type}.
+%\begin{macro}{\glsnavhypertarget}
 %    \begin{macrocode}
 \@ifundefined{hypertarget}{%
 \newcommand*{\glsnavhypertarget}[3][]{#3}}{%
 \newcommand*{\glsnavhypertarget}[3][\@glo@type]{%
 \hypertarget{glsn:#1@#2}{#3}}}
 %    \end{macrocode}
+%\end{macro}
 %
-%\DescribeMacro{\glsnavigation}
-% The \cmdname{glsnavigation} command displays a simple glossary 
+% The \cs{glsnavigation} command displays a simple glossary 
 % group navigation. 
 % The symbol and number elements are defined separately, 
 % so that they can be suppressed if need be. Note that this 
@@ -3498,6 +3760,7 @@ first={#4 (#3)},plural={#3s},firstplural={#4s (#3s)},#1}}
 % may not be defined if there are groups that do not contain any
 % terms, in which case you will get an undefined hyperlink warning.
 % Now for the whole navigation bit:
+%\begin{macro}{\glsnavigation}
 %    \begin{macrocode}
 \newcommand*{\glsnavigation}{%
 \glssymbolnav
@@ -3528,18 +3791,20 @@ first={#4 (#3)},plural={#3s},firstplural={#4s (#3s)},#1}}
 \glsnavhyperlink{Y}{\glsgetgrouptitle{Y}} \textbar\
 \glsnavhyperlink{Z}{\glsgetgrouptitle{Z}}}
 %    \end{macrocode}
-%\DescribeMacro{\glssymbolnav}
-% The \cmdname{glssymbolnav} produces a simple navigation set of
+%\end{macro}
+% The \cs{glssymbolnav} produces a simple navigation set of
 % links for just the symbol and number groups. This is used at
-% the start of \cmdname{glsnavigation}. If your glossary doesn't
+% the start of \cs{glsnavigation}. If your glossary doesn't
 % contain any symbol or navigation groups, you can redefine this
 % command to do nothing.
+%\begin{macro}{\glssymbolnav}
 %    \begin{macrocode}
 \newcommand*{\glssymbolnav}{%
 \glsnavhyperlink{glssymbols}{\glsgetgrouptitle{glssymbols}} \textbar\
 \glsnavhyperlink{glsnumbers}{\glsgetgrouptitle{glsnumbers}} \textbar\ 
 }
 %    \end{macrocode}
+%\end{macro}
 %\iffalse
 %    \begin{macrocode}
 %</glossary-hypernav.sty>
@@ -3557,11 +3822,11 @@ first={#4 (#3)},plural={#3s},firstplural={#4s (#3s)},#1}}
 % \icmdname{item} command, it will appear in a bold font by
 % default.
 %    \begin{macrocode}
-\ProvidesPackage{glossary-list}[2007/05/16 v1.0 (NLCT)]
+\ProvidesPackage{glossary-list}[2007/07/04 v1.01 (NLCT)]
 %    \end{macrocode}
 % The \glostyle{list} glossary style 
 % uses the \envname{description} environment. The group separator
-% \icmdname{glsgroupskip} is redefined as \cmdname{indexspace}
+% \icmdname{glsgroupskip} is redefined as \cs{indexspace}
 % which produces a gap between groups. The glossary heading
 % and the group headings do nothing. This is used as the default
 % style for the \styname{glossaries} package.
@@ -3571,7 +3836,7 @@ first={#4 (#3)},plural={#3s},firstplural={#4s (#3s)},#1}}
 \renewcommand*{\glossaryheader}{}%
 \renewcommand*{\glsgroupheading}[1]{}%
 \renewcommand*{\glossaryentryfield}[5]{%
-\item[\@glstarget{glo:##1}{##2}] ##3. ##5}%
+\item[\@glstarget{glo:##1}{##2}] ##3\glspostdescription\space ##5}%
 \renewcommand*{\glsgroupskip}{\indexspace}}
 %    \end{macrocode}
 % The \glostyle{listgroup} style is like the \glostyle{list}
@@ -3598,7 +3863,7 @@ first={#4 (#3)},plural={#3s},firstplural={#4s (#3s)},#1}}
 \newglossarystyle{altlist}{%
 \glossarystyle{list}%
 \renewcommand*{\glossaryentryfield}[5]{%
-\item[\@glstarget{glo:##1}{##2}]\mbox{}\newline ##3. ##5}%
+\item[\@glstarget{glo:##1}{##2}]\mbox{}\newline ##3\glspostdescription\space ##5}%
 }
 %    \end{macrocode}
 % The \glostyle{altlistgroup} glossary style is like the
@@ -3634,22 +3899,24 @@ first={#4 (#3)},plural={#3s},firstplural={#4s (#3s)},#1}}
 % The glossary styles defined in the \styname{glossary-long} package
 % used the \envname{longtable} environment in the glossary.
 %    \begin{macrocode}
-\ProvidesPackage{glossary-long}[2007/05/16 v1.0 (NLCT)]
+\ProvidesPackage{glossary-long}[2007/07/04 v1.01 (NLCT)]
 %    \end{macrocode}
 % Requires the \styname{longtable} package:
 %    \begin{macrocode}
 \RequirePackage{longtable}
 %    \end{macrocode}
-%\DescribeMacro{\glsdescwidth}
 % This is a length that governs the width of the description column.
+%\begin{macro}{\glsdescwidth}
 %    \begin{macrocode}
 \newlength\glsdescwidth
 %    \end{macrocode}
-%\DescribeMacro{\glspagelistwidth}
+%\end{macro}
 % This is a length that governs the width of the page list column.
+%\begin{macro}{\glspagelistwidth}
 %    \begin{macrocode}
 \newlength\glspagelistwidth
 %    \end{macrocode}
+%\end{macro}
 % Default values:
 %    \begin{macrocode}
 \setlength{\glsdescwidth}{0.6\linewidth}
@@ -3665,7 +3932,7 @@ first={#4 (#3)},plural={#3s},firstplural={#4s (#3s)},#1}}
 \renewcommand*{\glossaryheader}{}%
 \renewcommand*{\glsgroupheading}[1]{}%
 \renewcommand*{\glossaryentryfield}[5]{%
-\@glstarget{glo:##1}{##2} & ##3. ##5\\}%
+\@glstarget{glo:##1}{##2} & ##3\glspostdescription\space ##5\\}%
 \renewcommand*{\glsgroupskip}{ & \\}}
 %    \end{macrocode}
 % The \glostyle{longborder} style is like the above, but with horizontal and
@@ -3798,7 +4065,7 @@ first={#4 (#3)},plural={#3s},firstplural={#4s (#3s)},#1}}
 % The glossary styles defined in the \styname{glossary-super} package
 % use the \envname{supertabular} environment.
 %    \begin{macrocode}
-\ProvidesPackage{glossary-super}[2007/05/16 v1.0 (NLCT)]
+\ProvidesPackage{glossary-super}[2007/07/04 v1.01 (NLCT)]
 %    \end{macrocode}
 % Requires the \styname{supertabular} package:
 %    \begin{macrocode}
@@ -3816,7 +4083,7 @@ first={#4 (#3)},plural={#3s},firstplural={#4s (#3s)},#1}}
 \renewcommand*{\glossaryheader}{}%
 \renewcommand*{\glsgroupheading}[1]{}%
 \renewcommand*{\glossaryentryfield}[5]{%
-\@glstarget{glo:##1}{##2} & ##3. ##5\\}%
+\@glstarget{glo:##1}{##2} & ##3\glspostdescription\space ##5\\}%
 \renewcommand*{\glsgroupskip}{ & \\}}
 %    \end{macrocode}
 % The \glostyle{superborder} style is like the above, but with horizontal and
diff --git a/Master/texmf-dist/source/latex/glossaries/glossaries.ins b/Master/texmf-dist/source/latex/glossaries/glossaries.ins
index 8130433bd88..1fc606b961b 100644
--- a/Master/texmf-dist/source/latex/glossaries/glossaries.ins
+++ b/Master/texmf-dist/source/latex/glossaries/glossaries.ins
@@ -1,4 +1,4 @@
-% glossaries.ins generated using makedtx version 0.91b 2007/5/25 16:12
+% glossaries.ins generated using makedtx version 0.93b 2007/8/3 17:26
 \input docstrip
 
 \preamble