[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[groff] 04/07: grohtml(1): Update synopsis and Options section.
From: |
G. Branden Robinson |
Subject: |
[groff] 04/07: grohtml(1): Update synopsis and Options section. |
Date: |
Sat, 22 May 2021 09:14:46 -0400 (EDT) |
gbranden pushed a commit to branch master
in repository groff.
commit 9220af40829288c956c104d3508e3bb23df5ee47
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Sat May 22 18:56:28 2021 +1000
grohtml(1): Update synopsis and Options section.
* There is no command called "grohtml"; instead there are two programs,
pre-grohtml and post-grohtml, of complementary purposes that accept an
overlapping (but compatible) set of options. Document the commands as
they actually exist.
* (Name) Update apropos line to capture both command names.
* (Synopsis) Synopsize the commands distinctly.
* (Synopsis) Use more informative option parameter names.
* (Synopsis) Use .RB and .IR escapes instead of .OP.
* (Options) Sync option parameter names with synopsis.
* (Options) Tweak and tighten nearby wording.
---
src/devices/grohtml/grohtml.1.man | 105 +++++++++++++++++++++++++-------------
1 file changed, 69 insertions(+), 36 deletions(-)
diff --git a/src/devices/grohtml/grohtml.1.man
b/src/devices/grohtml/grohtml.1.man
index 2980663..263fcb0 100644
--- a/src/devices/grohtml/grohtml.1.man
+++ b/src/devices/grohtml/grohtml.1.man
@@ -1,6 +1,6 @@
.TH grohtml @MAN1EXT@ "@MDATE@" "groff @VERSION@"
.SH Name
-grohtml \- groff output driver for HTML
+grohtml, post\-grohtml, pre\-grohtml \- groff output driver for HTML
.
.
.\" ====================================================================
@@ -34,33 +34,68 @@ grohtml \- groff output driver for HTML
.SH Synopsis
.\" ====================================================================
.
-.SY grohtml
-.OP \-bhlnprVy
-.OP \-a aa-text-bits
-.OP \-D dir
-.OP \-F dir
-.OP \-g aa-graphic-bits
-.OP \-i resolution
-.OP \-I image-stem
-.OP \-j filename
-.OP \-o image-vertical-offset
-.OP \-s size
-.OP \-S level
-.OP \-x html-dialect
+.SY pre\-grohtml
+.RB [ \-epV ]
+.RB [ \-a
+.IR anti-aliasing-text-bits ]
+.RB [ \-D
+.IR image-directory ]
+.RB [ \-F
+.IR font-directory ]
+.RB [ \-g
+.IR anti-aliasing-graphic-bits ]
+.RB [ \-i
+.IR resolution ]
+.RB [ \-I
+.IR image-stem ]
+.RB [ \-o
+.IR image-vertical-offset ]
+.RB [ \-x
+.IR html-dialect ]
.RI [ file
\&.\|.\|.\&]
.YS
.
.
-.SY grohtml
+.SY pre\-grohtml
.B \-\-help
.YS
.
.
-.SY grohtml
+.SY pre\-grohtml
.B \-v
.
-.SY grohtml
+.SY pre\-grohtml
+.B \-\-version
+.YS
+.
+.
+.SY post\-grohtml
+.RB [ \-bhlnrVy ]
+.RB [ \-F
+.IR font-directory ]
+.RB [ \-j
+.IR output-stem ]
+.RB [ \-s
+.IR base-point-size ]
+.RB [ \-S
+.IR heading-level ]
+.RB [ \-x
+.IR html-dialect ]
+.RI [ file
+\&.\|.\|.\&]
+.YS
+.
+.
+.SY post\-grohtml
+.B \-\-help
+.YS
+.
+.
+.SY post\-grohtml
+.B \-v
+.
+.SY post\-grohtml
.B \-\-version
.YS
.
@@ -153,7 +188,7 @@ both exit afterward.
.
.
.TP
-.BI \-a \~aa-text-bits
+.BI \-a \~anti-aliasing-text-bits
Number of bits of antialiasing information to be used by
.I text
when generating PNG images.
@@ -183,11 +218,11 @@ Initialize the background color to white.
.
.
.TP
-.BI \-D \~dir
+.BI \-D \~image-directory
Instruct
.I grohtml
to place all image files into directory
-.IR dir .
+.IR image-directory .
.
.
.TP
@@ -211,9 +246,9 @@ is specified).
.
.
.TP
-.BI \-F \~dir
+.BI \-F \~font-directory
Prepend directory
-.RI dir /dev name
+.RI font-directory /dev name
to the search path for font and device description files;
.I name
is the name of the device,
@@ -222,7 +257,7 @@ usually
.
.
.TP
-.BI \-g \~aa-graphic-bits
+.BI \-g \~anti-aliasing-graphic-bits
Number of bits of antialiasing information to be used by
.I graphics
when generating PNG images.
@@ -270,8 +305,8 @@ indicates 200 pixels per inch.
.
.
.TP
-.BI \-I \~stem
-Determine the image stem name.
+.BI \-I \~image-stem
+Determine the image file name stem.
.
If omitted grohtml uses
.IR \%grohtml\- XXXXX
@@ -281,19 +316,17 @@ is the process ID).
.
.
.TP
-.BI \-j \~filename
+.BI \-j \~output-stem
Instruct
.I grohtml
to split the HTML output into multiple files.
.
-The
-.I filename
-is the stem and output is written to a new file at each section heading
+Output is written to a new file at each section heading
(but see option
.B \-S
below)
named
-.IR filename\- n .html .
+.IR output-stem\- n .html .
.
.
.TP
@@ -316,7 +349,7 @@ This flag is automatically turned on if a heading contains
an image.
.
.
.TP
-.BI \-o \~vertical-offset
+.BI \-o \~image-vertical-offset
Specify the vertical offset of images in points.
.
.
@@ -335,7 +368,7 @@ Turn off the automatic header and footer line
.
.
.TP
-.BI \-s \~size
+.BI \-s \~base-point-size
Set the base point size of the source file.
.
Thereafter when this point size is used in the source it will correspond
@@ -349,13 +382,13 @@ tag is emitted.
.
.
.TP
-.BI \-S \~level
+.BI \-S \~heading-level
When splitting HTML output
(see option
.B \-j
above),
split at each nested heading level defined by
-.IR level ,
+.IR heading-level ,
or higher).
.
The default is
@@ -369,11 +402,11 @@ the document.
.
.
.TP
-.BI \-x \~dialect
+.BI \-x \~html-dialect
Select HTML dialect.
.
Currently,
-.I dialect
+.I html-dialect
should be either the
.RB digit\~ 4
or the
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [groff] 04/07: grohtml(1): Update synopsis and Options section.,
G. Branden Robinson <=