[Top][All Lists]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

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

From: G. Branden Robinson
Subject: [groff] 08/48: [docs]: Revise localization discussion.
Date: Fri, 31 Mar 2023 08:33:06 -0400 (EDT)

gbranden pushed a commit to branch branden-2023-03-31
in repository groff.

commit 2685ecf8213e48bf4f6e27fb77ddbaae6b879b5c
Author: G. Branden Robinson <>
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/ (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/ (Localization files):
    * 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/      | 34 +++-------------------------------
 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 
 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/ b/man/
index 2326b9c3a..b4497330a 100644
--- a/man/
+++ b/man/
@@ -6359,38 +6359,10 @@ request is usually invoked by a localization file 
loaded by the
 .I troffrc
-By default,
-.I troffrc
-loads the localization file for English.
-(As of
 .I groff
-localization files for Czech
-.RI ( cs ),
-.RI ( de ),
-.RI ( en ),
-.RI ( fr ),
-.RI ( it ),
-.RI ( ja ),
-.RI ( sv ),
-and Chinese
-.RI ( zh )
-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;
+.MR groff_tmac @MAN5EXT@ .
 .\" ====================================================================
diff --git a/man/ b/man/
index 8126e594f..df9ad639b 100644
--- a/man/
+++ b/man/
@@ -312,10 +312,8 @@ localized forms have been prepared by a localization macro 
-As of
 .I groff
-the following localization files exist.
+provides the following localization files.

reply via email to

[Prev in Thread] Current Thread [Next in Thread]