gbranden pushed a commit to branch master
in repository groff.
commit e8f4663eb6b05b50169bc292d67af63df9b5ac6a
Author: G. Branden Robinson <[email protected]>
AuthorDate: Sat Jan 10 13:57:44 2026 -0600
[doc,man]: Clarify points on l10n and hyphenation.
Sync material between groff(7) and groff_diff(7).
In our Texinfo manual, break input lines in a roff-friendly way.
---
doc/groff.texi.in | 20 +++++++++++++++-----
man/groff.7.man | 23 ++++++++++++++++-------
man/groff_diff.7.man | 25 +++++++++++++++----------
3 files changed, 46 insertions(+), 22 deletions(-)
diff --git a/doc/groff.texi.in b/doc/groff.texi.in
index e8062f131..3a07356c1 100644
--- a/doc/groff.texi.in
+++ b/doc/groff.texi.in
@@ -10120,11 +10120,21 @@ The @code{hpfa} request appends a file of patterns to
the current list.
@pindex ru.tmac
@pindex sv.tmac
@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.@footnote{For more on localization, see the
-@cite{groff_tmac@r{(5)}} man page.}
+GNU
+@command{troff} @c GNU
+ties the set of hyphenation patterns
+to the hyphenation language code
+selected by the
+@code{hla}
+request
+(see below).
+The
+@code{hpf}
+request is usually invoked
+by a localization file loaded by the
+@file{troffrc}
+file.@footnote{For more detail on localization,
+see @cite{groff_tmac@r{(5)}}.}
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 a10ca7a7e..abab64717 100644
--- a/man/groff.7.man
+++ b/man/groff.7.man
@@ -8224,24 +8224,33 @@ space
.SH Localization
.\" ====================================================================
.
-The set of hyphenation patterns is associated with the hyphenation
-language set by the
-.B .hla
+GNU
+.I troff \" GNU
+ties the set of hyphenation patterns
+to the hyphenation language code
+selected by the
+.B hla
request.
.
The
-.B .hpf
+.B hpf
request is usually invoked by a localization file loaded by the
.I troffrc
file.
.
.I groff
provides localization files for several languages;
-see
+See subsection \[lq]Localization packages\[rq] of
.MR groff_tmac @MAN5EXT@ .
.
-These also set the default automatic hyphenation mode with
-.BR \%.hydefault .
+For Western languages,
+the localization file
+sets the default hyphenation mode
+and loads hyphenation patterns and exceptions.
+.
+By default,
+.I troffrc
+loads the localization file for English.
.
.
.\" ====================================================================
diff --git a/man/groff_diff.7.man b/man/groff_diff.7.man
index 2f76ab120..475c6a21e 100644
--- a/man/groff_diff.7.man
+++ b/man/groff_diff.7.man
@@ -3387,8 +3387,11 @@ input encoding.
.
.
.IP
-The set of hyphenation patterns is associated with the hyphenation
-language set by the
+GNU
+.I troff \" GNU
+ties the set of hyphenation patterns
+to the hyphenation language code
+selected by the
.B hla
request.
.
@@ -3398,17 +3401,19 @@ request is usually invoked by a localization file
loaded by the
.I troffrc
file.
.
-By default,
-.I troffrc
-loads the localization file for English.
-.
+.I groff
+provides localization files for several languages;
See subsection \[lq]Localization packages\[rq] of
-.MR groff_tmac @MAN5EXT@
-for a list of available localization files.
+.MR groff_tmac @MAN5EXT@ .
.
For Western languages,
-the localization file sets the hyphenation mode and loads hyphenation
-patterns and exceptions.
+the localization file
+sets the default hyphenation mode
+and loads hyphenation patterns and exceptions.
+.
+By default,
+.I troffrc
+loads the localization file for English.
.
.
.IP
_______________________________________________
groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit
