[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[groff] 01/01: man pages: Fix misuse of two-font macros.
|
From: |
G. Branden Robinson |
|
Subject: |
[groff] 01/01: man pages: Fix misuse of two-font macros. |
|
Date: |
Mon, 19 Nov 2018 02:29:15 -0500 (EST) |
gbranden pushed a commit to branch master
in repository groff.
commit 253d2295cbc6b1556f52ef45e9a70f18c4b319c5
Author: G. Branden Robinson <address@hidden>
Date: Mon Nov 19 02:21:25 2018 -0500
man pages: Fix misuse of two-font macros.
* contrib/chem/chem.1.man:
* contrib/glilypond/glilypond.1.man:
* contrib/mom/groff_mom.7.man:
* contrib/pdfmark/pdfroff.1.man:
* man/groff.7.man:
* man/groff_diff.7.man:
* man/groff_font.5.man:
* man/groff_tmac.5.man:
* man/roff.7.man:
* src/devices/grolbp/grolbp.1.man:
* src/devices/grops/grops.1.man:
* src/preproc/eqn/eqn.1.man:
* src/preproc/refer/refer.1.man:
* src/roff/groff/groff.1.man:
* src/roff/nroff/nroff.1.man:
* src/utils/indxbib/indxbib.1.man:
* tmac/groff_man.7.man:
* tmac/groff_ms.7.man: Variously:
+ Convert two-font to one macro; or
+ Add whitespace so second argument is recognized and set
correctly; or
+ Add commas (including Oxford commas) to lists.
Fixes <https://savannah.gnu.org/bugs/index.php?51314>. Thanks
to Bjarni Ingi Gislason for pointing out the issue; I applied my
own corrections, so blame me if there are problems.
Also fixes <https://savannah.gnu.org/bugs/index.php?55051>, a
more-recently-introduced instance of the same basic issue.
Signed-off-by: G. Branden Robinson <address@hidden>
---
contrib/chem/chem.1.man | 2 +-
contrib/glilypond/glilypond.1.man | 2 +-
contrib/mom/groff_mom.7.man | 96 +++++++++++++++++++--------------------
contrib/pdfmark/pdfroff.1.man | 6 +--
man/groff.7.man | 2 +-
man/groff_diff.7.man | 8 ++--
man/groff_font.5.man | 4 +-
man/groff_tmac.5.man | 6 +--
man/roff.7.man | 2 +-
src/devices/grolbp/grolbp.1.man | 2 +-
src/devices/grops/grops.1.man | 12 ++---
src/preproc/eqn/eqn.1.man | 6 +--
src/preproc/refer/refer.1.man | 4 +-
src/roff/groff/groff.1.man | 8 ++--
src/roff/nroff/nroff.1.man | 4 +-
src/utils/indxbib/indxbib.1.man | 2 +-
tmac/groff_man.7.man | 2 +-
tmac/groff_ms.7.man | 2 +-
18 files changed, 85 insertions(+), 85 deletions(-)
diff --git a/contrib/chem/chem.1.man b/contrib/chem/chem.1.man
index f279561..f6397c4 100644
--- a/contrib/chem/chem.1.man
+++ b/contrib/chem/chem.1.man
@@ -858,7 +858,7 @@ macros needed by
A macro file which redefines
.B .PS
and
-.BR .PE
+.B .PE
to center
.I pic
diagrams.
diff --git a/contrib/glilypond/glilypond.1.man
b/contrib/glilypond/glilypond.1.man
index 637c58e..d3f736e 100644
--- a/contrib/glilypond/glilypond.1.man
+++ b/contrib/glilypond/glilypond.1.man
@@ -161,7 +161,7 @@ it is easier to use the following device options, either
.
.BR \-\-ps ,
.BR \-\-div ,
-.BR \-\-html,
+.BR \-\-html ,
or
.BR \-\-xhtml .
.
diff --git a/contrib/mom/groff_mom.7.man b/contrib/mom/groff_mom.7.man
index c198489..e014349 100644
--- a/contrib/mom/groff_mom.7.man
+++ b/contrib/mom/groff_mom.7.man
@@ -280,13 +280,13 @@ move backwards in a line
.
.
.TP
-.BI \[rs]*[BOLDER]
+.B \[rs]*[BOLDER]
invoke pseudo bold inline (related to macro
.BR .SETBOLDER )
.
.
.TP
-.BI \[rs]*[BOLDERX]
+.B \[rs]*[BOLDERX]
off pseudo bold inline (related to macro
.BR .SETBOLDER )
.
@@ -298,13 +298,13 @@ move characters pairs closer together inline (related to
macro
.
.
.TP
-.BI \[rs]*[COND]
+.B \[rs]*[COND]
invoke pseudo condensing inline (related to macro
.BR \%.CONDENSE )
.
.
.TP
-.BI \[rs]*[CONDX]
+.B \[rs]*[CONDX]
off pseudo condensing inline (related to macro
.BR \%.CONDENSE )
.
@@ -320,19 +320,19 @@ temporarily move downwards in a line
.
.
.TP
-.BI \[rs]*[EN-MARK]
+.B \[rs]*[EN-MARK]
mark initial line of a range of line numbers (for use with line
numbered endnotes)
.
.
.TP
-.BI \[rs]*[EXT]
+.B \[rs]*[EXT]
invoke pseudo extending inline (related to macro
.BR \%.EXTEND )
.
.
.TP
-.BI \[rs]*[EXTX]
+.B \[rs]*[EXTX]
off pseudo condensing inline (related to macro
.BR \%.EXTEND )
.
@@ -354,12 +354,12 @@ move forward in a line
.
.
.TP
-.BI \[rs]*[LEADER]
+.B \[rs]*[LEADER]
insert leaders at the end of a line
.
.
.TP
-.BI \[rs]*[RULE]
+.B \[rs]*[RULE]
draw a full measure rule
.
.
@@ -370,13 +370,13 @@ change the point size inline (related to macro
.
.
.TP
-.BI \[rs]*[SLANT]
+.B \[rs]*[SLANT]
invoke pseudo italic inline (related to macro
.BR \%.SETSLANT )
.
.
.TP
-.BI \[rs]*[SLANTX]
+.B \[rs]*[SLANTX]
off pseudo italic inline (related to macro
.BR \%.SETSLANT )
.
@@ -413,47 +413,47 @@ temporarily move upwards in a line
.\" ====================================================================
.
.TP
-.BI .AUTOLEAD
+.B .AUTOLEAD
set the linespacing relative to the point size
.
.
.TP
-.BI .B_MARGIN
+.B .B_MARGIN
set a bottom margin
.
.
.TP
-.BI .BR
+.B .BR
break a justified line
.
.
.TP
-.BI .CENTER
+.B .CENTER
set line-by-line quad centre
.
.
.TP
-.BI .CONDENSE
+.B .CONDENSE
set the amount to pseudo condense
.
.
.TP
-.BI .EL
+.B .EL
break a line without advancing on the page
.
.
.TP
-.BI .EXTEND
+.B .EXTEND
set the amount to pseudo extend
.
.
.TP
-.BI .FALLBACK_FONT
+.B .FALLBACK_FONT
establish a fallback font (for missing fonts)
.
.
.TP
-.BI .FAM
+.B .FAM
alias to
.B .FAMILY
.
@@ -465,7 +465,7 @@ set the
.
.
.TP
-.BI .FT
+.B .FT
set the font style (roman, italic, etc.)
.
.
@@ -475,12 +475,12 @@ hanging indent
.
.
.TP
-.BI .HY
+.B .HY
automatic hyphenation on/off
.
.
.TP
-.BI .HY_SET
+.B .HY_SET
set automatic hyphenation parameters
.
.
@@ -520,47 +520,47 @@ exit indent right
.
.
.TP
-.BI .JUSTIFY
+.B .JUSTIFY
justify text to both margins
.
.
.TP
-.BI .KERN
+.B .KERN
automatic character pair kerning on/off
.
.
.TP
-.BI .L_MARGIN
+.B .L_MARGIN
set a left margin (page offset)
.
.
.TP
-.BI .LEFT
+.B .LEFT
set line-by-line quad left
.
.
.TP
-.BI .LL
+.B .LL
set a line length
.
.
.TP
-.BI .LS
+.B .LS
set a linespacing (leading)
.
.
.TP
-.BI .PAGE
+.B .PAGE
set explicit page dimensions and margins
.
.
.TP
-.BI .PAGEWIDTH
+.B .PAGEWIDTH
set a custom page width
.
.
.TP
-.BI .PAGELENGTH
+.B .PAGELENGTH
set a custom page length
.
.
@@ -570,47 +570,47 @@ set common paper sizes (letter, A4, etc)
.
.
.TP
-.BI .PT_SIZE
+.B .PT_SIZE
set the point size
.
.
.TP
-.BI .QUAD
+.B .QUAD
"justify" text left, centre, or right
.
.
.TP
-.BI .R_MARGIN
+.B .R_MARGIN
set a right margin
.
.
.TP
-.BI .RIGHT
+.B .RIGHT
set line-by-line quad right
.
.
.TP
-.BI .SETBOLDER
+.B .SETBOLDER
set the amount of emboldening
.
.
.TP
-.BI .SETSLANT
+.B .SETSLANT
set the degree of slant
.
.
.TP
-.BI .SPREAD
+.B .SPREAD
force justify a line
.
.
.TP
-.BI .SS
+.B .SS
set the sentence space size
.
.
.TP
-.BI .T_MARGIN
+.B .T_MARGIN
set a top margin
.
.
@@ -620,7 +620,7 @@ temporary left indent
.
.
.TP
-.BI .WS
+.B .WS
set the minimum word space size
.
.
@@ -706,7 +706,7 @@ move characters pairs closer together inline (related to
macro
.TP
.B \[rs]*[COND]
.TQ
-.BI \[rs]*[CONDX]
+.B \[rs]*[CONDX]
Pseudo-condensing on/off
.
.RS
@@ -779,7 +779,7 @@ temporarily move downwards in a line
.\" EN-MARK
.\" ======================================================================
.TP
-.BI \[rs]*[EN-MARK]
+.B \[rs]*[EN-MARK]
mark initial line of a range of line numbers (for use with line
numbered endnotes)
.
@@ -874,7 +874,7 @@ move forward in a line
.\" LEADER
.\" ======================================================================
.TP
-.BI \[rs]*[LEADER]
+.B \[rs]*[LEADER]
insert leaders at the end of a line
.
.
@@ -882,7 +882,7 @@ insert leaders at the end of a line
.\" RULE
.\" ======================================================================
.TP
-.BI \[rs]*[RULE]
+.B \[rs]*[RULE]
draw a full measure rule
.
.
@@ -1171,7 +1171,7 @@ temporarily move upwards in a line
.\" AUTOLEAD
.\" ======================================================================
.TP
-.BI .AUTOLEAD
+.B .AUTOLEAD
set the linespacing relative to the point size
.
.
@@ -2012,7 +2012,7 @@ Indent left \[em] the optional argument requires a unit
of measure
indents text from the left margin of the page, or if you're in a
.IR tab ,
from the left edge of the
-.IR tab
+.IR tab .
.
Once
.I IL
diff --git a/contrib/pdfmark/pdfroff.1.man b/contrib/pdfmark/pdfroff.1.man
index f27b59b..5cf3144 100644
--- a/contrib/pdfmark/pdfroff.1.man
+++ b/contrib/pdfmark/pdfroff.1.man
@@ -196,7 +196,7 @@ Consequently,
accepts all options and arguments, as specified in
.BR groff (@MAN1EXT@),
which may also be considered as the definitive reference for all standard
-.BR pdfroff
+.B pdfroff
options and argument usage.
.
.
@@ -260,7 +260,7 @@ See
.BR groff (@MAN1EXT@)
for a description of all other short form options, which are
transparently passed through
-.BR pdfroff
+.B pdfroff
to
.BR groff .
.
@@ -824,7 +824,7 @@ macro package, a number of supplied macro packages,
and in particular those associated with the package
.BR pdfmark.tmac ,
are best suited for use with
-.BR pdfroff
+.B pdfroff
as the preferred formatter.
.
Detailed documentation on the use of these packages may be found,
diff --git a/man/groff.7.man b/man/groff.7.man
index 69e085d..c56a448 100644
--- a/man/groff.7.man
+++ b/man/groff.7.man
@@ -1993,7 +1993,7 @@ from right margin (default scaling indicator\~\c
Mark current vertical position in
.IR register ,
or in an internal register used by
-.BR .rt
+.B .rt
if no argument.
.
.TPx
diff --git a/man/groff_diff.7.man b/man/groff_diff.7.man
index a6e15d4..8bf03a8 100644
--- a/man/groff_diff.7.man
+++ b/man/groff_diff.7.man
@@ -1491,7 +1491,7 @@ conditional operators, or in the
.BR fspecial ,
.BR fp ,
or
-.BR sty
+.B sty
requests, font\~\c
.I g
is used.
@@ -2187,7 +2187,7 @@ associated with style\~\c
and the current font family is\~\c
.BR T ,
then font
-.BR TR
+.B TR
is used.
.
If the current font is not a style, then the current family is ignored.
@@ -3235,7 +3235,7 @@ True if there is a color named
.TP
.BI .if\ c ch
True if there is a character (or glyph)
-.IR ch
+.I ch
available;
.I ch
is either an ASCII character or a glyph (special character)
@@ -3699,7 +3699,7 @@ as defining a string
with contents
.BR cd .
In
-.IR groff
+.I groff
mode, this is considered as a call of a macro named
.BR dsabcd .
.
diff --git a/man/groff_font.5.man b/man/groff_font.5.man
index cb76a22..06a8017 100644
--- a/man/groff_font.5.man
+++ b/man/groff_font.5.man
@@ -136,7 +136,7 @@ types letter, legal, tabloid, ledger, statement, executive,
com10, and
monarch.
.
Case is not significant for
-.IR string
+.I string
if it holds predefined paper types.
.
Alternatively,
@@ -185,7 +185,7 @@ Use
instead.
.
This isn't used by
-.BR troff
+.B troff
itself but by output devices.
.
.TP
diff --git a/man/groff_tmac.5.man b/man/groff_tmac.5.man
index fcf4cd1..989eb85 100644
--- a/man/groff_tmac.5.man
+++ b/man/groff_tmac.5.man
@@ -609,7 +609,7 @@ So it could be activated by the argument
to option
.BR \-m ,
or
-.BR \-man
+.B \-man
for short.
.
.
@@ -709,7 +709,7 @@ with a leading \[oq]m\[cq] for the classical packages.
There are several ways to use a macro package in a document.
.
The classical way is to specify the troff/groff option
-.BR \-m
+.B \-m
.I name
at run-time; this makes the contents of the macro package
.I name
@@ -734,7 +734,7 @@ In groff, this was improved by the similar request
.B .mso
.IR package ,
which added searching in the tmac path, just like option
-.BR \-m
+.B \-m
does.
.
.
diff --git a/man/roff.7.man b/man/roff.7.man
index 06fbd8f..d240d15 100644
--- a/man/roff.7.man
+++ b/man/roff.7.man
@@ -1217,7 +1217,7 @@ History of Unix Manpages
The history page
.UE
of the mdocml project provides an overview of
-.IR roff
+.I roff
development up to date, with links to original documentation
and comments of the original authors.
.
diff --git a/src/devices/grolbp/grolbp.1.man b/src/devices/grolbp/grolbp.1.man
index d2ed1a8..d532d6c 100644
--- a/src/devices/grolbp/grolbp.1.man
+++ b/src/devices/grolbp/grolbp.1.man
@@ -55,7 +55,7 @@ series laser printers)
] [\c
.BI \-\-fontdir= font-directory\c
] [\c
-.BI \-\-landscape\c
+.B \-\-landscape\c
] [\c
.BI \-\-linewidth= width\c
] [\c
diff --git a/src/devices/grops/grops.1.man b/src/devices/grops/grops.1.man
index 075ce5e..e7b9c48 100644
--- a/src/devices/grops/grops.1.man
+++ b/src/devices/grops/grops.1.man
@@ -159,7 +159,7 @@ previewer.
.IP
Add\~4 if
.BR %%Page ,
-.BR %%Trailer
+.B %%Trailer
and
.B %%End\%Prolog
comments should be
@@ -222,7 +222,7 @@ is the name of the device, usually
.BR ps .
.
.TP
-.BI \-g
+.B \-g
Guess the page length.
.
This generates PostScript code that guesses the page length.
@@ -510,7 +510,7 @@ The
.BR %%Include\%Resource ,
.BR %%Begin\%Resource ,
and
-.BR %%End\%Resource
+.B %%End\%Resource
comments
(or possibly the old
.BR %%Document\%Needed\%Fonts ,
@@ -518,7 +518,7 @@ comments
.BR %%Include\%Font ,
.BR %%Begin\%Font ,
and
-.BR %%End\%Font
+.B %%End\%Font
comments)
should be used.
.
@@ -1357,7 +1357,7 @@ the 35 Adobe core fonts; the difference is mainly the
lack of the
For backwards compatibility, these old fonts are installed also in the
.
.IP
-.BR @OLDFONTDIR@/devps
+.B @OLDFONTDIR@/devps
.
.LP
directory.
@@ -1447,7 +1447,7 @@ Encoding used for text fonts.
Macros for use with
.BR grops ;
automatically loaded by
-.BR troffrc
+.B troffrc
.
.TP
.B @MACRODIR@/pspic.tmac
diff --git a/src/preproc/eqn/eqn.1.man b/src/preproc/eqn/eqn.1.man
index 471309c..c0cc4d6 100644
--- a/src/preproc/eqn/eqn.1.man
+++ b/src/preproc/eqn/eqn.1.man
@@ -606,7 +606,7 @@ and the number registers
.BR 0d ,
.BR 0skern ,
and
-.BR 0skew
+.B 0skew
contain the width, height, depth, subscript kern, and skew of\~\c
.IR e .
.
@@ -1105,7 +1105,7 @@ In a macro body,
where
.I n
is between 1 and\~9, is replaced by the
-.IR n-th
+.IR n th
argument if the macro is called with arguments;
if there are fewer than
.IR n \~arguments,
@@ -1285,7 +1285,7 @@ parameters have no effect on the generated MathML.
.
.IP *
The
-.BR special,
+.BR special ,
.BR up ,
.BR down ,
.BR fwd ,
diff --git a/src/preproc/refer/refer.1.man b/src/preproc/refer/refer.1.man
index 3e92e7e..8d97daf 100644
--- a/src/preproc/refer/refer.1.man
+++ b/src/preproc/refer/refer.1.man
@@ -266,7 +266,7 @@ label\ "(A.n|Q)\ ',\ '\ (D.y|D)"; \%bracket-label\ "\ ("\
)\ ";\ "
.TP
.B \-l
.B label
-.BI A.nD.y%a
+.B A.nD.y%a
.
.
.TP
@@ -564,7 +564,7 @@ The format of a citation is
.LP
The
.IR opening-text ,
-.IR closing-text
+.IR closing-text ,
and
.I flags
components are optional.
diff --git a/src/roff/groff/groff.1.man b/src/roff/groff/groff.1.man
index 0f4c9e9..0f57c2d 100644
--- a/src/roff/groff/groff.1.man
+++ b/src/roff/groff/groff.1.man
@@ -563,7 +563,7 @@ to all subprograms.
.TP
.B \-V
Output the pipeline that would be run by
-.BR groff
+.B groff
(as a wrapper program) on the standard output, but do not execute it.
.
If given more than once,
@@ -804,7 +804,7 @@ The
.I physical
paper size, giving the actual dimensions of the paper sheets, is
controlled by output devices like
-.BR grops
+.B grops
with the command-line options
.B \-p
and
@@ -1405,11 +1405,11 @@ Historically, this prefix was the character
but it can be anything.
.
For example,
-.BR gtroff
+.B gtroff
stood for
.IR groff 's
.BR troff ,
-.BR gtbl
+.B gtbl
for the
.I groff
version of
diff --git a/src/roff/nroff/nroff.1.man b/src/roff/nroff/nroff.1.man
index 6aacd90..ebd9f32 100644
--- a/src/roff/nroff/nroff.1.man
+++ b/src/roff/nroff/nroff.1.man
@@ -164,7 +164,7 @@ ignores
.BR \-e ,
.BR \-q ,
and
-.BR \-s
+.B \-s
(which are not implemented in
.IR @address@hidden ).
.
@@ -234,7 +234,7 @@ is unset.
.\" ====================================================================
.
Character definitions in the file
-.IR @MACRODIR@/\:tty\-char.tmac
+.I @MACRODIR@/\:tty\-char.tmac
are loaded to replace unrepresentable glyphs.
.
.
diff --git a/src/utils/indxbib/indxbib.1.man b/src/utils/indxbib/indxbib.1.man
index 7c28ef1..719aca5 100644
--- a/src/utils/indxbib/indxbib.1.man
+++ b/src/utils/indxbib/indxbib.1.man
@@ -96,7 +96,7 @@ character.
The values set by the
.BR \-c ,
.BR \-n ,
-.BR \-l
+.BR \-l ,
and
.B \-t
options are stored in the index;
diff --git a/tmac/groff_man.7.man b/tmac/groff_man.7.man
index 23f6a9d..d7cb3c8 100644
--- a/tmac/groff_man.7.man
+++ b/tmac/groff_man.7.man
@@ -551,7 +551,7 @@ The descriptions of
.BR .LP ,
.BR .PP ,
and
-.BR .P
+.B .P
above were written using
.B .TP
and
diff --git a/tmac/groff_ms.7.man b/tmac/groff_ms.7.man
index cf7380c..c3c6280 100644
--- a/tmac/groff_ms.7.man
+++ b/tmac/groff_ms.7.man
@@ -1496,7 +1496,7 @@ rather than silently to ignore them.
Some Bell Labs localisms are not implemented by default.
.
However, if you call the otherwise undocumented
-.BR SC
+.B SC
section-header macro, you will enable implementations of three other
archaic Bell Labs macros:
.BR UC ,
| [Prev in Thread] |
Current Thread |
[Next in Thread] |
- [groff] 01/01: man pages: Fix misuse of two-font macros.,
G. Branden Robinson <=