[groff] 26/32: grolbp(1): Fix content and style nits.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit a3af6f3bfeb640138fd2ecd0ba016b4c1ad4b734
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Thu Oct 6 00:29:35 2022 -0500

    grolbp(1): Fix content and style nits.
    
    Tighten discussion of paper size/orientation.
    
    Annotate an inconsistency of this output driver's behavior.
---
 src/devices/grolbp/grolbp.1.man | 119 +++++++++++-----------------------------
 1 file changed, 33 insertions(+), 86 deletions(-)

diff --git a/src/devices/grolbp/grolbp.1.man b/src/devices/grolbp/grolbp.1.man
index 264b3c2df..ae7cd5aff 100644
--- a/src/devices/grolbp/grolbp.1.man
+++ b/src/devices/grolbp/grolbp.1.man
@@ -169,104 +169,51 @@ Elite | ER | EB | EI |
 .
 .
 .\" ====================================================================
-.SS "Paper sizes"
+.SS "Paper size, orientation, and device description file"
 .\" ====================================================================
 .
-The paper size can be set in the
-.I DESC
-file or with command-line options to
-.I grolbp.
-If the paper size is specified both ways,
-the command-line options take
-precedence over the contents of the
-.I DESC
-file
-(this applies to the page orientation too).
-.
-.MR groff_font @MAN5EXT@
-describes how to set the paper dimensions in the
-.I DESC
-file.
+The
+.BR \-p ,
+.B \-\-paper\-size
+option overrides any setting in the device description file
+.IR DESC .
 .
-To set the paper size on the command line,
-add
-.RS
-.EX
-.BI \-p\~ paper-size
-.EE
-.RE
-or
-.RS
-.EX
-.BI \-\-papersize= paper-size
-.EE
-.RE
-to the other
-.I grolbp
-options,
-where
-.I paper-size
-is in the same format as in the
-.I DESC
-file.
-.
-If no paper size is specified in the
-.I DESC
-file or on the command line,
-a default size of A4 is used.
-.
-.
-.\" ====================================================================
-.SS "Page orientation"
-.\" ====================================================================
+If neither specifies a paper size,
+A4 is assumed.
 .
-As with the page size,
-the orientation of the page
-.RB ( portrait
-or
-.BR landscape )
-can be set in the
-.I DESC
-file or with command-line options.
+See subsection
+.RI \[lq] DESC
+file format\[rq] of
+.MR groff_font @MAN5EXT@
+for accepted paper size formats.
 .
-These keywords are case insensitive.
 .
-To set the orientation in the
+.P
+In its
 .I DESC
 file,
-insert a line
-.RS
-.EX
-orientation portrait
-.EE
-.RE
+.I grolbp
+(case-insensitively) recognizes an
+.B orientation
+directive accepting one mandatory argument,
+.B portrait
 or
-.RS
-.EX
-orientation landscape
-.EE
-.RE
-as desired.
-.
-The first valid orientation command in the
-.I DESC
-file is used.
+.BR landscape .
 .
+The first valid orientation directive encountered controls.
+.\" XXX: This is inconsistent with other description file processing.
 .
-To set the page orientation with command-line options you can use the
-.B \-o
-or
+The
+.BR \-l ,
+.BR \-o ,
+and
 .B \-\-orientation
-options with the same parameters
-.RB ( portrait
-or
-.BR landscape )
-as in the
-.I DESC
-file,
-or the
-.B \-l
-option to select landscape orientation.
+command-line options
+override any setting in
+.IR DESC .
+.
+If none of the foregoing specify the orientation,
+portrait is assumed.
 .
 .
 .\" ====================================================================