gbranden pushed a commit to branch master
in repository groff.
commit 9ebaa15de28b5c9717c75c2edce5cf50fb6e2894
Author: G. Branden Robinson <[email protected]>
AuthorDate: Fri Apr 11 18:51:03 2025 -0500
[doc],groff_diff(7): Clarify hyphenation material.
Better illuminate where hyphenation codes come from.
---
doc/groff.texi.in | 8 ++++++++
man/groff_diff.7.man | 17 +++++++++++------
2 files changed, 19 insertions(+), 6 deletions(-)
diff --git a/doc/groff.texi.in b/doc/groff.texi.in
index f2859cd75..40458931a 100644
--- a/doc/groff.texi.in
+++ b/doc/groff.texi.in
@@ -9047,6 +9047,8 @@ See the discussion of the
request in @ref{Strings}.
@endDefreq
+@c BEGIN Keep (roughly) parallel with (parts of) section "Hyphenation"
+@c of groff_diff(7).
For automatic hyphenation to work, the formatter must know which letters
are equivalent; for example, the letter @samp{E} behaves like @samp{e};
only the latter typically appears in hyphenation pattern files. GNU
@@ -9065,6 +9067,12 @@ without it,
words containing such letters
won't hyphenate properly
even if the corresponding hyphenation patterns contain them.
+Localization files for the input character set and language
+configure hyphenation codes;
+see
+@cite{groff_tmac@r{(5)}}.
+@c END Keep (roughly) parallel with (parts of) section "Hyphenation"
+@c of groff_diff(7).
@Defreq {hcode, dst1 src1 [dst2 src2] @dots{}}
@cindex hyphenation code (@code{hcode})
diff --git a/man/groff_diff.7.man b/man/groff_diff.7.man
index 5735536aa..fa651f172 100644
--- a/man/groff_diff.7.man
+++ b/man/groff_diff.7.man
@@ -260,8 +260,6 @@ registers exercise color support.
.SS Hyphenation
.\" ====================================================================
.
-.\" BEGIN Keep (roughly) parallel with relevant material from groff.texi
-.\" nodes "Hyphenation" and "Manipulating Hyphenation".
GNU
.I troff \" GNU
uses a hyphenation algorithm and language-specific pattern files
@@ -301,6 +299,8 @@ GNU
does not perform automatic hyphenation.
.
.
+.\" BEGIN Keep (roughly) parallel with groff.texi node "Manipulating
+.\" Hyphenation".
.P
For automatic hyphenation to work,
the formatter must know which letters are equivalent;
@@ -336,16 +336,21 @@ words containing such letters
won't hyphenate properly
even if the corresponding hyphenation patterns contain them.
.
+Localization files for the input character set and language
+configure hyphenation codes;
+see
+.MR groff_tmac @MAN5EXT@ .
+.\" END Keep (roughly) parallel with groff.texi node "Manipulating
+.\" Hyphenation".
+.
.
.P
GNU
.IR troff 's \" GNU
.B \[rs]:
-escape sequence is analogous to the
+escape sequence works like
.B \[rs]%
-sequence but produces no hyphen if the word breaks at that location.
-.\" END Keep (roughly) parallel with relevant material from groff.texi
-.\" nodes "Hyphenation" and "Manipulating Hyphenation".
+but produces no hyphen if the word breaks at that location.
.
.
.\" ====================================================================
_______________________________________________
groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit
