[groff] 02/09: man pages: Use neutral quotes in code specimens.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit cc7971dfc0865893e5bc95584e5e0b80ae00d664
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Mon Oct 19 02:40:51 2020 +1100

    man pages: Use neutral quotes in code specimens.
---
 contrib/mm/groff_mm.7.man       |  4 +--
 contrib/mom/groff_mom.7.man     | 10 +++---
 man/groff.7.man                 |  4 +--
 man/groff_diff.7.man            |  8 ++---
 man/groff_out.5.man             |  2 +-
 man/groff_tmac.5.man            |  2 +-
 man/roff.7.man                  |  2 +-
 src/devices/grolbp/grolbp.1.man |  2 +-
 src/devices/grolj4/grolj4.1.man |  2 +-
 src/devices/gropdf/gropdf.1.man | 78 +++++++++++++++++++++++++----------------
 src/devices/grops/grops.1.man   | 29 ++++++++-------
 src/preproc/refer/refer.1.man   | 12 ++++---
 tmac/groff_man.7.man.in         |  2 +-
 tmac/groff_www.7.man            |  2 +-
 14 files changed, 90 insertions(+), 69 deletions(-)

diff --git a/contrib/mm/groff_mm.7.man b/contrib/mm/groff_mm.7.man
index 45978e7..69178d1 100644
--- a/contrib/mm/groff_mm.7.man
+++ b/contrib/mm/groff_mm.7.man
@@ -2454,7 +2454,7 @@ The argument should be specified as
 .
 .RS
 .IP
-.RI \[dq]' left-part ' center-part ' right-part '\[dq]
+.RI \[dq]\[aq] left-part \[aq] center-part \[aq] right-part \[aq]\[dq]
 .RE
 .
 .IP
@@ -2473,7 +2473,7 @@ The default argument is
 .
 .RS
 .IP
-\[dq]''- % -''\[dq]
+\[dq]\[aq]\[aq]- % -\[aq]\[aq]\[dq]
 .RE
 .
 .IP
diff --git a/contrib/mom/groff_mom.7.man b/contrib/mom/groff_mom.7.man
index 5a9739d..3869806 100644
--- a/contrib/mom/groff_mom.7.man
+++ b/contrib/mom/groff_mom.7.man
@@ -1113,7 +1113,7 @@ you should do:
 \&.TAB 1
 \&.PT_SIZE 24
 \&.ALD 3p
-\&\[rs]" You can't use \[rs]*[UP] or \[rs]*[DOWN] with \[rs]*[RULE].
+\&\[rs]" You can\[aq]t use \[rs]*[UP] or \[rs]*[DOWN] with \[rs]*[RULE].
 \&.RLD 3p
 \&.TQ
 .EE
@@ -1846,8 +1846,8 @@ only.
 \&.JUSTIFY
 \&.KERN
 \&.SS 0
-\&.IL \[rs]w'\[rs]0\[rs]0.'
-\&.HI \[rs]w'\[rs]0\[rs]0.'
+\&.IL \[rs]w\[aq]\[rs]0\[rs]0.\[aq]
+\&.HI \[rs]w\[aq]\[rs]0\[rs]0.\[aq]
 1.\[rs]0The most important point to be considered is whether
 the answer to the meaning of Life, the Universe, and
 Everything really is 42.  We have no one\[aq]s word on the
@@ -2032,7 +2032,7 @@ which case no unit of measure is required.
 For example,
 .RS
 .EX
-.B .IL \[rs]w'margarine'
+.B .IL \[rs]w\[aq]margarine\[aq]
 .EE
 .RE
 indents text by the width of the word
@@ -2166,7 +2166,7 @@ is required.
 For example,
 .RS
 .EX
-.B .IR \[rs]w'jello'
+.B .IR \[rs]w\[aq]jello\[aq]
 .EE
 .RE
 indents text by the width of the word
