[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[groff] 10/22: groff_man*(7): Fix content nits.
From: |
G. Branden Robinson |
Subject: |
[groff] 10/22: groff_man*(7): Fix content nits. |
Date: |
Mon, 2 Aug 2021 10:49:47 -0400 (EDT) |
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
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [groff] 10/22: groff_man*(7): Fix content nits.,
G. Branden Robinson <=