summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc')
-rw-r--r--Master/texmf-dist/doc/latex/testidx/CHANGES15
-rw-r--r--Master/texmf-dist/doc/latex/testidx/README6
-rw-r--r--Master/texmf-dist/doc/latex/testidx/samples/sample-idx-a4.pdfbin179083 -> 186061 bytes
-rw-r--r--Master/texmf-dist/doc/latex/testidx/samples/sample-idx-amsmath.pdfbin180673 -> 190620 bytes
-rw-r--r--Master/texmf-dist/doc/latex/testidx/samples/sample-idx-amsmath.tex1
-rw-r--r--Master/texmf-dist/doc/latex/testidx/samples/sample-idx-babel-german.pdfbin197506 -> 204565 bytes
-rw-r--r--Master/texmf-dist/doc/latex/testidx/samples/sample-idx-german.pdfbin197471 -> 204480 bytes
-rw-r--r--Master/texmf-dist/doc/latex/testidx/samples/sample-idx-hyp.pdfbin197330 -> 207017 bytes
-rw-r--r--Master/texmf-dist/doc/latex/testidx/samples/sample-idx-letter.pdfbin192702 -> 199713 bytes
-rw-r--r--Master/texmf-dist/doc/latex/testidx/samples/sample-idx-lua.pdfbin139651 -> 148258 bytes
-rw-r--r--Master/texmf-dist/doc/latex/testidx/samples/sample-idx-lua.tex4
-rw-r--r--Master/texmf-dist/doc/latex/testidx/samples/sample-idx-subset.pdfbin136824 -> 138492 bytes
-rw-r--r--Master/texmf-dist/doc/latex/testidx/samples/sample-idx-t1.pdfbin285224 -> 294342 bytes
-rw-r--r--Master/texmf-dist/doc/latex/testidx/samples/sample-idx-utf8.pdfbin305493 -> 316716 bytes
-rw-r--r--Master/texmf-dist/doc/latex/testidx/samples/sample-idx-utf8.tex5
-rw-r--r--Master/texmf-dist/doc/latex/testidx/samples/sample-idx-xe-digraphs.pdfbin0 -> 101305 bytes
-rw-r--r--Master/texmf-dist/doc/latex/testidx/samples/sample-idx-xe-digraphs.tex85
-rw-r--r--Master/texmf-dist/doc/latex/testidx/samples/sample-idx-xe.pdfbin96285 -> 103564 bytes
-rw-r--r--Master/texmf-dist/doc/latex/testidx/samples/sample-idx-xe.tex6
-rw-r--r--Master/texmf-dist/doc/latex/testidx/samples/sample-idx.pdfbin180704 -> 187731 bytes
-rw-r--r--Master/texmf-dist/doc/latex/testidx/samples/sample-idxgloss-bib2gls-xe.pdfbin0 -> 178540 bytes
-rw-r--r--Master/texmf-dist/doc/latex/testidx/samples/sample-idxgloss-bib2gls-xe.tex76
-rw-r--r--Master/texmf-dist/doc/latex/testidx/samples/sample-idxgloss-bib2gls.pdfbin0 -> 364062 bytes
-rw-r--r--Master/texmf-dist/doc/latex/testidx/samples/sample-idxgloss-bib2gls.tex72
-rw-r--r--Master/texmf-dist/doc/latex/testidx/samples/sample-idxgloss-desc.pdfbin0 -> 430712 bytes
-rw-r--r--Master/texmf-dist/doc/latex/testidx/samples/sample-idxgloss-desc.tex18
-rw-r--r--Master/texmf-dist/doc/latex/testidx/samples/sample-idxgloss-xe-digraphs.pdfbin0 -> 100182 bytes
-rw-r--r--Master/texmf-dist/doc/latex/testidx/samples/sample-idxgloss-xe-digraphs.tex38
-rw-r--r--Master/texmf-dist/doc/latex/testidx/samples/sample-idxgloss-xindy.pdfbin0 -> 279604 bytes
-rw-r--r--Master/texmf-dist/doc/latex/testidx/samples/sample-idxgloss-xindy.tex33
-rw-r--r--Master/texmf-dist/doc/latex/testidx/samples/sample-idxgloss.pdfbin0 -> 304536 bytes
-rw-r--r--Master/texmf-dist/doc/latex/testidx/samples/sample-idxgloss.tex22
-rw-r--r--Master/texmf-dist/doc/latex/testidx/samples/sample-noidxgloss.pdfbin0 -> 276368 bytes
-rw-r--r--Master/texmf-dist/doc/latex/testidx/samples/sample-noidxgloss.tex18
-rw-r--r--Master/texmf-dist/doc/latex/testidx/testidx-code.pdfbin378658 -> 480276 bytes
-rw-r--r--Master/texmf-dist/doc/latex/testidx/testidx-glossaries-diglyphs-utf8.bib61
-rw-r--r--Master/texmf-dist/doc/latex/testidx/testidx-glossaries-diglyphs.tex61
-rw-r--r--Master/texmf-dist/doc/latex/testidx/testidx-glossaries-markers.bib79
-rw-r--r--Master/texmf-dist/doc/latex/testidx/testidx-glossaries-mathsym.bib44
-rw-r--r--Master/texmf-dist/doc/latex/testidx/testidx-glossaries-nodiglyphs-utf8.bib63
-rw-r--r--Master/texmf-dist/doc/latex/testidx/testidx-glossaries-nodiglyphs.bib63
-rw-r--r--Master/texmf-dist/doc/latex/testidx/testidx-glossaries-nodiglyphs.tex61
-rw-r--r--Master/texmf-dist/doc/latex/testidx/testidx-glossaries-numbers.bib32
-rw-r--r--Master/texmf-dist/doc/latex/testidx/testidx-glossaries-samples-ascii.bib553
-rw-r--r--Master/texmf-dist/doc/latex/testidx/testidx-glossaries-samples-utf8.bib553
-rw-r--r--Master/texmf-dist/doc/latex/testidx/testidx-glossaries-samples.bib3111
-rw-r--r--Master/texmf-dist/doc/latex/testidx/testidx-glossaries-samples.tex801
-rw-r--r--Master/texmf-dist/doc/latex/testidx/testidx-manual.pdfbin282040 -> 321402 bytes
-rw-r--r--Master/texmf-dist/doc/latex/testidx/testidx-manual.tex406
49 files changed, 6254 insertions, 33 deletions
diff --git a/Master/texmf-dist/doc/latex/testidx/CHANGES b/Master/texmf-dist/doc/latex/testidx/CHANGES
index 359a3bc8447..c37932f0841 100644
--- a/Master/texmf-dist/doc/latex/testidx/CHANGES
+++ b/Master/texmf-dist/doc/latex/testidx/CHANGES
@@ -1,3 +1,18 @@
+v1.1 (2017-08-11):
+
+ * Added more sample text, including examples starting with some
+ digraphs and a trigraph.
+
+ * New package options: diglyphs, nodiglyphs
+
+ * New commands:
+
+ - \tstidxSetSeeEncap
+ - \tstidxSetSeeAlsoEncap
+
+ * Added supplementary package testidx-glossaries.sty which uses the
+ interface provided by the glossaries package.
+
v1.0 (2016-10-17):
* Initial release
diff --git a/Master/texmf-dist/doc/latex/testidx/README b/Master/texmf-dist/doc/latex/testidx/README
index 885829213e3..1671deff3c7 100644
--- a/Master/texmf-dist/doc/latex/testidx/README
+++ b/Master/texmf-dist/doc/latex/testidx/README
@@ -1,10 +1,12 @@
-LaTeX Package : testidx v1.0
+LaTeX Package : testidx v1.1
-Last Modified : 2016-10-17
+Last Modified : 2017-08-11
Author : Nicola Talbot
This package provides dummy text for testing indexes.
+The supplementary package testidx-glossaries.sty uses
+the indexing interface provided by the glossaries package.
Example document:
diff --git a/Master/texmf-dist/doc/latex/testidx/samples/sample-idx-a4.pdf b/Master/texmf-dist/doc/latex/testidx/samples/sample-idx-a4.pdf
index ba228b3e554..40d26c22e5c 100644
--- a/Master/texmf-dist/doc/latex/testidx/samples/sample-idx-a4.pdf
+++ b/Master/texmf-dist/doc/latex/testidx/samples/sample-idx-a4.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/testidx/samples/sample-idx-amsmath.pdf b/Master/texmf-dist/doc/latex/testidx/samples/sample-idx-amsmath.pdf
index 2d95b52f6f4..b212b990cc1 100644
--- a/Master/texmf-dist/doc/latex/testidx/samples/sample-idx-amsmath.pdf
+++ b/Master/texmf-dist/doc/latex/testidx/samples/sample-idx-amsmath.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/testidx/samples/sample-idx-amsmath.tex b/Master/texmf-dist/doc/latex/testidx/samples/sample-idx-amsmath.tex
index 9e3a62a5bb0..5faab29b766 100644
--- a/Master/texmf-dist/doc/latex/testidx/samples/sample-idx-amsmath.tex
+++ b/Master/texmf-dist/doc/latex/testidx/samples/sample-idx-amsmath.tex
@@ -16,6 +16,7 @@
\usepackage{makeidx}
\usepackage{amsmath}
+\usepackage{amssymb}
\usepackage{testidx}
\makeindex
diff --git a/Master/texmf-dist/doc/latex/testidx/samples/sample-idx-babel-german.pdf b/Master/texmf-dist/doc/latex/testidx/samples/sample-idx-babel-german.pdf
index 0a3a69fdfbd..624a7ec0243 100644
--- a/Master/texmf-dist/doc/latex/testidx/samples/sample-idx-babel-german.pdf
+++ b/Master/texmf-dist/doc/latex/testidx/samples/sample-idx-babel-german.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/testidx/samples/sample-idx-german.pdf b/Master/texmf-dist/doc/latex/testidx/samples/sample-idx-german.pdf
index e6cbc73f389..8796631b565 100644
--- a/Master/texmf-dist/doc/latex/testidx/samples/sample-idx-german.pdf
+++ b/Master/texmf-dist/doc/latex/testidx/samples/sample-idx-german.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/testidx/samples/sample-idx-hyp.pdf b/Master/texmf-dist/doc/latex/testidx/samples/sample-idx-hyp.pdf
index 3bcf22dba8a..e46507fbae2 100644
--- a/Master/texmf-dist/doc/latex/testidx/samples/sample-idx-hyp.pdf
+++ b/Master/texmf-dist/doc/latex/testidx/samples/sample-idx-hyp.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/testidx/samples/sample-idx-letter.pdf b/Master/texmf-dist/doc/latex/testidx/samples/sample-idx-letter.pdf
index ffcfcadc657..319f33dd7b2 100644
--- a/Master/texmf-dist/doc/latex/testidx/samples/sample-idx-letter.pdf
+++ b/Master/texmf-dist/doc/latex/testidx/samples/sample-idx-letter.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/testidx/samples/sample-idx-lua.pdf b/Master/texmf-dist/doc/latex/testidx/samples/sample-idx-lua.pdf
index 595df828e7f..6cf3556cd31 100644
--- a/Master/texmf-dist/doc/latex/testidx/samples/sample-idx-lua.pdf
+++ b/Master/texmf-dist/doc/latex/testidx/samples/sample-idx-lua.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/testidx/samples/sample-idx-lua.tex b/Master/texmf-dist/doc/latex/testidx/samples/sample-idx-lua.tex
index 382069e0850..39526333cd1 100644
--- a/Master/texmf-dist/doc/latex/testidx/samples/sample-idx-lua.tex
+++ b/Master/texmf-dist/doc/latex/testidx/samples/sample-idx-lua.tex
@@ -54,13 +54,13 @@
:prefixes ("0" "1" "2" "3" "4" "5" "6" "7" "8" "9")
:before "A")
-; define a "Maths" group for keys starting with "+"
+; define a "Maths" group for keys starting with ">"
(define-letter-group "Maths"
:prefixes (">" )
:before "Numbers")
-; define a "Markers" group for keys starting with "."
+; define a "Markers" group for keys starting with "<"
(define-letter-group "Markers"
:prefixes ("<" )
diff --git a/Master/texmf-dist/doc/latex/testidx/samples/sample-idx-subset.pdf b/Master/texmf-dist/doc/latex/testidx/samples/sample-idx-subset.pdf
index 2ff5ecb69d1..c6045b334ef 100644
--- a/Master/texmf-dist/doc/latex/testidx/samples/sample-idx-subset.pdf
+++ b/Master/texmf-dist/doc/latex/testidx/samples/sample-idx-subset.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/testidx/samples/sample-idx-t1.pdf b/Master/texmf-dist/doc/latex/testidx/samples/sample-idx-t1.pdf
index 22bc174e6e7..50a176f0d41 100644
--- a/Master/texmf-dist/doc/latex/testidx/samples/sample-idx-t1.pdf
+++ b/Master/texmf-dist/doc/latex/testidx/samples/sample-idx-t1.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/testidx/samples/sample-idx-utf8.pdf b/Master/texmf-dist/doc/latex/testidx/samples/sample-idx-utf8.pdf
index f6dabb82ef0..f35959e4b71 100644
--- a/Master/texmf-dist/doc/latex/testidx/samples/sample-idx-utf8.pdf
+++ b/Master/texmf-dist/doc/latex/testidx/samples/sample-idx-utf8.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/testidx/samples/sample-idx-utf8.tex b/Master/texmf-dist/doc/latex/testidx/samples/sample-idx-utf8.tex
index 54eda5316d0..e4cbb529f3b 100644
--- a/Master/texmf-dist/doc/latex/testidx/samples/sample-idx-utf8.tex
+++ b/Master/texmf-dist/doc/latex/testidx/samples/sample-idx-utf8.tex
@@ -18,6 +18,7 @@
\usepackage{filecontents}
\usepackage[T1]{fontenc}
\usepackage[utf8]{inputenc}
+\usepackage{amssymb}
\usepackage{makeidx}
\usepackage
[
@@ -64,13 +65,13 @@
:prefixes ("0" "1" "2" "3" "4" "5" "6" "7" "8" "9")
:before "A")
-; define a "Maths" group for keys starting with "+"
+; define a "Maths" group for keys starting with ">"
(define-letter-group "Maths"
:prefixes (">" )
:before "Numbers")
-; define a "Markers" group for keys starting with "."
+; define a "Markers" group for keys starting with "<"
(define-letter-group "Markers"
:prefixes ("<" )
diff --git a/Master/texmf-dist/doc/latex/testidx/samples/sample-idx-xe-digraphs.pdf b/Master/texmf-dist/doc/latex/testidx/samples/sample-idx-xe-digraphs.pdf
new file mode 100644
index 00000000000..a9c63412395
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/testidx/samples/sample-idx-xe-digraphs.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/testidx/samples/sample-idx-xe-digraphs.tex b/Master/texmf-dist/doc/latex/testidx/samples/sample-idx-xe-digraphs.tex
new file mode 100644
index 00000000000..7fcd40f9497
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/testidx/samples/sample-idx-xe-digraphs.tex
@@ -0,0 +1,85 @@
+% This file is public domain.
+%
+% This example document demonstrates the testidx package
+% with XeLaTeX and xindy using digraph glyphs.
+% You can build this document using:
+%
+% xelatex sample-idx-xe
+% xindy -M sample-idx-xe -M texindy -C utf8 -L english -t sample-idx-xe.ilg sample-idx-xe.idx
+% xelatex sample-idx-xe
+%
+% You may want to experiment with different languages.
+%
+% If you are using arara, the directives are:
+%
+% arara: xelatex
+% arara: xindy: {language: english, codepage: utf8,
+% arara: --> modules: [basename, texindy]}
+% arara: xelatex
+\documentclass{article}
+
+\usepackage{filecontents}
+\usepackage{fontspec}
+
+% Need a font that supports the digraph glyphs
+% For example:
+\setmainfont{Linux Libertine O}
+
+\usepackage{makeidx}
+\usepackage[diglyphs]{testidx}
+
+% Create the .xdy file for this example:
+\begin{filecontents*}{\jobname.xdy}
+; list of allowed attributes
+
+(define-attributes ((
+ "tstidxencapi"
+ "tstidxencapii"
+ "tstidxencapiii"
+)))
+
+; define format to use for locations
+
+(markup-locref :open "\tstidxencapi{"
+ :close "}"
+ :attr "tstidxencapi")
+
+(markup-locref :open "\tstidxencapii{"
+ :close "}"
+ :attr "tstidxencapii")
+
+(markup-locref :open "\tstidxencapiii{"
+ :close "}"
+ :attr "tstidxencapiii")
+
+(markup-locref-list :sep ",")
+(markup-range :sep "--")
+
+; define a numbers group
+
+(define-letter-group "Numbers"
+ :prefixes ("0" "1" "2" "3" "4" "5" "6" "7" "8" "9")
+ :before "A")
+
+; define a "Maths" group for keys starting with ">"
+
+(define-letter-group "Maths"
+ :prefixes (">" )
+ :before "Numbers")
+
+; define a "Markers" group for keys starting with "<"
+
+(define-letter-group "Markers"
+ :prefixes ("<" )
+ :before "Maths")
+
+\end{filecontents*}
+
+\makeindex
+
+\begin{document}
+\testidx
+
+\printindex
+\end{document}
+
diff --git a/Master/texmf-dist/doc/latex/testidx/samples/sample-idx-xe.pdf b/Master/texmf-dist/doc/latex/testidx/samples/sample-idx-xe.pdf
index 3e9264747e9..af1f8ada1e2 100644
--- a/Master/texmf-dist/doc/latex/testidx/samples/sample-idx-xe.pdf
+++ b/Master/texmf-dist/doc/latex/testidx/samples/sample-idx-xe.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/testidx/samples/sample-idx-xe.tex b/Master/texmf-dist/doc/latex/testidx/samples/sample-idx-xe.tex
index 0619b5aa826..4502dafe6f6 100644
--- a/Master/texmf-dist/doc/latex/testidx/samples/sample-idx-xe.tex
+++ b/Master/texmf-dist/doc/latex/testidx/samples/sample-idx-xe.tex
@@ -7,6 +7,8 @@
% xindy -M sample-idx-xe -M texindy -C utf8 -L english -t sample-idx-xe.ilg sample-idx-xe.idx
% xelatex sample-idx-xe
%
+% You may want to experiment with different languages.
+%
% If you are using arara, the directives are:
%
% arara: xelatex
@@ -53,13 +55,13 @@
:prefixes ("0" "1" "2" "3" "4" "5" "6" "7" "8" "9")
:before "A")
-; define a "Maths" group for keys starting with "+"
+; define a "Maths" group for keys starting with ">"
(define-letter-group "Maths"
:prefixes (">" )
:before "Numbers")
-; define a "Markers" group for keys starting with "."
+; define a "Markers" group for keys starting with "<"
(define-letter-group "Markers"
:prefixes ("<" )
diff --git a/Master/texmf-dist/doc/latex/testidx/samples/sample-idx.pdf b/Master/texmf-dist/doc/latex/testidx/samples/sample-idx.pdf
index fc7d00b7fbd..61197f80974 100644
--- a/Master/texmf-dist/doc/latex/testidx/samples/sample-idx.pdf
+++ b/Master/texmf-dist/doc/latex/testidx/samples/sample-idx.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/testidx/samples/sample-idxgloss-bib2gls-xe.pdf b/Master/texmf-dist/doc/latex/testidx/samples/sample-idxgloss-bib2gls-xe.pdf
new file mode 100644
index 00000000000..e5410c3d840
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/testidx/samples/sample-idxgloss-bib2gls-xe.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/testidx/samples/sample-idxgloss-bib2gls-xe.tex b/Master/texmf-dist/doc/latex/testidx/samples/sample-idxgloss-bib2gls-xe.tex
new file mode 100644
index 00000000000..34b6e711679
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/testidx/samples/sample-idxgloss-bib2gls-xe.tex
@@ -0,0 +1,76 @@
+% arara: xelatex
+% arara: bib2gls: {group: on}
+% arara: xelatex
+% arara: xelatex
+\documentclass{report}
+
+\usepackage{fontspec}
+\setmainfont{DejaVu Serif}
+
+\usepackage{amssymb}
+\usepackage[hidelinks]{hyperref}
+\usepackage[bib2gls,diglyphs]{testidx-glossaries}
+
+\setglossarystyle{mcolindexspannav}
+
+\renewcommand*{\glstreenamefmt}[1]{#1}
+\renewcommand*{\glstreegroupheaderfmt}[1]{\textbf{#1}}
+
+\tstidxmakegloss[
+ max-loc-diff={2},
+% Try with different languages
+% sort={no}% norsk
+% sort={nn}% nynorsk
+% sort={nl}% dutch
+% sort={is}% icelandic
+% sort={cy}% welsh
+% sort={ga}% irish
+% sort={pl}% polish
+% sort={hu}% hungarian
+% Or use a custom rule:
+ sort={custom},
+ sort-rule={% custom sort rule (only used with sort=custom)
+ ' '; % space
+ \string\u0300;% combining grave accent
+ \string\u0301;% combining acute accent
+ \string\u0302;% combining circumflex accent
+ \string\u0303;% combining tilde accent
+ \string\u0304;% combining macron accent
+ \string\u0305;% combining overline accent
+ \string\u0306;% combining breve accent
+ \string\u0307;% combining dot above accent
+ \string\u0308;% combining diaeresis accent
+ \string\u0309;% combining hook above accent
+ \string\u030A;% combining ring above accent
+ \string\u030B;% combining double acute accent
+ \string\u030C;% combining caron accent
+ \string\u0327;% combining cedilla accent
+ \string\u0328;% combining ogonek accent
+ \string\u20D7% combining right arrow above accent
+ <'\string_'< ','< ';'< ':'< '!'< '?'< '/'< '.'< '<'<'>'<'('<')'% punctuation
+ < 0 < 1 < 2 < 3 < 4 < 5 < 6 < 7 < 8 < 9
+ < a,A < b,B < c,C < d,D
+ < dd,Dd,DD
+ < dz,\string\u01F3\string&Dz,\string\u01F2\string&DZ,\string\u01F1 < dzs,DZS
+ < \string\u00F0,\string\u00D0 % eth
+ < e,E < f,F < ff,Ff,FF
+ < g,G < h,H < i,I < ij,\string\u0133,IJ,\string\u0132
+ < j,J < k,K < l,L
+ < ll,\string\u1EFB,Ll,LL,\string\u1EFA
+ < m,M < n,N
+ < ng,Ng,NG < o,O < p,P
+ < q,Q < r,R < s,S < t,T < u,U < v,V < w,W < x,X < y,Y < z,Z
+ < \string\u00E6,\string\u00C6 % (ae ligature)
+ < \string\u0153,\string\u0152 % (oe ligature)
+ < \string\u00FE,\string\u00DE % (thorn)
+ < \string\u00F8,\string\u00D8 % (o slash)
+ < \string\u0142,\string\u0141 % (l stroke)
+ }
+]
+
+\begin{document}
+
+\testidx
+
+\tstidxprintglossaries
+\end{document}
diff --git a/Master/texmf-dist/doc/latex/testidx/samples/sample-idxgloss-bib2gls.pdf b/Master/texmf-dist/doc/latex/testidx/samples/sample-idxgloss-bib2gls.pdf
new file mode 100644
index 00000000000..956cdf15115
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/testidx/samples/sample-idxgloss-bib2gls.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/testidx/samples/sample-idxgloss-bib2gls.tex b/Master/texmf-dist/doc/latex/testidx/samples/sample-idxgloss-bib2gls.tex
new file mode 100644
index 00000000000..71b9c18bf87
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/testidx/samples/sample-idxgloss-bib2gls.tex
@@ -0,0 +1,72 @@
+% arara: pdflatex
+% arara: bib2gls: {group: on}
+% arara: pdflatex
+% arara: pdflatex
+\documentclass{report}
+
+\usepackage[a4paper]{geometry}
+\usepackage[T1]{fontenc}
+\usepackage[utf8]{inputenc}
+\usepackage{amssymb}
+\usepackage[hidelinks]{hyperref}
+\usepackage[bib2gls]{testidx-glossaries}
+
+\setglossarystyle{mcolindexspannav}
+
+\renewcommand*{\glstreenamefmt}[1]{#1}
+\renewcommand*{\glstreegroupheaderfmt}[1]{\textbf{#1}}
+
+\tstidxmakegloss[
+% Try with different languages:
+% sort={no}% norsk
+% sort={nn}% nynorsk
+% sort={nl}% dutch
+% sort={is}% icelandic
+% sort={cy}% welsh
+% sort={ga}% irish
+% sort={pl}% polish
+% sort={hu}% hungarian
+% Or use a custom rule:
+ sort={custom},
+ sort-rule={% custom sort rule (only used with sort=custom)
+ ' '; % space
+ \string\u0300;% combining grave accent
+ \string\u0301;% combining acute accent
+ \string\u0302;% combining circumflex accent
+ \string\u0303;% combining tilde accent
+ \string\u0304;% combining macron accent
+ \string\u0305;% combining overline accent
+ \string\u0306;% combining breve accent
+ \string\u0307;% combining dot above accent
+ \string\u0308;% combining diaeresis accent
+ \string\u0309;% combining hook above accent
+ \string\u030A;% combining ring above accent
+ \string\u030B;% combining double acute accent
+ \string\u030C;% combining caron accent
+ \string\u0327;% combining cedilla accent
+ \string\u0328;% combining ogonek accent
+ \string\u20D7% combining right arrow above accent
+ <'\string_'< ','< ';'< ':'< '!'< '?'< '/'< '.'< '<'<'>'<'('<')'% punctuation
+ < 0 < 1 < 2 < 3 < 4 < 5 < 6 < 7 < 8 < 9
+ < a,A < b,B < c,C < d,D
+ < dd,Dd,DD < dz,DZ < dzs,DZS
+ < \string\u00F0,\string\u00D0 % eth
+ < e,E < f,F < ff,Ff,FF
+ < g,G < h,H < i,I < ij,IJ < j,J < k,K < l,L < ll,Ll,LL < m,M < n,N
+ < ng,Ng,NG < o,O < p,P
+ < q,Q < r,R < s,S < t,T < u,U < v,V < w,W < x,X < y,Y < z,Z
+ < \string\u00E6,\string\u00C6 % (ae ligature)
+ < \string\u0153,\string\u0152 % (oe ligature)
+ < \string\u00FE,\string\u00DE % (thorn)
+ < \string\u00F8,\string\u00D8 % (o slash)
+ < \string\u0142,\string\u0141 % (l stroke)
+}
+]
+
+\begin{document}
+
+\testidx
+
+\tstidxprintglossaries
+
+\end{document}
diff --git a/Master/texmf-dist/doc/latex/testidx/samples/sample-idxgloss-desc.pdf b/Master/texmf-dist/doc/latex/testidx/samples/sample-idxgloss-desc.pdf
new file mode 100644
index 00000000000..764fc16f9d7
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/testidx/samples/sample-idxgloss-desc.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/testidx/samples/sample-idxgloss-desc.tex b/Master/texmf-dist/doc/latex/testidx/samples/sample-idxgloss-desc.tex
new file mode 100644
index 00000000000..34c350a27cf
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/testidx/samples/sample-idxgloss-desc.tex
@@ -0,0 +1,18 @@
+% arara: pdflatex
+% arara: makeglossaries if found("aux", "@istfilename")
+% arara: pdflatex
+\documentclass{report}
+
+\usepackage[T1]{fontenc}
+\usepackage[hidelinks]{hyperref}
+\usepackage[desc]{testidx-glossaries}
+
+\tstidxmakegloss
+
+\begin{document}
+
+\testidx
+
+\tstidxprintglossaries
+
+\end{document}
diff --git a/Master/texmf-dist/doc/latex/testidx/samples/sample-idxgloss-xe-digraphs.pdf b/Master/texmf-dist/doc/latex/testidx/samples/sample-idxgloss-xe-digraphs.pdf
new file mode 100644
index 00000000000..ee78e9178cd
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/testidx/samples/sample-idxgloss-xe-digraphs.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/testidx/samples/sample-idxgloss-xe-digraphs.tex b/Master/texmf-dist/doc/latex/testidx/samples/sample-idxgloss-xe-digraphs.tex
new file mode 100644
index 00000000000..66785253533
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/testidx/samples/sample-idxgloss-xe-digraphs.tex
@@ -0,0 +1,38 @@
+% arara: xelatex
+% arara: makeglossaries if found("aux", "@istfilename")
+% arara: xelatex
+\documentclass{report}
+
+\usepackage{fontspec}
+\setmainfont{Linux Libertine O}
+
+\usepackage[xindy,diglyphs]{testidx-glossaries}
+
+% Try this example out with different xindy language modules:
+%\GlsSetXdyLanguage{dutch}
+%\GlsSetXdyLanguage{icelandic}
+%\GlsSetXdyLanguage{hungarian}
+%\GlsSetXdyLanguage{polish}
+
+\renewcommand*{\glstreenamefmt}[1]{#1}
+
+\GlsAddXdyAttribute{tstidxencapi}
+\GlsAddXdyAttribute{tstidxencapii}
+\GlsAddXdyAttribute{tstidxencapiii}
+
+% define a "Maths" group for keys starting with ">"
+
+\GlsAddLetterGroup{Maths}{:prefixes (">" ) :before "glsnumbers"}
+
+% define a "Markers" group for keys starting with "<"
+
+\GlsAddLetterGroup{Markers}{:prefixes ("<" ) :before "Maths"}
+
+\tstidxmakegloss
+
+\begin{document}
+\testidx
+
+\tstidxprintglossaries
+
+\end{document}
diff --git a/Master/texmf-dist/doc/latex/testidx/samples/sample-idxgloss-xindy.pdf b/Master/texmf-dist/doc/latex/testidx/samples/sample-idxgloss-xindy.pdf
new file mode 100644
index 00000000000..582ce035b04
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/testidx/samples/sample-idxgloss-xindy.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/testidx/samples/sample-idxgloss-xindy.tex b/Master/texmf-dist/doc/latex/testidx/samples/sample-idxgloss-xindy.tex
new file mode 100644
index 00000000000..882982e44a6
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/testidx/samples/sample-idxgloss-xindy.tex
@@ -0,0 +1,33 @@
+% arara: pdflatex
+% arara: makeglossaries if found("aux", "@istfilename")
+% arara: pdflatex
+\documentclass{report}
+
+\usepackage[T1]{fontenc}
+\usepackage[utf8]{inputenc}
+\usepackage{amssymb}
+\usepackage[seekey,prefix,verbose,xindy]{testidx-glossaries}
+
+% Try this example out with different xindy language modules:
+%\GlsSetXdyLanguage{dutch}
+%\GlsSetXdyLanguage{icelandic}
+%\GlsSetXdyLanguage{hungarian}
+%\GlsSetXdyLanguage{polish}
+
+\renewcommand*{\glstreenamefmt}[1]{#1}
+
+\GlsAddXdyAttribute{tstidxencapi}
+\GlsAddXdyAttribute{tstidxencapii}
+\GlsAddXdyAttribute{tstidxencapiii}
+
+\GlsAddLetterGroup{Maths}{:prefixes (">") :before "glsnumbers"}
+\GlsAddLetterGroup{Markers}{:prefixes ("<") :before "Maths"}
+
+\tstidxmakegloss
+
+\begin{document}
+\testidx
+
+\tstidxprintglossaries
+
+\end{document}
diff --git a/Master/texmf-dist/doc/latex/testidx/samples/sample-idxgloss.pdf b/Master/texmf-dist/doc/latex/testidx/samples/sample-idxgloss.pdf
new file mode 100644
index 00000000000..de7e98a83a2
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/testidx/samples/sample-idxgloss.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/testidx/samples/sample-idxgloss.tex b/Master/texmf-dist/doc/latex/testidx/samples/sample-idxgloss.tex
new file mode 100644
index 00000000000..0b7f8b61185
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/testidx/samples/sample-idxgloss.tex
@@ -0,0 +1,22 @@
+% arara: pdflatex
+% arara: makeglossaries if found("aux", "@istfilename")
+% arara: pdflatex
+\documentclass[11pt]{report}
+
+\usepackage[T1]{fontenc}
+\usepackage{amssymb}
+\usepackage[a4paper,left=.75in,right=1.6in]{geometry}
+\usepackage[verbose]{testidx-glossaries}
+
+\renewcommand*{\glstreenamefmt}[1]{#1}
+\renewcommand*{\glstreegroupheaderfmt}[1]{\textbf{#1}}
+
+\tstidxmakegloss
+
+\begin{document}
+
+\testidx
+
+\tstidxprintglossaries
+
+\end{document}
diff --git a/Master/texmf-dist/doc/latex/testidx/samples/sample-noidxgloss.pdf b/Master/texmf-dist/doc/latex/testidx/samples/sample-noidxgloss.pdf
new file mode 100644
index 00000000000..633472b549e
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/testidx/samples/sample-noidxgloss.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/testidx/samples/sample-noidxgloss.tex b/Master/texmf-dist/doc/latex/testidx/samples/sample-noidxgloss.tex
new file mode 100644
index 00000000000..5170388f0c3
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/testidx/samples/sample-noidxgloss.tex
@@ -0,0 +1,18 @@
+% arara: pdflatex
+% arara: pdflatex
+\documentclass{report}
+
+\usepackage[T1]{fontenc}
+\usepackage[tex,verbose]{testidx-glossaries}
+
+\renewcommand*{\glstreenamefmt}[1]{#1}
+
+\tstidxmakegloss
+
+\begin{document}
+
+\testidx
+
+\tstidxprintglossaries
+
+\end{document}
diff --git a/Master/texmf-dist/doc/latex/testidx/testidx-code.pdf b/Master/texmf-dist/doc/latex/testidx/testidx-code.pdf
index 56273b8b382..0e30ab91a93 100644
--- a/Master/texmf-dist/doc/latex/testidx/testidx-code.pdf
+++ b/Master/texmf-dist/doc/latex/testidx/testidx-code.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/testidx/testidx-glossaries-diglyphs-utf8.bib b/Master/texmf-dist/doc/latex/testidx/testidx-glossaries-diglyphs-utf8.bib
new file mode 100644
index 00000000000..e9f94b9ab28
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/testidx/testidx-glossaries-diglyphs-utf8.bib
@@ -0,0 +1,61 @@
+% Encoding: UTF-8
+
+@index{ll,
+ name={ỻ},
+ category={digraph},
+ description={a \glshyperlink{digraph} used in
+a number of languages. In Welsh, LL is considered a separate letter
+from L and may be rendered as the ligature Ỻ}
+}
+
+@index{ij,
+ name={ij},
+ category={digraph},
+ description={a \glshyperlink{digraph} used in Dutch that's sometimes considered
+a separate letter from I and may be rendered as the ligature IJ}
+}
+
+@index{dz,
+ name={dz},
+ category={digraph},
+ description={a \glshyperlink{digraph} used in
+a number of languages. In Hungarian, Dz is considered a separate letter
+from D and may be rendered as the ligature Dz}
+}
+
+@index{llan,
+ name={ỻan},
+ category={word},
+ description={commonly used placename element in Brittonic
+languages (such as Welsh) typically indicating parish church}
+}
+
+@index{llama,
+ name={ỻama},
+ category={word},
+ description={domesticate animal found in the Andes}
+}
+
+@index{lijnbus,
+ name={lijnbus},
+ category={word},
+ description={bus (Dutch)}
+}
+
+@index{ijsvrij,
+ name={ijsvrij},
+ category={word},
+ description={frost (Dutch)}
+}
+
+@index{dzwon,
+ name={dzwon},
+ category={word},
+ description={bell (Polish)}
+}
+
+@index{dzeta,
+ name={dzéta},
+ category={word},
+ description={the Greek letter zeta (Hungarian)}
+}
diff --git a/Master/texmf-dist/doc/latex/testidx/testidx-glossaries-diglyphs.tex b/Master/texmf-dist/doc/latex/testidx/testidx-glossaries-diglyphs.tex
new file mode 100644
index 00000000000..2b527e8fbfa
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/testidx/testidx-glossaries-diglyphs.tex
@@ -0,0 +1,61 @@
+%%
+%% This is file `testidx-glossaries-diglyphs.tex',
+%% generated with the docstrip utility.
+%%
+%% The original source files were:
+%%
+%% testidx.dtx (with options: `testidx-glossaries-diglyphs.tex,package')
+%%
+%% testidx.dtx
+%% Copyright 2017 Nicola Talbot
+%%
+%% This work may be distributed and/or modified under the
+%% conditions of the LaTeX Project Public License, either version 1.3
+%% of this license or (at your option) any later version.
+%% The latest version of this license is in
+%% http://www.latex-project.org/lppl.txt
+%% and version 1.3 or later is part of all distributions of LaTeX
+%% version 2005/12/01 or later.
+%%
+%% This work has the LPPL maintenance status `maintained'.
+%%
+%% The Current Maintainer of this work is Nicola Talbot.
+%%
+%% This work consists of the files testidx.dtx and testidx.ins and the derived files testidx.sty, testidx-glossaries.sty, testidx-glossaries-diglyphs.tex, testidx-glossaries-nodiglyphs.tex, testidx-glossaries-samples.tex, testidx-glossaries-diglyphs-utf8.bib, testidx-glossaries-markers.bib, testidx-glossaries-mathsym.bib, testidx-glossaries-nodiglyphs-utf8.bib, testidx-glossaries-nodiglyphs.bib, testidx-glossaries-numbers.bib, testidx-glossaries-samples-ascii.bib, testidx-glossaries-samples-utf8.bib, testidx-glossaries-samples.bib.
+%%
+%% \CharacterTable
+%% {Upper-case \A\B\C\D\E\F\G\H\I\J\K\L\M\N\O\P\Q\R\S\T\U\V\W\X\Y\Z
+%% Lower-case \a\b\c\d\e\f\g\h\i\j\k\l\m\n\o\p\q\r\s\t\u\v\w\x\y\z
+%% Digits \0\1\2\3\4\5\6\7\8\9
+%% Exclamation \! Double quote \" Hash (number) \#
+%% Dollar \$ Percent \% Ampersand \&
+%% Acute accent \' Left paren \( Right paren \)
+%% Asterisk \* Plus \+ Comma \,
+%% Minus \- Point \. Solidus \/
+%% Colon \: Semicolon \; Less than \<
+%% Equals \= Greater than \> Question mark \?
+%% Commercial at \@ Left bracket \[ Backslash \\
+%% Right bracket \] Circumflex \^ Underscore \_
+%% Grave accent \` Left brace \{ Vertical bar \|
+%% Right brace \} Tilde \~}
+\tstidxnewutfdigraph{ll}{ll}{ỻ}{a \glshyperlink{digraph} used in
+a number of languages. In Welsh, LL is considered a separate letter
+from L and may be rendered as a ligature Ỻ}
+\tstidxnewutfdigraph{ij}{ij}{ij}{a \glshyperlink{digraph} used in Dutch that's sometimes
+considered
+a separate letter from I and may be rendered as the ligature IJ}
+\tstidxnewutfdigraph{dz}{dz}{dz}{a \glshyperlink{digraph} used in
+a number of languages. In Hungarian, Dz is considered a separate
+letter
+from D and may be rendered as the ligature Dz}
+\tstidxnewutfword{llan}{llan}{ỻan}{commonly used placename element in Brittonic
+languages (such as Welsh) typically indicating parish church}
+\tstidxnewutfword{llama}{llama}{ỻama}{domesticate animal found in the Andes}
+\tstidxnewutfword{lijnbus}{lijnbus}{lijnbus}{bus (Dutch)}
+\tstidxnewutfword{ijsvrij}{ijsvrij}{ijsvrij}{frost (Dutch)}
+\tstidxnewutfword{dzwon}{dzwon}{dzwon}{bell (Polish)}
+\tstidxnewutfword{dzeta}{dz\'eta}{dzéta}{the Greek letter zeta
+(Hungarian)}
+\endinput
+%%
+%% End of file `testidx-glossaries-diglyphs.tex'.
diff --git a/Master/texmf-dist/doc/latex/testidx/testidx-glossaries-markers.bib b/Master/texmf-dist/doc/latex/testidx/testidx-glossaries-markers.bib
new file mode 100644
index 00000000000..b9693ab4553
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/testidx/testidx-glossaries-markers.bib
@@ -0,0 +1,79 @@
+% Encoding: ASCII
+
+@symbol{tstidxmarker,
+ name={\protect\tstidxmarker\space(\protect\tstidxcsfmt{tstidxmarker})},
+ category={indexmarker},
+ description={indicates where the indexing command was used for a
+top-level (level~0) entry}
+}
+
+@symbol{tstidxsubmarker,
+ name={\protect\tstidxsubmarker\space(\protect\tstidxcsfmt{tstidxsubmarker})},
+ category={indexmarker},
+ description={indicates where the indexing
+command was used for a level~1 entry}
+}
+
+@symbol{tstidxsubsubmarker,
+ name={\protect\tstidxsubsubmarker\space(\protect\tstidxcsfmt{tstidxsubsubmarker})},
+ category={indexmarker},
+ description={indicates where the indexing
+command was used for a level~2 entry}
+}
+
+@symbol{tstidxopenmarker,
+ name={\protect\tstidxopenmarker\space(\protect\tstidxcsfmt{tstidxopenmarker})},
+ category={indexmarker},
+ description={indicates where
+the start of a range was indexed for a top-level (level~0) entry}
+}
+
+@symbol{tstidxclosemarker,
+ name={\protect\tstidxclosemarker\space(\protect\tstidxcsfmt{tstidxclosemarker})},
+ category={indexmarker},
+ description={indicates where
+the end of a range was indexed for a top-level (level~0) entry}
+}
+
+@symbol{tstidxopensubmarker,
+ name={\protect\tstidxopensubmarker\space(\protect\tstidxcsfmt{tstidxopensubmarker})},
+ category={indexmarker},
+ description={indicates where
+the start of a range was indexed for a level~1 entry}
+}
+
+@symbol{tstidxclosesubmarker,
+ name={\protect\tstidxclosesubmarker\space(\protect\tstidxcsfmt{tstidxclosesubmarker})},
+ category={indexmarker},
+ description={indicates where
+the end of a range was indexed for a level~1 entry}
+}
+
+@symbol{tstidxopensubsubmarker,
+ name={\protect\tstidxopensubsubmarker\space(\protect\tstidxcsfmt{tstidxopensubsubmarker})},
+ category={indexmarker},
+ description={indicates where
+the start of a range was indexed for a level~2 entry}
+}
+
+@symbol{tstidxclosesubsubmarker,
+ name={\protect\tstidxclosesubsubmarker\space(\protect\tstidxcsfmt{tstidxclosesubsubmarker})},
+ category={indexmarker},
+ description={indicates where
+the end of a range was indexed for a level~2 entry}
+}
+
+@symbol{tstidxseemarker,
+ name={\protect\tstidxseemarker\space(\protect\tstidxcsfmt{tstidxseemarker})},
+ category={indexmarker},
+ description={indicates where the indexing
+command was used to cross-reference a top-level (level~0) entry}
+}
+
+@symbol{tstidxsubseemarker,
+ name={\protect\tstidxsubseemarker\space(\protect\tstidxcsfmt{tstidxsubseemarker})},
+ category={indexmarker},
+ description={indicates where the indexing
+command was used to cross-reference a level~1 entry}
+}
+
diff --git a/Master/texmf-dist/doc/latex/testidx/testidx-glossaries-mathsym.bib b/Master/texmf-dist/doc/latex/testidx/testidx-glossaries-mathsym.bib
new file mode 100644
index 00000000000..099d84a68b0
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/testidx/testidx-glossaries-mathsym.bib
@@ -0,0 +1,44 @@
+% Encoding: ASCII
+
+@symbol{alpha,
+ name={$\alpha$},
+ text={\alpha},
+ category={mathsymbol},
+ description={Greek letter alpha}
+}
+
+@symbol{beta,
+ name={$\beta$},
+ text={\beta},
+ category={mathsymbol},
+ description={Greek letter beta}
+}
+
+@symbol{gamma,
+ name={$\gamma$},
+ text={\gamma},
+ category={mathsymbol},
+ description={Greek letter gamma}
+}
+
+@symbol{sum,
+ name={$\sum$},
+ text={\sum},
+ category={mathsymbol},
+ description={summation}
+}
+
+@symbol{partial,
+ name={$\partial$},
+ text={\partial},
+ category={mathsymbol},
+ description={partial derivative}
+}
+
+@symbol{spinderiv,
+ name={$\eth$},
+ text={\eth},
+ category={mathsymbol},
+ description={spin-weighted partial derivative}
+}
+
diff --git a/Master/texmf-dist/doc/latex/testidx/testidx-glossaries-nodiglyphs-utf8.bib b/Master/texmf-dist/doc/latex/testidx/testidx-glossaries-nodiglyphs-utf8.bib
new file mode 100644
index 00000000000..7d0fc3095ed
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/testidx/testidx-glossaries-nodiglyphs-utf8.bib
@@ -0,0 +1,63 @@
+% Encoding: UTF-8
+
+@index{ll,
+ name={ll},
+ category={digraph},
+ description={a \glshyperlink{digraph} used in
+a number of languages. In Welsh, LL is considered a separate letter
+from L and may be rendered as a ligature}
+}
+
+@index{ij,
+ name={ij},
+ category={digraph},
+ description={a \glshyperlink{digraph} used in Dutch that's sometimes considered
+a separate letter from I and may be rendered as a ligature}
+}
+
+@index{dz,
+ name={dz},
+ category={digraph},
+ description={a \glshyperlink{digraph} used in
+a number of languages. In Hungarian, Dz is considered a separate
+letter
+from D and may be rendered as a ligature}
+}
+
+@index{llan,
+ name={llan},
+ category={word},
+ description={commonly used placename element in Brittonic
+languages (such as Welsh) typically indicating parish church}
+}
+
+@index{llama,
+ name={llama},
+ category={word},
+ description={domesticate animal found in the Andes}
+}
+
+@index{lijnbus,
+ name={lijnbus},
+ category={word},
+ description={bus (Dutch)}
+}
+
+@index{ijsvrij,
+ name={ijsvrij},
+ category={word},
+ description={frost (Dutch)}
+}
+
+@index{dzwon,
+ name={dzwon},
+ category={word},
+ description={bell (Polish)}
+}
+
+@index{dzeta,
+ name={dzéta},
+ category={word},
+ description={the Greek letter zeta (Hungarian)}
+}
+
diff --git a/Master/texmf-dist/doc/latex/testidx/testidx-glossaries-nodiglyphs.bib b/Master/texmf-dist/doc/latex/testidx/testidx-glossaries-nodiglyphs.bib
new file mode 100644
index 00000000000..2621374bd69
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/testidx/testidx-glossaries-nodiglyphs.bib
@@ -0,0 +1,63 @@
+% Encoding: ASCII
+
+@index{ll,
+ name={ll},
+ category={digraph},
+ description={a \glshyperlink{digraph} used in
+a number of languages. In Welsh, LL is considered a separate letter
+from L and may be rendered as a ligature}
+}
+
+@index{ij,
+ name={ij},
+ category={digraph},
+ description={a \glshyperlink{digraph} used in Dutch that's sometimes considered
+a separate letter from I and may be rendered as a ligature}
+}
+
+@index{dz,
+ name={dz},
+ category={digraph},
+ description={a \glshyperlink{digraph} used in
+a number of languages. In Hungarian, Dz is considered a separate
+letter
+from D and may be rendered as a ligature}
+}
+
+@index{llan,
+ name={llan},
+ category={word},
+ description={commonly used placename element in Brittonic
+languages (such as Welsh) typically indicating parish church}
+}
+
+@index{llama,
+ name={llama},
+ category={word},
+ description={domesticate animal found in the Andes}
+}
+
+@index{lijnbus,
+ name={lijnbus},
+ category={word},
+ description={bus (Dutch)}
+}
+
+@index{ijsvrij,
+ name={ijsvrij},
+ category={word},
+ description={frost (Dutch)}
+}
+
+@index{dzwon,
+ name={dzwon},
+ category={word},
+ description={bell (Polish)}
+}
+
+@index{dzeta,
+ name={dz\'eta},
+ category={word},
+ description={the Greek letter zeta (Hungarian)}
+}
+
diff --git a/Master/texmf-dist/doc/latex/testidx/testidx-glossaries-nodiglyphs.tex b/Master/texmf-dist/doc/latex/testidx/testidx-glossaries-nodiglyphs.tex
new file mode 100644
index 00000000000..095662e4226
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/testidx/testidx-glossaries-nodiglyphs.tex
@@ -0,0 +1,61 @@
+%%
+%% This is file `testidx-glossaries-nodiglyphs.tex',
+%% generated with the docstrip utility.
+%%
+%% The original source files were:
+%%
+%% testidx.dtx (with options: `testidx-glossaries-nodiglyphs.tex,package')
+%%
+%% testidx.dtx
+%% Copyright 2017 Nicola Talbot
+%%
+%% This work may be distributed and/or modified under the
+%% conditions of the LaTeX Project Public License, either version 1.3
+%% of this license or (at your option) any later version.
+%% The latest version of this license is in
+%% http://www.latex-project.org/lppl.txt
+%% and version 1.3 or later is part of all distributions of LaTeX
+%% version 2005/12/01 or later.
+%%
+%% This work has the LPPL maintenance status `maintained'.
+%%
+%% The Current Maintainer of this work is Nicola Talbot.
+%%
+%% This work consists of the files testidx.dtx and testidx.ins and the derived files testidx.sty, testidx-glossaries.sty, testidx-glossaries-diglyphs.tex, testidx-glossaries-nodiglyphs.tex, testidx-glossaries-samples.tex, testidx-glossaries-diglyphs-utf8.bib, testidx-glossaries-markers.bib, testidx-glossaries-mathsym.bib, testidx-glossaries-nodiglyphs-utf8.bib, testidx-glossaries-nodiglyphs.bib, testidx-glossaries-numbers.bib, testidx-glossaries-samples-ascii.bib, testidx-glossaries-samples-utf8.bib, testidx-glossaries-samples.bib.
+%%
+%% \CharacterTable
+%% {Upper-case \A\B\C\D\E\F\G\H\I\J\K\L\M\N\O\P\Q\R\S\T\U\V\W\X\Y\Z
+%% Lower-case \a\b\c\d\e\f\g\h\i\j\k\l\m\n\o\p\q\r\s\t\u\v\w\x\y\z
+%% Digits \0\1\2\3\4\5\6\7\8\9
+%% Exclamation \! Double quote \" Hash (number) \#
+%% Dollar \$ Percent \% Ampersand \&
+%% Acute accent \' Left paren \( Right paren \)
+%% Asterisk \* Plus \+ Comma \,
+%% Minus \- Point \. Solidus \/
+%% Colon \: Semicolon \; Less than \<
+%% Equals \= Greater than \> Question mark \?
+%% Commercial at \@ Left bracket \[ Backslash \\
+%% Right bracket \] Circumflex \^ Underscore \_
+%% Grave accent \` Left brace \{ Vertical bar \|
+%% Right brace \} Tilde \~}
+\tstidxnewdigraph{ll}{a \glshyperlink{digraph} used in
+a number of languages. In Welsh, LL is considered a separate letter
+from L and may be rendered as a ligature}
+\tstidxnewdigraph{ij}{a \glshyperlink{digraph} used in Dutch that's sometimes considered
+a separate letter from I and may be rendered as a ligature}
+\tstidxnewdigraph{dz}{a \glshyperlink{digraph} used in
+a number of languages. In Hungarian, Dz is considered a separate
+letter
+from D and may be rendered as a ligature}
+\tstidxnewword{llan}{commonly used placename element in Brittonic
+languages (such as Welsh) typically indicating parish church}
+\tstidxnewword{llama}{domesticate animal found in the Andes}
+\tstidxnewword{lijnbus}{bus (Dutch)}
+\tstidxnewword{ijsvrij}{frost (Dutch)}
+\tstidxnewword{dzwon}{bell (Polish)}
+
+\tstidxnewutfword{dzeta}{dz\'eta}{dzéta}{the Greek letter zeta
+(Hungarian)}
+\endinput
+%%
+%% End of file `testidx-glossaries-nodiglyphs.tex'.
diff --git a/Master/texmf-dist/doc/latex/testidx/testidx-glossaries-numbers.bib b/Master/texmf-dist/doc/latex/testidx/testidx-glossaries-numbers.bib
new file mode 100644
index 00000000000..1974f0004fb
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/testidx/testidx-glossaries-numbers.bib
@@ -0,0 +1,32 @@
+% Encoding: ASCII
+
+@number{42,
+ name={42},
+ category={number},
+ description={forty-two}
+}
+
+@number{10,
+ name={10},
+ category={number},
+ description={ten}
+}
+
+@number{16,
+ name={16},
+ category={number},
+ description={sixteen}
+}
+
+@number{2,
+ name={2},
+ category={number},
+ description={two}
+}
+
+@number{100,
+ name={100},
+ category={number},
+ description={one hundred}
+}
+
diff --git a/Master/texmf-dist/doc/latex/testidx/testidx-glossaries-samples-ascii.bib b/Master/texmf-dist/doc/latex/testidx/testidx-glossaries-samples-ascii.bib
new file mode 100644
index 00000000000..a028327855b
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/testidx/testidx-glossaries-samples-ascii.bib
@@ -0,0 +1,553 @@
+% Encoding: ASCII
+
+@index{dzsoker,
+ name={dzs\'oker},
+ category={word},
+ description={joker (Hungarian)}
+}
+
+@index{czesc,
+ name={cze\'s\'c},
+ category={word},
+ description={hello (Polish)}
+}
+
+@index{elite,
+ name={{\'e}lite},
+ category={word},
+ description={group of people regarded as
+the best of a particular society or organisation}
+}
+
+@index{aesthetic,
+ name={\ae sthetic},
+ category={word},
+ description={concerning beauty}
+}
+
+@index{oesophagus,
+ name={\oe sophagus},
+ category={word},
+ description={part of the alimentary canal}
+}
+
+@index{blase,
+ name={blas\'e},
+ category={word},
+ description={unimpressed or indifferent due to familiarity}
+}
+
+@index{protege,
+ name={prot\'eg\'e},
+ category={word},
+ description={person guided by an older more experienced person}
+}
+
+@index{clientele,
+ name={client\`ele},
+ category={word},
+ description={all the clients of a particular business}
+}
+
+@index{resumee,
+ name={r\'esum\'e},
+ category={word},
+ description={summary of something or curriculum vitae}
+}
+
+@index{soiree,
+ name={soir\'ee},
+ category={word},
+ description={an evening social gathering involving conversation or music}
+}
+
+@index{phoenix,
+ name={ph\oe nix},
+ category={word},
+ description={mythical bird that periodically burned itself and was reborn from the ashes}
+}
+
+@index{decor,
+ name={d\'ecor},
+ category={word},
+ description={the furnishings and decorations of a room}
+}
+
+@index{faerie,
+ name={f\ae rie},
+ category={word},
+ description={fairyland}
+}
+
+@index{facade,
+ name={fa\c{c}ade},
+ category={word},
+ description={the front face of a building}
+}
+
+@index{aethereal,
+ name={\ae thereal},
+ category={word},
+ description={light, airy or tenuous}
+}
+
+@index{debutante,
+ name={d\'ebutante},
+ category={word},
+ description={a young upper-class woman making her first appearance in society}
+}
+
+@index{naive,
+ name={na\"{\i}ve},
+ category={word},
+ description={lacking experience or wisdom}
+}
+
+@index{foetid,
+ name={f\oe tid},
+ category={word},
+ description={smelling very unpleasant}
+}
+
+@index{cliche,
+ name={clich\'e},
+ category={word},
+ description={overused phrase or idea}
+}
+
+@index{deshabille,
+ name={d\'eshabill\'e},
+ category={word},
+ description={the state of being only partially clothed}
+}
+
+@index{negligee,
+ name={n\'eglig\'ee},
+ category={word},
+ description={a woman's very thin dressing gown}
+}
+
+@index{cafe,
+ name={caf\'e},
+ category={word},
+ description={small restaurant that sells light meals}
+}
+
+@index{anaemic,
+ name={an\ae mic},
+ category={word},
+ description={suffering from anaemia}
+}
+
+@index{thornletter,
+ name={\th},
+ category={word},
+ see={thorn},
+ description={thorn}
+}
+
+@index{thorn,
+ name={thorn (\th)},
+ category={word},
+ description={Old English and Icelandic runic letter. In English, eventually replaced by the
+digraph \tstidxqt{th}}
+}
+
+@index{ethletter,
+ name={\dh},
+ category={word},
+ see={ethletter},
+ description={eth}
+}
+
+@index{eth,
+ name={eth (\dh)},
+ category={word},
+ description={Old English letter eventually
+superseded by the digraph \tstidxqt{th}, but still in use in
+some other languages}
+}
+
+@index{Ostergotland,
+ name={{\"O}sterg\"otland},
+ category={place},
+ description={a county in Sweden}
+}
+
+@index{places.Ostergotland,
+ name={{\"O}sterg\"otland},
+ parent={places},
+ category={place},
+ description={a county in Sweden}
+}
+
+@index{Angelholm,
+ name={{\"A}ngelholm},
+ category={place},
+ description={a place in Sweden}
+}
+
+@index{places.Angelholm,
+ name={{\"A}ngelholm},
+ parent={places},
+ category={place},
+ description={a place in Sweden}
+}
+
+@index{Oresund,
+ name={\O resund},
+ category={place},
+ description={a strait which separates Denmark and Sweden}
+}
+
+@index{places.Oresund,
+ name={\O resund},
+ parent={places},
+ category={place},
+ description={a strait which separates Denmark and Sweden}
+}
+
+@index{Tarnby,
+ name={T\r{a}rnby},
+ category={place},
+ description={a town in Denmark}
+}
+
+@index{places.Tarnby,
+ name={T\r{a}rnby},
+ parent={places},
+ category={place},
+ description={a town in Denmark}
+}
+
+@index{Rodovre,
+ name={R\o dovre},
+ category={place},
+ description={a Danish town}
+}
+
+@index{places.Rodovre,
+ name={R\o dovre},
+ parent={places},
+ category={place},
+ description={a Danish town}
+}
+
+@index{Naestved,
+ name={N\ae stved},
+ category={place},
+ description={a Danish town on the island of Zealand}
+}
+
+@index{places.Naestved,
+ name={N\ae stved},
+ parent={places},
+ category={place},
+ description={a Danish town on the island of Zealand}
+}
+
+@index{OlstykkeStenlose,
+ name={\O lstykke-Stenl\o se},
+ category={place},
+ description={a Danish city in North Zealand}
+}
+
+@index{places.OlstykkeStenlose,
+ name={\O lstykke-Stenl\o se},
+ parent={places},
+ category={place},
+ description={a Danish city in North Zealand}
+}
+
+@index{Asslar,
+ name={A\ss lar},
+ category={place},
+ description={German town}
+}
+
+@index{places.Asslar,
+ name={A\ss lar},
+ parent={places},
+ category={place},
+ description={German town}
+}
+
+@index{BadGottleubaBerggiesshubel,
+ name={Bad Gottleuba-Berggie\ss h\"ubel},
+ category={place},
+ description={a town in the Free State of Saxony, Germany}
+}
+
+@index{places.BadGottleubaBerggiesshubel,
+ name={Bad Gottleuba-Berggie\ss h\"ubel},
+ parent={places},
+ category={place},
+ description={a town in the Free State of Saxony, Germany}
+}
+
+@index{Lodz,
+ name={\L\'od\'z},
+ category={place},
+ description={Polish city}
+}
+
+@index{places.Lodz,
+ name={\L\'od\'z},
+ parent={places},
+ category={place},
+ description={Polish city}
+}
+
+@index{Swietokrzyskie,
+ name={{\'S}wi\k{e}tokrzyskie},
+ category={place},
+ description={Polish province}
+}
+
+@index{places.Swietokrzyskie,
+ name={{\'S}wi\k{e}tokrzyskie},
+ parent={places},
+ category={place},
+ description={Polish province}
+}
+
+@index{Zory,
+ name={{\.Z}ory},
+ category={place},
+ description={Polish town and city county}
+}
+
+@index{places.Zory,
+ name={{\.Z}ory},
+ parent={places},
+ category={place},
+ description={Polish town and city county}
+}
+
+@index{Zelechow,
+ name={{\.Z}elech\'ow},
+ category={place},
+ description={Polish town}
+}
+
+@index{places.Zelechow,
+ name={{\.Z}elech\'ow},
+ parent={places},
+ category={place},
+ description={Polish town}
+}
+
+@index{Lobez,
+ name={\L obez},
+ category={place},
+ description={Polish town}
+}
+
+@index{places.Lobez,
+ name={\L obez},
+ parent={places},
+ category={place},
+ description={Polish town}
+}
+
+@index{Glogow,
+ name={G\l og\'ow},
+ category={place},
+ description={Polish town}
+}
+
+@index{places.Glogow,
+ name={G\l og\'ow},
+ parent={places},
+ category={place},
+ description={Polish town}
+}
+
+@index{Cmielow,
+ name={{\'C}miel\'ow},
+ category={place},
+ description={Polish town}
+}
+
+@index{places.Cmielow,
+ name={{\'C}miel\'ow},
+ parent={places},
+ category={place},
+ description={Polish town}
+}
+
+@index{Scinawa,
+ name={{\'S}cinawa},
+ category={place},
+ description={Polish town}
+}
+
+@index{places.Scinawa,
+ name={{\'S}cinawa},
+ parent={places},
+ category={place},
+ description={Polish town}
+}
+
+@index{Swidnica,
+ name={{\'S}widnica},
+ category={place},
+ description={Polish town}
+}
+
+@index{places.Swidnica,
+ name={{\'S}widnica},
+ parent={places},
+ category={place},
+ description={Polish town}
+}
+
+@index{Olvesvatn,
+ name={{\"O}lvesvatn},
+ category={place},
+ description={Icelandic lake}
+}
+
+@index{places.Olvesvatn,
+ name={{\"O}lvesvatn},
+ parent={places},
+ category={place},
+ description={Icelandic lake}
+}
+
+@index{Ulfsvatn,
+ name={{\'U}lfsvatn},
+ category={place},
+ description={Icelandic lake}
+}
+
+@index{places.Ulfsvatn,
+ name={{\'U}lfsvatn},
+ parent={places},
+ category={place},
+ description={Icelandic lake}
+}
+
+@index{Anavatn,
+ name={{\'A}navatn},
+ category={place},
+ description={Icelandic lake}
+}
+
+@index{places.Anavatn,
+ name={{\'A}navatn},
+ parent={places},
+ category={place},
+ description={Icelandic lake}
+}
+
+@index{Masvatn,
+ name={M\'asvatn},
+ category={place},
+ description={Icelandic lake}
+}
+
+@index{places.Masvatn,
+ name={M\'asvatn},
+ parent={places},
+ category={place},
+ description={Icelandic lake}
+}
+
+@index{Thrihyrningsvatn,
+ name={\TH r\'{\i}hyrningsvatn},
+ category={place},
+ description={Icelandic lake}
+}
+
+@index{places.Thrihyrningsvatn,
+ name={\TH r\'{\i}hyrningsvatn},
+ parent={places},
+ category={place},
+ description={Icelandic lake}
+}
+
+@index{Sigridharstadhavatn,
+ name={Sigr\'{\i}\dh arsta\dh avatn},
+ category={place},
+ description={Icelandic lagoon}
+}
+
+@index{places.Sigridharstadhavatn,
+ name={Sigr\'{\i}\dh arsta\dh avatn},
+ parent={places},
+ category={place},
+ description={Icelandic lagoon}
+}
+
+@index{Graenavatn,
+ name={Gr\ae navatn},
+ category={place},
+ description={Icelandic lake}
+}
+
+@index{places.Graenavatn,
+ name={Gr\ae navatn},
+ parent={places},
+ category={place},
+ description={Icelandic lake}
+}
+
+@index{Arneslon,
+ name={{\'A}rnesl\'on},
+ category={place},
+ description={Icelandic lake}
+}
+
+@index{places.Arneslon,
+ name={{\'A}rnesl\'on},
+ parent={places},
+ category={place},
+ description={Icelandic lake}
+}
+
+@index{Isholsvatn,
+ name={{\'I}sh\'olsvatn},
+ category={place},
+ description={Icelandic lake}
+}
+
+@index{places.Isholsvatn,
+ name={{\'I}sh\'olsvatn},
+ parent={places},
+ category={place},
+ description={Icelandic lake}
+}
+
+@index{attachecase,
+ name={attach\'e case},
+ category={phrase},
+ description={small, flat briefcase for carrying documents}
+}
+
+@index{piedaterre,
+ name={pied-\`a-terre},
+ category={phrase},
+ description={small flat or house kept for occasional use}
+}
+
+@index{bergerehat,
+ name={berg\`ere hat},
+ category={phrase},
+ description={a type of wide-brimmed straw hat}
+}
+
+@index{AndersJonasAngstrom,
+ name={\AA ngstr\"om, Anders Jonas},
+ text={Anders Jonas \AA ngstr\"om},
+ category={person},
+ description={Swedish physicist}
+}
+
+@index{people.AndersJonasAngstrom,
+ name={\AA ngstr\"om, Anders Jonas},
+ text={Anders Jonas \AA ngstr\"om},
+ parent={people},
+ category={person},
+ description={Swedish physicist}
+}
diff --git a/Master/texmf-dist/doc/latex/testidx/testidx-glossaries-samples-utf8.bib b/Master/texmf-dist/doc/latex/testidx/testidx-glossaries-samples-utf8.bib
new file mode 100644
index 00000000000..a11ebfc468a
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/testidx/testidx-glossaries-samples-utf8.bib
@@ -0,0 +1,553 @@
+% Encoding: UTF-8
+
+@index{dzsoker,
+ name={dzsóker},
+ category={word},
+ description={joker (Hungarian)}
+}
+
+@index{czesc,
+ name={cześć},
+ category={word},
+ description={hello (Polish)}
+}
+
+@index{elite,
+ name={élite},
+ category={word},
+ description={group of people regarded as
+the best of a particular society or organisation}
+}
+
+@index{aesthetic,
+ name={æsthetic},
+ category={word},
+ description={concerning beauty}
+}
+
+@index{oesophagus,
+ name={œsophagus},
+ category={word},
+ description={part of the alimentary canal}
+}
+
+@index{blase,
+ name={blasé},
+ category={word},
+ description={unimpressed or indifferent due to familiarity}
+}
+
+@index{protege,
+ name={protégé},
+ category={word},
+ description={person guided by an older more experienced person}
+}
+
+@index{clientele,
+ name={clientèle},
+ category={word},
+ description={all the clients of a particular business}
+}
+
+@index{resumee,
+ name={résumé},
+ category={word},
+ description={summary of something or curriculum vitae}
+}
+
+@index{soiree,
+ name={soirée},
+ category={word},
+ description={an evening social gathering involving conversation or music}
+}
+
+@index{phoenix,
+ name={phœnix},
+ category={word},
+ description={mythical bird that periodically burned itself and was reborn from the ashes}
+}
+
+@index{decor,
+ name={décor},
+ category={word},
+ description={the furnishings and decorations of a room}
+}
+
+@index{faerie,
+ name={færie},
+ category={word},
+ description={fairyland}
+}
+
+@index{facade,
+ name={façade},
+ category={word},
+ description={the front face of a building}
+}
+
+@index{aethereal,
+ name={æthereal},
+ category={word},
+ description={light, airy or tenuous}
+}
+
+@index{debutante,
+ name={débutante},
+ category={word},
+ description={a young upper-class woman making her first appearance in society}
+}
+
+@index{naive,
+ name={naïve},
+ category={word},
+ description={lacking experience or wisdom}
+}
+
+@index{foetid,
+ name={fœtid},
+ category={word},
+ description={smelling very unpleasant}
+}
+
+@index{cliche,
+ name={cliché},
+ category={word},
+ description={overused phrase or idea}
+}
+
+@index{deshabille,
+ name={déshabillé},
+ category={word},
+ description={the state of being only partially clothed}
+}
+
+@index{negligee,
+ name={négligée},
+ category={word},
+ description={a woman's very thin dressing gown}
+}
+
+@index{cafe,
+ name={café},
+ category={word},
+ description={small restaurant that sells light meals}
+}
+
+@index{anaemic,
+ name={anæmic},
+ category={word},
+ description={suffering from anaemia}
+}
+
+@index{thornletter,
+ name={þ},
+ category={word},
+ see={thorn},
+ description={thorn}
+}
+
+@index{thorn,
+ name={thorn (þ)},
+ category={word},
+ description={Old English and Icelandic runic letter. In English, eventually replaced by the
+digraph \tstidxqt{th}}
+}
+
+@index{ethletter,
+ name={ð},
+ category={word},
+ see={eth},
+ description={eth}
+}
+
+@index{eth,
+ name={eth (ð)},
+ category={word},
+ description={Old English letter eventually
+superseded by the digraph \tstidxqt{th}, but still in use in
+some other languages}
+}
+
+@index{Ostergotland,
+ name={Östergötland},
+ category={place},
+ description={a county in Sweden}
+}
+
+@index{places.Ostergotland,
+ name={Östergötland},
+ parent={places},
+ category={place},
+ description={a county in Sweden}
+}
+
+@index{Angelholm,
+ name={Ängelholm},
+ category={place},
+ description={a place in Sweden}
+}
+
+@index{places.Angelholm,
+ name={Ängelholm},
+ parent={places},
+ category={place},
+ description={a place in Sweden}
+}
+
+@index{Oresund,
+ name={Øresund},
+ category={place},
+ description={a strait which separates Denmark and Sweden}
+}
+
+@index{places.Oresund,
+ name={Øresund},
+ parent={places},
+ category={place},
+ description={a strait which separates Denmark and Sweden}
+}
+
+@index{Tarnby,
+ name={Tårnby},
+ category={place},
+ description={a town in Denmark}
+}
+
+@index{places.Tarnby,
+ name={Tårnby},
+ parent={places},
+ category={place},
+ description={a town in Denmark}
+}
+
+@index{Rodovre,
+ name={Rødovre},
+ category={place},
+ description={a Danish town}
+}
+
+@index{places.Rodovre,
+ name={Rødovre},
+ parent={places},
+ category={place},
+ description={a Danish town}
+}
+
+@index{Naestved,
+ name={Næstved},
+ category={place},
+ description={a Danish town on the island of Zealand}
+}
+
+@index{places.Naestved,
+ name={Næstved},
+ parent={places},
+ category={place},
+ description={a Danish town on the island of Zealand}
+}
+
+@index{OlstykkeStenlose,
+ name={Ølstykke-Stenløse},
+ category={place},
+ description={a Danish city in North Zealand}
+}
+
+@index{places.OlstykkeStenlose,
+ name={Ølstykke-Stenløse},
+ parent={places},
+ category={place},
+ description={a Danish city in North Zealand}
+}
+
+@index{Asslar,
+ name={Aßlar},
+ category={place},
+ description={German town}
+}
+
+@index{places.Asslar,
+ name={Aßlar},
+ parent={places},
+ category={place},
+ description={German town}
+}
+
+@index{BadGottleubaBerggiesshubel,
+ name={Bad Gottleuba-Berggießhübel},
+ category={place},
+ description={a town in the Free State of Saxony, Germany}
+}
+
+@index{places.BadGottleubaBerggiesshubel,
+ name={Bad Gottleuba-Berggießhübel},
+ parent={places},
+ category={place},
+ description={a town in the Free State of Saxony, Germany}
+}
+
+@index{Lodz,
+ name={Łódź},
+ category={place},
+ description={Polish city}
+}
+
+@index{places.Lodz,
+ name={Łódź},
+ parent={places},
+ category={place},
+ description={Polish city}
+}
+
+@index{Swietokrzyskie,
+ name={Świętokrzyskie},
+ category={place},
+ description={Polish province}
+}
+
+@index{places.Swietokrzyskie,
+ name={Świętokrzyskie},
+ parent={places},
+ category={place},
+ description={Polish province}
+}
+
+@index{Zory,
+ name={Żory},
+ category={place},
+ description={Polish town and city county}
+}
+
+@index{places.Zory,
+ name={Żory},
+ parent={places},
+ category={place},
+ description={Polish town and city county}
+}
+
+@index{Zelechow,
+ name={Żelechów},
+ category={place},
+ description={Polish town}
+}
+
+@index{places.Zelechow,
+ name={Żelechów},
+ parent={places},
+ category={place},
+ description={Polish town}
+}
+
+@index{Lobez,
+ name={Łobez},
+ category={place},
+ description={Polish town}
+}
+
+@index{places.Lobez,
+ name={Łobez},
+ parent={places},
+ category={place},
+ description={Polish town}
+}
+
+@index{Glogow,
+ name={Głogów},
+ category={place},
+ description={Polish town}
+}
+
+@index{places.Glogow,
+ name={Głogów},
+ parent={places},
+ category={place},
+ description={Polish town}
+}
+
+@index{Cmielow,
+ name={Ćmielów},
+ category={place},
+ description={Polish town}
+}
+
+@index{places.Cmielow,
+ name={Ćmielów},
+ parent={places},
+ category={place},
+ description={Polish town}
+}
+
+@index{Scinawa,
+ name={Ścinawa},
+ category={place},
+ description={Polish town}
+}
+
+@index{places.Scinawa,
+ name={Ścinawa},
+ parent={places},
+ category={place},
+ description={Polish town}
+}
+
+@index{Swidnica,
+ name={Świdnica},
+ category={place},
+ description={Polish town}
+}
+
+@index{places.Swidnica,
+ name={Świdnica},
+ parent={places},
+ category={place},
+ description={Polish town}
+}
+
+@index{Olvesvatn,
+ name={Ölvesvatn},
+ category={place},
+ description={Icelandic lake}
+}
+
+@index{places.Olvesvatn,
+ name={Ölvesvatn},
+ parent={places},
+ category={place},
+ description={Icelandic lake}
+}
+
+@index{Ulfsvatn,
+ name={Úlfsvatn},
+ category={place},
+ description={Icelandic lake}
+}
+
+@index{places.Ulfsvatn,
+ name={Úlfsvatn},
+ parent={places},
+ category={place},
+ description={Icelandic lake}
+}
+
+@index{Anavatn,
+ name={Ánavatn},
+ category={place},
+ description={Icelandic lake}
+}
+
+@index{places.Anavatn,
+ name={Ánavatn},
+ parent={places},
+ category={place},
+ description={Icelandic lake}
+}
+
+@index{Masvatn,
+ name={Másvatn},
+ category={place},
+ description={Icelandic lake}
+}
+
+@index{places.Masvatn,
+ name={Másvatn},
+ parent={places},
+ category={place},
+ description={Icelandic lake}
+}
+
+@index{Thrihyrningsvatn,
+ name={Þríhyrningsvatn},
+ category={place},
+ description={Icelandic lake}
+}
+
+@index{places.Thrihyrningsvatn,
+ name={Þríhyrningsvatn},
+ parent={places},
+ category={place},
+ description={Icelandic lake}
+}
+
+@index{Sigridharstadhavatn,
+ name={Sigríðarstaðavatn},
+ category={place},
+ description={Icelandic lagoon}
+}
+
+@index{places.Sigridharstadhavatn,
+ name={Sigríðarstaðavatn},
+ parent={places},
+ category={place},
+ description={Icelandic lagoon}
+}
+
+@index{Graenavatn,
+ name={Grænavatn},
+ category={place},
+ description={Icelandic lake}
+}
+
+@index{places.Graenavatn,
+ name={Grænavatn},
+ parent={places},
+ category={place},
+ description={Icelandic lake}
+}
+
+@index{Arneslon,
+ name={Árneslón},
+ category={place},
+ description={Icelandic lake}
+}
+
+@index{places.Arneslon,
+ name={Árneslón},
+ parent={places},
+ category={place},
+ description={Icelandic lake}
+}
+
+@index{Isholsvatn,
+ name={Íshólsvatn},
+ category={place},
+ description={Icelandic lake}
+}
+
+@index{places.Isholsvatn,
+ name={Íshólsvatn},
+ parent={places},
+ category={place},
+ description={Icelandic lake}
+}
+
+@index{attachecase,
+ name={attaché case},
+ category={phrase},
+ description={small, flat briefcase for carrying documents}
+}
+
+@index{piedaterre,
+ name={pied-à-terre},
+ category={phrase},
+ description={small flat or house kept for occasional use}
+}
+
+@index{bergerehat,
+ name={bergère hat},
+ category={phrase},
+ description={a type of wide-brimmed straw hat}
+}
+
+@index{AndersJonasAngstrom,
+ name={Ångström, Anders Jonas},
+ text={Anders Jonas Ångström},
+ category={person},
+ description={Swedish physicist}
+}
+
+@index{people.AndersJonasAngstrom,
+ name={Ångström, Anders Jonas},
+ text={Anders Jonas Ångström},
+ parent={people},
+ category={person},
+ description={Swedish physicist}
+}
diff --git a/Master/texmf-dist/doc/latex/testidx/testidx-glossaries-samples.bib b/Master/texmf-dist/doc/latex/testidx/testidx-glossaries-samples.bib
new file mode 100644
index 00000000000..4c04aa04b74
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/testidx/testidx-glossaries-samples.bib
@@ -0,0 +1,3111 @@
+% Encoding: ASCII
+
+@index{packages,
+ category={word},
+ description={files provided to adjust the document
+ design or provide new commands}
+}
+
+@index{books,
+ category={word},
+ description={written or printed works}
+}
+
+@index{films,
+ category={word},
+ description={stories recorded by camera}
+}
+
+@index{people,
+ category={word},
+ description={human individuals (or fictional
+ anthropomorphisms)}
+}
+
+@index{places,
+ category={word},
+ description={particular areas or locations}
+}
+
+@index{applications,
+ category={word},
+ description={computer programs}
+}
+
+@index{environments,
+ category={word},
+ description={a marked-up block within the document
+that requires special action or formatting}
+}
+
+@index{attributes,
+ category={word},
+ description={qualities or features that characterise something}
+}
+
+@index{check,
+ category={word},
+ description={make sure something is the case}
+}
+
+@index{chalk,
+ category={word},
+ description={soft limestone substance made into sticks to
+use for writing}
+}
+
+@index{daft,
+ category={word},
+ description={silly or foolish}
+}
+
+@index{parse,
+ category={word},
+ description={divide a sentence into its component parts for
+analysis}
+}
+
+@index{interpret,
+ category={word},
+ description={translate or explain the meaning of}
+}
+
+@index{oak,
+ category={word},
+ description={large tree that produces acorns}
+}
+
+@index{rhubarb,
+ category={word},
+ description={thick reddish or green leaf stalks
+of a plant from the dock family}
+}
+
+@index{rhinoceros,
+ category={word},
+ description={a large plant-eating mammal
+with one or two horns on its nose}
+}
+
+@index{aardvark,
+ category={word},
+ description={an African mammal}
+}
+
+@index{ddisgynedig,
+ category={word},
+ description={descending (Welsh)}
+}
+
+@index{ddyrchafedig,
+ category={word},
+ description={advanced (Welsh)}
+}
+
+@index{ffotograff,
+ category={word},
+ description={photo (Welsh)}
+}
+
+@index{index,
+ category={word},
+ description={an alphabetical list of names, terms or
+ subjects with references to where they occur in the document}
+}
+
+@index{phrase,
+ category={word},
+ description={group of words forming a unit}
+}
+
+@index{glossary,
+ category={word},
+ description={an alphabetical list of words with explanations}
+}
+
+@index{layout,
+ category={word},
+ description={the way something is laid out (for example, on a page)}
+}
+
+@index{filler,
+ category={word},
+ description={something used to fill in gaps or increase bulk}
+}
+
+@index{padding,
+ category={word},
+ description={something used to pad out material to make it
+longer},
+ seealso={filler}
+}
+
+@index{example,
+ category={word},
+ description={thing used to illustrate something}
+}
+
+@index{purpose,
+ category={word},
+ description={the reason for doing something}
+}
+
+@index{whatsit,
+ category={word},
+ description={In \TeX\ terms, a mechanism to allow
+extensions to \TeX, including writing to files or providing
+special instructions to printing devices. More generally,
+a whatsit is an unnamed person or thing}
+}
+
+@index{test,
+ category={word},
+ description={a means of testing something}
+}
+
+@index{design,
+ category={word},
+ description={plan or purpose}
+}
+
+@index{document,
+ category={word},
+ description={a piece of written, printed or electronic
+matter that provides information}
+}
+
+@index{book,
+ category={word},
+ description={written or printed work}
+}
+
+@index{range,
+ category={word},
+ description={area of variation or scope}
+}
+
+@index{word,
+ category={word},
+ description={single unit of language which has meaning}
+}
+
+@index{marker,
+ category={word},
+ description={an identifying symbol}
+}
+
+@index{footnote,
+ category={word},
+ description={additional information written at the bottom of a page}
+}
+
+@index{encap,
+ category={word},
+ description={the format used to encapsulate the location}
+}
+
+@index{text,
+ category={word},
+ description={written or printed or electronically
+represented words}
+}
+
+@index{argument,
+ category={word},
+ description={parameter passed to a command or
+application}
+}
+
+@index{predefined,
+ category={word},
+ description={already defined}
+}
+
+@index{excessive,
+ category={word},
+ description={more than normal or desired}
+}
+
+@index{block,
+ category={word},
+ description={large quantity of things viewed as a unit}
+}
+
+@index{paragraph,
+ category={word},
+ description={block of writing, beginning on a new line}
+}
+
+@index{waffle,
+ category={word},
+ description={speak or write vague or trivial information in a
+lengthy way}
+}
+
+@index{gibberish,
+ category={word},
+ description={meaningless or hard to comprehend speech
+or writing}
+}
+
+@index{gobbledegook,
+ category={word},
+ description={language that is difficult to understand},
+ see={gibberish}
+}
+
+@index{clarify,
+ category={word},
+ description={make it easier to understand}
+}
+
+@index{confidential,
+ category={word},
+ description={private or secret information}
+}
+
+@index{roundabout,
+ category={word},
+ description={not direct}
+}
+
+@index{fashion,
+ category={word},
+ description={a way of doing something}
+}
+
+@index{illustration,
+ category={word},
+ description={an example to explain something},
+ seealso={example}
+}
+
+@index{wit,
+ category={word},
+ description={natural talent for saying or writing things in
+an amusing or clever way}
+}
+
+@index{eloquence,
+ category={word},
+ description={fluent or persuasive speech or writing}
+}
+
+@index{adage,
+ category={word},
+ description={popular saying}
+}
+
+@index{motto,
+ category={word},
+ description={short sentence of phrase expressing a belief
+or aim}
+}
+
+@index{verbiage,
+ category={word},
+ description={excessively length speech or writing}
+}
+
+@index{drivel,
+ category={word},
+ description={nonsense}
+}
+
+@index{tutor,
+ category={word},
+ description={teacher}
+}
+
+@index{grass,
+ category={word},
+ description={in addition to the plant, also slang for
+reporting criminal activity}
+}
+
+@index{distress,
+ category={word},
+ description={cause anxiety}
+}
+
+@index{concordance,
+ category={word},
+ description={an alphabetical list of important words
+used in a document}
+}
+
+@index{ogling,
+ category={word},
+ description={staring at someone in a lecherous manner}
+}
+
+@index{gawping,
+ category={word},
+ description={staring in a rude or stupid manner},
+ see={ogling}
+}
+
+@index{passim,
+ category={word},
+ description={referencing various places in a document}
+}
+
+@index{localisation,
+ category={word},
+ description={place or position}
+}
+
+@index{digraph,
+ category={word},
+ description={two letters representing a single sound}
+}
+
+@index{trigraph,
+ category={word},
+ description={three letters representing a single sound}
+}
+
+@index{lyuk,
+ category={word},
+ description={hole (Hungarian)},
+ seealso={digraph}
+}
+
+@index{dzs,
+ category={trigraph},
+ description={Hungarian \glshyperlink{trigraph} considered a separate letter}
+}
+
+@index{cz,
+ category={digraph},
+ description={digraph in some languages, such as Polish}
+}
+
+@index{dd,
+ category={digraph},
+ description={digraph in some languages, such as Welsh}
+}
+
+@index{ff,
+ category={digraph},
+ description={digraph in some languages, such as Welsh}
+}
+
+@index{ng,
+ category={digraph},
+ description={digraph in some languages, such as Welsh}
+}
+
+@index{ly,
+ category={digraph},
+ description={digraph in some languages, such as Hungarian}
+}
+
+@index{dzsungel,
+ category={word},
+ description={jungle (Hungarian)},
+ seealso={trigraph}
+}
+
+@index{nonsense,
+ category={word},
+ description={something that doesn't make sense}
+}
+
+@index{volauvent,
+ category={word},
+ name={vol-au-vent},
+ description={small round puff pastry containing savoury food}
+}
+
+@index{two,
+ category={word},
+ description={number following one}
+}
+
+@index{sculpture,
+ category={word},
+ description={artwork made of wood, metal or stone}
+}
+
+@index{Venus,
+ category={word},
+ description={Roman goddess (or planet named after her)}
+}
+
+@index{zoo,
+ category={word},
+ description={place containing animals}
+}
+
+@index{alphabet,
+ category={word},
+ description={ordered set of letters used to form words}
+}
+
+@index{resume,
+ category={word},
+ description={continue after an interruption}
+}
+
+@index{fly,
+ category={word},
+ description={travel by air}
+}
+
+@index{aeroplane,
+ category={word},
+ description={fixed wing flying vehicle}
+}
+
+@index{window,
+ category={word},
+ description={opening in wall or window to view out or in}
+}
+
+@index{ogonek,
+ category={word},
+ description={a diacritic hook placed under the lower right
+corner of a vowel}
+}
+
+@index{sail,
+ category={word},
+ description={travel by or navigate a boat}
+}
+
+@index{ship,
+ category={word},
+ description={large boat}
+}
+
+@index{OT1,
+ category={word},
+ description={one of the original font encodings provided with
+\TeX}
+}
+
+@index{UTF8,
+ name={UTF-8},
+ category={word},
+ description={character encoding that uses 8-bit code units}
+}
+
+@index{life,
+ category={word},
+ description={existence}
+}
+
+@index{universe,
+ category={word},
+ description={all existing space and matter}
+}
+
+@index{even,
+ category={word},
+ description={multiple of two}
+}
+
+@index{century,
+ category={word},
+ description={period of 100 years or a score of 100 runs}
+}
+
+@index{cricket,
+ category={word},
+ description={bat and ball game played between two teams
+with eleven players on either side}
+}
+
+@index{calendar,
+ category={word},
+ description={chart or list showing a period of time}
+}
+
+@index{prefix,
+ category={word},
+ description={word or letter placed at the start of another
+word}
+}
+
+@index{gobsmacked,
+ category={word},
+ description={astonished}
+}
+
+@index{astounded,
+ category={word},
+ description={shocked or very surprised}
+}
+
+@index{quaint,
+ category={word},
+ description={old-fashioned or unusual}
+}
+
+@index{yatter,
+ category={word},
+ description={chatter or talk non-stop}
+}
+
+@index{yawn,
+ category={word},
+ description={open one's mouth due to tiredness or boredom}
+}
+
+@index{quirky,
+ category={word},
+ description={peculiar or unexpected habits}
+}
+
+@index{badinage,
+ category={word},
+ description={witty conversation}
+}
+
+@index{expire,
+ category={word},
+ description={come to an end}
+}
+
+@index{story,
+ category={word},
+ description={account or description of imaginary or real
+events}
+}
+
+@index{begin,
+ category={word},
+ description={start something}
+}
+
+@index{forget,
+ category={word},
+ description={fail to remember something}
+}
+
+@index{tale,
+ category={word},
+ description={a story}
+}
+
+@index{adventure,
+ category={word},
+ description={unusual or exciting or daring experience}
+}
+
+@index{derringdo,
+ name={derring-do},
+ category={word},
+ description={heroic action}
+}
+
+@index{hero,
+ category={word},
+ description={principle male character in a story or a person
+admired for their achievements}
+}
+
+@index{title,
+ category={word},
+ description={name of a document or work, or a name that
+describes a position}
+}
+
+@index{knight,
+ category={word},
+ description={a man raised to military rank after service
+as a page or squire, or a man entitled to use \tstidxqt{Sir} before
+his name}
+}
+
+@index{handsome,
+ category={word},
+ description={good-looking}
+}
+
+@index{bold,
+ category={word},
+ description={confident or brave}
+}
+
+@index{brave,
+ category={word},
+ description={prepared to face danger or difficulties}
+}
+
+@index{duck,
+ category={word},
+ description={a waterbird with a blunt bill, short legs and webbed
+feet}
+}
+
+@index{name,
+ category={word},
+ description={word or words by which something is known}
+}
+
+@index{plight,
+ category={word},
+ description={dangerous situation}
+}
+
+@index{land,
+ category={word},
+ description={area of ground}
+}
+
+@index{OgRe,
+ category={word},
+ description={an ogre is a man-eating giant or a terrifying
+person. The silly capitalisation is just a reference to \TeX's
+output routine}
+}
+
+@index{reference,
+ category={word},
+ description={referring to something}
+}
+
+@index{perilous,
+ category={word},
+ description={dangerous or full of risk}
+}
+
+@index{quest,
+ category={word},
+ description={long or difficult search for something}
+}
+
+@index{xor,
+ category={word},
+ description={\LaTeX3 experimental output routine}
+}
+
+@index{continuation,
+ category={word},
+ description={state of continuing}
+}
+
+@index{newcomers,
+ category={word},
+ description={recent arrivals}
+}
+
+@index{nod,
+ category={word},
+ description={in addition to the action of moving one's head
+up and down, also indicates a reference of acknowledgement of
+something}
+}
+
+@index{centre,
+ category={word},
+ description={point in the middle (UK spelling)}
+}
+
+@index{center,
+ category={word},
+ description={point in the middle (US spelling)}
+}
+
+@index{lore,
+ category={word},
+ description={tradition or knowledge of a particular subject}
+}
+
+@index{raft,
+ category={word},
+ description={flat water vessel made from pieces of wood
+tied together}
+}
+
+@index{external,
+ category={word},
+ description={belonging outside of something}
+}
+
+@index{pun,
+ category={word},
+ description={play on words}
+}
+
+@index{joke,
+ category={word},
+ description={something said to amuse others}
+}
+
+@index{witty,
+ category={word},
+ description={having the ability to say clever or
+amusing things}
+}
+
+@index{cameo,
+ category={word},
+ description={small part in a story for a distinguished
+actor}
+}
+
+@index{exclamation,
+ category={word},
+ description={sudden cry}
+}
+
+@index{bog,
+ category={word},
+ description={area of soft, wet, muddy ground}
+}
+
+@index{leviathans,
+ category={word},
+ description={very large, powerful thing (such as a sea
+monster)}
+}
+
+@index{vale,
+ category={word},
+ description={valley}
+}
+
+@index{doom,
+ category={word},
+ description={fate}
+}
+
+@index{chaos,
+ category={word},
+ description={complete confusion or disorder}
+}
+
+@index{butterfly,
+ category={word},
+ description={winged insect}
+}
+
+@index{motif,
+ category={word},
+ description={repeated theme}
+}
+
+@index{sentence,
+ category={word},
+ description={set of words forming a complete statement,
+instruction or question}
+}
+
+@index{conjunction,
+ category={word},
+ description={word used to connect words or clauses}
+}
+
+@index{naughty,
+ category={word},
+ description={badly behaved}
+}
+
+@index{leap,
+ category={word},
+ description={jump far or high across something}
+}
+
+@index{bound,
+ category={word},
+ description={leaping movement}
+}
+
+@index{sword,
+ category={word},
+ description={weapon with a long metal blade}
+}
+
+@index{myriad,
+ category={word},
+ description={countless or a very great number}
+}
+
+@index{clones,
+ category={word},
+ description={identical copy}
+}
+
+@index{repetition,
+ category={word},
+ description={something that's been repeated}
+}
+
+@index{lair,
+ category={word},
+ description={hiding place or den}
+}
+
+@index{roar,
+ category={word},
+ description={loud, deep sound}
+}
+
+@index{peace,
+ category={word},
+ description={freedom from war or anxiety}
+}
+
+@index{harmony,
+ category={word},
+ description={arranged well or peacefully together}
+}
+
+@index{span,
+ category={word},
+ description={length of time or full extent or extend across
+something}
+}
+
+@index{fear,
+ category={word},
+ description={anxiety about something unpleasant}
+}
+
+@index{thrilling,
+ category={word},
+ description={exciting}
+}
+
+@index{quixotic,
+ category={word},
+ description={impractically unselfish and idealist}
+}
+
+@index{seal,
+ category={word},
+ description={seal-dwelling fish-eating mammal with flippers}
+}
+
+@index{sea,
+ category={word},
+ description={large area of salt water}
+}
+
+@index{seaborne,
+ category={word},
+ description={transported or travelling by sea}
+}
+
+@index{zither,
+ category={word},
+ description={a type of stringed musical instrument}
+}
+
+@index{zealous,
+ category={word},
+ description={having great enthusiasm for something}
+}
+
+@index{fan,
+ category={word},
+ description={an admirer of something}
+}
+
+@index{youthful,
+ category={word},
+ description={seeming young}
+}
+
+@index{magic,
+ category={word},
+ description={having the apparent power of supernatural or
+mysterious forces}
+}
+
+@index{magical,
+ category={word},
+ description={relating to or using magic}
+}
+
+@index{yoyo,
+ name={yo-yo},
+ category={word},
+ description={a round toy consisting of two discs and a
+piece of string}
+}
+
+@index{wily,
+ category={word},
+ description={using cunning or crafty methods to gain an
+advantage}
+}
+
+@index{wombat,
+ category={word},
+ description={a type of small marsupial}
+}
+
+@index{warrior,
+ category={word},
+ description={brave or experienced fighter}
+}
+
+@index{laserguided,
+ name={laser-guided},
+ category={word},
+ description={guided by a laser}
+}
+
+@index{villainous,
+ category={word},
+ description={characteristic of a villain}
+}
+
+@index{zany,
+ category={word},
+ description={amusingly unconventional}
+}
+
+@index{zoologist,
+ category={word},
+ description={someone who studies animals}
+}
+
+@index{xebec,
+ category={word},
+ description={a type of small sailing ship}
+}
+
+@index{xenon,
+ category={word},
+ description={a type of inert gas}
+}
+
+@index{xylem,
+ category={word},
+ description={a plant tissue}
+}
+
+@index{xylene,
+ category={word},
+ description={a type of liquid hydrocarbon}
+}
+
+@index{zounds,
+ category={word},
+ description={an exclamation}
+}
+
+@index{Ooh,
+ category={word},
+ description={an exclamation}
+}
+
+@index{zucchini,
+ category={word},
+ description={a type of long, green summer squash (called
+a courgette in British English)}
+}
+
+@index{xylophone,
+ category={word},
+ description={a type of musical instrument}
+}
+
+@index{exhilarating,
+ category={word},
+ description={pleasing or energetic}
+}
+
+@index{yuppie,
+ category={word},
+ description={urban well-paid young middle-class professional}
+}
+
+@index{yoghurt,
+ category={word},
+ description={thick, liquid food made from milk}
+}
+
+@index{yummy,
+ category={word},
+ description={delicious}
+}
+
+@index{yuck,
+ category={word},
+ description={disgusting}
+}
+
+@index{Viking,
+ category={word},
+ description={a member of Scandinavian seafaring people
+between the eighth and eleventh centuries}
+}
+
+@index{vignette,
+ category={word},
+ description={brief episode}
+}
+
+@index{viceroy,
+ category={word},
+ description={a person who governs a colony on behalf of
+the sovereign}
+}
+
+@index{vichyssoise,
+ category={word},
+ description={a type of soup}
+}
+
+@index{viceregal,
+ category={word},
+ description={relating to a viceroy}
+}
+
+@index{quiz,
+ category={word},
+ description={game or competition}
+}
+
+@index{glyph,
+ category={word},
+ description={small graphic symbol}
+}
+
+@index{asleep,
+ category={word},
+ description={in or into a state of sleep}
+}
+
+@index{ashore,
+ category={word},
+ description={to or on shore or land}
+}
+
+@index{aspire,
+ category={word},
+ description={to have strong ambitions to be or do something}
+}
+
+@index{assailed,
+ category={word},
+ description={past tense of assail}
+}
+
+@index{recover,
+ category={word},
+ description={get well again}
+}
+
+@index{reecover,
+ name={re-cover},
+ category={word},
+ description={to cover again}
+}
+
+@index{document.properties,
+ name={properties},
+ parent={document},
+ category={word},
+ description={attributes such as page size}
+}
+
+@index{fontencoding.OT1,
+ name={OT1},
+ parent={fontencoding},
+ category={word},
+ description={one of the original font encodings supplied with \TeX}
+}
+
+@index{hero.intrepid,
+ name={intrepid},
+ parent={hero},
+ category={word},
+ description={a hero known for his boldness and bravery},
+ see={intrepidhero}
+}
+@index{dadorail,
+ name={dado rail},
+ category={phrase},
+ description={waist-high moulding around the wall of a room}
+}
+
+@index{indexingapplication,
+ name={indexing application},
+ category={phrase},
+ description={an application that generates a document index}
+}
+
+@index{visualeffects,
+ name={visual effects},
+ category={phrase},
+ description={use of imagery to create an effect}
+}
+
+@index{dummytext,
+ name={dummy text},
+ category={phrase},
+ description={sample text used for demonstration not
+for its content}
+}
+
+@index{pagebreak,
+ name={page break},
+ category={phrase},
+ description={the point where document text is broken
+across two pages}
+}
+
+@index{linktext,
+ name={link text},
+ category={phrase},
+ description={for the \glshyperlink{glossariespackage}
+package, this refers to the text inserted into the document
+through commands like \glshyperlink{cs.gls}}
+}
+
+@index{crossreference,
+ name={cross-reference},
+ category={phrase},
+ description={reference to another part of the
+document or to a part of another document}
+}
+
+@index{marginalnote,
+ name={marginal note},
+ category={phrase},
+ description={text that's placed in the page margin}
+}
+
+@index{overfulllines,
+ name={overfull lines},
+ category={phrase},
+ description={lines where the text extends into
+the margin because of a formatting failure}
+}
+
+@index{loremipsum,
+ name={lorem ipsum},
+ category={phrase},
+ description={dummy text}
+}
+
+@index{betweenyoumeandthegatepost,
+ name={between you, me and the gatepost},
+ category={phrase},
+ description={an expression
+meaning you're telling someone a secret that shouldn't be passed on
+(common in some British dialects)}
+}
+
+@index{waywithwords,
+ name={way with words},
+ category={phrase},
+ description={have a particular talent with words}
+}
+
+@index{creativewriting,
+ name={creative writing},
+ category={phrase},
+ description={writing typically identified
+by narrative craft, character development and use of literary tropes}
+}
+
+@index{cuttothechase,
+ name={cut to the chase},
+ category={phrase},
+ description={get to the point}
+}
+
+@index{gettothepoint,
+ name={get to the point},
+ category={phrase},
+ description={state something directly}
+}
+
+@index{keepmum,
+ name={keep mum},
+ category={phrase},
+ description={be silent about something},
+ seealso={confidential}
+}
+
+@index{outputroutine,
+ name={output routine},
+ category={phrase},
+ description={\TeX's method of outputting a page}
+}
+
+@index{outofwhack,
+ name={out of whack},
+ category={phrase},
+ description={out of order or not working}
+}
+
+@index{pagedimensions,
+ name={page dimensions},
+ category={phrase},
+ description={the dimensions of a page (such as
+the page width and page height)}
+}
+
+@index{fontfamily,
+ name={font family},
+ category={phrase},
+ description={the name of a font}
+}
+
+@index{fontsize,
+ name={font size},
+ category={phrase},
+ description={the size of a font}
+}
+
+@index{locationlist,
+ name={location list},
+ category={phrase},
+ description={the list of locations used in an index to indicate
+where
+the term being referenced was used in the document},
+ seealso={crossreference}
+}
+
+@index{rangeseparator,
+ name={range separator},
+ category={phrase},
+ description={the symbol
+used between the start and end location to indicate a range},
+ see={locationlist}
+}
+
+@index{pagenumber,
+ name={page number},
+ category={phrase},
+ description={the number identifying a particular page}
+}
+
+@index{multipleencaps,
+ name={multiple encaps},
+ category={phrase},
+ description={a warning issued by
+\glshyperlink{makeindex} when the same page number is indexed
+with different encap values}
+}
+
+@index{inputencoding,
+ name={input encoding},
+ category={phrase},
+ description={the character encoding used
+in the document source code}
+}
+
+@index{fontencoding,
+ name={font encoding},
+ category={phrase},
+ description={the encoding used by the document
+font}
+}
+
+@index{extendedLatincharacters,
+ name={extended Latin characters},
+ category={phrase},
+ description={Latin characters outside the basic ASCII set}
+}
+
+@index{cupoftea,
+ name={cup of tea},
+ category={phrase},
+ description={an expression indicating what one likes
+or is interested in}
+}
+
+@index{whistlestoptour,
+ name={whistle-stop tour},
+ category={phrase},
+ description={a series of short visits to different places}
+}
+
+@index{numbergroup,
+ name={number group},
+ category={phrase},
+ description={a group associated with numbers}
+}
+
+@index{primenumber,
+ name={prime number},
+ category={phrase},
+ description={a number that is only divisible by itself and 1}
+}
+
+@index{holdmybreath,
+ name={hold my breath},
+ category={phrase},
+ description={stop breathing temporarily, also used as an expression to indicate a state of anticipation or
+suspense}
+}
+
+@index{lettergroups,
+ name={letter groups},
+ category={phrase},
+ description={groups associated with letters}
+}
+
+@index{Onceuponatime,
+ name={Once upon a time},
+ category={phrase},
+ description={an expression commonly used at
+the start of fairy tales}
+}
+
+@index{acrossthepond,
+ name={across the pond},
+ category={phrase},
+ description={colloquial expression indicating
+the other side of the Atlantic}
+}
+
+@index{badform,
+ name={bad form},
+ category={phrase},
+ description={an offence against accepted behaviour}
+}
+
+@index{MontyPython,
+ name={Monty Python},
+ category={phrase},
+ description={a British surreal comedy group}
+}
+
+@index{magicincantation,
+ name={magic incantation},
+ category={phrase},
+ description={words used to create a magical effect}
+}
+
+@index{commonknowledge,
+ name={common knowledge},
+ category={phrase},
+ description={something widely known}
+}
+
+@index{intrepidhero,
+ name={intrepid hero},
+ category={phrase},
+ description={a hero known for his boldness and bravery}
+}
+
+@index{sealion,
+ name={sea lion},
+ category={phrase},
+ description={a type of large seal}
+}
+
+@index{sealantgun,
+ name={sealant gun},
+ category={phrase},
+ description={a device used for applying sealant}
+}
+
+@index{zootsuit,
+ name={zoot suit},
+ category={phrase},
+ description={a suit typically having a long loose
+jacket and high-waisted trousers}
+}
+
+@index{anonymousreviewer,
+ name={anonymous reviewer},
+ category={phrase},
+ description={an unnamed reviewer}
+}
+
+@index{yulelog,
+ name={yule log},
+ category={phrase},
+ description={a large log traditionally burnt on
+Christmas Eve or a log-shaped chocolate cake}
+}
+
+@index{vicepresident,
+ name={vice-president},
+ category={phrase},
+ description={a president's deputy}
+}
+
+@index{viceadmiral,
+ name={vice admiral},
+ category={phrase},
+ description={a high rank of naval officer}
+}
+
+@index{Victoriaplum,
+ name={Victoria plum},
+ category={phrase},
+ description={a large, red, dessert plum}
+}
+
+@index{Victoriasponge,
+ name={Victoria sponge},
+ category={phrase},
+ description={a sponge cake consisting of two
+layers with jam filling in between}
+}
+
+@index{viceversa,
+ name={vice versa},
+ category={phrase},
+ description={reversing the order of the items just mentioned}
+}
+
+@index{vicechancellor,
+ name={vice chancellor},
+ category={phrase},
+ description={a deputy chancellor of a
+British university in charge of its administration}
+}
+
+@index{letterordering,
+ name={letter ordering},
+ category={phrase},
+ description={ordering according to the
+individual characters}
+}
+
+@index{wordordering,
+ name={word ordering},
+ category={phrase},
+ description={ordering according to the
+language or locale's definition of words}
+}
+
+@index{commercialworld,
+ name={commercial world, the},
+ text={the commercial world},
+ category={phrase},
+ description={pertaining to commerce}
+}
+
+@index{farawayland,
+ name={far away land, a},
+ text={a far away land},
+ category={phrase},
+ description={somewhere that's far away; a
+term often used in fairy tales}
+}
+
+@index{GoldenArara,
+ name={Golden Arara, the},
+ text={the Golden Arara},
+ category={phrase},
+ description={a made-up item in the dummy text}
+}
+
+@index{MightyHelmofKnuth,
+ name={Mighty Helm of Knuth, the},
+ text={the Mighty Helm of Knuth},
+ category={phrase},
+ description={a made-up item in the dummy text}
+}
+
+@index{LegendarySword,
+ name={Legendary Sword, the},
+ text={the Legendary Sword},
+ category={phrase},
+ description={a made-up item in the dummy text}
+}
+
+@index{BogofEternalGlossaries,
+ name={Bog of Eternal Glossaries, the},
+ text={the Bog of Eternal Glossaries},
+ category={phrase},
+ description={a made-up place in the dummy text}
+}
+
+@index{DreadValeoftheEditors,
+ name={Dread Vale of the Editors, the},
+ text={the Dread Vale of the Editors},
+ category={phrase},
+ description={a made-up place in the dummy text}
+}
+
+@index{butterfliesofchaos,
+ name={butterflies of chaos, the},
+ text={the butterflies of chaos},
+ category={phrase},
+ description={the butterfly effect is a popular method of describing aspects of chaos theory}
+}
+
+@index{End,
+ name={End, The},
+ text={The End},
+ category={phrase},
+ description={denotes the end of a story, especially fairy tales}
+}
+
+@index{locationlist.pageseparator,
+ name={page separator},
+ parent={locationlist},
+ category={phrase},
+ description={symbol used to separate page references}
+}
+
+@index{locationlist.rangeseparator,
+ name={range separator},
+ parent={locationlist},
+ category={phrase},
+ description={symbol used to mark page range references}
+}
+
+@index{motjuste,
+ name={mot juste},
+ description={the most appropriate word}
+}
+
+@index{Poland,
+ name={Poland},
+ category={place},
+ description={an Eastern European country}
+}
+
+@index{places.Poland,
+ name={Poland},
+ parent={places},
+ category={place},
+ description={an Eastern European country}
+}
+
+@index{Glasgow,
+ name={Glasgow},
+ category={place},
+ description={a Scottish city}
+}
+
+@index{places.Glasgow,
+ name={Glasgow},
+ parent={places},
+ category={place},
+ description={a Scottish city}
+}
+
+@index{Iceland,
+ name={Iceland},
+ category={place},
+ description={a Nordic island nation}
+}
+
+@index{places.Iceland,
+ name={Iceland},
+ parent={places},
+ category={place},
+ description={a Nordic island nation}
+}
+
+@index{Nghaerdydd,
+ name={Nghaerdydd},
+ category={place},
+ description={Cardiff}
+}
+
+@index{places.Nghaerdydd,
+ name={Nghaerdydd},
+ parent={places},
+ category={place},
+ description={Cardiff}
+}
+
+@index{Nghymru,
+ name={Nghymru},
+ category={place},
+ description={Wales}
+}
+
+@index{places.Nghymru,
+ name={Nghymru},
+ parent={places},
+ category={place},
+ description={Wales}
+}
+
+@index{Ffestiniog,
+ name={Ffestiniog},
+ category={place},
+ description={a place in Wales}
+}
+
+@index{places.Ffestiniog,
+ name={Ffestiniog},
+ parent={places},
+ category={place},
+ description={a place in Wales}
+}
+
+@index{BogofEternalStench,
+ name={Bog of Eternal Stench, the},
+ text={the Bog of Eternal Stench},
+ category={place},
+ description={place in the film \glshyperlink{Labyrinth}}
+}
+
+@index{places.BogofEternalStench,
+ name={Bog of Eternal Stench, the},
+ text={the Bog of Eternal Stench},
+ parent={places},
+ category={place},
+ description={place in the film \glshyperlink{Labyrinth}}
+}
+
+@index{JamesJoyce,
+ name={Joyce, James},
+ text={James Joyce},
+ category={person},
+ description={an author}
+}
+
+@index{people.JamesJoyce,
+ name={Joyce, James},
+ text={James Joyce},
+ parent={people},
+ category={person},
+ description={an author}
+}
+
+@index{DonaldKnuth,
+ name={Knuth, Donald},
+ text={Donald Knuth},
+ category={person},
+ description={creator of \TeX}
+}
+
+@index{people.DonaldKnuth,
+ name={Knuth, Donald},
+ text={Donald Knuth},
+ parent={people},
+ category={person},
+ description={creator of \TeX}
+}
+
+@index{PauloCereda,
+ name={Cereda, Paulo},
+ text={Paulo Cereda},
+ category={person},
+ description={creator of \glshyperlink{arara}}
+}
+
+@index{people.PauloCereda,
+ name={Cereda, Paulo},
+ text={Paulo Cereda},
+ parent={people},
+ category={person},
+ description={creator of \glshyperlink{arara}}
+}
+
+@index{SirQuackalot,
+ name={Quackalot, Sir},
+ text={Sir Quackalot},
+ category={person},
+ description={fictitious character}
+}
+
+@index{people.SirQuackalot,
+ name={Quackalot, Sir},
+ text={Sir Quackalot},
+ parent={people},
+ category={person},
+ description={fictitious character}
+}
+
+@index{theFairyGoose,
+ name={Fairy Goose, the},
+ text={the Fairy Goose},
+ category={person},
+ description={fictitious character}
+}
+
+@index{people.theFairyGoose,
+ name={Fairy Goose, the},
+ text={the Fairy Goose},
+ parent={people},
+ category={person},
+ description={fictitious character}
+}
+
+@index{DavidCarlisle,
+ name={Carlisle, David},
+ text={David Carlisle},
+ category={person},
+ description={member of the \LaTeX3 team}
+}
+
+@index{people.DavidCarlisle,
+ name={Carlisle, David},
+ text={David Carlisle},
+ parent={people},
+ category={person},
+ description={member of the \LaTeX3 team}
+}
+
+@index{JosephWright,
+ name={Wright, Joseph},
+ text={Joseph Wright},
+ category={person},
+ description={member of the \LaTeX3 team}
+}
+
+@index{people.JosephWright,
+ name={Wright, Joseph},
+ text={Joseph Wright},
+ parent={people},
+ category={person},
+ description={member of the \LaTeX3 team}
+}
+
+@index{Ulysses,
+ name={\tstidxbookfmt{Ulysses}},
+ category={book},
+ description={a modernist novel by James Joyce}
+}
+
+@index{books.Ulysses,
+ name={\tstidxbookfmt{Ulysses}},
+ parent={books},
+ category={book},
+ description={a modernist novel by James Joyce}
+}
+
+@index{SirQuackalotandtheGoldenArara,
+ name={\tstidxbookfmt{Sir Quackalot and the Golden Arara}},
+ category={book},
+ description={a fictitious book}
+}
+
+@index{books.SirQuackalotandtheGoldenArara,
+ name={\tstidxbookfmt{Sir Quackalot and the Golden Arara}},
+ parent={books},
+ category={book},
+ description={a fictitious book}
+}
+
+@index{SirQuackalotandtheHyperLakeofDoom,
+ name={\tstidxbookfmt{Sir Quackalot and the Hyper Lake of Doom}},
+ category={book},
+ description={a fictitious book}
+}
+
+@index{books.SirQuackalotandtheHyperLakeofDoom,
+ name={\tstidxbookfmt{Sir Quackalot and the Hyper Lake of Doom}},
+ parent={books},
+ category={book},
+ description={a fictitious book}
+}
+
+@index{CompactOxfordEnglishDictionary,
+ name={\tstidxbookfmt{Compact Oxford English Dictionary}},
+ category={book},
+ description={a dictionary}
+}
+
+@index{books.CompactOxfordEnglishDictionary,
+ name={\tstidxbookfmt{Compact Oxford English Dictionary}},
+ parent={books},
+ category={book},
+ description={a dictionary}
+}
+
+@index{HitchhikersGuidetotheGalaxy,
+ name={\tstidxbookfmt{Hitchhiker's Guide to the Galaxy, the}},
+ text={\tstidxbookfmt{the Hitchhiker's Guide to the Galaxy}},
+ category={book},
+ description={a comedy series by Douglas Adams, originally created for radio but later
+adapted to book, TV and film}
+}
+
+@index{books.HitchhikersGuidetotheGalaxy,
+ name={\tstidxbookfmt{Hitchhiker's Guide to the Galaxy, the}},
+ text={\tstidxbookfmt{the Hitchhiker's Guide to the Galaxy}},
+ parent={books},
+ category={book},
+ description={a comedy series by Douglas Adams, originally created for radio but later
+adapted to book, TV and film}
+}
+
+@index{AdventuresofSirQuackalot,
+ name={\tstidxbookfmt{Adventures of Sir Quackalot, the}},
+ text={\tstidxbookfmt{the Adventures of Sir Quackalot}},
+ category={book},
+ description={a fictitious book}
+}
+
+@index{books.AdventuresofSirQuackalot,
+ name={\tstidxbookfmt{Adventures of Sir Quackalot, the}},
+ text={\tstidxbookfmt{the Adventures of Sir Quackalot}},
+ parent={books},
+ category={book},
+ description={a fictitious book}
+}
+
+@index{Labyrinth,
+ name={\tstidxfilmfmt{Labyrinth}},
+ category={film},
+ description={a musical fantasy film}
+}
+
+@index{films.Labyrinth,
+ name={\tstidxfilmfmt{Labyrinth}},
+ parent={films},
+ category={film},
+ description={a musical fantasy film}
+}
+
+@index{ThirdMan,
+ name={\tstidxfilmfmt{Third Man, The}},
+ text={\tstidxfilmfmt{The Third Man}},
+ category={film},
+ description={a British film noir}
+}
+
+@index{films.ThirdMan,
+ name={\tstidxfilmfmt{Third Man, The}},
+ text={\tstidxfilmfmt{The Third Man}},
+ parent={films},
+ category={film},
+ description={a British film noir}
+}
+
+@index{TeX,
+ name={\TeX},
+ category={symbol},
+ description={a typesetting system created by Donald Knuth}
+}
+
+@index{fx,
+ name={$f(\vec{x})$},
+ text={f(\vec{x})},
+ category={math},
+ description={a function of $x$}
+}
+
+@index{n,
+ name={$n$},
+ text={n},
+ category={math},
+ description={an integer}
+}
+
+@index{E,
+ name={$E$},
+ text={E},
+ category={math},
+ description={energy}
+}
+
+@index{testidxpackage,
+ name={\tstidxstyfmt{testidx} package},
+ text={\tstidxstyfmt{testidx}},
+ category={package},
+ description={package that produces dummy text for testing
+index styles and indexing applications}
+}
+
+@index{packages.testidxpackage,
+ name={\tstidxstyfmt{testidx}},
+ parent={packages},
+ category={package},
+ description={package that produces dummy text for testing
+index styles and indexing applications}
+}
+
+@index{testidxglossariespackage,
+ name={\tstidxstyfmt{testidx-glossaries} package},
+ text={\tstidxstyfmt{testidx-glossaries}},
+ category={package},
+ description={package that produces dummy text
+for testing glossary styles and indexing applications that integrate
+with the \glshyperlink{glossariespackage} or
+\glshyperlink{glossariesextrapackage} packages}
+}
+
+@index{packages.testidxglossariespackage,
+ name={\tstidxstyfmt{testidx-glossaries}},
+ parent={packages},
+ category={package},
+ description={package that produces dummy text
+for testing glossary styles and indexing applications that integrate
+with the \glshyperlink{glossariespackage} or
+\glshyperlink{glossariesextrapackage} packages}
+}
+
+@index{glossariespackage,
+ name={\tstidxstyfmt{glossaries} package},
+ text={\tstidxstyfmt{glossaries}},
+ category={package},
+ description={a package for creating glossaries or lists
+of terms, symbols or abbreviations}
+}
+
+@index{packages.glossariespackage,
+ name={\tstidxstyfmt{glossaries}},
+ parent={packages},
+ category={package},
+ description={a package for creating glossaries or lists
+of terms, symbols or abbreviations}
+}
+
+@index{glossariesextrapackage,
+ name={\tstidxstyfmt{glossaries-extra} package},
+ text={\tstidxstyfmt{glossaries-extra}},
+ category={package},
+ description={an extension to the \glshyperlink{glossariespackage} package}
+}
+
+@index{packages.glossariesextrapackage,
+ name={\tstidxstyfmt{glossaries-extra}},
+ parent={packages},
+ category={package},
+ description={an extension to the \glshyperlink{glossariespackage} package}
+}
+
+@index{hyperrefpackage,
+ name={\tstidxstyfmt{hyperref} package},
+ text={\tstidxstyfmt{hyperref}},
+ category={package},
+ description={a package that provides extensive support for hypertext}
+}
+
+@index{packages.hyperrefpackage,
+ name={\tstidxstyfmt{hyperref}},
+ parent={packages},
+ category={package},
+ description={a package that provides extensive support for hypertext}
+}
+
+@index{lipsumpackage,
+ name={\tstidxstyfmt{lipsum} package},
+ text={\tstidxstyfmt{lipsum}},
+ category={package},
+ description={a package that generates dummy text}
+}
+
+@index{packages.lipsumpackage,
+ name={\tstidxstyfmt{lipsum}},
+ parent={packages},
+ category={package},
+ description={a package that generates dummy text}
+}
+
+@index{inputencpackage,
+ name={\tstidxstyfmt{inputenc} package},
+ text={\tstidxstyfmt{inputenc}},
+ category={package},
+ description={a package that can be used to identify the document
+encoding}
+}
+
+@index{packages.inputencpackage,
+ name={\tstidxstyfmt{inputenc}},
+ parent={packages},
+ category={package},
+ description={a package that can be used to identify the document
+encoding}
+}
+
+@index{fontencpackage,
+ name={\tstidxstyfmt{fontenc} package},
+ text={\tstidxstyfmt{fontenc}},
+ category={package},
+ description={a package that can be used to set the font
+encoding},
+ seealso={inputencpackage}
+}
+
+@index{packages.fontencpackage,
+ name={\tstidxstyfmt{fontenc}},
+ parent={packages},
+ category={package},
+ description={a package that can be used to set the font encoding}
+}
+
+@index{amsmathpackage,
+ name={\tstidxstyfmt{amsmath} package},
+ text={\tstidxstyfmt{amsmath}},
+ category={package},
+ description={a package that provides AMS mathematical
+facilities}
+}
+
+@index{packages.amsmathpackage,
+ name={\tstidxstyfmt{amsmath}},
+ parent={packages},
+ category={package},
+ description={a package that provides AMS mathematical
+facilities}
+}
+
+@index{amssymbpackage,
+ name={\tstidxstyfmt{amssymb} package},
+ text={\tstidxstyfmt{amssymb}},
+ category={package},
+ description={a package that provides mathematical
+symbols}
+}
+
+@index{packages.amssymbpackage,
+ name={\tstidxstyfmt{amssymb}},
+ parent={packages},
+ category={package},
+ description={a package that provides mathematical
+symbols}
+}
+
+@index{longtablepackage,
+ name={\tstidxstyfmt{longtable} package},
+ text={\tstidxstyfmt{longtable}},
+ category={package},
+ description={a package that allows tables to flow over
+page boundaries}
+}
+
+@index{packages.longtablepackage,
+ name={\tstidxstyfmt{longtable}},
+ parent={packages},
+ category={package},
+ description={a package that allows tables to flow over
+page boundaries}
+}
+
+@index{testidxglossariespackage.extra,
+ name={\tstidxstyoptfmt{extra}},
+ parent={testidxglossariespackage},
+ category={packageoption},
+ description={load the \glshyperlink{glossariesextrapackage} package}
+}
+
+@index{packages.testidxglossariespackage.extra,
+ name={\tstidxstyoptfmt{extra}},
+ parent={packages.testidxglossariespackage},
+ category={packageoption},
+ description={load the \glshyperlink{glossariesextrapackage} package}
+}
+
+@index{testidxglossariespackage.noextra,
+ name={\tstidxstyoptfmt{noextra}},
+ parent={testidxglossariespackage},
+ category={packageoption},
+ description={don't load the \glshyperlink{glossariesextrapackage}
+package (only load \glshyperlink{glossariespackage})}
+}
+
+@index{packages.testidxglossariespackage.noextra,
+ name={\tstidxstyoptfmt{noextra}},
+ parent={packages.testidxglossariespackage},
+ category={packageoption},
+ description={don't load the \glshyperlink{glossariesextrapackage}
+package (only load \glshyperlink{glossariespackage})}
+}
+
+@index{testidxglossariespackage.noseekey,
+ name={\tstidxstyoptfmt{noseekey}},
+ parent={testidxglossariespackage},
+ category={packageoption},
+ description={don't use the \tstidxqt{see} key to implement the cross-referencing (use
+\glshyperlink{cs.glssee} instead)}
+}
+
+@index{packages.testidxglossariespackage.noseekey,
+ name={\tstidxstyoptfmt{noseekey}},
+ parent={packages.testidxglossariespackage},
+ category={packageoption},
+ description={don't use the \tstidxqt{see} key to implement the cross-referencing (use
+\glshyperlink{cs.glssee} instead)}
+}
+
+@index{testidxglossariespackage.seekey,
+ name={\tstidxstyoptfmt{seekey}},
+ parent={testidxglossariespackage},
+ category={packageoption},
+ description={use the \tstidxqt{see} key to implement the cross-referencing}
+}
+
+@index{packages.testidxglossariespackage.seekey,
+ name={\tstidxstyoptfmt{seekey}},
+ parent={packages.testidxglossariespackage},
+ category={packageoption},
+ description={use the \tstidxqt{see} key to implement the cross-referencing}
+}
+
+@index{testidxglossariespackage.xindy,
+ name={\tstidxstyoptfmt{xindy}},
+ parent={testidxglossariespackage},
+ category={packageoption},
+ description={set up the \glshyperlink{glossariespackage} package to use \glshyperlink{xindy}
+as the indexing application}
+}
+
+@index{packages.testidxglossariespackage.xindy,
+ name={\tstidxstyoptfmt{xindy}},
+ parent={packages.testidxglossariespackage},
+ category={packageoption},
+ description={set up the \glshyperlink{glossariespackage} package to use \glshyperlink{xindy}
+as the indexing application}
+}
+
+@index{testidxglossariespackage.tex,
+ name={\tstidxstyoptfmt{tex}},
+ parent={testidxglossariespackage},
+ category={packageoption},
+ description={set up the \glshyperlink{glossariespackage} package to use \TeX\ to
+sort and collate the entries}
+}
+
+@index{packages.testidxglossariespackage.tex,
+ name={\tstidxstyoptfmt{tex}},
+ parent={packages.testidxglossariespackage},
+ category={packageoption},
+ description={set up the \glshyperlink{glossariespackage} package to use \TeX\ to
+sort and collate the entries}
+}
+
+@index{testidxglossariespackage.bib2gls,
+ name={\tstidxstyoptfmt{bib2gls}},
+ parent={testidxglossariespackage},
+ category={packageoption},
+ description={set up the \glshyperlink{glossariesextrapackage} package to use
+\glshyperlink{bib2gls} as the indexing application}
+}
+
+@index{packages.testidxglossariespackage.bib2gls,
+ name={\tstidxstyoptfmt{bib2gls}},
+ parent={packages.testidxglossariespackage},
+ category={packageoption},
+ description={set up the \glshyperlink{glossariesextrapackage} package to use
+\glshyperlink{bib2gls} as the indexing application}
+}
+
+@index{testidxglossariespackage.noglsnumbers,
+ name={\tstidxstyoptfmt{noglsnumbers}},
+ parent={testidxglossariespackage},
+ category={packageoption},
+ description={pass the \tstidxstyoptfmt{glsnumbers=false} option to the
+\glshyperlink{glossariespackage} package}
+}
+
+@index{packages.testidxglossariespackage.noglsnumbers,
+ name={\tstidxstyoptfmt{noglsnumbers}},
+ parent={packages.testidxglossariespackage},
+ category={packageoption},
+ description={pass the \tstidxstyoptfmt{glsnumbers=false} option to the
+\glshyperlink{glossariespackage} package}
+}
+
+@index{testidxglossariespackage.glsnumbers,
+ name={\tstidxstyoptfmt{glsnumbers}},
+ parent={testidxglossariespackage},
+ category={packageoption},
+ description={pass the \tstidxstyoptfmt{glsnumbers=true} option to the
+\glshyperlink{glossariespackage} package}
+}
+
+@index{packages.testidxglossariespackage.glsnumbers,
+ name={\tstidxstyoptfmt{glsnumbers}},
+ parent={packages.testidxglossariespackage},
+ category={packageoption},
+ description={pass the \tstidxstyoptfmt{glsnumbers=true} option to the
+\glshyperlink{glossariespackage} package}
+}
+
+@index{testidxglossariespackage.verbose,
+ name={\tstidxstyoptfmt{verbose}},
+ parent={testidxglossariespackage},
+ category={packageoption},
+ description={write information about the test entries in the transcript file}
+}
+
+@index{packages.testidxglossariespackage.verbose,
+ name={\tstidxstyoptfmt{verbose}},
+ parent={packages.testidxglossariespackage},
+ category={packageoption},
+ description={write information about the test entries in the transcript file}
+}
+
+@index{testidxglossariespackage.noverbose,
+ name={\tstidxstyoptfmt{noverbose}},
+ parent={testidxglossariespackage},
+ category={packageoption},
+ description={don't write information about the test entries in the transcript file}
+}
+
+@index{packages.testidxglossariespackage.noverbose,
+ name={\tstidxstyoptfmt{noverbose}},
+ parent={packages.testidxglossariespackage},
+ category={packageoption},
+ description={don't write information about the test entries in the transcript file}
+}
+
+@index{testidxglossariespackage.desc,
+ name={\tstidxstyoptfmt{desc}},
+ parent={testidxglossariespackage},
+ category={packageoption},
+ description={add descriptions to the dummy entries}
+}
+
+@index{packages.testidxglossariespackage.desc,
+ name={\tstidxstyoptfmt{desc}},
+ parent={packages.testidxglossariespackage},
+ category={packageoption},
+ description={add descriptions to the dummy entries}
+}
+
+@index{testidxpackage.hidemarks,
+ name={\tstidxstyoptfmt{hidemarks}},
+ parent={testidxpackage},
+ category={packageoption},
+ description={hide the marks showing where the indexing is occurring}
+}
+
+@index{packages.testidxpackage.hidemarks,
+ name={\tstidxstyoptfmt{hidemarks}},
+ parent={packages.testidxpackage},
+ category={packageoption},
+ description={hide the marks showing where the indexing is occurring}
+}
+
+@index{testidxpackage.showmarks,
+ name={\tstidxstyoptfmt{showmarks}},
+ parent={testidxpackage},
+ category={packageoption},
+ description={mark where the indexing is occurring}
+}
+
+@index{packages.testidxpackage.showmarks,
+ name={\tstidxstyoptfmt{showmarks}},
+ parent={packages.testidxpackage},
+ category={packageoption},
+ description={mark where the indexing is occurring}
+}
+
+@index{testidxpackage.notestencaps,
+ name={\tstidxstyoptfmt{notestencaps}},
+ parent={testidxpackage},
+ category={packageoption},
+ description={don't use the test encaps}
+}
+
+@index{packages.testidxpackage.notestencaps,
+ name={\tstidxstyoptfmt{notestencaps}},
+ parent={packages.testidxpackage},
+ category={packageoption},
+ description={don't use the test encaps}
+}
+
+@index{testidxpackage.verbose,
+ name={\tstidxstyoptfmt{verbose}},
+ parent={testidxpackage},
+ category={packageoption},
+ description={show the index commands in the document text}
+}
+
+@index{packages.testidxpackage.verbose,
+ name={\tstidxstyoptfmt{verbose}},
+ parent={packages.testidxpackage},
+ category={packageoption},
+ description={show the index commands in the document text}
+}
+
+@index{testidxpackage.noverbose,
+ name={\tstidxstyoptfmt{noverbose}},
+ parent={testidxpackage},
+ category={packageoption},
+ description={don't show the index commands in the document text}
+}
+
+@index{packages.testidxpackage.noverbose,
+ name={\tstidxstyoptfmt{noverbose}},
+ parent={packages.testidxpackage},
+ category={packageoption},
+ description={don't show the index commands in the document text}
+}
+
+@index{testidxpackage.digraphs,
+ name={\tstidxstyoptfmt{digraphs}},
+ parent={testidxpackage},
+ category={packageoption},
+ description={use glyphs instead of the two-character digraphs for certain words}
+}
+
+@index{packages.testidxpackage.digraphs,
+ name={\tstidxstyoptfmt{digraphs}},
+ parent={packages.testidxpackage},
+ category={packageoption},
+ description={use glyphs instead of the two-character digraphs for certain words}
+}
+
+@index{testidxpackage.german,
+ name={\tstidxstyoptfmt{german}},
+ parent={testidxpackage},
+ category={packageoption},
+ description={change the \glshyperlink{makeindex} quote character to allow the
+double-quote character to indicate an umlaut}
+}
+
+@index{packages.testidxpackage.german,
+ name={\tstidxstyoptfmt{german}},
+ parent={packages.testidxpackage},
+ category={packageoption},
+ description={change the \glshyperlink{makeindex} quote character to allow the
+double-quote character to indicate an umlaut}
+}
+
+@index{testidxpackage.ngerman,
+ name={\tstidxstyoptfmt{ngerman}},
+ parent={testidxpackage},
+ category={packageoption},
+ description={change the \glshyperlink{makeindex} quote character to allow the
+double-quote character to indicate an umlaut}
+}
+
+@index{packages.testidxpackage.ngerman,
+ name={\tstidxstyoptfmt{ngerman}},
+ parent={packages.testidxpackage},
+ category={packageoption},
+ description={change the \glshyperlink{makeindex} quote character to allow the
+double-quote character to indicate an umlaut}
+}
+
+@index{testidxpackage.sanitize,
+ name={\tstidxstyoptfmt{sanitize}},
+ parent={testidxpackage},
+ category={packageoption},
+ description={sanitize the sort value before passing it to the indexing command}
+}
+
+@index{packages.testidxpackage.sanitize,
+ name={\tstidxstyoptfmt{sanitize}},
+ parent={packages.testidxpackage},
+ category={packageoption},
+ description={sanitize the sort value before passing it to the indexing command}
+}
+
+@index{testidxglossariespackage.sanitize,
+ name={\tstidxstyoptfmt{sanitize}},
+ parent={testidxglossariespackage},
+ category={packageoption},
+ description={sanitize the sort value}
+}
+
+@index{packages.testidxglossariespackage.sanitize,
+ name={\tstidxstyoptfmt{sanitize}},
+ parent={packages.testidxglossariespackage},
+ category={packageoption},
+ description={sanitize the sort value}
+}
+
+@index{testidxpackage.nosanitize,
+ name={\tstidxstyoptfmt{nosanitize}},
+ parent={testidxpackage},
+ category={packageoption},
+ description={don't sanitize the sort value before passing it to the indexing command}
+}
+
+@index{packages.testidxpackage.nosanitize,
+ name={\tstidxstyoptfmt{nosanitize}},
+ parent={packages.testidxpackage},
+ category={packageoption},
+ description={don't sanitize the sort value before passing it to the indexing command}
+}
+
+@index{testidxglossariespackage.nosanitize,
+ name={\tstidxstyoptfmt{nosanitize}},
+ parent={testidxglossariespackage},
+ category={packageoption},
+ description={don't sanitize the sort value}
+}
+
+@index{packages.testidxglossariespackage.nosanitize,
+ name={\tstidxstyoptfmt{nosanitize}},
+ parent={packages.testidxglossariespackage},
+ category={packageoption},
+ description={don't sanitize the sort value}
+}
+
+@index{testidxpackage.prefix,
+ name={\tstidxstyoptfmt{prefix}},
+ parent={testidxpackage},
+ category={packageoption},
+ description={insert a prefix before the sort value for certain symbols}
+}
+
+@index{packages.testidxpackage.prefix,
+ name={\tstidxstyoptfmt{prefix}},
+ parent={packages.testidxpackage},
+ category={packageoption},
+ description={insert a prefix before the sort value for certain symbols}
+}
+
+@index{testidxpackage.noprefix,
+ name={\tstidxstyoptfmt{noprefix}},
+ parent={testidxpackage},
+ category={packageoption},
+ description={don't insert a prefix before the sort value for certain symbols}
+}
+
+@index{packages.testidxpackage.noprefix,
+ name={\tstidxstyoptfmt{noprefix}},
+ parent={packages.testidxpackage},
+ category={packageoption},
+ description={don't insert a prefix before the sort value for certain symbols}
+}
+
+@index{testidxpackage.nostripaccents,
+ name={\tstidxstyoptfmt{nostripaccents}},
+ parent={testidxpackage},
+ category={packageoption},
+ description={don't strip accent commands from the sort value in
+ASCII mode}
+}
+
+@index{packages.testidxpackage.nostripaccents,
+ name={\tstidxstyoptfmt{nostripaccents}},
+ parent={packages.testidxpackage},
+ category={packageoption},
+ description={don't strip accent commands from the sort value in
+ASCII mode}
+}
+
+@index{testidxpackage.stripaccents,
+ name={\tstidxstyoptfmt{stripaccents}},
+ parent={testidxpackage},
+ category={packageoption},
+ description={strip accent commands from the sort value in
+ASCII mode}
+}
+
+@index{packages.testidxpackage.stripaccents,
+ name={\tstidxstyoptfmt{stripaccents}},
+ parent={packages.testidxpackage},
+ category={packageoption},
+ description={strip accent commands from the sort value in
+ASCII mode}
+}
+
+@index{testidxglossariespackage.nostripaccents,
+ name={\tstidxstyoptfmt{nostripaccents}},
+ parent={testidxglossariespackage},
+ category={packageoption},
+ description={don't strip accent commands from the sort value in
+ASCII mode}
+}
+
+@index{packages.testidxglossariespackage.nostripaccents,
+ name={\tstidxstyoptfmt{nostripaccents}},
+ parent={packages.testidxglossariespackage},
+ category={packageoption},
+ description={don't strip accent commands from the sort value in
+ASCII mode}
+}
+
+@index{testidxglossariespackage.stripaccents,
+ name={\tstidxstyoptfmt{stripaccents}},
+ parent={testidxglossariespackage},
+ category={packageoption},
+ description={strip accent commands from the sort value in
+ASCII mode}
+}
+
+@index{packages.testidxglossariespackage.stripaccents,
+ name={\tstidxstyoptfmt{stripaccents}},
+ parent={packages.testidxglossariespackage},
+ category={packageoption},
+ description={strip accent commands from the sort value in
+ASCII mode}
+}
+
+@index{hyperrefpackage.hidelinks,
+ name={\tstidxstyoptfmt{hidelinks}},
+ parent={hyperrefpackage},
+ category={packageoption},
+ description={don't use a visual effect to show the hyperlinks}
+}
+
+@index{packages.hyperrefpackage.hidelinks,
+ name={\tstidxstyoptfmt{hidelinks}},
+ parent={packages.hyperrefpackage},
+ category={packageoption},
+ description={don't use a visual effect to show the hyperlinks}
+}
+
+@index{fontencpackage.T1,
+ name={\tstidxstyoptfmt{T1}},
+ parent={fontencpackage},
+ category={packageoption},
+ description={set the font encoding to T1}
+}
+
+@index{packages.fontencpackage.T1,
+ name={\tstidxstyoptfmt{T1}},
+ parent={packages.fontencpackage},
+ category={packageoption},
+ description={set the font encoding to T1}
+}
+
+@index{theindexenvironment,
+ name={\tstidxenvfmt{theindex} environment},
+ text={\tstidxenvfmt{theindex}},
+ category={environment},
+ description={environment used to display an index}
+}
+
+@index{alignenvironment,
+ name={\tstidxenvfmt{align} environment},
+ text={\tstidxenvfmt{align}},
+ category={environment},
+ description={environment provided by the
+\glshyperlink{amsmathpackage} package to align equations}
+}
+
+@index{eqnarrayenvironment,
+ name={\tstidxenvfmt{eqnarray} environment},
+ text={\tstidxenvfmt{eqnarray}},
+ category={environment},
+ description={environment provided by the \LaTeX\ kernel to align equations}
+}
+
+@index{bib2gls,
+ name={\tstidxappfmt{bib2gls}},
+ category={application},
+ description={an indexing application designed
+to work with the \glshyperlink{glossariesextrapackage} package}
+}
+
+@index{applications.bib2gls,
+ name={\tstidxappfmt{bib2gls}},
+ parent={applications},
+ category={application},
+ description={an indexing application designed
+to work with the \glshyperlink{glossariesextrapackage} package}
+}
+
+@index{makeindex,
+ name={\tstidxappfmt{makeindex}},
+ category={application},
+ description={an indexing application}
+}
+
+@index{applications.makeindex,
+ name={\tstidxappfmt{makeindex}},
+ parent={applications},
+ category={application},
+ description={an indexing application}
+}
+
+@index{xindy,
+ name={\tstidxappfmt{xindy}},
+ category={application},
+ description={a highly-configurable indexing application with
+localisation support}
+}
+
+@index{applications.xindy,
+ name={\tstidxappfmt{xindy}},
+ parent={applications},
+ category={application},
+ description={a highly-configurable indexing application with
+localisation support}
+}
+
+@index{texdoc,
+ name={\tstidxappfmt{texdoc}},
+ category={application},
+ description={an application for viewing documentation
+installed in a \TeX\ distribution}
+}
+
+@index{applications.texdoc,
+ name={\tstidxappfmt{texdoc}},
+ parent={applications},
+ category={application},
+ description={an application for viewing documentation
+installed in a \TeX\ distribution}
+}
+
+@index{arara,
+ name={\tstidxappfmt{arara}},
+ category={application},
+ description={an automation tool for building documents}
+}
+
+@index{applications.arara,
+ name={\tstidxappfmt{arara}},
+ parent={applications},
+ category={application},
+ description={an automation tool for building documents}
+}
+
+@index{Perl,
+ name={\tstidxappfmt{Perl}},
+ category={application},
+ description={a scripting language}
+}
+
+@index{applications.Perl,
+ name={\tstidxappfmt{Perl}},
+ parent={applications},
+ category={application},
+ description={a scripting language}
+}
+
+@index{makeglossaries,
+ name={\tstidxappfmt{makeglossaries}},
+ category={application},
+ description={a Perl script provided with the
+\glshyperlink{glossariespackage} package that automatically runs
+either \glshyperlink{makeindex} or \glshyperlink{xindy}
+according to the document settings}
+}
+
+@index{applications.makeglossaries,
+ name={\tstidxappfmt{makeglossaries}},
+ parent={applications},
+ category={application},
+ description={a Perl script provided with the
+\glshyperlink{glossariespackage} package that automatically runs
+either \glshyperlink{makeindex} or \glshyperlink{xindy}
+according to the document settings}
+}
+
+@index{makeglossarieslite,
+ name={\tstidxappfmt{makeglossaries-lite}},
+ category={application},
+ description={a light-weight Lua alternative to \glshyperlink{makeglossaries}}
+}
+
+@index{applications.makeglossarieslite,
+ name={\tstidxappfmt{makeglossaries-lite}},
+ parent={applications},
+ category={application},
+ description={a light-weight Lua alternative to \glshyperlink{makeglossaries}}
+}
+
+@index{Emacs,
+ name={\tstidxappfmt{Emacs}},
+ category={application},
+ description={a text editor}
+}
+
+@index{applications.Emacs,
+ name={\tstidxappfmt{Emacs}},
+ parent={applications},
+ category={application},
+ description={a text editor}
+}
+
+@index{Vi,
+ name={\tstidxappfmt{Vi}},
+ category={application},
+ description={a text editor}
+}
+
+@index{applications.Vi,
+ name={\tstidxappfmt{Vi}},
+ parent={applications},
+ category={application},
+ description={a text editor}
+}
+
+@index{xindy.Lswedish,
+ name={\tstidxappoptfmt{-L swedish}},
+ parent={xindy},
+ category={applicationoption},
+ description={use the Swedish language module}
+}
+
+@index{applications.xindy.Lswedish,
+ name={\tstidxappoptfmt{-L swedish}},
+ parent={applications.xindy},
+ category={applicationoption},
+ description={use the Swedish language module}
+}
+
+@index{Lswedish.xindyoption,
+ name={\tstidxappoptfmt{-L swedish} (\tstidxappfmt{xindy})},
+ category={applicationoption},
+ description={use the Swedish language module}
+}
+
+@index{xindy.Ldanish,
+ name={\tstidxappoptfmt{-L danish}},
+ parent={xindy},
+ category={applicationoption},
+ description={use the Danish language module}
+}
+
+@index{applications.xindy.Ldanish,
+ name={\tstidxappoptfmt{-L danish}},
+ parent={applications.xindy},
+ category={applicationoption},
+ description={use the Danish language module}
+}
+
+@index{Ldanish.xindyoption,
+ name={\tstidxappoptfmt{-L danish} (\tstidxappfmt{xindy})},
+ category={applicationoption},
+ description={use the Danish language module}
+}
+
+@index{xindy.Lpolish,
+ name={\tstidxappoptfmt{-L polish}},
+ parent={xindy},
+ category={applicationoption},
+ description={use the Polish language module}
+}
+
+@index{applications.xindy.Lpolish,
+ name={\tstidxappoptfmt{-L polish}},
+ parent={applications.xindy},
+ category={applicationoption},
+ description={use the Polish language module}
+}
+
+@index{Lpolish.xindyoption,
+ name={\tstidxappoptfmt{-L polish} (\tstidxappfmt{xindy})},
+ category={applicationoption},
+ description={use the Polish language module}
+}
+
+@index{xindy.Licelandic,
+ name={\tstidxappoptfmt{-L icelandic}},
+ parent={xindy},
+ category={applicationoption},
+ description={use the Icelandic language module}
+}
+
+@index{applications.xindy.Licelandic,
+ name={\tstidxappoptfmt{-L icelandic}},
+ parent={applications.xindy},
+ category={applicationoption},
+ description={use the Icelandic language module}
+}
+
+@index{Licelandic.xindyoption,
+ name={\tstidxappoptfmt{-L icelandic} (\tstidxappfmt{xindy})},
+ category={applicationoption},
+ description={use the Icelandic language module}
+}
+
+@index{xindy.Lgermanduden,
+ name={\tstidxappoptfmt{-L german-duden}},
+ parent={xindy},
+ category={applicationoption},
+ description={use the German language module with the duden setting}
+}
+
+@index{applications.xindy.Lgermanduden,
+ name={\tstidxappoptfmt{-L german-duden}},
+ parent={applications.xindy},
+ category={applicationoption},
+ description={use the German language module with the duden setting}
+}
+
+@index{Lgermanduden.xindyoption,
+ name={\tstidxappoptfmt{-L german-duden} (\tstidxappfmt{xindy})},
+ category={applicationoption},
+ description={use the German language module with the duden setting}
+}
+
+@index{xindy.Lgermandin5007,
+ name={\tstidxappoptfmt{-L german-din5007}},
+ parent={xindy},
+ category={applicationoption},
+ description={use the German language module with the din5007 setting}
+}
+
+@index{applications.xindy.Lgermandin5007,
+ name={\tstidxappoptfmt{-L german-din5007}},
+ parent={applications.xindy},
+ category={applicationoption},
+ description={use the German language module with the din5007 setting}
+}
+
+@index{Lgermandin5007.xindyoption,
+ name={\tstidxappoptfmt{-L german-din5007} (\tstidxappfmt{xindy})},
+ category={applicationoption},
+ description={use the German language module with the din5007 setting}
+}
+
+@index{xindy.Mord/letorder,
+ name={\tstidxappoptfmt{-M ord/letorder}},
+ parent={xindy},
+ category={applicationoption},
+ description={use the letter ordering module}
+}
+
+@index{applications.xindy.Mord/letorder,
+ name={\tstidxappoptfmt{-M ord/letorder}},
+ parent={applications.xindy},
+ category={applicationoption},
+ description={use the letter ordering module}
+}
+
+@index{Mord/letorder.xindyoption,
+ name={\tstidxappoptfmt{-M ord/letorder} (\tstidxappfmt{xindy})},
+ category={applicationoption},
+ description={use the letter ordering module}
+}
+
+@index{makeindex.g,
+ name={\tstidxappoptfmt{-g}},
+ parent={makeindex},
+ category={applicationoption},
+ description={use the German setting that
+recognises the double-quote character as an umlaut command}
+}
+
+@index{applications.makeindex.g,
+ name={\tstidxappoptfmt{-g}},
+ parent={applications.makeindex},
+ category={applicationoption},
+ description={use the German setting that
+recognises the double-quote character as an umlaut command}
+}
+
+@index{g.makeindexoption,
+ name={\tstidxappoptfmt{-g} (\tstidxappfmt{makeindex})},
+ category={applicationoption},
+ description={use the German setting that
+recognises the double-quote character as an umlaut command}
+}
+
+@index{makeindex.l,
+ name={\tstidxappoptfmt{-l}},
+ parent={makeindex},
+ category={applicationoption},
+ description={use letter ordering}
+}
+
+@index{applications.makeindex.l,
+ name={\tstidxappoptfmt{-l}},
+ parent={applications.makeindex},
+ category={applicationoption},
+ description={use letter ordering}
+}
+
+@index{l.makeindexoption,
+ name={\tstidxappoptfmt{-l} (\tstidxappfmt{makeindex})},
+ category={applicationoption},
+ description={use letter ordering}
+}
+
+@index{tstidxencapi,
+ name={\texttt{tstidxencapi} (\tstidxcsfmt{tstidxencapi})},
+ text={\texttt{tstidxencapi}},
+ category={encapcsn},
+ description={first test encap}
+}
+
+@index{encap.tstidxencapi,
+ name={\texttt{tstidxencapi}},
+ parent={encap},
+ category={encapcsn},
+ description={first test encap}
+}
+
+@index{tstidxencapii,
+ name={\texttt{tstidxencapii} (\tstidxcsfmt{tstidxencapii})},
+ text={\texttt{tstidxencapii}},
+ category={encapcsn},
+ description={second test encap}
+}
+
+@index{encap.tstidxencapii,
+ name={\texttt{tstidxencapii}},
+ parent={encap},
+ category={encapcsn},
+ description={second test encap}
+}
+
+@index{tstidxencapiii,
+ name={\texttt{tstidxencapiii} (\tstidxcsfmt{tstidxencapiii})},
+ text={\texttt{tstidxencapiii}},
+ category={encapcsn},
+ description={third test encap}
+}
+
+@index{encap.tstidxencapiii,
+ name={\texttt{tstidxencapiii}},
+ parent={encap},
+ category={encapcsn},
+ description={third test encap}
+}
+
+@index{cs.index,
+ name={\tstidxcsfmt{index}},
+ category={cs},
+ description={write information to the external index file
+that will be processed by an indexing application (defined by the
+\LaTeX\ kernel)}
+}
+
+@index{cs.testidx,
+ name={\tstidxcsfmt{testidx}},
+ category={cs},
+ description={produce the dummy text (defined in the
+\glshyperlink{testidxpackage} package)}
+}
+
+@index{cs.tstidxtoidx,
+ name={\tstidxcsfmt{tstidxtoidx}},
+ category={cs},
+ description={switch back to the original definitions
+provided by the base \glshyperlink{testidxpackage} package (defined
+in the \glshyperlink{testidxglossariespackage} package)}
+}
+
+@index{cs.gls,
+ name={\tstidxcsfmt{gls}},
+ category={cs},
+ description={reference a term defined by the
+\glshyperlink{glossariespackage} package (displays text and performs
+indexing)}
+}
+
+@index{cs.glspl,
+ name={\tstidxcsfmt{glspl}},
+ category={cs},
+ description={as \glshyperlink{cs.gls} but displays the
+plural form}
+}
+
+@index{cs.glsadd,
+ name={\tstidxcsfmt{glsadd}},
+ category={cs},
+ description={indexes a term defined by the
+\glshyperlink{glossariespackage} package (but doesn't display any
+text)}
+}
+
+@index{cs.glssee,
+ name={\tstidxcsfmt{glssee}},
+ category={cs},
+ description={indexes a cross-referenced term or terms defined by the
+\glshyperlink{glossariespackage} package (but doesn't display any
+text)}
+}
+
+@index{cs.glsxtrindexseealso,
+ name={\tstidxcsfmt{glsxtrindexseealso}},
+ category={cs},
+ description={indexes a \tstidxqt{see also} cross-referenced term
+or terms
+defined by the
+\glshyperlink{glossariesextrapackage} package (but doesn't display
+any text)}
+}
+
+@index{cs.glshyperlink,
+ name={\tstidxcsfmt{glshyperlink}},
+ category={cs},
+ description={displays the text associated with a
+term (with a hyperlink if enabled) but doesn't perform
+any indexing (defined by the \glshyperlink{glossariespackage}
+package)}
+}
+
+@index{cs.setglossarystyle,
+ name={\tstidxcsfmt{setglossarystyle}},
+ category={cs},
+ description={sets the glossary style
+(defined by the \glshyperlink{glossariespackage} package)}
+}
+
+@index{cs.tstidxfootnote,
+ name={\tstidxcsfmt{tstidxfootnote}},
+ category={cs},
+ description={produces a footnote
+(defined by the \glshyperlink{testidxpackage} package)}
+}
+
+@index{cs.footnote,
+ name={\tstidxcsfmt{footnote}},
+ category={cs},
+ description={produces a footnote
+(defined by the \LaTeX\ kernel)}
+}
+
+@index{cs.tstidxtext,
+ name={\tstidxcsfmt{tstidxtext}},
+ category={cs},
+ description={used to mark the sample text being indexed
+(defined by the \glshyperlink{testidxpackage} package)}
+}
+
+@index{cs.textcolor,
+ name={\tstidxcsfmt{textcolor}},
+ category={cs},
+ description={displays the given text in the given colour
+(a colour package is required to enable this command)}
+}
+
+@index{cs.glstreenamefmt,
+ name={\tstidxcsfmt{glstreenamefmt}},
+ category={cs},
+ description={used to set the font for
+the name field in the tree-like glossary styles}
+}
+
+@index{cs.tstindex,
+ name={\tstidxcsfmt{tstindex}},
+ category={cs},
+ description={used to index the sample text
+for the base \glshyperlink{testidxpackage} package (not for the
+\glshyperlink{testidxglossariespackage} package)}
+}
+
+@index{cs.GlsAddXdyAttribute,
+ name={\tstidxcsfmt{GlsAddXdyAttribute}},
+ category={cs},
+ description={adds a \glshyperlink{xindy}
+attribute (provided by the \glshyperlink{glossariespackage} package)}
+}
+
+@index{cs.delimN,
+ name={\tstidxcsfmt{delimN}},
+ category={cs},
+ description={page number separator used in the
+\glshyperlink{locationlist} (provided by the \glshyperlink{glossariespackage} package)}
+}
+
+@index{cs.delimR,
+ name={\tstidxcsfmt{delimR}},
+ category={cs},
+ description={page range separator used in the
+\glshyperlink{locationlist} (provided by the \glshyperlink{glossariespackage} package)}
+}
+
+@index{cs.IeC,
+ name={\tstidxcsfmt{IeC}},
+ category={cs},
+ description={used internally by the \glshyperlink{inputencpackage}
+package}
+}
+
+@index{cs.tstidxindexmarkerprefix,
+ name={\tstidxcsfmt{tstidxindexmarkerprefix}},
+ category={cs},
+ description={prefix used in the
+sort key for markers if the \tstidxstyoptfmt{prefix}
+option is used (but not with the \tstidxstyoptfmt{bib2gls}
+option)}
+}
+
+@index{cs.tstidxindexmathsymprefix,
+ name={\tstidxcsfmt{tstidxindexmathsymprefix}},
+ category={cs},
+ description={prefix used in the
+sort key for mathematical symbols if the \tstidxstyoptfmt{prefix}
+option is used (but not with the \tstidxstyoptfmt{bib2gls}
+option)}
+}
+
+@index{cs.tstidxmakegloss,
+ name={\tstidxcsfmt{tstidxmakegloss}},
+ category={cs},
+ description={command used to load
+the files containing the sample glossary definitions
+and also use the appropriate command to initialise the indexing,
+depending on the package options}
+}
+
diff --git a/Master/texmf-dist/doc/latex/testidx/testidx-glossaries-samples.tex b/Master/texmf-dist/doc/latex/testidx/testidx-glossaries-samples.tex
new file mode 100644
index 00000000000..01e6208ad97
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/testidx/testidx-glossaries-samples.tex
@@ -0,0 +1,801 @@
+%%
+%% This is file `testidx-glossaries-samples.tex',
+%% generated with the docstrip utility.
+%%
+%% The original source files were:
+%%
+%% testidx.dtx (with options: `testidx-glossaries-samples.tex,package')
+%%
+%% testidx.dtx
+%% Copyright 2017 Nicola Talbot
+%%
+%% This work may be distributed and/or modified under the
+%% conditions of the LaTeX Project Public License, either version 1.3
+%% of this license or (at your option) any later version.
+%% The latest version of this license is in
+%% http://www.latex-project.org/lppl.txt
+%% and version 1.3 or later is part of all distributions of LaTeX
+%% version 2005/12/01 or later.
+%%
+%% This work has the LPPL maintenance status `maintained'.
+%%
+%% The Current Maintainer of this work is Nicola Talbot.
+%%
+%% This work consists of the files testidx.dtx and testidx.ins and the derived files testidx.sty, testidx-glossaries.sty, testidx-glossaries-diglyphs.tex, testidx-glossaries-nodiglyphs.tex, testidx-glossaries-samples.tex, testidx-glossaries-diglyphs-utf8.bib, testidx-glossaries-markers.bib, testidx-glossaries-mathsym.bib, testidx-glossaries-nodiglyphs-utf8.bib, testidx-glossaries-nodiglyphs.bib, testidx-glossaries-numbers.bib, testidx-glossaries-samples-ascii.bib, testidx-glossaries-samples-utf8.bib, testidx-glossaries-samples.bib.
+%%
+%% \CharacterTable
+%% {Upper-case \A\B\C\D\E\F\G\H\I\J\K\L\M\N\O\P\Q\R\S\T\U\V\W\X\Y\Z
+%% Lower-case \a\b\c\d\e\f\g\h\i\j\k\l\m\n\o\p\q\r\s\t\u\v\w\x\y\z
+%% Digits \0\1\2\3\4\5\6\7\8\9
+%% Exclamation \! Double quote \" Hash (number) \#
+%% Dollar \$ Percent \% Ampersand \&
+%% Acute accent \' Left paren \( Right paren \)
+%% Asterisk \* Plus \+ Comma \,
+%% Minus \- Point \. Solidus \/
+%% Colon \: Semicolon \; Less than \<
+%% Equals \= Greater than \> Question mark \?
+%% Commercial at \@ Left bracket \[ Backslash \\
+%% Right bracket \] Circumflex \^ Underscore \_
+%% Grave accent \` Left brace \{ Vertical bar \|
+%% Right brace \} Tilde \~}
+\tstidxnewword{packages}{files provided to adjust the document
+design or provide new commands}
+\tstidxnewword{books}{written or printed works}
+\tstidxnewword{films}{stories recorded by camera}
+\tstidxnewword{people}{human individuals (or fictional
+anthropomorphisms)}
+\tstidxnewword{places}{particular areas or locations}
+\tstidxnewword{applications}{computer programs}
+\tstidxnewword{environments}{a marked-up block within the document
+that requires special action or formatting}
+\tstidxnewword{attributes}{qualities or features that characterise
+something}
+\tstidxnewword{parse}{divide a sentence into its component parts for
+analysis}
+\tstidxnewword{interpret}{translate or explain the meaning of}
+\tstidxnewword{oak}{large tree that produces acorns}
+\tstidxnewword{daft}{silly or foolish}
+\tstidxnewword{rhubarb}{thick reddish or green leaf stalks
+of a plant from the dock family}
+\tstidxnewword{rhinoceros}{a large plant-eating mammal
+with one or two horns on its nose}
+\tstidxnewword{aardvark}{an African mammal}
+\tstidxnewword{check}{make sure something is the case}
+\tstidxnewword{chalk}{soft limestone substance made into sticks to
+use for writing}
+\tstidxnewword{index}{an alphabetical list of names, terms or
+subjects with references to where they occur in the document}
+\tstidxnewword{phrase}{group of words forming a unit}
+\tstidxnewword{glossary}{an alphabetical list of words with
+explanations}
+\tstidxnewword{layout}{the way something is laid out (for example,
+on a page)}
+\tstidxnewword{filler}{something used to fill in gaps or increase bulk}
+\tstidxnewwordseealso{padding}{something used
+to pad out material to make it longer}{filler}
+\tstidxnewword{example}{thing used to illustrate something}
+\tstidxnewword{purpose}{the reason for doing something}
+\tstidxnewword{whatsit}{In \TeX\ terms, a mechanism to allow
+extensions to \TeX, including writing to files or providing
+special instructions to printing devices. More generally,
+a whatsit is an unnamed person or thing}
+\tstidxnewword{test}{a means of testing something}
+\tstidxnewword{design}{plan or purpose}
+\tstidxnewword{document}{a piece of written, printed or electronic
+matter that provides information}
+\tstidxnewword{book}{written or printed work}
+\tstidxnewword{range}{area of variation or scope}
+\tstidxnewword{word}{single unit of language which has meaning}
+\tstidxnewword{marker}{an identifying symbol}
+\tstidxnewword{footnote}{additional information written at the
+bottom of a page}
+\tstidxnewword{encap}{the format used to encapsulate the location}
+\tstidxnewword{text}{written or printed or electronically
+represented words}
+\tstidxnewword{argument}{parameter passed to a command or
+application}
+\tstidxnewword{predefined}{already defined}
+\tstidxnewword{excessive}{more than normal or desired}
+\tstidxnewword{block}{large quantity of things viewed as a unit}
+\tstidxnewword{paragraph}{block of writing, beginning on a new line}
+\tstidxnewword{waffle}{speak or write vague or trivial information in a lengthy way}
+\tstidxnewword{gibberish}{meaningless or hard to comprehend speech
+or writing}
+\tstidxnewwordsee{gobbledegook}{language that is
+difficult to understand}{gibberish}
+\tstidxnewword{clarify}{make it easier to understand}
+\tstidxnewword{confidential}{private or secret information}
+\tstidxnewword{roundabout}{not direct}
+\tstidxnewword{fashion}{a way of doing something}
+\tstidxnewwordseealso{illustration}{an example to explain something}{example}
+\tstidxnewword{wit}{natural talent for saying or writing things in
+an amusing or clever way}
+\tstidxnewword{eloquence}{fluent or persuasive speech or writing}
+\tstidxnewword{adage}{popular saying}
+\tstidxnewword{motto}{short sentence of phrase expressing a belief
+or aim}
+\tstidxnewword{verbiage}{excessively length speech or writing}
+\tstidxnewword{drivel}{nonsense}
+\tstidxnewword{tutor}{teacher}
+\tstidxnewword{grass}{in addition to the plant, also slang for
+reporting criminal activity}
+\tstidxnewword{distress}{cause anxiety}
+\tstidxnewword{concordance}{an alphabetical list of important words
+used in a document}
+\tstidxnewword{ogling}{staring at someone in a lecherous manner}
+\tstidxnewwordsee{gawping}{staring in a rude or stupid manner}{ogling}
+\tstidxnewword{passim}{referencing various places in a document}
+\tstidxnewword{localisation}{place or position}
+\tstidxnewword{digraph}{two letters representing a single sound}
+\tstidxnewword{trigraph}{three letters representing a single sound}
+\tstidxnewwordseealso{lyuk}{hole (Hungarian)}{digraph}
+\tstidxnewwordseealso{dzsungel}{jungle (Hungarian)}{trigraph}
+\tstidxnewword{nonsense}{something that doesn't make sense}
+\tstidxnewword{vol-au-vent}{small round puff pastry containing
+savoury food}
+\tstidxnewword{two}{number following one}
+\tstidxnewword{sculpture}{artwork made of wood, metal or stone}
+\tstidxnewword{Venus}{Roman goddess (or planet named after her)}
+\tstidxnewword{zoo}{place containing animals}
+\tstidxnewword{alphabet}{ordered set of letters used to form words}
+\tstidxnewword{resume}{continue after an interruption}
+\tstidxnewword{fly}{travel by air}
+\tstidxnewword{aeroplane}{fixed wing flying vehicle}
+\tstidxnewword{window}{opening in wall or window to view out or in}
+\tstidxnewword{ogonek}{a diacritic hook placed under the lower right
+corner of a vowel}
+\tstidxnewword{sail}{travel by or navigate a boat}
+\tstidxnewword{ship}{large boat}
+\tstidxnewword{OT1}{one of the original font encodings provided with
+\TeX}
+\tstidxnewword{UTF-8}{character encoding that uses 8-bit code units}
+\tstidxnewword{life}{existence}
+\tstidxnewword{universe}{all existing space and matter}
+\tstidxnewword{even}{multiple of two}
+\tstidxnewword{century}{period of 100 years or a score of 100 runs}
+\tstidxnewword{cricket}{bat and ball game played between two teams
+with eleven players on either side}
+\tstidxnewword{calendar}{chart or list showing a period of time}
+\tstidxnewword{prefix}{word or letter placed at the start of another
+word}
+\tstidxnewword{gobsmacked}{astonished}
+\tstidxnewword{astounded}{shocked or very surprised}
+\tstidxnewword{quaint}{old-fashioned or unusual}
+\tstidxnewword{yatter}{chatter or talk non-stop}
+\tstidxnewword{yawn}{open one's mouth due to tiredness or boredom}
+\tstidxnewword{quirky}{peculiar or unexpected habits}
+\tstidxnewword{badinage}{witty conversation}
+\tstidxnewword{expire}{come to an end}
+\tstidxnewword{story}{account or description of imaginary or real
+events}
+\tstidxnewword{begin}{start something}
+\tstidxnewword{forget}{fail to remember something}
+\tstidxnewword{tale}{a story}
+\tstidxnewword{adventure}{unusual or exciting or daring experience}
+\tstidxnewword{derring-do}{heroic action}
+\tstidxnewword{hero}{principle male character in a story or a person
+admired for their achievements}
+\tstidxnewword{title}{name of a document or work, or a name that
+describes a position}
+\tstidxnewword{knight}{a man raised to military rank after service
+as a page or squire, or a man entitled to use \tstidxqt{Sir} before
+his name}
+\tstidxnewword{handsome}{good-looking}
+\tstidxnewword{bold}{confident or brave}
+\tstidxnewword{brave}{prepared to face danger or difficulties}
+\tstidxnewword{duck}{a waterbird with a blunt bill, short legs and webbed feet}
+\tstidxnewword{name}{word or words by which something is known}
+\tstidxnewword{plight}{dangerous situation}
+\tstidxnewword{land}{area of ground}
+\tstidxnewword{OgRe}{an ogre is a man-eating giant or a terrifying
+person. The silly capitalisation is just a reference to \TeX's output
+routine}
+\tstidxnewword{reference}{referring to something}
+\tstidxnewword{perilous}{dangerous or full of risk}
+\tstidxnewword{quest}{long or difficult search for something}
+\tstidxnewword{xor}{\LaTeX3 experimental output routine}
+\tstidxnewword{continuation}{state of continuing}
+\tstidxnewword{newcomers}{recent arrivals}
+\tstidxnewword{nod}{in addition to the action of moving one's head
+up and down, also indicates a reference of acknowledgement of
+something}
+\tstidxnewword{centre}{point in the middle (UK spelling)}
+\tstidxnewword{center}{point in the middle (US spelling)}
+\tstidxnewword{lore}{tradition or knowledge of a particular subject}
+\tstidxnewword{raft}{flat water vessel made from pieces of wood
+tied together}
+\tstidxnewword{external}{belonging outside of something}
+\tstidxnewword{pun}{play on words}
+\tstidxnewword{joke}{something said to amuse others}
+\tstidxnewword{witty}{having the ability to say clever or
+amusing things}
+\tstidxnewword{cameo}{small part in a story for a distinguished
+actor}
+\tstidxnewword{exclamation}{sudden cry}
+\tstidxnewword{bog}{area of soft, wet, muddy ground}
+\tstidxnewword{leviathans}{very large, powerful thing (such as a sea
+monster)}
+\tstidxnewword{vale}{valley}
+\tstidxnewword{doom}{fate}
+\tstidxnewword{chaos}{complete confusion or disorder}
+\tstidxnewword{butterfly}{winged insect}
+\tstidxnewword{motif}{repeated theme}
+\tstidxnewword{sentence}{set of words forming a complete statement,
+instruction or question}
+\tstidxnewword{conjunction}{word used to connect words or clauses}
+\tstidxnewword{naughty}{badly behaved}
+\tstidxnewword{leap}{jump far or high across something}
+\tstidxnewword{bound}{leaping movement}
+\tstidxnewword{sword}{weapon with a long metal blade}
+\tstidxnewword{myriad}{countless or a very great number}
+\tstidxnewword{clones}{identical copy}
+\tstidxnewword{repetition}{something that's been repeated}
+\tstidxnewword{lair}{hiding place or den}
+\tstidxnewword{roar}{loud, deep sound}
+\tstidxnewword{peace}{freedom from war or anxiety}
+\tstidxnewword{harmony}{arranged well or peacefully together}
+\tstidxnewword{span}{length of time or full extent or extend across
+something}
+\tstidxnewword{fear}{anxiety about something unpleasant}
+\tstidxnewword{thrilling}{exciting}
+\tstidxnewword{quixotic}{impractically unselfish and idealist}
+\tstidxnewword{sea}{large area of salt water}
+\tstidxnewword{seal}{seal-dwelling fish-eating mammal with flippers}
+\tstidxnewword{seaborne}{transported or travelling by sea}
+\tstidxnewword{zither}{a type of stringed musical instrument}
+\tstidxnewword{zealous}{having great enthusiasm for something}
+\tstidxnewword{fan}{an admirer of something}
+\tstidxnewword{youthful}{seeming young}
+\tstidxnewword{magic}{having the apparent power of supernatural or
+mysterious forces}
+\tstidxnewword{magical}{relating to or using magic}
+\tstidxnewword{yo-yo}{a round toy consisting of two discs and a
+piece of string}
+\tstidxnewword{wily}{using cunning or crafty methods to gain an
+advantage}
+\tstidxnewword{wombat}{a type of small marsupial}
+\tstidxnewword{warrior}{brave or experienced fighter}
+\tstidxnewword{laser-guided}{guided by a laser}
+\tstidxnewword{villainous}{characteristic of a villain}
+\tstidxnewword{zany}{amusingly unconventional}
+\tstidxnewword{zoologist}{someone who studies animals}
+\tstidxnewword{xebec}{a type of small sailing ship}
+\tstidxnewword{xenon}{a type of inert gas}
+\tstidxnewword{xylem}{a plant tissue}
+\tstidxnewword{xylene}{a type of liquid hydrocarbon}
+\tstidxnewword{zounds}{an exclamation}
+\tstidxnewword{Ooh}{an exclamation}
+\tstidxnewword{zucchini}{a type of long, green summer squash (called
+a courgette in British English)}
+\tstidxnewword{xylophone}{a type of musical instrument}
+\tstidxnewword{exhilarating}{pleasing or energetic}
+\tstidxnewword{yuppie}{urban well-paid young middle-class professional}
+\tstidxnewword{yoghurt}{thick, liquid food made from milk}
+\tstidxnewword{yummy}{delicious}
+\tstidxnewword{yuck}{disgusting}
+\tstidxnewword{Viking}{a member of Scandinavian seafaring people
+between the eighth and eleventh centuries}
+\tstidxnewword{vignette}{brief episode}
+\tstidxnewword{viceroy}{a person who governs a colony on behalf of
+the sovereign}
+\tstidxnewword{vichyssoise}{a type of soup}
+\tstidxnewword{viceregal}{relating to a viceroy}
+\tstidxnewword{quiz}{game or competition}
+\tstidxnewword{glyph}{small graphic symbol}
+\tstidxnewword{asleep}{in or into a state of sleep}
+\tstidxnewword{ashore}{to or on shore or land}
+\tstidxnewword{aspire}{to have strong ambitions to be or do something}
+\tstidxnewword{assailed}{past tense of assail}
+\tstidxnewword{recover}{get well again}
+\tstidxnewword[name={re-cover}]{reecover}{to cover again}
+\tstidxnewdigraph{cz}{digraph in some languages, such as Polish}
+\tstidxnewdigraph{dd}{digraph in some languages, such as Welsh}
+\tstidxnewdigraph{ff}{digraph in some languages, such as Welsh}
+\tstidxnewdigraph{ng}{digraph in some languages, such as Welsh}
+\tstidxnewdigraph{ly}{digraph in some languages, such as Hungarian}
+\tstidxnewtrigraph{dzs}{Hungarian \glshyperlink{trigraph} considered a separate letter}
+\tstidxnewword{ddisgynedig}{descending (Welsh)}
+\tstidxnewword{ddyrchafedig}{advanced (Welsh)}
+\tstidxnewword{ffotograff}{photo (Welsh)}
+
+\tstidxnewutfword{dzsoker}{dzs\'oker}{dzsóker}{joker (Hungarian)}
+\tstidxnewutfword{czesc}{cze\'s\'c}{cześć}{hello (Polish)}
+\tstidxnewutfword{elite}{\'elite}{élite}{group of people regarded as
+the best of a particular society or organisation}
+\tstidxnewutfword{aesthetic}{\ae sthetic}{æsthetic}{concerning
+beauty}
+\tstidxnewutfword{blase}{blas\'e}{blasé}{unimpressed or indifferent
+due to familiarity}
+\tstidxnewutfword{protege}{prot\'eg\'e}{protégé}{person guided by an
+older more experienced person}
+\tstidxnewutfword{clientele}{client\`ele}{clientèle}{all the clients
+of a particular business}
+\tstidxnewutfword{resumee}{r\'esum\'e}{résumé}{summary of something
+or curriculum vitae}
+\tstidxnewutfword{soiree}{soir\'ee}{soirée}{an evening social
+gathering involving conversation or music}
+\tstidxnewutfword{phoenix}{ph\oe nix}{phœnix}{mythical bird that
+periodically burned itself and was reborn from the ashes}
+\tstidxnewutfword{decor}{d\'ecor}{décor}{the furnishings and
+decorations of a room}
+\tstidxnewutfword{faerie}{f\ae rie}{færie}{fairyland}
+\tstidxnewutfword{facade}{fa\c{c}ade}{façade}{the front face of a
+building}
+\tstidxnewutfword{aethereal}{\ae thereal}{æthereal}{light, airy or
+tenuous}
+\tstidxnewutfword{debutante}{d\'ebutante}{débutante}{a young
+upper-class woman making her first appearance in society}
+\tstidxnewutfword{naive}{na\"{\i}ve}{naïve}{lacking experience or
+wisdom}
+\tstidxnewutfword{foetid}{f\oe tid}{fœtid}{smelling very unpleasant}
+\tstidxnewutfword{cliche}{clich\'e}{cliché}{overused phrase or idea}
+\tstidxnewutfword{deshabille}{d\'eshabill\'e}{déshabillé}{the state
+of being only partially clothed}
+\tstidxnewutfword{negligee}{n\'eglig\'ee}{négligée}{a woman's very
+thin dressing gown}
+\tstidxnewutfword{cafe}{caf\'e}{café}{small restaurant that sells
+light meals}
+\tstidxnewutfword{anaemic}{an\ae mic}{anæmic}{suffering from anaemia}
+
+\tstidxnewutfwordsee{thornletter}{\th}{þ}{thorn}{thorn}
+\tstidxnewutfwordsee{ethletter}{\dh}{ð}{eth}{eth}
+\tstidxnewutfword{thorn}{thorn (\th)}{thorn (þ)}{Old English and
+Icelandic runic letter. In English, eventually replaced by the
+digraph \tstidxqt{th}}
+\tstidxnewutfword{eth}{eth (\dh)}{eth (ð)}{Old English letter eventually
+superseded by the digraph \tstidxqt{th}, but still in use in
+some other languages}
+\tstidxnewutfword{oesophagus}{\oe sophagus}{œsophagus}{part of the
+alimentary canal}
+\tstidxnewplace{Poland}{an Eastern European country}
+\tstidxnewplace{Glasgow}{a Scottish city}
+\tstidxnewplace{Iceland}{a Nordic island nation}
+\tstidxnewplace{Nghaerdydd}{Cardiff}
+\tstidxnewplace{Nghymru}{Wales}
+\tstidxnewplace{Ffestiniog}{a place in Wales}
+\tstidxnewutfplace{Ostergotland}{\"Osterg\"otland}{Östergötland}{a
+county in Sweden}
+\tstidxnewutfplace{Angelholm}{\"Angelholm}{Ängelholm}{a place in
+Sweden}
+\tstidxnewutfplace{Oresund}{\O resund}{Øresund}{a strait which
+separates Denmark and Sweden}
+\tstidxnewutfplace{Tarnby}{T\r{a}rnby}{Tårnby}{a town in Denmark}
+\tstidxnewutfplace{Rodovre}{R\o dovre}{Rødovre}{a Danish town}
+\tstidxnewutfplace{Naestved}{N\ae stved}{Næstved}{a Danish town on
+the island of Zealand}
+\tstidxnewutfplace{OlstykkeStenlose}{\O lstykke-Stenl\o se}%
+{Ølstykke-Stenløse}{a Danish city in North Zealand}
+\tstidxnewutfplace{Asslar}{A\ss lar}{Aßlar}{German town}
+\tstidxnewutfplace{BadGottleubaBerggiesshubel}%
+{Bad Gottleuba-Berggie\ss h\"ubel}{Bad Gottleuba-Berggießhübel}%
+{a town in the Free State of Saxony, Germany}
+\tstidxnewutfplace{Lodz}{\L\'od\'z}{Łódź}{Polish city}
+\tstidxnewutfplace{Swietokrzyskie}{\'Swi\k{e}tokrzyskie}%
+{Świętokrzyskie}{Polish province}
+\tstidxnewutfplace{Zory}{\.Zory}{Żory}{Polish town and city county}
+\tstidxnewutfplace{Zelechow}{\.Zelech\'ow}{Żelechów}%
+{Polish town}
+\tstidxnewutfplace{Lobez}{\L obez}{Łobez}{Polish town}
+\tstidxnewutfplace{Glogow}{G\l og\'ow}{Głogów}{Polish town}
+\tstidxnewutfplace{Cmielow}{\'Cmiel\'ow}{Ćmielów}{Polish town}
+\tstidxnewutfplace{Scinawa}{\'Scinawa}{Ścinawa}{Polish town}
+\tstidxnewutfplace{Swidnica}{\'Swidnica}{Świdnica}{Polish town}
+\tstidxnewutfplace{Olvesvatn}{\"Olvesvatn}{Ölvesvatn}{Icelandic lake}
+\tstidxnewutfplace{Ulfsvatn}{\'Ulfsvatn}{Úlfsvatn}{Icelandic lake}
+\tstidxnewutfplace{Anavatn}{\'Anavatn}{Ánavatn}{Icelandic lake}
+\tstidxnewutfplace{Masvatn}{M\'asvatn}{Másvatn}{Icelandic lake}
+\tstidxnewutfplace{Thrihyrningsvatn}{\TH r\'{\i}hyrningsvatn}%
+{Þríhyrningsvatn}{Icelandic lake}
+\tstidxnewutfplace{Sigridharstadhavatn}%
+{Sigr\'{\i}\dh arsta\dh avatn}{Sigríðarstaðavatn}%
+{Icelandic lagoon}
+\tstidxnewutfplace{Graenavatn}{Gr\ae navatn}{Grænavatn}%
+{Icelandic lake}
+\tstidxnewutfplace{Arneslon}{\'Arnesl\'on}{Árneslón}%
+{Icelandic lake}
+\tstidxnewutfplace{Isholsvatn}{\'Ish\'olsvatn}{Íshólsvatn}%
+{Icelandic lake}
+\tstidxnewartplace{the}{Bog of Eternal Stench}{place in the film
+\glshyperlink{Labyrinth}}
+\tstidxnewphrase{dado rail}{waist-high moulding around the
+wall of a room}
+\tstidxnewphrase{indexing application}{an application that generates
+a document index}
+\tstidxnewphrase{visual effects}{use of imagery to create an effect}
+\tstidxnewphrase{dummy text}{sample text used for demonstration not
+for its content}
+\tstidxnewphrase{page break}{the point where document text is broken
+across two pages}
+\tstidxnewphrase{link text}{for the \glshyperlink{glossariespackage}
+package, this refers to the text inserted into the document
+through commands like \glshyperlink{cs.gls}}
+\tstidxnewphrase{cross-reference}{reference to another part of the
+document or to a part of another document}
+\tstidxnewphrase{marginal note}{text that's placed in the page
+margin}
+\tstidxnewphrase{overfull lines}{lines where the text extends into
+the margin because of a formatting failure}
+\tstidxnewphrase{lorem ipsum}{dummy text}
+\tstidxnewphrase{between you, me and the gatepost}{an expression
+meaning you're telling someone a secret that shouldn't be passed on
+(common in some British dialects)}
+\tstidxnewphrase{way with words}{have a particular talent with words}
+\tstidxnewphrase{creative writing}{writing typically identified
+by narrative craft, character development and use of literary tropes}
+\tstidxnewphrase{cut to the chase}{get to the point}
+\tstidxnewphrase{get to the point}{state something directly}
+\tstidxnewphraseseealso{keep mum}{be silent about something}{confidential}
+\tstidxnewphrase{output routine}{\TeX's method of outputting a page}
+\tstidxnewphrase{out of whack}{out of order or not working}
+\tstidxnewphrase{page dimensions}{the dimensions of a page (such as
+the page width and page height)}
+\tstidxnewphrase{font family}{the name of a font}
+\tstidxnewphrase{font size}{the size of a font}
+\tstidxnewphraseseealso{location list}%
+{the list of locations used in an index to indicate where
+the term being referenced was used in the document}{crossreference}
+\tstidxnewphrasesee{range separator}{the symbol
+used between the start and end location to indicate a range}{locationlist}
+\tstidxnewphrase{page number}{the number identifying a
+particular page}
+\tstidxnewphrase{multiple encaps}{a warning issued by
+\glshyperlink{makeindex} when the same page number is indexed
+with different encap values}
+\tstidxnewphrase{input encoding}{the character encoding used
+in the document source code}
+\tstidxnewphrase{font encoding}{the encoding used by the document
+font}
+\tstidxnewphrase{extended Latin characters}{Latin characters outside
+the basic ASCII set}
+\tstidxnewphrase{cup of tea}{an expression indicating what one likes
+or is interested in}
+\tstidxnewphrase{whistle-stop tour}{a series of short visits to
+different places}
+\tstidxnewphrase{number group}{a group associated with numbers}
+\tstidxnewphrase{prime number}{a number that is only divisible by
+itself and 1}
+\tstidxnewphrase{hold my breath}{stop breathing temporarily, also
+used as an expression to indicate a state of anticipation or
+suspense}
+\tstidxnewphrase{letter groups}{groups associated with letters}
+\tstidxnewphrase{Once upon a time}{an expression commonly used at
+the start of fairy tales}
+\tstidxnewphrase{across the pond}{colloquial expression indicating
+the other side of the Atlantic}
+\tstidxnewphrase{bad form}{an offence against accepted behaviour}
+\tstidxnewphrase{Monty Python}{a British surreal comedy group}
+\tstidxnewphrase{magic incantation}{words used to create a magical
+effect}
+\tstidxnewphrase{common knowledge}{something widely known}
+\tstidxnewphrase{intrepid hero}{a hero known for his boldness
+and bravery}
+\tstidxnewphrase{sea lion}{a type of large seal}
+\tstidxnewphrase{sealant gun}{a device used for applying sealant}
+\tstidxnewphrase{zoot suit}{a suit typically having a long loose
+jacket and high-waisted trousers}
+\tstidxnewphrase{anonymous reviewer}{an unnamed reviewer}
+\tstidxnewphrase{yule log}{a large log traditionally burnt on
+Christmas Eve or a log-shaped chocolate cake}
+\tstidxnewphrase{vice-president}{a president's deputy}
+\tstidxnewphrase{vice admiral}{a high rank of naval officer}
+\tstidxnewphrase{Victoria plum}{a large, red, dessert plum}
+\tstidxnewphrase{Victoria sponge}{a sponge cake consisting of two
+layers with jam filling in between}
+\tstidxnewphrase{vice versa}{reversing the order of the items just
+mentioned}
+\tstidxnewphrase{vice chancellor}{a deputy chancellor of a
+British university in charge of its administration}
+\tstidxnewphrase{letter ordering}{ordering according to the
+individual characters}
+\tstidxnewphrase{word ordering}{ordering according to the
+language or locale's definition of words}
+\tstidxnewphrase{mot juste}{the most appropriate word}
+\tstidxnewutfphrase{attachecase}{attach\'e case}{attaché case}%
+{small, flat briefcase for carrying documents}
+\tstidxnewutfphrase{piedaterre}{pied-\`a-terre}{pied-à-terre}%
+{small flat or house kept for occasional use}
+\tstidxnewutfphrase{bergerehat}{berg\`ere hat}{bergère hat}%
+{a type of wide-brimmed straw hat}
+\tstidxnewartphrase{the}{commercial world}{pertaining to commerce}
+\tstidxnewartphrase{a}{far away land}{somewhere that's far away; a
+term often used in fairy tales}
+\tstidxnewartphrase{the}{Golden Arara}{a made-up item in the dummy
+text}
+\tstidxnewartphrase{the}{Mighty Helm of Knuth}{a made-up item in the dummy
+text}
+\tstidxnewartphrase{the}{Legendary Sword}{a made-up item in the dummy
+text}
+\tstidxnewartphrase{the}{Bog of Eternal Glossaries}{a made-up place in the dummy
+text}
+\tstidxnewartphrase{the}{Dread Vale of the Editors}{a made-up place in the dummy
+text}
+\tstidxnewartphrase{the}{butterflies of chaos}{the butterfly effect
+is a popular method of describing aspects of chaos theory}
+\tstidxnewartphrase{The}{End}{denotes the end of a
+story, especially fairy tales}
+\tstidxnewsubword{document}{properties}{attributes such as page size}
+\tstidxnewsubword{font encoding}{OT1}{one of the original font
+encodings supplied with \TeX}
+\tstidxnewsubwordsee{hero}{intrepid}{a hero known for his boldness
+and bravery}{intrepidhero}
+\tstidxnewsubphrase{location list}{page separator}%
+{symbol used to separate page references}
+\tstidxnewsubphrase{location list}{range separator}%
+{symbol used to mark page range references}
+\tstidxnewperson{James}{Joyce}{an author}
+\tstidxnewperson{Donald}{Knuth}{creator of \TeX}
+\tstidxnewperson{Paulo}{Cereda}{creator of \glshyperlink{arara}}
+\tstidxnewperson{Sir}{Quackalot}{fictitious character}
+\tstidxnewperson{the}{Fairy Goose}{fictitious character}
+\tstidxnewperson{David}{Carlisle}{member of the \LaTeX3 team}
+\tstidxnewperson{Joseph}{Wright}{member of the \LaTeX3 team}
+\tstidxnewutfperson{Anders Jonas}{\AA ngstr\"om}%
+[AndersJonasAngstrom]{Anders Jonas}{Ångström}%
+{Swedish physicist}
+\tstidxnewbook{Ulysses}{a modernist novel by James Joyce}
+\tstidxnewbook{Sir Quackalot and the Golden Arara}{a fictitious book}
+\tstidxnewbook{Sir Quackalot and the Hyper Lake of Doom}{a fictitious book}
+\tstidxnewbook{Compact Oxford English Dictionary}{a dictionary}
+\tstidxnewartbook{The}{Hitchhiker's Guide to the Galaxy}{a comedy
+series by Douglas Adams, originally created for radio but later
+adapted to book, TV and film}
+\tstidxnewartbook{The}{Adventures of Sir Quackalot}{a fictitious book}
+\tstidxnewfilm{Labyrinth}{a musical fantasy film}
+\tstidxnewartfilm{The}{Third Man}{a British film noir}
+\tstidxnewsym{TeX}{\TeX}{a typesetting system created by Donald
+Knuth}
+\tstidxnewmath{f(x)}[fx]{f(\protect\vec{x})}{a function of $x$}
+\tstidxnewmath{n}{n}{an integer}
+\tstidxnewmath{E}{E}{energy}
+\tstidxnewmathsym{alpha}{\protect\alpha}{Greek letter alpha}
+\tstidxnewmathsym{beta}{\protect\beta}{Greek letter beta}
+\tstidxnewmathsym{gamma}{\protect\gamma}{Greek letter gamma}
+\tstidxnewmathsym{sum}{\protect\sum}{summation}
+\tstidxnewmathsym{partial}{\protect\partial}{partial derivative}
+\tstidxnewmathsym{eth}[spinderiv]{\protect\eth}{spin-weighted partial derivative}
+\tstidxnewsty{testidx}{package that produces dummy text for testing
+index styles and indexing applications}
+\tstidxnewsty{testidx-glossaries}{package that produces dummy text
+for testing glossary styles and indexing applications that integrate
+with the \glshyperlink{glossariespackage} or
+\glshyperlink{glossariesextrapackage} packages}
+\tstidxnewsty{glossaries}{a package for creating glossaries or lists
+of terms, symbols or abbreviations}
+\tstidxnewsty{glossaries-extra}{an extension to the
+\glshyperlink{glossariespackage} package}
+\tstidxnewsty{hyperref}{a package that provides extensive support
+for hypertext}
+\tstidxnewsty{lipsum}{a package that generates dummy text}
+\tstidxnewsty{inputenc}{a package that can be used to identify the document encoding}
+\tstidxnewstyseealso{fontenc}{a package that can be used to set the font
+encoding}{inputencpackage}
+\tstidxnewsty{amsmath}{a package that provides AMS mathematical
+facilities}
+\tstidxnewsty{amssymb}{a package that provides mathematical
+symbols}
+\tstidxnewsty{longtable}{a package that allows tables to flow over
+page boundaries}
+\tstidxnewsty{makeidx}{a package that provides indexing
+facilities}
+\tstidxnewsty{imakeidx}{a sophisticated package that provides indexing
+facilities}
+\tstidxnewstyopt{testidx-glossaries}{extra}{load the
+\glshyperlink{glossariesextrapackage} package}
+\tstidxnewstyopt{testidx-glossaries}{noextra}{don't load the
+\glshyperlink{glossariesextrapackage} package (only load
+\glshyperlink{glossariespackage})}
+\tstidxnewstyopt{testidx-glossaries}{noseekey}{don't use the
+\tstidxqt{see} key to implement the cross-referencing (use
+\glshyperlink{cs.glssee} instead)}
+\tstidxnewstyopt{testidx-glossaries}{seekey}{use the
+\tstidxqt{see} key to implement the cross-referencing}
+\tstidxnewstyopt{testidx-glossaries}{xindy}{set up the
+\glshyperlink{glossariespackage} package to use \glshyperlink{xindy}
+as the indexing application}
+\tstidxnewstyopt{testidx-glossaries}{tex}{set up the
+\glshyperlink{glossariespackage} package to use \TeX\ to
+sort and collate the entries}
+\tstidxnewstyopt{testidx-glossaries}{bib2gls}{set up the
+\glshyperlink{glossariesextrapackage} package to use
+\glshyperlink{bib2gls} as the indexing application}
+\tstidxnewstyopt{testidx-glossaries}{noglsnumbers}{pass
+the \tstidxstyoptfmt{glsnumbers=false} option to the
+\glshyperlink{glossariespackage} package}
+\tstidxnewstyopt{testidx-glossaries}{glsnumbers}{pass
+the \tstidxstyoptfmt{glsnumbers=true} option to the
+\glshyperlink{glossariespackage} package}
+\tstidxnewstyopt{testidx-glossaries}{verbose}{write
+information about the test entries in the transcript file}
+\tstidxnewstyopt{testidx-glossaries}{noverbose}{don't write
+information about the test entries in the transcript file}
+\tstidxnewstyopt{testidx-glossaries}{desc}{add descriptions
+to the dummy entries}
+\tstidxnewstyopt{testidx-glossaries}{sanitize}{sanitize the sort value}
+\tstidxnewstyopt{testidx-glossaries}{nosanitize}{don't sanitize the
+sort value}
+\tstidxnewstyopt{testidxglossaries}{stripaccents}{in ASCII mode, strip accent
+commands from the sort value}
+\tstidxnewstyopt{testidxglossaries}{nostripaccents}{in ASCII mode, strip accent
+commands from the sort value}
+\tstidxnewstyopt{testidx}{hidemarks}{hide the marks showing
+where the indexing is occurring}
+\tstidxnewstyopt{testidx}{showmarks}{mark
+where the indexing is occurring}
+\tstidxnewstyopt{testidx}{notestencaps}{don't use the
+test encaps}
+\tstidxnewstyopt{testidx}{verbose}{show the index
+commands in the document text}
+\tstidxnewstyopt{testidx}{noverbose}{don't show the index
+commands in the document text}
+\tstidxnewstyopt{testidx}{digraphs}{use glyphs instead of
+the two-character digraphs for certain words}
+\tstidxnewstyopt{testidx}{german}{change the
+\glshyperlink{makeindex} quote character to allow the
+double-quote character to indicate an umlaut}
+\tstidxnewstyopt{testidx}{ngerman}{change the
+\glshyperlink{makeindex} quote character to allow the
+double-quote character to indicate an umlaut}
+\tstidxnewstyopt{testidx}{sanitize}{sanitize the sort value
+before passing it to the indexing command}
+\tstidxnewstyopt{testidx}{nosanitize}{don't sanitize the sort value
+before passing it to the indexing command}
+\tstidxnewstyopt{testidx}{stripaccents}{in ASCII mode, strip accent
+commands from the sort value}
+\tstidxnewstyopt{testidx}{nostripaccents}{in ASCII mode, strip accent
+commands from the sort value}
+\tstidxnewstyopt{testidx}{prefix}{insert a prefix before the sort
+value for certain symbols}
+\tstidxnewstyopt{testidx}{noprefix}{don't insert a prefix before the sort
+value for certain symbols}
+\tstidxnewstyopt{hyperref}{hidelinks}{don't use a visual effect to
+show the hyperlinks}
+\tstidxnewstyopt{fontenc}{T1}{set the font encoding to T1}
+\tstidxnewenv{theindex}{environment used to display an index}
+\tstidxnewenv{align}{environment provided by the
+\glshyperlink{amsmathpackage} package to align equations}
+\tstidxnewenv{eqnarray}{environment provided by the \LaTeX\
+kernel to align equations}
+\tstidxnewapp{bib2gls}{an indexing application designed
+to work with the \glshyperlink{glossariesextrapackage} package}
+\tstidxnewapp{makeindex}{an indexing application}
+\tstidxnewapp{xindy}{a highly-configurable indexing application with
+localisation support}
+\tstidxnewapp{texdoc}{an application for viewing documentation
+installed in a \TeX\ distribution}
+\tstidxnewapp{arara}{an automation tool for building documents}
+\tstidxnewapp{Perl}{a scripting language}
+\tstidxnewapp{makeglossaries}{a Perl script provided with the
+\glshyperlink{glossariespackage} package that automatically runs
+either \glshyperlink{makeindex} or \glshyperlink{xindy}
+according to the document settings}
+\tstidxnewapp{makeglossaries-lite}{a light-weight Lua alternative to
+\glshyperlink{makeglossaries}}
+\tstidxnewapp{Emacs}{a text editor}
+\tstidxnewapp{Vi}{a text editor}
+\tstidxnewappopt{xindy}{-L swedish}{use the Swedish language module}
+\tstidxnewappopt{xindy}{-L danish}{use the Danish language module}
+\tstidxnewappopt{xindy}{-L polish}{use the Polish language module}
+\tstidxnewappopt{xindy}{-L icelandic}{use the Icelandic language module}
+\tstidxnewappopt{xindy}{-L german-duden}{use the German language
+module with the duden setting}
+\tstidxnewappopt{xindy}{-L german-din5007}{use the German language
+module with the din5007 setting}
+\tstidxnewappopt{xindy}{-M ord/letorder}{use the letter ordering
+module}
+\tstidxnewappopt{makeindex}{-g}{use the German setting that
+recognises the double-quote character as an umlaut command}
+\tstidxnewappopt{makeindex}{-l}{use letter ordering}
+\tstidxnewindexmarker{tstidxmarker}{indicates where the indexing
+command was used for a top-level (level~0) entry}
+\tstidxnewindexmarker{tstidxsubmarker}{indicates where the indexing
+command was used for a level~1 entry}
+\tstidxnewindexmarker{tstidxsubsubmarker}{indicates where the indexing
+command was used for a level~2 entry}
+\tstidxnewindexmarker{tstidxopenmarker}{indicates where
+the start of a range was indexed for a top-level (level~0) entry}
+\tstidxnewindexmarker{tstidxclosemarker}{indicates where
+the end of a range was indexed for a top-level (level~0) entry}
+\tstidxnewindexmarker{tstidxopensubmarker}{indicates where
+the start of a range was indexed for a level~1 entry}
+\tstidxnewindexmarker{tstidxclosesubmarker}{indicates where
+the end of a range was indexed for a level~1 entry}
+\tstidxnewindexmarker{tstidxopensubsubmarker}{indicates where
+the start of a range was indexed for a level~2 entry}
+\tstidxnewindexmarker{tstidxclosesubsubmarker}{indicates where
+the end of a range was indexed for a level~2 entry}
+\tstidxnewindexmarker{tstidxseemarker}{indicates where the indexing
+command was used to cross-reference a top-level (level~0) entry}
+\tstidxnewindexmarker{tstidxsubseemarker}{indicates where the indexing
+command was used to cross-reference a level~1 entry}
+\tstidxnewencapcsn{tstidxencapi}{first test encap}
+\tstidxnewencapcsn{tstidxencapii}{second test encap}
+\tstidxnewencapcsn{tstidxencapiii}{third test encap}
+\tstidxnewcs{index}{write information to the external index file
+that will be processed by an indexing application (defined by the
+\LaTeX\ kernel)}
+
+\tstidxnewcs{testidx}{produce the dummy text (defined in the
+\glshyperlink{testidxpackage} package)}
+
+\tstidxnewcs{tstidxtoidx}{switch back to the original definitions
+provided by the base \glshyperlink{testidxpackage} package (defined
+in the \glshyperlink{testidxglossariespackage} package)}
+
+\tstidxnewcs{gls}{reference a term defined by the
+\glshyperlink{glossariespackage} package (displays text and performs
+indexing)}
+
+\tstidxnewcs{glspl}{as \glshyperlink{cs.gls} but displays the
+plural form}
+
+\tstidxnewcs{glsadd}{indexes a term defined by the
+\glshyperlink{glossariespackage} package (but doesn't display any text)}
+
+\tstidxnewcs{glssee}{indexes a cross-referenced term or terms defined by the
+\glshyperlink{glossariespackage} package (but doesn't display any text)}
+
+\tstidxnewcs{glsxtrindexseealso}{indexes a \tstidxqt{see also}
+cross-referenced term or terms defined by the
+\glshyperlink{glossariesextrapackage} package (but doesn't display any text)}
+
+\tstidxnewcs{glshyperlink}{displays the text associated with a
+term (with a hyperlink if enabled) but doesn't perform
+any indexing (defined by the \glshyperlink{glossariespackage} package)}
+
+\tstidxnewcs{setglossarystyle}{sets the glossary style
+(defined by the \glshyperlink{glossariespackage} package)}
+
+\tstidxnewcs{delimN}{page delimiter used in location lists
+(defined by the \glshyperlink{glossariespackage} package)}
+
+\tstidxnewcs{delimR}{page range delimiter used in location lists
+(defined by the \glshyperlink{glossariespackage} package)}
+
+\tstidxnewcs{tstidxfootnote}{produces a footnote
+(defined by the \glshyperlink{testidxpackage} package)}
+
+\tstidxnewcs{footnote}{produces a footnote
+(defined by the \LaTeX\ kernel)}
+
+\tstidxnewcs{tstidxtext}{used to mark the sample text being indexed
+(defined by the \glshyperlink{testidxpackage} package)}
+
+\tstidxnewcs{textcolor}{displays the given text in the given colour
+(a colour package is required to enable this command)}
+
+\tstidxnewcs{glstreenamefmt}{used to set the font for
+the name field in the tree-like glossary styles}
+
+\tstidxnewcs{tstindex}{used to index the sample text
+for the base \glshyperlink{testidxpackage} package (not for the
+\glshyperlink{testidxglossariespackage} package)}
+
+\tstidxnewcs{GlsAddXdyAttribute}{adds a \glshyperlink{xindy}
+attribute (provided by the \glshyperlink{glossariespackage} package)}
+
+\tstidxnewcs{IeC}{used internally by the
+\glshyperlink{inputencpackage}
+package}
+
+\tstidxnewcs{tstidxindexmarkerprefix}{prefix used in the
+sort key for markers if the \tstidxstyoptfmt{prefix}
+option is used (but not with the \tstidxstyoptfmt{bib2gls}
+option)}
+
+\tstidxnewcs{tstidxindexmathsymprefix}{prefix used in the
+sort key for mathematical symbols if the \tstidxstyoptfmt{prefix}
+option is used (but not with the \tstidxstyoptfmt{bib2gls}
+option)}
+
+\tstidxnewcs{tstidxmakegloss}{command used to load
+the files containing the sample glossary definitions
+and also use the appropriate command to initialise the indexing,
+depending on the package options}
+\tstidxnewnumber{42}{forty-two}
+\tstidxnewnumber{10}{ten}
+\tstidxnewnumber{16}{sixteen}
+\tstidxnewnumber{2}{two}
+\tstidxnewnumber{100}{one hundred}
+\endinput
+%%
+%% End of file `testidx-glossaries-samples.tex'.
diff --git a/Master/texmf-dist/doc/latex/testidx/testidx-manual.pdf b/Master/texmf-dist/doc/latex/testidx/testidx-manual.pdf
index 72e0d2dae12..7eedfb5ba4f 100644
--- a/Master/texmf-dist/doc/latex/testidx/testidx-manual.pdf
+++ b/Master/texmf-dist/doc/latex/testidx/testidx-manual.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/testidx/testidx-manual.tex b/Master/texmf-dist/doc/latex/testidx/testidx-manual.tex
index fc5546094f8..5311acae3a8 100644
--- a/Master/texmf-dist/doc/latex/testidx/testidx-manual.tex
+++ b/Master/texmf-dist/doc/latex/testidx/testidx-manual.tex
@@ -1,8 +1,9 @@
\documentclass[widecs]{nlctdoc}
\usepackage[marginpar=1in]{geometry}
-\usepackage[utf8]{inputenc}
\usepackage[T1]{fontenc}
+\usepackage[utf8]{inputenc}
+
\usepackage{metalogo}
\usepackage{cmap}
\usepackage{upquote}
@@ -26,12 +27,12 @@
\begin{document}
- \title{testidx.sty v1.0:
+ \title{testidx.sty v1.1:
dummy text for testing indexes}
\author{Nicola L.C. Talbot\\[10pt]
\url{http://www.dickimaw-books.com/}}
- \date{2016-10-17}
+ \date{2017-08-11}
\maketitle
\tableofcontents
@@ -43,10 +44,83 @@ The \styfmt{testidx} package is for testing indexes (\cs{index},
and \app{xindy}).
As with packages like \sty{lipsum} and \sty{blindtext}, this package
provides dummy text, but it's interspersed with \cs{index} commands.
-The filler text is English not lorum ipsum, as this makes it
+The filler text is mostly English not lorum ipsum, as this makes it
slightly easier to check the words in the index against the words in
the document. (For those who don't understand English, it's at least
-no worse than lorum ipsum.)
+no worse than lorum ipsum.) There are some terms (words, phrases or proper
+nouns) that include extended Latin characters or digraphs to allow
+for testing with a variety of Latin alphabets. The dummy text is
+designed to cause problems that can occur in real documents to help
+test your chosen indexing application or index style. The main
+issues this package tries to replicate are:
+\begin{itemize}
+\item Multiple encaps. For example, the word \qt{paragraph} is
+indexed within the same block using no encap and each of the three
+test encap values. This causes the \app{makeindex} warning
+\qt{Conflicting entries: multiple encaps for the same page under
+same key.}
+
+\item An explicit range formation conflicting with a mid-range encap.
+The word \qt{range} has an explicit range formation (starting in
+block~4 and ending in block~9), but \qt{range} is also indexed in
+block~5 with one of the test encap values. This causes the
+\app{makeindex} warning \qt{Inconsistent page encapsulator \ldots\
+within range.}
+
+\item Page breaking mishaps. This is largely dependent on the font
+size and page geometry, but the dummy text contains some long
+paragraphs and has enough entries to result in at least some awkward
+page breaks. These may include a page or column break between an
+index group heading and the first entry in that group or between an
+index item and the first sub-item following it. Also check for
+indexing that occurs in paragraphs that span page breaks to ensure
+the location number is correct.
+
+\item Untidy page lists. This again depends on the font size and
+page geometry, but some entries are sporadically indexed throughout
+the dummy text, which can lead to a long list that can't be formed
+into a neat range.
+
+\item Mid-list cross-referencing. The word \qt{lyuk} is indexed
+and then cross-referenced in block~3, and indexed again in block~7.
+This can result in the rather odd occurrence of a cross-reference
+appearing in the middle of the location list for that entry, depending on the
+indexing method.
+
+\item Collation-level homographs. (Same spelling except for
+accents.) The words \qt{resume}
+and \qt{r\'esum\'e} are both indexed. These should be treated as
+separate entries in the index, even if the comparator considers
+them identical. Different indexing methods may
+produce different ordering or may even merge the two words, so check
+they are both present.
+
+\item Compound entries. The index contains a mixture of
+single words, compound words, names, titles and phrases. The ordering may vary
+depending on the sorting method. For example, check the ordering
+of \qt{sea}, \qt{sea lion}, \qt{seaborne} and \qt{seal}, and
+also the words starting with \qt{vice}, such as \qt{vice admiral},
+\qt{viceroy} and \qt{vice-president}.
+
+\item Long entries can cause awkward line breaks and justification
+in a multicolumn index with narrow columns.
+
+\item Interference caused by whatsits. Block~8 has a whatsit caused
+by the indexing that interferes with limits of a summation in an
+equation.
+
+\item Symbols and numbers that don't have a natural word order.
+The numbers may or may not be ordered numerically, depending on the
+indexing method.
+\end{itemize}
+In addition, words containing extended Latin characters, digraphs and a
+trigraph are indexed to help test various Latin alphabets, such as
+Swedish, Icelandic, Welsh, Dutch, Polish and Hungarian. These may or
+may not be recognised by indexing applications.
+
+Version 1.1 now comes with a supplementary package
+\sty{testidx-glossaries} which provides a similar way of testing the
+\sty{glossaries} or \sty{glossaries-extra} package.
Example document:
\begin{verbatim}
@@ -110,7 +184,7 @@ attributes (encaps) used in the dummy text. For example:
:close "}"
:attr "tstidxencapiii")
-(markup-locref-list :sep ",")
+(markup-locref-list :sep ", ")
(markup-range :sep "--")
\end{filecontents*}
@@ -243,9 +317,45 @@ quote '+'
\end{document}
\end{verbatim}
+The \styfmt{testidx-glossaries} package automatically loads
+\styfmt{testidx} and will also load either \sty{glossaries} or
+\sty{glossaries-extra}. For example:
+\begin{verbatim}
+\documentclass{report}
+
+\usepackage[T1]{fontenc}
+\usepackage{testidx-glossaries}
+
+\renewcommand*{\glstreenamefmt}[1]{#1}
+
+\tstidxmakegloss
+
+\begin{document}
+
+\testidx
+
+\tstidxprintglossaries
+
+\end{document}
+\end{verbatim}
+This automatically sets the \texttt{mcolsindexgroup} glossary style
+to mimic the style commonly used with indexes.
+This document can be built using:
+\begin{verbatim}
+pdflatex myDoc
+makeglossaries myDoc
+pdflatex myDoc
+\end{verbatim}
+Note that the \texttt{mcolsindexgroup} style sets the \texttt{name}
+field in \cs{glstreenamefmt}, which defaults to bold. This has been
+redefined in the above example to simply do its argument.
+
\section{Package Options}
\label{sec:pkgopt}
+\subsection{\texorpdfstring{\styfmt{testidx}}{testidx} options}
+\label{sec:testidxpkgopt}
+
The following package options are provided:
\begin{description}
\item[\pkgopt{german} or \pkgopt{ngerman}]
@@ -350,21 +460,178 @@ code (e.g.\ \verb"\tstidxsty[emph]{testidx}").
(Default.) Cancels the \pkgopt{notestencaps} option.
This option ensures that \ics{testidx} uses the three test
encaps.
+
+\item[\pkgopt{prefix}]
+(Default.) Inserts a prefix in the sort value for certain (symbol) entries to
+keep them together in the index. These entries represent markers
+(prefixed with \ics{tstidxindexmarkerprefix}) and maths symbols (prefixed with
+\ics{tstidxmathsymprefix}).
+
+\item[\pkgopt{noprefix}]
+Doesn't insert a prefix for the markers and maths symbol entries.
+This option doesn't alter the entries starting with a
+hyphen (such as \texttt{-l}) which always have that prefix
+since it's part of the display name.
+
+\item[\pkgopt{diglyphs}]
+Words with \tstidxqt{ll}, \tstidxqt{ij} and \tstidxqt{dz} digraphs
+will have the two characters forming the digraph replaced with a
+single UTF-8 glyph. This option only works if UTF-8 is supported
+\emph{and the document font recognises the glyphs}. (The trigraph
+\tstidxqt{dzw} and other digraphs,
+such as \tstidxqt{th} aren't affected by this option.)
+
+\item[\pkgopt{nodiglyphs}]
+(Default.) Don't use single glyphs for the \tstidxqt{ll},
+\tstidxqt{ij} and \tstidxqt{dz} digraphs. (This option doesn't
+affect other glyphs, such as \ae\ or \th, that are more commonly
+used in some languages.)
\end{description}
+\subsection{\texorpdfstring{\styfmt{testidx-glossaries}}{testidx-glossaries}
+ options}
+\label{sec:testidxglospkgopt}
+
+Most of the package options provided by \styfmt{testidx} can also be
+used with \styfmt{testidx-glossaries}. The \pkgopt{verbose} option
+has a slightly different effect. With \styfmt{testidx}, that option
+shows the indexing command within the text. However, the
+\sty{glossaries} package requires entries to first be defined and
+doesn't use \cs{index} but uses its own internal custom commands
+that depend on the indexing method, so for
+\styfmt{testidx-glossaries}, the \pkgopt{verbose} option instead
+writes information in the transcript file (\texttt{.log}) when the
+dummy entries are defined. For example:
+\begin{verbatim}
+Package testidx-glossaries Info: new term label={packages},
+(testidx-glossaries) name={packages},
+(testidx-glossaries) text={packages},
+(testidx-glossaries) parent={},
+(testidx-glossaries) see={}
+(testidx-glossaries) on input line 1.
+\end{verbatim}
+When used with the \pkgopt{tex} option, the \pkgopt{verbose}
+option will additionally write information while \TeX\ is
+sorting, since this can take a while and may give the appearance
+that the build process has hung.
+
+When used with the \pkgopt{bib2gls} option, the \pkgopt{verbose}
+option will show the syntax used by \ics{tstidxmakegloss}
+to load each resource. If you search the \texttt{.log} file for
+instances of \ics{GlsXtrLoadResource}, you'll find the commands
+needed to replicate the behaviour of \cs{tstidxmakegloss}.
+
+In addition to the options listed above, the following options are
+also available for \styfmt{testidx-glossaries}:
+\begin{description}
+\item[\pkgopt{extra}]
+Load the \sty{glossaries-extra} package.
+
+\item[\pkgopt{noextra}]
+Don't load the \sty{glossaries-extra} package. Just load the
+base \sty{glossaries} package. (Default.)
+
+\item[\pkgopt{makeindex}]
+(Default.) Passes the \pkgopt{makeindex} option to
+\sty{glossaries}. This option also sets up \ics{tstidxmakegloss}
+to use \ics{makeglossaries}, \ics{tstidxprintglossaries} to use
+\ics{printglossaries} and \ics{tstidxprintglossary} to use
+\ics{printglossary}. Use \app{makeglossaries} (or
+\app{makeglossaries-lite}) in the build process.
+
+\item[\pkgopt{xindy}] Passes the \pkgopt{xindy} option to
+\sty{glossaries}. This option also sets up \ics{tstidxmakegloss}
+to use \ics{makeglossaries}, \ics{tstidxprintglossaries} to use
+\ics{printglossaries} and \ics{tstidxprintglossary} to use
+\ics{printglossary}. Use \app{makeglossaries} (or
+\app{makeglossaries-lite}) in the build process.
+
+\item[\pkgopt{tex}] This option also sets up \ics{tstidxmakegloss}
+to use \ics{makenoidxglossaries}, \ics{tstidxprintglossaries} to use
+\ics{printnoidxglossaries} and \ics{tstidxprintglossary} to use
+\ics{printnoidxglossary}. (\TeX\ is used for to sort and collate the
+entries. Don't use \app{makeglossaries} or \app{makeglossaries-lite}
+in the build process.)
+
+\item[\pkgopt{bib2gls}] Passes the \pkgopt{record} option to
+\sty{glossaries-extra}. (This option automatically implements the
+\pkgopt{extra} option.) This option also sets up
+\ics{tstidxmakegloss} to use \ics{GlsXtrLoadResources},
+\ics{tstidxprintglossaries} to use
+\ics{printunsrtglossaries} and \ics{tstidxprintglossary} to use
+\ics{printunsrtglossary}. Use \app{bib2gls} in the build process.
+Note that this option ignores the commands
+\ics{tstidxindexmarkerprefix} and \ics{tstidxmathsymprefix}.
+
+\item[\pkgopt{manual}] Indicates that the test document
+doesn't use \cs{tstidxmakegloss}. (This disables the check
+that ensures that command has been used.) Use this option if you
+want to customize the glossary set-up. This option may be used in
+addition to the above options, but it will disable
+\cs{tstidxmakegloss}, \cs{tstidxprintglossary} and
+\cs{tstidxprintglossaries}.
+
+The sample files can be loaded using
+\begin{definition}[\DescribeMacro\tstidxloadsamples]
+\cs{tstidxloadsamples}
+\end{definition}
+(which \cs{tstidxmakegloss} does implicitly) except in the case of
+\pkgopt{bib2gls} where the sample files need to be loaded in
+\cs{GlsXtrLoadResource}.
+
+\item[\pkgopt{seekey}]
+(Default.)
+Use the \texttt{see} key for cross-references instead of using \ics{glssee}.
+If the \texttt{seealso} key has been defined (\sty{glossaries-extra}
+v1.16+), then this will be used for the \qt{see also}
+cross-references (otherwise \verb|see=[\seealsoname]|\marg{label}
+will be used).
+
+\item[\pkgopt{noseekey}]
+Use \ics{glssee} for cross-references and don't set the \texttt{see}
+(or \texttt{seealso}) key.
+
+\item[\pkgopt{noglsnumbers}] Passes the \pkgopt{glsnumbers=false} option to
+\sty{glossaries}.
+
+\item[\pkgopt{glsnumbers}] Passes the \pkgopt{glsnumbers=true} option to
+\sty{glossaries}. (This is the default for the \sty{glossaries}
+package.)
+
+\item[\pkgopt{desc}] Provide descriptions for the dummy entries.
+This setting automatically implements the \sty{glossaries}
+package's \pkgopt{nopostdot=false} option and sets the
+\texttt{indexgroup} glossary style.
+
+\item[\pkgopt{nodesc}]
+(Default.) Don't provide descriptions for the dummy entries.
+(The \texttt{description} field is set to empty.)
+This setting automatically implements the \sty{glossaries}
+package's \pkgopt{nopostdot} option and sets the
+\texttt{mcolindexgroup} glossary style. (The \sty{glossary-mcols} package
+is automatically loaded.)
+\end{description}
+
+Both the \texttt{mcolindexgroup} and \texttt{indexgroup} styles set
+the \texttt{name} field in \ics{glstreenamefmt}, which by default
+uses \cs{textbf}. This can be redefined as appropriate.
+You can switch to a different glossary style using
+\cs{setglossarystyle}\marg{style-name}.
+
\section{Basic Commands}
\label{sec:basic}
This section only covers the basic commands provided by
-\styfmt{testidx}. For more advanced commands, see the documented
-code.
+\styfmt{testidx} and \styfmt{testidx-glossaries}.
+For more advanced commands, see the documented code.
\begin{definition}[\DescribeMacro\testidx]
\cs{testidx}\oarg{blocks}
\end{definition}
-This is the principle command provided by this package. It
+This is the principle command provided by the \sty{testidx} package. It
generates the predefined dummy text that's interspersed
-with indexing commands. There are \number\tstidxmaxblocks\
+with indexing commands. (The text varies slightly according to the
+document settings.) There are \number\tstidxmaxblocks\
blocks in total. This number can be accessed through the register:
\begin{definition}[\DescribeMacro\tstidxmaxblocks]
\cs{tstidxmaxblocks}
@@ -386,15 +653,37 @@ displayed material. The starred form won't eliminate
paragraph breaks \emph{within} the blocks, just those
used as separators between the blocks.
+If you use \sty{testidx-glossaries}, you additionally need
+\begin{definition}[\DescribeMacro\tstidxmakegloss]
+\cs{tstidxmakegloss}\oarg{options}
+\end{definition}
+in the preamble. This loads the files that provide the dummy entries
+and uses \cs{makeglossaries} or \cs{makenoidxglossaries} or
+\cs{GlsXtrLoadResources} depending on the package options. The
+optional argument \meta{options} is appended to the optional argument of
+\cs{GlsXtrLoadResources} if the \pkgopt{bib2gls} package option has
+been used, otherwise \meta{options} is ignored.
+
+To display the glossary, either use
+\begin{definition}[\DescribeMacro\tstidxprintglossaries]
+\cs{tstidxprintglossaries}
+\end{definition}
+or
+\begin{definition}[\DescribeMacro\tstidxprintglossary]
+\cs{tstidxprintglossary}\marg{options}
+\end{definition}
+where you want the glossary to be displayed. This will use the
+appropriate command according to the package set up.
+
The intention of the dummy text is to provide an index that should
-typically span at least three pages for A4 or letter paper,
-to allow testing of headers and footers across a double-paged
-spread. Some of the indexing commands intentionally cause
-warnings from \app{makeindex} to test for certain situations.
-Phrases are indexed as well as just individual words to
-increase the chances of indexed terms spanning a page
-break. However, the page dimensions, fonts and other material in the
-document will obviously alter where the page breaks occur.
+typically span at least three pages for A4 or letter paper, to allow
+testing of headers and footers across a double-paged spread and to
+test the effects of page breaking. Some of the indexing commands intentionally
+cause warnings from \app{makeindex} to test for certain situations.
+Phrases are indexed as well as just individual words to increase the
+chances of indexed terms spanning a page break. However, the page
+dimensions, fonts and other material in the document will obviously
+alter where the page breaks occur.
You can display only a subset of the blocks using the optional
argument, which may be a comma-separated list of block identifiers
@@ -439,7 +728,7 @@ your intention. Just remember to stay within the range
1--\cs{tstidxmaxblocks} as you'll get an error if you
go out of those bounds.
-The actual indexing is performed using:
+With just \sty{testidx}, the actual indexing is performed using:
\begin{definition}[\DescribeMacro\tstindex]
\cs{tstindex}\marg{text}
\end{definition}
@@ -447,6 +736,10 @@ This defaults to just \cs{index}\marg{text} but may be redefined. For
example, if you are testing multiple indexes, you can
redefine \cs{tstindex} to use a specific index.
+With \sty{testidx-glossaries}, the above command isn't used.
+Instead \cs{gls}, \cs{glspl}, \cs{glsadd} or \cs{glssee} will be
+used depending on the context.
+
The dummy text includes markers to identify where the instances
of \cs{tstindex} have been used. To reduce the possibility of
package conflict, \styfmt{testidx} loads a bare minimum of
@@ -457,7 +750,9 @@ commands, so the markers are fairly primitive. If you prefer
fancier markers, you can change them by redefining the
commands listed below. Multiple markers in the dummy text
indicate multiple instances of \cs{tstindex} without any
-intervening text.
+intervening text. (Naturally, \sty{testidx-glossaries} requires more
+packages as it loads \sty{glossaries}, and possibly also
+\sty{glossaries-extra}.)
\begin{definition}[\DescribeMacro\tstidxmarker]
\cs{tstidxmarker}
@@ -562,7 +857,7 @@ text colour.
If you are using \app{xindy}, you'll need to add these
to a \texttt{.xdy} file that can be loaded using \app{xindy}'s
-\texttt{-M} switch. For example, include the following
+\texttt{-M} switch. For example, with just \sty{testidx}, include the following
in your \texttt{.xdy} file:
\begin{verbatim}
; list of allowed attributes
@@ -593,6 +888,35 @@ haven't already done so:
(markup-locref-list :sep ",")
(markup-range :sep "--")
\end{verbatim}
+If you use \sty{testidx-glossaries}, the \sty{glossaries} package
+provides commands to add information to the automatically generated
+\texttt{.xdy} file. For example:
+\begin{verbatim}
+\GlsAddXdyAttribute{tstidxencapi}
+\GlsAddXdyAttribute{tstidxencapii}
+\GlsAddXdyAttribute{tstidxencapiii}
+\end{verbatim}
+If you want to provide your own custom cross-reference class
+you can use
+\begin{definition}[\DescribeMacro\tstidxSetSeeEncap]
+\cs{tstidxSetSeeEncap}\marg{encap name}
+\end{definition}
+to change the \texttt{see} encap to \meta{encap name} and
+\begin{definition}[\DescribeMacro\tstidxSetSeeAlsoEncap]
+\cs{tstidxSetSeeAlsoEncap}\marg{encap name}
+\end{definition}
+to change the \texttt{seealso} encap to \meta{encap name}.
+For example:
+\begin{verbatim}
+\tstidxSetSeeAlsoEncap{uncheckedseealso}
+\end{verbatim}
+and in the \texttt{.xdy} file:
+\begin{verbatim}
+(define-crossref-class "uncheckedseealso" :unverified)
+(markup-crossref-list :class "uncheckedseealso"
+ :open "\seealso" :close "{}")
+\end{verbatim}
+which creates an unverified alternative to \texttt{seealso}.
The \cs{tstindex} command is sometimes placed before the term
or phrase being indexed and sometimes afterwards. To clarify
@@ -624,12 +948,18 @@ for better consistency. These markup commands typically
won't need changing, but if they do, see the documented code
for further detail.)
-Example:
+In the case of \sty{testidx-glossaries}, the above example would be
+\begin{verbatim}
+\gls{DonaldKnuth}\glsadd{people.DonaldKnuth}
+\end{verbatim}
+(\cs{index} isn't used).
+
+Example (using just \sty{testidx}):
\begin{verbatim}
\renewcommand*{\tstindex}[1]{}
\textsf{\testidx[1,\tstidxmaxblocks]}
\end{verbatim}
-produces the two paragraphs (first and last blocks) shown below:
+This produces the two paragraphs (first and last blocks) shown below:
\medskip\par
\renewcommand*{\tstindex}[1]{}
@@ -654,7 +984,8 @@ close a range.
If you need to change the indexing special characters, you
can redefine the commands listed in this section. Remember
that you will also need to make the relevant changes to your
-indexing style file.
+indexing style file. (These commands only apply to \sty{testidx} not
+\sty{testidx-glossaries}.)
\begin{definition}[\DescribeMacro\tstidxquote]
\cs{tstidxquote}
@@ -757,6 +1088,30 @@ Or
\end{document}
\end{verbatim}
+If the UTF-8 mode is on, you can additionally use the
+\pkgopt{diglyphs} package option to replace the
+\tstidxqt{ll}, \tstidxqt{ij} and \tstidxqt{dz} digraphs with
+a single glyph, but you'll need a font that supports
+those glyphs. (The trigraph \tstidxqt{dzw} and other digraphs,
+such as \tstidxqt{th} aren't affected by this option.) For example
+\begin{verbatim}
+\documentclass{article}
+
+\usepackage{fontspec}
+\setmainfont{Linux Libertine O}
+
+\usepackage{makeidx}
+\usepackage[diglyphs]{testidx}
+
+\makeindex
+
+\begin{document}
+\testidx
+
+\printindex
+\end{document}
+\end{verbatim}
+
\end{description}
When the ASCII mode is on, words or phrases with UTF-8
@@ -806,7 +1161,8 @@ example will appear in the \texttt{.idx} file as:
\begin{flushleft}\ttfamily
\cs{indexentry}\{\AA ngstr\"om, Anders Jonas\}\marg{location}
\end{flushleft}
-Regular \LaTeX\ requires the \sty{inputenc} package to support
+Regular \LaTeX\ (\app{latex} or \app{pdflatex}) requires the
+\sty{inputenc} package to support
UTF-8 characters, but each UTF-8 character is treated as
two tokens (the first and second octets) where the first token is an
active character that takes the second token as the argument.