summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--ChangeLog7
-rw-r--r--src/devices/grohtml/grohtml.man22
2 files changed, 28 insertions, 1 deletions
diff --git a/ChangeLog b/ChangeLog
index f1451295..05684a02 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,10 @@
+2010-11-02 Anton Shepelev <anton.txt@gmail.com>
+
+ [grohtml] Improve man page.
+
+ * src/devices/grohtml/grohtml.man: Document two-pass handling of
+ input data.
+
2010-09-19 Werner LEMBERG <wl@gnu.org>
[groff] Don't use prefix for preconv.
diff --git a/src/devices/grohtml/grohtml.man b/src/devices/grohtml/grohtml.man
index 3950abbc..02209e2e 100644
--- a/src/devices/grohtml/grohtml.man
+++ b/src/devices/grohtml/grohtml.man
@@ -99,6 +99,27 @@ using
.B \-P
option.
.
+.PP
+.B grohtml
+invokes
+.B groff
+twice.
+In the first pass, pictures, equations, and tables are rendered
+using the
+.B ps
+device, and in the second pass HTML output is generated by the
+.B html
+device.
+.
+.PP
+.B grohtml
+always writes output in \%UTF-8 encoding and has built-in
+entities for all non-composite unicode characters.
+In spite of this, groff may issue warnings about unknown special
+characters if they can't be found during the first pass.
+Such warnings can be safely ignored unless the special characters
+appear inside a table or equation.
+.
.
.SH OPTIONS
.TP
@@ -327,7 +348,6 @@ encountered.
.
.
.SH FILES
-.
.B grohtml
uses temporary files.
See the