[grohtml] Improve man page.

* src/devices/grohtml/grohtml.man: Document two-pass handling of
input data.

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