[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[groff] 02/09: man pages: Use neutral quotes in code specimens.
From: |
G. Branden Robinson |
Subject: |
[groff] 02/09: man pages: Use neutral quotes in code specimens. |
Date: |
Wed, 21 Oct 2020 02:44:44 -0400 (EDT) |
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
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [groff] 02/09: man pages: Use neutral quotes in code specimens.,
G. Branden Robinson <=