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.tex24
1 files changed, 21 insertions, 3 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 0938849b99d..93908891dfa 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
@@ -226,13 +226,13 @@ styles (glossaries):>#1={\protect\ttfamily#1}|main}}
\DeleteShortVerb{\|}
\MakeShortVerb{"}
- \title{glossaries-extra.sty v1.32:
+ \title{glossaries-extra.sty v1.33:
an extension to the glossaries package}
\author{Nicola L.C. Talbot\\[10pt]
Dickimaw Books\\
\url{http://www.dickimaw-books.com/}}
- \date{2018-05-24}
+ \date{2018-07-26}
\maketitle
\begin{abstract}
@@ -656,6 +656,9 @@ over a glossary list. This includes \ics{forglsentries} and
\ics{glsaddall}.
\end{important}
+Note that \ics{ifglsused} will just display ?? with
+\pkgopt[warn]{undefaction} if the entry hasn't been defined.
+
\item[{\pkgoptdef{indexcrossrefs}}] This is a boolean option.
If \pkgoptfmt{true}, this will automatically index any
cross-referenced entries that haven't been marked as used at
@@ -2077,9 +2080,24 @@ other categories will be unchanged.
Further information about entry counting, including the
new per-unit feature, is described in \sectionref{sec:entrycount}.
-\section{Unsetting the First Use Flag}
+\section{First Use Flag}
\label{sec:glsunset}
+The \styfmt{glossaries} package provides
+\begin{definition}
+\ics{ifglsused}\marg{label}\marg{true}\marg{false}
+\end{definition}
+to determine whether or not an entry has been used. This requires
+the entry to have been defined. To allow for
+\pkgopt[warn]{undefaction} (which is automatically switched on with
+the \pkgopt{record} option), the \styfmt{glossaries-extra} package
+redefines this command to allow for this setting. In the event that
+this setting is on and \meta{label} is undefined, then neither
+\meta{true} nor \meta{false} is done and ?? is displayed in the text
+(with a warning in the transcript). This has the knock-on effect of
+providing a more understandable error message with the default setting
+if the entry is undefined.
+
There are two new commands provided with version 1.31+:
\begin{definition}[\DescribeMacro\glslocalreseteach]
\cs{glslocalreseteach}\marg{list}