commit e182b251588cb4eea381d299af21dc882b8bc184 Author: G. Branden Robinson Date: Sun Dec 9 17:58:41 2018 -0500 troff(1): Fix bad grammar. Signed-off-by: G. Branden Robinson 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 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 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 address@hidden:gnu.org -for reporting bugs -.ME . +bug tracker activity (read-only) +.ME ; +. . .IP .MT address@hidden:gnu.org -for general discussion of -.IR groff , -.ME . +general discussion +.ME ; +and +. +. .IP -.MT address@hidden:ffii.org -the groff commit list +.MT address@hidden: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 address@hidden: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 address@hidden:jclark.com commit c943f4c43e3e44c263d71c41ce164f71a086d58b Author: G. Branden Robinson 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 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 Date: Fri Dec 7 12:02:14 2018 -0500 groff(1): DESC files describe devices, not fonts. Signed-off-by: G. Branden Robinson 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 Date: Fri Dec 7 11:31:19 2018 -0500 man pages: Hyphenate phrasal adjectives. ...when they precede nouns. Signed-off-by: G. Branden Robinson 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 Date: Fri Dec 7 11:26:28 2018 -0500 man pages: Escape hyphens in filenames. Signed-off-by: G. Branden Robinson 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 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 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 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 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 address@hidden@/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 @address@hidden 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 @address@hidden \-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 @address@hidden (@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 address@hidden@/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 address@hidden@/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 address@hidden@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 address@hidden@. +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 @address@hidden 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 @address@hidden; +.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 @address@hidden +.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 .\" ==================================================================== address@hidden@/www.tmac +. +.I @MACRODIR@/www.tmac . . .\" ==================================================================== commit da5c044ce34073a3aea4574b28fcae645527fa4d Author: G. Branden Robinson 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 @address@hidden (@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 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 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.