diff options
author | G. Branden Robinson <g.branden.robinson@gmail.com> | 2023-03-23 23:36:05 -0500 |
---|---|---|
committer | G. Branden Robinson <g.branden.robinson@gmail.com> | 2023-04-01 10:33:39 -0500 |
commit | 74a910b9e9a967ada22b3d2e89d28ee51995a829 (patch) | |
tree | ce6d47301df2519b44dbdf55f5123e5300769b5b /doc | |
parent | 5b18b7c821b7df2a964a3faed01348c7afa24a5b (diff) | |
download | groff-git-74a910b9e9a967ada22b3d2e89d28ee51995a829.tar.gz |
[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".
Diffstat (limited to 'doc')
-rw-r--r-- | doc/groff.texi | 13 |
1 files changed, 4 insertions, 9 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 |