[grohtml]: Improve texinfo documentation.

* doc/groff.texinfo (grohtml): Insert man page description, slightly
extended.

1 files changed, 22 insertions, 1 deletions

diff --git a/doc/groff.texinfo b/doc/groff.texinfo
index ae2ac6ea..8d2e5c68 100644
--- a/doc/groff.texinfo
+++ b/doc/groff.texinfo
@@ -14922,7 +14922,28 @@ is available as an extra package from the following address:
 @section @code{grohtml}
 @cindex @code{grohtml}, the program
 
-@c XXX
+The @code{grohtml} front end (which consists of a preprocessor,
+@code{pre-grohtml}, and a device driver, @code{post-grohtml}) translates
+the output of GNU @code{troff} to @acronym{HTML}.  Users should always
+invoke @code{grohtml} via the @code{groff} command with a @code{\-Thtml}
+option.  If no files are given, @code{grohtml} will read the standard
+input.  A filename of @code{-} will also cause @code{grohtml} to read
+the standard input.  @acronym{HTML} output is written to the standard
+output.  When @code{grohtml} is run by @code{groff}, options can be
+passed to @code{grohtml} using @code{groff}'s @code{-P} option.
+
+@code{grohtml} invokes @code{groff} twice.  In the first pass, pictures,
+equations, and tables are rendered using the @code{ps} device, and in
+the second pass @acronym{HTML} output is generated by the @code{html}
+device.
+
+@code{grohtml} always writes output in @code{UTF-8} encoding and has
+built-in entities for all non-composite unicode characters.  In spite of
+this, @code{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, in which case glyphs for these characters must be defined for
+the @code{ps} device as well.
 
 @menu
 * Invoking grohtml::