branch master updated: * doc/texi2any_api.texi (Translation Contexts): edit.

[Patrice Dumas]

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

pertusus pushed a commit to branch master
in repository texinfo.

The following commit(s) were added to refs/heads/master by this push:
     new b0ba3439b6 * doc/texi2any_api.texi (Translation Contexts): edit.
b0ba3439b6 is described below

commit b0ba3439b677a60357042e5df6c2fe815a7544a5
Author: Patrice Dumas <pertusus@free.fr>
AuthorDate: Thu Nov 10 08:57:33 2022 +0100

    * doc/texi2any_api.texi (Translation Contexts): edit.
---
 ChangeLog             |  4 ++++
 doc/texi2any_api.texi | 19 +++++++++++++------
 2 files changed, 17 insertions(+), 6 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index b875e4e4b3..083b557abb 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,7 @@
+2022-11-10  Patrice Dumas  <pertusus@free.fr>
+
+       * doc/texi2any_api.texi (Translation Contexts): edit.
+
 2022-11-10  Patrice Dumas  <pertusus@free.fr>
 
        * doc/texi2any_api.texi (Translations Output and Customization):
diff --git a/doc/texi2any_api.texi b/doc/texi2any_api.texi
index d1f771a16f..66ac7676c2 100644
--- a/doc/texi2any_api.texi
+++ b/doc/texi2any_api.texi
@@ -3079,9 +3079,11 @@ 
texinfo_register_formatting_function('format_translate_string',
 @node Translation Contexts
 @section Translation Contexts
 
-Translation contexts are for translated direction strings (@pxref{Direction
-Strings}) and for special elements headings (@pxref{Common Customization of
-Special Elements}).
+Translation contexts may be set to avoid ambiguities for translated
+strings, in particular when the strings are short (@pxref{Contexts,,,gettext,
+GNU @code{gettext} utilities}).  Translation contexts are set for translated
+direction strings (@pxref{Direction Strings}) and for special elements headings
+(@pxref{Special Elements Information Customization}).
 
 For direction strings, the translation context is based on the direction
 name (@pxref{Directions}), with @samp{direction} prepended and another
@@ -3107,9 +3109,9 @@ direction @code{text} direction string translation 
context is thus @samp{This
 (current section) direction string}.
 
 For special element headings, the translation context is obtained by
-prepending @samp{section heading} to the special element variety.  For example,
-the @code{footnotes} special element variety heading translation context is
-@samp{footnotes section heading}.
+prepending @samp{section heading} to the special element variety 
(@pxref{Special
+Elements Varieties}).  For example, the @code{footnotes} special element
+variety heading translation context is @samp{footnotes section heading}.
 
 Here is an example, which could be used with the same
 function registered as @code{format_translate_string} as in the example above:
@@ -3132,6 +3134,11 @@ my %translations = (
 
 @end example
 
+Other translated strings may also be associated with translation contexts.
+The translation template file @file{po_document/texinfo_document.pot}
+in the source directory of Texinfo contains the translated strings appearing in
+all the output formats.
+
 
 @node Directions@comma{} Links@comma{} Labels and Files
 @chapter Directions, Links, Labels and Files