[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[groff] 06/12: doc/meref.me.in: Fix feature summary table nits.
From: |
G. Branden Robinson |
Subject: |
[groff] 06/12: doc/meref.me.in: Fix feature summary table nits. |
Date: |
Thu, 16 Dec 2021 07:11:23 -0500 (EST) |
gbranden pushed a commit to branch master
in repository groff.
commit cb1b89620ff5b0b509831a3b8ecf4f1916d34567
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Thu Dec 16 08:20:58 2021 +1100
doc/meref.me.in: Fix feature summary table nits.
...observed while revising groff_me(7).
* Remove junk comment line (I de-documented \SP in favor of \~).
* Add non-printing input break `\&` between non-sentence ending period
and space.
* Be more consistent: we say "(pre/post) space", not "spacing" when
referring to registers containing vertical distances to be inserted by
the package adjacent to various constructs. I try to reserve the term
"spacing" for baseline separation (registers `$V` and `$v`).
* Recast descriptions of `lp` and `pp` to distinguish them better.
---
doc/meref.me.in | 13 ++++++++-----
1 file changed, 8 insertions(+), 5 deletions(-)
diff --git a/doc/meref.me.in b/doc/meref.me.in
index fc18efa..a132cc9 100644
--- a/doc/meref.me.in
+++ b/doc/meref.me.in
@@ -136,6 +136,10 @@ strings,
and sometimes macro calls.
Default parameter values are shown in square brackets
in this document.
+.\" XXX GBR CONVERT THE MANUAL TO USE THIS CONVENTION
+.\" Numeric arguments to macros are denoted with lowercase letters and
+.\" string arguments with uppercase.
+.\" XXX GBR CONVERT THE MANUAL TO USE THE ABOVE CONVENTION
The notation
.i \(+-N
indicates a numerical value with an optional leading sign.
@@ -2070,7 +2074,6 @@ and a square \(sq marks \*G extensions.
.if n .(c
.(l L
.$H
-.\"\e\fI\,space\fP F\(sc unbreakable, unadjustable space
\e\fI\,newline\fP F\(sc continue input line
\e" F\(sc comment (to end of input line)
\e*# S delayed text marker
@@ -2172,11 +2175,11 @@ and a square \(sq marks \*G extensions.
\&.bc M begin new column
\&.bi M embolden and italicize argument
\en(bi R display (block) indentation
-\&.bl M insert space (even at page top; cf. \fB.sp\fP)
+\&.bl M insert space (even at page top; cf.\& \fB.sp\fP)
\en(bm R distance from text area to page bottom
\&.bp M\(sc begin new page
\&.br M\(sc break output line
-\en(bs R display (block) pre/post spacing
+\en(bs R display (block) pre/post space
\en(bt R block threshold for keeps
\&.bx M box argument
\ec F\(sc continue output line
@@ -2224,7 +2227,7 @@ and a square \(sq marks \*G extensions.
\el\(aq\fI\,d\/\fP\(aq F\(sc draw horizontal line of length \fId\fP
\&.lc M\(sc set leader repetition character
\&.ll M set line length
-\&.lp M begin left-aligned paragraph
+\&.lp M begin fully left-aligned paragraph
\e*(lq S left double quotation mark
\&.ls M\(sc set multi-line spacing
\&.m1 M set page top to header distance
@@ -2256,7 +2259,7 @@ and a square \(sq marks \*G extensions.
\&.pn M\(sc set next page number
\&.po M\(sc set page offset
\en(po R page offset
-\&.pp M begin paragraph
+\&.pp M begin first-line indented paragraph
\en(pp R paragraph type size in points
\en(ps R paragraph prespace
\&.q M quote argument
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [groff] 06/12: doc/meref.me.in: Fix feature summary table nits.,
G. Branden Robinson <=