Manual page for PTROFF(1)
ptroff - troff to a POSTSCRIPT printer
SYNOPSIS
ptroff
[
-t
] [
-lpaperlength
] [
-ssize
] [
-Ffamily
] [
troff options
] [
spool options
] [
files
]
DESCRIPTION
ptroff
is a shell script that runs
[o]troff(1)
in an environment to produce output on a POSTSCRIPT printer. It uses
pscat
to convert
troff
C/A/T output to a POSTSCRIPT print file, and spools this for printing.
If no
files
are specified, the standard input is used.
Page offset distances and the page length
are specified by giving a fixed-point real number optionally
followed by a units measure. For example, 1in means one inch, 15mm means
fifteen millimeters. If no units are indicated, points (72 to the inch)
are used.
In addition to the standard
[o]troff
options, the following options are understood by
ptroff.
- -t
-
sends the POSTSCRIPT output to the standard output,
rather than spooling it to a printer.
Note that this overrides the meaning of the
troff
-t
option; if you want the C/A/T file, run
[o]troff
directly.
- -l pagelength
-
specifies the page length to use when splitting the
C/A/T file into POSTSCRIPT pages. The default is 11in.
Units are described above.
- -s size
-
chooses a paper size for printing, such as
Letter, Legal, or A4.
- -F fontfamily
-
names a font family to load into
[o]troff
and
pscat.
Fontfamily
is used to name both a
*.head
file containing
troff
``fp'' commands, and a
*.ct
file containing a character mapping for
pscat.
Fontfamilies ``Times'' and ``Helvetica'' are probably
defined at your site, others may be available.
In 4.2bsd UNIX systems, the following spooler options are passed on to
lpr.
- -Pprinter
-
causes the output to be sent to the named printer.
- -#n
-
causes
n
copies of the output to be produced. The default is one.
- -h
-
suppress the printing of the job burst page.
- -C class
-
set the job classification for use on the burst page.
- -J name
-
set the job name for use on the burst page. Otherwise, the name of the
first input file will be used.
- -m
-
send mail after files have been printed.
In System V UNIX systems, the following spooler options are passed on to
lp.
- -ddest
-
causes the output to be sent to the named destination.
- -nn
-
causes
n
copies of the output to be produced. The default is one.
- -h
-
suppress the printing of the job burst page.
- -r
-
don't page-reverse the output.
- -s
-
suppress messages from
lp.
- -m
-
send mail after files have been printed.
- -w
-
write to user's terminal after files have been printed.
ENVIRONMENT
- PRINTER (4.2bsd)
-
the name of a printer (as in the
-P
option) for
lpr
to use. If no
-P
option is specified,
lpr
will use this printer. If neither
-P
nor PRINTER is set,
ptroff
will spool to a printer named ``PostScript''.
- LPDEST (System V)
-
the name of a printer (as in the
-d
option) for
lp
to use. If no
-d
option is specified,
lp
will use this printer. If neither
-d
nor LPDEST is set,
ptroff
will spool to a printer class named ``PostScript''.
FILES
- XTROFFFONTDIRX/*.ct
-
character correspondence tables for
pscat.
- XTROFFFONTDIRX/*.head
-
troff
headers containing ``.fp'' commands.
- XTROFFFONTDIRX/ftXX
-
font width files for
troff.
- XPSLIBDIRX/pscat.pro
-
default POSTSCRIPT prologue for
pscat.
SEE ALSO
pscat(1), pscatmap(8).
4.2bsd: troff(1).
System V: otroff(1).
J. F. Ossanna,
Nroff/Troff user's manual
Documenter's Workbench
AUTHOR
Adobe Systems Incorporated
BUGS
Because of the character mapping tables used, explicit
use of the ``.fp'' troff directive will usually produce the
wrong result. Users must build and reference correct tables with
pscatmap.8
for non-standard ``.fp'' combinations to work.
More flexibility is allowed by using
troff,
pscat,
and the spooler separately.
NOTES
POSTSCRIPT is a trademark of Adobe Systems Incorporated.
Times and Helvetica are registered trademark of Allied Corporation.
Documenter's Workbench is a trademark of AT&T Technologies.
Created by unroff & hp-tools.
© somebody (See intro for details). All Rights Reserved.
Last modified 11/5/97
