texlive[52213] Master/texmf-dist: testidx (29sep19)

commits+karl at tug.org commits+karl at tug.org
Sun Sep 29 23:15:11 CEST 2019


Revision: 52213
          http://tug.org/svn/texlive?view=revision&revision=52213
Author:   karl
Date:     2019-09-29 23:15:10 +0200 (Sun, 29 Sep 2019)
Log Message:
-----------
testidx (29sep19)

Modified Paths:
--------------
    trunk/Master/texmf-dist/doc/latex/testidx/CHANGES
    trunk/Master/texmf-dist/doc/latex/testidx/README
    trunk/Master/texmf-dist/doc/latex/testidx/samples/sample-idx-a4.pdf
    trunk/Master/texmf-dist/doc/latex/testidx/samples/sample-idx-amsmath.pdf
    trunk/Master/texmf-dist/doc/latex/testidx/samples/sample-idx-babel-german.pdf
    trunk/Master/texmf-dist/doc/latex/testidx/samples/sample-idx-babel-german.tex
    trunk/Master/texmf-dist/doc/latex/testidx/samples/sample-idx-german.pdf
    trunk/Master/texmf-dist/doc/latex/testidx/samples/sample-idx-german.tex
    trunk/Master/texmf-dist/doc/latex/testidx/samples/sample-idx-hyp.pdf
    trunk/Master/texmf-dist/doc/latex/testidx/samples/sample-idx-letter.pdf
    trunk/Master/texmf-dist/doc/latex/testidx/samples/sample-idx-lua.pdf
    trunk/Master/texmf-dist/doc/latex/testidx/samples/sample-idx-lua.tex
    trunk/Master/texmf-dist/doc/latex/testidx/samples/sample-idx-subset.pdf
    trunk/Master/texmf-dist/doc/latex/testidx/samples/sample-idx-t1.pdf
    trunk/Master/texmf-dist/doc/latex/testidx/samples/sample-idx-utf8.pdf
    trunk/Master/texmf-dist/doc/latex/testidx/samples/sample-idx-utf8.tex
    trunk/Master/texmf-dist/doc/latex/testidx/samples/sample-idx-xe-digraphs.pdf
    trunk/Master/texmf-dist/doc/latex/testidx/samples/sample-idx-xe-digraphs.tex
    trunk/Master/texmf-dist/doc/latex/testidx/samples/sample-idx-xe.pdf
    trunk/Master/texmf-dist/doc/latex/testidx/samples/sample-idx-xe.tex
    trunk/Master/texmf-dist/doc/latex/testidx/samples/sample-idx.pdf
    trunk/Master/texmf-dist/doc/latex/testidx/samples/sample-idxgloss-bib2gls-xe.pdf
    trunk/Master/texmf-dist/doc/latex/testidx/samples/sample-idxgloss-bib2gls.pdf
    trunk/Master/texmf-dist/doc/latex/testidx/samples/sample-idxgloss-desc.pdf
    trunk/Master/texmf-dist/doc/latex/testidx/samples/sample-idxgloss-desc.tex
    trunk/Master/texmf-dist/doc/latex/testidx/samples/sample-idxgloss-xe-digraphs.pdf
    trunk/Master/texmf-dist/doc/latex/testidx/samples/sample-idxgloss-xindy.pdf
    trunk/Master/texmf-dist/doc/latex/testidx/samples/sample-idxgloss.pdf
    trunk/Master/texmf-dist/doc/latex/testidx/samples/sample-idxgloss.tex
    trunk/Master/texmf-dist/doc/latex/testidx/samples/sample-noidxgloss.pdf
    trunk/Master/texmf-dist/doc/latex/testidx/testidx-code.pdf
    trunk/Master/texmf-dist/doc/latex/testidx/testidx-glossaries-diglyphs.tex
    trunk/Master/texmf-dist/doc/latex/testidx/testidx-glossaries-nodiglyphs.tex
    trunk/Master/texmf-dist/doc/latex/testidx/testidx-glossaries-samples.bib
    trunk/Master/texmf-dist/doc/latex/testidx/testidx-glossaries-samples.tex
    trunk/Master/texmf-dist/doc/latex/testidx/testidx-manual.pdf
    trunk/Master/texmf-dist/doc/latex/testidx/testidx-manual.tex
    trunk/Master/texmf-dist/source/latex/testidx/testidx.dtx
    trunk/Master/texmf-dist/source/latex/testidx/testidx.ins
    trunk/Master/texmf-dist/tex/latex/testidx/testidx-glossaries.sty
    trunk/Master/texmf-dist/tex/latex/testidx/testidx.sty

