[groff] 02/14: grohtml(1): Recast.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit ff0f7faa1aba1eada056235d818777c63981c3cf
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Fri Jun 4 18:32:18 2021 +1000

    grohtml(1): Recast.
    
    Revise for more accurate use of terminology.
---
 src/devices/grohtml/grohtml.1.man | 43 +++++++++++++++++++++++----------------
 1 file changed, 26 insertions(+), 17 deletions(-)

diff --git a/src/devices/grohtml/grohtml.1.man 
b/src/devices/grohtml/grohtml.1.man
index 1bb34df..9dede66 100644
--- a/src/devices/grohtml/grohtml.1.man
+++ b/src/devices/grohtml/grohtml.1.man
@@ -104,15 +104,16 @@ grohtml, post\-grohtml, pre\-grohtml \- groff output 
driver for HTML
 .SH Description
 .\" ====================================================================
 .
-The
-.I grohtml
-front end (which consists of a preprocessor,
-.IR pre-grohtml ,
-and a device driver,
-.IR post-grohtml )
-translates the output of GNU
+The GNU
 .I roff
-to HTML.
+system's HTML support consists of a preprocessor,
+.IR pre\-grohtml ,
+and a device driver,
+.IR post\-grohtml ;
+together,
+they translate
+.IR roff (@MAN7EXT@)
+documents to HTML.
 .
 Users should always invoke
 .I grohtml
@@ -130,7 +131,7 @@ is
 .I grohtml
 reads the standard input stream.
 .
-HTML output is written to the standard output stream.
+Output is written to the standard output stream.
 .
 When
 .I grohtml
@@ -151,19 +152,26 @@ invokes
 twice.
 .
 In the first pass,
+the preprocessor
+.I pre\-grohtml
+renders
 pictures,
 equations,
-and tables are rendered using the
+and tables as images in PostScript format using the
 .B ps
-device,
-and in the second pass HTML output is generated by the
-.B html
-device.
+output driver.
+.
+In the second pass,
+the output driver
+.I post\-grohtml
+translates the output of
+.IR \%@g@troff (@MAN1EXT@)
+to HTML.
 .
 .
 .PP
 .I grohtml
-always writes output in \%UTF-8 encoding and has built-in entities for
+always writes output encoded in \%UTF-8 and has built-in entities for
 all non-composite Unicode characters.
 .
 In spite of this,
@@ -451,13 +459,14 @@ flag is also specified.
 .SH Usage
 .\" ====================================================================
 .
-There are styles called
+Font styles called
 .BR R ,
 .BR I ,
 .BR B ,
 and
 .B BI
-mounted at font positions 1 to\~4.
+are mounted at font positions\~1 to\~4,
+respectively.
 .
 .
 .\" ====================================================================