[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[groff] 03/05: man pages: Reflow long lines in page sources.
From: |
G. Branden Robinson |
Subject: |
[groff] 03/05: man pages: Reflow long lines in page sources. |
Date: |
Fri, 21 Aug 2020 06:12:16 -0400 (EDT) |
gbranden pushed a commit to branch master
in repository groff.
commit e96bb24d08ad7a95325716f79732cb97316e8ba4
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Fri Aug 21 18:32:26 2020 +1000
man pages: Reflow long lines in page sources.
...and in two tmac files.
Also correct numerous style nits.
* contrib/glilypond/glilypond.1.man: Correct spacing in ps2pdf example.
Stop setting shell prompt in bold in lilypond example (only user
_input_ should be set in bold in examples, and only when something
other than literal user input appears).
* contrib/hdtbl/groff_hdtbl.7.man: Don't capitalize the independent
clause after a colon. Set "groff" in italics.
* contrib/mm/groff_mm.7.man: Recast awkward phrasing "other than X only"
as "if X only". Use "bold-text" as metasyntactic variable name moer
consistently.
* src/devices/gropdf/gropdf.1.man: Fix misplaced ending quote in
syntax synopsis of \X'pdf: transition' (as I understand it, it should
come after the arguments to "transition", not "transition" itself).
* src/devices/grops/grops.1.man: Remove unnecessaary spaces in syntax
synopsis of \X'ps: import'. Add more non-printing break points to
URL.
* src/devices/xditview/gxditview.1.man: Escape hyphens in X Logical Font
Descriptions; they are literals that you can copy and passed as an
option argument to "xfd -fn", for instance.
* src/preproc/grn/grn.1.man: Don't render Sun (as in Microsystems) in
full capitals.
* src/roff/groff/groff.1.man: Hyphenate attributive phrases.
* tmac/groff_me.7.man: Delete word "space" from table line that already
says "line spacing".
* tmac/groff_www.7.man: Refer to macro package simply as "www" instead
of "-mwww" (with leading dash!). I dislike the latter practice,
mostly seen documentation of the s (ms) macros. In my view it
confuses the letter with the envelope and it's bad enough that the
name of a macro package gets slippery when a leading "m" is stuck on
it; we don't need the option dash grafted on as well. This is the
sort of mischief people get up to when a lexical name space is too
small. Set "grohtml" in italics, not bold (and not roman, as was also
used).
---
contrib/gdiffmk/gdiffmk.1.man | 4 +-
contrib/glilypond/glilypond.1.man | 13 +-
contrib/hdtbl/groff_hdtbl.7.man | 94 ++++++++------
contrib/mm/groff_mm.7.man | 40 ++++--
contrib/mm/groff_mmse.7.man | 3 +-
contrib/mom/groff_mom.7.man | 229 ++++++++++++++++++-----------------
contrib/pdfmark/pdfroff.1.man | 24 ++--
man/groff_diff.7.man | 5 +-
src/devices/grodvi/grodvi.1.man | 5 +-
src/devices/gropdf/gropdf.1.man | 68 ++++++-----
src/devices/grops/grops.1.man | 20 +--
src/devices/xditview/gxditview.1.man | 64 ++++++----
src/preproc/eqn/eqn.1.man | 16 ++-
src/preproc/grn/grn.1.man | 38 +++---
src/preproc/pic/pic.1.man | 39 +++---
src/preproc/refer/refer.1.man | 34 ++++--
src/preproc/soelim/soelim.1.man | 7 +-
src/roff/groff/groff.1.man | 16 ++-
tmac/an-old.tmac | 3 +-
tmac/devtag.tmac | 18 +--
tmac/groff_man.7.man.in | 4 +-
tmac/groff_me.7.man | 2 +-
tmac/groff_www.7.man | 55 +++++----
23 files changed, 479 insertions(+), 322 deletions(-)
diff --git a/contrib/gdiffmk/gdiffmk.1.man b/contrib/gdiffmk/gdiffmk.1.man
index 6e186b9..a741648 100644
--- a/contrib/gdiffmk/gdiffmk.1.man
+++ b/contrib/gdiffmk/gdiffmk.1.man
@@ -107,8 +107,8 @@ Clearly both cannot be
.
.
.LP
-Note that the output is not necessarily compatible with all macro packages
-and all preprocessors.
+Note that the output is not necessarily compatible with all macro
+packages and all preprocessors.
.
See section \(lqBugs\(rq below.
.
diff --git a/contrib/glilypond/glilypond.1.man
b/contrib/glilypond/glilypond.1.man
index 44512e1..40bb233 100644
--- a/contrib/glilypond/glilypond.1.man
+++ b/contrib/glilypond/glilypond.1.man
@@ -227,7 +227,9 @@ Normally all
.I EPS
files are sent to the temporary directory.
.
-With this option, you can generate your own directory, in which all useful
+With this option,
+you can generate your own directory,
+in which all useful
.I EPS
files are send.
.
@@ -728,7 +730,10 @@ This is done by the
program using
.RS
.EX
-\fR$ \fP \fBpdf2ps\fP \fIfile-name\fP \fB.pdf\fP \fIfile-name\fP \fB.ps\fP
+$\~\c
+.B pdf2ps\~\c
+.IB file-name .pdf\~\c
+.IB file-name .pds
.EE
.RE
.
@@ -797,7 +802,9 @@ program into many files of different formats, including
files, using
.RS
.EX
-.BI "$ lilypond \-\-ps \-dbackend=eps \-dgs\-load\-fonts \-\-output="
file\-name
+$\~\c
+.B lilypond \-\-ps \-dbackend=eps \-dgs\-load\-fonts \-\-output=\c
+.I file-name
.EE
.RE
for each
diff --git a/contrib/hdtbl/groff_hdtbl.7.man b/contrib/hdtbl/groff_hdtbl.7.man
index 88beb99..91a76ac 100644
--- a/contrib/hdtbl/groff_hdtbl.7.man
+++ b/contrib/hdtbl/groff_hdtbl.7.man
@@ -29,8 +29,8 @@ groff_hdtbl \- Heidelberger table macros for GNU roff
.ig
Some simple formatting macros. Note that we use '.ig' here and not a
comment to make 'mandb' 2.4.1 (and probably more recent versions also)
- happy; otherwise the '.char' lines and the stuff which follows is included
- in the 'whatis' database.
+ happy; otherwise the '.char' lines and the stuff which follows is
+ included in the 'whatis' database.
..
.
.
@@ -167,15 +167,16 @@ groff_hdtbl \- Heidelberger table macros for GNU roff
.
The
.B hdtbl
-macros consist of four base and three optional macros, controlled by about
-twenty arguments.
+macros consist of four base and three optional macros,
+controlled by about twenty arguments.
.
The syntax is simple and similar to the
.B HTML
-table model and nearly as flexible: You can write sequences of tokens (macro
-calls with their arguments and content data), separated by blanks and
-beginning with a macro call, into the same line to get compact and cleanly
-arrranged input.
+table model and nearly as flexible:
+you can write sequences of tokens
+(macro calls with their arguments and content data),
+separated by blanks and beginning with a macro call,
+into the same line to get compact and cleanly arrranged input.
.
An advantage of
.B hdtbl
@@ -207,8 +208,10 @@ First of all, you must load the
.I hdtbl.tmac
file.
.
-As with nearly all other groff macro packages, there are two possibilities
-to do so:
+As with nearly all other
+.I groff
+macro packages,
+there are two possibilities to do so:
.
Either add the line
.
@@ -372,11 +375,13 @@ argument, see below).
.
.
.PP
-The contents of a table cell is arbitrary; for example, it can be another
-table, without restriction to the nesting depth.
+The contents of a table cell is arbitrary;
+for example,
+it can be another table,
+without restriction to the nesting depth.
.
-A given table layout can be either constructed with suitably nested tables
-or with proper arguments to
+A given table layout can be either constructed with suitably nested
+tables or with proper arguments to
.CR .TD
and
.CR .TH\c
@@ -486,8 +491,10 @@ Here the latter table in a more compact form.
.
.
.PP
-If a macro has one or more arguments (see below), and it is not starting a
-line, everything belonging to this macro including the macro itself must be
+If a macro has one or more arguments
+(see below),
+and it is not starting a line,
+everything belonging to this macro including the macro itself must be
enclosed in double quotes.
.
.
@@ -535,8 +542,9 @@ Another possible form is
.
.
.PP
-However, this is limited to the case where the macro is the first one in the
-line and not already enclosed in double quotes.
+However,
+this is limited to the case where the macro is the first one in the line
+and not already enclosed in double quotes.
.
.
.PP
@@ -614,7 +622,8 @@ Border color.
.XAA cols= m
Number of table columns.
.
-This argument is necessary if more than one column is in the table and no
+This argument is necessary if more than one column is in the table and
+no
.CR \[oq]width\[cq]
arguments are present.
.
@@ -657,11 +666,12 @@ Widths of table cells.
.CI n
or natural numbers with the pseudo-scaling indicator
.CR \[oq]%\[cq]\c
-, with the meaning \[lq]percent of the actual line length (or column length
-for inner tables, respectively)\[rq].
+, with the meaning \[lq]percent of the actual line length
+(or column length for inner tables,
+respectively)\[rq].
.
-If there are less width values than table columns, the last width value is
-used for the remaining cells.
+If there are less width values than table columns,
+the last width value is used for the remaining cells.
.
The argument
.
@@ -675,8 +685,8 @@ for example indicates that the first column is 1.5\~inches
wide; the
remaining columns take 1/10 of the column length each.
.
.XDEF
-The table width equals the outer line length or column length; the columns
-have equal widths.
+The table width equals the outer line length or column length;
+the columns have equal widths.
.
.XAA height= n
Height of the table.
@@ -789,9 +799,10 @@ cells left and right of this column.
.
.IP
.B Remark:
-Overlapping of column and row spanning, as in the following table fragment
-(the overlapping happens in the second cell in the second row), is invalid
-and causes incorrect results.
+Overlapping of column and row spanning,
+as in the following table fragment
+(the overlapping happens in the second cell in the second row),
+is invalid and causes incorrect results.
.
.RS
.IP
@@ -905,9 +916,9 @@ If the argument
.CR \[oq]hold\[cq]
is given, the table is held until it is freed by calling the macro
.CR .t*free\c
-, which in turn prints the table immediately, either at the current position
-or at the top of the next page if its height is larger than the remaining
-space on the page.
+, which in turn prints the table immediately,
+either at the current position or at the top of the next page if its
+height is larger than the remaining space on the page.
.
.IP \[bu] 3
Otherwise, if the table is higher than the remaining space on the page,
@@ -952,7 +963,8 @@ macro.
.
.
.\" ====================================================================
-.SS "Arguments common to \f[CB].TBL\f[], \f[CB].TR\f[], \f[CB].TD\f[], and
\f[CB].TH\f[]"
+.SS "Arguments common to \f[CB].TBL\f[], \f[CB].TR\f[], \f[CB].TD\f[], \
+and \f[CB].TH\f[]"
.\" ====================================================================
.
The arguments described in this section can be specified with the
@@ -961,8 +973,11 @@ and
.CR .TR
macros, but they are eventually passed on to the table cells.
.
-If omitted, the defaults take place, which the user can change by setting
-the corresponding default registers or strings, as documented below.
+If omitted,
+the defaults take place,
+which the user can change by setting the corresponding default registers
+or strings,
+as documented below.
.
Setting an argument with the
.CR .TBL
@@ -1032,8 +1047,8 @@ As with
.CR .ft
request the
.CR \[oq]fst\[cq]
-argument can be used to specify the font family and font style together, for
-example
+argument can be used to specify the font family and font style together,
+for example
.CR \[oq]fst=HNBI\[cq]
instead of
.CR \[oq]ff=HN\[cq]
@@ -1114,7 +1129,8 @@ this is a separator line to the cell below.
: a double separator line.
.
.IP
-The thickness of the separator lines is the half of the border thickness,
+The thickness of the separator lines is the half of the border
+thickness,
but at least 0.1\~inches.
.
The distance between the double lines is equal to the line thickness.
@@ -1125,8 +1141,8 @@ Together with
.CR \[oq]border=0\[cq]
for proper formatting the value of
.CR \[oq]csp\[cq]
-must be at least .05\~inches for single separator lines and .15\~inches for
-double separator lines.
+must be at least .05\~inches for single separator lines and .15\~inches
+for double separator lines.
.
.XDEFS hl=s t*hl
.
diff --git a/contrib/mm/groff_mm.7.man b/contrib/mm/groff_mm.7.man
index 195588e..3f34807 100644
--- a/contrib/mm/groff_mm.7.man
+++ b/contrib/mm/groff_mm.7.man
@@ -91,7 +91,6 @@ is the ISO 3166 two-letter code for the
(as used for the output format localization).
.
.
-.\"########################################################################
.LP
A file called
.I locale
@@ -383,7 +382,7 @@ otherwise it is printed on page\~1 without a cover sheet.
T}
1@Abstract is only printed on the cover sheet (\fBMT 4\fP only).
2@T{
-Abstract is printed only on the cover sheet (other than \fBMT 4\fP only).
+Abstract is printed only on the cover sheet (if not \fBMT 4\fP).
The cover sheet is printed without a need for \fBCS\fP.
T}
.TE
@@ -416,7 +415,16 @@ must appear just after each
The title shows up after the name in the signature block.
.
.TP
-.BI AU\ "\fR[\fPname \fR[\fPinitials \fR[\fPloc \fR[\fPdept \fR[\fPext
\fR[\fProom \fR[\fParg \fR[\fParg \fR[\fParg\fR]]]]]]]]]\fP"
+.B AU\~\c
+.RI [ name\~\c
+.RI [ initials\~\c
+.RI [ loc\~\c
+.RI [ dept\~\c
+.RI [ ext\~\c
+.RI [ room\~\c
+.RI [ arg1\~\c
+.RI [ arg2\~\c
+.RI [ arg3\~ ]]]]]]]]]
Author information.
.
Specifies the author of the memo or paper, and is printed on the cover
@@ -449,7 +457,10 @@ Letter signature.
Generates a line with place for signature.
.
.TP
-.BI B\ "\fR[\fPbold-text \fR[\fPprev-font-text \fR[\fPbold \fR[.\|.\|.]]]]\fP"
+.B B\~\c
+.RI [ bold-text\~\c
+.RI [ prev-font-text\~\c
+.RI [ bold-text\~ .\|.\|.\&]]]
Begin boldface.
.
No limit on the number of arguments.
@@ -495,7 +506,8 @@ list item (see
.BR LI ).
.
.I text-indent
-overrides the default indentation of the list items set by number register
+overrides the default indentation of the list items set by number
+register
.BR Pi .
.
A third argument prohibits printing of a blank line before each item.
@@ -598,7 +610,9 @@ or
.BI DF\ "\fR[\fPformat \fR[\fPfill \fR[\fPrindent\fR]]]\fP"
Begin floating display (no nesting allowed).
.
-A floating display is saved in a queue and is printed in the order entered.
+A floating display is saved in a queue and is printed in the order
+entered.
+.
.IR Format ,
.IR fill ,
and
@@ -2054,7 +2068,9 @@ See also string variable
T}
RN@T{
Reference notation.
-Prints \[oq]In reference to:\[cq] and the argument two lines below the date
line.
+Prints \[oq]In reference to:\[cq] and the argument two lines below the
+date line.
+.
See also string variable
.BR LetRN .
T}
@@ -2066,7 +2082,9 @@ See also string variable
T}
SA@T{
Salutation.
-Prints \[cq]To Whom It May Concern:\[cq] or the argument if it was present.
+Prints \[cq]To Whom It May Concern:\[cq] or the argument if it was
+present.
+.
The salutation is printed two lines below the inside address.
See also string variable
.BR LetSA .
@@ -2912,7 +2930,8 @@ This macro is called instead of the normal page header.
.
It is possible to get complete control over the header.
.
-Note that the header and the footer are printed in a separate environment.
+Note that the header and the footer are printed in a separate
+environment.
.
Line length is preserved, though.
.
@@ -3692,7 +3711,8 @@ T}
3@\[oq]section-page\[cq] numbering style enabled.
4@page header is removed on the first page.
5@T{
-\[oq]section-page\[cq] and \[oq]section-figure\[cq] numbering style enabled.
+\[oq]section-page\[cq] and \[oq]section-figure\[cq] numbering style
+enabled.
T}
.TE
.RE
diff --git a/contrib/mm/groff_mmse.7.man b/contrib/mm/groff_mmse.7.man
index 5aff778..224702a 100644
--- a/contrib/mm/groff_mmse.7.man
+++ b/contrib/mm/groff_mmse.7.man
@@ -123,7 +123,8 @@ Anger dokumentbeteckning eller dokumentnummer.
.
.TP
.BI ".LO BET\ " beteckning
-Anger beteckning (�rendebeteckning i form av diarienummer eller liknande).
+Anger beteckning
+(�rendebeteckning i form av diarienummer eller liknande).
.
.TP
.BI ".LO SIDOR\ " antal
diff --git a/contrib/mom/groff_mom.7.man b/contrib/mom/groff_mom.7.man
index 43fc13d..777a8cf 100644
--- a/contrib/mom/groff_mom.7.man
+++ b/contrib/mom/groff_mom.7.man
@@ -631,9 +631,9 @@ begin using an initialized colour inline
move wards in a line
.
.
-.\" ======================================================================
+.\" ====================================================================
.\" BOLDER
-.\" ======================================================================
+.\" ====================================================================
.TP
.B \[rs]*[BOLDER]
.TQ
@@ -653,7 +653,8 @@ Both are inline escapes, therefore they should not appear
as separate
lines, but rather be embedded in text lines, like this:
.RS
.EX
-.FONT R "Not " B \[rs]*[BOLDER] R everything B \[rs]*[BOLDERX] R " is as it
seems."
+.FONT R "Not " B \[rs]*[BOLDER] R everything B \[rs]*[BOLDERX] \
+R " is as it seems."
.EE
.RE
.
@@ -661,7 +662,8 @@ lines, but rather be embedded in text lines, like this:
Alternatively, if you wanted the whole line emboldened, you should do
.RS
.EX
-.FONT B \[rs]*[BOLDER] R "Not everything is as it seems." B \[rs]*[BOLDERX]
+.FONT B \[rs]*[BOLDER] R "Not everything is as it seems." \
+B \[rs]*[BOLDERX]
.EE
.RE
.
@@ -680,18 +682,18 @@ requests.
.RE
.
.
-.\" ======================================================================
+.\" ====================================================================
.\" BU
-.\" ======================================================================
+.\" ====================================================================
.TP
.FONT B \[rs]*[BU I " n" B ]
move characters pairs closer together inline (related to macro
.BR \%.KERN )
.
.
-.\" ======================================================================
+.\" ====================================================================
.\" COND
-.\" ======================================================================
+.\" ====================================================================
.TP
.B \[rs]*[COND]
.TQ
@@ -748,34 +750,34 @@ requests.
.RE
.
.
-.\" ======================================================================
+.\" ====================================================================
.\" CONDSUP
-.\" ======================================================================
+.\" ====================================================================
.TP
.FONT B \[rs]*[CONDSUP] R .\|.\|. B \[rs]*[CONDSUPX]
pseudo-condensed superscript
.
.
-.\" ======================================================================
+.\" ====================================================================
.\" DOWN
-.\" ======================================================================
+.\" ====================================================================
.TP
.FONT B \[rs]*[DOWN I " n" B ]
temporarily move downwards in a line
.
.
-.\" ======================================================================
+.\" ====================================================================
.\" EN-MARK
-.\" ======================================================================
+.\" ====================================================================
.TP
.B \[rs]*[EN\-MARK]
mark initial line of a range of line numbers (for use with line
numbered endnotes)
.
.
-.\" ======================================================================
+.\" ====================================================================
.\" EXT
-.\" ======================================================================
+.\" ====================================================================
.TP
.B \[rs]*[EXT]
.TQ
@@ -834,59 +836,59 @@ requests.
.RE
.
.
-.\" ======================================================================
+.\" ====================================================================
.\" EXTSUP
-.\" ======================================================================
+.\" ====================================================================
.TP
.FONT B \[rs]*[EXTSUP] R .\|.\|. B \[rs]*[EXTSUPX]
pseudo extended superscript
.
.
-.\" ======================================================================
+.\" ====================================================================
.\" FU
-.\" ======================================================================
+.\" ====================================================================
.TP
.FONT B \[rs]*[FU I " n" B ]
move characters pairs further apart inline (related to macro
.BR .KERN )
.
.
-.\" ======================================================================
+.\" ====================================================================
.\" FWD
-.\" ======================================================================
+.\" ====================================================================
.TP
.FONT B \[rs]*[FWD I " n" B ]
move forward in a line
.
.
-.\" ======================================================================
+.\" ====================================================================
.\" LEADER
-.\" ======================================================================
+.\" ====================================================================
.TP
.B \[rs]*[LEADER]
insert leaders at the end of a line
.
.
-.\" ======================================================================
+.\" ====================================================================
.\" RULE
-.\" ======================================================================
+.\" ====================================================================
.TP
.B \[rs]*[RULE]
draw a full measure rule
.
.
-.\" ======================================================================
+.\" ====================================================================
.\" PT_SIZE
-.\" ======================================================================
+.\" ====================================================================
.TP
.FONT B \[rs]*[SIZE I " n" B ]
change the point size inline (related to macro
.BR \%.PT_SIZE )
.
.
-.\" ======================================================================
+.\" ====================================================================
.\" SLANT
-.\" ======================================================================
+.\" ====================================================================
.TP
.B \[rs]*[SLANT]
.TQ
@@ -911,7 +913,8 @@ therefore they should not appear as separate lines, but
rather be
embedded in text lines, like this:
.RS
.EX
-.FONT R "Not " B \[rs]*[SLANT] R everything B \[rs]*[SLANTX] R " is as it
seems."
+.FONT R "Not " B \[rs]*[SLANT] R everything B \[rs]*[SLANTX] \
+R " is as it seems."
.EE
.RE
.
@@ -921,7 +924,8 @@ Alternatively, if you wanted the whole line
you'd do
.RS
.EX
-.FONT B \[rs]*[SLANT] R "Not everything is as it seems." B \[rs]*[SLANTX]
+.FONT B \[rs]*[SLANT] R "Not everything is as it seems." \
+B \[rs]*[SLANTX]
.EE
.RE
.
@@ -942,9 +946,9 @@ To change this behaviour, use the special macro
.RE
.
.
-.\" ======================================================================
+.\" ====================================================================
.\" ST
-.\" ======================================================================
+.\" ====================================================================
.TP
.FONT B \[rs]*[ST I <number> B ] R .\|.\|. B \[rs]*[ST I <number> B X]
Mark positions of string tabs
@@ -986,7 +990,9 @@ above, means the numeric identifier of the tab.
The following shows a sample input line with string tab markers.
.RS
.EX
-.FONT B \[rs]*[ST1] R "Now is the time" B \[rs]*[ST1X] R " for all " B
\[rs]*[ST2] R "good men" B \[rs]*ST2X] R " to come to the aid of the party."
+.FONT B \[rs]*[ST1] R "Now is the time" B \[rs]*[ST1X] R " for all " \
+B \[rs]*[ST2] R "good men" B \[rs]*ST2X] \
+R " to come to the aid of the party."
.EE
.RE
.
@@ -1109,7 +1115,8 @@ you should do:
.B .TAB 1
.B .PT_SIZE 24
.B .ALD 3p
-.B \[rs]*[RULE] \[rs]" Note that you can't use \[rs]*[UP] or \[rs]*[DOWN] with
\[rs]*[RULE]\""
+.B \[rs]*[RULE] \[rs]" Note that you can't use \[rs]*[UP] or \
+\[rs]*[DOWN] with \[rs]*[RULE]\""
.B .RLD 3p
.B .TQ
.EE
@@ -1118,17 +1125,17 @@ you should do:
.RE
.
.
-.\" ======================================================================
+.\" ====================================================================
.\" SUP
-.\" ======================================================================
+.\" ====================================================================
.TP
.FONT B \[rs]*[SUP] R .\|.\|. B \[rs]*[SUPX]
superscript
.
.
-.\" ======================================================================
+.\" ====================================================================
.\" TB+
-.\" ======================================================================
+.\" ====================================================================
.TP
.B \[rs]*[TB+]
Inline escape for
@@ -1136,17 +1143,17 @@ Inline escape for
.RI ( "Tab Next" )
.
.
-.\" ======================================================================
+.\" ====================================================================
.\" UL
-.\" ======================================================================
+.\" ====================================================================
.TP
.FONT B \[rs]*[UL] R .\|.\|. B \[rs]*[ULX]
invoke underlining inline (fixed width fonts only)
.
.
-.\" ======================================================================
+.\" ====================================================================
.\" UP
-.\" ======================================================================
+.\" ====================================================================
.TP
.FONT B \[rs]*[UP I " n" B ]
temporarily move upwards in a line
@@ -1156,17 +1163,17 @@ temporarily move upwards in a line
.SS "Details of macros in alphabetical order"
.\" ====================================================================
.
-.\" ======================================================================
+.\" ====================================================================
.\" AUTOLEAD
-.\" ======================================================================
+.\" ====================================================================
.TP
.B .AUTOLEAD
set the linespacing relative to the point size
.
.
-.\" ======================================================================
+.\" ====================================================================
.\" Bottom Margin
-.\" ======================================================================
+.\" ====================================================================
.TP
.BI .B_MARGIN " <bottom margin>"
Bottom Margin
@@ -1222,9 +1229,9 @@ macros.
.RE
.
.
-.\" ======================================================================
+.\" ====================================================================
.\" Fallback Font
-.\" ======================================================================
+.\" ====================================================================
.TP
.BI \%.FALLBACK_FONT " <fallback font> " "[ ABORT | WARN ]"
Fallback Font
@@ -1352,17 +1359,17 @@ will once again abort on
.RE
.
.
-.\" ======================================================================
+.\" ====================================================================
.\" FAM
-.\" ======================================================================
+.\" ====================================================================
.TP
.BI .FAM " <family>"
Type Family, alias of \fB.FAMILY\fR
.
.
-.\" ======================================================================
+.\" ====================================================================
.\" FAMILY
-.\" ======================================================================
+.\" ====================================================================
.TP
.BI .FAMILY " <family>"
Type Family, alias \fB.FAM\fR
@@ -1583,18 +1590,18 @@ fonts respectively.
.RE
.
.
-.\" ======================================================================
+.\" ====================================================================
.\" FONT
-.\" ======================================================================
+.\" ====================================================================
.TP
.BI ".FONT R | B | BI | " "<any other valid font style>"
Alias to
.B .FT
.
.
-.\" ======================================================================
+.\" ====================================================================
.\" FT
-.\" ======================================================================
+.\" ====================================================================
.TP
.BI ".FT R | B | BI | " "<any other valid font style>"
Set font
@@ -1723,9 +1730,9 @@ font control.
.RE
.
.
-.\" ======================================================================
+.\" ====================================================================
.\" Hanging Indent
-.\" ======================================================================
+.\" ====================================================================
.TP
.BI "\%.HI [" " <measure> " ]
Hanging indent \[em] the optional argument requires a unit of measure.
@@ -1897,9 +1904,9 @@ to see hanging indents in action.
.RE
.
.
-.\" ======================================================================
+.\" ====================================================================
.\" IB - INDENT BOTH
-.\" ======================================================================
+.\" ====================================================================
.TP
.BI "\%.IB [" " <left measure> <right measure> " ]
Indent both \[em] the optional argument requires a unit of measure
@@ -1987,9 +1994,9 @@ and
.RE
.
.
-.\" ======================================================================
+.\" ====================================================================
.\" IL - INDENT LEFT
-.\" ======================================================================
+.\" ====================================================================
.TP
.BI "\%.IL [" " <measure> " ]
Indent left \[em] the optional argument requires a unit of measure
@@ -2061,9 +2068,9 @@ automatically turns off
.RE
.
.
-.\" ======================================================================
+.\" ====================================================================
.\" IQ - quit any/all indents
-.\" ======================================================================
+.\" ====================================================================
.TP
.BI "\%.IQ [" " <measure> " ]
IQ \[em] quit any/all indents
@@ -2123,9 +2130,9 @@ styles at once.
.RE
.
.
-.\" ======================================================================
+.\" ====================================================================
.\" IR - INDENT RIGHT
-.\" ======================================================================
+.\" ====================================================================
.TP
.BI "\%.IR [" " <measure> " ]
Indent right \[em] the optional argument requires a unit of measure
@@ -2195,9 +2202,9 @@ automatically turns off
.RE
.
.
-.\" ======================================================================
+.\" ====================================================================
.\" Left Margin
-.\" ======================================================================
+.\" ====================================================================
.TP
.BI .L_MARGIN " <left margin>"
Left Margin
@@ -2208,7 +2215,8 @@ Left Margin
L_MARGIN establishes the distance from the left edge of the printer
sheet at which you want your type to start.
.
-It may be used any time, and remains in effect until you enter a new value.
+It may be used any time,
+and remains in effect until you enter a new value.
.
.P
Left indents and tabs are calculated from the value you pass to
@@ -2220,7 +2228,9 @@ A unit of measure is required.
.
Decimal fractions are allowed.
.
-Therefore, to set the left margin at 3 picas (1/2 inch), you'd enter either
+Therefore,
+to set the left margin at 3 picas (1/2 inch),
+you'd enter either
.RS
.EX
.B .L_MARGIN 3P
@@ -2257,9 +2267,9 @@ macros.
.RE
.
.
-.\" ======================================================================
+.\" ====================================================================
.\" MCO - BEGIN MULTI-COLUMN SETTING
-.\" ======================================================================
+.\" ====================================================================
.TP
.B .MCO
Begin multi-column setting.
@@ -2292,9 +2302,9 @@ macro in the document processing macros.
.RE
.
.
-.\" ======================================================================
+.\" ====================================================================
.\" MCR - RETURN TO TOP OF COLUMN
-.\" ======================================================================
+.\" ====================================================================
.TP
.B \%.MCR
Once you've turned
@@ -2306,9 +2316,9 @@ at any time, returns you to the
.IR "top of your columns".
.
.
-.\" ======================================================================
+.\" ====================================================================
.\" MCX - EXIT MULTI-COLUMNS
-.\" ======================================================================
+.\" ====================================================================
.TP
.BI "\%.MCX [ " "<distance to advance below longest column>" " ]"
Optional argument requires a unit of measure.
@@ -2385,9 +2395,9 @@ below the baseline of the longest column.
.RE
.
.
-.\" ======================================================================
+.\" ====================================================================
.\" Start a new Page
-.\" ======================================================================
+.\" ====================================================================
.TP
.B .NEWPAGE
.
@@ -2406,9 +2416,9 @@ a new one (subject to the top margin set with
.RE
.
.
-.\" ======================================================================
+.\" ====================================================================
.\" Page
-.\" ======================================================================
+.\" ====================================================================
.TP
.BI ".PAGE " <width> " [ " <length> " [ " <lm> " [ " <rm> " [ " \
<tm> " [ " <bm> " ] ] ] ] ]"
@@ -2469,7 +2479,9 @@ would look like this:
.RE
.
.P
-Now suppose you also want to set the top margin, say, at 1\(en1/2 inches.
+Now suppose you also want to set the top margin,
+say,
+at 1\(en1/2 inches.
.
.I <tm>
comes after
@@ -2535,9 +2547,9 @@ dimensions and margins.
.RE
.
.
-.\" ======================================================================
+.\" ====================================================================
.\" Page Length
-.\" ======================================================================
+.\" ====================================================================
.TP
.BI .PAGELENGTH " <length of printer sheet>"
tells
@@ -2566,9 +2578,9 @@ information on ensuring groff respects your
.RE
.
.
-.\" ======================================================================
+.\" ====================================================================
.\" Page Width
-.\" ======================================================================
+.\" ====================================================================
.TP
.BI .PAGEWIDTH " <width of printer sheet>"
.
@@ -2602,9 +2614,9 @@ information on ensuring groff respects your
.RE
.
.
-.\" ======================================================================
+.\" ====================================================================
.\" Paper
-.\" ======================================================================
+.\" ====================================================================
.TP
.BI .PAPER " <paper type>"
provides a convenient way to set the page dimensions for some common
@@ -2633,9 +2645,9 @@ can be one of:
.B .PRINTSTYLE
.
.
-.\" ======================================================================
+.\" ====================================================================
.\" PT_SIZE - POINT SIZE OF TYPE
-.\" ======================================================================
+.\" ====================================================================
.TP
.BI .PT_SIZE " <size of type in points>"
Point size of type, does not require a
@@ -2755,9 +2767,9 @@ with
.RE
.
.
-.\" ======================================================================
+.\" ====================================================================
.\" Right Margin
-.\" ======================================================================
+.\" ====================================================================
.TP
.BI .R_MARGIN " <right margin>"
Right Margin
@@ -2780,7 +2792,8 @@ and/or
.
The reason is that
.B .R_MARGIN
-calculates line length from the overall page dimensions and the left margin.
+calculates line length from the overall page dimensions and the left
+margin.
.
.P
Obviously, it can't make the calculation if it doesn't know the page
@@ -2864,9 +2877,9 @@ macros.
.RE
.
.
-.\" ======================================================================
+.\" ====================================================================
.\" ST - Set String Tabs
-.\" ======================================================================
+.\" ====================================================================
.TP
.FONT B .ST I " <tab number> " B "L | R | C | J [ QUAD ]"
.
@@ -2926,9 +2939,9 @@ If you want it to be justified, enter
.RE
.
.
-.\" ======================================================================
+.\" ====================================================================
.\" TAB - Call Tabs
-.\" ======================================================================
+.\" ====================================================================
.TP
.BI \%.TAB " <tab number>"
After
@@ -3055,18 +3068,18 @@ Broccoli
.
.RE
.
-.\" ======================================================================
+.\" ====================================================================
.\" TB - Call Tabs Alias
-.\" ======================================================================
+.\" ====================================================================
.TP
.BI .TB " <tab number>"
Alias to
.B .TAB
.
.
-.\" ======================================================================
+.\" ====================================================================
.\" TI - TEMPORARY (LEFT) INDENT
-.\" ======================================================================
+.\" ====================================================================
.TP
.BI "\%.TI [" " <measure> " ]
Temporary left indent \[em] the optional argument requires a
@@ -3138,9 +3151,9 @@ is exactly
.
.
.
-.\" ======================================================================
+.\" ====================================================================
.\" TN - Tab Next
-.\" ======================================================================
+.\" ====================================================================
.TP
.B .TN
Tab Next
@@ -3250,9 +3263,9 @@ following
.RE
.
.
-.\" ======================================================================
+.\" ====================================================================
.\" Tab Quit
-.\" ======================================================================
+.\" ====================================================================
.TP
.B .TQ
.B TQ
@@ -3270,9 +3283,9 @@ that were in effect prior to invoking any
.IR tabs .
.
.
-.\" ======================================================================
+.\" ====================================================================
.\" Top Margin
-.\" ======================================================================
+.\" ====================================================================
.TP
.BI .T_MARGIN " <top margin>"
Top margin
diff --git a/contrib/pdfmark/pdfroff.1.man b/contrib/pdfmark/pdfroff.1.man
index c24112f..bd363cd 100644
--- a/contrib/pdfmark/pdfroff.1.man
+++ b/contrib/pdfmark/pdfroff.1.man
@@ -109,14 +109,15 @@ processing, when applied to suitably marked up
.B groff
source files,
such that tables of contents and body text are formatted separately,
-and are subsequently combined in the correct order, for final publication
-as a single PDF document.
+and are subsequently combined in the correct order,
+for final publication as a single PDF document.
.
A further optional
\*(lqstyle sheet\*(rq
capability is provided;
-this allows for the definition of content which is required to precede the
-table of contents, in the published document.
+this allows for the definition of content which is required to precede
+the table of contents,
+in the published document.
.
.P
For each invocation of
@@ -197,7 +198,8 @@ Consequently,
.B pdfroff
accepts all options and arguments, as specified in
.BR groff (@MAN1EXT@),
-which may also be considered as the definitive reference for all standard
+which may also be considered as the definitive reference for all
+standard
.B pdfroff
options and argument usage.
.
@@ -322,9 +324,11 @@ to create a reference dictionary, for use in a different
document.
.
.TP
.B \-\-no\-reference\-dictionary
-May be used to eliminate the overhead of creating a reference dictionary,
+May be used to eliminate the overhead of creating a reference
+dictionary,
when it is known that the target PDF document contains no public
-references, created by the
+references,
+created by the
.I pdfhref
macro.
.
@@ -366,8 +370,10 @@ to encode the document name in a generated reference
dictionary.
.
.TP
.BI \-\-reference\-dictionary= name
-Specifies the name to be used for the generated reference dictionary file;
-if unspecified, the reference dictionary is created in a temporary file,
+Specifies the name to be used for the generated reference dictionary
+file;
+if unspecified,
+the reference dictionary is created in a temporary file,
which is deleted when
.B pdfroff
completes processing of the current document.
diff --git a/man/groff_diff.7.man b/man/groff_diff.7.man
index 7997ca1..8c01904 100644
--- a/man/groff_diff.7.man
+++ b/man/groff_diff.7.man
@@ -1184,8 +1184,9 @@ have certain properties associated with them.
.
In
.IR groff ,
-a glyph is a numbered box with a given height above and depth below the
baseline, and
-a width\[em]nothing more.)
+a glyph is a numbered box with a given height above and depth below the
+baseline,
+and a width\[em]nothing more.)
.
These properties can be modified with this request.
.
diff --git a/src/devices/grodvi/grodvi.1.man b/src/devices/grodvi/grodvi.1.man
index c56f3d9..1d42550 100644
--- a/src/devices/grodvi/grodvi.1.man
+++ b/src/devices/grodvi/grodvi.1.man
@@ -370,8 +370,9 @@ is used instead of
.BR CW .
.
.LP
-Finally, the symbol fonts of the American Mathematical Society are available
-as special fonts
+Finally,
+the symbol fonts of the American Mathematical Society are available as
+special fonts
.B SA
(msam10) and
.B SB
diff --git a/src/devices/gropdf/gropdf.1.man b/src/devices/gropdf/gropdf.1.man
index 3f56190..e41826f 100644
--- a/src/devices/gropdf/gropdf.1.man
+++ b/src/devices/gropdf/gropdf.1.man
@@ -216,7 +216,8 @@ or have no CMap at all by omitting the argument.
.\" .IR n \~\c
.\" thousandths of an em.
.\" .
-.\" If this option is not given, the line thickness defaults to 0.04\~em.
+.\" If this option is not given, the line thickness defaults to
+.\" 0.04\~em.
.\" .
.\" .
.TP
@@ -273,8 +274,8 @@ PDF.
.
.LP
.B gropdf
-supports the concept of foundries, that is different versions of basically
-the same font.
+supports the concept of foundries,
+that is different versions of basically the same font.
.
During install a
.I Foundry
@@ -324,9 +325,9 @@ This restriction will be lifted in a later version.
.\" .B grops
.\" is able to display all glyphs in a PostScript font, not only 256.
.\" .I enc_file
-.\" (or the default encoding if no encoding file specified) just defines the
-.\" order of glyphs for the first 256 characters; all other glyphs are
-.\" accessed with additional encoding vectors which
+.\" (or the default encoding if no encoding file specified) just defines
+.\" the order of glyphs for the first 256 characters;
+.\" all other glyphs are accessed with additional encoding vectors which
.\" .B grops
.\" produces on the fly.
.
@@ -650,10 +651,12 @@ Suppress output.
Stop suppressing output.
.
.TP
-.B "\[rs]X'ps: exec gsave currentpoint 2 copy translate \fIn\fP rotate neg
exch neg exch translate'"
+.BI "\[rs]X\[aq]ps: exec gsave currentpoint 2 copy translate\~" n\~\c
+.B rotate neg exch neg exch translate\[aq]
where
.I n
is the angle of rotation.
+.
This is to support the
.I align
command in
@@ -729,8 +732,10 @@ X commands:-
.LP
.TP
.B "\[rs]X'ps: exec %%%%PAUSE"
-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 section before this is treated as a block and is introduced using
+the current BLOCK transition setting
+(see \[oq]pdf: transition\[cq] below).
+.
This command
can be introduced using the macro
.BR .pdfpause .
@@ -787,8 +792,8 @@ This means that you can alter the page size at will within
the PDF file
being created by
.BR gropdf .
.
-If you do want to change the paper size, it must be done before you start
-creating the page.
+If you do want to change the paper size,
+it must be done before you start creating the page.
.
.LP
In addition,
@@ -829,15 +834,16 @@ greater than the width of the drawing is required as well.
.
If
.I width
-is specified as zero then the width is scaled in proportion to the height.
+is specified as zero then the width is scaled in proportion to the
+height.
.
.\" .IP
.\" See
.\" .BR groff_tmac (@MAN7EXT@)
.\" for a description of the
.\" .B PSPIC
-.\" macro which provides a convenient high-level interface for inclusion of
-.\" PostScript graphics.
+.\" macro which provides a convenient high-level interface for inclusion
+.\" of PostScript graphics.
.
.TP
.B \[rs]X'pdf: xrev'
@@ -845,7 +851,8 @@ 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.
.
-This is useful for reversing the direction of glyphs in the Dingbats font.
+This is useful for reversing the direction of glyphs in the Dingbats
+font.
.
To return to normal printing repeat the command again.
.
@@ -898,8 +905,8 @@ The convenience command for this is
.
.TP
.BI "\[rs]X'pdf: switchtopage " "when name"
-Normally each new page is appended to the end of the document, this command
-allows following pages to be inserted at a
+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]
position within the document (see pagename command above).
.I \[oq]when\[cq]
@@ -910,20 +917,24 @@ If it is ommitted it defaults to
.IP
The convenience command for this is
.BR .pdfswitchtopage .
-It should be used at the end of the page before you want the switch to happen.
+It should be used at the end of the page before you want the switch to
+happen.
.IP
-This allows pages such as a TOC to be moved to elsewhere in the document, but
-more esoteric uses are possible.
+This allows pages such as a TOC to be moved to elsewhere in the
+document,
+but more esoteric uses are possible.
.
.TP
-.BR "\[rs]X'pdf: transition'" "feature mode duration dimension motion
direction scale bool"
+.B \[rs]X\[aq]pdf: transition\~\c
+.IB "feature mode duration dimension motion direction scale bool" \[aq]
where
.IP
.I feature
can be either SLIDE or BLOCK.
When it is SLIDE the transition is used
-when a new slide is introduced to the screen, if BLOCK then this transition
-is used for the individual blocks which make up the slide.
+when a new slide is introduced to the screen,
+if BLOCK then this transition is used for the individual blocks which
+make up the slide.
.br
.I mode
is the transition type between slides:-
@@ -965,9 +976,9 @@ entry, revealing the new page.
- The old page dissolves gradually to reveal the new one.
.br
.B Glitter
-- Similar to Dissolve, except that the effect sweeps across the page in a
-wide band moving from one side of the screen to the other in the
-direction specified by the
+- Similar to Dissolve,
+except that the effect sweeps across the page in a wide band moving from
+one side of the screen to the other in the direction specified by the
.I direction
entry.
.br
@@ -1049,8 +1060,9 @@ Outward from the center of the page.
.BR Cover ,
.BR Uncover " and " Push
transition styles only)
-The direction in which the specified transition effect shall moves, expressed
in
-degrees counterclockwise starting from a left-to-right direction.
+The direction in which the specified transition effect shall moves,
+expressed in degrees counterclockwise starting from a left-to-right
+direction.
If the value is a number, it shall be one of:
.B 0
= Left to right,
diff --git a/src/devices/grops/grops.1.man b/src/devices/grops/grops.1.man
index 1d988b6..7bd7d2c 100644
--- a/src/devices/grops/grops.1.man
+++ b/src/devices/grops/grops.1.man
@@ -272,7 +272,8 @@ The search path is initialized with the current directory.
This option may be specified more than once; the directories are then
searched in the order specified (but before the current directory).
.
-If you want to make the current directory be read before other directories,
+If you want to make the current directory be read before other
+directories,
add
.B \-I.\&
at the appropriate place.
@@ -389,8 +390,9 @@ Lines starting with
and blank lines are ignored.
.
The code for each character given in the font file must correspond
-to the code for the character in encoding file, or to the code in the default
-encoding for the font if the PostScript font is not to be reencoded.
+to the code for the character in encoding file,
+or to the code in the default encoding for the font if the PostScript
+font is not to be reencoded.
.
This code can be used with the
.B \[rs]N
@@ -782,8 +784,9 @@ containing slanted lowercase Greek letters taken from PS
Symbol.
.
Zapf Dingbats is available as
.BR ZD ,
-and a reversed version of ZapfDingbats (with symbols pointing in the opposite
-direction) is available as
+and a reversed version of ZapfDingbats
+(with symbols pointing in the opposite direction)
+is available as
.BR ZDR ;
most characters in these fonts are unnamed and must be accessed using
.BR \[rs]N .
@@ -966,7 +969,9 @@ so that it can create an appropriately sized PostScript
dictionary
to contain them.
.
.TP
-.BI \[rs]X'ps:\ import\ file\ llx\ lly\ urx\ ury\ width\ \fR[\fP\ height\
\fR]\fP '
+.BI "\[rs]X\[aq]ps: import\~" "file llx lly urx ury width\~"\c
+.RI [ height ]\c
+.B \[aq]
Import a PostScript graphic from
.IR file .
.
@@ -1509,7 +1514,8 @@ for details on the location of temporary files.
.
.
.LP
-.UR
http://\:partners.adobe.com/\:public/\:developer/\:en/\:ps/\:5001.DSC_Spec.pdf
+.UR http://\:partners\:.adobe\:.com/\:public/\:developer/\:en/\:ps/\
+\:5001\:.DSC_Spec\:.pdf
PostScript Language Document Structuring Conventions Specification
.UE
.
diff --git a/src/devices/xditview/gxditview.1.man
b/src/devices/xditview/gxditview.1.man
index 05b0033..6d823aa 100644
--- a/src/devices/xditview/gxditview.1.man
+++ b/src/devices/xditview/gxditview.1.man
@@ -118,7 +118,9 @@ devices:
.BR \%\-TX75\-12 ,
.BR \%\-TX100 ,
.BR \%\-TX100\-12 .
-They differ by the X\~resolution (75dpi or 100dpi) and the used base font
+They differ by the X\~resolution
+(75dpi or 100dpi)
+and the used base font
size (10pt or 12pt).
.
They are especially built for
@@ -309,8 +311,8 @@ along with the additional options listed below:
.
.TP 8
.B \-help
-This option indicates that a brief summary of the allowed options should be
-printed.
+This option indicates that a brief summary of the allowed options should
+be printed.
.
.TP
.B \-page
@@ -461,25 +463,43 @@ font name, and secondly the X\~font name.
.
The default is
.nf
-"\e
-TR -adobe-times-medium-r-normal--*-100-*-*-*-*-iso8859-1\en\e
-TI -adobe-times-medium-i-normal--*-100-*-*-*-*-iso8859-1\en\e
-TB -adobe-times-bold-r-normal--*-100-*-*-*-*-iso8859-1\en\e
-TBI -adobe-times-bold-i-normal--*-100-*-*-*-*-iso8859-1\en\e
-CR -adobe-courier-medium-r-normal--*-100-*-*-*-*-iso8859-1\en\e
-CI -adobe-courier-medium-o-normal--*-100-*-*-*-*-iso8859-1\en\e
-CB -adobe-courier-bold-r-normal--*-100-*-*-*-*-iso8859-1\en\e
-CBI -adobe-courier-bold-o-normal--*-100-*-*-*-*-iso8859-1\en\e
-HR -adobe-helvetica-medium-r-normal--*-100-*-*-*-*-iso8859-1\en\e
-HI -adobe-helvetica-medium-o-normal--*-100-*-*-*-*-iso8859-1\en\e
-HB -adobe-helvetica-bold-r-normal--*-100-*-*-*-*-iso8859-1\en\e
-HBI -adobe-helvetica-bold-o-normal--*-100-*-*-*-*-iso8859-1\en\e
-NR -adobe-new century
schoolbook-medium-r-normal--*-100-*-*-*-*-iso8859-1\en\e
-NI -adobe-new century
schoolbook-medium-i-normal--*-100-*-*-*-*-iso8859-1\en\e
-NB -adobe-new century
schoolbook-bold-r-normal--*-100-*-*-*-*-iso8859-1\en\e
-NBI -adobe-new century
schoolbook-bold-i-normal--*-100-*-*-*-*-iso8859-1\en\e
-S -adobe-symbol-medium-r-normal--*-100-*-*-*-*-adobe-fontspecific\en\e
-SS -adobe-symbol-medium-r-normal--*-100-*-*-*-*-adobe-fontspecific\en\e
+"\[rs]
+TR \-adobe\-times\-medium\-r\-normal\
+\-\-*\-100\-*\-*\-*\-*\-iso8859\-1\[rs]n\[rs]
+TI \-adobe\-times\-medium\-i\-normal\
+\-\-*\-100\-*\-*\-*\-*\-iso8859\-1\[rs]n\[rs]
+TB \-adobe\-times\-bold\-r\-normal\
+\-\-*\-100\-*\-*\-*\-*\-iso8859\-1\[rs]n\[rs]
+TBI \-adobe\-times\-bold\-i\-normal\
+\-\-*\-100\-*\-*\-*\-*\-iso8859\-1\[rs]n\[rs]
+CR \-adobe\-courier\-medium\-r\-normal\
+\-\-*\-100\-*\-*\-*\-*\-iso8859\-1\[rs]n\[rs]
+CI \-adobe\-courier\-medium\-o\-normal\
+\-\-*\-100\-*\-*\-*\-*\-iso8859\-1\[rs]n\[rs]
+CB \-adobe\-courier\-bold\-r\-normal\
+\-\-*\-100\-*\-*\-*\-*\-iso8859\-1\[rs]n\[rs]
+CBI \-adobe\-courier\-bold\-o\-normal\
+\-\-*\-100\-*\-*\-*\-*\-iso8859\-1\[rs]n\[rs]
+HR \-adobe\-helvetica\-medium\-r\-normal\
+\-\-*\-100\-*\-*\-*\-*\-iso8859\-1\[rs]n\[rs]
+HI \-adobe\-helvetica\-medium\-o\-normal\
+\-\-*\-100\-*\-*\-*\-*\-iso8859\-1\[rs]n\[rs]
+HB \-adobe\-helvetica\-bold\-r\-normal\
+\-\-*\-100\-*\-*\-*\-*\-iso8859\-1\[rs]n\[rs]
+HBI \-adobe\-helvetica\-bold\-o\-normal\
+\-\-*\-100\-*\-*\-*\-*\-iso8859\-1\[rs]n\[rs]
+NR \-adobe\-new century schoolbook\-medium\-r\-normal\
+\-\-*\-100\-*\-*\-*\-*\-iso8859\-1\[rs]n\[rs]
+NI \-adobe\-new century schoolbook\-medium\-i\-normal\
+\-\-*\-100\-*\-*\-*\-*\-iso8859\-1\[rs]n\[rs]
+NB \-adobe\-new century schoolbook\-bold\-r\-normal\
+\-\-*\-100\-*\-*\-*\-*\-iso8859\-1\[rs]n\[rs]
+NBI \-adobe\-new century schoolbook\-bold\-i\-normal\
+\-\-*\-100\-*\-*\-*\-*\-iso8859\-1\[rs]n\[rs]
+S \-adobe\-symbol\-medium\-r\-normal\
+\-\-*\-100\-*\-*\-*\-*\-adobe\-fontspecific\[rs]n\[rs]
+SS \-adobe\-symbol\-medium\-r\-normal\
+\-\-*\-100\-*\-*\-*\-*\-adobe\-fontspecific\[rs]n\[rs]
"
.fi
.
diff --git a/src/preproc/eqn/eqn.1.man b/src/preproc/eqn/eqn.1.man
index 5be7ce1..f8df0dd 100644
--- a/src/preproc/eqn/eqn.1.man
+++ b/src/preproc/eqn/eqn.1.man
@@ -516,7 +516,8 @@ This sets
as an accent under
.IR e1 .
.I e2
-is assumed to be at the correct height for a character without a descender;
+is assumed to be at the correct height for a character without a
+descender;
.I e2
is moved down if
.I e1
@@ -626,7 +627,8 @@ contain the width, height, depth, subscript kern, and skew
of\~\c
.
(The
.I "subscript kern"
-of an object says how much a subscript on that object should be tucked in;
+of an object says how much a subscript on that object should be tucked
+in;
the
.I skew
of an object says how far to the right of the center of the object an
@@ -638,8 +640,8 @@ so that it outputs the desired result with its origin at
the current
point, and increase the current horizontal position by the width
of the object.
.
-The number registers must also be modified so that they correspond to the
-result.
+The number registers must also be modified so that they correspond to
+the result.
.
.IP
For example, suppose you wanted a construct that \[oq]cancels\[cq] an
@@ -866,7 +868,8 @@ Normally,
.B bar
or
.B under
-produces a line whose length is the width of the object to which it applies;
+produces a line whose length is the width of the object to which it
+applies;
in the case of a single character,
this tends to produce a line that looks too long.
.
@@ -1185,7 +1188,8 @@ making it undefined.
.
.
.LP
-Besides the macros mentioned above, the following definitions are available:
+Besides the macros mentioned above,
+the following definitions are available:
.BR Alpha ,
.BR Beta ,
\&.\|.\|.,
diff --git a/src/preproc/grn/grn.1.man b/src/preproc/grn/grn.1.man
index f1a0edd..3998402 100644
--- a/src/preproc/grn/grn.1.man
+++ b/src/preproc/grn/grn.1.man
@@ -192,7 +192,8 @@ even when followed by a character other than space or
newline.
.\"The first time, only the interiors of filled polygons (as borderless
.\"polygons) are printed.
.\"The second time, the outline is printed as a series of line segments.
-.\"This way, postprocessors that overwrite rather than merge picture elements
+.\"This way,
+.\"postprocessors that overwrite rather than merge picture elements
.\"(such as PostScript) can still have text and graphics on a shaded
.\"background.
.
@@ -209,9 +210,11 @@ may have one
.I @g@grn
command.
.
-Commands consist of one or two strings separated by white space, the first
-string being the command and the second its operand.
-Commands may be upper or lower case and abbreviated down to one character.
+Commands consist of one or two strings separated by white space,
+the first string being the command and the second its operand.
+.
+Commands may be upper or lower case and abbreviated down to one
+character.
.
.
.PP
@@ -219,8 +222,8 @@ Commands that affect a picture's environment (those listed
before
.BR default ,
see below) are only in effect for the current picture:
.
-The environment is reinitialized to the defaults at the start of the next
-picture.
+The environment is reinitialized to the defaults at the start of the
+next picture.
.
The commands are as follows:
.TP
@@ -305,8 +308,12 @@ narrow (medium and thick, respectively) lines to
.I N
times 0.15pt (this value can be changed at compile time).
.
-The default is 1.0 (3.0 and 5.0, respectively), which corresponds to 0.15pt
-(0.45pt and 0.75pt, respectively).
+The default is 1.0
+(3.0 and 5.0,
+respectively),
+which corresponds to 0.15pt
+(0.45pt and 0.75pt,
+respectively).
.
A thickness value of zero selects the smallest available line thickness.
.
@@ -639,15 +646,18 @@ Type Specifications in \fIgremlin\fP Files
.TE
.sp
.IP \(bu
-After the object type comes a variable number of lines, each specifying a
-point used to display the element.
+After the object type comes a variable number of lines,
+each specifying a point used to display the element.
+.
Each line contains an x-coordinate and a y-coordinate in floating point
-format, separated by spaces.
-The list of points is terminated by a line containing the string \[lq]\-1.0
-\-1.0\[rq]
+format,
+separated by spaces.
+.
+The list of points is terminated by a line containing the string
+\[lq]\-1.0 \-1.0\[rq]
.RI ( AED
version) or a single asterisk, \[lq]*\[rq]
-.RI ( SUN / X11
+.RI ( Sun / X11
version).
.
.IP \(bu
diff --git a/src/preproc/pic/pic.1.man b/src/preproc/pic/pic.1.man
index 8209d8b..f136a3d 100644
--- a/src/preproc/pic/pic.1.man
+++ b/src/preproc/pic/pic.1.man
@@ -46,8 +46,8 @@
.ie \n(.g .ds ic \/
.el .ds ic \^
.
-.\" The BSD man macros can't handle " in arguments to font change macros,
-.\" so use \(ts instead of ".
+.\" The BSD man macros can't handle " in arguments to font change
+.\" macros, so use \(ts instead of ".
.tr \(ts"\""
.
.
@@ -340,7 +340,8 @@ You can safely use this feature to change fonts or to
change the value of
.BR \ebaselineskip .
.
-Anything else may well produce undesirable results; use at your own risk.
+Anything else may well produce undesirable results;
+use at your own risk.
.
Lines beginning with a period are not given any special treatment.
.
@@ -479,12 +480,21 @@ Include
at this point in the file.
.
.TP
-\fBcopy\fR [\fB"\,\fIfilename\/\fB"\fR] \fBthru\fR \fIX\fR \fIbody\fR \fIX\fR \
-[\fBuntil\fR \fB"\,\fIword\*(ic\fB"\fR]
-.ns
-.TP
-\fBcopy\fR [\fB"\,\fIfilename\/\fB"\fR] \fBthru\fR \fImacro\fR \
-[\fBuntil\fR \fB"\,\fIword\*(ic\fB"\fR]
+.BR copy\~ [ \[dq]\c
+.IB filename \[dq]\c
+.RB ]\~ thru\~\c
+.I X body X\~\c
+.RB [ until\~ \[dq]\c
+.IB word \[dq]\c
+]
+.TQ
+.BR copy\~ [ \[dq]\c
+.IB filename \[dq]\c
+.RB ]\~ thru\~\c
+.I macro\~\c
+.RB [ until\~ \[dq]\c
+.IB word \[dq]\c
+]
This construct does
.I body
once for each line of
@@ -888,12 +898,13 @@ The compass points of a text object are determined by
this box.
The implicit motion associated with the object is also determined
by this box.
.
-The dimensions of this box are taken from the width and height attributes;
-if the width attribute is not supplied then the width will be taken to be
+The dimensions of this box are taken from the width and height
+attributes;
+if the width attribute is not supplied then the width will be taken to
+be
.BR textwid ;
-if the height attribute is not supplied then the height will be taken to be
-the number of text strings associated with the object
-times
+if the height attribute is not supplied then the height will be taken to
+be the number of text strings associated with the object times
.BR textht .
.
Initially
diff --git a/src/preproc/refer/refer.1.man b/src/preproc/refer/refer.1.man
index c90005c..78ef855 100644
--- a/src/preproc/refer/refer.1.man
+++ b/src/preproc/refer/refer.1.man
@@ -124,8 +124,8 @@ such as
or
.IR mm .
.
-The commands to format a citation's reference can be output immediately after
-the citation,
+The commands to format a citation's reference can be output immediately
+after the citation,
or the references may be accumulated,
and the commands output at some later point.
.
@@ -432,7 +432,8 @@ can be used.
.
.TP
.B %E
-For an article that is part of a book, the name of an editor of the book.
+For an article that is part of a book,
+the name of an editor of the book.
.
Where the work has editors and no authors,
the names of the editors should be given as
@@ -540,7 +541,8 @@ only the last such field will be used.
.
.
.LP
-If accent strings are used, they should follow the character to be accented.
+If accent strings are used,
+they should follow the character to be accented.
This means that the
.B AM
macro must be used with the
@@ -628,7 +630,9 @@ this behaviour can be altered using the
and
.B ]
flags.
-Note that leading and trailing spaces are significant for these components.
+.
+Note that leading and trailing spaces are significant for these
+components.
.
.
.LP
@@ -690,7 +694,9 @@ flags rather than including the brackets in
and
.I closing-text
is that
-you can change the style of bracket used in the document just by changing the
+.
+you can change the style of bracket used in the document just by
+changing the
.B bracket-label
command.
.
@@ -710,8 +716,11 @@ line and a warning will be given.
.
.
.LP
-There is no special notation for making a citation to multiple references.
-Just use a sequence of citations, one for each reference.
+There is no special notation for making a citation to multiple
+references.
+.
+Just use a sequence of citations,
+one for each reference.
.
Don't put anything between the citations.
.
@@ -955,7 +964,8 @@ Only one field can be an annotation.
.TP
.BI articles\ string \fR\|.\|.\|.
.IR string \|.\|.\|.\&
-are definite or indefinite articles, and should be ignored at the beginning of
+are definite or indefinite articles,
+and should be ignored at the beginning of
.B T
fields when sorting.
.
@@ -1193,7 +1203,8 @@ of this command is more useful.
.B label-in-text\*n
For each reference output a label in the text.
.
-The label will be separated from the surrounding text as described in the
+The label will be separated from the surrounding text as described in
+the
.B bracket-label
command.
.
@@ -1299,7 +1310,8 @@ each followed by a number,
indicating how many fields with the name should be used for sorting.
.
.B +
-can be used to indicate that all the fields with the name should be used.
+can be used to indicate that all the fields with the name should be
+used.
.
Also
.B .\&
diff --git a/src/preproc/soelim/soelim.1.man b/src/preproc/soelim/soelim.1.man
index 9ad3480..9d4fb70 100644
--- a/src/preproc/soelim/soelim.1.man
+++ b/src/preproc/soelim/soelim.1.man
@@ -97,8 +97,8 @@ ignore the whole line.
.
.
.PP
-Note that there must be no whitespace between the leading dot and the two
-characters \[oq]s\[cq] and \[oq]o\[cq].
+Note that there must be no whitespace between the leading dot and the
+two characters \[oq]s\[cq] and \[oq]o\[cq].
.
Otherwise, only
.B groff
@@ -233,7 +233,8 @@ to source files.
.
.
.PP
-If a file to be sourced should also be preprocessed, it must already be read
+If a file to be sourced should also be preprocessed,
+it must already be read
.I before
the input file passes through the preprocessor.
.
diff --git a/src/roff/groff/groff.1.man b/src/roff/groff/groff.1.man
index fd7f041..7365667 100644
--- a/src/roff/groff/groff.1.man
+++ b/src/roff/groff/groff.1.man
@@ -108,8 +108,8 @@ program allows control of the whole
.I groff
system by command-line options.
.
-This is a great simplification in comparison to the classical case (which
-uses pipes only).
+This is a great simplification in comparison to the classical case
+(which uses pipes only).
.
.
.\" ====================================================================
@@ -202,7 +202,8 @@ The current directory is always searched first.
This option may be specified more than once;
the directories are searched in the order specified.
.
-No directory search is performed for files specified using an absolute path.
+No directory search is performed for files specified using an absolute
+path.
.
This option implies the
.B \-s
@@ -447,7 +448,10 @@ postprocessor is
.
.TP
lj4
-HP LaserJet4 compatible (or other PCL5 compatible) printers (postprocessor
+HP LaserJet4-compatible
+(or other PCL5-compatible)
+printers
+(postprocessor
is
.BR grolj4 ).
.
@@ -1063,8 +1067,8 @@ There is a shell script
that emulates the behavior of classical
.BR nroff .
.
-It tries to automatically select the proper output encoding, according to
-the current locale.
+It tries to automatically select the proper output encoding,
+according to the current locale.
.
.
.P
diff --git a/tmac/an-old.tmac b/tmac/an-old.tmac
index 37055b9..a792e54 100644
--- a/tmac/an-old.tmac
+++ b/tmac/an-old.tmac
@@ -248,7 +248,8 @@
.\" Redefine these to customize the header & footer
.
.de1 PT
-. tl
'\\*[an-title](\\*[an-section])'\\*[an-extra3]'\\*[an-title](\\*[an-section])'
+. tl '\\*[an-title](\\*[an-section])'\\*[an-extra3]'\
+\\*[an-title](\\*[an-section])'
..
.
.de1 BT
diff --git a/tmac/devtag.tmac b/tmac/devtag.tmac
index ee253f8..ef591bb 100644
--- a/tmac/devtag.tmac
+++ b/tmac/devtag.tmac
@@ -28,15 +28,15 @@ along with this program. If not, see
<http://www.gnu.org/licenses/>.
Description
------------------------------------------------------------------------
-A simple set of macros to provide markup devices (currently only grohtml)
-with tags that define the meaning of the formatted text and also
-basic formatting instructions. It generalizes the tag concept used within
-grohtml and in the future it is hoped that more markup based devices
-can capitalize on this work. It also clearly defines those tags which are
-honoured by grohtml. Note that not all tags are included here. Some
-of the grohtml specific tags (header specific and jobname, etc.) are
-called directly from within www.tmac. The tags defined here are
-reasonably generic and could be applied to other devices.
+A simple set of macros to provide markup devices (currently only
+grohtml) with tags that define the meaning of the formatted text and
+also basic formatting instructions. It generalizes the tag concept used
+within grohtml and in the future it is hoped that more markup based
+devices can capitalize on this work. It also clearly defines those tags
+which are honoured by grohtml. Note that not all tags are included
+here. Some of the grohtml specific tags (header specific and jobname,
+etc.) are called directly from within www.tmac. The tags defined here
+are reasonably generic and could be applied to other devices.
..
.
.do if d DEVTAG-NH .nx
diff --git a/tmac/groff_man.7.man.in b/tmac/groff_man.7.man.in
index 360b952..894732f 100644
--- a/tmac/groff_man.7.man.in
+++ b/tmac/groff_man.7.man.in
@@ -388,8 +388,8 @@ in parentheses immediately appended to
.I footer-middle
is centered in the footer line.
.
-The arrangement of the rest of the footer depends on whether double-sided
-layout is enabled with the option
+The arrangement of the rest of the footer depends on whether
+double-sided layout is enabled with the option
.BR \-rD1 .
.
When disabled (the default),
diff --git a/tmac/groff_me.7.man b/tmac/groff_me.7.man
index 3ee39cd..ed1ec0a 100644
--- a/tmac/groff_me.7.man
+++ b/tmac/groff_me.7.man
@@ -89,7 +89,7 @@ l l.
\fB.bp\fP begin new page
\fB.br\fP break output line here
\fB.sp\fP \fIn\fP insert \fIn\fP spacing lines
-\fB.ls\fP \fIn\fP (line spacing) \fIn\fP=1 single, \fIn\fP=2 double space
+\fB.ls\fP \fIn\fP (line spacing) \fIn\fP=1 single, \fIn\fP=2 double
\fB.na\fP no alignment of right margin
\fB.ce\fP \fIn\fP center next \fIn\fP lines
\fB.ul\fP \fIn\fP underline next \fIn\fP lines
diff --git a/tmac/groff_www.7.man b/tmac/groff_www.7.man
index e3929bc..cc6b7a7 100644
--- a/tmac/groff_www.7.man
+++ b/tmac/groff_www.7.man
@@ -58,15 +58,19 @@ groff_www \- groff macros for authoring web pages
.SH Description
.\" ====================================================================
.
-This manual page describes the GNU \-mwww macro package, which is part of
-the groff document formatting system.
+This manual page describes the GNU
+.I www
+macro package,
+which is part of the
+.I groff
+document formatting system.
.
The manual page is very a basic guide, and the HTML device driver
-.RB ( \%grohtml )
+.RI ( \%grohtml )
has been completely rewritten but still remains as in an alpha state.
.
-It has been included into the distribution so that a lot of people have a
-chance to test it.
+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
.I troffrc
@@ -78,7 +82,7 @@ or
.
.PP
To see the hyperlinks in action, please format this man page with the
-.B \%grohtml
+.I \%grohtml
device.
.
.
@@ -146,7 +150,7 @@ A file is split whenever a \&.SH or \&.NH\ 1 is encountered.
Its argument is the file stem name for future output files.
.
This option is equivalent to
-.BR \%grohtml 's
+.IR \%grohtml 's
.B \-j
option.
.
@@ -155,7 +159,7 @@ option.
Specify the cut off depth when generating links from section headings.
.
For example, a parameter of\~2 would cause
-.B \%grohtml
+.I \%grohtml
to generate a list of links for
.B .NH\ 1
and
@@ -172,7 +176,7 @@ Whereas
.RE
.IP
tells
-.B \%grohtml
+.I \%grohtml
that no heading links should be created at all.
.
Another method for turning automatic headings off is by issuing the
@@ -183,8 +187,12 @@ to
.
.TP
.B .BCL foreground background active not-visited visited
-This macro takes five parameters: foreground, background, active hypertext
-link, hypertext link not yet visited, and visited hypertext link colour.
+This macro takes five parameters:
+foreground,
+background,
+active hypertext link,
+hypertext link not yet visited,
+and visited hypertext link colour.
.
.TP
.B .BGIMG imagefile
@@ -496,8 +504,9 @@ End heading.
.TP
.B .LK
.TAG LK
-Force \%grohtml to place the automatically generated links at this
-position.
+Force
+.I \%grohtml
+to place the automatically generated links at this position.
.
If this manual page has been processed with
.B \-Thtml
@@ -518,8 +527,9 @@ No effect for all other devices.
.
.TP
.B .NHR
-Suppress generation of the top and bottom rules which \%grohtml emits
-by default.
+Suppress generation of the top and bottom rules which
+.I \%grohtml
+emits by default.
.
.TP
.B .HTL
@@ -666,9 +676,9 @@ but these values will be superseded by a user call to
LINKSTYLE.
.\" ====================================================================
.
By default
-.B \%grohtml
-generates links to all section headings and places these at the top of the
-HTML document.
+.I \%grohtml
+generates links to all section headings and places these at the top of
+the HTML document.
.
(See
.UR #LK
@@ -716,10 +726,11 @@ Bernd Warken
.\" ====================================================================
.SH "See Also"
.\" ====================================================================
-.BR groff (@MAN1EXT@),
-.BR @g@troff (@MAN1EXT@),
-.BR \%grohtml (@MAN1EXT@),
-.BR netpbm (1)
+.
+.IR groff (@MAN1EXT@),
+.IR @g@troff (@MAN1EXT@),
+.IR \%grohtml (@MAN1EXT@),
+.IR netpbm (1)
.
.
.\" Restore compatibility mode (for, e.g., Solaris 10/11).
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [groff] 03/05: man pages: Reflow long lines in page sources.,
G. Branden Robinson <=