Modified: trunk/Master/texmf-dist/doc/latex/testidx/CHANGES
===================================================================
--- trunk/Master/texmf-dist/doc/latex/testidx/CHANGES	2019-09-29 21:14:48 UTC (rev 52212)
+++ trunk/Master/texmf-dist/doc/latex/testidx/CHANGES	2019-09-29 21:15:10 UTC (rev 52213)
@@ -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

Modified: trunk/Master/texmf-dist/doc/latex/testidx/README
===================================================================
--- trunk/Master/texmf-dist/doc/latex/testidx/README	2019-09-29 21:14:48 UTC (rev 52212)
+++ trunk/Master/texmf-dist/doc/latex/testidx/README	2019-09-29 21:15:10 UTC (rev 52213)
@@ -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 @@
 \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
 

Modified: trunk/Master/texmf-dist/doc/latex/testidx/samples/sample-idx-a4.pdf
===================================================================
(Binary files differ)

Modified: trunk/Master/texmf-dist/doc/latex/testidx/samples/sample-idx-amsmath.pdf
===================================================================
(Binary files differ)

Modified: trunk/Master/texmf-dist/doc/latex/testidx/samples/sample-idx-babel-german.pdf
===================================================================
(Binary files differ)

Modified: trunk/Master/texmf-dist/doc/latex/testidx/samples/sample-idx-babel-german.tex
===================================================================
--- trunk/Master/texmf-dist/doc/latex/testidx/samples/sample-idx-babel-german.tex	2019-09-29 21:14:48 UTC (rev 52212)
+++ trunk/Master/texmf-dist/doc/latex/testidx/samples/sample-idx-babel-german.tex	2019-09-29 21:15:10 UTC (rev 52213)
@@ -18,7 +18,7 @@
 \usepackage{filecontents}
 \usepackage{makeidx}
 \usepackage{babel}
