[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[groff] 43/53: doc/meref.me: Revise "roff Support" section.
From: |
G. Branden Robinson |
Subject: |
[groff] 43/53: doc/meref.me: Revise "roff Support" section. |
Date: |
Tue, 14 Dec 2021 01:22:01 -0500 (EST) |
gbranden pushed a commit to branch master
in repository groff.
commit 1275eaf4c7c0bd7cfc87ab36280caa2cf6d5ab39
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Sat Dec 11 14:26:33 2021 +1100
doc/meref.me: Revise "roff Support" section.
* Capitalize "Roman" when referring to the numerals (not the style).
* Tighten wording.
---
doc/meref.me | 93 +++++++++++++++++++++++++-----------------------------------
1 file changed, 38 insertions(+), 55 deletions(-)
diff --git a/doc/meref.me b/doc/meref.me
index e4f622f..5fc6bef 100644
--- a/doc/meref.me
+++ b/doc/meref.me
@@ -1291,8 +1291,8 @@ It won't work right
if
.i W
is adjusted or broken (including hyphenation breaks);
-it is reliable only when filling is disabled.
-It works poorly in \*N mode.
+it is reliable only when filling is disabled,
+and works poorly in \*N mode.
.sh 1 "\f(BIroff\fP Support"
.pp
The following facilities are provided to aid migration of
@@ -1309,102 +1309,85 @@ typesetting systems.
.)f
.TL
.b .ix
-.i +N
+.i \(+-N
.DE
-Indent,
-no break.
-Equivalent to
-.b \(aqin
-.i N .
+Equivalent to \(lq\|\fB\[aq]in \fI\(+-N\/\fR\(rq.
.TL
.b .bl
.i N
.DE
-Leave
-.i N
-contiguous white space,
-on the next page if not enough room
-on this page.
-Equivalent to putting a
-.b .sp
-.i N
-inside a block.
+Equivalent to \(lq\fB.sp \fIN\/\fR\(rq
+inside a
+.b .(b
+block.
.TL
.b .pa
-.i +N
+.i \(+-N
.DE
-Equivalent to
-.b .bp .
+Equivalent to \(lq\fB.bp \fI\(+-N\/\fR\(rq.
.TL
.b .ro
.DE
-Set page number
-in roman numerals.
-Equivalent to
-.b ".af % i" .
+Equivalent to \(lq\fB.af % i\fP\(rq.
.TL
.b .ar
.DE
-Set page number in Arabic.
-Equivalent to
-.b ".af % 1" .
+Equivalent to \(lq\fB.af % 1\fP\(rq.
.TL
.b .n1
.DE
-Number lines from one,
-in margin,
-on each page.
+Number output lines starting from one.
+The line length is reduced by the width of four numerals
+and indented by the same amount
+to accommodate the number.
.TL
.b .n2
-.i N
+.i \(+-N
.i c
.DE
-Number lines from
-.i N .
-.
Stop numbering if
.i N
missing;
resume where stopped if
.i N
unsigned,
-or resume with number incremented by
+or resume with number modified by
\(+-\c
-.i N .
+.i N.
.
If
.i c
-is c,
-maintain compatibility with original
+is
+.b c,
+maintain compatibility with
+.i roff (1)
.b .n2
-by narrowing line width to accommodate numbers.
+by narrowing the line width to accommodate numbers.
.TL
.b .sk
.DE
-Leave the next output page blank,
+Leave the next output page blank
except for headers and footers.
-This is used to leave space
+This can reserve space
for a full-page diagram
-which is produced externally
-and pasted in later.
-To get a partial-page paste-in display,
-say
-.b .sv \ \c
-.i N ,
+produced externally
+and composited in later.
+(To reserve only a partial page,
+use \[lq]\c
+.b .sv \~\c
+.i N \[rq],
where
.i N
-is the amount of space
-to leave;
-this space will be output immediately
+is the amount of space required.
+This space will be output immediately
if there is room,
-and will otherwise be output
+and otherwise
at the top of the next page.
-However, be warned:
-if
+If
.i N
-is greater than the amount of available space
+is greater than the space available
on an empty page,
-no space will ever be output.
+none will be output.)
.sh 1 "Preprocessor Support"
.TL
.b .EQ
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [groff] 43/53: doc/meref.me: Revise "roff Support" section.,
G. Branden Robinson <=