gbranden pushed a commit to branch master
in repository groff.
commit 17b735d2fcf3d37827003dbf8ffd40c6c3c5ac1b
Author: G. Branden Robinson <[email protected]>
AuthorDate: Wed Sep 11 08:39:38 2024 -0500
groff_man*(7): Fix content and style nits.
* Improve example of a man(7) feature test for portability mavens to use
POSIX BRE character classes. (Even this year's Issue 8 of POSIX does
not admit the `-w` option or the `\<` or `\>` word-boundary-matching
syntax.)
* Use active voice more.
* Adapt phrasing to increasing use of italic-capable terminal emulators.
* Clarify and tighten wording. Push and pull.
---
tmac/groff_man.7.man.in | 15 ++++++++-------
1 file changed, 8 insertions(+), 7 deletions(-)
diff --git a/tmac/groff_man.7.man.in b/tmac/groff_man.7.man.in
index e3ecb5d14..a725e686b 100644
--- a/tmac/groff_man.7.man.in
+++ b/tmac/groff_man.7.man.in
@@ -1358,7 +1358,7 @@ are best presented with
.
Text may be hyperlinked to email addresses with
.BR .MT / .ME
-or other URIs with
+or other sorts of URI with
.BR .UR / .UE .
.
To hyperlink text,
@@ -1433,7 +1433,7 @@ rendering them can result in jarring adjustment or
variations in line
length,
or
.I @g@troff
-warnings when a hyperlink is longer than an output line.
+warnings when one is longer than an output line.
.
The application of non-printing break point escape sequences
.B \e:
@@ -1645,7 +1645,8 @@ call is followed immediately by hyperlinking macros
or
.BR .MT / .ME ,
and the device doesn't support hyperlinking,
-the hyperlink is set at the beginning of the indented paragraph,
+the package sets the link target at the beginning
+of the indented paragraph,
not as part of the tag.
.
.
@@ -1662,7 +1663,7 @@ offering only
.RB \~( .I ),
and roman.
.
-Italic text is usually set underscored instead on terminals.
+Italic text may instead render underscored on terminals.
.
.B .SM
sets text at a smaller type size,
@@ -2430,7 +2431,7 @@ hyphenation when setting arguments to
.
.RS
.EX
-have_MR=$(echo .pm | troff \-man 2>&1 | grep MR)
+have_MR=$(echo .pm | troff \-man 2>&1 | grep \(aqMR[[:space:]]\(aq)
if [ \-n "$have_MR" ]
then
sed \(aq/@DEFINE_MR@/d\(aq myprog.man.in > myprog.man
@@ -3760,8 +3761,8 @@ Any valid argument to
If the
.B MF
string ends in \[lq]I\[rq],
-it is assumed to be an oblique typeface,
-and italic corrections are applied before and after man page topics and
+the package assumes it to be an oblique typeface,
+and applies italic corrections before and after man page topics and
identifiers.
.
.
_______________________________________________
Groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit
