[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[groff] 21/122: [man pages]: Break input lines consistently.
From: |
G. Branden Robinson |
Subject: |
[groff] 21/122: [man pages]: Break input lines consistently. |
Date: |
Wed, 11 Nov 2020 02:59:08 -0500 (EST) |
gbranden pushed a commit to branch master
in repository groff.
commit ffddc27a942c2836c651d8a76a023bb5b41b06fe
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Sun Nov 8 13:06:59 2020 +1100
[man pages]: Break input lines consistently.
* contrib/mm/groff_mm.7.man:
* man/groff_font.5.man:
* src/roff/nroff/nroff.1.man:
* src/utils/pfbtops/pfbtops.1.man:
Break input lines after (prose) commas, semicolons, and colons, and
set multi-word parentheticals on their own input lines.
---
contrib/mm/groff_mm.7.man | 8 +--
man/groff_font.5.man | 114 +++++++++++++++++++++++++++-------------
src/roff/nroff/nroff.1.man | 3 +-
src/utils/pfbtops/pfbtops.1.man | 3 +-
4 files changed, 86 insertions(+), 42 deletions(-)
diff --git a/contrib/mm/groff_mm.7.man b/contrib/mm/groff_mm.7.man
index e1b13ba..6aa40f8 100644
--- a/contrib/mm/groff_mm.7.man
+++ b/contrib/mm/groff_mm.7.man
@@ -118,7 +118,8 @@ name and so on.
.
.
.LP
-In this manual, square brackets are used to show optional arguments.
+In this manual,
+square brackets are used to show optional arguments.
.
.
.\" ====================================================================
@@ -3904,8 +3905,9 @@ letter type.
.
The name of the submacro has the letter type as suffix.
.
-It is therefore possible to define other letter types, either in the
-territory-specific macro file, or as local additions.
+It is therefore possible to define other letter types,
+either in the territory-specific macro file,
+or as local additions.
.
.B .LT
sets the number variables
diff --git a/man/groff_font.5.man b/man/groff_font.5.man
index cb0d7dd..9a121ce 100644
--- a/man/groff_font.5.man
+++ b/man/groff_font.5.man
@@ -130,7 +130,8 @@ The physical vertical dimension of the output medium in
machine units.
.
This isn't used by
.I \%@g@troff
-itself but by output devices.
+itself,
+but by output devices.
.
Deprecated.
.
@@ -144,10 +145,22 @@ Select a paper size.
.
Valid values for
.I string
-are the ISO paper types A0\[en]A7, B0\[en]B7, C0\[en]C7, D0\[en]D7,
-DL, and the US paper
-types letter, legal, tabloid, ledger, statement, executive, com10, and
-monarch.
+are the ISO paper types
+.BR A0 \[en] A7 ,
+.BR B0 \[en] B7 ,
+.BR C0 \[en] C7 ,
+.BR D0 \[en] D7 ,
+.BR DL ,
+and the US paper types
+.BR letter ,
+.BR legal ,
+.BR tabloid ,
+.BR ledger ,
+.BR statement ,
+.BR executive ,
+.BR com10 ,
+and
+.BR monarch .
.
Case is not significant for
.I string
@@ -171,9 +184,11 @@ Both
.I length
and
.I width
-must have a unit appended; valid values are \[oq]i\[cq] for inches,
-\[oq]c\[cq] for centimeters, \[oq]p\[cq] for points, and \[oq]P\[cq]
-for picas.
+must have a unit appended;
+valid values are \[oq]i\[cq] for inches,
+\[oq]c\[cq] for centimeters,
+\[oq]p\[cq] for points,
+and \[oq]P\[cq] for picas.
.
Example:
.BR 12c,235p .
@@ -201,7 +216,8 @@ instead.
.
This isn't used by
.I \%@g@troff
-itself but by output devices.
+itself,
+but by output devices.
.
.TP
.B pass_filenames
@@ -229,7 +245,8 @@ Use
.I program
as the spooler program for printing.
.
-If omitted, the
+If omitted,
+the
.B \-l
and
.B \-L
@@ -306,16 +323,19 @@ instead of glyphs.
.IP
If
.B unicode
-is present, no
+is present,
+no
.B charset
section is required in the font description files since the Unicode
handling built into
.I groff
is used.
.
-However, if there are entries in a
+However,
+if there are entries in a
.B charset
-section, they either override the default mappings for those
+section,
+they either override the default mappings for those
particular characters or add new mappings (normally for composite
characters).
.
@@ -365,7 +385,8 @@ Not all commands in the
.I DESC
file are used by
.I \%@g@troff
-itself; some of the keywords (or even additional ones) are used by
+itself;
+some of the keywords (or even additional ones) are used by
postprocessors to store arbitrary information about the device.
.
.LP
@@ -381,11 +402,14 @@ but completely ignored:
.SS "Font file format"
.\" ====================================================================
.
-A font file has two sections; empty lines are ignored in both of them.
+A font file has two sections;
+empty lines are ignored in both of them.
.
.LP
The first section is a sequence of lines each containing a sequence of
-blank delimited words; the first word in the line is a key, and
+blank delimited words;
+the first word in the line is a key,
+and
subsequent words give a value for that key.
.
.TP
@@ -393,7 +417,8 @@ subsequent words give a value for that key.
Glyphs
.IR lig1 ,
.IR lig2 ", \|.\|.\|., " lign
-are ligatures; possible ligatures are
+are ligatures;
+possible ligatures are
.BR ff ,
.BR fi ,
.BR fl ,
@@ -401,7 +426,8 @@ are ligatures; possible ligatures are
and
.BR ffl .
.
-For backwards compatibility, the list of ligatures may be terminated
+For backwards compatibility,
+the list of ligatures may be terminated
with a\~\c
.BR 0 .
.
@@ -430,8 +456,8 @@ The normal width of a space is\~\c
The font is
.IR special ;
this means that when a glyph is requested that is not present in
-the current font, it is searched for in any special fonts that are
-mounted.
+the current font,
+it is searched for in any special fonts that are mounted.
.
.LP
Other commands are ignored by
@@ -491,8 +517,8 @@ then it corresponds to the groff input character
.IR c ;
if it is of the form
.BI \[rs] c
-where c is a single character, then it
-corresponds to the special character
+where c is a single character,
+then it corresponds to the special character
.BI \[rs][ c ]\fR;
otherwise it corresponds to the groff input character
.BI \[rs][ name ]\fR.
@@ -522,15 +548,20 @@ field gives the glyph type:
.
.TP
1
-means the glyph has a descender, for example, \[oq]p\[cq];
+means the glyph has a descender,
+for example,
+\[oq]p\[cq];
.
.TP
2
-means the glyph has an ascender, for example, \[oq]b\[cq];
+means the glyph has an ascender,
+for example,
+\[oq]b\[cq];
.
.TP
3
-means the glyph has both an ascender and a descender, for example,
+means the glyph has both an ascender and a descender,
+for example,
\[oq](\[cq].
.
.LP
@@ -553,7 +584,9 @@ or
.B 0X
it is interpreted as hexadecimal.
.
-Note, however, that the
+Note,
+however,
+that the
.B \[rs]N
escape sequence only accepts a decimal integer.
.
@@ -602,8 +635,8 @@ Missing subfields are assumed to be\~0.
.
The subfields are all decimal integers.
.
-Since there is no associated binary format, these
-values are not required to fit into a variable of type
+Since there is no associated binary format,
+these values are not required to fit into a variable of type
.B char
as they are in ditroff.
.
@@ -614,15 +647,19 @@ subfields gives the width of the glyph.
The
.I height
subfield gives the height of the glyph (upwards is positive);
-if a glyph does not extend above the baseline, it should be
-given a zero height, rather than a negative height.
+if a glyph does not extend above the baseline,
+it should be given a zero height,
+rather than a negative height.
.
The
.I depth
-subfield gives the depth of the glyph, that is, the distance
-below the baseline to which the glyph extends (downwards is positive);
-if a glyph does not extend below the baseline, it should be
-given a zero depth, rather than a negative depth.
+subfield gives the depth of the glyph,
+that is,
+the distance below the baseline to which the glyph extends (downwards is
+positive);
+if a glyph does not extend below the baseline,
+it should be given a zero depth,
+rather than a negative depth.
.
The
.I italic-correction
@@ -710,8 +747,10 @@ You can browse it interactively with \[lq]info groff\[rq].
.
.LP
\[lq]Troff User's Manual\[rq]
-by Joseph F.\& Ossanna, 1976
-(revised by Brian W.\& Kernighan, 1992),
+by Joseph F.\& Ossanna,
+1976
+(revised by Brian W.\& Kernighan,
+1992),
AT&T Bell Laboratories Computing Science Techical Report No.\& 54,
widely called simply \[lq]CSTR\~#54\[rq],
documents the language,
@@ -725,7 +764,8 @@ documentation as
.
.LP
\[lq]A Typesetter-independent TROFF\[rq]
-by Brian W.\& Kernighan, 1982,
+by Brian W.\& Kernighan,
+1982,
AT&T Bell Laboratories Computing Science Techical Report No.\& 97,
provides additional insights into the
device and font description file formats
diff --git a/src/roff/nroff/nroff.1.man b/src/roff/nroff/nroff.1.man
index 8746073..23473d1 100644
--- a/src/roff/nroff/nroff.1.man
+++ b/src/roff/nroff/nroff.1.man
@@ -189,7 +189,8 @@ The options
.B \-t
(tbl),
.B \-S
-(safer), and
+(safer),
+and
.B \-U
(unsafe) are passed to
.IR groff .
diff --git a/src/utils/pfbtops/pfbtops.1.man b/src/utils/pfbtops/pfbtops.1.man
index 02832ac..0d63d90 100644
--- a/src/utils/pfbtops/pfbtops.1.man
+++ b/src/utils/pfbtops/pfbtops.1.man
@@ -62,7 +62,8 @@ ASCII, splitting overlong lines in text packets into smaller
chunks.
.
If
.I pfb-file
-is omitted, the PFB file will be read from the standard input.
+is omitted,
+the PFB file will be read from the standard input stream.
.
The ASCII format PostScript font will be written on the standard output.
.
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [groff] 21/122: [man pages]: Break input lines consistently.,
G. Branden Robinson <=