[Groff-commit] groff ChangeLog src/devices/grohtml/grohtml.man

[Werner LEMBERG]

CVSROOT:        /cvsroot/groff
Module name:    groff
Changes by:     Werner LEMBERG <wl>     10/11/02 19:04:51

Modified files:
        .              : ChangeLog 
        src/devices/grohtml: grohtml.man 

Log message:
        [grohtml] Improve man page.
        
        * src/devices/grohtml/grohtml.man: Document two-pass handling of
        input data.

CVSWeb URLs:
http://cvs.savannah.gnu.org/viewcvs/groff/ChangeLog?cvsroot=groff&r1=1.1244&r2=1.1245
http://cvs.savannah.gnu.org/viewcvs/groff/src/devices/grohtml/grohtml.man?cvsroot=groff&r1=1.27&r2=1.28

Patches:
Index: ChangeLog
===================================================================
RCS file: /cvsroot/groff/groff/ChangeLog,v
retrieving revision 1.1244
retrieving revision 1.1245
diff -u -b -r1.1244 -r1.1245
--- ChangeLog   19 Sep 2010 13:51:25 -0000      1.1244
+++ ChangeLog   2 Nov 2010 19:04:50 -0000       1.1245
@@ -1,3 +1,10 @@
+2010-11-02  Anton Shepelev  <address@hidden>
+
+       [grohtml] Improve man page.
+
+       * src/devices/grohtml/grohtml.man: Document two-pass handling of
+       input data.
+
 2010-09-19  Werner LEMBERG  <address@hidden>
 
        [groff] Don't use prefix for preconv.

Index: src/devices/grohtml/grohtml.man
===================================================================
RCS file: /cvsroot/groff/groff/src/devices/grohtml/grohtml.man,v
retrieving revision 1.27
retrieving revision 1.28
diff -u -b -r1.27 -r1.28
--- src/devices/grohtml/grohtml.man     20 Jan 2010 13:05:01 -0000      1.27
+++ src/devices/grohtml/grohtml.man     2 Nov 2010 19:04:51 -0000       1.28
@@ -99,6 +99,27 @@
 .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 @@
 .
 .
 .SH FILES
-.
 .B grohtml
 uses temporary files.
 See the