


GROFF(1)                                                 GROFF(1)


NNAAMMEE
       groff - front end for the groff document formatting system

SSYYNNOOPPSSIISS
       ggrrooffff [ --ttppeesszzaaiivvhhbbllCCEENNRRVVZZ ] [  --ww_n_a_m_e  ]  [  --WW_n_a_m_e  ]  [
       --HH_f_i_l_e  ] [ --mm_n_a_m_e ] [ --FF_d_i_r ] [ --TT_d_e_v ] [ --ff_f_a_m ] [ --MM_d_i_r
       ] [ --dd_c_s ] [ --rr_c_n ] [ --nn_n_u_m ] [  --oo_l_i_s_t  ]  [  --PP_a_r_g  ]  [
       _f_i_l_e_s... ]

DDEESSCCRRIIPPTTIIOONN
       ggrrooffff is a front-end to the groff document formatting sys-
       tems.  Normally it runs the ggttrrooffff program and a  postpro-
       cessor  appropriate  for  the  selected device.  Available
       devices are:

       ppss     For PostScript printers and previewers

       ddvvii    For TeX dvi format

       XX7755    For a 75 dpi X11 previewer

       XX110000   For a 100dpi X11 previewer

       XXppss    For X11 previewer used with intermediate output for
              ppss device.

       aasscciiii  For typewriter-like devices

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

       The default device is aasscciiii.  It can optionally preprocess
       with any of ggppiicc, ggeeqqnn, ggttbbll, ggrreeffeerr, or ggssooeelliimm..  It will
       also load any macros and eqn definitions  required  for  a
       particular  device.   It can also spool the resulting out-
       put.

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

OOPPTTIIOONNSS
       --hh     Print a help message.

       --ee     Preprocess with geqn.

       --tt     Preprocess with gtbl.

       --pp     Preprocess with gpic.

       --ss     Preprocess with gsoelim.

       --RR     Preprocess  with  grefer.  No mechanism is provided
              for passing arguments to ggrreeffeerr because most grefer
              options  have  equivalent  commands  which  can  be



Groff Version 1.05       30 October 1991                        1





GROFF(1)                                                 GROFF(1)


              included in  the  file.   See  ggrreeffeerr(1)  for  more
              details.

       --vv     Make  programs run by ggrrooffff print out their version
              number.

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

       --zz     Suppress  output  from ggttrrooffff.  Only error messages
              will be printed.

       --ZZ     Do not postprocess the output of ggttrrooffff.   Normally
              ggrrooffff  will automatically run the appropriate post-
              processor.

       --PP_a_r_g  Pass  _a_r_g  to  the  postprocessor.   Each  argument
              should  be  passed with a separate --PP option.  Note
              that ggrrooffff does not prepend -- to _a_r_g before passing
              it to the postprocessor.

       --ll     Spool the output.

       --LL_a_r_g  Pass  _a_r_g  to the spooler.  Each argument should be
              passed with a separate --LL option.  Note that  ggrrooffff
              does  not prepend -- to _a_r_g before passing it to the
              postprocessor.

       --TT_d_e_v  Prepare output for device _d_e_v.  The default  device
              is aasscciiii.

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

       --aa
       --bb
       --ii
       --CC
       --EE
       --ww_n_a_m_e
       --WW_n_a_m_e
       --mm_n_a_m_e
       --oo_l_i_s_t
       --dd_c_s
       --rr_c_n
       --FF_d_i_r
       --MM_d_i_r
       --HH_f_i_l_e
       --ff_f_a_m
       --nn_n_u_m  These are as described in ggttrrooffff(1)..

EENNVVIIRROONNMMEENNTT
       GGRROOFFFF__TTMMAACC__PPAATTHH
              A colon separated list of directories in  which  to



Groff Version 1.05       30 October 1991                        2





GROFF(1)                                                 GROFF(1)


              search for macro files.

       GGRROOFFFF__TTYYPPEESSEETTTTEERR
              Default device.

       GGRROOFFFF__FFOONNTT__PPAATTHH
              A  colon  separated list of directories in which to
              search for the ddeevv_n_a_m_e directory.

       GGRROOFFFF__HHYYPPHHEENN
              File containing hyphenation patterns.

       PPAATTHH   The search path for commands executed by ggrrooffff.

       GGRROOFFFF__TTMMPPDDIIRR
              The directory in which temporary files will be cre-
              ated.  If this is not set and TTMMPPDDIIRR is set, tempo-
              rary files will be created in that directory.  Oth-
              erwise  temporary  files  will  be created in //ttmmpp.
              The ggrrooppss(1) and ggrreeffeerr(1) commands can create tem-
              porary files.

FFIILLEESS
       //uussrr//lliibb//ggrrooffff//hhyypphheenn                 Hyphenation patterns

       //uussrr//lliibb//ggrrooffff//ttmmaacc//ttmmaacc.._n_a_m_e         Macro file  used  by
                                             --mm_n_a_m_e.

       //uussrr//lliibb//ggrrooffff//ffoonntt//ddeevv_n_a_m_e//DDEESSCC      Device   description
                                             file   for    device
                                             _n_a_m_e.

       //uussrr//lliibb//ggrrooffff//ffoonntt//ddeevv_n_a_m_e//_F         Font file for font _F
                                             of device _n_a_m_e.

       //uussrr//lliibb//ggrrooffff//ffoonntt//ddeevv_n_a_m_e//eeqqnncchhaarr   ggeeqqnn definitions for
                                             device _n_a_m_e.

SSEEEE AALLSSOO
       ggrroogg(1), ggttrrooffff(1), ggttbbll(1), ggppiicc(1), ggeeqqnn(1), ggssooeelliimm(1),,
       ggrreeffeerr(1), ggrrooppss(1), ggrrooddvvii(1), ggrroottttyy(1),  ggrrooffff__ffoonntt(5),
       ggrrooffff__oouutt(5), ggrrooffff__mmss(7), ggrrooffff__mmee(7)
       _G_r_o_f_f _C_h_a_r_a_c_t_e_r _N_a_m_e_s














Groff Version 1.05       30 October 1991                        3


