branch master updated: Document DOCUMENTLANGUAGE_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 38adc883d9 Document DOCUMENTLANGUAGE_COLLATION.
38adc883d9 is described below

commit 38adc883d9a0814494b371ceabd496b0d2327d2b
Author: Gavin Smith <gavinsmith0123@gmail.com>
AuthorDate: Wed Feb 14 20:34:51 2024 +0000

    Document DOCUMENTLANGUAGE_COLLATION.
    
    * doc/texinfo.texi (Other Customization Variables):
    Document DOCUMENTLANGUAGE_COLLATION.
    (@documentlanguage): Reference DOCUMENTLANGUAGE_COLLATION.
---
 ChangeLog        |  8 ++++++++
 doc/texinfo.texi | 30 +++++++++++++++++++++---------
 2 files changed, 29 insertions(+), 9 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index f83d88fc7c..9733a90fd4 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,11 @@
+2024-02-14  Gavin Smith <gavinsmith0123@gmail.com>
+
+       Document DOCUMENTLANGUAGE_COLLATION.
+
+       * doc/texinfo.texi (Other Customization Variables):
+       Document DOCUMENTLANGUAGE_COLLATION.
+       (@documentlanguage): Reference DOCUMENTLANGUAGE_COLLATION.
+
 2024-02-14  Patrice Dumas  <pertusus@free.fr>
 
        * tp/Texinfo/XS/main/manipulate_indices.c (setup_collator): warn if
diff --git a/doc/texinfo.texi b/doc/texinfo.texi
index b3b4eeeeaf..4400cb6e93 100644
--- a/doc/texinfo.texi
+++ b/doc/texinfo.texi
@@ -11805,12 +11805,16 @@ example, @code{de} is equivalent to @code{de_DE} 
(German as spoken in
 Germany).
 
 @cindex Document strings, translation of
-For Info and other online output, this command changes the translation
-of various @dfn{document strings} such as ``see'' in cross-references
-(@pxref{Cross References}), ``Function'' in defuns (@pxref{Definition
-Commands}), and so on.  Some strings, such as ``Node:'', ``Next:'',
-``Menu:'', etc., are keywords in Info output, so are not translated
-there; they are translated in other output formats.
+This command changes the translation of various @dfn{document strings}
+such as ``see'' in cross-references (@pxref{Cross References}),
+``Function'' in defuns (@pxref{Definition Commands}), and so on.
+Optionally, this command may also affect how @command{texi2any}
+sorts indices (@pxref{Other Customization Variables}, under
+@code{DOCUMENTLANGUAGE_COLLATION}).
+
+Note that in Info output, some strings, such as ``Node:'', ``Next:'',
+``Menu:'', etc., are keywords and so are not translated.
+
 In DocBook output @code{@@documentlanguage} sets the language for
 following sections.
 
@@ -16166,9 +16170,9 @@ By default, @command{texi2any} sorts document indices 
according to the
 without language-specific collation tailoring.  If set, use the language
 for linguistic tailoring of index sorting.
 
-@command{texi2any} gives no warning if there is no support for linguistic
-tailoring, either due to missing software or missing support for the
-specified language.
+Currently, @command{texi2any} gives no warning if there is no support
+for linguistic tailoring due to either missing software or missing
+support for the specified language.
 
 In Perl, the @code{Unicode::Collate::Locale} module is used for linguistic
 tailoring; therefore if this module is not installed, the variable will be
@@ -16177,6 +16181,8 @@ silently ignored.
 If @code{USE_UNICODE_COLLATION} is set to @samp{0}, there is no Unicode
 collation and so no linguistic tailoring either.
 
+See also the @code{DOCUMENTLANGUAGE_COLLATION} variable, described below.
+
 @item COMMAND_LINE_ENCODING
 Encoding used to decode command-line arguments.  Default is based on the locale
 encoding.  This may affect file names inserted into output files or error
@@ -16227,6 +16233,12 @@ retrieve the entity, and identifies the canonical DTD 
for the
 document.  The default value is different for each of HTML, DocBook
 and XML.
 
+@item DOCUMENTLANGUAGE_COLLATION
+If set, try to use the language specified in a @code{@@documentlanguage}
+directive for language-specific tailoring of index sorting.
+See also the @code{COLLATION_LANGUAGE} variable, described above.
+(@xref{@code{@@documentlanguage}}.)
+
 @item DUMP_TEXI
 For debugging.  If set, no conversion is done, only parsing and macro
 expansion.  If the option @option{--macro-expand} is set, the Texinfo