-\usepackage{testidx}
+\usepackage[ascii]{testidx}
 
 \providecommand*\lettergroup[1]{%
   \par\textbf{#1}\par

Modified: trunk/Master/texmf-dist/doc/latex/testidx/samples/sample-idx-german.pdf
===================================================================
(Binary files differ)

Modified: trunk/Master/texmf-dist/doc/latex/testidx/samples/sample-idx-german.tex
===================================================================
--- trunk/Master/texmf-dist/doc/latex/testidx/samples/sample-idx-german.tex	2019-09-29 21:14:48 UTC (rev 52212)
+++ trunk/Master/texmf-dist/doc/latex/testidx/samples/sample-idx-german.tex	2019-09-29 21:15:10 UTC (rev 52213)
@@ -18,7 +18,7 @@
 \usepackage{filecontents}
 \usepackage{makeidx}
 \usepackage{ngerman}
-\usepackage[german]{testidx}
+\usepackage[german,ascii]{testidx}
 
 \providecommand*\lettergroup[1]{%
   \par\textbf{#1}\par

Modified: trunk/Master/texmf-dist/doc/latex/testidx/samples/sample-idx-hyp.pdf
===================================================================
(Binary files differ)

Modified: trunk/Master/texmf-dist/doc/latex/testidx/samples/sample-idx-letter.pdf
===================================================================
(Binary files differ)

Modified: trunk/Master/texmf-dist/doc/latex/testidx/samples/sample-idx-lua.pdf
===================================================================
(Binary files differ)

Modified: trunk/Master/texmf-dist/doc/latex/testidx/samples/sample-idx-lua.tex
===================================================================
--- trunk/Master/texmf-dist/doc/latex/testidx/samples/sample-idx-lua.tex	2019-09-29 21:14:48 UTC (rev 52212)
+++ trunk/Master/texmf-dist/doc/latex/testidx/samples/sample-idx-lua.tex	2019-09-29 21:15:10 UTC (rev 52213)
@@ -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}
 

Modified: trunk/Master/texmf-dist/doc/latex/testidx/samples/sample-idx-subset.pdf
===================================================================
(Binary files differ)

Modified: trunk/Master/texmf-dist/doc/latex/testidx/samples/sample-idx-t1.pdf
===================================================================
(Binary files differ)

Modified: trunk/Master/texmf-dist/doc/latex/testidx/samples/sample-idx-utf8.pdf
===================================================================
(Binary files differ)

Modified: trunk/Master/texmf-dist/doc/latex/testidx/samples/sample-idx-utf8.tex
===================================================================
--- trunk/Master/texmf-dist/doc/latex/testidx/samples/sample-idx-utf8.tex	2019-09-29 21:14:48 UTC (rev 52212)
+++ trunk/Master/texmf-dist/doc/latex/testidx/samples/sample-idx-utf8.tex	2019-09-29 21:15:10 UTC (rev 52213)
@@ -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}
 

Modified: trunk/Master/texmf-dist/doc/latex/testidx/samples/sample-idx-xe-digraphs.pdf
===================================================================
(Binary files differ)

Modified: trunk/Master/texmf-dist/doc/latex/testidx/samples/sample-idx-xe-digraphs.tex
===================================================================
--- trunk/Master/texmf-dist/doc/latex/testidx/samples/sample-idx-xe-digraphs.tex	2019-09-29 21:14:48 UTC (rev 52212)
+++ trunk/Master/texmf-dist/doc/latex/testidx/samples/sample-idx-xe-digraphs.tex	2019-09-29 21:15:10 UTC (rev 52213)
@@ -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}
 

Modified: trunk/Master/texmf-dist/doc/latex/testidx/samples/sample-idx-xe.pdf
===================================================================
(Binary files differ)

Modified: trunk/Master/texmf-dist/doc/latex/testidx/samples/sample-idx-xe.tex
===================================================================
--- trunk/Master/texmf-dist/doc/latex/testidx/samples/sample-idx-xe.tex	2019-09-29 21:14:48 UTC (rev 52212)
+++ trunk/Master/texmf-dist/doc/latex/testidx/samples/sample-idx-xe.tex	2019-09-29 21:15:10 UTC (rev 52213)
@@ -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}
 

Modified: trunk/Master/texmf-dist/doc/latex/testidx/samples/sample-idx.pdf
===================================================================
(Binary files differ)

Modified: trunk/Master/texmf-dist/doc/latex/testidx/samples/sample-idxgloss-bib2gls-xe.pdf
===================================================================
(Binary files differ)

Modified: trunk/Master/texmf-dist/doc/latex/testidx/samples/sample-idxgloss-bib2gls.pdf
===================================================================
(Binary files differ)

Modified: trunk/Master/texmf-dist/doc/latex/testidx/samples/sample-idxgloss-desc.pdf
===================================================================
(Binary files differ)

Modified: trunk/Master/texmf-dist/doc/latex/testidx/samples/sample-idxgloss-desc.tex
===================================================================
--- trunk/Master/texmf-dist/doc/latex/testidx/samples/sample-idxgloss-desc.tex	2019-09-29 21:14:48 UTC (rev 52212)
+++ trunk/Master/texmf-dist/doc/latex/testidx/samples/sample-idxgloss-desc.tex	2019-09-29 21:15:10 UTC (rev 52213)
@@ -5,7 +5,7 @@
 
 \usepackage[T1]{fontenc}
 \usepackage[hidelinks]{hyperref}
