Go to main content

man pages section 1: User Commands

Exit Print View

Updated: Wednesday, February 9, 2022

grohtml (1)


grohtml - html driver for groff


grohtml [ -bhlnprv ] [ -aaa-text-bits ] [ -Ddir ] [ -Fdir ]
[ -gaa-graphic-bits ] [ -iresolution ] [ -Iimage-stem ]
[ -jfilename ] [ -oimage-vertical-offset ] [ -ssize ]
[ -Slevel ] [ -xhtml-dialect ] [ files... ]


GROHTML(1)                  General Commands Manual                 GROHTML(1)

       grohtml - html driver for groff

       grohtml [ -bhlnprv ] [ -aaa-text-bits ] [ -Ddir ] [ -Fdir ]
               [ -gaa-graphic-bits ] [ -iresolution ] [ -Iimage-stem ]
               [ -jfilename ] [ -oimage-vertical-offset ] [ -ssize ]
               [ -Slevel ] [ -xhtml-dialect ] [ files... ]

       The grohtml front end (which consists of a  preprocessor,  pre-grohtml,
       and  a  device driver, post-grohtml) translates the output of GNU troff
       to html.  Users should always invoke grohtml via the groff command with
       a -Thtml option.  If no files are given, grohtml will read the standard
       input.  A filename of - will also cause grohtml to  read  the  standard
       input.  Html output is written to the standard output.  When grohtml is
       run by groff options can be passed to grohtml using groff's -P option.

       grohtml invokes groff twice.  In the first pass,  pictures,  equations,
       and  tables  are  rendered  using the ps device, and in the second pass
       HTML output is generated by the html device.

       grohtml always writes output in UTF-8 encoding and has  built-in  enti-
       ties 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.

              Number of bits of antialiasing information to be  used  by  text
              when  generating  png images.  The default is 4 but valid values
              are 0, 1, 2, and 4.  Note your version of gs  needs  to  support
              the  -dTextAlphaBits  and -dGraphicAlphaBits options in order to
              exploit antialiasing.  A value of 0 stops grohtml  from  issuing
              antialiasing commands to gs.

       -b     Initialize the background color to white.

       -Ddir  Inform grohtml to place all image files into directory dir.

       -e     This  option should not be directly invoked by the user as it is
              an internal option utilized by groff when -Thtml or  -Txhtml  is
              specified.   It is used by the grohtml preprocessor to determine
              whether eqn should attempt to  produce  MathML  (if  -Txhtml  is

       -Fdir  Prepend  directory  dir/devname  to the search path for font and
              device description files; name is the name of the  device,  usu-
              ally html.

              Number  of bits of antialiasing information to be used by graph-
              ics when generating png images.  The default is 4 but valid val-
              ues  are  0, 1, 2, and 4.  Note your version of gs needs to sup-
              port the -dTextAlphaBits and -dGraphicAlphaBits options in order
              to  exploit antialiasing.  A value of 0 stops grohtml from issu-
              ing antialiasing commands to gs.

       -h     Generate section and number headings  by  using  <B>...</B>  and
              increasing  the  font  size,  rather than using the <Hn>...</Hn>

              Select the resolution for all images.  By default  this  is  100
              pixels per inch.  Example: -i200 indicates 200 pixels per inch.

       -Istem Determine   the  image  stem  name.   If  omitted  grohtml  uses
              grohtml-XXX (XXX is the process ID).

              Inform grohtml to split the html  output  into  multiple  files.
              The filename is the stem and specified section headings (default
              is level one) start a new file, named filename-n.html.

       -l     Turn off the production of automatic section links at the top of
              the document.

       -n     Generate  simple heading anchors whenever a section/number head-
              ing is found.  Without the option the anchor value is  the  tex-
              tual heading.  This can cause problems when a heading contains a
              `?' on older versions of some browsers (Netscape).  This flag is
              automatically turned on if a heading contains an image.

              Specify the vertical offset of images in points.

       -p     Display  page  rendering  progress to stderr.  grohtml only dis-
              plays a page number when an image is required.

       -r     Turn off the automatic header and footer line (html rule).

       -s size
              Set the base point size of the  source  file.   Thereafter  when
              this  point size is used in the source it will correspond to the
              html base size.  Every increase of two points in the source will
              yield  a <big> tag, and conversely when a decrease of two points
              is seen a <small> tag is emitted.

              When splitting html output,  split  at  the  heading  level  (or
              higher) defined by level.

       -v     Print the version number.

       -V     Create  an  XHTML or HTML validator button at the bottom of each
              page of the document.

              Select HTML dialect.  Currently, dialect should  be  either  the
              digit  4  or the letter x which indicates whether grohtml should
              generate HTML 4 or XHTML, respectively.  This option should  not
              be directly invoked by the user as it is an internal option uti-
              lized by groff when -Thtml or -Txhtml is specified.

       -y     Produce a right-justified groff signature at the end of the doc-
              ument.  This is only generated if the -V flag is also specified.

       There  are  styles  called  R, I, B, and BI mounted at font positions 1
       to 4.

       grohtml is dependent upon the png utilities (pnmcut, pnmcrop, pnmtopng)
       and  GhostScript (gs).  pnmtopng (version 2.37.6 or greater) and pnmcut
       from the netpbm package (version 9.16 or greater) will work  also.   It
       is  also  dependent upon psselect from the PSUtils package.  Images are
       generated whenever a table, picture, equation or line is encountered.

       grohtml uses temporary files.  See the groff(1) man  page  for  details
       where such files are created.

              A  list of directories in which to search for the devname direc-
              tory  in  addition  to  the  default  ones.   See  troff(1)  and
              groff_font(5) for more details.

       Grohtml has been completely redesigned and rewritten.  It is still beta

       See attributes(7) for descriptions of the following attributes:

       |Availability   | text/groff       |
       |Stability      | Uncommitted      |

       afmtodit(1), groff(1), troff(1), psbb(1), groff_out(5),  groff_font(5),

       Copyright (C) 1999-2014 Free Software Foundation, Inc.

       Permission  is  granted  to make and distribute verbatim copies of this
       manual provided the copyright notice and  this  permission  notice  are
       preserved on all copies.

       Permission  is granted to copy and distribute modified versions of this
       manual under the conditions for verbatim  copying,  provided  that  the
       entire  resulting derived work is distributed under the terms of a per-
       mission notice identical to this one.

       Permission is granted to copy and distribute translations of this  man-
       ual into another language, under the above conditions for modified ver-
       sions, except that this permission notice may be included  in  transla-
       tions approved by the Free Software Foundation instead of in the origi-
       nal English.

       Source code for open source software components in Oracle  Solaris  can
       be found at https://www.oracle.com/downloads/opensource/solaris-source-

       This    software    was    built    from    source     available     at
       https://github.com/oracle/solaris-userland.    The  original  community
       source                was                downloaded                from

       Further information about this software can be found on the open source
       community website at https://www.gnu.org/software/groff.

Groff Version 1.22.3            4 November 2014                     GROHTML(1)