summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/glossaries-extra/glossaries-extra-manual.tex
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2016-04-27 22:55:41 +0000
committerKarl Berry <karl@freefriends.org>2016-04-27 22:55:41 +0000
commit48b3038496bf03bf75673179dae38809fb3d8caf (patch)
tree40ef29349a58c3230fa67d91b7e314be47f3fd51 /Master/texmf-dist/doc/latex/glossaries-extra/glossaries-extra-manual.tex
parent221b1ab40f24236ec05478092e845aeea69ac75c (diff)
glossaries-extra (27apr16)
git-svn-id: svn://tug.org/texlive/trunk@40791 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/glossaries-extra/glossaries-extra-manual.tex')
-rw-r--r--Master/texmf-dist/doc/latex/glossaries-extra/glossaries-extra-manual.tex21
1 files changed, 12 insertions, 9 deletions
diff --git a/Master/texmf-dist/doc/latex/glossaries-extra/glossaries-extra-manual.tex b/Master/texmf-dist/doc/latex/glossaries-extra/glossaries-extra-manual.tex
index 39a9e6e1c4d..bf74f0c66f8 100644
--- a/Master/texmf-dist/doc/latex/glossaries-extra/glossaries-extra-manual.tex
+++ b/Master/texmf-dist/doc/latex/glossaries-extra/glossaries-extra-manual.tex
@@ -139,13 +139,13 @@ styles (glossaries):>#1={\protect\ttfamily#1}|main}}
\MakeShortVerb{"}
\DeleteShortVerb{\|}
- \title{glossaries-extra.sty v1.02:
+ \title{glossaries-extra.sty v1.03:
an extension to the glossaries package}
\author{Nicola L.C. Talbot\\[10pt]
Dickimaw Books\\
\url{http://www.dickimaw-books.com/}}
- \date{2016-04-25}
+ \date{2016-04-27}
\maketitle
\begin{abstract}
@@ -902,7 +902,7 @@ This will upper case the label \texttt{ssi} so the entry won't be
recognised. This problem will also occur if you use the all capitals
version, such as \ics{GLS}.
-\item The long and abbreviated forms accessed through
+\item\label{itm:nonexpandprob} The long and abbreviated forms accessed through
\ics{glsentrylong} and \ics{glsentryshort} are no longer expandable
and so can't be used be used in contexts that require this,
such as PDF bookmarks.
@@ -910,7 +910,7 @@ such as PDF bookmarks.
\item\label{itm:nestedsortprob} The nested commands may end up in the \gloskey{sort} key,
which will confuse the indexing.
-\item The \texttt{shtml} entry produces inconsistent results
+\item\label{itm:inconsistentfirstuseprob} The \texttt{shtml} entry produces inconsistent results
depending on whether the \texttt{ssi} or \texttt{html} entries have
been used. Suppose both \texttt{ssi} and \texttt{html} are used
before \texttt{shtml}. For example:
@@ -984,13 +984,13 @@ may not be a problem for some styles, but if you use one of the
\qt{sm} styles (that use \ics{textsmaller}), this will produce
an odd result.
-\item Each time the \texttt{shtml} entry is used, the
+\item\label{itm:indexingprob} Each time the \texttt{shtml} entry is used, the
\texttt{html} entry will also be indexed and marked as used,
and on \gls{firstuse} this will happen to both the \texttt{ssi}
and \texttt{html} entries. This kind of duplication in the location
list isn't usually particularly helpful to the reader.
-\item If \sty{hyperref} is in use, you'll get nested hyperlinks
+\item\label{itm:nestedhyplinkprob} If \sty{hyperref} is in use, you'll get nested hyperlinks
and there's no consistent way of dealing with this across the
available PDF viewers. If on the \gls{firstuse} case, the user
clicks on the \qt{HTML} part of the \qt{SSI enabled HTML (SHTML)}
@@ -1051,12 +1051,15 @@ is treated as
{\glstext[hyper=false,noindex]{ssi}} enabled
{\glstext[hyper=false,noindex]{html}}
\end{verbatim}
-This overcomes the last three problems listed
-above, but still doesn't fix the first two.
+This overcomes problems~\ref{itm:inconsistentfirstuseprob},
+\ref{itm:indexingprob} and \ref{itm:nestedhyplinkprob} listed
+above, but still doesn't fix problems~\ref{itm:nestedfirstucprob}
+and \ref{itm:nonexpandprob}.
Problem~\ref{itm:nestedsortprob} usually won't be an issue as most abbreviation
styles set the \gloskey{sort} key to the short form, so using these
commands in the long form but not the short form will only affect
-entries with a style that sorts according to the long form.
+entries with a style that sorts according to the long form (such as
+\abbrstyle{long-desc}).
Additionally, any instance of the long form commands, such
as \ics{glsxtrlong} or \ics{acrlong} will be temporarily