[groff] 02/27: groff_man*(7): Clarify and revise.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 4f89b1d0117010dc294e67b5a2cc41765fd3f54f
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Sun Dec 22 22:14:07 2024 -0600

    groff_man*(7): Clarify and revise.
    
    * Fix verb tense error.
    * Describe `EX`/`EE` behavior on typesetters more carefully.
    * Describe Unicode Basic Latin code point range more accurately.
    * Drop examples of typesetter devices; the page defines the term.
    * Recast description of `\(dq`, dropping excessively narrow presentation
      of `"`'s function in macro calls.
    * Document another hazard of `PD` manipulation--man(1) programs that
      "squeeze" the output can, on terminals, erase its effect.
---
 tmac/groff_man.7.man.in | 30 +++++++++++++++++-------------
 1 file changed, 17 insertions(+), 13 deletions(-)

diff --git a/tmac/groff_man.7.man.in b/tmac/groff_man.7.man.in
index de40ca702..4ac22e90b 100644
--- a/tmac/groff_man.7.man.in
+++ b/tmac/groff_man.7.man.in
@@ -593,7 +593,7 @@ Text lines after the call are set as an ordinary paragraph
 The content of
 .I heading-text
 and ordering of sections follows a set of common practices,
-as has much of the layout of material within sections.
+as does much of the layout of material within sections.
 .
 For example,
 a section called \(lqName\(rq or \(lqNAME\(rq must exist,
@@ -658,11 +658,15 @@ Begin and end example.
 .
 After
 .BR .EX ,
-filling is disabled and a constant-width (monospaced) font is selected.
+filling is disabled
+(and,
+on typesetters,
+a monospaced font family is selected).
 .
 Calling
 .B .EE
-enables filling and restores the previous font.
+enables filling
+(and restores the previous family).
 .
 .
 _ifstyle()dnl
@@ -2593,7 +2597,7 @@ even in man pages and usually do not cause portability 
problems.
 .
 Several of these render glyphs corresponding to punctuation code points
 in the Unicode basic Latin range
-(U+0000\(enU+007F)
+(U+0020\(enU+007F)
 that are handled specially in
 .I roff
 input;
@@ -2768,11 +2772,7 @@ a non-breaking space.
 .
 Used primarily in ellipses
 (\(lq.\e|.\e|.\(rq)\&
-to space the dots more pleasantly on typesetters like
-.BR dvi ,
-.BR pdf ,
-and
-.BR ps .
+to space the dots more pleasantly on typesetters.
 .
 .
 .TP
@@ -3028,13 +3028,12 @@ Use these for paired directional single quotes,
 Basic Latin quotation mark
 (double quote).
 .
-Use in macro calls to prevent
+Employ it in macro calls to work around interpretation of
+.RB \(oq\| \(dq \|\(cq
+as an argument delimiter.
 .\" This page prefers double quotes, but not here because they are more
 .\" confusing to the eye when another double quote is what is quoted!
-.RB \(oq\| \(dq \|\(cq
 .\" AT&T: .RB ` """'
-from being interpreted as beginning a quoted argument,
-or simply for readability.
 .
 .
 .RS
@@ -3253,6 +3252,11 @@ It translates poorly to HTML,
 under which exact space control and tabulation are not readily
 available.
 .
+Further,
+some
+.MR man 1
+programs \(lqsqueeze\(rq multiple blank output lines into one.
+.
 Thus,
 information or distinctions that you use tab stops to express are likely
 to be lost.