[groff] 10/22: groff_man*(7): Fix content nits.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 4a0236af03cb2e66244188fbdc92df1f0b1a21a4
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Sun Aug 1 18:03:31 2021 +1000

    groff_man*(7): Fix content nits.
    
    * Say "Version 9 Research Unix" instead of "Version 9 Unix".
    * Say "escape sequences" instead of "escapes"
    * Say "ordinary paragraph" instead of "block paragraph"; the latter term
      was otherwise unused in this page.
    * Use Unicode name for U+0022, but keep the mnemonic "double quote".
    * Explicitly describe \c escape in terms of filling behavior.  I don't
      see any way to present this page (or discuss roff systems in general)
      without defining what filling is; it's a fundamental concept.
    * Refer to a man page as a man "document" when discussing pagination, to
      ensure a distinction in the reader's mind.
---
 tmac/groff_man.7.man.in | 20 ++++++++++++--------
 1 file changed, 12 insertions(+), 8 deletions(-)

diff --git a/tmac/groff_man.7.man.in b/tmac/groff_man.7.man.in
index ce2ef3c..28ea782 100644
--- a/tmac/groff_man.7.man.in
+++ b/tmac/groff_man.7.man.in
@@ -578,7 +578,7 @@ _endif()dnl
 .IP
 .\" Also see subsection "History" below...
 These macros are extensions,
-introduced in Version\~9 Unix,
+introduced in Version\~9 Research Unix,
 to the original
 .I man
 package.
@@ -1569,7 +1569,7 @@ it is possible with the
 .B \ec
 and/or
 .B \ef
-escapes,
+escape sequences,
 but
 _endif()dnl
 see subsection \(lqPortability\(rq
@@ -1856,7 +1856,7 @@ Now we have created a relative inset
 moved the left margin)
 with
 .B .RS
-and started another block paragraph with
+and started another ordinary paragraph with
 .BR .P .
 .
 .
@@ -2364,7 +2364,8 @@ Use these for paired directional single quotes,
 .
 .TP
 .B \e(dq
-Basic Latin double-quote.
+Basic Latin quotation mark
+(double quote).
 .
 Use in macro calls to prevent
 .\" This page prefers double quotes, but not here because they are more
@@ -2469,14 +2470,15 @@ the end of an input line is treated like a space;
 .\" end-of-sentence detection is performed, and...
 an output line
 .I may
-be broken there\" if filling enabled
+be broken there if filling is enabled,
 (if not,
 an adjustable space is inserted)
 and
 .I will
-be broken there in
+be broken there when filling is disabled,
+as in
 .BR .EX / .EE
-examples.\" i.e., when filling is disabled
+examples.
 .
 Anything after
 .B \ec
@@ -2985,7 +2987,9 @@ Number output pages continuously.
 .
 If multiple man pages are processed,
 number the output pages in strictly increasing sequence,
-rather than resetting the page number to\~1 at each new man page.
+rather than resetting the page number to\~1 at each new
+.I man
+document.
 .
 .
 .TP