-\usepackage[desc]{testidx-glossaries}
+\usepackage[desc,ascii]{testidx-glossaries}
 
 \tstidxmakegloss
 

Modified: trunk/Master/texmf-dist/doc/latex/testidx/samples/sample-idxgloss-xe-digraphs.pdf
===================================================================
(Binary files differ)

Modified: trunk/Master/texmf-dist/doc/latex/testidx/samples/sample-idxgloss-xindy.pdf
===================================================================
(Binary files differ)

Modified: trunk/Master/texmf-dist/doc/latex/testidx/samples/sample-idxgloss.pdf
===================================================================
(Binary files differ)

Modified: trunk/Master/texmf-dist/doc/latex/testidx/samples/sample-idxgloss.tex
===================================================================
--- trunk/Master/texmf-dist/doc/latex/testidx/samples/sample-idxgloss.tex	2019-09-29 21:14:48 UTC (rev 52212)
+++ trunk/Master/texmf-dist/doc/latex/testidx/samples/sample-idxgloss.tex	2019-09-29 21:15:10 UTC (rev 52213)
@@ -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}}

Modified: trunk/Master/texmf-dist/doc/latex/testidx/samples/sample-noidxgloss.pdf
===================================================================
(Binary files differ)

Modified: trunk/Master/texmf-dist/doc/latex/testidx/testidx-code.pdf
===================================================================
(Binary files differ)

Modified: trunk/Master/texmf-dist/doc/latex/testidx/testidx-glossaries-diglyphs.tex
===================================================================
--- trunk/Master/texmf-dist/doc/latex/testidx/testidx-glossaries-diglyphs.tex	2019-09-29 21:14:48 UTC (rev 52212)
+++ trunk/Master/texmf-dist/doc/latex/testidx/testidx-glossaries-diglyphs.tex	2019-09-29 21:15:10 UTC (rev 52213)
@@ -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

Modified: trunk/Master/texmf-dist/doc/latex/testidx/testidx-glossaries-nodiglyphs.tex
===================================================================
--- trunk/Master/texmf-dist/doc/latex/testidx/testidx-glossaries-nodiglyphs.tex	2019-09-29 21:14:48 UTC (rev 52212)
+++ trunk/Master/texmf-dist/doc/latex/testidx/testidx-glossaries-nodiglyphs.tex	2019-09-29 21:15:10 UTC (rev 52213)
@@ -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

Modified: trunk/Master/texmf-dist/doc/latex/testidx/testidx-glossaries-samples.bib
===================================================================
--- trunk/Master/texmf-dist/doc/latex/testidx/testidx-glossaries-samples.bib	2019-09-29 21:14:48 UTC (rev 52212)
+++ trunk/Master/texmf-dist/doc/latex/testidx/testidx-glossaries-samples.bib	2019-09-29 21:15:10 UTC (rev 52213)
@@ -27,6 +27,12 @@
   description={particular areas or locations}
 }
 
+ at 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 @@
 
 @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 @@
   description={attributes such as page size}
 }
 
+ at 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},

Modified: trunk/Master/texmf-dist/doc/latex/testidx/testidx-glossaries-samples.tex
===================================================================
--- trunk/Master/texmf-dist/doc/latex/testidx/testidx-glossaries-samples.tex	2019-09-29 21:14:48 UTC (rev 52212)
+++ trunk/Master/texmf-dist/doc/latex/testidx/testidx-glossaries-samples.tex	2019-09-29 21:15:10 UTC (rev 52213)
@@ -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 @@
 \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 @@
 \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 @@
 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}

Modified: trunk/Master/texmf-dist/doc/latex/testidx/testidx-manual.pdf
===================================================================
(Binary files differ)