diff --git a/man/groff.7.man b/man/groff.7.man
index a368a26..ebfa829 100644
--- a/man/groff.7.man
+++ b/man/groff.7.man
@@ -4942,8 +4942,8 @@ Then these lines could look like
 \&.ds u2 in
 \&.ds u3 after
 \&.ie n \[rs]*[u1]\[rs]fI\[rs]*(u2\[rs]fP\[rs]*(u3
-\&.el \[rs]*(u1\[rs]Z\[aq]\[rs]*(u2\[aq]\[rs]v\[aq].25m'\[rs]D\[aq]l \
-\[rs]w\[aq]\[rs]*(u2\[aq]u 0\[aq]\[rs]v\[aq]\-.25m\[aq]\[rs]*(u3
+\&.el \[rs]*(u1\[rs]Z\[aq]\[rs]*(u2\[aq]\[rs]v\[aq].25m\[aq]\[rs]D\
+\[aq]l \[rs]w\[aq]\[rs]*(u2\[aq]u 0\[aq]\[rs]v\[aq]\-.25m\[aq]\[rs]*(u3
 .EE
 .RE
 .
diff --git a/man/groff_diff.7.man b/man/groff_diff.7.man
index 3f5a664..e3b214a 100644
--- a/man/groff_diff.7.man
+++ b/man/groff_diff.7.man
@@ -4138,7 +4138,7 @@ Example:
 .EX
 \&.if t \[rs]{\[rs]
 \&.  de bar
-\&.    nop Hello, I'm \[oq]bar\[cq].
+\&.    nop Hello, I'm \[aq]bar\[aq].
 \&.  .
 \&.\[rs]}
 .EE
@@ -4321,7 +4321,7 @@ changing this.
 .
 .IP
 The corresponding
-.BR \[rs]D'f .\|.\|.\& '
+.BR \[rs]D\[aq]f .\|.\|.\& \[aq]
 command shouldn't be used since its argument is always rounded to an
 integer multiple of the horizontal resolution which can lead to
 surprising results.
@@ -4391,8 +4391,8 @@ does not depend on this.
 .
 Given a drawing command of the form
 .IP
-\f[B]\[rs]D'\f[I]c\f[R] $x sub 1$ $y sub 1$ $x sub 2$ $y sub 2$ $...$ \c
-$x sub n$ $y sub n$\f[B]'\f[R]
+\f[B]\[rs]D\[aq]\f[I]c\f[R] $x sub 1$ $y sub 1$ $x sub 2$ $y sub 2$ \c
+$...$ $x sub n$ $y sub n$\f[B]\[aq]\f[R]
 .
 .P
 where
diff --git a/man/groff_out.5.man b/man/groff_out.5.man
index 4936536..9df6b2d 100644
--- a/man/groff_out.5.man
+++ b/man/groff_out.5.man
@@ -997,7 +997,7 @@ different color schemes.
 These commands are generated by the
 .I groff
 escape sequences
-.BR \*[@backslash]D'F\  .\|.\|. '
+.BR \*[@backslash]D\[aq]F\  .\|.\|. '
 and
 .B \*[@backslash]M
 (with no other corresponding graphics commands).
diff --git a/man/groff_tmac.5.man b/man/groff_tmac.5.man
index a96232d..050e057 100644
--- a/man/groff_tmac.5.man
+++ b/man/groff_tmac.5.man
@@ -524,7 +524,7 @@ image's width.
 .EX
 \&.am PSPIC
 \&.\ \ vpt 0
-\&\[rs]h'(\[rs]\[rs]n[ps-offset]u + \[rs]\[rs]n[ps-deswid]u)'
+\&\[rs]h\[aq](\[rs]\[rs]n[ps-offset]u + \[rs]\[rs]n[ps-deswid]u)\[aq]
 \&.\ \ sp \-1
 \&.\ \ vpt 1
 \&..
diff --git a/man/roff.7.man b/man/roff.7.man
index 4705180..3f6b4a6 100644
--- a/man/roff.7.man
+++ b/man/roff.7.man
@@ -1122,7 +1122,7 @@ This process is not well documented, so here an example:
 .RS
 .P
 .EX
-LESSOPEN='|lesspipe %s'
+LESSOPEN=\[aq]|lesspipe %s\[aq]
 .EE
 .RE
 .
diff --git a/src/devices/grolbp/grolbp.1.man b/src/devices/grolbp/grolbp.1.man
index 06ac664..1eab7f7 100644
--- a/src/devices/grolbp/grolbp.1.man
+++ b/src/devices/grolbp/grolbp.1.man
@@ -101,7 +101,7 @@ For compatibility with
 there is an additional drawing command available:
 .
 .TP
-.BI \eD'R\  dh\ dv '
+.BI \[rs]D\[aq]R\~ "dh dv" \[aq]
 Draw a rule
 (i.e., a solid black rectangle),
 with one corner at the current position,
diff --git a/src/devices/grolj4/grolj4.1.man b/src/devices/grolj4/grolj4.1.man
index cb78dbc..82d64e9 100644
--- a/src/devices/grolj4/grolj4.1.man
+++ b/src/devices/grolj4/grolj4.1.man
@@ -75,7 +75,7 @@ printer.
 There is an additional drawing command available:
 .
 .TP
-.BI \eD'R\  dh\ dv '
+.BI \[rs]D\[aq]R\~ "dh dv" \[aq]
 Draw a rule (solid black rectangle), with one corner at the current
 position, and the diagonally opposite corner at the current position
 .RI +( dh , dv ).
diff --git a/src/devices/gropdf/gropdf.1.man b/src/devices/gropdf/gropdf.1.man
index e10e92b..765e812 100644
--- a/src/devices/gropdf/gropdf.1.man
+++ b/src/devices/gropdf/gropdf.1.man
@@ -151,7 +151,7 @@ is the name of the device, usually
 .BI \-I " dir"
 This option may be used to add a directory to the search path for
 files named in
-.B \[rs]X'pdf: pdfpic'
+.B \[rs]X\[aq]pdf: pdfpic\[aq]
 escape.
 .
 The current directory is always searched first.
@@ -621,10 +621,12 @@ The lower case greek characters are automatically slanted 
(to match
 the SymbolSlanted font (SS) available to PostScript).
 .
 Zapf Dingbats is available as
-.BR ZD ,
-the "hand pointing left" glyph (\[rs][lh]) is available since it has
-been defined using the \[rs]X'pdf: xrev' extension which reverses the
-direction of letters within words.
+.BR ZD ;
+the \[lq]hand pointing left\[rq] glyph
+.RB ( \[rs][lh] )
+is available since it has been defined using the
+.B \[rs]X\[aq]pdf: xrev\[aq]
+extension which reverses the direction of letters within words.
 .
 .
 .LP
@@ -643,11 +645,11 @@ escape sequences supported by
 Specifically, the following is supported.
 .
 .TP
-.B "\[rs]X'ps: invis'"
+.B \[rs]X\[aq]ps: invis\[aq]
 Suppress output.
 .
 .TP
-.B "\[rs]X'ps: endinvis'"
+.B \[rs]X\[aq]ps: endinvis\[aq]
 Stop suppressing output.
 .
 .TP
@@ -663,13 +665,13 @@ command in
 .BR gpic .
 .
 .TP
-.B "\[rs]X'ps: exec grestore'"
+.B \[rs]X\[aq]ps: exec grestore\[aq]
 Again used by
 .B gpic
 to restore after rotation.
 .
 .TP
-.BI "\[rs]X'ps: exec " "n " "setlinejoin'"
+.BI "\[rs]X\[aq]ps: exec " "n\~" "setlinejoin\[aq]"
 where
 .I n
 can be one of the following values.
@@ -681,7 +683,7 @@ can be one of the following values.
 2 = Bevel join
 .
 .TP
-.BI "\[rs]X'ps: exec " "n " "setlinecap'"
+.BI "\[rs]X\[aq]ps: exec " "n " "setlinecap\[aq]"
 where
 .I n
 can be one of the following values.
@@ -695,7 +697,7 @@ can be one of the following values.
 .
 .LP
 .TP
-.B "\[rs]X'ps: ... pdfmark'"
+.BR "\[rs]X\[aq]ps:\~" .\|.\|.\& "\~pdfmark\[aq]"
 All the
 .I pdfmark
 macros installed by using
@@ -731,16 +733,20 @@ These commands are implemented with
 X commands:-
 .LP
 .TP
-.B "\[rs]X'ps: exec %%%%PAUSE"
+.B \[rs]X\[aq]ps: exec %%%%PAUSE\[aq]
 The section before this is treated as a block and is introduced using
-the current BLOCK transition setting
-(see \[oq]pdf: transition\[cq] below).
+the current
+.B BLOCK
+transition setting
+(see
+.RB \[lq] "\[rs]X\[aq]pdf: transition\[aq]" \[rq]
+below).
 .
 This command
 can be introduced using the macro
 .BR .pdfpause .
 .TP
-.B "\[rs]X'ps: exec %%%%BEGINONCE"
+.B \[rs]X\[aq]ps: exec %%%%BEGINONCE\[aq]
 Any text following this command (up to %%%%ENDONCE) is shown only once,
 the next %%%%PAUSE will remove it.
 If producing a non presentation pdf, i.e.\&
@@ -749,7 +755,7 @@ ignoring the pauses, see
 below, this text is ignored.
 .LP
 .TP
-.B "\[rs]X'ps: exec %%%%ENDONCE"
+.B \[rs]X\[aq]ps: exec %%%%ENDONCE\[aq]
 This terminates the block defined by %%%%BEGINONCE.
 This pair of commands
 is what implements the .BLOCKS Once/.BLOCKE commands in present.tmac.
@@ -777,7 +783,7 @@ One
 special used by the DVI driver is also recognised:
 .
 .TP
-.BI \[rs]X'papersize= paper-size '
+.BI \[rs]X\[aq]papersize= paper-size \[aq]
 where the
 .I paper-size
 parameter is the same as the
@@ -805,7 +811,8 @@ tags.
 The following tags are supported:
 .
 .TP
-.BI "\[rs]X'pdf: pdfpic " "file alignment width height line-length" '
+.B \[rs]X\[aq]pdf: pdfpic\~\c
+.IR "file alignment width height line-length" \[aq]
 Place an image of the specified
 .I width
 containing the PDF drawing from file
@@ -846,7 +853,7 @@ height.
 .\" of PostScript graphics.
 .
 .TP
-.B \[rs]X'pdf: xrev'
+.B \[rs]X\[aq]pdf: xrev\[aq]
 This toggles a flag which reverses the direction of printing
 .IR "letter by letter" ,
 i.e., each separate letter is reversed, not the entire word.
@@ -866,18 +873,24 @@ spot\[cq] region).
 Normally this is never used except from within the pdfmark macros.
 .
 .TP
-.B \[rs]X'pdf: markend'
-The macros which support PDF Bookmarks use this call internally to
-stop the definition of bookmark hotspot (user will have called
-\[oq].pdfhref\~L\[cq] with the text which will become the \[oq]hot
-spot\[cq] region).
+.BI "\[rs]X\[aq]pdf: markstart " "/ANN-definition" \[aq]
+.TQ
+.B \[rs]X\[aq]pdf: markend\[aq]
+The macros which support PDF bookmarks use these calls internally to
+start and stop (respectively) the definition of bookmark hot spot;
+the user will have called \[lq].pdfhref\~L\[rq] with the text which will
+become the hot spot region).
+.
+Normally,
+these are never used except from within the
+.I pdfmark
+macros.
 .
-Normally this is never used except from within the pdfmark macros.
 .
 .TP
-.B \[rs]X'pdf: marksuspend'
+.B \[rs]X\[aq]pdf: marksuspend\[aq]
 .TQ
-.B \[rs]X'pdf: markrestart'
+.B \[rs]X\[aq]pdf: markrestart\[aq]
 If you are using page traps to produce headings, footings, etc., you
 need to use these in case a \[oq]hot spot\[cq] crosses a page
 boundary, otherwise any text output by the heading or footing macro
@@ -887,12 +900,15 @@ To stop this happening just place 
\[oq].pdfmarksuspend\[cq] and
 \[oq].pdfmarkrestart\[cq] at the start and end of the page trap macro,
 respectively.
 .
-(These are just convenience macros which emit the \[rs]X code.
+(These are just convenience macros which emit the corresponding
+.B \[rs]X
+escapes.
+.
+These macros must be used only within page traps.)
 .
-These macros must only be used within page traps.)
 .
 .TP
-.BI "\[rs]X'pdf: pagename " name
+.BI "\[rs]X\[aq]pdf: pagename\~" name \[aq]
 This gives the current page a
 .IR name .
 .IP
@@ -904,7 +920,7 @@ The convenience command for this is
 .BR .pdfpagename .
 .
 .TP
-.BI "\[rs]X'pdf: switchtopage " "when name"
+.BI "\[rs]X'pdf: switchtopage\~" "when name" \[aq]
 Normally each new page is appended to the end of the document,
 this command allows following pages to be inserted at a
 .I \[oq]named\[cq]
diff --git a/src/devices/grops/grops.1.man b/src/devices/grops/grops.1.man
index f697d70..958d049 100644
--- a/src/devices/grops/grops.1.man
+++ b/src/devices/grops/grops.1.man
@@ -262,9 +262,9 @@ both on letter (8.5\[mu]11) paper and on A4 paper without 
change.
 .BI \-I dir
 This option may be used to add a directory to the search path for
 files on the command line and files named in
-.B \[rs]X'ps: import'
+.B \[rs]X\[aq]ps: \%import\[aq]
 and
-.B \[rs]X'ps: file'
+.B \[rs]X\[aq]ps: file\[aq]
 escapes.
 .
 The search path is initialized with the current directory.
@@ -821,7 +821,7 @@ only interprets commands that begin with a
 tag.
 .
 .TP
-.BI \[rs]X'ps:\ exec\  code '
+.BI "\[rs]X\[aq]ps: exec\~" code \[aq]
 This executes the arbitrary PostScript commands in
 .IR code .
 .
@@ -846,7 +846,7 @@ For example,
 \&.nr x 1i
 .br
 .B
-\[rs]X'ps: exec \[rs]nx u 0 rlineto stroke'
+\[rs]X\[aq]ps: exec \[rs]nx u 0 rlineto stroke\[aq]
 .br
 .RE
 .
@@ -865,7 +865,9 @@ is on top of the dictionary stack.
 .
 If your code adds definitions to this dictionary,
 you should allocate space for them using
-.BI \[rs]X'ps\ mdef \ n '\fR.
+.BI "\[rs]X\[aq]ps mdef\~" n \[aq]\c
+\&.
+.
 .
 Any definitions persist only until the end of the page.
 .
@@ -917,14 +919,14 @@ This must be supplied by the user, if necessary.
 .RE
 .
 .TP
-.BI \[rs]X'ps:\ file\  name '
+.BI "\[rs]X\[aq]ps: file\~" name \[aq]
 This is the same as the
 .B exec
 command except that the PostScript code is read from file
 .IR name .
 .
 .TP
-.BI \[rs]X'ps:\ def\  code '
+.BI "\[rs]X\[aq]ps: def\~" code \[aq]
 Place a PostScript definition contained in
 .I code
 in the prologue.
@@ -952,7 +954,7 @@ escape sequence with an argument that names a macro,
 can extend over multiple lines.
 .
 .TP
-.BI \[rs]X'ps:\ mdef\  n\ code  '
+.BI "\[rs]X\[aq]ps: mdef\~" "n code" \[aq]
 Like
 .BR def ,
 except that
@@ -1038,9 +1040,9 @@ macro which provides a convenient high-level interface 
for inclusion of
 PostScript graphics.
 .
 .TP
-.B \[rs]X'ps:\ invis'
+.B \[rs]X\[aq]ps: invis\[aq]
 .TQ
-.B \[rs]X'ps:\ endinvis'
+.B \[rs]X\[aq]ps: endinvis\[aq]
 No output is generated for text and drawing commands
 that are bracketed with these
 .B \[rs]X
@@ -1070,9 +1072,10 @@ request
 .IP
 .ft B
 .nf
-\&.char \[rs](em \[rs]X'ps: invis'\[rs]
-\[rs]Z'\[rs]v'-.25m'\[rs]h'.05m'\[rs]D'l .9m 0'\[rs]h'.05m''\[rs]
-\[rs]X'ps: endinvis'\[rs](em
+\&.char \[rs][em] \[rs]X\[aq]ps: invis\[aq]\[rs]
+\[rs]Z\[aq]\[rs]v\[aq]-.25m\[aq]\[rs]h\[aq].05m\[aq]\c
+\[rs]D\[aq]l .9m 0\[aq]\[rs]h\[aq].05m\[aq]\[aq]\[rs]
+\[rs]X\[aq]ps: endinvis\[aq]\[rs][em]
 .ft
 .fi
 .
diff --git a/src/preproc/refer/refer.1.man b/src/preproc/refer/refer.1.man
index bebfb16..111e4ad 100644
--- a/src/preproc/refer/refer.1.man
+++ b/src/preproc/refer/refer.1.man
@@ -235,8 +235,8 @@ see subsection \(lqCommands\(rq below).
 .
 .TP
 .B \-S
-.B
-label\ "(A.n|Q)\ ',\ '\ (D.y|D)"; \%bracket-label\ "\ ("\ )\ ";\ "
+.B label \[dq](A.n|Q) \[aq], \[aq] (D.y|D)\[dq]; \
+\%bracket-\%label \[dq]\ (\[dq]\ )\ \[dq];\ \[dq]
 .
 .
 .TP
@@ -1380,7 +1380,7 @@ is omitted, it defaults to\ 1.
 .
 .
 .TP
-.BI ' string '
+.BI \[aq] string \[aq]
 The characters in
 .I string
 literally.
@@ -1479,8 +1479,10 @@ or last
 upper or lower case letters or digits of
 .IR expr .
 .
-Troff special characters (such as
-.BR \e('a )
+.I roff
+special characters
+(such as
+.BR \e(\[aq]a )
 count as a single letter.
 .
 Accent strings are retained but do not count towards the total.
diff --git a/tmac/groff_man.7.man.in b/tmac/groff_man.7.man.in
index ba76bad..a0fa99c 100644
--- a/tmac/groff_man.7.man.in
+++ b/tmac/groff_man.7.man.in
@@ -3351,7 +3351,7 @@ values.
 \(bu warning: number register \(aqan\-saved\-margin\c
 .IR n "\(aq not defined"
 .TQ
-\(bu warning: number register 'an\-saved\-prevailing\-indent\c
+\(bu warning: number register \(aqan\-saved\-prevailing\-indent\c
 .IR n "\(aq not defined"
 The
 .B .RS
diff --git a/tmac/groff_www.7.man b/tmac/groff_www.7.man
index 0b3ffd2..f920aee 100644
--- a/tmac/groff_www.7.man
+++ b/tmac/groff_www.7.man
@@ -250,7 +250,7 @@ guide
 by:
 .RS
 .IP
-.B .URL pic\[rs]:.html \[dq]Eric Raymond's pic guide\[dq]
+.B .URL pic\[rs]:.html \[dq]Eric Raymond\[aq]s pic guide\[dq]
 .RE
 .
 .TP