[groff] 08/08: man pages: Stop using .SM macro.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 5e9812f1a89a413779d6ca4a81b5d8ef02b4f145
Author: G. Branden Robinson <address@hidden>
Date:   Sun Nov 11 15:01:03 2018 -0500

    man pages: Stop using .SM macro.
    
        * contrib/groffer/groffer.1.man:
        * man/groff_diff.7.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/pic/pic.1.man:
        * src/roff/groff/groff.1.man:
        * src/roff/nroff/nroff.1.man:
        * src/roff/troff/troff.1.man:
        * tmac/groff_ms.7.man: As above.  .SB was not used anywhere, and
        .SM was inconsistently used--mostly in groffer(1)--to mark up
        environment variable names in small caps.  But as now noted in
        groff_man(7), font size changes are invisible on nroff output
        devices, which is probably where most eyeballs encounter man
        pages.
    
    Signed-off-by: G. Branden Robinson <address@hidden>
---
 contrib/groffer/groffer.1.man        | 40 ------------------------------------
 man/groff_diff.7.man                 | 18 +++++++---------
 man/groff_tmac.5.man                 |  1 -
 src/devices/grodvi/grodvi.1.man      |  1 -
 src/devices/grohtml/grohtml.1.man    |  2 --
 src/devices/grolbp/grolbp.1.man      |  1 -
 src/devices/grolj4/grolj4.1.man      |  1 -
 src/devices/gropdf/gropdf.1.man      |  3 ---
 src/devices/grops/grops.1.man        |  3 ---
 src/devices/grotty/grotty.1.man      |  6 ++----
 src/devices/xditview/gxditview.1.man |  1 -
 src/preproc/pic/pic.1.man            |  8 +++-----
 src/roff/groff/groff.1.man           |  1 -
 src/roff/nroff/nroff.1.man           |  2 --
 src/roff/troff/troff.1.man           |  7 +------
 tmac/groff_ms.7.man                  |  3 +--
 16 files changed, 14 insertions(+), 84 deletions(-)

diff --git a/contrib/groffer/groffer.1.man b/contrib/groffer/groffer.1.man
index 57430a3..212357d 100644
--- a/contrib/groffer/groffer.1.man
+++ b/contrib/groffer/groffer.1.man
@@ -133,7 +133,6 @@ behaviors.
 .
 This can be done either in configuration files, with the shell
 environment variable
-.SM
 .IR \%GROFFER_OPT ,
 or on the command line.
 .
@@ -474,7 +473,6 @@ an error is raised.
 .
 .P
 These abbreviations are only allowed in the environment variable
-.SM
 .IR \%GROFFER_OPT ,
 but not in the configuration files.
 .
@@ -583,7 +581,6 @@ Reset all configuration from previously processed 
command-line options
 to the default values.
 .
 This is useful to wipe out all former options of the configuration, in
-.SM
 .IR \%GROFFER_OPT ,
 and restart option processing using only the rest of the command line.
 .
@@ -928,7 +925,6 @@ This option is equivalent to
 option
 .BR \-\-pager=\,\fIprog\fP .
 The option argument can be a file name or a program to be searched in
-.SM
 .IR $PATH ;
 arguments can be provided additionally.
 .
@@ -938,7 +934,6 @@ arguments can be provided additionally.
 Choose a viewer program for actual device or mode.
 .
 This can be a file name or a program to be searched in
-.SM
 .IR $PATH ;
 arguments can be provided additionally.
 .
@@ -1367,7 +1362,6 @@ If your system has \f(CRGNU\fP
 installed the full set of long and short options of the \f(CRGNU\fP
 .B man
 program can be passed via the environment variable
-.SM
 .IR MANOPT ;
 see
 .BR \%man (1).
@@ -1424,7 +1418,6 @@ Set the language for
 .IR \%man\~pages .
 .
 This has the same effect, but overwrites
-.SM
 .IR $LANG .
 .
 .
@@ -1687,7 +1680,6 @@ files, do not delete them during the run of
 .TP
 .B \-\-debug\-params
 Print the parameters, as obtained from the configuration files, from
-.SM
 .IR \%GROFFER_OPT ,
 and the command-line arguments.
 .
@@ -1735,7 +1727,6 @@ the display program for viewing the output with its 
arguments,
 .
 .IP \*(BU 2m
 the active parameters from the config files, the arguments in
-.SM
 .IR \%GROFFER_OPT ,
 and the arguments of the command line,
 .
@@ -2051,7 +2042,6 @@ environment (or similar implementations within other 
windowing
 environments).
 .
 The environment variable
-.SM
 .I \%DISPLAY
 and the option
 .B \-\-display
@@ -2143,7 +2133,6 @@ for a text output on a text terminal using some pager 
program.
 .
 .P
 If the variable
-.SM
 .I \%DISPLAY
 is not set or empty,
 .B \%groffer
@@ -2362,13 +2351,11 @@ It is generated by the following methods.
 .
 .IP \*(BU 2m
 The environment variable
-.SM
 .I \%MANPATH
 can be set.
 .
 .IP \*(BU 2m
 It can be read from the arguments of the environment variable
-.SM
 .IR MANOPT .
 .
 .IP \*(BU 2m
@@ -2389,7 +2376,6 @@ program is tried to determine one.
 .
 .IP \*(BU 2m
 If this does not work a reasonable default path from
-.SM
 .I $PATH
 is determined.
 .
@@ -2415,13 +2401,11 @@ can be provided by 3 methods.
 .
 .IP \*(BU 2m
 The environment variable
-.SM
 .I \%SYSTEM
 has the lowest precedence.
 .
 .IP \*(BU 2m
 This can be overridden by an option in
-.SM
 .IR MANOPT .
 .
 .IP \*(BU 2m
@@ -2468,22 +2452,18 @@ can be chosen by several methods.
 .
 .IP \*(BU 2m
 Environment variable
-.SM
 .IR LANG .
 .
 .IP \*(BU 2m
 This is overridden by
-.SM
 .IR \%LC_MESSAGES .
 .
 .IP \*(BU 2m
 This is overridden by
-.SM
 .IR LC_ALL .
 .
 .IP \*(BU 2m
 This can be overridden by providing an option in
-.SM
 .IR MANOPT .
 .
 .IP \*(BU 2m
@@ -2646,7 +2626,6 @@ on the command line:
 .
 .IP \*(BU 2m
 Environment variable
-.SM
 .I \%MANSECT
 .
 .IP \*(BU 2m
@@ -2679,7 +2658,6 @@ search to only some
 The multiple
 .I sections
 are only possible for
-.SM
 .I \%MANSECT
 and
 .BR \-\-sections .
@@ -2705,7 +2683,6 @@ abbreviation is good enough in most cases.
 .
 .IP \*(BU 2m
 Environment variable
-.SM
 .I \%EXTENSION
 .
 .IP \*(BU 2m
@@ -2931,7 +2908,6 @@ and some standard system variables are honored.
 .\" ====================================================================
 .
 .TP
-.SM
 .I \%GROFFER_OPT
 Store options for a run of
 .BR \%groffer .
@@ -2958,7 +2934,6 @@ The following variables have a special meaning for
 .
 .
 .TP
-.SM
 .I \%DISPLAY
 If set, this variable indicates that the X Window System is running.
 .
@@ -2980,13 +2955,10 @@ can be started on the second monitor by the command
 .
 .
 .TP
-.SM
 .I \%LC_ALL
 .TQ
-.SM
 .I \%LC_MESSAGES
 .TQ
-.SM
 .I LANG
 If one of these variables is set (in the above sequence), its content
 is interpreted as the locale, the language to be used, especially when
@@ -3022,7 +2994,6 @@ This is the same behavior as when all 3\~variables are 
unset.
 .
 .
 .TP
-.SM
 .I \%PAGER
 This variable can be used to set the pager for the tty output.
 .
@@ -3037,7 +3008,6 @@ program
 .sp
 .
 .TP
-.SM
 .I PATH
 All programs within the
 .B \%groffer
@@ -3067,7 +3037,6 @@ The following variable has a direct meaning for the
 program.
 .
 .TP
-.SM
 .I \%GROFF_TMPDIR
 If the value of this variable is an existing, writable directory,
 .B \%groffer
@@ -3099,13 +3068,11 @@ but the user interface is the same.
 The
 .B man
 environment variables can be overwritten by options provided with
-.SM
 .IR MANOPT ,
 which in turn is overwritten by the command line.
 .
 .
 .TP
-.SM
 .I \%EXTENSION
 Restrict the search for
 .I \%man\~pages
@@ -3117,7 +3084,6 @@ see there for details.
 .
 .
 .TP
-.SM
 .I MANOPT
 This variable contains options as a preset for
 .BR \%man (1).
@@ -3134,7 +3100,6 @@ given on the command line.
 .
 .
 .TP
-.SM
 .I \%MANPATH
 If set, this variable contains the directories in which the
 .I \%man\~page
@@ -3145,7 +3110,6 @@ This is overridden by option
 .
 .
 .TP
-.SM
 .I \%MANSECT
 If this is a colon separated list of section names, the search for
 .I \%man\~pages
@@ -3156,7 +3120,6 @@ This is overridden by option
 .
 .
 .TP
-.SM
 .I \%SYSTEM
 If this is set to a comma separated list of names these are interpreted
 as
@@ -3170,7 +3133,6 @@ see there for details.
 .
 .P
 The environment variable
-.SM
 .I \%MANROFFSEQ
 is ignored by
 .B \%groffer
@@ -3197,7 +3159,6 @@ System-wide configuration file for
 User-specific configuration file for
 .BR \%groffer ,
 where
-.SM
 .I \%$HOME
 denotes the user's home directory.
 .
@@ -3212,7 +3173,6 @@ file in
 comes first; it is overwritten by the configuration file in the home
 directory; both configuration files are overwritten by the environment
 variable
-.SM
 .IR \%GROFFER_OPT ;
 everything is overwritten by the command line arguments.
 .
diff --git a/man/groff_diff.7.man b/man/groff_diff.7.man
index 246b3d2..88f1e6f 100644
--- a/man/groff_diff.7.man
+++ b/man/groff_diff.7.man
@@ -340,7 +340,7 @@ Normally it is more convenient to use
 But
 .B \[rs]C
 has the advantage that it is compatible with recent versions of
-.SM UNIX
+UNIX
 and is available in compatibility mode.
 .
 .TP
@@ -894,9 +894,8 @@ and
 .BI .asciify\  xx
 This request \[oq]unformats\[cq] the diversion
 .I xx
-in such a way that
-.SM ASCII
-and space characters (and some escape sequences) that were formatted
+in such a way that ASCII and space characters (and some escape
+sequences) that were formatted
 and diverted into
 .I xx
 are treated like ordinary input characters when
@@ -2212,7 +2211,7 @@ command-line option.
 The
 .B styles
 command in the
-.SM DESC
+DESC
 file controls which font positions (if any) are initially associated
 with styles rather than fonts.
 .
@@ -2310,8 +2309,7 @@ using
 .IP
 Unlike with the
 .B cf
-request, the file cannot contain characters such as
-.SM NUL
+request, the file cannot contain characters, such as NUL,
 that are not valid troff input characters.
 .
 .TP
@@ -3136,7 +3134,7 @@ This behaviour is different to UNIX troff.
 .
 .P
 Fonts not listed in the
-.SM DESC
+DESC
 file are automatically mounted on the next available font position
 when they are referenced.
 .
@@ -3242,9 +3240,7 @@ True if there is a character (or glyph)
 .IR ch
 available;
 .I ch
-is either an
-.SM ASCII
-character or a glyph (special character)
+is either an ASCII character or a glyph (special character)
 .BI \[rs]N' xxx '\f[R],
 .BI \[rs]( xx
 or
diff --git a/man/groff_tmac.5.man b/man/groff_tmac.5.man
index 522e91d..939bb4a 100644
--- a/man/groff_tmac.5.man
+++ b/man/groff_tmac.5.man
@@ -389,7 +389,6 @@ orientation:
 .
 .IP
 .EX
-.SM
 \fIsh#\fP groff \-Tps \-dpaper=a4l \-P\-pa4 \-P\-l \-ms foo.ms > foo.ps
 .EE
 .
diff --git a/src/devices/grodvi/grodvi.1.man b/src/devices/grodvi/grodvi.1.man
index 36306c4..1ca3aa9 100644
--- a/src/devices/grodvi/grodvi.1.man
+++ b/src/devices/grodvi/grodvi.1.man
@@ -394,7 +394,6 @@ care of hcode values.
 .\" ====================================================================
 .
 .TP
-.SM
 .I GROFF_FONT_PATH
 A list of directories in which to search for the
 .BI dev name
diff --git a/src/devices/grohtml/grohtml.1.man 
b/src/devices/grohtml/grohtml.1.man
index 1a0e5f5..15828f2 100644
--- a/src/devices/grohtml/grohtml.1.man
+++ b/src/devices/grohtml/grohtml.1.man
@@ -399,7 +399,6 @@ man page for details where such files are created.
 .\" ====================================================================
 .
 .TP
-.SM
 .I GROFF_FONT_PATH
 A list of directories in which to search for the
 .BI dev name
@@ -413,7 +412,6 @@ for more details.
 .
 .
 .TP
-.SM
 .I SOURCE_DATE_EPOCH
 A timestamp (expressed as seconds since the Unix epoch) to use as the
 creation timestamp in place of the current time.
diff --git a/src/devices/grolbp/grolbp.1.man b/src/devices/grolbp/grolbp.1.man
index 3194275..d2ed1a8 100644
--- a/src/devices/grolbp/grolbp.1.man
+++ b/src/devices/grolbp/grolbp.1.man
@@ -403,7 +403,6 @@ is case sensitive.
 .\" ====================================================================
 .
 .TP
-.SM
 .I GROFF_FONT_PATH
 A list of directories in which to search for the
 .BI dev name
diff --git a/src/devices/grolj4/grolj4.1.man b/src/devices/grolj4/grolj4.1.man
index d38f8ad..87fcbea 100644
--- a/src/devices/grolj4/grolj4.1.man
+++ b/src/devices/grolj4/grolj4.1.man
@@ -179,7 +179,6 @@ must be in the range 0 to 65535; default is\~0.
 .\" ====================================================================
 .
 .TP
-.SM
 .I GROFF_FONT_PATH
 A list of directories in which to search for the
 .BI dev name
diff --git a/src/devices/gropdf/gropdf.1.man b/src/devices/gropdf/gropdf.1.man
index 6966137..d6d98db 100644
--- a/src/devices/gropdf/gropdf.1.man
+++ b/src/devices/gropdf/gropdf.1.man
@@ -1249,7 +1249,6 @@ field should be null for the default foundry.
 .\" ====================================================================
 .
 .TP
-.SM
 .I GROFF_FONT_PATH
 A list of directories in which to search for the
 .BI dev name
@@ -1266,14 +1265,12 @@ for more details.
 .
 .
 .TP
-.SM
 .I GROPDF_NOSLIDE
 If this is set true,
 .B gropdf
 will ignore all commands which produce a presentation pdf,
 and produce a normal pdf instead.
 .TP
-.SM
 .I SOURCE_DATE_EPOCH
 A timestamp (expressed as seconds since the Unix epoch) to use as the
 creation timestamp in place of the current time.
diff --git a/src/devices/grops/grops.1.man b/src/devices/grops/grops.1.man
index 774ef6a..075ce5e 100644
--- a/src/devices/grops/grops.1.man
+++ b/src/devices/grops/grops.1.man
@@ -1387,7 +1387,6 @@ or add the directory to groff's font path environment 
variable
 .\" ====================================================================
 .
 .TP
-.SM
 .I GROPS_PROLOGUE
 If this is set to
 .IR foo ,
@@ -1404,7 +1403,6 @@ overrides this environment variable.
 .
 .
 .TP
-.SM
 .I GROFF_FONT_PATH
 A list of directories in which to search for the
 .BI dev name
@@ -1418,7 +1416,6 @@ for more details.
 .
 .
 .TP
-.SM
 .I SOURCE_DATE_EPOCH
 A timestamp (expressed as seconds since the Unix epoch) to use as the
 creation timestamp in place of the current time.
diff --git a/src/devices/grotty/grotty.1.man b/src/devices/grotty/grotty.1.man
index 1e09647..35ec5db 100644
--- a/src/devices/grotty/grotty.1.man
+++ b/src/devices/grotty/grotty.1.man
@@ -107,13 +107,13 @@ switch to revert to the old behaviour, printing a bold 
character
 .I c
 with the sequence
 .RI \[lq] c
-.SM BACKSPACE
+BACKSPACE
 .IR c \[rq]
 and an italic character
 .I c
 by the sequence
 .RB \[lq] _
-.SM BACKSPACE
+BACKSPACE
 .IR c \[rq].
 .
 At the same time, color output is disabled.
@@ -389,7 +389,6 @@ otherwise use the old drawing scheme for bold and underline.
 .\" ====================================================================
 .
 .TP
-.SM
 .I GROFF_NO_SGR
 If set, the old drawing scheme for bold and underline (using the
 backspace character) is active.
@@ -398,7 +397,6 @@ Colors are disabled.
 .
 .
 .TP
-.SM
 .I GROFF_FONT_PATH
 A list of directories in which to search for the
 .BI dev name
diff --git a/src/devices/xditview/gxditview.1.man 
b/src/devices/xditview/gxditview.1.man
index 2ac96fe..d3bd80f 100644
--- a/src/devices/xditview/gxditview.1.man
+++ b/src/devices/xditview/gxditview.1.man
@@ -478,7 +478,6 @@ SS  
-adobe-symbol-medium-r-normal--*-100-*-*-*-*-adobe-fontspecific\en\e
 .\" ====================================================================
 .
 .TP
-.SM
 .I GROFF_FONT_PATH
 A list of directories in which to search for the
 .BI dev name
diff --git a/src/preproc/pic/pic.1.man b/src/preproc/pic/pic.1.man
index 6520fdb..848a153 100644
--- a/src/preproc/pic/pic.1.man
+++ b/src/preproc/pic/pic.1.man
@@ -864,8 +864,7 @@ Note that GNU
 will always scale a picture by the same amount vertically as well as
 horizontally.
 .
-This is different from the
-.SM DWB
+This is different from the DWB
 2.0
 .B pic
 which may scale a picture by a different amount vertically than
@@ -1311,9 +1310,8 @@ W.\& Richard Stevens,
 .
 Input characters that are invalid for
 .B groff
-(i.e., those with
-.SM ASCII
-code 0, or 013 octal, or between 015 and 037 octal, or between 0200 and 0237
+(i.e., those with ASCII code 0,
+or 013 octal, or between 015 and 037 octal, or between 0200 and 0237
 octal) are rejected even in \*(tx mode.
 .
 .
diff --git a/src/roff/groff/groff.1.man b/src/roff/groff/groff.1.man
index 574fa49..6dc29bc 100644
--- a/src/roff/groff/groff.1.man
+++ b/src/roff/groff/groff.1.man
@@ -35,7 +35,6 @@ groff \- front-end for the groff document formatting system
 .\" ====================================================================
 .\" Environment variable
 .de EnvVar
-.  SM
 .  IR \%\\$1 \\$2
 ..
 .\" ====================================================================
diff --git a/src/roff/nroff/nroff.1.man b/src/roff/nroff/nroff.1.man
index 0ea3dea..1c0b6cd 100644
--- a/src/roff/nroff/nroff.1.man
+++ b/src/roff/nroff/nroff.1.man
@@ -168,14 +168,12 @@ prints a help message.
 .\" ====================================================================
 .
 .TP
-.SM
 .I GROFF_TYPESETTER
 The default device for
 .BR groff .
 If not set (which is the normal case), it defaults to \(oqps\(cq.
 .
 .TP
-.SM
 .I GROFF_BIN_PATH
 A colon separated list of directories in which to search for the
 .B groff
diff --git a/src/roff/troff/troff.1.man b/src/roff/troff/troff.1.man
index 7dfdb40..05024c8 100644
--- a/src/roff/troff/troff.1.man
+++ b/src/roff/troff/troff.1.man
@@ -75,9 +75,7 @@ Whitespace is permitted between a command-line option and its 
argument.
 .
 .TP
 .B \-a
-Generate an
-.SM ASCII
-approximation of the typeset output.
+Generate an ASCII approximation of the typeset output.
 .
 .TP
 .B \-b
@@ -516,7 +514,6 @@ All warnings.
 .\" ====================================================================
 .
 .TP
-.SM
 .I GROFF_TMAC_PATH
 A colon separated list of directories in which to search for
 macro files.
@@ -532,12 +529,10 @@ in unsafe mode, home directory,
 after these.
 .
 .TP
-.SM
 .I GROFF_TYPESETTER
 Default device.
 .
 .TP
-.SM
 .I GROFF_FONT_PATH
 A colon separated list of directories in which to search for the
 .BI dev name
diff --git a/tmac/groff_ms.7.man b/tmac/groff_ms.7.man
index e615741..cf7380c 100644
--- a/tmac/groff_ms.7.man
+++ b/tmac/groff_ms.7.man
@@ -61,8 +61,7 @@ typesetting system.
 The
 .I ms
 macros are mostly compatible with the documented behavior of the 4.3
-.SM BSD
-Unix
+BSD Unix
 .I ms
 macros (see
 .I Differences from troff ms