gbranden pushed a commit to branch master
in repository groff.
commit d15c86d953e5dbe15718bd31e2b9d4c56dca316c
Author: G. Branden Robinson <[email protected]>
AuthorDate: Sun Aug 11 00:40:36 2024 -0500
[docs]: Revise `hw` request discussion.
* A word must consist only of characters, ordinary or special.
* Refer to the hyphen-minus sign correctly.
* Drop observation that the request can be used more than once; nearly
all can (cf. `ex`, `ab`).
* Sync language between our Texinfo manual and groff(7).
Prompted by discussion with Dave Kemper in
<https://savannah.gnu.org/bugs/?66054>.
---
doc/groff.texi.in | 10 +++++-----
man/groff.7.man | 11 +++++++----
2 files changed, 12 insertions(+), 9 deletions(-)
diff --git a/doc/groff.texi.in b/doc/groff.texi.in
index bbb811900..643bd9032 100644
--- a/doc/groff.texi.in
+++ b/doc/groff.texi.in
@@ -8556,8 +8556,9 @@ unusual words found in technical literature. We can
instruct GNU
@c TODO: Add request `rhw`?
@cindex hyphenation exceptions
@Defreq {hw, word @dots{}}
-Define each @dfn{hyphenation exception} @var{word} with each hyphen `-'
-in the word indicating a hyphenation point. For example, the request
+Define each @dfn{hyphenation exception} @var{word} comprising ordinary
+or special characters with each hyphen-minus `-' in @var{word}
+indicating a hyphenation point. For example, the request
@Example
.hw in-sa-lub-rious alpha
@@ -8569,9 +8570,8 @@ marks potential hyphenation points in ``insalubrious'',
and prevents
``alpha'' from being hyphenated at all.
Besides the space character, any character whose hyphenation code is
-zero can be used to separate the arguments of @code{hw} (see the
-@code{hcode} request below). In addition, this request can be used more
-than once.
+zero can be used to separate the arguments (see the @code{hcode} request
+below).
@cindex @code{hw} request, and @code{hy} restrictions
Hyphenation points specified with @code{hw} are not subject to the
diff --git a/man/groff.7.man b/man/groff.7.man
index b5596d228..03c798bb6 100644
--- a/man/groff.7.man
+++ b/man/groff.7.man
@@ -3404,11 +3404,14 @@ and
.
.TPx
.REQ .hw "word \fR.\|.\|.\fP"
-Define hyphenation overrides for each
-.I word;
-a hyphen
+Define each
+.I "hyphenation exception"
+.I word
+comprising ordinary or special characters with each hyphen-minus
.RB \[lq] \- \[rq]
-indicates a hyphenation point.
+in
+.I word
+indicating a hyphenation point.
.
.TPx
.REQ .hy
_______________________________________________
Groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit
