summaryrefslogtreecommitdiff
path: root/man
diff options
context:
space:
mode:
authoresr <esr>2007-02-04 17:33:08 +0000
committeresr <esr>2007-02-04 17:33:08 +0000
commit2516da6c2b983b954bdfcceaac83519eea30bbee (patch)
treee854543ecc8477dcac61952b28421cfbbf751a8d /man
parent089c5dcc962f16d0cfe569f14a886e1866bf1715 (diff)
downloadgroff-2516da6c2b983b954bdfcceaac83519eea30bbee.tar.gz
Explicit is better than implicit. Get rid of another macro that
obscured what was actually going on.
Diffstat (limited to 'man')
-rw-r--r--man/groff_tmac.man49
1 files changed, 16 insertions, 33 deletions
diff --git a/man/groff_tmac.man b/man/groff_tmac.man
index 5b2032c3..6a076b2a 100644
--- a/man/groff_tmac.man
+++ b/man/groff_tmac.man
@@ -54,13 +54,6 @@ FDL in the main directory of the groff source package.
. nop \)\\$*\)
..
.\" --------------------------------------------------------------------
-.de 'char
-. ds @tmp@ `\f(CR\\$1\f[]'
-. shift
-. Text \\*[@tmp@]\\$*
-. rm @tmp@
-..
-.\" --------------------------------------------------------------------
.de option
. ds @tmp@ \f(CB\\$1\f[]
. shift 1
@@ -533,8 +526,7 @@ intervening space, this looked like a long option preceded by a single
minus \[em] a sensation in the computer stone age.
.
To make this optically working for macro package names, all classical
-macro packages choose a name that started with the letter
-.'char m ,
+macro packages choose a name that started with the letter `m',
which was omitted in the naming of the macro file.
.
.
@@ -553,10 +545,8 @@ for short.
.
.
.P
-For similar reasons, macro packages that did not start with an
-.'char m
-had a leading
-.'char m
+For similar reasons, macro packages that did not start with an `m'
+had a leading `m'
added in the documentation and in talking; for example, the package
corresponding to
.I tmac.doc
@@ -573,8 +563,7 @@ command line option for activating this package reads
To cope with all situations, actual versions of
.BR groff (@MAN1EXT@)
are smart about both naming schemes by providing two macro files
-for the inflicted macro packages; one with a leading
-.'char m ,
+for the inflicted macro packages; one with a leading `m'
the other one without it.
.
So in
@@ -593,10 +582,8 @@ macro package may be specified as on of the following four methods:
.
.
.P
-Recent packages that do not start with
-.'char m
-do not use an additional
-.'char m
+Recent packages that do not start with `m'
+do not use an additional `m'
in the documentation.
.
For example, the
@@ -645,8 +632,7 @@ In
.IR groff ,
most macro packages are described in\~man pages called
.BR groff_\f[I]name\f[] (@MAN7EXT@),
-with a leading
-.'char m
+with a leading `m'
for the classical packages.
.
.
@@ -779,23 +765,23 @@ abbreviations for those preprocessor commands that should be run
when formatting the document.
.
Mostly, only the letters corresponding to the options for the
-preprocessors are recognized,
-.'char e
+preprocessors are recognized,
+`e'
(for
.BR eqn ),
-.\" 'char G ,
-.\" 'char g ,
-.'char p ,
+.\" `G',
+.\" `g',
+`p`
(for
.BR pic ),
-.'char R
+`R'
(for
.BR refer ),
-.'char s
+`s'
(for
.BR soelim ),
and
-.'char t
+`t'
(for
.BR tbl ).
(see
@@ -814,10 +800,7 @@ The
.I man
program handles some preprocessors automatically, such that in
man\~pages only the following characters should be used:
-.'char e ,
-.'char p ,
-and
-.'char t .
+`e', `p', and `t'.
.
.
..