groff-commit
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

[groff] 12/17: groff(7), groff_diff(7): Tighten wording.


From: G. Branden Robinson
Subject: [groff] 12/17: groff(7), groff_diff(7): Tighten wording.
Date: Wed, 7 Jun 2023 19:35:44 -0400 (EDT)

gbranden pushed a commit to branch master
in repository groff.

commit 302730a568f709860b12d3cabff0c59d44c4e28b
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Wed Jun 7 12:11:46 2023 -0500

    groff(7), groff_diff(7): Tighten wording.
    
    ...to improve dead-tree pagination.
---
 man/groff.7.man      | 17 ++++++++---------
 man/groff_diff.7.man | 16 ++++++++++------
 2 files changed, 18 insertions(+), 15 deletions(-)

diff --git a/man/groff.7.man b/man/groff.7.man
index f9e86855d..3ccdedcd8 100644
--- a/man/groff.7.man
+++ b/man/groff.7.man
@@ -7729,22 +7729,21 @@ after
 .SS "Underlining by overstriking with \e(ul"
 .\" ====================================================================
 .
-You can use the
+The
 .B \[rs]z
-escape sequence to format a glyph while suppressing advancement of its
-drawing position;
-this is another form of overstriking.
+escape sequence writes a glyph without advancing the
+drawing position,
+enabling overstriking.
 .
 Thus,
 .BI \[rs]z c \[rs](ul
 formats
 .I c
-without advancement,
-then draws the underrule glyph on top of it.
+with an underrule glyph on top of it.
 .
-Because video terminals implement the underrule glyph by setting the
-underline attribute on the character cell,
-this works in both
+Video terminals implement the underrule by setting a character cell's
+underline attribute,
+so this technique works in both
 .I nroff \" mode
 and
 .I troff \" mode
diff --git a/man/groff_diff.7.man b/man/groff_diff.7.man
index 81d11d35b..e17bae1ee 100644
--- a/man/groff_diff.7.man
+++ b/man/groff_diff.7.man
@@ -1029,11 +1029,14 @@ comment\[em]it leaves a blank line on the input stream.
 .\" Keep \$0 before \$( in spite of collation.
 .TP
 .B \[rs]$0
-The name by which the current macro was invoked.
+The name by which the current macro was called.
 .
-The
+In GNU
+.I troff \" GNU
+this can vary;
+see the
 .B als
-request can make a macro have more than one name.
+request.
 .
 .TP
 .BI \[rs]$( nn
@@ -1177,7 +1180,8 @@ so the remainder of the word is subject to hyphenation as 
normal.
 .
 .TP
 .BI \[rs]? anything \[rs]?
-When used in a diversion, this transparently embeds
+When used in a diversion,
+this transparently embeds
 .I anything
 in the diversion.
 .I anything
@@ -1193,8 +1197,8 @@ if you want to embed newlines in a diversion.
 .
 The escape sequence
 .B \[rs]?\&
-is also recognized in copy mode and turned into a single internal
-code; it is this code that terminates
+is also recognized in copy mode and becomes an internal code;
+it is this code that terminates
 .IR anything .
 Thus
 .



reply via email to

[Prev in Thread] Current Thread [Next in Thread]