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/CHANGES8
-rw-r--r--Master/texmf-dist/doc/latex/testidx/README7
-rw-r--r--Master/texmf-dist/doc/latex/testidx/samples/sample-idx-a4.pdfbin186061 -> 186326 bytes
-rw-r--r--Master/texmf-dist/doc/latex/testidx/samples/sample-idx-amsmath.pdfbin190620 -> 190937 bytes
-rw-r--r--Master/texmf-dist/doc/latex/testidx/samples/sample-idx-babel-german.pdfbin204565 -> 204609 bytes
-rw-r--r--Master/texmf-dist/doc/latex/testidx/samples/sample-idx-babel-german.tex2
-rw-r--r--Master/texmf-dist/doc/latex/testidx/samples/sample-idx-german.pdfbin204480 -> 204649 bytes
-rw-r--r--Master/texmf-dist/doc/latex/testidx/samples/sample-idx-german.tex2
-rw-r--r--Master/texmf-dist/doc/latex/testidx/samples/sample-idx-hyp.pdfbin207017 -> 207510 bytes
-rw-r--r--Master/texmf-dist/doc/latex/testidx/samples/sample-idx-letter.pdfbin199713 -> 199911 bytes
-rw-r--r--Master/texmf-dist/doc/latex/testidx/samples/sample-idx-lua.pdfbin148258 -> 148916 bytes
-rw-r--r--Master/texmf-dist/doc/latex/testidx/samples/sample-idx-lua.tex2
-rw-r--r--Master/texmf-dist/doc/latex/testidx/samples/sample-idx-subset.pdfbin138492 -> 138492 bytes
-rw-r--r--Master/texmf-dist/doc/latex/testidx/samples/sample-idx-t1.pdfbin294342 -> 294962 bytes
-rw-r--r--Master/texmf-dist/doc/latex/testidx/samples/sample-idx-utf8.pdfbin316716 -> 316807 bytes
-rw-r--r--Master/texmf-dist/doc/latex/testidx/samples/sample-idx-utf8.tex2
-rw-r--r--Master/texmf-dist/doc/latex/testidx/samples/sample-idx-xe-digraphs.pdfbin101305 -> 102392 bytes
-rw-r--r--Master/texmf-dist/doc/latex/testidx/samples/sample-idx-xe-digraphs.tex8
-rw-r--r--Master/texmf-dist/doc/latex/testidx/samples/sample-idx-xe.pdfbin103564 -> 104548 bytes
-rw-r--r--Master/texmf-dist/doc/latex/testidx/samples/sample-idx-xe.tex2
-rw-r--r--Master/texmf-dist/doc/latex/testidx/samples/sample-idx.pdfbin187731 -> 188003 bytes
-rw-r--r--Master/texmf-dist/doc/latex/testidx/samples/sample-idxgloss-bib2gls-xe.pdfbin178540 -> 179953 bytes
-rw-r--r--Master/texmf-dist/doc/latex/testidx/samples/sample-idxgloss-bib2gls.pdfbin364062 -> 363897 bytes
-rw-r--r--Master/texmf-dist/doc/latex/testidx/samples/sample-idxgloss-desc.pdfbin430712 -> 431035 bytes
-rw-r--r--Master/texmf-dist/doc/latex/testidx/samples/sample-idxgloss-desc.tex2
-rw-r--r--Master/texmf-dist/doc/latex/testidx/samples/sample-idxgloss-xe-digraphs.pdfbin100182 -> 101271 bytes
-rw-r--r--Master/texmf-dist/doc/latex/testidx/samples/sample-idxgloss-xindy.pdfbin279604 -> 279705 bytes
-rw-r--r--Master/texmf-dist/doc/latex/testidx/samples/sample-idxgloss.pdfbin304536 -> 304624 bytes
-rw-r--r--Master/texmf-dist/doc/latex/testidx/samples/sample-idxgloss.tex2
-rw-r--r--Master/texmf-dist/doc/latex/testidx/samples/sample-noidxgloss.pdfbin276368 -> 277566 bytes
-rw-r--r--Master/texmf-dist/doc/latex/testidx/testidx-code.pdfbin480276 -> 483610 bytes
-rw-r--r--Master/texmf-dist/doc/latex/testidx/testidx-glossaries-diglyphs.tex2
-rw-r--r--Master/texmf-dist/doc/latex/testidx/testidx-glossaries-nodiglyphs.tex2
-rw-r--r--Master/texmf-dist/doc/latex/testidx/testidx-glossaries-samples.bib15
-rw-r--r--Master/texmf-dist/doc/latex/testidx/testidx-glossaries-samples.tex7
-rw-r--r--Master/texmf-dist/doc/latex/testidx/testidx-manual.pdfbin321402 -> 326696 bytes
-rw-r--r--Master/texmf-dist/doc/latex/testidx/testidx-manual.tex127
37 files changed, 153 insertions, 37 deletions
diff --git a/Master/texmf-dist/doc/latex/testidx/CHANGES b/Master/texmf-dist/doc/latex/testidx/CHANGES
index c37932f0841..4917d1faa62 100644
--- a/Master/texmf-dist/doc/latex/testidx/CHANGES
+++ b/Master/texmf-dist/doc/latex/testidx/CHANGES
@@ -1,3 +1,11 @@
+v1.2 (2019-09-29):
+
+ * Added options ascii and noascii
+
+ * Added lonely sub-item
+
+ * Corrected description for seal
+
v1.1 (2017-08-11):
* Added more sample text, including examples starting with some
diff --git a/Master/texmf-dist/doc/latex/testidx/README b/Master/texmf-dist/doc/latex/testidx/README
index 1671deff3c7..9802c9ed451 100644
--- a/Master/texmf-dist/doc/latex/testidx/README
+++ b/Master/texmf-dist/doc/latex/testidx/README
@@ -1,6 +1,6 @@
-LaTeX Package : testidx v1.1
+LaTeX Package : testidx v1.2
-Last Modified : 2017-08-11
+Last Modified : 2019-09-29
Author : Nicola Talbot
@@ -24,7 +24,8 @@ Example document:
\end{document}
Note that the dummy indexing intentionally triggers multiple encap
-warnings for testing purposes.
+warnings for testing purposes. The package is designed to emulate
+common problems.
LICENCE
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 40d26c22e5c..3ca5dc3cffa 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 b212b990cc1..5cc32f43014 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-babel-german.pdf b/Master/texmf-dist/doc/latex/testidx/samples/sample-idx-babel-german.pdf
index 624a7ec0243..c6c10af4b29 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-babel-german.tex b/Master/texmf-dist/doc/latex/testidx/samples/sample-idx-babel-german.tex
index 3f0719aa348..2537bc3b997 100644
--- a/Master/texmf-dist/doc/latex/testidx/samples/sample-idx-babel-german.tex
+++ b/Master/texmf-dist/doc/latex/testidx/samples/sample-idx-babel-german.tex
@@ -18,7 +18,7 @@
\usepackage{filecontents}
\usepackage{makeidx}
\usepackage{babel}
-\usepackage{testidx}
+\usepackage[ascii]{testidx}
\providecommand*\lettergroup[1]{%
\par\textbf{#1}\par
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 8796631b565..a63d6cd0d97 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-german.tex b/Master/texmf-dist/doc/latex/testidx/samples/sample-idx-german.tex
index 0a3543bbeab..c8be3266328 100644
--- a/Master/texmf-dist/doc/latex/testidx/samples/sample-idx-german.tex
+++ b/Master/texmf-dist/doc/latex/testidx/samples/sample-idx-german.tex
@@ -18,7 +18,7 @@
\usepackage{filecontents}
\usepackage{makeidx}
\usepackage{ngerman}
-\usepackage[german]{testidx}
+\usepackage[german,ascii]{testidx}
\providecommand*\lettergroup[1]{%
\par\textbf{#1}\par
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 e46507fbae2..85fc48dea5a 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 319f33dd7b2..2f85f384127 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 6cf3556cd31..70b9f497eba 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 39526333cd1..31b7ad03399 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
@@ -12,7 +12,7 @@
% arara: lualatex
% arara: xindy: {language: english, codepage: utf8,
% arara: --> log: sample-idx-lua.ilg,
-% arara: --> modules: [basename, texindy]}
+% arara: --> modules: [sample-idx-lua, texindy]}
% arara: lualatex
\documentclass{article}
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 c6045b334ef..68e21fbfe38 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 50a176f0d41..5ca311a23eb 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 f35959e4b71..92c8339c562 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 e4cbb529f3b..836963ea274 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
@@ -11,7 +11,7 @@
%
% arara: pdflatex
% arara: xindy: {language: english, codepage: utf8,
-% arara: --> modules: [basename, texindy]}
+% arara: --> modules: [sample-idx-utf8, texindy]}
% arara: pdflatex
\documentclass{article}
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
index a9c63412395..820d84b896d 100644
--- 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
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
index 7fcd40f9497..d579daaabe4 100644
--- 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
@@ -4,9 +4,9 @@
% 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
+% xelatex sample-idx-xe-digraphs
+% xindy -M sample-idx-xe-digraphs -M texindy -C utf8 -L english -t sample-idx-xe-digraphs.ilg sample-idx-xe-digraphs.idx
+% xelatex sample-idx-xe-digraphs
%
% You may want to experiment with different languages.
%
@@ -14,7 +14,7 @@
%
% arara: xelatex
% arara: xindy: {language: english, codepage: utf8,
-% arara: --> modules: [basename, texindy]}
+% arara: --> modules: [sample-idx-xe-digraphs, texindy]}
% arara: xelatex
\documentclass{article}
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 af1f8ada1e2..7d5a0510e14 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 4502dafe6f6..f1edaa47f64 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
@@ -13,7 +13,7 @@
%
% arara: xelatex
% arara: xindy: {language: english, codepage: utf8,
-% arara: --> modules: [basename, texindy]}
+% arara: --> modules: [sample-idx-xe, texindy]}
% arara: xelatex
\documentclass{article}
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 61197f80974..cf24bc93dd3 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
index e5410c3d840..5354e2194bb 100644
--- 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
Binary files differ
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
index 956cdf15115..9b22eb4b616 100644
--- a/Master/texmf-dist/doc/latex/testidx/samples/sample-idxgloss-bib2gls.pdf
+++ 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-desc.pdf b/Master/texmf-dist/doc/latex/testidx/samples/sample-idxgloss-desc.pdf
index 764fc16f9d7..7cfe8e25ec5 100644
--- a/Master/texmf-dist/doc/latex/testidx/samples/sample-idxgloss-desc.pdf
+++ 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
index 34c350a27cf..51bf60d169f 100644
--- a/Master/texmf-dist/doc/latex/testidx/samples/sample-idxgloss-desc.tex
+++ b/Master/texmf-dist/doc/latex/testidx/samples/sample-idxgloss-desc.tex
@@ -5,7 +5,7 @@
\usepackage[T1]{fontenc}
\usepackage[hidelinks]{hyperref}
-\usepackage[desc]{testidx-glossaries}
+\usepackage[desc,ascii]{testidx-glossaries}
\tstidxmakegloss
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
index ee78e9178cd..ac3bd07d79e 100644
--- 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
Binary files differ
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
index 582ce035b04..06816ef5f8e 100644
--- a/Master/texmf-dist/doc/latex/testidx/samples/sample-idxgloss-xindy.pdf
+++ 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.pdf b/Master/texmf-dist/doc/latex/testidx/samples/sample-idxgloss.pdf
index de7e98a83a2..a220c9492db 100644
--- a/Master/texmf-dist/doc/latex/testidx/samples/sample-idxgloss.pdf
+++ 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
index 0b7f8b61185..3fc6661563a 100644
--- a/Master/texmf-dist/doc/latex/testidx/samples/sample-idxgloss.tex
+++ b/Master/texmf-dist/doc/latex/testidx/samples/sample-idxgloss.tex
@@ -6,7 +6,7 @@
\usepackage[T1]{fontenc}
\usepackage{amssymb}
\usepackage[a4paper,left=.75in,right=1.6in]{geometry}
-\usepackage[verbose]{testidx-glossaries}
+\usepackage[verbose,ascii]{testidx-glossaries}
\renewcommand*{\glstreenamefmt}[1]{#1}
\renewcommand*{\glstreegroupheaderfmt}[1]{\textbf{#1}}
diff --git a/Master/texmf-dist/doc/latex/testidx/samples/sample-noidxgloss.pdf b/Master/texmf-dist/doc/latex/testidx/samples/sample-noidxgloss.pdf
index 633472b549e..9dadb10e479 100644
--- a/Master/texmf-dist/doc/latex/testidx/samples/sample-noidxgloss.pdf
+++ b/Master/texmf-dist/doc/latex/testidx/samples/sample-noidxgloss.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/testidx/testidx-code.pdf b/Master/texmf-dist/doc/latex/testidx/testidx-code.pdf
index 0e30ab91a93..0374b93cd13 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.tex b/Master/texmf-dist/doc/latex/testidx/testidx-glossaries-diglyphs.tex
index 2b527e8fbfa..ff4f92b62a3 100644
--- a/Master/texmf-dist/doc/latex/testidx/testidx-glossaries-diglyphs.tex
+++ b/Master/texmf-dist/doc/latex/testidx/testidx-glossaries-diglyphs.tex
@@ -7,7 +7,7 @@
%% testidx.dtx (with options: `testidx-glossaries-diglyphs.tex,package')
%%
%% testidx.dtx
-%% Copyright 2017 Nicola Talbot
+%% Copyright 2019 Nicola Talbot
%%
%% This work may be distributed and/or modified under the
%% conditions of the LaTeX Project Public License, either version 1.3
diff --git a/Master/texmf-dist/doc/latex/testidx/testidx-glossaries-nodiglyphs.tex b/Master/texmf-dist/doc/latex/testidx/testidx-glossaries-nodiglyphs.tex
index 095662e4226..a664fa77ffb 100644
--- a/Master/texmf-dist/doc/latex/testidx/testidx-glossaries-nodiglyphs.tex
+++ b/Master/texmf-dist/doc/latex/testidx/testidx-glossaries-nodiglyphs.tex
@@ -7,7 +7,7 @@
%% testidx.dtx (with options: `testidx-glossaries-nodiglyphs.tex,package')
%%
%% testidx.dtx
-%% Copyright 2017 Nicola Talbot
+%% Copyright 2019 Nicola Talbot
%%
%% This work may be distributed and/or modified under the
%% conditions of the LaTeX Project Public License, either version 1.3
diff --git a/Master/texmf-dist/doc/latex/testidx/testidx-glossaries-samples.bib b/Master/texmf-dist/doc/latex/testidx/testidx-glossaries-samples.bib
index 4c04aa04b74..821977f7dd2 100644
--- a/Master/texmf-dist/doc/latex/testidx/testidx-glossaries-samples.bib
+++ b/Master/texmf-dist/doc/latex/testidx/testidx-glossaries-samples.bib
@@ -27,6 +27,12 @@
description={particular areas or locations}
}
+@index{subitems,
+ category={word},
+ name={sub-items},
+ description={items that have a parent entry}
+}
+
@index{applications,
category={word},
description={computer programs}
@@ -877,7 +883,7 @@ something}
@index{seal,
category={word},
- description={seal-dwelling fish-eating mammal with flippers}
+ description={sea-dwelling fish-eating mammal with flippers}
}
@index{sea,
@@ -1106,6 +1112,13 @@ the sovereign}
description={attributes such as page size}
}
+@index{subitems.lonely,
+ name={lonely},
+ parent={subitems},
+ category={word},
+ description={a sub-item that doesn't have any siblings}
+}
+
@index{fontencoding.OT1,
name={OT1},
parent={fontencoding},
diff --git a/Master/texmf-dist/doc/latex/testidx/testidx-glossaries-samples.tex b/Master/texmf-dist/doc/latex/testidx/testidx-glossaries-samples.tex
index 01e6208ad97..85a6cf5f1d7 100644
--- a/Master/texmf-dist/doc/latex/testidx/testidx-glossaries-samples.tex
+++ b/Master/texmf-dist/doc/latex/testidx/testidx-glossaries-samples.tex
@@ -7,7 +7,7 @@
%% testidx.dtx (with options: `testidx-glossaries-samples.tex,package')
%%
%% testidx.dtx
-%% Copyright 2017 Nicola Talbot
+%% Copyright 2019 Nicola Talbot
%%
%% This work may be distributed and/or modified under the
%% conditions of the LaTeX Project Public License, either version 1.3
@@ -45,6 +45,7 @@ design or provide new commands}
\tstidxnewword{people}{human individuals (or fictional
anthropomorphisms)}
\tstidxnewword{places}{particular areas or locations}
+\tstidxnewword{sub-items}{items that have a parent entry}
\tstidxnewword{applications}{computer programs}
\tstidxnewword{environments}{a marked-up block within the document
that requires special action or formatting}
@@ -240,7 +241,7 @@ something}
\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{seal}{sea-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}
@@ -513,6 +514,8 @@ text}
is a popular method of describing aspects of chaos theory}
\tstidxnewartphrase{The}{End}{denotes the end of a
story, especially fairy tales}
+\tstidxnewsubword{sub-items}{lonely}{a sub-item that doesn't have
+any siblings}
\tstidxnewsubword{document}{properties}{attributes such as page size}
\tstidxnewsubword{font encoding}{OT1}{one of the original font
encodings supplied with \TeX}
diff --git a/Master/texmf-dist/doc/latex/testidx/testidx-manual.pdf b/Master/texmf-dist/doc/latex/testidx/testidx-manual.pdf
index 7eedfb5ba4f..4c81af57908 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 5311acae3a8..a08bdfe22a9 100644
--- a/Master/texmf-dist/doc/latex/testidx/testidx-manual.tex
+++ b/Master/texmf-dist/doc/latex/testidx/testidx-manual.tex
@@ -27,12 +27,12 @@
\begin{document}
- \title{testidx.sty v1.1:
+ \title{testidx.sty v1.2:
dummy text for testing indexes}
\author{Nicola L.C. Talbot\\[10pt]
\url{http://www.dickimaw-books.com/}}
- \date{2017-08-11}
+ \date{2019-09-29}
\maketitle
\tableofcontents
@@ -41,7 +41,11 @@ dummy text for testing indexes}
The \styfmt{testidx} package is for testing indexes (\cs{index},
\env{theindex} and indexing applications, such as \app{makeindex}
-and \app{xindy}).
+and \app{xindy}). See also
+\href{http://tug.org/TUGboat/tb38-3/tb120talbot.pdf}{Testing
+indexes: \texttt{testidx.sty}} in
+\href{http://tug.org/TUGboat/Contents/contents38-3.html}{TUGboat issue 38:3, 2017}.
+
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 mostly English not lorum ipsum, as this makes it
@@ -112,13 +116,23 @@ 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.
+
+\item An item with just a single sub-item. (Perhaps the document
+author intended to index more sub-items but they weren't needed in
+the end.) Ideally this needs to be flagged and have the hierarchy
+removed. There are actually two lonely sub-items. The first is
+\qt{properties} as a sub-item of \qt{document}. In this case the
+parent \qt{document} has also been indexed and has a location. The
+second is \qt{lonely} as a sub-item of \qt{sub-items}. In this case
+the parent \qt{sub-items} hasn't been indexed and so doesn't have a
+location.
\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
+As from version 1.1, \sty{testidx} now comes with a supplementary package
\sty{testidx-glossaries} which provides a similar way of testing the
\sty{glossaries} or \sty{glossaries-extra} package.
@@ -150,6 +164,24 @@ There will be warnings about multiple encaps. This is intentional
to test how the indexing applications deal with this problem.
\end{important}
+Note that as from 2018, \LaTeX\ now automatically provides limited
+UTF-8 support even if the document doesn't load \sty{inputenc}. Therefore
+the above document will use the ASCII indexing tests with pre-2018
+\LaTeX, but will use the UTF-8 indexing tests with newer versions of
+the \LaTeX\ kernel (because \cs{inputencodingname} is now defined as
+\texttt{utf8}). If you specifically want to test ASCII indexing
+then you either need to switch to ASCII encoding:
+\begin{verbatim}
+\usepackage[ascii]{inputenc}
+\usepackage{makeidx}
+\usepackage{testidx}
+\end{verbatim}
+or use \sty{testidx}'s \pkgopt{ascii} option:
+\begin{verbatim}
+\usepackage{makeidx}
+\usepackage[ascii]{testidx}
+\end{verbatim}
+
If you want to use \app{xindy}, you'll need to define the
attributes (encaps) used in the dummy text. For example:
\begin{verbatim}
@@ -272,7 +304,7 @@ For example:
\usepackage{filecontents}
\usepackage{makeidx}
\usepackage{ngerman}
-\usepackage[german]{testidx}
+\usepackage[german,ascii]{testidx}
\begin{filecontents*}{\jobname.ist}
quote '+'
@@ -302,7 +334,7 @@ Alternatively:
\usepackage{filecontents}
\usepackage{makeidx}
\usepackage{babel}
-\usepackage{testidx}
+\usepackage[ascii]{testidx}
\begin{filecontents*}{\jobname.ist}
quote '+'
@@ -324,7 +356,7 @@ The \styfmt{testidx-glossaries} package automatically loads
\documentclass{report}
\usepackage[T1]{fontenc}
-\usepackage{testidx-glossaries}
+\usepackage[ascii]{testidx-glossaries}
\renewcommand*{\glstreenamefmt}[1]{#1}
@@ -358,6 +390,15 @@ redefined in the above example to simply do its argument.
The following package options are provided:
\begin{description}
+\item[\pkgopt{ascii}] Use only ASCII tests even if the document
+supports UTF-8. Any characters outside
+that range are produced with \LaTeX\ commands.
+
+\item[\pkgopt{noascii}] (Default.) Don't enforce ASCII tests. This option
+doesn't actually provide UTF-8 support but will simply
+determine whether or not to use ASCII tests depending on the
+document's input encoding.
+
\item[\pkgopt{german} or \pkgopt{ngerman}]
This redefines the indexing \qt{quote} character to use \texttt{+}
instead of the double-quote character. Remember to add this
@@ -412,6 +453,10 @@ This option may also be implemented using
\begin{definition}[\DescribeMacro\testidxSanitizeOff]
\cs{testidxSanitizeOff}
\end{definition}
+Note that as from \LaTeX\ 2019/10/01 UTF-8 characters are no longer
+expanded while they are written to the \texttt{.idx} file. This
+means that there may be no difference between \pkgopt{sanitize} and
+\pkgopt{nosanitize} depending on the \LaTeX\ kernel in use.
\item[\pkgopt{showmarks}]
(Default.) Show the location of the \cs{index} commands
@@ -1026,12 +1071,16 @@ The \qt{close range} character. The default is:
\label{sec:exlatin}
The dummy text includes words or phrases that have extended
-Latin characters. There are two modes:
+Latin characters. (The document encoding should be correctly set
+before loading \sty{testidx}.) There are two modes:
\begin{description}
-\item[ASCII] This mode is on \emph{unless} you are using
-\XeLaTeX\ or \LuaLaTeX, or the document has loaded
-\sty{inputenc} with the encoding set to \pkgopt{utf8}.
+\item[ASCII] This mode is on by default \emph{unless} you are using
+\XeLaTeX\ or \LuaLaTeX, or the document has the encoding set to \pkgopt{utf8}.
+Note that with new versions of \LaTeX, \cs{inputencodingname} is now
+automatically defined as \pkgopt{utf8} by the kernel. You can
+explicitly switch this mode on with the \pkgopt{ascii} package
+option.
Example that will switch on ASCII mode:
\begin{verbatim}
@@ -1049,12 +1098,30 @@ Example that will switch on ASCII mode:
\printindex
\end{document}
\end{verbatim}
+(With new versions of \LaTeX\ this document will start with
+\cs{inputencodingname} set to \texttt{utf8} and then it will be
+changed to \texttt{latin1} when \sty{inputenc} is loaded.)
+
+Alternatively use the \pkgopt{ascii} package option:
+\begin{verbatim}
+\documentclass{article}
-\item[UTF-8] This mode is on \emph{if} you are using
-\XeLaTeX\ or \LuaLaTeX, or if the document has loaded
-\sty{inputenc} with the encoding set to \pkgopt{utf8}.
+\usepackage{makeidx}
+\usepackage[ascii]{testidx}
-Example that will switch on UTF-8 mode:
+\makeindex
+
+\begin{document}
+\testidx
+
+\printindex
+\end{document}
+\end{verbatim}
+
+\item[UTF-8] This mode is on by default \emph{if} you are using
+\XeLaTeX\ or \LuaLaTeX, or if \cs{inputencodingname} is set to \pkgopt{utf8}.
+
+Example that will switch on UTF-8 mode (\XeLaTeX\ or \LuaLaTeX):
\begin{verbatim}
\documentclass{article}
@@ -1070,7 +1137,7 @@ Example that will switch on UTF-8 mode:
\printindex
\end{document}
\end{verbatim}
-Or
+Or (\sty{inputenc} sets the encoding to UTF-8):
\begin{verbatim}
\documentclass{article}
@@ -1087,13 +1154,30 @@ Or
\printindex
\end{document}
\end{verbatim}
+Or with new versions of the \LaTeX\ kernel (which automatically
+provides UTF-8 support):
+\begin{verbatim}
+\documentclass{article}
+
+\usepackage[T1]{fontenc}
+\usepackage{makeidx}
+\usepackage{testidx}
+
+\makeindex
+
+\begin{document}
+\testidx
+
+\printindex
+\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
+such as \tstidxqt{th} aren't affected by this option.) For example:
\begin{verbatim}
\documentclass{article}
@@ -1174,7 +1258,7 @@ above will appear in the \texttt{.idx} file as:
\end{verbatim}
(where 3 is the page number).
-Since this can confuse the indexing application,
+Since this expansion can confuse the indexing application,
\styfmt{testidx} provides a \pkgopt{sanitize} package option
which will first sanitize the UTF-8 characters before
indexing them. This option is on by default for regular \LaTeX\ and
@@ -1188,6 +1272,13 @@ if you want to test how your indexing command (whatever
\cs{tstindex} is defined as) behaves with these characters, then
switch it off.
+\begin{important}
+As from \LaTeX\ 2019/10/01 this behaviour has changed and the UTF-8
+characters are no longer expanded while they are written to the
+\texttt{.idx} file. This means that the tests may produce different
+results depending on the \LaTeX\ kernel in use.
+\end{important}
+
Note that this \pkgopt{sanitize} option isn't adjusting the
definition of \cs{index} or \cs{tstindex}, but is essentially
pretending that the user is doing something like: