*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->NetBSD man pages -> grohtml (1)              



NAME    [Toc]    [Back]

       grohtml - html driver for groff

SYNOPSIS    [Toc]    [Back]

       grohtml [ -atTvdgm? ] [ -Fdir ] [ -Iimagetype ] [ -rreso-
               lution ] [ files... ]

       It is possible to have whitespace between a  command  line
       option and its parameter.

DESCRIPTION    [Toc]    [Back]

       grohtml  translates the output of GNU troff to html.  Normally
 grohtml should be invoked by using 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  the groff -P

OPTIONS    [Toc]    [Back]

       -a     force grohtml to generate html line breaks  in  the
              same  position  as  troff  dictates.   Without this
              option grohtml generates text in  paragraphs  which
              is formatted by the html browser.

       -d     turn on internal debugging.

       -g     tell  grohtml not to try and guess titles and headings.
  By using this flag together with the -m  and
              -a  flag  grohtml  will treat the html browser as a
              printer, not as a formatter.

       -m     leave margins alone.  grohtml will not remove  left

       -t     forbids  grohtml  from  generating html tables when
              implementing indentation and tabular text.  grohtml
              can  implement .IP by tables or html indents.  However
 if .2C is used it can only  be  sensibly  converted
  to  html using a table structure.  As a few
              known bugs still exist with  the  html  table  code
              this option is present to supress execution of this
              development code.  The default in grohtml  is  that
              html tables are generated when appropriate.

       -T     forbids  grohtml  from  generating images when processing
 output from tbl.  This is useful when  simple
 textual tables are being produced.

       -Fdir  Search  the  directory  dir/devname  for  font  and
              device description files; name is the name  of  the
              device, usually html.

              select  the  type  of  image generated when grohtml
              encounters an  equation,  table,  or  picture.   By
              default this is png256.  Legal image types are: gif
              and any of the png formats which are  supported  by
              ghostscript gs(1).

              select  the  resolution for all images.  By default
              this is 80 pixels per inch.  Example:  -r100  indicates
 100 pixels per inch.

       -v     Print the version number.

       -?     Display usage.

USAGE    [Toc]    [Back]

       There  are  styles  called R, I, B, and BI mounted at font
       positions 1 to 4.  It is advisable to  invoke  groff  with
       the  -mhtml  macro  set, which turns off headers, footers,
       and hyphenation; additionally, it will right justify text.

DEPENDENCIES    [Toc]    [Back]

       grohtml  is  dependent  upon grops and gs.  If grohtml has
       been configured to generate gif files then it  is  further
       dependent upon, ppmtogif, and ppmquant.  However if it has
       been configured to generate png files (the  default)  then
       it  is  dependent  upon  gs  having  a  png output device.
       Images are generated whenever a table,  picture,  equation
       or line is encountered.

BUGS    [Toc]    [Back]

       This  is  still  very  alpha.   At  least three major bugs
       remain: Firstly, grohtml sometimes miscalculates  the  end
       of  an  html  table resulting in text which appears twice.
       Secondly  equation  numbers  are  not  handled  correctly.
       Thirdly  equation  macros  and pic macros can confuse gro-

SEE ALSO    [Toc]    [Back]

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

Groff Version 1.16.1      April 8, 2001                GROHTML(1)
[ Back ]
 Similar pages
Name OS Title
grops NetBSD PostScript driver for groff
grops FreeBSD PostScript driver for groff
grops OpenBSD PostScript driver for groff
grotty FreeBSD groff driver for typewriter-like devices
grotty OpenBSD groff driver for typewriter-like devices
grolj4 OpenBSD groff driver for HP Laserjet 4 family
grolj4 FreeBSD groff driver for HP Laserjet 4 family
grolj4 NetBSD groff driver for HP Laserjet 4 family
grotty NetBSD groff driver for typewriter-like devices
grotty Linux groff driver for typewriter-like devices
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service