[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 <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
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [groff] 08/48: [docs]: Revise localization discussion.,
G. Branden Robinson <=