[groff] 08/78: [docs]: Revise localization discussion.

[G. Branden Robinson]

gbranden pushed a commit to branch branden-2023-04-07
in repository groff.

commit 74a910b9e9a967ada22b3d2e89d28ee51995a829
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Thu Mar 23 23:36:05 2023 -0500

    [docs]: Revise localization discussion.
    
    * doc/groff.texi: Drop staleness-prone material about localization setup
      and specific languages supported; replace with cross reference to
      groff_tmac(5).  This material also doesn't document the formatter per
      se, and so is inappropriate for the "GNU troff reference" chapter.
    
    * man/groff_tmac.5.man (Localization files): Add introductory sentence
      summarizing their purpose.  Add advice regarding the order of their
      loading; thanks to Nikita Ivanov for reporting this omission.
    
    * man/groff_tmac.5.man (Localization files):
    * man/groff.7.man (Localization): Improve robustness to future
      development by reorganizing and dropping version number references.
    
    In both documents, refer to "localization files" rather than
    "localization packages".
---
 doc/groff.texi       | 13 ++++---------
 man/groff.7.man      | 34 +++-------------------------------
 man/groff_tmac.5.man |  4 +---
 3 files changed, 8 insertions(+), 43 deletions(-)

diff --git a/doc/groff.texi b/doc/groff.texi
index 7e300dbef..ce5f7cdfd 100644
--- a/doc/groff.texi
+++ b/doc/groff.texi
@@ -8437,7 +8437,7 @@ Set automatic hyphenation mode to @var{mode}, an integer 
encoding
 conditions for hyphenation; if omitted, @samp{1} is implied.  The
 hyphenation mode is available in the read-only register @samp{.hy}; it
 is associated with the environment (@pxref{Environments}).  The default
-hyphenation mode depends on the localization package loaded when GNU
+hyphenation mode depends on the localization file loaded when GNU
 @code{troff} starts up; see the @code{hpf} request below.
 
 Typesetting practice generally does not avail itself of every
@@ -8641,14 +8641,9 @@ be used.  By default, every code maps to itself except 
those for letters
 @pindex zh.tmac
 The set of hyphenation patterns is associated with the language set by
 the @code{hla} request (see below).  The @code{hpf} request is usually
-invoked by a localization file loaded by the @file{troffrc} file.  By
-default, @file{troffrc} loads the localization file for
-English.@footnote{As of @code{groff} 1.23.0, localization files for
-Czech (@code{cs}), German (@code{de}), English (@code{en}), French
-(@code{fr}), Italian (@code{it}), Japanese (@code{ja}), Swedish
-(@code{sv}), and Chinese (@code{zh}) exist.}  For Western languages, the
-localization file sets the hyphenation mode and loads hyphenation
-patterns and exceptions.
+invoked by a localization file loaded by the @file{troffrc}
+file.@footnote{For more on localization, see the
+@cite{groff_tmac@r{(5)}} man page.}
 
 A second call to @code{hpf} (for the same language) replaces the
 hyphenation patterns with the new ones.  Invoking @code{hpf} or
diff --git a/man/groff.7.man b/man/groff.7.man
index 2326b9c3a..b4497330a 100644
--- a/man/groff.7.man
+++ b/man/groff.7.man
@@ -6359,38 +6359,10 @@ request is usually invoked by a localization file 
loaded by the
 .I troffrc
 file.
 .
-By default,
-.I troffrc
-loads the localization file for English.
-.
-(As of
 .I groff
-1.23.0,
-localization files for Czech
-.RI ( cs ),
-German
-.RI ( de ),
-English
-.RI ( en ),
-French
-.RI ( fr ),
-Italian
-.RI ( it ),
-Japanese
-.RI ( ja ),
-Swedish
-.RI ( sv ),
-and Chinese
-.RI ( zh )
-exist.)
-.
-For Western languages,
-the localization file sets the hyphenation mode and loads hyphenation
-patterns and exceptions.
-.
-It also (re-)defines translatable strings and macros that packages use
-to handle localization tasks,
-such as formatting the calendar date.
+provides localization files for several languages;
+see
+.MR groff_tmac @MAN5EXT@ .
 .
 .
 .\" ====================================================================
diff --git a/man/groff_tmac.5.man b/man/groff_tmac.5.man
index 8126e594f..df9ad639b 100644
--- a/man/groff_tmac.5.man
+++ b/man/groff_tmac.5.man
@@ -312,10 +312,8 @@ localized forms have been prepared by a localization macro 
file.
 .
 .
 .P
-As of
 .I groff
-1.23.0,
-the following localization files exist.
+provides the following localization files.
 .
 .
 .TP