NAME
          groff - front end for the groff document formatting system

     SYNOPSIS
          groff [ -tpeszaivhblCENRVXZ ] [ -wname ] [ -Wname ] [ -mname
          ] [ -Fdir ] [ -Tdev ] [ -ffam ] [ -Mdir ] [ -dcs ] [ -rcn ]
          [ -nnum ] [ -olist ] [ -Parg ] [ files...  ]

     DESCRIPTION
          groff is a front-end to the groff document formatting
          system.  Normally it runs the gtroff program and a
          postprocessor appropriate for the selected device.
          Available devices are:

          ps   For PostScript printers and previewers

          dvi  For TeX dvi format

          X75  For a 75 dpi X11 previewer

          X100 For a 100dpi X11 previewer

          ascii
               For typewriter-like devices

          latin1
               For typewriter-like devices using the ISO Latin-1
               character set.

          The postprocessor to be used for a device is specified by
          the postpro command in the device description file.  This
          can be overridden with the -X option.

          The default device is ps.  It can optionally preprocess with
          any of gpic, geqn, gtbl, grefer, or gsoelim.

          Options without an argument can be grouped behind a single
          -.  A filename of - denotes the standard input.

          The grog command can be used to guess the correct groff
          command to use to format a file.

     OPTIONS
          -h   Print a help message.

          -e   Preprocess with geqn.

          -t   Preprocess with gtbl.

          -p   Preprocess with gpic.

          -s   Preprocess with gsoelim.
          -R   Preprocess with grefer.  No mechanism is provided for
               passing arguments to grefer because most grefer options
               have equivalent commands which can be included in the
               file.  See grefer(1) for more details.

          -v   Make programs run by groff print out their version
               number.

          -V   Print the pipeline on stdout instead of executing it.

          -z   Suppress output from gtroff.  Only error messages will
               be printed.

          -Z   Do not postprocess the output of gtroff.  Normally
               groff will automatically run the appropriate
               postprocessor.

          -Parg
               Pass arg to the postprocessor.  Each argument should be
               passed with a separate -P option.  Note that groff does
               not prepend - to arg before passing it to the
               postprocessor.

          -l   Send the output to a printer.  The command used for
               this is specified by the print command in the device
               description file.

          -Larg
               Pass arg to the spooler.  Each argument should be
               passed with a separate -L option.  Note that groff does
               not prepend - to arg before passing it to the
               postprocessor.

          -Tdev
               Prepare output for device dev.  The default device is
               ps.

          -X   Preview with gxditview instead of using the usual
               postprocessor.  This is unlikely to produce good
               results except with -Tps.

          -N   Don't allow newlines with eqn delimiters.  This is the
               same as the -N option in geqn.

          -a
          -b
          -i
          -C
          -E
          -wname
          -Wname
          -mname
          -olist
          -dcs
          -rcn
          -Fdir
          -Mdir
          -ffam
          -nnum
               These are as described in gtroff(1).

     ENVIRONMENT
          GROFF_COMMAND_PREFIX
               If this is set X, then groff will run Xtroff instead of
               gtroff.  This also applies to tbl, pic, eqn, refer and
               soelim.  It does not apply to grops, grodvi, grotty and
               gxditview.

          GROFF_TMAC_PATH
               A colon separated list of directories in which to
               search for macro files.

          GROFF_TYPESETTER
               Default device.

          GROFF_FONT_PATH
               A colon separated list of directories in which to
               search for the devname directory.

          PATH The search path for commands executed by groff.

          GROFF_TMPDIR
               The directory in which temporary files will be created.
               If this is not set and TMPDIR is set, temporary files
               will be created in that directory.  Otherwise temporary
               files will be created in /tmp.  The grops(1) and
               grefer(1) commands can create temporary files.

     FILES
          /usr/products/src2/gcc/AIX.d/lib/groff/font/devname/DESC
               Device description file for device name.

          /usr/products/src2/gcc/AIX.d/lib/groff/font/devname/F
               Font file for font F of device name.

     AUTHOR
          James Clark <jjc@jclark.com>

     BUGS
          Report bugs to bug-groff@prep.ai.mit.edu.  Include a
          complete, self-contained example that will allow the bug to
          be reproduced, and say which version of groff you are using.

     COPYRIGHT
          Copyright 8c9 1989, 1990, 1991, 1992 Free Software Foundation,
          Inc.

          groff is free software; you can redistribute it and/or
          modify it under the terms of the GNU General Public License
          as published by the Free Software Foundation; either version
          2, or (at your option) any later version.

          groff is distributed in the hope that it will be useful, but
          WITHOUT ANY WARRANTY; without even the implied warranty of
          MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See
          the GNU General Public License for more details.

          You should have received a copy of the GNU General Public
          License along with groff; see the file COPYING.  If not,
          write to the Free Software Foundation, 675 Mass Ave,
          Cambridge, MA 02139, USA.

     AVAILABILITY
          The most recent released version of groff is always
          available for anonymous ftp from prep.ai.mit.edu
          (18.71.0.38) in the directory pub/gnu.

     SEE ALSO
          grog(1), gtroff(1), gtbl(1), gpic(1), geqn(1), gsoelim(1),
          grefer(1), grops(1), grodvi(1), grotty(1), gxditview(1),
          groff_font(5), groff_out(5), groff_ms(7), groff_me(7),
          groff_char(7)