[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[groff] 09/16: groff(7): Fix style nits.
From: |
G. Branden Robinson |
Subject: |
[groff] 09/16: groff(7): Fix style nits. |
Date: |
Mon, 23 Aug 2021 00:06:42 -0400 (EDT) |
gbranden pushed a commit to branch master
in repository groff.
commit f80db8df979317a26525c8f408cebcfdf6b24371
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Sun Aug 22 12:54:26 2021 +1000
groff(7): Fix style nits.
* Use correct font style for literal arguments in request summaries.
* Break input lines at multi-word parentheses.
* Alphabetize \e in list of escapes interpreted even in copy mode.
* Fix macro call spacing goof in repeated list of escape sequences
interpreted even in copy mode.
---
man/groff.7.man | 65 ++++++++++++++++++++++++++++++---------------------------
1 file changed, 34 insertions(+), 31 deletions(-)
diff --git a/man/groff.7.man b/man/groff.7.man
index 83a1696..583d50b 100644
--- a/man/groff.7.man
+++ b/man/groff.7.man
@@ -2101,7 +2101,7 @@ Set automatic hyphenation mode to
.
.
.TPx
-.REQ .hy \fB0\fP
+.REQ .hy\~0
Disable automatic hyphenation;
same as
.BR .nh .
@@ -2249,7 +2249,7 @@ Enable line-tabs mode (i.e., calculate tab positions
relative to output
line).
.
.TPx
-.REQ .linetabs "n"
+.REQ .linetabs\~0
If
.I n
is zero, disable line-tabs mode, otherwise enable it.
@@ -2698,7 +2698,8 @@ In a macro, shift the arguments by
positions.
.
.TPx
-.REQ .sizes "s1 s2 \fR\&.\|.\|.\&\fP s\fRn\fP \fR[\fB0\fP\fR]\fP"
+.REQ .sizes "s1 s2 \fR\&.\|.\|.\&\fP s\fRn\~\c
+[\f[CB]0\f[]]
Set available font sizes similar to the
.B sizes
command in a
@@ -2983,7 +2984,10 @@ Set underline font to
.
.TPx
.REQ .ul "N"
-Underline (italicize in troff)
+Underline
+(italicize in
+.I troff
+mode)
.I N
input lines.
.
@@ -3000,7 +3004,7 @@ Enable vertical position traps.
.
.
.TPx
-.B .vpt 0
+.REQ .vpt\~0
Disable vertical position traps.
.
.
@@ -3228,13 +3232,13 @@ and the following character is processed normally.
.\" ====================================================================
.
The escape sequences
-.esc e ,
.esc . ,
.esc \[dq] ,
.esc # ,
.esc $ ,
.esc * ,
.esc a ,
+.esc e ,
.esc n ,
.esc t ,
.esc g ,
@@ -3648,12 +3652,12 @@ Mark horizontal position in register with arbitrarily
long
.RI name\~ reg .
.
.TP
-.ESCq l Nc
+.ESCq l N\f[R][\f[]c\f[R]]
Horizontal line drawing function (optionally using character
.IR c ).
.
.TP
-.ESCq L Nc
+.ESCq L N\f[R][\f[]c\f[R]]
Vertical line drawing function (optionally using character
.IR c ).
.
@@ -5408,27 +5412,27 @@ it does so in
it copies the characters of the definition into a dedicated storage
region,
interpolating the escape sequences
-.BR \[rs] n ,
-.BR \[rs] g ,
-.BR \[rs] $ ,
-.BR \[rs] * ,
+.BR \[rs]n ,
+.BR \[rs]g ,
+.BR \[rs]$ ,
+.BR \[rs]* ,
and
-.B \[rs] V
+.B \[rs]V
normally;
interpreting
.BI \[rs] newline
immediately;
discarding comments
-.BR \[rs] "
+.B \[rs]"
and
-.BR \[rs] # ;
+.BR \[rs]# ;
interpolating the current leader,
escape,
or tab character with
-.BR \[rs] a ,
-.BR \[rs] e ,
+.BR \[rs]a ,
+.BR \[rs]e ,
and
-.BR \[rs] t ,
+.BR \[rs]t ,
respectively;
and storing all other escape sequences in an encoded form.
.
@@ -5450,12 +5454,12 @@ by default,
escapes itself.
.
Thus you can control whether a given
-.BR \[rs] n ,
-.BR \[rs] g ,
-.BR \[rs] $ ,
-.BR \[rs] * ,
+.BR \[rs]n ,
+.BR \[rs]g ,
+.BR \[rs]$ ,
+.BR \[rs]* ,
or
-.B \[rs] V
+.B \[rs]V
escape sequence is interpreted at the time the macro containing it is
defined,
or later when the macro is called.
@@ -5510,7 +5514,7 @@ to obtain a backslash glyph,
and
.B \[rs]&
before
-.RB \[lq] . \[rq]
+.RB \[lq] .\& \[rq]
and
.RB \[lq] \[aq] \[rq]
where
@@ -5528,12 +5532,12 @@ when it is executed.
.
This fact leads to exponential growth in the number of escape characters
required to delay interpolation of
-.BR \[rs] n ,
-.BR \[rs] g ,
-.BR \[rs] $ ,
-.BR \[rs] * ,
+.BR \[rs]n ,
+.BR \[rs]g ,
+.BR \[rs]$ ,
+.BR \[rs]* ,
and
-.B \[rs] V
+.B \[rs]V
at each nesting level.
.
An alternative is to use
@@ -5550,8 +5554,7 @@ to keep
.RB \[lq] ..\& \[rq]
from ending a macro definition prematurely.
.
-If the multiplicity of backslashes complicates
-maintenance,
+If the multiplicity of backslashes complicates maintenance,
use end macros.
.
.
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [groff] 09/16: groff(7): Fix style nits.,
G. Branden Robinson <=