[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[groff] 28/32: grolbp(1): Fix more content and style nits.
From: |
G. Branden Robinson |
Subject: |
[groff] 28/32: grolbp(1): Fix more content and style nits. |
Date: |
Thu, 6 Oct 2022 09:11:25 -0400 (EDT) |
gbranden pushed a commit to branch master
in repository groff.
commit 14e1085bcfb24789a95de6e5dbe5162e5bc46a2c
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Thu Oct 6 01:10:03 2022 -0500
grolbp(1): Fix more content and style nits.
* Set "groff" in italics in summary-description (Savannah #63150).
* Speak of "drawing position", not "current position". This is groff,
not PostScript.
* Say "produce" or "format" instead of "print", since this program does
not of itself cause printing to happen.
* Clarify provenance of this man page in comment.
* Annotate apparent limitation of supported hardware in comment.
* Suppress hyphenation of literals.
* Break input lines after commas.
* Document a default in terms of the units it uses, not different ones.
* Tighten wording.
---
src/devices/grolbp/grolbp.1.man | 50 +++++++++++++++++++++++------------------
1 file changed, 28 insertions(+), 22 deletions(-)
diff --git a/src/devices/grolbp/grolbp.1.man b/src/devices/grolbp/grolbp.1.man
index 45b177f38..a09524ef2 100644
--- a/src/devices/grolbp/grolbp.1.man
+++ b/src/devices/grolbp/grolbp.1.man
@@ -1,11 +1,13 @@
'\" t
.TH grolbp @MAN1EXT@ "@MDATE@" "groff @VERSION@"
.SH Name
-grolbp \- groff output driver for Canon CaPSL printers
+grolbp \-
+.I groff
+output driver for Canon CaPSL printers
.
.
-.\" Modified by Francisco Andrés Verdú <pandres@dragonet.es> for the
-.\" grolbp program.
+.\" Modified from grolj4 man page by Francisco Andrés Verdú
+.\" <pandres@dragonet.es> for the grolbp program.
.
.
.\" ====================================================================
@@ -91,9 +93,9 @@ grolbp \- groff output driver for Canon CaPSL printers
.SH Description
.\" ====================================================================
.
-The GNU
+This GNU
.I roff
-LBP output driver translates the output of
+output driver translates the output of
.MR @g@troff @MAN1EXT@
into a CaPSL and VDM format suitable for Canon LBP-4 and LBP-8 printers.
.
@@ -269,7 +271,7 @@ can be one of the letters
.BR I ,
or
.BR B ,
-.\" XXX: what about "BI"?
+.\" The bold-italic style apparently was not supported for bitmap fonts.
indicating the roman,
italic,
and bold styles,
@@ -304,7 +306,7 @@ listing A\[rq].
For instance,
to select the \[lq]Swiss\[rq] font in bold-italic style,
which appears in the font listing
-as \[lq]Swiss\-BoldOblique\[rq],
+as \%\[lq]Swiss\-BoldOblique\[rq],
.RS
.EX
lbpname Swiss\-BoldOblique
@@ -324,7 +326,6 @@ device.
.SS "Drawing commands"
.\" ====================================================================
.
-.P
For compatibility with
.MR grolj4 @MAN1EXT@ ,
an additional drawing command is available.
@@ -333,11 +334,11 @@ an additional drawing command is available.
.TP
.BI \[rs]D\[aq]R\~ "dh dv" \[aq]
Draw a rule
-(i.e., a solid black rectangle),
-with one corner at the current position,
-and the diagonally opposite corner at the current
-position
+(solid black rectangle)
+with one corner at the drawing position,
+and the diagonally opposite corner at the drawing position
.RI +( dh , dv ).
+.\" XXX , at which the drawing position will be afterward. ?
.
.
.\" ====================================================================
@@ -360,7 +361,7 @@ all exit afterward.
.BI \-c " num-copies"
.TQ
.BI \-\-copies= num-copies
-Print
+Produce
.I num-copies
copies of each page.
.
@@ -373,7 +374,8 @@ Prepend directory
.RI font-directory /dev name
to the search path for font and device description files;
.I name
-is the name of the device, usually
+is the name of the device,
+usually
.BR lbp .
.
.
@@ -381,16 +383,19 @@ is the name of the device, usually
.B \-l
.TQ
.B \-\-landscape
-Print the document with a landscape orientation.
+Format the document in landscape orientation.
.
.
.TP
.BI \-o " orientation"
.TQ
.BI \-\-orientation= orientation
-Print the document with
-.I orientation
-orientation, which must be \(oqportrait\(cq or \(oqlandscape\(cq.
+Format the document in the given
+.IR orientation ,
+which must be
+.RB \%\[lq] portrait \[rq]
+or
+.RB \%\[lq] landscape \[rq].
.
.
.TP
@@ -399,8 +404,7 @@ orientation, which must be \(oqportrait\(cq or
\(oqlandscape\(cq.
.BI \-\-papersize= paper-size
Set the paper size to
.IR paper-size ,
-which must be a valid paper size description as indicated in section
-\[lq]Paper Sizes\[rq], below.
+which must be a valid paper size format as described above.
.
.
.TP
@@ -410,7 +414,9 @@ which must be a valid paper size description as indicated
in section
Set the default line thickness to
.I width
thousandths of an em;
-the default is 0.04\~em.
+the default is
+.B 40
+(0.04\~em).
.
.
.\" ====================================================================
@@ -419,7 +425,7 @@ the default is 0.04\~em.
.
.TP
.I GROFF_FONT_PATH
-A list of directories in which to seek the selected output device's
+lists directories in which to seek the selected output device's
directory of device and font description files.
.
See
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [groff] 28/32: grolbp(1): Fix more content and style nits.,
G. Branden Robinson <=