[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[groff] 02/14: grohtml(1): Recast.
From: |
G. Branden Robinson |
Subject: |
[groff] 02/14: grohtml(1): Recast. |
Date: |
Fri, 4 Jun 2021 16:01:59 -0400 (EDT) |
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.
.
.
.\" ====================================================================
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [groff] 02/14: grohtml(1): Recast.,
G. Branden Robinson <=