branch master updated: * doc/texinfo.texi (Other Customization Variables), * NEWS: Document USE_UNICODE_COLLATION.

[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 cb472fffa8 * doc/texinfo.texi (Other Customization Variables), * NEWS: 
Document USE_UNICODE_COLLATION.
cb472fffa8 is described below

commit cb472fffa8b51a4580ba16c8024382cbbaff520d
Author: Gavin Smith <gavinsmith0123@gmail.com>
AuthorDate: Mon Jan 29 19:18:54 2024 +0000

    * doc/texinfo.texi (Other Customization Variables),
    * NEWS: Document USE_UNICODE_COLLATION.
---
 ChangeLog        |  5 +++++
 NEWS             |  2 ++
 doc/texinfo.texi | 20 ++++++++++++++++++++
 3 files changed, 27 insertions(+)

diff --git a/ChangeLog b/ChangeLog
index c7566c4c25..8e893ef4b6 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,8 @@
+2024-01-29  Gavin Smith <gavinsmith0123@gmail.com>
+
+       * doc/texinfo.texi (Other Customization Variables),
+       * NEWS: Document USE_UNICODE_COLLATION.
+
 2024-01-29  Patrice Dumas  <pertusus@free.fr>
 
        Add @verbatiminclude files to --trace-includes output
diff --git a/NEWS b/NEWS
index 1694f95dda..d3ade883b4 100644
--- a/NEWS
+++ b/NEWS
@@ -16,6 +16,8 @@ See the manual for detailed information.
 * texi2any
  . info output: output Info-documentlanguage in Local Variables section
    of output file if @documentlanguage is given
+ . new variable USE_UNICODE_COLLATION to allow turning off the slower
+   use of Unicode collation when sorting indices
  . remove SIMPLE_MENU customization option and tree transformation.
  . remove FRAMES and FRAMESET_DOCTYPE customization options.
  . set CHECK_NORMAL_MENU_STRUCTURE in the default case.
diff --git a/doc/texinfo.texi b/doc/texinfo.texi
index cbb9e90621..0c7b379d3b 100644
--- a/doc/texinfo.texi
+++ b/doc/texinfo.texi
@@ -16536,6 +16536,26 @@ Default is on for Info, off for other output.  If set, 
use exactly
 what @code{@@setfilename} gives for the output file name, including
 the extension.  You should not need to explicitly set this variable.
 
+@pindex Unicode::Collate
+@item USE_UNICODE_COLLATION
+By default, @command{texi2any} sorts document indices according to
+the @dfn{Unicode Collation Algorithm} (defined in
+@uref{http://www.unicode.org/reports/tr10/, Unicode Technical Standard #10}),
+which performs a @dfn{multi-level} ordering of strings containing Unicode
+code points.  (To do this, the program uses the @code{Unicode::Collate}
+module, a standard part of Perl installations.)  However, the use of
+this algorithm incurs noticeably longer run times when processing manuals
+with large indices.
+
+Set this variable to @samp{0} to use a simpler, faster sorting algorithm
+which only uses Perl's built-in string comparison.
+
+You may find this useful for speeding up @command{texi2any} if you don't
+have many non-ASCII characters in index entry text, or if you don't care
+about having the indices sorted correctly, especially when working on
+the draft of a manual.
+
+
 @pindex Text::Unidecode
 @item USE_UNIDECODE
 If set to false, do not use the @code{Text::Unidecode} Perl module to