Modified: trunk/Master/texmf-dist/doc/latex/testidx/testidx-manual.tex
===================================================================
--- trunk/Master/texmf-dist/doc/latex/testidx/testidx-manual.tex	2019-09-29 21:14:48 UTC (rev 52212)
+++ trunk/Master/texmf-dist/doc/latex/testidx/testidx-manual.tex	2019-09-29 21:15:10 UTC (rev 52213)
@@ -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 @@
 
 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,6 +116,16 @@
 \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
@@ -118,7 +132,7 @@
 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 @@
 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 @@
 \usepackage{filecontents}
 \usepackage{makeidx}
 \usepackage{ngerman}
-\usepackage[german]{testidx}
+\usepackage[german,ascii]{testidx}
 
 \begin{filecontents*}{\jobname.ist}
 quote '+'
@@ -302,7 +334,7 @@
 \usepackage{filecontents}
 \usepackage{makeidx}
 \usepackage{babel}
-\usepackage{testidx}
+\usepackage[ascii]{testidx}
 
 \begin{filecontents*}{\jobname.ist}
 quote '+'
@@ -324,7 +356,7 @@
 \documentclass{report}
 
 \usepackage[T1]{fontenc}
-\usepackage{testidx-glossaries}
+\usepackage[ascii]{testidx-glossaries}
 
 \renewcommand*{\glstreenamefmt}[1]{#1}
 
@@ -358,6 +390,15 @@
 
 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 @@
 \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 @@
 \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 @@
 \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.)
 
-\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}.
+Alternatively use the \pkgopt{ascii} package option:
+\begin{verbatim}
+\documentclass{article}
 
-Example that will switch on UTF-8 mode:
+\usepackage{makeidx}
+\usepackage[ascii]{testidx}
+
+\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 @@
 \printindex
 \end{document}
 \end{verbatim}
-Or
+Or (\sty{inputenc} sets the encoding to UTF-8):
 \begin{verbatim}
 \documentclass{article}
 
@@ -1087,13 +1154,30 @@
 \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 @@
 \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 @@
 \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:

Modified: trunk/Master/texmf-dist/source/latex/testidx/testidx.dtx
===================================================================
--- trunk/Master/texmf-dist/source/latex/testidx/testidx.dtx	2019-09-29 21:14:48 UTC (rev 52212)
+++ trunk/Master/texmf-dist/source/latex/testidx/testidx.dtx	2019-09-29 21:15:10 UTC (rev 52213)
@@ -1,17 +1,17 @@
 %\iffalse
 % testidx.dtx generated using makedtx version 1.2 (c) Nicola Talbot
 % Command line args:
-%   -author "Nicola Talbot"
-%   -doc "testidx-codedoc.tex"
-%   -setambles ".*\.bib=>\nopreamble\nopostamble"
-%   -codetitle "Main Package Code"
 %   -src "(testidx.sty)\Z=>\1"
 %   -src "(testidx-.*.sty)\Z=>\1"
 %   -src "(testidx-glossaries.*\.tex)\Z=>\1"
 %   -src "(testidx-glossaries.*\.bib)\Z=>\1"
+%   -setambles ".*\.bib=>\nopreamble\nopostamble"
+%   -doc "testidx-codedoc.tex"
+%   -codetitle "Main Package Code"
+%   -author "Nicola Talbot"
 %   -macrocode ".*\.bib"
 %   testidx
-% Created on 2017/8/11 12:58
+% Created on 2019/9/29 13:53
 %\fi
 %\iffalse
 %<*package>
@@ -34,7 +34,7 @@
 %\fi
 % \iffalse
 % Doc-Source file to use with LaTeX2e
-% Copyright (C) 2017 Nicola Talbot, all rights reserved.
+% Copyright (C) 2019 Nicola Talbot, all rights reserved.
 % \fi
 % \iffalse
 %<*driver>
