[groff] 10/30: [NEWS,doc,man]: Clarify `phw` behavior.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 7cdad63be91eadd0a544ba10aeaac3d7904b4bdd
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Thu Nov 7 10:18:46 2024 -0600

    [NEWS,doc,man]: Clarify `phw` behavior.
---
 NEWS                 |  3 ++-
 doc/groff.texi.in    | 11 ++++++-----
 man/groff.7.man      |  3 ++-
 man/groff_diff.7.man |  3 ++-
 4 files changed, 12 insertions(+), 8 deletions(-)

diff --git a/NEWS b/NEWS
index 3b312a4c0..7d1ef58d5 100644
--- a/NEWS
+++ b/NEWS
@@ -116,7 +116,8 @@ troff
    hyphenation code of each ordinary or special character argument.
 
 *  A new request, `phw`, reports to the standard error stream the
-   list of hyphenation exceptions.
+   list of hyphenation exceptions associated with the current
+   hyphenation language.
 
 *  A new request, `pline`, reports to the standard error stream the list
    of output nodes (an internal data structure) corresponding to the
diff --git a/doc/groff.texi.in b/doc/groff.texi.in
index c560dd5ce..3d1f18b06 100644
--- a/doc/groff.texi.in
+++ b/doc/groff.texi.in
@@ -17219,11 +17219,12 @@ listed in bracketed syntax using the default escape 
character.
 @cindex hyphenation exceptions, dumping (@code{phw})
 @cindex exceptions, hyphenation, dumping (@code{phw})
 Report, to the standard error stream, the list of hyphenation
-exceptions.  Each hyphenation point is marked with @samp{-}.  Words that
-will not be hyphenated at all are prefixed with @samp{-}.  Those to
-which automatic hyphenation applies (meaning those defined in a
-hyphenation pattern file rather than with the @code{hw} request) are
-suffixed with a tab and asterisk (@code{*}).
+exceptions associated with the current hyphenation language.  Each
+hyphenation point is marked with @samp{-}.  Words that will not be
+hyphenated at all are prefixed with @samp{-}.  Those to which automatic
+hyphenation applies (meaning those defined in a hyphenation pattern file
+rather than with the @code{hw} request) are suffixed with a tab and
+asterisk (@code{*}).
 @endDefreq
 
 @Defreq {pline, }
diff --git a/man/groff.7.man b/man/groff.7.man
index 1d248b237..7858b38e8 100644
--- a/man/groff.7.man
+++ b/man/groff.7.man
@@ -4006,7 +4006,8 @@ the hyphenation code of each ordinary or special
 .REQ .phw
 Report,
 to the standard error stream,
-the list of hyphenation exceptions.
+the list of hyphenation exceptions
+associated with the current hyphenation language.
 .
 Each hyphenation point is marked with
 .RB \[lq] \- \[rq].
diff --git a/man/groff_diff.7.man b/man/groff_diff.7.man
index 5ce80158c..93e43ed31 100644
--- a/man/groff_diff.7.man
+++ b/man/groff_diff.7.man
@@ -3307,7 +3307,8 @@ escape character.
 .B .phw
 Report,
 to the standard error stream,
-the list of hyphenation exceptions.
+the list of hyphenation exceptions
+associated with the current hyphenation language.
 .
 Each hyphenation point is marked with
 .RB \[lq] \- \[rq].