[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[groff] 01/01: man/*.man: Improve style and consistency.
From: |
G. Branden Robinson |
Subject: |
[groff] 01/01: man/*.man: Improve style and consistency. |
Date: |
Thu, 9 Nov 2017 06:51:52 -0500 (EST) |
gbranden pushed a commit to branch master
in repository groff.
commit 7239885bc8f614e8ec14a5dd41c8fc6879ef0841
Author: G. Branden Robinson <address@hidden>
Date: Thu Nov 9 06:30:54 2017 -0500
man/*.man: Improve style and consistency.
* man/ditroff.7.man:
* man/groff.7.man:
* man/groff_char.7.man:
* man/groff_diff.7.man:
* man/groff_font.5.man:
* man/groff_out.5.man:
* man/groff_tmac.5.man:
* man/roff.7.man:
+ Break input lines at 72 columns.
+ Add editor settings to assist automating this.
+ Parallelize use and name of comment heading before editor settings.
* man/groff.7.man:
+ Trim section divider comments from 73 to 72 columns.
+ Add \& to prevent intersentence spacing within "so that ‘\\..’
expands to ‘..’."
* man/groff_tmac.5.man:
+ Hyphenate adjective phrase "driver-specific".
* man/roff.7.man:
+ Use em-dash instead of en-dash bracketed by spaces for narrative
interruption.
+ Future-proof paragraph reflowing by adding a \& after "cf.".
Signed-off-by: G. Branden Robinson <address@hidden>
---
man/ditroff.7.man | 10 +++++--
man/groff.7.man | 62 ++++++++++++++++++++++++-------------------
man/groff_char.7.man | 46 ++++++++++++++++++--------------
man/groff_diff.7.man | 74 ++++++++++++++++++++++++++++++----------------------
man/groff_font.5.man | 16 +++++++++---
man/groff_out.5.man | 14 +++++-----
man/groff_tmac.5.man | 22 +++++++++-------
man/roff.7.man | 42 +++++++++++++++--------------
8 files changed, 168 insertions(+), 118 deletions(-)
diff --git a/man/ditroff.7.man b/man/ditroff.7.man
index 496fd59..e3c004e 100644
--- a/man/ditroff.7.man
+++ b/man/ditroff.7.man
@@ -44,7 +44,8 @@ It supported only two output devices, the
.B nroff
program produced text oriented tty output, while the
.B troff
-program generated graphical output for exactly one output device, the Wang
+program generated graphical output for exactly one output device, the
+Wang
.I Graphic Systems CAT
typesetter.
.
@@ -152,7 +153,12 @@ The groff version of the intermediate output language, the
basis for
multi-devicing.
.
.
+.\" ====================================================================
+.\" Editor settings
+.\" ====================================================================
+.
.\" Local Variables:
.\" mode: nroff
+.\" fill-column: 72
.\" End:
-.\" vim: set filetype=groff:
+.\" vim: set filetype=groff textwidth=72:
diff --git a/man/groff.7.man b/man/groff.7.man
index 88a99b3..c9d3f44 100644
--- a/man/groff.7.man
+++ b/man/groff.7.man
@@ -40,7 +40,7 @@ groff \- a short reference for the GNU roff language
.de TPx
. TP 10n
..
-.\" =====================================================================
+.\" ====================================================================
.\" .Text anything ...
.\"
.\" All arguments are printed as text.
@@ -103,7 +103,7 @@ groff \- a short reference for the GNU roff language
.
.\" ========= escape sequences =========
.
-.\" =====================================================================
+.\" ====================================================================
.\" .ESC name [arg]
.\"
.\" Synopsis of an escape sequence, optionally with argument
@@ -115,7 +115,7 @@ groff \- a short reference for the GNU roff language
.de ESC
. Text "\f[CB]\e\\$1\,\f[I]\\$2\/\fR"
..
-.\" =====================================================================
+.\" ====================================================================
.\" .ESC[] name arg
.\"
.\" Synopsis for escape sequence with a bracketed long argument
@@ -127,7 +127,7 @@ groff \- a short reference for the GNU roff language
.de ESC[]
. Text "\f[CB]\e\\$1\[lB]\f[]\,\f[I]\\$2\/\f[]\f[CB]\[rB]\f[]"
..
-.\" =====================================================================
+.\" ====================================================================
.\" .ESCq name arg
.\"
.\" Synopsis for escape sequence with a bracketed long argument
@@ -139,7 +139,7 @@ groff \- a short reference for the GNU roff language
.de ESCq
. Text "\f[CB]\e\\$1\[cq]\f[]\,\f[I]\\$2\/\f[]\f[CB]\[cq]\f[]"
..
-.\" =====================================================================
+.\" ====================================================================
.\" .ESC? arg
.\"
.\" Synopsis for escape sequence with a bracketed long argument
@@ -150,7 +150,7 @@ groff \- a short reference for the GNU roff language
.de ESC?
. Text "\f[CB]\e?\,\f[I]\\$1\/\f[CB]?\f[R]"
..
-.\" =====================================================================
+.\" ====================================================================
.\" .esc name [punct]
.\"
.\" Reference of an escape sequence (no args), possibly punctuation
@@ -162,7 +162,7 @@ groff \- a short reference for the GNU roff language
.de esc
. BR "\e\\$1" \\$2
..
-.\" =====================================================================
+.\" ====================================================================
.\" .escarg name arg [punct]
.\"
.\" Reference of an escape sequence (no args)
@@ -175,7 +175,7 @@ groff \- a short reference for the GNU roff language
.de escarg
. Text \f[B]\e\\$1\f[]\,\f[I]\\$2\/\f[]\\$3
..
-.\" =====================================================================
+.\" ====================================================================
.\" .esc[] name arg [punct]
.\"
.\" Reference for escape sequence with a bracketed long argument
@@ -188,7 +188,7 @@ groff \- a short reference for the GNU roff language
. Text \f[CB]\e\\$1\[lB]\f[]\,\f[CI]\\$2\/\f[]\f[CB]\[rB]\f[]\\$3
..
.
-.\" =====================================================================
+.\" ====================================================================
.\" .escq name arg
.\"
.\" Reference for escape sequence with a bracketed long argument
@@ -668,8 +668,8 @@ Otherwise, it is non-special.
\f[CI]space\f[]
Space characters are only functional characters.
.
-They separate the arguments in requests, macros, and strings, and the words
-in text lines.
+They separate the arguments in requests, macros, and strings, and the
+words in text lines.
.
They are subject to groff's horizontal spacing calculations.
.
@@ -1080,8 +1080,8 @@ If an expression defined as
starts with a
.squoted_char +
sign the resulting value of the expression is added to an already
-existing value inherent to the related request, e.g.\& adding to a number
-register.
+existing value inherent to the related request, e.g.\& adding to a
+number register.
.
If the expression starts with a
.squoted_char -
@@ -1483,7 +1483,8 @@ can't be redefined.
.
.TPx
.REQ .dei "macro"
-Define or redefine a macro whose name is contained in the string register
+Define or redefine a macro whose name is contained in the string
+register
.I macro
until
.B ..\&
@@ -2227,8 +2228,8 @@ Return from a macro.
.
.TPx
.REQ .return "anything"
-Return twice, namely from the macro at the current level and from the macro
-one level higher.
+Return twice, namely from the macro at the current level and from the
+macro one level higher.
.
.TPx
.REQ .rfschar "f c1 c2 .\|.\|.\&"
@@ -2452,7 +2453,8 @@ Enable track kerning for
.IR font .
.
.TPx
-.REQ .tl
"\f[CB]\[cq]\f[]left\f[CB]\[cq]\f[]center\f[CB]\[cq]\f[]right\f[CB]\[cq]\f[]"
+.REQ .tl "\f[CB]\[cq]\f[]left\f[CB]\[cq]\f[]center\f[CB]\[cq]\f[]right\
+\f[CB]\[cq]\f[]"
Three-part title.
.
.TPx
@@ -2643,7 +2645,8 @@ address@hidden address@hidden stop
.
.
.P
-Note that the \[oq]ideal\[cq] preprocessor is not available in groff yet.
+Note that the \[oq]ideal\[cq] preprocessor is not available in groff
+yet.
.
.
.\" ====================================================================
@@ -2844,8 +2847,9 @@ the underline character.
.
.TP
.ESC .
-The same as a dot (\[oq].\[cq]). Necessary in nested macro
-definitions so that \[oq]\[rs]\[rs]..\[cq] expands to \[oq]..\[cq].
+The same as a dot (\[oq].\[cq]).
+Necessary in nested macro definitions so that \[oq]\[rs]\[rs]..\[cq]\&
+expands to \[oq]..\[cq].
.
.TP
.ESC %
@@ -3899,7 +3903,8 @@ It can be stored and used to set adjustment.
.
.TPx
.REG .k
-The current horizontal output position (relative to the current indentation).
+The current horizontal output position (relative to the current
+indentation).
.TPx
.REG .kern
1\~if pairwise kerning is enabled, 0\~otherwise.
@@ -3977,7 +3982,8 @@ Current page length.
.
.TPx
.REG .P
-1\~if the current page is being printed, 0\~otherwise (as determined by the
+1\~if the current page is being printed, 0\~otherwise (as determined by
+the
.option \-o
command-line option).
.
@@ -4226,8 +4232,8 @@ Vertical position of last printed text base-line.
.REG opminx
.TPx
.REG opminy
-These four registers mark the top left and bottom right hand corners of a box
-which encompasses all written glyphs.
+These four registers mark the top left and bottom right hand corners of
+a box which encompasses all written glyphs.
They are reset to \-1 by
.escarg O 0
or
@@ -4421,7 +4427,8 @@ gets lost, use the following:
\&.ds u3 after
\&.ie n \[rs]*[u1]\[rs]f[I]\[rs]*[u2]\[rs]f[P]\[rs]*[u3]
\&.el \[rs]*[u1]\[rs]Z\[aq]\[rs]*[u2]\[aq]\[rs]v\[aq].25m\[aq]\[rs]D\
-\[aq]l \[rs]w\[aq]\[rs]*[u2]\[aq]u 0\[aq]\[rs]v\[aq]\-.25m\[aq]\[rs]*[u3]
+\[aq]l \[rs]w\[aq]\[rs]*[u2]\[aq]u 0\[aq]\[rs]v\[aq]\-.25m\[aq]\[rs]*\
+[u3]
.EE
.RE
.
@@ -4646,10 +4653,11 @@ documentations and other information.
.
.
.\" ====================================================================
-.\" Emacs Setup
+.\" Editor settings
.\" ====================================================================
.
.\" Local Variables:
.\" mode: nroff
+.\" fill-column: 72
.\" End:
-.\" vim: set filetype=groff:
+.\" vim: set filetype=groff textwidth=72:
diff --git a/man/groff_char.7.man b/man/groff_char.7.man
index 6215372..728ba73 100644
--- a/man/groff_char.7.man
+++ b/man/groff_char.7.man
@@ -100,7 +100,8 @@ On EBCDIC platforms, only code page
is supported (which contains the same characters as \%latin1; the
input encoding file is called \f(CWcp1047.tmac\fP).
.
-Again, some input characters are reserved for internal and special purposes.
+Again, some input characters are reserved for internal and special
+purposes.
.
.
.P
@@ -230,8 +231,8 @@ Lower case letters a\(enz (print as themselves).
.
.
.P
-Most of the remaining characters not in the just described ranges print as
-themselves; the only exceptions are the following characters:
+Most of the remaining characters not in the just described ranges print
+as themselves; the only exceptions are the following characters:
.
.
.TP
@@ -509,12 +510,14 @@ backslash, namely \%\[oq]\e-\[cq], which can be either
accessed as
\[oq]\f(CW\e\-\fP\[cq] or \[oq]\f(CW\e[-]\fP\[cq].
.
.TP
-\f(CW\e[\fP\,\fIbase_glyph composite_1 composite_2 \&.\|.\|.\/\fP\f(CW]\fP
+\f(CW\e[\fP\,\fIbase_glyph composite_1 composite_2 \&.\|.\|.\/\fP\
+\f(CW]\fP
A composite glyph; see below for a more detailed description.
.
.
.P
-In groff, each \%8-bit input character can also referred to by the construct
+In groff, each \%8-bit input character can also referred to by the
+construct
\[oq]\f(CW\e[char\fP\,\fIn\/\fP\f(CW]\fP\[cq] where
.I n
is the decimal code of the character, a number between 0 and\ 255
@@ -530,14 +533,16 @@ Another special convention is the handling of glyphs with
names directly
derived from a Unicode code point; this is shown in the
\[oq]Unicode\[cq] column of the table below.
.
-In general, all glyphs not having a name as listed in this manual page can
-be accessed with the \[oq]\f(CW\e[u\fP\,\fIXXXX\/\fP\f(CW]\fP\[cq]
-construct; please go to section \[oq]Using Symbols\[cq] in the groff info
-manual for more details.
+In general, all glyphs not having a name as listed in this manual page
+can be accessed with the
+\[oq]\f(CW\e[u\fP\,\fIXXXX\/\fP\f(CW]\fP\[cq]
+construct; please go to section \[oq]Using Symbols\[cq] in the groff
+info manual for more details.
.
.
.P
-Moreover, new glyph names can be created by the \f(CW.char\fP request; see
+Moreover, new glyph names can be created by the \f(CW.char\fP request;
+see
.BR groff (@MAN7EXT@).
.
.P
@@ -1207,15 +1212,16 @@ T}
.P
.I Greek glyphs
.P
-These glyphs are intended for technical use, not for real Greek; normally,
-the uppercase letters have upright shape, and the lowercase ones are
-slanted.
+These glyphs are intended for technical use, not for real Greek;
+normally, the uppercase letters have upright shape, and the lowercase
+ones are slanted.
.
There is a problem with the mapping of letter phi to Unicode.
.
Prior to Unicode version\ 3.0, the difference between U+03C6, GREEK
-SMALL LETTER PHI, and U+03D5, GREEK PHI SYMBOL, was not clearly described;
-only the glyph shapes in the Unicode book could be used as a reference.
+SMALL LETTER PHI, and U+03D5, GREEK PHI SYMBOL, was not clearly
+described; only the glyph shapes in the Unicode book could be used as a
+reference.
.
Starting with Unicode\ 3.0, the reference glyphs have been exchanged and
described verbally also: In mathematical context, U+03D5 is the stroked
@@ -1349,8 +1355,8 @@ a short reference of the groff formatting language
.
.P
.IR "An extension to the troff character set for Europe" ,
-E.G.\& Keizer, K.J.\& Simonsen, J.\& Akkerhuis; EUUG Newsletter, Volume 9,
-No.\& 2, Summer 1989
+E.G.\& Keizer, K.J.\& Simonsen, J.\& Akkerhuis; EUUG Newsletter,
+Volume 9, No.\& 2, Summer 1989
.
.
.P
@@ -1363,10 +1369,12 @@ The Unicode Standard
.
.
.\" ====================================================================
-.\" Emacs settings
+.\" Editor settings
.\" ====================================================================
+.
.\" Local Variables:
.\" mode: nroff
+.\" fill-column: 72
.\" tab-width: 20
.\" End:
-.\" vim: set filetype=groff:
+.\" vim: set filetype=groff tabstop=20 textwidth=72:
diff --git a/man/groff_diff.7.man b/man/groff_diff.7.man
index 06a6fce..85c9161 100644
--- a/man/groff_diff.7.man
+++ b/man/groff_diff.7.man
@@ -98,9 +98,11 @@ The names of number registers, fonts,
strings/\:macros/\:diversions,
special characters (glyphs), and colors can be of any length.
.
In escape sequences, additionally to the classical
-\[oq]\fB(\fP\,\fIxx\/\fP\[cq] construction for a two-character glyph name,
-you can use \[oq]\fB[\fP\,\fIxxx\/\fP\fB]\fP\[cq] for a name of
-arbitrary length.
+\[oq]\fB(\fP\,\fIxx\/\fP\[cq]
+construction for a two-character glyph name,
+you can use
+\[oq]\fB[\fP\,\fIxxx\/\fP\fB]\fP\[cq]
+for a name of arbitrary length.
.
.TP
.BI \[rs][ xxx ]
@@ -298,8 +300,8 @@ or\~\c
.BR 0 ,
depending on whether
.I anything
-is or is not acceptable as the name of a string, macro, diversion, number
-register, environment, font, or color.
+is or is not acceptable as the name of a string, macro, diversion,
+number register, environment, font, or color.
.
It returns\~\c
.B 0
@@ -685,7 +687,8 @@ Thus
\&.nr x 1
\&.nf
\&.di d
-\&\[rs]?\[rs]\[rs]?\[rs]\[rs]\[rs]\[rs]?\[rs]\[rs]\[rs]\[rs]\[rs]\[rs]\[rs]\c
+\&\[rs]?\[rs]\[rs]?\[rs]\[rs]\[rs]\[rs]?\[rs]\[rs]\[rs]\[rs]\[rs]\[rs]\
+\[rs]\c
\&\[rs]nx\[rs]\[rs]\[rs]\[rs]?\[rs]\[rs]?\[rs]?
\&.di
\&.nr x 2
@@ -1028,8 +1031,8 @@ Use this in combination with values 2 and\~4 (initially
no characters
have this property).
.
.IP 128
-Prohibit a line break before the character, but allow a line break after the
-character.
+Prohibit a line break before the character, but allow a line break after
+the character.
This works only in combination with flags 256 and 512 and has no effect
otherwise.
.
@@ -1050,9 +1053,10 @@ Contrary to flag values 2 and\~4, the flags 128, 256,
and 512 work
pairwise.
.
If, for example, the left character has value 512, and the right
-character 128, no line break gets inserted. If we use value\~6
-instead for the left character, a line break after the character
-can't be suppressed since the right neighbour character
+character 128, no line break gets inserted.
+.
+If we use value\~6 instead for the left character, a line break after
+the character can't be suppressed since the right neighbour character
doesn't get examined.
.
.TP
@@ -1507,8 +1511,8 @@ for font\~\c
.IR f .
.I zoom
must a non-negative integer multiple of 1/1000th.
-If it is missing or is equal to zero, it means the same as 1000, namely no
-magnification.
+If it is missing or is equal to zero, it means the same as 1000, namely
+no magnification.
.IR f \~\c
must be a real font name, not a style.
.
@@ -1535,9 +1539,9 @@ and so on.
A hyphenation code must be a single input character (not a special
character) other than a digit or a space.
.
-Initially each lower-case letter \%a\[en]z has a hyphenation code, which is
-itself, and each upper-case letter \%A\[en]Z has a hyphenation code which is
-the lower-case version of itself.
+Initially each lower-case letter \%a\[en]z has a hyphenation code, which
+is itself, and each upper-case letter \%A\[en]Z has a hyphenation code
+which is the lower-case version of itself.
.
See also the
.B hpf
@@ -1699,7 +1703,8 @@ The arguments of
.B hpfcode
must be integers in the range 0 to\~255.
.
-Note that it is even possible to use character codes which are invalid in
+Note that it is even possible to use character codes which are invalid
+in
.B groff
otherwise.
.
@@ -1905,7 +1910,8 @@ exists, append to it instead of truncating it.
.BI .output\ string
Emit
.I string
-directly to the intermediate output (subject to copy-mode interpretation);
+directly to the intermediate output (subject to copy-mode
+interpretation);
this is similar to
.B \[rs]!\&
used at the top level.
@@ -1997,8 +2003,8 @@ request.
.B .return
Within a macro, return immediately.
.
-If called with an argument, return twice, namely from the current macro and
-from the macro one level higher.
+If called with an argument, return twice, namely from the current macro
+and from the macro one level higher.
.
No effect otherwise.
.
@@ -3185,8 +3191,8 @@ and
.BR \[rs]Z .
.
When decoding a macro or string argument that is delimited by double
-quotes, a character that appears at a different input level to the starting
-delimiter character is not recognized as the closing delimiter
+quotes, a character that appears at a different input level to the
+starting delimiter character is not recognized as the closing delimiter
character.
.
The implementation of
@@ -3276,8 +3282,8 @@ If there is a glyph named
.B \[rs]|
or
.BR \[rs]^ ,
-respectively (note the leading backslash), defined in the current font file,
-use this glyph's width instead of the default value.
+respectively (note the leading backslash), defined in the current font
+file, use this glyph's width instead of the default value.
.
.P
It is now possible to have whitespace between the first and second dot
@@ -3349,8 +3355,9 @@ commands.
is any sequence of characters terminated by a space or a newline (to
be more precise, it is a sequence of glyphs which are accessed with
the corresponding characters); the first character should be printed at
-the current position, the current horizontal position should be increased
-by the width of the first character, and so on for each character.
+the current position, the current horizontal position should be
+increased by the width of the first character, and so on for each
+character.
.
The width of the glyph is that given in the font file,
appropriately scaled for the current point size, and rounded so that
@@ -3484,7 +3491,8 @@ delim $$
.EN
.
.TP
-\f[B]Dp\f[R] $dx sub 1$ $dy sub 1$ $dx sub 2$ $dy sub 2$ $...$ $dx sub n$ $dy
sub n$\[rs]n
+\f[B]Dp\f[R] $dx sub 1$ $dy sub 1$ $dx sub 2$ $dy sub 2$ $...$ \
+$dx sub n$ $dy sub n$\[rs]n
Draw a polygon with, for $i = 1 ,..., n+1$, the
.IR i -th
vertex at the current position
@@ -3495,7 +3503,8 @@ At the moment, GNU pic only uses this command to generate
triangles
and rectangles.
.
.TP
-\f[B]DP\f[R] $dx sub 1$ $dy sub 1$ $dx sub 2$ $dy sub 2$ $...$ $dx sub n$ $dy
sub n$\[rs]n
+\f[B]DP\f[R] $dx sub 1$ $dy sub 1$ $dx sub 2$ $dy sub 2$ $...$ \
+$dx sub n$ $dy sub n$\[rs]n
.
Like
.B Dp
@@ -3527,7 +3536,8 @@ does not depend on this.
.
Given a drawing command of the form
.IP
-\f[B]\[rs]D'\f[I]c\f[R] $x sub 1$ $y sub 1$ $x sub 2$ $y sub 2$ $...$ $x sub
n$ $y sub n$\f[B]'\f[R]
+\f[B]\[rs]D'\f[I]c\f[R] $x sub 1$ $y sub 1$ $x sub 2$ $y sub 2$ $...$ \
+$x sub n$ $y sub n$\f[B]'\f[R]
.
.P
where
@@ -3570,7 +3580,8 @@ Thus after executing a
.BR D \~\c
command of the form
.IP
-\f[B]D\f[I]c\f[R] $x sub 1$ $y sub 1$ $x sub 2$ $y sub 2$ $...$ $x sub n$ $y
sub n$\[rs]n
+\f[B]D\f[I]c\f[R] $x sub 1$ $y sub 1$ $x sub 2$ $y sub 2$ $...$ \
+$x sub n$ $y sub n$\[rs]n
.
.P
the current position should be increased by
@@ -3962,5 +3973,6 @@ classical troff documentation
.
.\" Local Variables:
.\" mode: nroff
+.\" fill-column: 72
.\" End:
-.\" vim: set filetype=groff:
+.\" vim: set filetype=groff textwidth=72:
diff --git a/man/groff_font.5.man b/man/groff_font.5.man
index 656cba9..dd76bba 100644
--- a/man/groff_font.5.man
+++ b/man/groff_font.5.man
@@ -117,7 +117,8 @@ PostScript input.
.
Under GNU/Linux this is usually
.I gs
-but under other systems (notably cygwin) it might be set to another name.
+but under other systems (notably cygwin) it might be set to another
+name.
.
.TP
.BI "paperlength " n
@@ -172,8 +173,8 @@ for picas.
Example:
.BR 12c,235p .
.
-An argument which starts with a digit is always treated as a custom paper
-format.
+An argument which starts with a digit is always treated as a custom
+paper format.
.
.B papersize
sets both the vertical and horizontal dimension of the output medium.
@@ -716,7 +717,14 @@ for graphical mode (default is PDF mode).
.
.
.cp \n[groff_font_C]
+.
+.
+.\" ====================================================================
+.\" Editor settings
+.\" ====================================================================
+.
.\" Local Variables:
.\" mode: nroff
+.\" fill-column: 72
.\" End:
-.\" vim: set filetype=groff:
+.\" vim: set filetype=groff textwidth=72:
diff --git a/man/groff_out.5.man b/man/groff_out.5.man
index dc694c2..13a5bc2 100644
--- a/man/groff_out.5.man
+++ b/man/groff_out.5.man
@@ -64,7 +64,8 @@ after these commands, otherwise the position is not changed.
.RI ( \,\\$1\/ ,\ \,\\$2\/ )\\$3
..
.de indexed_offset
-.offset \fI\\$1\/\fP\d\s-3\\$2\s+3\u\x'\n[.v]/4'
\fI\\$3\/\fP\d\s-3\\$4\s+3\u\x'\n[.v]/4' \\$5\x'\n[.v]/4'
+.offset \fI\\$1\/\fP\d\s-3\\$2\s+3\u\x'\n[.v]/4' \fI\\$3\/\fP\
+\d\s-3\\$4\s+3\u\x'\n[.v]/4' \\$5\x'\n[.v]/4'
..
.\" format: .command <name> "<arguments>" <punctuation>
.de command
@@ -659,8 +660,8 @@ If
.B \-T\~html
or
.B \-T\~xhtml
-is used, negative values are emitted also to indicate an unbreakable space
-with given width.
+is used, negative values are emitted also to indicate an unbreakable
+space with given width.
.
For example,
.B N\~\-193
@@ -2004,10 +2005,11 @@ CSTR\~#54
.
.
.\" ====================================================================
-.\" Emacs settings
+.\" Editor settings
.\" ====================================================================
-.\"
+.
.\" Local Variables:
.\" mode: nroff
+.\" fill-column: 72
.\" End:
-.\" vim: set filetype=groff:
+.\" vim: set filetype=groff textwidth=72:
diff --git a/man/groff_tmac.5.man b/man/groff_tmac.5.man
index 6bb8a4b..7e29618 100644
--- a/man/groff_tmac.5.man
+++ b/man/groff_tmac.5.man
@@ -69,8 +69,8 @@ directories.
provides all classical macro packages, some more full packages, and
some secondary packages for special purposes.
.
-Note that it is not possible to use multiple primary macro packages at the
-same time; saying e.g.\&
+Note that it is not possible to use multiple primary macro packages at
+the same time; saying e.g.\&
.
.IP
.EX
@@ -200,8 +200,8 @@ sets the input encoding to latin-2.
.B de
.TQ
.B den
-German localization support, including the main macro packages (me, mom, mm,
-and ms).
+German localization support, including the main macro packages (me, mom,
+mm, and ms).
.
.IP
.B de.tmac
@@ -236,7 +236,8 @@ sets the input encoding to latin-9 to get proper support of
the
.
.TP
.B sv
-Swedish localization support, including the me, mom, and ms macro packages.
+Swedish localization support, including the me, mom, and ms macro
+packages.
.
Note that Swedish for the mm macros is handled separately; see
.BR groff_mmse (@MAN7EXT@).
@@ -379,8 +380,8 @@ Most output drivers need additional command-line switches
.B \-p
and
.B \-l
-to override the default paper length and orientation as set in the driver
-specific DESC file.
+to override the default paper length and orientation as set in the
+driver-specific DESC file.
.
For example, use the following for PS output on A4 paper in landscape
orientation:
@@ -1133,8 +1134,8 @@ calling the diversion just like a macro.
.
.
.P
-Most of the problems arising with diversions can be avoided if you remain
-aware of the fact that diversions always store complete lines.
+Most of the problems arising with diversions can be avoided if you
+remain aware of the fact that diversions always store complete lines.
.
If diversions are used when the line buffer has not been flushed,
strange results are produced; not knowing this, many people get
@@ -1321,5 +1322,6 @@ FHS web site
.
.\" Local Variables:
.\" mode: nroff
+.\" fill-column: 72
.\" End:
-.\" vim: filetype=groff:
+.\" vim: set filetype=groff textwidth=72:
diff --git a/man/roff.7.man b/man/roff.7.man
index 145e010..d3f7dff 100644
--- a/man/roff.7.man
+++ b/man/roff.7.man
@@ -79,8 +79,8 @@ system today is the free software implementation \f[CR]GNU\f[]
.BR groff (@MAN1EXT@).
.
.I groff
-implements the look-and-feel and functionality of its ancestors, with many
-extensions.
+implements the look-and-feel and functionality of its ancestors, with
+many extensions.
.
.
.P
@@ -117,7 +117,8 @@ is used to format UNIX
.IR "manual pages" ,
(or
.IR "man pages" ),
-the standard documentation system on many UNIX-derived operating systems.
+the standard documentation system on many UNIX-derived operating
+systems.
.
.
.P
@@ -142,8 +143,8 @@ Document formatting by computer dates back to the 1960s.
.
The
.I roff
-system itself is intimately connected to the Unix operating system, but its
-roots go back to the earlier operating systems CTSS and Multics.
+system itself is intimately connected to the Unix operating system, but
+its roots go back to the earlier operating systems CTSS and Multics.
.
.
.\" ====================================================================
@@ -157,8 +158,8 @@ was written in the MAD language by
.I Jerry Saltzer
for the
.IR "Compatible Time Sharing System (CTSS)" ,
-a project of the Massachusetts Institute of Technology (MIT), in 1963 and
-1964 \[en] note that CTSS commands were all uppercase.
+a project of the Massachusetts Institute of Technology (MIT), in 1963
+and 1964\[em]note that CTSS commands were all uppercase.
.
.P
In 1965, MIT's Project MAC teamed with Bell Telephone Laboratories
@@ -179,8 +180,8 @@ and other members of the Multics team.
.P
Like its CTSS ancestor, Multics
.B runoff
-formatted an input file consisting of text and command lines; commands began
-with a period and were two letters.
+formatted an input file consisting of text and command lines; commands
+began with a period and were two letters.
.
Output from these commands was to terminal devices such as IBM Selectric
terminals.
@@ -195,8 +196,8 @@ processing.
.P
BCPL and
.B runoff
-were ported to the GCOS system at Bell Labs when BTL left the development of
-Multics.
+were ported to the GCOS system at Bell Labs when BTL left the
+development of Multics.
.
.
.P
@@ -231,7 +232,8 @@ $git clone https://github.com/bwarken/runoff.git
.
At BTL, there was a need to drive the
.I Graphic Systems CAT
-typesetter, a graphical output device from a PDP-11 computer running Unix.
+typesetter, a graphical output device from a PDP-11 computer running
+Unix.
.
As
.B runoff
@@ -421,9 +423,9 @@ An alternative is
.UR https://\:github.com/\:n\-t\-roff/\:heirloom\-doctools
.I Gunnar Ritter's Heirloom roff project
.UE
-project, started in 2005, which provides enhanced versions of the various
-roff tools found in the OpenSolaris and Plan\~9 operating systems, now
-available under free licenses.
+project, started in 2005, which provides enhanced versions of the
+various roff tools found in the OpenSolaris and Plan\~9 operating
+systems, now available under free licenses.
.
You can get this package with the shell command:
.RS
@@ -917,7 +919,8 @@ of the man pages.
.
.
.P
-The classical macro packages take the package name as an extension, e.g.\&
+The classical macro packages take the package name as an extension,
+e.g.\&
.IB file. me
for a document using the
.I me
@@ -1044,7 +1047,7 @@ This is the next sentence in the same paragraph.
\&.
.
This is a longer sentence stretching over several input lines;
-abbreviations like cf. are easily identified because the dot is
+abbreviations like cf\&. are easily identified because the dot is
not followed by a line break.
\&.
.
@@ -1416,10 +1419,11 @@ might be a good starting point.
.
.
.\" ====================================================================
-.\" Emacs setup
+.\" Editor settings
.\" ====================================================================
.
.\" Local Variables:
.\" mode: nroff
+.\" fill-column: 72
.\" End:
-.\" vim: set filetype=groff:
+.\" vim: set filetype=groff textwidth=72:
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [groff] 01/01: man/*.man: Improve style and consistency.,
G. Branden Robinson <=