@@ -45,6 +45,7 @@
 testidx.dtx
 \fi
 
+\usepackage{metalogo}
 \usepackage{fontspec}
 \setromanfont{FreeSerif}
 \setsansfont{FreeSans}[Scale=MatchLowercase]
@@ -61,7 +62,7 @@
 
 \setcounter{IndexColumns}{2}
 
-\CheckSum{10076}
+\CheckSum{10168}
 
 \begin{document}
 \DocInput{testidx.dtx}
@@ -71,12 +72,12 @@
 %\MakeShortVerb{"}
 %\DeleteShortVerb{\|}
 %
-% \title{Documented Code For testidx v1.1}
+% \title{Documented Code For testidx v1.2}
 % \author{Nicola L.C. Talbot\\[10pt]
 %Dickimaw Books\\
 %\url{http://www.dickimaw-books.com/}}
 %
-% \date{2017-08-11}
+% \date{2019-09-29}
 % \maketitle
 %
 %\tableofcontents
@@ -106,7 +107,7 @@
 %\section{Initialisation}
 %    \begin{macrocode}
 \NeedsTeXFormat{LaTeX2e}
-\ProvidesPackage{testidx}[2017/08/11 v1.1 (NLCT)]
+\ProvidesPackage{testidx}[2019/09/29 v1.2 (NLCT)]
 %    \end{macrocode}
 %To avoid as much conflict as possible, this package loads the
 %bare minimum, so I'm not using useful packages like \styfmt{etoolbox} or
@@ -135,9 +136,10 @@
 }
 %    \end{macrocode}
 %\end{macro}
-%\begin{macro}{\@tstidx at ifutfviii}
+%\begin{macro}{\@@tstidx at ifutfviii}
+%\changes{1.2}{2019-09-29}{renamed from \cs{@tstidx at ifutfviii}}
 %    \begin{macrocode}
-\newcommand*{\@tstidx at ifutfviii}[2]{%
+\newcommand*{\@@tstidx at ifutfviii}[2]{%
  \@tstidx at ifxelua{#1}
  {%
    \ifx\inputencodingname\@tstidx at utfviii#1\else#2\fi
@@ -146,6 +148,23 @@
 \newcommand*{\@tstidx at utfviii}{utf8}
 %    \end{macrocode}
 %\end{macro}
+%\begin{macro}{\@tstidx at ifutfviii}
+%\changes{1.2}{2019-09-29}{now let to \cs{@@tstidx at ifutfviii}}
+%    \begin{macrocode}
+\let\@tstidx at ifutfviii\@@tstidx at ifutfviii
+%    \end{macrocode}
+%\end{macro}
+%As from 2018, \LaTeX\ now automatically enables UTF-8 support, so provide
+%an option to use only ASCII in the test:
+%\changes{1.2}{2019-09-29}{added ascii and noascii options}
+%    \begin{macrocode}
+\DeclareOption{ascii}{\let\@tstidx at ifutfviii\@secondoftwo}
+%    \end{macrocode}
+%Provide option to counteract this (if document doesn't support
+%UTF-8 this won't make a difference):
+%    \begin{macrocode}
+\DeclareOption{noascii}{\let\@tstidx at ifutfviii\@@tstidx at ifutfviii}
+%    \end{macrocode}
 %
 %\begin{macro}{\tstidxprocessasciisort}
 %The first argument is a control sequence in which to store the
@@ -301,6 +320,12 @@
 }
 %    \end{macrocode}
 %\end{macro}
+%Note that as from LaTeX 2019/10/01, UTF-8 characters no longer
+%expand as they are written to the indexing file. This means that
+%there won't be a difference if the sanitizing is on or off.
+%Similarly there's no difference with \XeLaTeX\ and \LuaLaTeX\ since
+%they natively support UTF-8 and don't make extended characters
+%active anyway.
 %
 %\begin{macro}{\iftestidxdiglyphs}
 %\changes{1.1}{2017-08-11}{new}
@@ -3702,6 +3727,7 @@
 %\end{macro}
 %
 %\begin{macro}{\@tidx at par@iii}
+%\changes{1.2}{2019-09-29}{added lonely sub-item}
 %    \begin{macrocode}
 \tstidxnewblock
 {%
@@ -3812,7 +3838,8 @@
  any further sub-levels. Although \tstidxapp{xindy} allows more than
  three levels (\tstidxapp{makeindex} doesn't), it's somewhat
  \tstidxword{excessive} to go below a sub-sub-level. 
- You'll have to add your own tests for anything deeper.%
+ You'll have to add your own tests for anything deeper.
+ Watch out for \tstidxsubword{sub-items}{lonely} sub-items.%
 }
 %    \end{macrocode}
 %\end{macro}
@@ -4676,7 +4703,7 @@
 %and then used in the dummy text.
 %    \begin{macrocode}
 \NeedsTeXFormat{LaTeX2e}
-\ProvidesPackage{testidx-glossaries}[2017/08/11 v1.1 (NLCT)]
+\ProvidesPackage{testidx-glossaries}[2019/09/29 v1.2 (NLCT)]
 %    \end{macrocode}
 %
 %\begin{macro}{\tstidx at glossariespkg}
@@ -7728,9 +7755,10 @@
  any further sub-levels. Although \tstidxapp{xindy} allows more than
  three levels (\tstidxapp{makeindex} doesn't), it's somewhat
  \tstidxword{excessive} to go below a sub-sub-level.
- You'll have to add your own tests for anything deeper.%
+ You'll have to add your own tests for anything deeper.
+ Watch out for \tstidxsubword{sub-items}{lonely} sub-items.%
+}
 
-}
 \let\@tidx at org@par at iii\@tidx at par@iii
 \let\@tidx at par@iii\@tidx at gls@par at iii
 %    \end{macrocode}
@@ -8059,6 +8087,7 @@
 \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}
@@ -8257,7 +8286,7 @@
 \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}
@@ -8566,6 +8595,8 @@
 %    \end{macrocode}
 %Sub-entries (terms).
 %    \begin{macrocode}
+\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}
@@ -10512,6 +10543,12 @@
   description={particular areas or locations}
 }
 
+ at index{subitems,
+  category={word},
+  name={sub-items},
+  description={items that have a parent entry}
+}
+
 @index{applications,
   category={word},
   description={computer programs}
@@ -11362,7 +11399,7 @@
 
 @index{seal,
   category={word},
-  description={seal-dwelling fish-eating mammal with flippers}
+  description={sea-dwelling fish-eating mammal with flippers}
 }
 
 @index{sea,
@@ -11591,6 +11628,13 @@
   description={attributes such as page size}
 }
 
+ at 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},

Modified: trunk/Master/texmf-dist/source/latex/testidx/testidx.ins
===================================================================
--- trunk/Master/texmf-dist/source/latex/testidx/testidx.ins	2019-09-29 21:14:48 UTC (rev 52212)
+++ trunk/Master/texmf-dist/source/latex/testidx/testidx.ins	2019-09-29 21:15:10 UTC (rev 52213)
@@ -1,10 +1,10 @@
-% testidx.ins generated using makedtx version 1.2 2017/8/11 12:58
+% testidx.ins generated using makedtx version 1.2 2019/9/29 13:53
 \input docstrip
 
 \preamble
 
  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

Modified: trunk/Master/texmf-dist/tex/latex/testidx/testidx-glossaries.sty
===================================================================
--- trunk/Master/texmf-dist/tex/latex/testidx/testidx-glossaries.sty	2019-09-29 21:14:48 UTC (rev 52212)
+++ trunk/Master/texmf-dist/tex/latex/testidx/testidx-glossaries.sty	2019-09-29 21:15:10 UTC (rev 52213)
@@ -7,7 +7,7 @@
 %% testidx.dtx  (with options: `testidx-glossaries.sty,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
@@ -39,7 +39,7 @@
 %%   Grave accent  \`     Left brace    \{     Vertical bar  \|
 %%   Right brace   \}     Tilde         \~}
 \NeedsTeXFormat{LaTeX2e}
-\ProvidesPackage{testidx-glossaries}[2017/08/11 v1.1 (NLCT)]
+\ProvidesPackage{testidx-glossaries}[2019/09/29 v1.2 (NLCT)]
 \newcommand*{\tstidx at glossariespkg}{glossaries}
 \@ifpackageloaded{glossaries}
 {%
@@ -2227,9 +2227,10 @@
  any further sub-levels. Although \tstidxapp{xindy} allows more than
  three levels (\tstidxapp{makeindex} doesn't), it's somewhat
  \tstidxword{excessive} to go below a sub-sub-level.
- You'll have to add your own tests for anything deeper.%
+ You'll have to add your own tests for anything deeper.
+ Watch out for \tstidxsubword{sub-items}{lonely} sub-items.%
+}
 
-}
 \let\@tidx at org@par at iii\@tidx at par@iii
 \let\@tidx at par@iii\@tidx at gls@par at iii
 \newcommand*{\@tidx at gls@par at iv}{%

Modified: trunk/Master/texmf-dist/tex/latex/testidx/testidx.sty
===================================================================
--- trunk/Master/texmf-dist/tex/latex/testidx/testidx.sty	2019-09-29 21:14:48 UTC (rev 52212)
+++ trunk/Master/texmf-dist/tex/latex/testidx/testidx.sty	2019-09-29 21:15:10 UTC (rev 52213)
@@ -7,7 +7,7 @@
 %% testidx.dtx  (with options: `testidx.sty,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
@@ -39,7 +39,7 @@
 %%   Grave accent  \`     Left brace    \{     Vertical bar  \|
 %%   Right brace   \}     Tilde         \~}
 \NeedsTeXFormat{LaTeX2e}
-\ProvidesPackage{testidx}[2017/08/11 v1.1 (NLCT)]
+\ProvidesPackage{testidx}[2019/09/29 v1.2 (NLCT)]
 \RequirePackage{color}
 \RequirePackage{ifxetex}
 \RequirePackage{ifluatex}
@@ -54,7 +54,7 @@
    \fi
   \fi
 }
-\newcommand*{\@tstidx at ifutfviii}[2]{%
+\newcommand*{\@@tstidx at ifutfviii}[2]{%
  \@tstidx at ifxelua{#1}
  {%
    \ifx\inputencodingname\@tstidx at utfviii#1\else#2\fi
@@ -61,6 +61,9 @@
  }%
 }
 \newcommand*{\@tstidx at utfviii}{utf8}
+\let\@tstidx at ifutfviii\@@tstidx at ifutfviii
+\DeclareOption{ascii}{\let\@tstidx at ifutfviii\@secondoftwo}
+\DeclareOption{noascii}{\let\@tstidx at ifutfviii\@@tstidx at ifutfviii}
 \newcommand*{\tstidxprocessasciisort}{\tstidxprocessasciisortstrip}
 \newcommand*{\testidxStripAccents}{%
   \renewcommand*{\tstidxprocessasciisort}{\tstidxprocessasciisortstrip}%
@@ -2347,7 +2350,8 @@
  any further sub-levels. Although \tstidxapp{xindy} allows more than
  three levels (\tstidxapp{makeindex} doesn't), it's somewhat
  \tstidxword{excessive} to go below a sub-sub-level.
- You'll have to add your own tests for anything deeper.%
+ You'll have to add your own tests for anything deeper.
+ Watch out for \tstidxsubword{sub-items}{lonely} sub-items.%
 }
 \tstidxnewblock*{\@tidx at openrangepar}
 {%



More information about the tex-live-commits mailing list