gbranden pushed a commit to branch branden-2023-03-31 in repository groff. commit 2685ecf8213e48bf4f6e27fb77ddbaae6b879b5c Author: G. Branden Robinson <g.branden.robin...@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 _______________________________________________ Groff-commit mailing list Groff-commit@gnu.org https://lists.gnu.org/mailman/listinfo/groff-commit