summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/glossaries-extra/glossaries-extra-manual.tex
diff options
context:
space:
mode:
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.tex40
1 files changed, 35 insertions, 5 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 e6f12508fea..56e1c4270cc 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
@@ -205,13 +205,13 @@ styles (glossaries):>#1={\protect\ttfamily#1}|main}}
\DeleteShortVerb{\|}
\MakeShortVerb{"}
- \title{glossaries-extra.sty v1.19:
+ \title{glossaries-extra.sty v1.20:
an extension to the glossaries package}
\author{Nicola L.C. Talbot\\[10pt]
Dickimaw Books\\
\url{http://www.dickimaw-books.com/}}
- \date{2017-09-08}
+ \date{2017-09-11}
\maketitle
\begin{abstract}
@@ -855,13 +855,22 @@ This also has a starred version that doesn't automatically switch
off hyperlinks.
The individual glossary displaying commands \ics{printglossary},
-\ics{printnoidxglossary} and \cs{printunsrtglossary} have an extra
-key \gloskey[printglossary]{target}. This is a boolean key which can
+\ics{printnoidxglossary} and \cs{printunsrtglossary} have two extra
+keys:
+
+\begin{itemize}
+\item \gloskey[printglossary]{target}. This is a boolean key which can
be used to switch off the automatic hypertarget for each entry.
Unlike \cs{glsdisablehyper} this doesn't switch off hyperlinks, so
any cross-references within the glossary won't be affected. This is
a way of avoiding duplicate target warnings if a glossary needs to
be displayed multiple times.
+\item
+\gloskey[printglossary]{targetnameprefix}\texttt{=}\marg{prefix}. Another way
+of avoiding duplicate target names is to set a prefix
+used for the names. Unlike changing \cs{glolinkprefix} this doesn't affect
+any hyperlinks (such as those created with \cs{gls}).
+\end{itemize}
The \cs{newglossaryentry} command has three new keys:
\begin{itemize}
@@ -6595,6 +6604,27 @@ avoid duplicate hypertarget names. For example:
}%
}
\end{verbatim}
+Note that this will cause a problem if your descriptions
+contain commands like \cs{gls} that need to link an entry that
+doesn't appear in the summary. In this case, it's a better approach
+to use:
+\begin{verbatim}
+\printunsrtglossary*{%
+ \renewcommand{\printunsrtglossaryhandler}[1]{%
+ \glsxtrfieldxifinlist{#1}{record.section}{\thesection}
+ {\glsxtrunsrtdo{#1}}%
+ {}%
+ }%
+ \ifcsundef{theHsection}%
+ {%
+ \setkeys{printgloss}{targetnameprefix={record.#2.\csuse{thesection}.}}%
+ }%
+ {%
+ \setkeys{printgloss}{targetnameprefix={record.#2.\csuse{theHsection}.}}%
+ }%
+}
+\end{verbatim}
+
If it's a short summary at the start of a section, you might
also want to suppress the glossary header and add some vertical
space afterwards:
@@ -6617,7 +6647,7 @@ space afterwards:
}
\end{verbatim}
-There's a shortcut command that does this:
+There's a shortcut command that essentially does this:
\begin{definition}[\DescribeMacro\printunsrtglossaryunit]
\cs{printunsrtglossaryunit}\oarg{options}\marg{counter name}
\end{definition}