--help
displays a usage message, while -v
and --version
show
version information; all exit afterward.
-b
n Provide workarounds for older printers, broken spoolers,
and previewers. Normally grops
produces output at
PostScript LanguageLevel 2 that conforms to the Document
Structuring Conventions version 3.0. Some older printers,
spoolers, and previewers can't handle such output. The
value of n controls what grops
does to make its output
acceptable to such programs. A value of 0 causes grops
not to employ any workarounds.
Add 1 if no %%BeginDocumentSetup
and %%EndDocumentSetup
comments should be generated; this is needed for early
versions of TranScript that get confused by anything
between the %%EndProlog
comment and the first %%Page
comment.
Add 2 if lines in included files beginning with %!
should
be stripped out; this is needed for Sun's pageview
previewer.
Add 4 if %%Page
, %%Trailer
and %%EndProlog
comments should
be stripped out of included files; this is needed for
spoolers that don't understand the %%BeginDocument
and
%%EndDocument
comments.
Add 8 if the first line of the PostScript output should be
%!PS-Adobe-2.0
rather than %!PS-Adobe-3.0
; this is needed
when using Sun's Newsprint with a printer that requires
page reversal.
Add 16 if no media size information should be included in
the document (that is, neither use %%DocumentMedia
nor the
setpagedevice
PostScript command). This was the behaviour
of groff version 1.18.1 and earlier; it is needed for
older printers which don't understand PostScript
LanguageLevel 2. It is also necessary if the output is
further processed to get an encapsulated PS (EPS) file –
see below.
The default value can be specified by a
broken
n
command in the DESC file. Otherwise the default value
is 0.
-c
n Print n copies of each page.
-F
dir Prepend directory dir/devname to the search path for
prologue, font, and device description files; name is the
name of the device, usually ps
.
-g
Guess the page length. This generates PostScript code
that guesses the page length. The guess is correct only
if the imageable area is vertically centered on the page.
This option allows you to generate documents that can be
printed both on letter (8.5×11) paper and on A4 paper
without change.
-I
dir This option may be used to add a directory to the search
path for files on the command line and files named in
\X'ps: import'
and \X'ps: file'
escapes. The search path
is initialized with the current directory. This option
may be specified more than once; the directories are then
searched in the order specified (but before the current
directory). If you want to make the current directory be
read before other directories, add -I.
at the appropriate
place.
No directory search is performed for files with an
absolute file name.
-l
Print the document in landscape format.
-m
Turn manual feed on for the document.
-p
paper-size
Set physical dimension of output medium. This overrides
the papersize
, paperlength
, and paperwidth
commands in the
DESC file; it accepts the same arguments as the papersize
command. See groff_font(5) for details.
-P
prologue-file
Use the file prologue-file (in the font path) as the
prologue instead of the default prologue file prologue
.
This option overrides the environment variable
GROPS_PROLOGUE.
-w
n Lines should be drawn using a thickness of n thousandths
of an em. If this option is not given, the line thickness
defaults to 0.04 em.