At 2018-12-10T00:43:39+0100, Bertrand Garrigues wrote: > On Sun, Dec 09 2018 at 12:15:20 AM, "G. Branden Robinson" > <g.branden.robin...@gmail.com> wrote: > > At 2018-12-09T01:02:19+0100, Bertrand Garrigues wrote: > >> > I'm attaching the fix to the "POSITIONS FROM INSTALLATION" section > >> > (which I would like to rename--it's pretty awkward English), and below > >> > please find a 'git log origin..HEAD' of my other pending changes. > >> > >> I think you've attached another patch, the 'POSITIONS FROM INSTALLATION' > >> section is unchanged. > > > > Err, yes. I've got several commits queued and mixed them up. > > > > I've got the right one this time. > > hmm... the patch does not apply for me (I'm on master > 92f40b186aa2adda8039fff09c1246bdd30dbd3d).
It follows 3 of the other patches I have pending. I attached it simply for review purposes, not an intended application. If you want to do that I'd probably just better send everything that's pending. > Also, as 'POSITION FROM INSTALLATION' sounds like bad English for you, > why not fix it right away? Because you just asked me to hold off until 1.22.4 is finished? If I misunderstood and you'd like me to push the attached commits, and fix that section heading to boot, I'm happy to. I'm attaching everything that I have ready to go. Regards, Branden
commit e182b251588cb4eea381d299af21dc882b8bc184
Author: G. Branden Robinson <g.branden.robin...@gmail.com>
Date: Sun Dec 9 17:58:41 2018 -0500
troff(1): Fix bad grammar.
Signed-off-by: G. Branden Robinson <g.branden.robin...@gmail.com>
diff --git a/src/roff/troff/troff.1.man b/src/roff/troff/troff.1.man
index 353957db..32859fae 100644
--- a/src/roff/troff/troff.1.man
+++ b/src/roff/troff/troff.1.man
@@ -585,8 +585,8 @@ Note that
.I troffrc
and
.I troffrc\-end
-are neither searched in the current nor in the home directory by
-default for security reasons (even if the
+searched for neither in the current nor the home directory by default
+for security reasons (even if the
.B \-U
option is given).
.
@@ -601,6 +601,7 @@ necessary.
.\" ====================================================================
.SH AUTHORS
.\" ====================================================================
+.
The GNU version of
.I troff
was originally written by James Clark;
commit 81545ca171a4cf3d20280b723bf975f12776f76b
Author: G. Branden Robinson <g.branden.robin...@gmail.com>
Date: Fri Dec 7 12:24:46 2018 -0500
groff(1): Update "Availability" section.
* Note read-only status of bug-groff list.
* Make the prose read well with or without explicit URLs.
* Update location of groff-commit list (gnu.org, not ffii.org).
* Tighten wording.
Signed-off-by: G. Branden Robinson <g.branden.robin...@gmail.com>
diff --git a/src/roff/groff/groff.1.man b/src/roff/groff/groff.1.man
index 4217776e..99a19852 100644
--- a/src/roff/groff/groff.1.man
+++ b/src/roff/groff/groff.1.man
@@ -1822,28 +1822,37 @@ Information on how to get
.I groff
and related information is available at the
.UR http://\:www.gnu.org/\:software/\:groff
-groff GNU website
+groff page of the GNU website
.UE .
.
+.
.P
Three
.I groff
mailing lists are available:
+.
+.
.IP
.MT bug\-groff@\:gnu.org
-for reporting bugs
-.ME .
+bug tracker activity (read-only)
+.ME ;
+.
.
.IP
.MT groff@\:gnu.org
-for general discussion of
-.IR groff ,
-.ME .
+general discussion
+.ME ;
+and
+.
+.
.IP
-.MT groff\-commit@\:ffii.org
-the groff commit list
+.MT groff\-commit@\:gnu.org
+commit activity (read-only)
.ME ,
-a read-only list showing logs of commitments to the groff repository.
+which reports changes to
+.IR groff 's
+source code repository by its developers.
+.
.
.P
Details on repository access and much more can be found in the file
@@ -1854,25 +1863,27 @@ source package.
.
.
.P
-There is a free implementation of the
+A free implementation of the
.B grap
preprocessor, written by
.MT faber@\:lunabase.org
Ted Faber
-.ME .
-.
-The actual version can be found at the
-.
+.ME ,
+and can be found at the
.UR http://\:www.lunabase.org/\:\|\[ti]faber/\:Vault/\:software/\:grap/
grap website
.UE .
-This is the only grap version supported by
+.
+This is the only
+.I grap
+supported by
.IR groff .
.
.
.\" ====================================================================
.SH AUTHORS
.\" ====================================================================
+.
.B groff
was written by
.MT jjc@\:jclark.com
commit c943f4c43e3e44c263d71c41ce164f71a086d58b
Author: G. Branden Robinson <g.branden.robin...@gmail.com>
Date: Fri Dec 7 12:03:01 2018 -0500
groff(1): Recast installation directory material.
Kill off outdated reference to Makefile.comm.
Resync list with the variables in Makefile.am that we makevarescape.
The list is now collated by the order of the Makefile variable
expansions, which is pretty feeble (and totally opaque to the reader),
but there doesn't seem to be a better sort order given that the items
are under the control of the person running the configure script.
Signed-off-by: G. Branden Robinson <g.branden.robin...@gmail.com>
diff --git a/src/roff/groff/groff.1.man b/src/roff/groff/groff.1.man
index 92e847b9..4217776e 100644
--- a/src/roff/groff/groff.1.man
+++ b/src/roff/groff/groff.1.man
@@ -1630,76 +1630,107 @@ is not available on \f[CR]ASCII\f[] based operating systems.
.SH "POSITIONS FROM INSTALLATION"
.\" ====================================================================
.
-There are some directories in which
.I groff
-installs all of its data files.
+installs files in varying locations depending on its compile-time
+configuration.
.
-Due to different installation habits on different operating systems,
-their locations are not absolutely fixed, but their function is
-clearly defined and coincides on all systems.
+On this installation, the following locations are used.
.
.
-.\" ====================================================================
-.SS "Collection of Installation Directories"
-.\" ====================================================================
-.
-This section describes the position of all files of the
-.I groff
-package after the installation \[em] got from
-.I Makefile.comm
-at the top of the
-.I groff
-source package.
+.TP
+.I @APPRESDIR@
+Application defaults directory for
+.IR gxditview (@MAN1EXT@).
.
.
.TP
-.I @DEFAULT_INDEX@
-index directory and index name
+.I @BINDIR@
+Directory containing
+.IR groff 's
+executable commands.
+.
+.
.TP
-.I @LEGACYFONTDIR@
-legacy font directory
+.I @COMMON_WORDS_FILE@
+List of common words for
+.IR indxbib (@MAN1EXT@).
+.
+.
.TP
-.I @BINDIR@
-directory for binary programs
+.I @DATASUBDIR@
+Directory for data files.
+.
+.
.TP
-.I @SYSTEMMACRODIR@
-system tmac directory
+.I @DEFAULT_INDEX@
+Default index for
+.IR lkbib (@MAN1EXT@)
+and
+.IR refer (@MAN1EXT@).
+.
+.
.TP
.I @DOCDIR@
-documentation directory
+Documentation directory.
+.
+.
.TP
.I @EXAMPLEDIR@
-directory for examples
-.TP
-.I @HTMLDOCDIR@
-documentation directory for HTML files
+Example directory.
+.
+.
.TP
-.I @PDFDOCDIR@
-documentation directory for PDF files
+.I @FONTDIR@
+Font directory.
+.
+.
.TP
-.I @DATASUBDIR@
-data subdirectory
+.I @HTMLDOCDIR@
+HTML documentation directory.
+.
+.
.TP
-.I @COMMON_WORDS_FILE@
-file for common words
+.I @LEGACYFONTDIR@
+Legacy font directory.
+.
+.
.TP
-.I @FONTDIR@
-directory for fonts
+.I @LOCALFONTDIR@
+Local font directory.
+.
+.
.TP
-.I @OLDFONTDIR@
-directory for old fonts
+.I @LOCALMACRODIR@
+Local macro package
+.RI ( tmac
+file) directory.
+.
+.
.TP
.I @MACRODIR@
-tmac directory
+Macro package
+.RI ( tmac
+file) directory.
+.
+.
.TP
-.I @TMAC_MDIR@
-mm tmac directory
+.I @OLDFONTDIR@
+Font directory for compatibility with old versions of
+.IR groff ;
+see
+.IR grops (@MAN1EXT@).
+.
+.
.TP
-.I @LOCALFONTDIR@
-local font directory
+.I @PDFDOCDIR@
+PDF documentation directory.
+.
+.
.TP
-.I @LOCALMACRODIR@
-local tmac directory
+.I @SYSTEMMACRODIR@
+System macro package
+.RI ( tmac
+file) directory.
.
.
.\" ====================================================================
commit 01cd80b9f98f0ef0b94016b2a9825cabf0655424
Author: G. Branden Robinson <g.branden.robin...@gmail.com>
Date: Fri Dec 7 12:02:14 2018 -0500
groff(1): DESC files describe devices, not fonts.
Signed-off-by: G. Branden Robinson <g.branden.robin...@gmail.com>
diff --git a/src/roff/groff/groff.1.man b/src/roff/groff/groff.1.man
index ea7e8859..92e847b9 100644
--- a/src/roff/groff/groff.1.man
+++ b/src/roff/groff/groff.1.man
@@ -690,7 +690,7 @@ Set default font family.
.
.TP
.BI \-F\ dir
-Set path for font
+Set path for device
.I DESC
files.
.
commit 3c691361cab524a6e303552714e6aa46c05a5fc2
Author: G. Branden Robinson <g.branden.robin...@gmail.com>
Date: Fri Dec 7 11:31:19 2018 -0500
man pages: Hyphenate phrasal adjectives.
...when they precede nouns.
Signed-off-by: G. Branden Robinson <g.branden.robin...@gmail.com>
diff --git a/man/groff.7.man b/man/groff.7.man
index a30755bc..24f093fe 100644
--- a/man/groff.7.man
+++ b/man/groff.7.man
@@ -2716,7 +2716,7 @@ but there is no two-character analogue.
.
.P
While one-character escape sequences are mainly used for in-line
-functions and system related tasks, the two-letter names following the
+functions and system-related tasks, the two-letter names following the
.esc (
construct are glyphs predefined by the roff system; these are called
\[oq]Special Characters\[cq] in the classical documentation.
diff --git a/src/roff/troff/troff.1.man b/src/roff/troff/troff.1.man
index 2ae0ead2..353957db 100644
--- a/src/roff/troff/troff.1.man
+++ b/src/roff/troff/troff.1.man
@@ -365,7 +365,7 @@ This is enabled by default.
.
.TP
.BR color "\t524288"
-Color related warnings.
+Color-related warnings.
.
.TP
.BR delim "\t8"
commit 5c9c43b594c7948f392992315bf3407afb9f4f82
Author: G. Branden Robinson <g.branden.robin...@gmail.com>
Date: Fri Dec 7 11:26:28 2018 -0500
man pages: Escape hyphens in filenames.
Signed-off-by: G. Branden Robinson <g.branden.robin...@gmail.com>
diff --git a/man/groff_tmac.5.man b/man/groff_tmac.5.man
index d70ed3db..750fd505 100644
--- a/man/groff_tmac.5.man
+++ b/man/groff_tmac.5.man
@@ -562,7 +562,7 @@ See
.
.
.TP
-.I tty-char
+.I tty\-char
Overrides the definition of standard troff characters and some groff
characters for TTY devices.
.
diff --git a/src/roff/troff/troff.1.man b/src/roff/troff/troff.1.man
index 72f74be9..2ae0ead2 100644
--- a/src/roff/troff/troff.1.man
+++ b/src/roff/troff/troff.1.man
@@ -245,7 +245,7 @@ can be any troff numeric expression.
Don't load
.I troffrc
and
-.IR troffrc-end .
+.IR troffrc\-end .
.
.TP
.BI \-T name
commit 5886afe4f0b419a9646edeecf132aab91fc23d5d
Author: G. Branden Robinson <g.branden.robin...@gmail.com>
Date: Fri Dec 7 11:17:00 2018 -0500
groff_me(7): Prefix .TH release info with "groff".
...as all the other man pages do (well, except groff_mdoc(7)).
Signed-off-by: G. Branden Robinson <g.branden.robin...@gmail.com>
diff --git a/tmac/groff_me.7.man b/tmac/groff_me.7.man
index 19fa3484..ab3f4aea 100644
--- a/tmac/groff_me.7.man
+++ b/tmac/groff_me.7.man
@@ -1,5 +1,5 @@
'\" t
-.TH GROFF_ME @MAN7EXT@ "@MDATE@" "@VERSION@"
+.TH GROFF_ME @MAN7EXT@ "@MDATE@" "groff @VERSION@"
.SH NAME
groff_me \- \(lqme\(rq macro package for formatting documents with GNU \
roff
commit 962596565c4ca18b52de77d62df8cebbc2deecd3
Author: G. Branden Robinson <g.branden.robin...@gmail.com>
Date: Sat Dec 1 02:18:32 2018 -0500
man pages: Set filespecs in italics, not bold.
contrib/pdfmark/pdfroff.1.man:
man/groff.7.man:
man/groff_diff.7.man:
man/groff_font.5.man:
man/groff_out.5.man:
man/groff_tmac.5.man:
src/devices/grodvi/grodvi.1.man:
src/devices/grolbp/grolbp.1.man:
src/devices/grolj4/grolj4.1.man:
src/devices/gropdf/gropdf.1.man:
src/devices/grops/grops.1.man:
src/devices/grotty/grotty.1.man:
src/devices/xditview/gxditview.1.man:
src/preproc/eqn/eqn.1.man:
src/preproc/grn/grn.1.man:
src/preproc/pic/pic.1.man:
src/preproc/refer/refer.1.man:
src/roff/groff/groff.1.man:
src/roff/troff/troff.1.man:
src/utils/indxbib/indxbib.1.man:
src/utils/tfmtodit/tfmtodit.1.man:
tmac/groff_ms.7.man:
tmac/groff_www.7.man:
+ As above.
contrib/pdfmark/pdfroff.1.man:
man/groff_font.5.man:
man/groff_out.5.man:
man/groff_tmac.5.man:
src/devices/grodvi/grodvi.1.man:
src/devices/grohtml/grohtml.1.man:
src/devices/grolbp/grolbp.1.man:
src/devices/grolj4/grolj4.1.man:
src/devices/gropdf/gropdf.1.man:
src/devices/grops/grops.1.man:
src/devices/grotty/grotty.1.man:
src/devices/xditview/gxditview.1.man:
src/preproc/grn/grn.1.man:
src/preproc/refer/refer.1.man:
src/roff/groff/groff.1.man:
src/roff/troff/troff.1.man:
src/utils/indxbib/indxbib.1.man:
src/utils/tfmtodit/tfmtodit.1.man:
+ Set variable parts of filespecs in roman in filespec context but in
italics when isolated in running prose; see groff_man(7).
contrib/pdfmark/pdfroff.1.man:
+ Set shell variable expansions within filespecs in roman.
+ Stop suppressing hyphenation before macro-expanded filespecs. Since
commit ea32b7d0462813fc3e7c423efb6d805273df9edd, we get free
discretionary breaks after slashes in macro-expanded filespec
components anyway. So with any luck, even in the unlikely case a
filespec paragraph tag has to be broken, it won't be done in an
eye-watering place using a hyphen.
man/groff_out.5.man:
+ Remove pseudo-prefix from src/libs/libdriver/input.cpp. The
subsequent paragraph already describes it as being relative to the top
of the groff source tree. I think this is an abuse of the Files
section (and this is section 5--files don't open files), but doing
something about that is out of scope for this changeset.
man/groff_tmac.5.man:
+ Use font macros rather than font escapes; also eliminates use of
italic-correction escapes.
src/devices/gropdf/gropdf.1.man:
src/devices/grops/grops.1.man:
+ Don't quote filespecs on top of or instead of italicizing them.
src/devices/grotty/grotty.1.man:
+ Delete word "kludgy" from the description of the alternate character
definitions in tty-char.tmac; Ingo Schwarze has spent some effort
improving them.
Signed-off-by: G. Branden Robinson <g.branden.robin...@gmail.com>
diff --git a/contrib/pdfmark/pdfroff.1.man b/contrib/pdfmark/pdfroff.1.man
index b5fc5aa5..1f4587f1 100644
--- a/contrib/pdfmark/pdfroff.1.man
+++ b/contrib/pdfmark/pdfroff.1.man
@@ -140,7 +140,7 @@ macro package, should the user choose to employ it.
Specifically, if the
.I pdfhref
macro, defined in the
-.B pdfmark.tmac
+.I pdfmark.tmac
package, is used to define public reference marks, or dynamic links to
such reference marks, then
.B pdfroff
@@ -649,14 +649,13 @@ Input and output files for
may be named according to any convention of the user's choice.
Typically, input files may be named according to the choice of the
principal formatting macro package, e.g.,
-.IB file .ms
+.RI file .ms
might be an input file for formatting using the
.B ms
macros
-.RB ( s.tmac );
+.RI ( s.tmac );
normally, the final output file should be named
-.IB file .pdf\c
-\&.
+.RI file .pdf .
.
.
.P
@@ -672,7 +671,7 @@ is available,
it is invoked to create a private subdirectory of
the nominated temporary files directory,
(with subdirectory name derived from the template
-.BR pdfroff-XXXXXXXXXX );
+.IR pdfroff-XXXXXXXXXX );
if this subdirectory is successfully created,
the temporary files will be placed within it,
otherwise they will be placed directly in the directory
@@ -680,8 +679,8 @@ nominated in the environment.
.P
All temporary files themselves
are named according to the convention
-.BI pdf $$ .*\c
-\&, where
+.IR pdf $$ . *,
+where
.I $$
is the standard shell variable representing the process ID of the
.B pdfroff
@@ -692,7 +691,7 @@ represents any of the extensions used by
to identify the following temporary and intermediate files.
.
.TP
-.BI pdf $$ .tmp
+.IR pdf $$ .tmp
A scratch pad file,
used to capture reference data emitted by
.BR groff ,
@@ -701,7 +700,7 @@ during the
compilation phase.
.
.TP
-.BI pdf $$ .ref
+.IR pdf $$ .ref
The
.IR "reference dictionary" ,
as compiled in the last but one pass of the
@@ -724,11 +723,10 @@ this intermediate file becomes permanent,
and is named
.IR name ,
rather than
-.BI pdf $$ .ref\c
-\&.
+.IR pdf $$ .ref .
.
.TP
-.BI pdf $$ .cmp
+.IR pdf $$ .cmp
Used to collect
.I reference dictionary
entries during the active pass of the
@@ -737,10 +735,9 @@ compilation phase.
.
At the end of any pass,
when the content of
-.BI pdf $$ .cmp
+.IR pdf $$ .cmp
compares as identical to
-.BI pdf $$ .ref\c
-\&,
+.IR pdf $$ .ref ,
(or the corresponding file named by the
.BR \%\-\-reference\-dictionary =\c
.I name
@@ -754,7 +751,7 @@ is appended to this intermediate file,
for inclusion in the final formatting passes.
.
.TP
-.BI pdf $$ .tc
+.IR pdf $$ .tc
An intermediate
.I PostScript
file,
@@ -765,7 +762,7 @@ on ultimate output to the
postprocessor.
.
.TP
-.BI pdf $$ .ps
+.IR pdf $$ .ps
An intermediate
.I PostScript
file,
@@ -774,8 +771,7 @@ in which the body text is collected prior to ultimate output to the
postprocessor,
in the proper sequence,
.I after
-.BI pdf $$ .tc\c
-\&.
+.IR pdf $$ .tc .
.
.
.\" ====================================================================
@@ -820,7 +816,7 @@ the use of any specific
.B groff
macro package, a number of supplied macro packages,
and in particular those associated with the package
-.BR pdfmark.tmac ,
+.IR pdfmark.tmac ,
are best suited for use with
.B pdfroff
as the preferred formatter.
@@ -829,7 +825,7 @@ Detailed documentation on the use of these packages may be found,
in PDF format, in the reference guide
.BR "\*(lqPortable Document Format Publishing with GNU Troff\*(rq" ,
included in the installed documentation set as
-.BR \%@PDFDOCDIR@/pdfmark.pdf .
+.IR @PDFDOCDIR@/pdfmark.pdf .
.
.
.\" Restore compatibility mode (for, e.g., Solaris 10/11).
diff --git a/man/groff.7.man b/man/groff.7.man
index c21b1a21..a30755bc 100644
--- a/man/groff.7.man
+++ b/man/groff.7.man
@@ -2326,7 +2326,7 @@ positions.
Set available font sizes similar to the
.B sizes
command in a
-.B DESC
+.I DESC
file.
.
.TPx
diff --git a/man/groff_diff.7.man b/man/groff_diff.7.man
index 5d93684f..39d17475 100644
--- a/man/groff_diff.7.man
+++ b/man/groff_diff.7.man
@@ -165,7 +165,7 @@ is equal to
points, where
.B sizescale
is specified in the
-.B DESC
+.I DESC
file (1 by default).
.
There is a new scale indicator\~\c
@@ -2107,7 +2107,7 @@ Shifting by negative amounts is currently undefined.
This command is similar to the
.B sizes
command of a
-.B DESC
+.I DESC
file.
.
It sets the available font sizes for the current font to
diff --git a/man/groff_font.5.man b/man/groff_font.5.man
index 06a8017b..cb3bbf00 100644
--- a/man/groff_font.5.man
+++ b/man/groff_font.5.man
@@ -37,15 +37,14 @@ font format.
The font files for device
.I name
are stored in a directory
-.BI dev name\/\c
-\&.
+.IR dev name.
.
-There are two types of file: a device description file called
-.B DESC
-and for each font\~\c
-.I F
-a font file called\~\c
-.IR F .
+There are two types of file:
+a device description file called
+.I DESC
+and for each
+.RI font \~F ,
+a font file called\~F.
.
These are text files;
unlike the ditroff font format,
@@ -56,7 +55,9 @@ there is no associated binary format.
.SS DESC file format
.\" ====================================================================
.
-The DESC file can contain the following types of line as shown below.
+The
+.I DESC
+file can contain the following types of line as shown below.
.
Later entries in the file override previous values.
.
@@ -141,8 +142,9 @@ if it holds predefined paper types.
.
Alternatively,
.I string
-can be a file name (e.g.\& \[oq]/etc/papersize\[cq]); if the file can
-be opened,
+can be a file name (e.g.\&
+.IR /etc/papersize );
+if the file can be opened,
.B groff
reads the first line and tests for the above paper sizes.
.
@@ -346,7 +348,9 @@ and
.B sizes
lines are compulsory.
.
-Not all commands in the DESC file are used by
+Not all commands in the
+.I DESC
+file are used by
.B troff
itself; some of the keywords (or even additional ones) are used by
postprocessors to store arbitrary information about the device.
@@ -663,12 +667,12 @@ Most entries in kernpairs section have a negative value for\~\c
.\" ====================================================================
.
.TP
-.BI @FONTDIR@/dev name /DESC
+.IR @FONTDIR@/dev name /DESC
Device description file for device
.IR name .
.
.TP
-.BI @FONTDIR@/dev name / F
+.IR @FONTDIR@/dev name / F
Font file for font\~\c
.I F
of device
diff --git a/man/groff_out.5.man b/man/groff_out.5.man
index 4f0efaf9..6f1bd18c 100644
--- a/man/groff_out.5.man
+++ b/man/groff_out.5.man
@@ -1824,12 +1824,12 @@ are documented in
.\" ====================================================================
.
.TP
-.BI @FONTDIR@/dev name /DESC
+.IR @FONTDIR@/dev name /DESC
Device description file for device
.IR name .
.
.TP
-.IB \[la]groff-source-dir\[ra] /src/libs/libdriver/input.cpp
+.I src/libs/libdriver/input.cpp
Defines the parser and postprocessor for the
.I intermediate
.IR output .
@@ -1904,7 +1904,7 @@ language such as numerical units and escape sequences.
.TP
.BR groff_font (@MAN5EXT@)
for details on the device scaling parameters of the
-.B DESC
+.I DESC
file.
.
.
diff --git a/man/groff_tmac.5.man b/man/groff_tmac.5.man
index 29b25b6f..d70ed3db 100644
--- a/man/groff_tmac.5.man
+++ b/man/groff_tmac.5.man
@@ -96,7 +96,7 @@ or the
.B man
macro package.
See below the description of the
-.B andoc.tmac
+.I andoc.tmac
file.
.
.
@@ -105,16 +105,16 @@ file.
.\" ====================================================================
.
.TP
-.B man
+.I man
This is the classical macro package for Unix manual pages
(man\~pages); it is quite handy and easy to use; see
.BR groff_man (@MAN7EXT@).
.
.
.TP
-.B doc
+.I doc
.TQ
-.B mdoc
+.I mdoc
An alternative macro package for man\~pages mainly used in BSD
systems; it provides many new features, but it is not the standard for
man\~pages; see
@@ -122,9 +122,9 @@ man\~pages; see
.
.
.TP
-.B andoc
+.I andoc
.TQ
-.B mandoc
+.I mandoc
Use this file in case you don't know whether the
.B man
macros or the
@@ -145,7 +145,7 @@ to use.
.
.
.TP
-.B me
+.I me
The classical
.I me
macro package; see
@@ -153,7 +153,7 @@ macro package; see
.
.
.TP
-.B mm
+.I mm
The semi-classical
.I mm
macro package; see
@@ -161,7 +161,7 @@ macro package; see
.
.
.TP
-.B mom
+.I mom
The new
.I mom
macro package, only available in groff.
@@ -175,7 +175,7 @@ See
.
.
.TP
-.B ms
+.I ms
The classical
.I ms
macro package; see
@@ -187,27 +187,27 @@ macro package; see
.\" ====================================================================
.
.TP
-.B cs
+.I cs
This file adds support for Czech localization, including the main macro
packages (me, mom, mm, and ms).
.
.IP
Note that
-.B cs.tmac
+.I cs.tmac
sets the input encoding to latin-2.
.
.
.TP
-.B de
+.I de
.TQ
-.B den
+.I den
German localization support, including the main macro packages (me, mom,
mm, and ms).
.
.IP
-.B de.tmac
+.I de.tmac
selects hyphenation patterns for traditional orthography, and
-.B den.tmac
+.I den.tmac
does the same for the new orthography
(\[oq]Recht\%schreib\%reform\[cq]).
.
@@ -215,7 +215,7 @@ It should be used as the last macro package on the command line.
.
.
.TP
-.B fr
+.I fr
This file adds support for French localization, including the main macro
packages (me, mom, mm, and ms).
.
@@ -230,13 +230,13 @@ Example:
.
.IP
Note that
-.B fr.tmac
+.I fr.tmac
sets the input encoding to latin-9 to get proper support of the
\[oq]oe\[cq] ligature.
.
.
.TP
-.B sv
+.I sv
Swedish localization support, including the me, mom, and ms macro
packages.
.
@@ -252,13 +252,13 @@ It should be used as the last macro package on the command line.
.
.
.TP
-.B latin1
+.I latin1
.TQ
-.B latin2
+.I latin2
.TQ
-.B latin5
+.I latin5
.TQ
-.B latin9
+.I latin9
Various input encodings supported directly by groff.
.
Normally, this macro is loaded at the very beginning of a document or
@@ -271,7 +271,7 @@ Note that these macro packages don't work on EBCDIC hosts.
.
.
.TP
-.B cp1047
+.I cp1047
Encoding support for EBCDIC.
.
On those platforms it is loaded automatically at start-up.
@@ -313,13 +313,13 @@ macro package or to plain groff.
.
.
.TP
-.B 62bit
+.I 62bit
Provides macros for addition, multiplication, and division of 62-bit
integers (allowing safe multiplication of 31-bit integers, for example).
.
.
.TP
-.B ec
+.I ec
Switch to the EC and TC font families.
.
To be used with
@@ -328,17 +328,17 @@ To be used with
.
.
.TP
-.B hdtbl
+.I hdtbl
The Heidelberger table macros, contributed by Joachim Walsdorff, allow
the generation of tables through a syntax similar to the HTML table
model.
.
Note that
-.B hdtbl
+.I hdtbl
is a macro package, not a preprocessor like
.BR tbl (@MAN1EXT@).
.
-.B hdtbl
+.I hdtbl
works only with the
.B \-Tps
and
@@ -350,7 +350,7 @@ See
.
.
.TP
-.B papersize
+.I papersize
This macro file is already loaded at start-up by
.B @g@troff
so it isn't necessary to call it explicitly.
@@ -394,20 +394,20 @@ orientation:
.
.
.TP
-.B pdfpic
+.I pdfpic
A single macro is provided in this file,
.BR PSPIC ,
to include a PDF graphic in a document, i.e., under the output device
.BR \-Tpdf .
.
For all other devices,
-.B pspic
+.I pspic
is used.
.
So
-.B pdfpic
+.I pdfpic
is an extension of
-.B pspic.
+.IR pspic .
.
By that you can now even replace all
.B PSPIC
@@ -423,7 +423,7 @@ options.
.
.
.TP
-.B pic
+.I pic
This file provides proper definitions for the macros
.B PS
and
@@ -439,7 +439,7 @@ definitions for those two macros (actually, most of them already do).
.
.
.TP
-.B pspic
+.I pspic
A single macro is provided in this file,
.BR PSPIC ,
to include a PostScript graphic in a document.
@@ -540,7 +540,7 @@ image's width.
.
.
.TP
-.B ptx
+.I ptx
A single macro is provided in this file,
.BR xx ,
for formatting permuted index entries as produced by the GNU
@@ -552,7 +552,7 @@ your document and adapt it to your needs.
.
.
.TP
-.B trace
+.I trace
Use this for tracing macro calls.
.
It is only useful for debugging.
@@ -562,7 +562,7 @@ See
.
.
.TP
-.B tty-char
+.I tty-char
Overrides the definition of standard troff characters and some groff
characters for TTY devices.
.
@@ -571,7 +571,7 @@ normal TTY formatting to allow processing with critical equipment.
.
.
.TP
-.B www
+.I www
Additions of elements known from the HTML format, as used in the
internet (World Wide Web) pages; this includes URL links and mail
addresses; see
@@ -672,7 +672,8 @@ would not make much sense.
.
.P
A second strange feature of classical troff was to name macro files
-in the form \f[B]tmac.\f[]\,\f[I]name\f[].
+in the form
+.IR tmac. name.
In modern operating systems, the type of a file is specified as a
postfix, the file name extension.
.
@@ -716,9 +717,9 @@ at run-time; this makes the contents of the macro package
available.
.
In groff, the file
-.IB name .tmac
+.RI name .tmac
is searched within the tmac path; if not found,
-.BI tmac. name
+.IR tmac. name
is searched for instead.
.
.
@@ -805,7 +806,7 @@ to invoke
.
.P
If you want to write your own groff macro file, call it
-.IB whatever .tmac
+.RI whatever .tmac
and put it in a directory in the tmac path;
see section \[lq]Files\[rq] below.
.
@@ -1176,10 +1177,10 @@ the diversion and can be manipulated from within the macros.
.\" ====================================================================
.
All macro package files must be named
-.IB name .tmac
+.RI name .tmac
to fully use the tmac mechanism.
.
-.BI tmac. name
+.IR tmac. name
as with classical packages is possible as well, but deprecated.
.
.
@@ -1216,7 +1217,7 @@ a platform-specific directory, being
.
.RS
.IP
-.B @SYSTEMMACRODIR@
+.I @SYSTEMMACRODIR@
.RE
.
.IP
@@ -1227,7 +1228,7 @@ a site-specific (platform-independent) directory, being
.
.RS
.IP
-.B @LOCALMACRODIR@
+.I @LOCALMACRODIR@
.RE
.
.IP
@@ -1238,7 +1239,7 @@ the main tmac directory, being
.
.RS
.IP
-.B @MACRODIR@
+.I @MACRODIR@
.RE
.
.IP
diff --git a/src/devices/grodvi/grodvi.1.man b/src/devices/grodvi/grodvi.1.man
index 4c07ce23..843a1f90 100644
--- a/src/devices/grodvi/grodvi.1.man
+++ b/src/devices/grodvi/grodvi.1.man
@@ -77,7 +77,7 @@ Normally it should be run by
This will run
.BR @g@troff\ \-Tdvi ;
it will also input the macros in
-.BR @MACRODIR@/\:dvi.tmac .
+.IR @MACRODIR@/\:dvi.tmac .
.
.LP
The DVI file generated by
@@ -122,7 +122,7 @@ may not contain a newline.
For inclusion of EPS image files,
.B \-Tdvi
loads
-.B pspic.tmac
+.I pspic.tmac
automatically, providing the
.B PSPIC
macro.
@@ -143,7 +143,7 @@ additional commands:
.TP
.BI internalname\ name
The name of the tfm file (without the
-.B .tfm
+.I .tfm
extension) is
.IR name .
.
@@ -215,7 +215,7 @@ Other drawing commands will be ignored.
.TP
.BI \-F dir
Prepend directory
-.IB dir /dev name
+.RI dir /dev name
to the search path for font and device description files;
.I name
is the name of the device, usually
@@ -235,7 +235,7 @@ This overrides the
and
.B paperwidth
commands in the
-.B DESC
+.I DESC
file; it accepts the same arguments as the
.B papersize
command (see
@@ -377,14 +377,14 @@ These two fonts are not mounted by default.
Using the option
.B \-mec
(which loads the file
-.BR ec.tmac )
+.IR ec.tmac )
provides the EC and TC fonts.
.
The design of the EC family is very similar to that of the CM fonts;
additionally, they give a much better coverage of groff symbols.
.
Note that
-.B ec.tmac
+.I ec.tmac
must be called before any language-specific files; it doesn't take
care of hcode values.
.
@@ -396,7 +396,7 @@ care of hcode values.
.TP
.I GROFF_FONT_PATH
A list of directories in which to search for the
-.BI dev name
+.IR dev name
directory in addition to the default ones.
.
See
@@ -411,21 +411,21 @@ for more details.
.\" ====================================================================
.
.TP
-.B @FONTDIR@/devdvi/DESC
+.I @FONTDIR@/devdvi/DESC
Device description file.
.
.TP
-.BI @FONTDIR@/devdvi/ F
+.IR @FONTDIR@/devdvi/ F
Font description file for font
.IR F .
.
.TP
-.B @MACRODIR@/dvi.tmac
+.I @MACRODIR@/dvi.tmac
Macros for use with
.BR grodvi .
.
.TP
-.B @MACRODIR@/ec.tmac
+.I @MACRODIR@/ec.tmac
Macros to switch to EC fonts.
.
.
diff --git a/src/devices/grohtml/grohtml.1.man b/src/devices/grohtml/grohtml.1.man
index 15828f29..a54ae989 100644
--- a/src/devices/grohtml/grohtml.1.man
+++ b/src/devices/grohtml/grohtml.1.man
@@ -182,7 +182,7 @@ is specified).
.TP
.BI \-F dir
Prepend directory
-.IB dir /dev name
+.RI dir /dev name
to the search path for font and device description files;
.I name
is the name of the device, usually
@@ -401,7 +401,7 @@ man page for details where such files are created.
.TP
.I GROFF_FONT_PATH
A list of directories in which to search for the
-.BI dev name
+.IR dev name
directory in addition to the default ones.
.
See
diff --git a/src/devices/grolbp/grolbp.1.man b/src/devices/grolbp/grolbp.1.man
index 684f6ccb..bdd1c0f3 100644
--- a/src/devices/grolbp/grolbp.1.man
+++ b/src/devices/grolbp/grolbp.1.man
@@ -130,7 +130,7 @@ copies of each page.
.TQ
.BI \-\-fontdir= font-directory
Prepend directory
-.IB font-directory /dev name
+.RI font-directory /dev name
to the search path for font and device description files;
.I name
is the name of the device, usually
@@ -225,12 +225,12 @@ Elite | ER | EB | EI |
.\" ====================================================================
.
The paper size can be set in the
-.B DESC
+.I DESC
file or with command-line options to
.BR grolbp .
If the paper size is specified both ways, the command-line options take
precedence over the contents of the
-.B DESC
+.I DESC
file (this applies to the page orientation too).
.
.
@@ -238,7 +238,7 @@ file (this applies to the page orientation too).
See
.BR groff_font (@MAN5EXT@)
how to set the paper dimensions in the
-.B DESC
+.I DESC
file.
.
.
@@ -260,13 +260,13 @@ to the other
options, where
.I paper-size
is in the same format as in the
-.B DESC
+.I DESC
file.
.
.
.PP
If no paper size is specified in the
-.B DESC
+.I DESC
file or the command line, a default size of A4 is used.
.
.
@@ -279,7 +279,7 @@ As with the page size, the orientation of the printed page
or
.BR landscape )
can be set in the
-.B DESC
+.I DESC
file or with command-line options.
.
It is also case insensitive.
@@ -287,7 +287,7 @@ It is also case insensitive.
.
.PP
To set the orientation in the
-.B DESC
+.I DESC
file, insert a line with the following content:
.sp 1
.in +2m
@@ -297,7 +297,7 @@ file, insert a line with the following content:
.sp 1
.
Only the first valid orientation command in the
-.B DESC
+.I DESC
file is used.
.
.
@@ -311,7 +311,7 @@ option with the same parameters
or
.BR landscape )
as in the
-.B DESC
+.I DESC
file.
Or you can use the
.B \-l
@@ -405,7 +405,7 @@ is case sensitive.
.TP
.I GROFF_FONT_PATH
A list of directories in which to search for the
-.BI dev name
+.IR dev name
directory in addition to the default ones.
.
See
@@ -420,16 +420,16 @@ for more details.
.\" ====================================================================
.
.TP
-.B @FONTDIR@/devlbp/DESC
+.I @FONTDIR@/devlbp/DESC
Device description file.
.
.TP
-.BI @FONTDIR@/devlbp/ F
+.IR @FONTDIR@/devlbp/ F
Font description file for font
.IR F .
.
.TP
-.B @MACRODIR@/lbp.tmac
+.I @MACRODIR@/lbp.tmac
Macros for use with
.BR grolbp .
.
diff --git a/src/devices/grolj4/grolj4.1.man b/src/devices/grolj4/grolj4.1.man
index 87fcbea4..079f9c06 100644
--- a/src/devices/grolj4/grolj4.1.man
+++ b/src/devices/grolj4/grolj4.1.man
@@ -136,7 +136,7 @@ If this option isn't specified, the line thickness defaults to
.TP
.BI \-F " font-directory"
Prepend directory
-.IB font-directory /dev name
+.IR font-directory /dev name
to the search path for font and device description files;
.I name
is the name of the device, usually
@@ -181,7 +181,7 @@ must be in the range 0 to 65535; default is\~0.
.TP
.I GROFF_FONT_PATH
A list of directories in which to search for the
-.BI dev name
+.IR dev name
directory in addition to the default ones.
.
See
@@ -196,16 +196,16 @@ for more details.
.\" ====================================================================
.
.TP
-.B @FONTDIR@/devlj4/DESC
+.I @FONTDIR@/devlj4/DESC
Device description file.
.
.TP
-.BI @FONTDIR@/devlj4/ F
+.IR @FONTDIR@/devlj4/ F
Font description file for font
.IR F .
.
.TP
-.B @MACRODIR@/lj4.tmac
+.I @MACRODIR@/lj4.tmac
Macros for use with
.BR grolj4 .
.
diff --git a/src/devices/gropdf/gropdf.1.man b/src/devices/gropdf/gropdf.1.man
index eb7458c1..8b6e9590 100644
--- a/src/devices/gropdf/gropdf.1.man
+++ b/src/devices/gropdf/gropdf.1.man
@@ -130,7 +130,7 @@ fonts (even the 14 base PDF fonts).
.TP
.BI \-F " dir"
Prepend directory
-.IB dir /dev name
+.IR dir /dev name
to the search path for font, and device description files;
.I name
is the name of the device, usually
@@ -165,7 +165,7 @@ This overrides the
and
.B paperwidth
commands in the
-.B DESC
+.I DESC
file; it accepts the same arguments as the
.B papersize
command.
@@ -190,7 +190,7 @@ complains about this line if it is included, but works anyway.
.RI " [" cmapfile ]
.B Gropdf
normally includes a ToUnicode CMap with any font created using
-.B text.enc
+.I text.enc
as the encoding file,
this makes it easier to search for words which contain ligatures.
.
@@ -273,7 +273,7 @@ supports the concept of foundries, that is different versions of basically
the same font.
.
During install a
-.B Foundry
+.I Foundry
file controls where fonts are found and builds
.B groff
fonts from the files it discovers on your system.
@@ -338,7 +338,7 @@ Fonts may be in PFA or PFB format.
Any downloadable fonts which should, when required, be included by
.B gropdf
must be listed in the file
-.BR @FONTDIR@/devpdf/download ;
+.IR @FONTDIR@/devpdf/download ;
this should consist of lines of the form
.
.IP
@@ -367,7 +367,7 @@ is searched for using the same mechanism that is used
for groff font metric files.
.
The
-.B download
+.I download
file itself is also searched for using this mechanism;
currently, only the first found file in the font path is used.
.
@@ -695,7 +695,8 @@ macros installed by using
.I \-m pdfmark
or
.I \-m mspdf
-(see documentation in \[oq]pdfmark.pdf\[cq]).
+(see documentation in
+.IR pdfmark.pdf ).
.
A subset of these macros are installed automatically when you use
.B \-Tpdf
@@ -1216,19 +1217,24 @@ store them anyway).
.
.LI
Register all fonts which must be downloaded to the printer in the
-\[oq]devpdf/download\[cq] file.
+.I devpdf/download
+file.
.
Only the first occurrence of this file in the font path is read.
.
-This means that you should copy the default \[oq]download\[cq] file to
-the first directory in your font path and add your fonts there.
+This means that you should copy the default
+.I download
+file to the first directory in your font path and add your fonts there.
.
To continue the above example we assume that the PS font name for
Foo\-Bar\-Bold.pfa is \[oq]XY\-Foo\-Bar\-Bold\[cq] (the PS font name is
stored in the
.B internalname
-field in the \[oq]FBB\[cq] file) and belongs to foundry \[oq]F\[cq]
-thus the following line should be added to \[oq]download\[cq]:
+field in the
+.I FBB
+file) and belongs to foundry \[oq]F\[cq]
+thus the following line should be added to
+.IR download :
.
.RS
.IP
@@ -1248,11 +1254,14 @@ field should be null for the default foundry.
.TP
.I GROFF_FONT_PATH
A list of directories in which to search for the
-.BI dev name
+.IR dev name
directory in addition to the default ones.
.
-If, in the \[oq]download\[cq] file, the
-font file has been specified with a full path, no directories are searched.
+If, in the
+.I download
+file,
+the font file has been specified with a full path,
+no directories are searched.
.
See
.BR @g@troff (@MAN1EXT@)
@@ -1278,16 +1287,16 @@ creation timestamp in place of the current time.
.\" ====================================================================
.
.TP
-.B @FONTDIR@/devpdf/DESC
+.I @FONTDIR@/devpdf/DESC
Device description file.
.
.TP
-.BI @FONTDIR@/devpdf/ F
+.IR @FONTDIR@/devpdf/ F
Font description file for font\~\c
.IR F .
.
.TP
-.BI @FONTDIR@/devpdf/ U\-F
+.IR @FONTDIR@/devpdf/ U\-F
Font description file for font\~\c
.I F
(using foundry\~\c
@@ -1295,19 +1304,19 @@ Font description file for font\~\c
rather than the default foundry).
.
.TP
-.B @FONTDIR@/devpdf/download
+.I @FONTDIR@/devpdf/download
List of downloadable fonts.
.
.TP
-.B @FONTDIR@/devpdf/Foundry
+.I @FONTDIR@/devpdf/Foundry
A Perl script used during install to locate suitable fonts.
.
.TP
-.B @FONTDIR@/devpdf/enc/text.enc
+.I @FONTDIR@/devpdf/enc/text.enc
Encoding used for text fonts.
.
.TP
-.B @MACRODIR@/pdf.tmac
+.I @MACRODIR@/pdf.tmac
Macros for use with
.BR gropdf ;
automatically loaded by
diff --git a/src/devices/grops/grops.1.man b/src/devices/grops/grops.1.man
index 2d47da86..8d730ba7 100644
--- a/src/devices/grops/grops.1.man
+++ b/src/devices/grops/grops.1.man
@@ -200,7 +200,9 @@ The default value can be specified by a
.BI broken\ n
.
.LP
-command in the DESC file.
+command in the
+.I DESC
+file.
.
Otherwise the default value is\~0.
.RE
@@ -214,7 +216,7 @@ copies of each page.
.TP
.BI \-F dir
Prepend directory
-.IB dir /dev name
+.RI dir /dev name
to the search path for prologue, font, and device description files;
.I name
is the name of the device, usually
@@ -272,7 +274,7 @@ This overrides the
and
.B paperwidth
commands in the
-.B DESC
+.I DESC
file; it accepts the same arguments as the
.B papersize
command.
@@ -415,7 +417,7 @@ to convert a Type\~1 font in PFB format.
Any downloadable fonts which should, when required, be included by
.B grops
must be listed in the file
-.BR @FONTDIR@/devps/download ;
+.IR @FONTDIR@/devps/download ;
this should consist of lines of the form
.
.IP
@@ -439,7 +441,7 @@ is searched for using the same mechanism that is used
for groff font metric files.
.
The
-.B download
+.I download
file itself is also searched for using this mechanism;
currently, only the first found file in the font path is used.
.
@@ -453,7 +455,7 @@ interprets any comments in the files sufficiently to ensure that its
own output is conforming.
.
It also supplies any needed font resources that are listed in the
-.B download
+.I download
file
as well as any needed file resources.
.
@@ -489,7 +491,7 @@ the following lines
.LP
In this case both Garamond and Garamond-Outline would need to be listed
in the
-.B download
+.I download
file.
.
A downloadable font should not include its own name in a
@@ -1196,7 +1198,7 @@ the
script to create appropriate metric files.
.
The resulting font wrappers should be added to the
-.B download
+.I download
file.
.B ttftot42
source code can be downloaded from
@@ -1260,7 +1262,8 @@ Old PS printers might not support it (this is, they don't have a
built-in TrueType font interpreter).
.
.IP
-If your font is in PFB format (such fonts normally have \[oq].pfb\[cq]
+If your font is in PFB format (such fonts normally have
+.I .pfb
as the file extension), you might use groff's
.BR \%pfbtops (@MAN1EXT@)
program to convert it to PFA.
@@ -1286,8 +1289,11 @@ afmtodit Foo-Bar-Bold.afm textmap FBB
.RE
.
.IP
-which converts the metric file \[oq]Foo-Bar-Bold.afm\[cq] to the groff
-font \[oq]FBB\[cq].
+which converts the metric file
+.I Foo-Bar-Bold.afm
+to the groff
+font
+.IR FBB .
.
If you have a font family which comes with normal, bold, italic,
and bold italic faces, it is recommended to use the letters
@@ -1311,7 +1317,8 @@ and
.
.LI
Install both the groff font description files and the fonts in a
-\[oq]devps\[cq] subdirectory of the font path which groff finds.
+.I devps
+subdirectory of the font path which groff finds.
.
See section \[lq]Environment\[rq] in
.BR troff (@MAN1EXT@)
@@ -1322,19 +1329,24 @@ to store them anyway).
.
.LI
Register all fonts which must be downloaded to the printer in the
-\[oq]devps/download\[cq] file.
+.I devps/download
+file.
.
Only the first occurrence of this file in the font path is read.
.
-This means that you should copy the default \[oq]download\[cq] file to
-the first directory in your font path and add your fonts there.
+This means that you should copy the default
+.I download
+file to the first directory in your font path and add your fonts there.
.
To continue the above example we assume that the PS font name for
-Foo-Bar-Bold.pfa is \[oq]XY-Foo-Bar-Bold\[cq] (the PS font name is
-stored in the
+.I Foo-Bar-Bold.pfa
+is \[oq]XY-Foo-Bar-Bold\[cq] (the PS font name is stored in the
.B internalname
-field in the \[oq]FBB\[cq] file), thus the following line should be
-added to \[cq]download\[cq].
+field in the
+.I FBB
+file),
+thus the following line should be added to
+.IR download .
.
.RS
.IP
@@ -1354,7 +1366,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
-.B @OLDFONTDIR@/devps
+.I @OLDFONTDIR@/devps
.
.LP
directory.
@@ -1402,7 +1414,7 @@ overrides this environment variable.
.TP
.I GROFF_FONT_PATH
A list of directories in which to search for the
-.BI dev name
+.IR dev name
directory in addition to the default ones.
.
See
@@ -1423,44 +1435,44 @@ creation timestamp in place of the current time.
.\" ====================================================================
.
.TP
-.B @FONTDIR@/devps/DESC
+.I @FONTDIR@/devps/DESC
Device description file.
.
.TP
-.BI @FONTDIR@/devps/ F
+.IR @FONTDIR@/devps/ F
Font description file for font
.IR F .
.
.TP
-.B @FONTDIR@/devps/download
+.I @FONTDIR@/devps/download
List of downloadable fonts.
.
.TP
-.B @FONTDIR@/devps/text.enc
+.I @FONTDIR@/devps/text.enc
Encoding used for text fonts.
.
.TP
-.B @MACRODIR@/ps.tmac
+.I @MACRODIR@/ps.tmac
Macros for use with
.BR grops ;
automatically loaded by
.B troffrc
.
.TP
-.B @MACRODIR@/pspic.tmac
+.I @MACRODIR@/pspic.tmac
Definition of
.B PSPIC
macro,
automatically loaded by
-.BR ps.tmac .
+.IR ps.tmac .
.
.TP
-.B @MACRODIR@/psold.tmac
+.I @MACRODIR@/psold.tmac
Macros to disable use of characters not present in older
PostScript printers (e.g., \[oq]eth\[cq] or \[oq]thorn\[cq]).
.
.TP
-.BI /tmp/grops XXXXXX
+.IR /tmp/grops XXXXXX
Temporary file.
See
.BR groff (@MAN1EXT@)
diff --git a/src/devices/grotty/grotty.1.man b/src/devices/grotty/grotty.1.man
index 14ff6607..baa531b8 100644
--- a/src/devices/grotty/grotty.1.man
+++ b/src/devices/grotty/grotty.1.man
@@ -224,7 +224,7 @@ escape sequence in
.
.LP
If the
-.B DESC
+.I DESC
file contains the keyword
.BR unicode ,
.B grotty
@@ -303,7 +303,7 @@ its last line.
.TP
.BI \-F dir
Prepend directory
-.IB dir /dev name
+.RI dir /dev name
to the search path for font and device description files;
.I name
is the name of the device, usually
@@ -399,7 +399,7 @@ Colors are disabled.
.TP
.I GROFF_FONT_PATH
A list of directories in which to search for the
-.BI dev name
+.IR dev name
directory in addition to the default ones.
.
See
@@ -414,69 +414,69 @@ for more details.
.\" ====================================================================
.
.TP
-.B @FONTDIR@/devascii/DESC
-Device description file for
+.I @FONTDIR@/devascii/DESC
+Device description file for the
.B ascii
device.
.
.TP
-.BI @FONTDIR@/devascii/ F
+.IR @FONTDIR@/devascii/ F
Font description file for font
.I F
-of
+of the
.B ascii
device.
.
.TP
-.B @FONTDIR@/devlatin1/DESC
-Device description file for
+.I @FONTDIR@/devlatin1/DESC
+Device description file for the
.B latin1
device.
.
.TP
-.BI @FONTDIR@/devlatin1/ F
+.IR @FONTDIR@/devlatin1/ F
Font description file for font
.I F
-of
+of the
.B latin1
device.
.
.TP
-.B @FONTDIR@/devutf8/DESC
-Device description file for
+.I @FONTDIR@/devutf8/DESC
+Device description file for the
.B utf8
device.
.
.TP
-.BI @FONTDIR@/devutf8/ F
+.IR @FONTDIR@/devutf8/ F
Font description file for font
.I F
-of
+of the
.B utf8
device.
.
.TP
-.B @FONTDIR@/devcp1047/DESC
-Device description file for
+.I @FONTDIR@/devcp1047/DESC
+Device description file for the
.B cp1047
device.
.
.TP
-.BI @FONTDIR@/devcp1047/ F
+.IR @FONTDIR@/devcp1047/ F
Font description file for font
.I F
-of
+of the
.B cp1047
device.
.
.TP
-.B @MACRODIR@/tty.tmac
+.IR @MACRODIR@/tty.tmac
Macros for use with
.BR grotty .
.
.TP
-.B @MACRODIR@/tty\-char.tmac
-Additional kludgy character definitions for use with
+.IR @MACRODIR@/tty\-char.tmac
+Additional character definitions for use with
.BR grotty .
.
.LP
diff --git a/src/devices/xditview/gxditview.1.man b/src/devices/xditview/gxditview.1.man
index d3bd80f7..a44de7da 100644
--- a/src/devices/xditview/gxditview.1.man
+++ b/src/devices/xditview/gxditview.1.man
@@ -284,8 +284,10 @@ The
.B paperlength
and
.B paperwidth
-commands in the DESC file specify the length and width in machine units
-of the virtual page displayed by
+commands in the
+.I DESC
+file specify the length and width in machine units of the virtual page
+displayed by
.BR \%gxditview .
.
.
@@ -335,7 +337,9 @@ The
.I groff intermediate output
file will be displayed at a resolution of
.I res
-dpi, unless the DESC file contains the
+dpi, unless the
+.I DESC
+file contains the
.B X11
command, in which case the device resolution will be used.
.
@@ -480,7 +484,7 @@ SS -adobe-symbol-medium-r-normal--*-100-*-*-*-*-adobe-fontspecific\en\e
.TP
.I GROFF_FONT_PATH
A list of directories in which to search for the
-.BI dev name
+.IR dev name
directory in addition to the default ones.
.
See
@@ -495,14 +499,14 @@ for more details.
.\" ====================================================================
.
.TP
-.B @APPRESDIR@/GXditview
+.I @APPRESDIR@/GXditview
.TQ
-.B @APPRESDIR@/GXditview\-color
+.I @APPRESDIR@/GXditview\-color
The default resource files of
.BR \%gxditview .
.
Users should override these values in the
-.B .Xdefaults
+.I .Xdefaults
file, normally located in the user's home directory.
.
See
diff --git a/src/preproc/eqn/eqn.1.man b/src/preproc/eqn/eqn.1.man
index bb6b6e4a..022de4fd 100644
--- a/src/preproc/eqn/eqn.1.man
+++ b/src/preproc/eqn/eqn.1.man
@@ -91,14 +91,14 @@ causes the standard input to be read.
.LP
.B eqn
searches for the file
-.B eqnrc
+.I eqnrc
in the directories given with the
.B \-M
option first, then in
-.BR @SYSTEMMACRODIR@ ,
-.BR @LOCALMACRODIR@ ,
+.IR @SYSTEMMACRODIR@ ,
+.IR @LOCALMACRODIR@ ,
and finally in the standard macro directory
-.BR @MACRODIR@ .
+.IR @MACRODIR@ .
.
If it exists,
.B eqn
@@ -183,12 +183,12 @@ Normally, the only effect of this is to define a macro
.I name
with a value of\~\c
.BR 1 ;
-.B eqnrc
+.I eqnrc
uses this to provide definitions appropriate for the output device.
.
However, if the specified device is \[lq]MathML\[rq], the output is
MathML markup rather than troff commands, and
-.B eqnrc
+.I eqnrc
is not loaded at all.
.
The default output device is
@@ -199,13 +199,13 @@ The default output device is
Search
.I dir
for
-.B eqnrc
+.I eqnrc
before the default directories.
.
.TP
.B \-R
Don't load
-.BR eqnrc .
+.IR eqnrc .
.
.TP
.BI \-f F
@@ -1075,7 +1075,7 @@ and
is ignored.
.
The default value is\~0 (This is typically changed to\~1 by the
-.B eqnrc
+.I eqnrc
file for the
.BR ascii ,
.BR latin1 ,
@@ -1260,7 +1260,7 @@ causes a character to be set in roman type.
.\" ====================================================================
.
.TP
-.B @MACRODIR@/eqnrc
+.I @MACRODIR@/eqnrc
Initialization file.
.
.
diff --git a/src/preproc/grn/grn.1.man b/src/preproc/grn/grn.1.man
index d463f118..84647119 100644
--- a/src/preproc/grn/grn.1.man
+++ b/src/preproc/grn/grn.1.man
@@ -132,25 +132,25 @@ files.
.
The default path is (in that order) the current directory, the home
directory,
-.BR @SYSTEMMACRODIR@ ,
-.BR @LOCALMACRODIR@ ,
+.IR @SYSTEMMACRODIR@ ,
+.IR @LOCALMACRODIR@ ,
and
-.BR @MACRODIR@ .
+.IR @MACRODIR@ .
.
.TP
.BI \-F dir
Search
.I dir
for subdirectories
-.BI dev name
+.IR dev name
.RI ( name
is the name of the device) for the
-.B DESC
+.I DESC
file before the default font directories
-.BR @LOCALFONTDIR@ ,
-.BR @FONTDIR@ ,
+.IR @LOCALFONTDIR@ ,
+.IR @FONTDIR@ ,
and
-.BR @LEGACYFONTDIR@ .
+.IR @LEGACYFONTDIR@ .
.
.TP
.B \-C
@@ -748,7 +748,7 @@ cause problems if displayed on the
.\" ====================================================================
.
.TP
-.BI @FONTDIR@/dev name /DESC
+.IR @FONTDIR@/dev name /DESC
Device description file for device
.IR name .
.
diff --git a/src/preproc/pic/pic.1.man b/src/preproc/pic/pic.1.man
index 848a1536..847bbe37 100644
--- a/src/preproc/pic/pic.1.man
+++ b/src/preproc/pic/pic.1.man
@@ -252,7 +252,7 @@ A complete documentation is available in the file
.
.LP
.RS
-.B @DOCDIR@/pic.ms
+.I @DOCDIR@/pic.ms
.RE
.
.
@@ -1241,8 +1241,7 @@ package.
.\" ====================================================================
.
.TP
-.B
-@MACRODIR@/pic.tmac
+.I @MACRODIR@/pic.tmac
Example definitions of the
.B PS
and
@@ -1268,7 +1267,8 @@ macros.
Eric S.\& Raymond,
.I Making Pictures With GNU PIC.
.br
-@DOCDIR@/pic.ps (this file, together with its source file, pic.ms, is part
+.I @DOCDIR@/pic.ps
+(this file, together with its source file, pic.ms, is part
of the groff documentation)
.
.
diff --git a/src/preproc/refer/refer.1.man b/src/preproc/refer/refer.1.man
index 170e3cc4..54279e56 100644
--- a/src/preproc/refer/refer.1.man
+++ b/src/preproc/refer/refer.1.man
@@ -1715,12 +1715,12 @@ macro.
.\" ====================================================================
.
.TP
-.B @DEFAULT_INDEX@
+.I @DEFAULT_INDEX@
Default database.
.
.
.TP
-.IB file @INDEX_SUFFIX@
+.RI file @INDEX_SUFFIX@
Index files.
.
.
diff --git a/src/roff/groff/groff.1.man b/src/roff/groff/groff.1.man
index 945f8c4f..ea7e8859 100644
--- a/src/roff/groff/groff.1.man
+++ b/src/roff/groff/groff.1.man
@@ -690,7 +690,9 @@ Set default font family.
.
.TP
.BI \-F\ dir
-Set path for font DESC files.
+Set path for font
+.I DESC
+files.
.
.TP
.B \-i
@@ -699,10 +701,10 @@ Process standard input after the specified input files.
.TP
.BI \-m\ name
Include macro file
-.IB name .tmac
+.RI name .tmac
(or
-.BI tmac. name\/\c
-); see also
+.IR tmac. name);
+see also
.BR \%groff_tmac (@MAN5EXT@).
.
.TP
@@ -1482,7 +1484,7 @@ for details.
.TP
.I GROFF_FONT_PATH
A list of directories in which to search for the
-.BI dev name
+.IR dev name
directory in addition to the default ones.
.
See
@@ -1523,7 +1525,7 @@ and
.IR \%TMPDIR .
.
Otherwise, temporary files are created in
-.BR /tmp .
+.IR /tmp .
.
The
.BR \%@g@refer (@MAN1EXT@),
@@ -1644,59 +1646,59 @@ clearly defined and coincides on all systems.
This section describes the position of all files of the
.I groff
package after the installation \[em] got from
-.B Makefile.comm
+.I Makefile.comm
at the top of the
.I groff
source package.
.
.
.TP
-.B @DEFAULT_INDEX@
+.I @DEFAULT_INDEX@
index directory and index name
.TP
-.B @LEGACYFONTDIR@
+.I @LEGACYFONTDIR@
legacy font directory
.TP
-.B @BINDIR@
+.I @BINDIR@
directory for binary programs
.TP
-.B @SYSTEMMACRODIR@
+.I @SYSTEMMACRODIR@
system tmac directory
.TP
-.B @DOCDIR@
+.I @DOCDIR@
documentation directory
.TP
-.B @EXAMPLEDIR@
+.I @EXAMPLEDIR@
directory for examples
.TP
-.B @HTMLDOCDIR@
+.I @HTMLDOCDIR@
documentation directory for HTML files
.TP
-.B @PDFDOCDIR@
+.I @PDFDOCDIR@
documentation directory for PDF files
.TP
-.B @DATASUBDIR@
+.I @DATASUBDIR@
data subdirectory
.TP
-.B @COMMON_WORDS_FILE@
+.I @COMMON_WORDS_FILE@
file for common words
.TP
-.B @FONTDIR@
+.I @FONTDIR@
directory for fonts
.TP
-.B @OLDFONTDIR@
+.I @OLDFONTDIR@
directory for old fonts
.TP
-.B @MACRODIR@
+.I @MACRODIR@
tmac directory
.TP
-.B @TMAC_MDIR@
+.I @TMAC_MDIR@
mm tmac directory
.TP
-.B @LOCALFONTDIR@
+.I @LOCALFONTDIR@
local font directory
.TP
-.B @LOCALMACRODIR@
+.I @LOCALMACRODIR@
local tmac directory
.
.
@@ -1721,7 +1723,7 @@ have a special meaning:
.
.
.TP
-.B troffrc
+.I troffrc
Initialization file for
.IR troff .
.
@@ -1731,7 +1733,7 @@ before reading the macro sets and any input.
.
.
.TP
-.B troffrc\-end
+.I troffrc\-end
Final startup file for
.IR troff .
.
@@ -1739,9 +1741,9 @@ It is parsed after all macro sets have been read.
.
.
.TP
-.IB name .tmac
+.RI name .tmac
.TQ
-.BI tmac. name
+.IR tmac. name
Macro file for macro package
.IR name .
.
@@ -1766,7 +1768,7 @@ have a special meaning:
.
.
.TP
-.BI dev name /DESC
+.IR dev name /DESC
Device description file for device
.IR name ,
see
@@ -1774,7 +1776,7 @@ see
.
.
.TP
-.BI dev name / F
+.IR dev name / F
Font file for font
.I F
of device
@@ -1814,7 +1816,7 @@ a read-only list showing logs of commitments to the groff repository.
.
.P
Details on repository access and much more can be found in the file
-.B README
+.I README
at the top directory of the
.I groff
source package.
diff --git a/src/roff/troff/troff.1.man b/src/roff/troff/troff.1.man
index 8f53c103..72f74be9 100644
--- a/src/roff/troff/troff.1.man
+++ b/src/roff/troff/troff.1.man
@@ -135,10 +135,10 @@ as the default font family.
Search in directory (or directory path)
.I dir
for subdirectories
-.BI dev name
+.IR dev name
.RI ( name
is the name of the device) and there for the
-.B DESC
+.I DESC
file and font files.
.
.I dir
@@ -172,10 +172,10 @@ No directory search is performed for files with an absolute file name.
.TP
.BI \-m name
Read in the file
-.IB name .tmac\fR.
+.RI name .tmac .
.
If it isn't found, try
-.BI tmac. name
+.IR tmac. name
instead.
.
It will be first searched for in directories given with the
@@ -183,8 +183,11 @@ It will be first searched for in directories given with the
command-line option, then in directories given in the
.I GROFF_TMAC_PATH
environment variable, then in the current directory (only if in unsafe
-mode), the home directory, @SYSTEMMACRODIR@, @LOCALMACRODIR@, and
-@MACRODIR@.
+mode), the home directory,
+.IR @SYSTEMMACRODIR@ ,
+.IR @LOCALMACRODIR@ ,
+and
+.IR @MACRODIR@ .
.
.TP
.BI \-M dir
@@ -240,9 +243,9 @@ can be any troff numeric expression.
.TP
.B \-R
Don't load
-.B troffrc
+.I troffrc
and
-.BR troffrc-end .
+.IR troffrc-end .
.
.TP
.BI \-T name
@@ -521,9 +524,9 @@ will scan directories given in the
.B \-M
option before these, and in standard directories (current directory if
in unsafe mode, home directory,
-.BR @SYSTEMMACRODIR@ ,
-.BR @LOCALMACRODIR@ ,
-.BR @MACRODIR@ )
+.IR @SYSTEMMACRODIR@ ,
+.IR @LOCALMACRODIR@ ,
+.IR @MACRODIR@ )
after these.
.
.TP
@@ -533,16 +536,16 @@ Default device.
.TP
.I GROFF_FONT_PATH
A colon separated list of directories in which to search for the
-.BI dev name
+.IR dev name
directory.
.
.B @g@troff
will scan directories given in the
.B \-F
option before these, and in standard directories
-.RB ( @LOCALFONTDIR@ ,
-.BR @FONTDIR@ ,
-.BR @LEGACYFONTDIR@ )
+.RI ( @LOCALFONTDIR@ ,
+.IR @FONTDIR@ ,
+.IR @LEGACYFONTDIR@ )
after these.
.
.
@@ -551,26 +554,26 @@ after these.
.\" ====================================================================
.
.TP
-.B @MACRODIR@/troffrc
+.I @MACRODIR@/troffrc
Initialization file (called before any other macro package).
.
.TP
-.B @MACRODIR@/troffrc\-end
+.I @MACRODIR@/troffrc\-end
Initialization file (called after any other macro package).
.
.TP
-.BI @MACRODIR@/ name .tmac
+.IR @MACRODIR@/ name .tmac
.TQ
-.BI @MACRODIR@/tmac. name
+.IR @MACRODIR@/tmac. name
Macro files
.
.TP
-.BI @FONTDIR@/dev name /DESC
+.IR @FONTDIR@/dev name /DESC
Device description file for device
.IR name .
.
.TP
-.BI @FONTDIR@/dev name / F
+.IR @FONTDIR@/dev name / F
Font file for font
.I F
of device
@@ -579,9 +582,9 @@ of device
.
.P
Note that
-.B troffrc
+.I troffrc
and
-.B troffrc\-end
+.I troffrc\-end
are neither searched in the current nor in the home directory by
default for security reasons (even if the
.B \-U
diff --git a/src/utils/indxbib/indxbib.1.man b/src/utils/indxbib/indxbib.1.man
index 719aca5a..25a6aab1 100644
--- a/src/utils/indxbib/indxbib.1.man
+++ b/src/utils/indxbib/indxbib.1.man
@@ -69,7 +69,7 @@ and
.BR lkbib (@MAN1EXT@).
.
The index will be named
-.IB filename @INDEX_SUFFIX@\fR;
+.RI filename @INDEX_SUFFIX@ ;
the index is written to a temporary file which is then renamed to
this.
.
@@ -78,7 +78,7 @@ If no filenames are given on the command line because the
option has been used, and no
.B \-o
option is given, the index will be named
-.BR @DEFAULT_INDEX_NAME@@INDEX_SUFFIX@ .
+.IR @DEFAULT_INDEX_NAME@@INDEX_SUFFIX@ .
.
.
.LP
@@ -140,7 +140,7 @@ Each file is a separate record.
Read the list of common words from
.I file
instead of
-.BR @COMMON_WORDS_FILE@ .
+.IR @COMMON_WORDS_FILE@ .
.
.TP
.BI \-d dir
@@ -229,7 +229,7 @@ is 100.
.TP
.BI \-o basename
The index should be named
-.IB basename @INDEX_SUFFIX@\fR.
+.RI basename @INDEX_SUFFIX@ .
.
.TP
.BI \-t n
@@ -246,19 +246,19 @@ is 6.
.\" ====================================================================
.
.TP
-.IB filename @INDEX_SUFFIX@
+.RI filename @INDEX_SUFFIX@
Index.
.
.TP
-.B @DEFAULT_INDEX_NAME@@INDEX_SUFFIX@
+.I @DEFAULT_INDEX_NAME@@INDEX_SUFFIX@
Default index name.
.
.TP
-.B @COMMON_WORDS_FILE@
+.I @COMMON_WORDS_FILE@
List of common words.
.
.TP
-.BI indxbib XXXXXX
+.IR indxbib XXXXXX
Temporary file.
.
.
diff --git a/src/utils/tfmtodit/tfmtodit.1.man b/src/utils/tfmtodit/tfmtodit.1.man
index 7ddf30e1..605942db 100644
--- a/src/utils/tfmtodit/tfmtodit.1.man
+++ b/src/utils/tfmtodit/tfmtodit.1.man
@@ -136,7 +136,7 @@ Metafont can be made to put this information in the gf file by loading
the following definition after
.B cmbase
when creating
-.BR cm.base :
+.IR cm.base :
.IP
.nf
.ft B
@@ -151,7 +151,7 @@ def ignore_math_fit(expr left_adjustment,right_adjustment) =
For the EC font family, load the following definition after
.B exbase
(it is probably easiest to patch
-.B exbase.mf
+.I exbase.mf
locally):
.IP
.nf
@@ -165,9 +165,9 @@ def ignore_math_fit(expr left_adjustment,right_adjustment) =
.ft R
.LP
The gf file created using this modified
-.B cm.base
+.I cm.base
or
-.B exbase
+.I exbase
should be specified with the
.B \-g
option.
@@ -228,11 +228,11 @@ commands giving additional font metric information.
.\" ====================================================================
.
.TP
-.B @FONTDIR@/devdvi/DESC
+.I @FONTDIR@/devdvi/DESC
Device description file.
.
.TP
-.BI @FONTDIR@/devdvi/ F
+.IR @FONTDIR@/devdvi/ F
Font description file for font
.IR F .
.
diff --git a/tmac/groff_ms.7.man b/tmac/groff_ms.7.man
index ca71280f..a9f1e94d 100644
--- a/tmac/groff_ms.7.man
+++ b/tmac/groff_ms.7.man
@@ -977,7 +977,8 @@ X11 documents which actually use
.B Ds
and
.B De
-always load a specific macro file from the X11 distribution (macros.t)
+always load a specific macro file from the X11 distribution
+.RI ( macros.t )
which provides proper definitions for the two macros.
.
.PP
@@ -1779,11 +1780,11 @@ Names containing only uppercase letters and digits.
.SH FILES
.\" ====================================================================
.
-.B @MACRODIR@/ms.tmac
+.I @MACRODIR@/ms.tmac
(a wrapper file for
-.BR s.tmac )
+.IR s.tmac )
.br
-.B @MACRODIR@/s.tmac
+.I @MACRODIR@/s.tmac
.
.
.
diff --git a/tmac/groff_www.7.man b/tmac/groff_www.7.man
index db0726c4..9c2f2040 100644
--- a/tmac/groff_www.7.man
+++ b/tmac/groff_www.7.man
@@ -68,7 +68,7 @@ It has been included into the distribution so that a lot of people have a
chance to test it.
.
Note that this macro file is automatically called (via the
-.B troffrc
+.I troffrc
file) if you use
.B \-Thtml
or
@@ -688,7 +688,8 @@ information is currently rendered as a PNG image.
.\" ====================================================================
.SH FILES
.\" ====================================================================
-@MACRODIR@/www.tmac
+.
+.I @MACRODIR@/www.tmac
.
.
.\" ====================================================================
commit da5c044ce34073a3aea4574b28fcae645527fa4d
Author: G. Branden Robinson <g.branden.robin...@gmail.com>
Date: Fri Nov 30 23:12:51 2018 -0500
*.man: Regularize (sub)section cross references.
contrib/gdiffmk/gdiffmk.1.man:
contrib/groffer/groffer.1.man:
contrib/mm/groff_mm.7.man:
contrib/pdfmark/pdfroff.1.man:
man/groff.7.man:
man/groff_diff.7.man:
man/groff_out.5.man:
man/groff_tmac.5.man:
man/roff.7.man:
src/devices/grolbp/grolbp.1.man:
src/devices/gropdf/gropdf.1.man:
src/devices/grops/grops.1.man:
src/preproc/eqn/eqn.1.man:
src/preproc/refer/refer.1.man:
src/roff/troff/troff.1.man:
tmac/groff_ms.7.man:
+ Quote (sub)section names instead of setting them in bold or italics.
contrib/mm/groff_mm.7.man:
contrib/pdfmark/pdfroff.1.man:
man/groff.7.man:
man/groff_out.5.man:
man/groff_tmac.5.man:
man/roff.7.man:
src/devices/grolbp/grolbp.1.man:
src/devices/gropdf/gropdf.1.man:
src/devices/grops/grops.1.man:
src/preproc/eqn/eqn.1.man:
src/preproc/refer/refer.1.man:
+ When cross referencing a local (sub)section, add direction of
reference ("above" vs. "below").
contrib/mm/groff_mm.7.man:
contrib/pdfmark/pdfroff.1.man:
man/groff.7.man:
man/groff_diff.7.man:
man/groff_out.5.man:
man/groff_tmac.5.man:
man/roff.7.man:
src/devices/grolbp/grolbp.1.man:
src/devices/gropdf/gropdf.1.man:
src/devices/grops/grops.1.man:
src/preproc/eqn/eqn.1.man:
src/roff/troff/troff.1.man:
tmac/groff_man.7.man:
+ Stop setting (sub)section names in all caps. That is a presentational
matter better decided in the implementation of the .SH and .SS macros.
contrib/groffer/groffer.1.man:
+ Fix comma splice.
+ Fix incorrect (or outdated) section name reference to X(7).
contrib/mm/groff_mm.7.man:
+ "See also" is a good section title, but in prose, "also see" is more
idiomatic.
man/groff_char.7.man:
+ "{next,previous} section" get a definite article.
man/groff_diff.7.man:
src/devices/grolbp/grolbp.1.man:
tmac/groff_man.7.man:
+ (Sub)section $IDENTIFIER by contrast does _not_ require a definite
article.
man/groff_out.5.man:
+ Fix incorrect reference (named section is actually a subsection).
man/groff_tmac.5.man:
+ Fix non-idiomatic English "some" -> "a". My favorite example of this
is an old Debian package description of a Moon Patrol clone:
"drive some car across the moon"
...which carries a pointed tone of contempt or ambivalence to a
native speaker.
src/devices/gropdf/gropdf.1.man:
src/devices/grops/grops.1.man:
+ There is no need to identify the destination of a cross reference as a
man page if it's formatted as only man page references are ("foo(1)").
diff --git a/contrib/gdiffmk/gdiffmk.1.man b/contrib/gdiffmk/gdiffmk.1.man
index 26532f0f..1e20d473 100644
--- a/contrib/gdiffmk/gdiffmk.1.man
+++ b/contrib/gdiffmk/gdiffmk.1.man
@@ -102,9 +102,7 @@ Clearly both cannot be
Note that the output is not necessarily compatible with all macro packages
and all preprocessors.
.
-See the
-.B BUGS
-section below.
+See section \(lqBugs\(rq below.
.
.
.\" ====================================================================
diff --git a/contrib/groffer/groffer.1.man b/contrib/groffer/groffer.1.man
index e0457ce4..5eec6bf2 100644
--- a/contrib/groffer/groffer.1.man
+++ b/contrib/groffer/groffer.1.man
@@ -1554,10 +1554,10 @@ window.
.TP
.BI \-\-display \ X-display
Set the X Window System display on which the viewer program
-shall be started, see
-.BR X (7),
-section
-.IR "Display Names" ,
+shall be started.
+.
+See section \(lqDisplay Names\(rq in
+.BR X (7)
for the syntax of the argument.
.
.
@@ -1596,10 +1596,8 @@ This is equivalent to
Set the geometry of the display window, that means its size and its
starting position.
.
-See
-.BR \%X (7),
-section
-.IR "Geometry Management" ,
+See section \(lqGeometry Specifications\(rq in
+.BR X (7)
for the syntax of the argument.
.
.
diff --git a/contrib/mm/groff_mm.7.man b/contrib/mm/groff_mm.7.man
index 3ecf8f09..a95790cb 100644
--- a/contrib/mm/groff_mm.7.man
+++ b/contrib/mm/groff_mm.7.man
@@ -1997,8 +1997,7 @@ See also
Format a letter in one of four different styles depending
on the argument.
.
-See also section
-.BR INTERNALS .
+Also see section \[lq]Internals\[rq] below.
.
.RS
.IP
@@ -2678,8 +2677,7 @@ otherwise at the last.
No reference data is printed if the author(s) is specified through
.BR .WA / .WE .
.
-See section
-.BR INTERNALS .
+See section \[lq]Internals\[rq] below.
.
.TP
.BI SK\ \fR[\fPpages\fR]\fP
diff --git a/contrib/pdfmark/pdfroff.1.man b/contrib/pdfmark/pdfroff.1.man
index 5cf31442..b5fc5aa5 100644
--- a/contrib/pdfmark/pdfroff.1.man
+++ b/contrib/pdfmark/pdfroff.1.man
@@ -305,9 +305,8 @@ has completed PDF document formatting; this may be useful, when
debugging formatting problems.
.
.IP
-See section
-.BR FILES ,
-for a description of the temporary files used by
+See section \[lq]Files\[rq] below for a description of the temporary
+files used by
.BR pdfroff .
.
.TP
@@ -665,8 +664,7 @@ Temporary files, created by
.BR pdfroff ,
are placed in the file system hierarchy,
in or below the directory specified by environment variables
-(see section
-.BR ENVIRONMENT ).
+(see section \[lq]Environment\[rq] above).
.
If
.BR mktemp (@MAN1EXT@)
diff --git a/man/groff.7.man b/man/groff.7.man
index b61ee513..c21b1a21 100644
--- a/man/groff.7.man
+++ b/man/groff.7.man
@@ -2962,8 +2962,7 @@ End conditional input.
.ESC ( sc
A glyph with two-character name
.IR sc ;
-see section
-.BR "Special Characters" .
+see section \[lq]Special Characters\[rq] below.
.
.TP
.ESC[] "" name
@@ -3705,9 +3704,11 @@ command-line option.
.\" ====================================================================
.
Registers are variables that store a value.
-In groff, most registers store numerical values (see section
-.B NUMERICAL EXPRESSIONS
-above), but some can also hold a string value.
+.
+In groff,
+most registers store numerical values
+(see section \[lq]Numerical Expressions\[rq] above),
+but some can also hold a string value.
.
.
.P
diff --git a/man/groff_char.7.man b/man/groff_char.7.man
index 8bd0a5e3..6ce59681 100644
--- a/man/groff_char.7.man
+++ b/man/groff_char.7.man
@@ -369,7 +369,7 @@ are printable characters that print as themselves.
.
Although they can be specified directly with the keyboard on systems
with a \%latin1 code page, it is better to use their glyph names;
-see next section.
+see the next section.
.
.P
.na
diff --git a/man/groff_diff.7.man b/man/groff_diff.7.man
index 49b8d848..5d93684f 100644
--- a/man/groff_diff.7.man
+++ b/man/groff_diff.7.man
@@ -73,9 +73,7 @@ format (troff output).
.
.
.P
-The section
-.I SEE ALSO
-gives pointers to both the classical
+Section \[lq]See Also\[rq] below gives pointers to both the classical
.I roff
and the modern
.I groff
@@ -2543,9 +2541,7 @@ is read in copy mode.
.BR \[rs]D' \*[ellipsis] '
All drawing commands of groff's intermediate output are accepted.
.
-See subsection
-.B "Drawing Commands"
-below for more information.
+See subsection \[lq]Drawing Commands\[rq] below.
.
.
.\" ====================================================================
diff --git a/man/groff_out.5.man b/man/groff_out.5.man
index f014de24..4f0efaf9 100644
--- a/man/groff_out.5.man
+++ b/man/groff_out.5.man
@@ -406,8 +406,8 @@ is guaranteed to consist of the following three lines (in that order):
.B x init
.RE
.P
-with the arguments set as outlined in the section
-.BR "Device Control Commands" .
+with the arguments set as outlined in subsection \[lq]Device Control
+Commands\[rq] below.
.
However, the parser for the
.I intermediate output
@@ -729,8 +729,8 @@ used the unit
.I points
(\c
.BR p )
-instead; see section
-.BR COMPATIBILITY .
+instead;
+see section \[lq]Compatibility\[rq] below.
.
.
.TP
@@ -901,8 +901,7 @@ In the following command reference, the syntax element
.I \[la]line-break\[ra]
means a
.I syntactical line break
-as defined in section
-.BR Separation .
+as defined in subsection \[lq]Separation\[rq] above.
.
.
.TP
@@ -1229,8 +1228,7 @@ In the following, the syntax element
.I \[la]line-break\[ra]
means a
.I syntactical line break
-as defined in section
-.BR Separation .
+as defined in subsection \[lq]Separation\[rq] above.
.
.TP
.x-command F name
@@ -1273,8 +1271,8 @@ Set character height to\~\c
.I Classical troff
used the unit points (\c
.BR p )
-instead; see section
-.BR COMPATIBILITY .
+instead;
+see section \[lq]Compatibility\[rq] below.
.
.
.TP
@@ -1504,8 +1502,8 @@ So a
.I groff
postprocessor must only redefine the methods of this class.
.
-For details, see the reference in section
-.BR FILES .
+For details,
+see the reference in section \[lq]Files\[rq] below.
.
.
.\" ====================================================================
diff --git a/man/groff_tmac.5.man b/man/groff_tmac.5.man
index 7a3d793b..29b25b6f 100644
--- a/man/groff_tmac.5.man
+++ b/man/groff_tmac.5.man
@@ -806,8 +806,9 @@ to invoke
.P
If you want to write your own groff macro file, call it
.IB whatever .tmac
-and put it in some directory of the tmac path, see section
-.BR FILES .
+and put it in a directory in the tmac path;
+see section \[lq]Files\[rq] below.
+.
Then documents can include it with the
.B .mso
request or the option
diff --git a/man/roff.7.man b/man/roff.7.man
index d240d152..deff211c 100644
--- a/man/roff.7.man
+++ b/man/roff.7.man
@@ -85,8 +85,7 @@ many extensions.
.P
The ancestry of
.I roff
-is described in section
-.BR HISTORY .
+is described in section \[lq]History\[rq] below.
.
In this document, the term
.I roff
@@ -331,8 +330,8 @@ output format, and the postprocessor system.
.
This completed the structure of a
.I "roff system"
-as it is still in use today; see section
-.BR "USING ROFF" .
+as it is still in use today;
+see section \[lq]Using Roff\[rq] below.
.
In 1979, these novelties were described in the paper
[CSTR\~#97].
diff --git a/src/devices/grolbp/grolbp.1.man b/src/devices/grolbp/grolbp.1.man
index d532d6c9..684f6ccb 100644
--- a/src/devices/grolbp/grolbp.1.man
+++ b/src/devices/grolbp/grolbp.1.man
@@ -166,8 +166,8 @@ orientation, which must be \(oqportrait\(cq or \(oqlandscape\(cq.
.BI \-\-papersize= paper-size
Set the paper size to
.IR paper-size ,
-which must be a valid paper size description as indicated in the section
-.BR "PAPER SIZES" .
+which must be a valid paper size description as indicated in section
+\[lq]Paper Sizes\[rq], below.
.
.
.TP
diff --git a/src/devices/gropdf/gropdf.1.man b/src/devices/gropdf/gropdf.1.man
index d6d98db5..eb7458c1 100644
--- a/src/devices/gropdf/gropdf.1.man
+++ b/src/devices/gropdf/gropdf.1.man
@@ -99,9 +99,8 @@ option.
.
.
.LP
-See section
-.B FONT INSTALLATION
-below for a guide how to install fonts for
+See section \[lq]Font Installation\[rq] below for a guide how to install
+fonts for
.BR gropdf .
.
.
@@ -1208,11 +1207,9 @@ and
Install both the groff font description files and the fonts in a
\[oq]devpdf\[cq] subdirectory of the font path which groff finds.
.
-See the
-.B ENVIRONMENT
-section in the
+See section \[lq]Environment\[rq] in
.BR @g@troff (@MAN1EXT@)
-man page which lists the actual value of the font path.
+for the actual value of the font path.
.
Note that groff doesn't use the AFM files (but it is a good idea to
store them anyway).
diff --git a/src/devices/grops/grops.1.man b/src/devices/grops/grops.1.man
index e7b9c48d..2d47da86 100644
--- a/src/devices/grops/grops.1.man
+++ b/src/devices/grops/grops.1.man
@@ -104,9 +104,8 @@ arguments.
To print such concatenated output it is necessary to deactivate DSC
handling in the printing program or previewer.
.
-See section
-.B FONT INSTALLATION
-below for a guide how to install fonts for
+See section \[lq]Font Installation\[rq] below for a guide how to install
+fonts for
.BR grops .
.
.
@@ -1314,11 +1313,9 @@ and
Install both the groff font description files and the fonts in a
\[oq]devps\[cq] subdirectory of the font path which groff finds.
.
-See the
-.B ENVIRONMENT
-section in the
+See section \[lq]Environment\[rq] in
.BR troff (@MAN1EXT@)
-man page which lists the actual value of the font path.
+for the actual value of the font path.
.
Note that groff doesn't use the AFM files (but it is a good idea
to store them anyway).
diff --git a/src/preproc/eqn/eqn.1.man b/src/preproc/eqn/eqn.1.man
index c0cc4d63..bb6b6e4a 100644
--- a/src/preproc/eqn/eqn.1.man
+++ b/src/preproc/eqn/eqn.1.man
@@ -389,9 +389,7 @@ in these cases
.B chartype
changes the font type of the characters.
.
-See the
-.B Fonts
-subsection.
+See subsection \[lq]Fonts\[rq] below.
.
.
.\" ====================================================================
@@ -1324,9 +1322,7 @@ boundaries.
.
.
.LP
-See the
-.B BUGS
-section for translation limits specific to
+See section \[lq]Bugs\[rq] below for translation limits specific to
.BR eqn .
.
.
diff --git a/src/preproc/refer/refer.1.man b/src/preproc/refer/refer.1.man
index 8d97daf9..170e3cc4 100644
--- a/src/preproc/refer/refer.1.man
+++ b/src/preproc/refer/refer.1.man
@@ -189,9 +189,8 @@ Whitespace is permitted between a command-line option and its argument.
.
.LP
Most options are equivalent to commands
-(for a description of these commands see the
-.B Commands
-subsection):
+(for a description of these commands,
+see subsection \(lqCommands\(rq below).
.
.
.nr a \n(.j
@@ -1031,9 +1030,8 @@ is a label expression that specifies a string with which to replace the
.B D
field after constructing the label.
.
-See the
-.B "Label expressions"
-subsection for a description of label expressions.
+See subsection \(lqLabel expressions\(rq below for a description of
+label expressions.
.
This command is useful if you do not want explicit labels in the
reference list,
@@ -1298,9 +1296,8 @@ Also
can be used to indicate the references should be sorted using the
(tentative) label.
.
-(The
-.B "Label expressions"
-subsection describes the concept of a tentative label.)
+(Subsection \(lqLabel expressions\(rq below describes the concept of a
+tentative label.)
.
.
.TP
diff --git a/src/roff/troff/troff.1.man b/src/roff/troff/troff.1.man
index 2755c77d..8f53c103 100644
--- a/src/roff/troff/troff.1.man
+++ b/src/roff/troff/troff.1.man
@@ -279,9 +279,7 @@ Print the version number.
Enable warning
.IR name .
.
-Available warnings are described in the section
-.I WARNINGS
-below.
+Available warnings are described in section \(lqWarnings\(rq below.
.
To enable most useful warnings use
.B \-w
diff --git a/tmac/groff_man.7.man b/tmac/groff_man.7.man
index eb5209d6..ef5f9f57 100644
--- a/tmac/groff_man.7.man
+++ b/tmac/groff_man.7.man
@@ -408,8 +408,7 @@ Move the left margin to the right by the value
.IR indent ,
if specified,
and by a default amount otherwise;
-see subsection \(lqHorizontal and vertical spacing\(rq,
-below.
+see subsection \(lqHorizontal and vertical spacing\(rq below.
.
Calls to
.B .RS
@@ -473,8 +472,7 @@ followed by a vertical space downward by a default amount
macro).
.
The font size and style are reset to defaults;
-see subsection \(lqFont style macros\(rq,
-below.
+see subsection \(lqFont style macros\(rq below.
.
Finally, the left margin and indentation are reset to default values.
.
@@ -493,8 +491,7 @@ Subsequent text is indented by
.IR indent ,
if specified,
and by a default amount otherwise;
-see subsection \(lqHorizontal and vertical spacing\(rq,
-below.
+see subsection \(lqHorizontal and vertical spacing\(rq below.
.
.
.IP
@@ -1210,8 +1207,7 @@ see the
\(oq\e(oq\(cq,
and
\(oq\e(cq\(cq
-escapes in the subsection \(lqPortability\(rq,
-below.
+escapes in subsection \(lqPortability\(rq below.
.
.
.\" END USAGE (TODO: move to tutorial/style guide when we have it)
@@ -1368,7 +1364,7 @@ that is,
the width of a letter \(lqn\(rq in the font current when the macro is
called.
.
-See section \(lqNUMERICAL EXPRESSIONS\(rq in
+See section \(lqNumerical Expressions\(rq in
.IR groff (7)
for further details.
.
@@ -1486,7 +1482,7 @@ also cause a break but no insertion of vertical space.
.SS "Number registers"
.\" ====================================================================
.
-Number registers are described in section \(lqOPTIONS\(rq, below.
+Number registers are described in section \(lqOptions\(rq below.
.
.
.\" ====================================================================
@@ -2228,7 +2224,7 @@ Set hyphenation flags.
.
Permissible values of
.I flags
-are documented in section \(lqHYPHENATION\(rq of
+are documented in section \(lqHyphenation\(rq of
.IR groff (7).
.
The default is\~4 if continuous rendering is enabled
diff --git a/tmac/groff_ms.7.man b/tmac/groff_ms.7.man
index c3c6280f..ca71280f 100644
--- a/tmac/groff_ms.7.man
+++ b/tmac/groff_ms.7.man
@@ -456,9 +456,7 @@ the first line of the paragraph is printed.
.PP
Similarly,
when a section heading
-(see subsection
-.I Headings
-below)
+(see subsection \[lq]Headings\[rq] below)
precedes any of these paragraph types,
the
.B HORPHANS
commit 21cab5070e52053588e2e8677881eb720159dd6f
Author: G. Branden Robinson <g.branden.robin...@gmail.com>
Date: Fri Nov 30 20:15:40 2018 -0500
NEWS, man pages: Fix typos.
...the sort a spell checker doesn't catch.
Signed-off-by: G. Branden Robinson <g.branden.robin...@gmail.com>
diff --git a/NEWS b/NEWS
index f43c75ec..1adb2a10 100644
--- a/NEWS
+++ b/NEWS
@@ -42,7 +42,7 @@ o PDFPIC has been corrected so the behaviour is the same whether you use the
set an environment variable "export GROFF_PDFPIC_NOSPACE=1" which will
restore the previous behaviour for all runs.
- Note that this change has no effect it you were using .PDFPIC with the
+ Note that this change has no effect if you were using .PDFPIC with the
PostScript driver--only if you used it with the PDF driver.
diff --git a/tmac/groff_man.7.man b/tmac/groff_man.7.man
index 64997b3d..eb5209d6 100644
--- a/tmac/groff_man.7.man
+++ b/tmac/groff_man.7.man
@@ -1122,7 +1122,7 @@ material.
.IR text ]
Set
.I text
-one point size smaller that the default size.
+one point size smaller than the default size.
.
If the macro is given no arguments,
the text of the next input line is set smaller.
@@ -1150,7 +1150,7 @@ it will be hidden from readers using such devices.
Set
.I text
in bold,
-one point size smaller that the default size.
+one point size smaller than the default size.
.
If the macro is given no arguments,
the text of the next input line is set smaller and in bold.
signature.asc
Description: PGP signature
