summaryrefslogtreecommitdiff
path: root/src
diff options
context:
space:
mode:
authorwl <wl>2010-11-02 19:04:50 +0000
committerwl <wl>2010-11-02 19:04:50 +0000
commita0d61fdb385f12cb7779276ee5d0b187c90106d3 (patch)
tree83587ce4fc68ad6ee6e1c103273ce01e757c2d37 /src
parent7878ae0c82a624c477d1a5c7fbac68a7127cc28a (diff)
downloadgroff-a0d61fdb385f12cb7779276ee5d0b187c90106d3.tar.gz
[grohtml] Improve man page.
* src/devices/grohtml/grohtml.man: Document two-pass handling of input data.
Diffstat (limited to 'src')
-rw-r--r--src/devices/grohtml/grohtml.man22
1 files changed, 21 insertions, 1 deletions
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