4.4BSD/usr/share/man/cat1/groff.0

Compare this file to the similar file:
Show the results in this format:

GROFF(1) BSD Reference Manual GROFF(1)

NNAAMMEE
groff - front end for the groff document formatting system

SSYYNNOOPPSSIISS
ggrrooffff [ --ttppeesszzaaiivvhhbbllCCEENNRRVVXXZZ ] [ --ww_n_a_m_e ] [ --WW_n_a_m_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-
tem. Normally it runs the ttrrooffff program and a postproces-
sor 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

aasscciiii For typewriter-like devices

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

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

The default device is ppss. It can optionally preprocess
with any of ppiicc, eeqqnn, ttbbll, rreeffeerr, or ssooeelliimm..

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

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

OOPPTTIIOONNSS
--hh Print a help message.

--ee Preprocess with eqn.

--tt Preprocess with tbl.

--pp Preprocess with pic.

--ss Preprocess with soelim.

Groff Version 1.08 29 October 1992 1

GROFF(1) BSD Reference Manual GROFF(1)

--RR Preprocess with refer. No mechanism is provided
for passing arguments to rreeffeerr because most refer
options have equivalent commands which can be
included in the file. See rreeffeerr(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 ttrrooffff. Only error messages
will be printed.

--ZZ Do not postprocess the output of ttrrooffff. 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 Send the output to a printer. The command used for
this is specified by the pprriinntt command in the
device description file.

--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 ppss.

--XX Preview with ggxxddiittvviieeww instead of using the usual
postprocessor. This is unlikely to produce good
results except with --TTppss.

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

--aa
--bb
--ii
--CC
--EE
--ww_n_a_m_e
--WW_n_a_m_e
--mm_n_a_m_e

Groff Version 1.08 29 October 1992 2

GROFF(1) BSD Reference Manual GROFF(1)

--oo_l_i_s_t
--dd_c_s
--rr_c_n
--FF_d_i_r
--MM_d_i_r
--ff_f_a_m
--nn_n_u_m These are as described in ttrrooffff(1)..

EENNVVIIRROONNMMEENNTT
GGRROOFFFF__CCOOMMMMAANNDD__PPRREEFFIIXX
If this is set _X, then ggrrooffff will run _Xttrrooffff
instead of ttrrooffff. This also applies to ttbbll, ppiicc,
eeqqnn, rreeffeerr and ssooeelliimm. It does not apply to ggrrooppss,
ggrrooddvvii, ggrroottttyy and ggxxddiittvviieeww.

GGRROOFFFF__TTMMAACC__PPAATTHH
A colon separated list of directories in which to
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.

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 rreeffeerr(1) commands can create tem-
porary files.

FFIILLEESS
//uussrr//sshhaarree//ggrrooffff__ffoonntt//ddeevv_n_a_m_e//DDEESSCC
Device description file for device _n_a_m_e.

//uussrr//sshhaarree//ggrrooffff__ffoonntt//ddeevv_n_a_m_e//_F
Font file for font _F of device _n_a_m_e.

AAUUTTHHOORR
James Clark <jjc@jclark.com>

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

Groff Version 1.08 29 October 1992 3

GROFF(1) BSD Reference Manual GROFF(1)

CCOOPPYYRRIIGGHHTT
Copyright (C) 1989, 1990, 1991, 1992 Free Software Founda-
tion, 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 war-
ranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PUR-
POSE. 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, Cam-
bridge, MA 02139, USA.

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

SSEEEE AALLSSOO
ggrroogg(1), ttrrooffff(1), ttbbll(1), ppiicc(1), eeqqnn(1), ssooeelliimm(1),,
rreeffeerr(1), ggrrooppss(1), ggrrooddvvii(1), ggrroottttyy(1), ggxxddiittvviieeww(1),
ggrrooffff__ffoonntt(5), ggrrooffff__oouutt(5), ggrrooffff__mmss(7), ggrrooffff__mmee(7),
ggrrooffff__cchhaarr(7)

Groff Version 1.08 29 October 1992 4