[groff] 03/07: grolj4(1): Make editorial fixes.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit e39250e936eb44b0e4872d6b91825ec4897d6dbc
Author: G. Branden Robinson <address@hidden>
Date:   Sat Jun 23 08:22:19 2018 -0400

    grolj4(1): Make editorial fixes.
    
    * Use HP's preferred casing for "LaserJet".
    * Document all operation modes in synopsis.
    * Parallelize option argument names between synopsis and later
      discussion.
    * Consistently put 2 empty requests between paragraphs, even when the
      paragraph is tagged.
    * Add whitespace between short option letter and argument in OPTIONS
      section, for readability.
    
    Signed-off-by: G. Branden Robinson <address@hidden>
---
 src/devices/grolj4/grolj4.1.man | 62 +++++++++++++++++++++++++++++------------
 1 file changed, 44 insertions(+), 18 deletions(-)

diff --git a/src/devices/grolj4/grolj4.1.man b/src/devices/grolj4/grolj4.1.man
index cdd6bb8..1478d64 100644
--- a/src/devices/grolj4/grolj4.1.man
+++ b/src/devices/grolj4/grolj4.1.man
@@ -1,6 +1,6 @@
 .TH GROLJ4 @MAN1EXT@ "@MDATE@" "groff @VERSION@"
 .SH NAME
-grolj4 \- groff driver for HP Laserjet 4 family
+grolj4 \- groff driver for HP LaserJet 4 family
 .
 .
 .\" license
@@ -28,13 +28,25 @@ grolj4 \- groff driver for HP Laserjet 4 family
 .\" ====================================================================
 .
 .SY grolj4
-.OP \-lv
-.OP \-d \fR[\fPn\fR]\fP
-.OP \-c n
-.OP \-p paper_size
-.OP \-w n
-.OP \-F dir
-.RI "[\ " files\|.\|.\|. "\ ]"
+.OP \-l
+.OP \-c num-copies
+.RB [ \-d
+.RI [ n ]]
+.OP \-F font-directory
+.OP \-p paper-size
+.OP \-w line-width
+.RI [ file
+\&.\|.\|.\&]
+.YS
+.
+.SY grolj4
+.B \-\-help
+.YS
+.
+.SY grolj4
+.B \-v
+.SY grolj4
+.B \-\-version
 .YS
 .
 .
@@ -45,7 +57,7 @@ grolj4 \- groff driver for HP Laserjet 4 family
 .B grolj4
 is a driver for
 .B groff
-that produces output in PCL5 format suitable for an HP Laserjet 4
+that produces output in PCL5 format suitable for an HP LaserJet 4
 printer.
 .
 .
@@ -73,47 +85,57 @@ commands.
 It is possible to have whitespace between a command-line option and its
 parameter.
 .
+.
 .TP
-.BI \-c n
+.BI \-c " num-copies"
 Print
-.I n
+.I num-copies
 copies of each page.
 .
+.
 .TP
 .B \-l
 Print the document with a landscape orientation.
 .
+.
 .TP
-.BI "\-d [" n ]
+.B \-d\c
+.RI " [" n ]
 Use duplex mode
 .IR n :
 1\ is long-side binding; 2\ is short-side binding;
 default is\ 1.
 .
+.
 .TP
-.BI \-p size
+.BI \-p " paper-size"
 Set the paper size to
-.IR size ,
+.IR paper-size ,
 which must be one of
 letter, legal, executive, a4, com10, monarch, c5, b5, dl.
 .
+.
 .TP
 .B \-v
+.TQ
+.B \-\-version
 Print the version number.
 .
+.
 .TP
-.BI \-w n
+.BI \-w " line-width"
 Set the default line thickness to
-.I n
+.I line-width
 thousandths of an em.
 .
 If this option isn't specified, the line thickness defaults to
 0.04\~em.
 .
+.
 .TP
-.BI \-F dir
+.BI \-F " font-directory"
 Prepend directory
-.IB dir /dev name
+.IB font-directory /dev name
 to the search path for font and device description files;
 .I name
 is the name of the device, usually
@@ -124,22 +146,26 @@ is the name of the device, usually
 The following four commands are available additionally in the
 font description files:
 .
+.
 .TP
 .BI pclweight \ N
 The integer value
 .I N
 must be in the range \-7 to +7; default is\~0.
 .
+.
 .TP
 .BI pclstyle \ N
 The integer value
 .I N
 must be in the range 0 to 32767; default is\~0.
 .
+.
 .TP
 .BI pclproportional \ N
 A boolean flag which can be either 0 or\~1; default is\~0.
 .
+.
 .TP
 .BI pcltypeface \ N
 The integer value