branch master updated: * doc/texinfo.texi (Indexing Commands): Advice on empty index sort keys. Report from Werner.

[Gavin D. Smith]

This is an automated email from the git hooks/post-receive script.

gavin pushed a commit to branch master
in repository texinfo.

The following commit(s) were added to refs/heads/master by this push:
     new b5d32aaa0a * doc/texinfo.texi (Indexing Commands): Advice on empty 
index sort keys.  Report from Werner.
b5d32aaa0a is described below

commit b5d32aaa0a67794d0324b0f9d5b726df80c8dee3
Author: Gavin Smith <gavinsmith0123@gmail.com>
AuthorDate: Sun Nov 6 21:13:25 2022 +0000

    * doc/texinfo.texi (Indexing Commands):
    Advice on empty index sort keys.  Report from Werner.
---
 ChangeLog        |  5 +++++
 doc/texinfo.texi | 14 ++++++++++++--
 2 files changed, 17 insertions(+), 2 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index 0fb738a8fd..c300465803 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,8 @@
+2022-11-06  Gavin Smith  <gavinsmith0123@gmail.com>
+
+       * doc/texinfo.texi (Indexing Commands):
+       Advice on empty index sort keys.  Report from Werner.
+
 2022-11-01  Patrice Dumas  <pertusus@free.fr>
 
        * doc/texinfo.texi (Internationalization of Document Strings):
diff --git a/doc/texinfo.texi b/doc/texinfo.texi
index 5ac6c2f43a..29298b2477 100644
--- a/doc/texinfo.texi
+++ b/doc/texinfo.texi
@@ -8661,8 +8661,7 @@ produces under backslash.
 @vindex txiindexhyphenignore
 @vindex txiindexlessthanignore
 @vindex txiindexatsignignore
-To reduce the quantity of sort keys you need to provide explicitly,
-you may choose to ignore certain characters in index entries
+You may choose to ignore certain characters in index entries
 for the purposes of sorting.  The characters that you can
 currently choose to ignore are @samp{\}, @samp{-}, @samp{<}
 and @samp{@@}, which are ignored by giving as an argument to the
@@ -8672,6 +8671,17 @@ and @samp{@@}, which are ignored by giving as an 
argument to the
 txiindexbackslashignore} causes the @samp{\mathopsup} entry in the
 index for this manual to be sorted as if it were @samp{mathopsup},
 so that it appears among the other entries beginning with `M'.
+This avoids the need to provide explicit sort keys for index
+entries containing these characters.
+
+When using these options, it is possible to get an index entry with
+an empty sort key.  To avoid this, specify a @code{@@sortas} directive
+in the index entry.  For example:
+
+@example
+@@set txiindexbackslashignore
+@@findex @@sortas@{\@} \
+@end example
 
 
 @node Advanced Indexing