LPTOPS(1) Printing Tools LPTOPS(1)
NAME
lptops - convert a text file into a PostScript file
SYNOPSIS
lptops [-B #] [-C n] [-D] [-E header]
[-F fontname] [-G] [-H] [-I #] [-J printer]
[-K n] [-L #] [-M n] [-N [tb][lcr]n]
[-O #] [-P #] [-Q] [-R #] [-T #] [-U]
[-V] [-W] [-X] infile
DESCRIPTION
lptops converts a text file into a PostScript file for printing on
an Apple LaserWriter, or any other PostScript-compatible output
device. It supports selection of a variety of fonts at arbitrary
point sizes, margin specification, portrait and landscape page
orientation, automatic page numbering, page outlining, and multi-column
printing.
This program is usually used to print ascii text files. However, it can
also be used to print files which contain ISO 8859-1 characters. To
print a file with ISO 8859-1 characters, specify a text font, such as the
default Courier font.
In the option descriptions below, physical dimensions described as # may
be specified as a single number with an optional fractional part, and a
required two-letter unit designator. Letter case is ignored. Possible
forms are:
#.##bp big point (1in=72bp) [Courier: 120.000/Pbp cpi]
#.##cm centimeter [Courier: 4.233/Pcm cpi]
#.##in inch [Courier: 1.667/Pin cpi]
#.##mm millimeter (10mm=1cm) [Courier: 42.333/Pmm cpi]
#.##pt point (72.27pt=1in) [Courier: 120.450/Ppt cpi]
The bracketed values give the number of characters per inch (cpi) for a
point size of P units with the fixed-width Courier font.
Options are parsed left to right. So, always the most recent option is
considered when there is a conflict. For example,
lptops -U -X
here, -X will be considered.
The letter case is ignored in the options and the following options may
appear in any order.
-B # Bottom margin of #.
-C n Print n copies of each page.
Page 1
LPTOPS(1) Printing Tools LPTOPS(1)
-D Use the Standard PostScript character set for text fonts. If this
option is not specified, the program will check whether the
specified font contains ISO 8859-1 (Latin-1) characters. If so, it
will use the ISO 8859-1 character set. Otherwise, it will use the
default character set for the specified font.
-E header
The header string will be used to print the gaudy header if -G
option is turned on. This flag has no effect if -G is not used.
-F fontname
PostScript fontname. Possible values with acceptable short
abbreviations (formed from the upper-case letters in the font
names) are as follows. The following 35 typefaces are available
on most of the PostScript printers. Some old printers may support
only the first 13 typefaces.
Full Name Abbreviation
______________________________________________________
Courier C
Courier-Bold CB
Courier-BoldOblique CBO
Courier-Oblique CO
Helvetica H
Helvetica-Bold HB
Helvetica-BoldOblique HBO
Helvetica-Oblique HO
Symbol S
Times-Bold TB
Times-BoldItalic TBI
Times-Italic TI
Times-Roman T
AvantGarde-Book AGB
AvantGarde-BookOblique AGBO
AvantGarde-Demi AGD
AvantGarde-DemiOblique AGDO
Bookman-Demi BD
Bookman-DemiItalic BDI
Bookman-Light BL
Bookman-LightItalic BLI
Helvetica-Narrow HN
Helvetica-Narrow-Bold HNB
Helvetica-Narrow-BoldOblique HNBO
Helvetica-Narrow-Oblique HNO
NewCenturySchlbk-Bold NCSB
NewCenturySchlbk-BoldItalic NCSBI
NewCenturySchlbk-Italic NCSI
NewCenturySchlbk-Roman NCSR
Palatino-Bold PB
Page 2
LPTOPS(1) Printing Tools LPTOPS(1)
Palatino-BoldItalic PBI
Palatino-Italic PI
Palatino-Roman PR
ZapfChancery-MediumItalic ZCMI
ZapfDingbats ZD
The user is not limited to the above 35 typefaces. If there are any
additional fonts that have been downloaded into the PostScript
printer, then they can be used by specifying them through fontname.
If the requested font is not found, then the PostScript interpreter
will substitute it with a Courier font.
Only the Courier fonts have fixed widths like typewriter and line
printer fonts. The others are proportionally spaced for improved
readability, and consequently, tabular material will not line up
properly with them.
-G Turn on page decorations. Prints Date,Time,File name and Page
number. If a header is specified with the -E option, it will
override file name.
-H Horizontal page orientation (landscape mode) instead of vertical
page orientation (portrait mode).
-I # Top margin of # for initial page (for letterheads); if not
specified, it will default to the value given for the top margin
by default or by the -T# command.
-J printer
The printer on which the document ( output ) is going to be printed.
The printer has to be installed on the system. If this option is not
specified, lptops assumes 8.5x11in page size and 0.35in margins.
-K n The maximum number of lines to be printed on the page. Default is 66
lines.
-L # Left margin of #.
-M n Multiple column output (n columns). In multiple column mode,
formfeeds cause column breaks instead of page breaks.
-N [tb][lcr]n
Number output pages. The number is placed by default in the center
of the top margin, but the margin can be selected explicitly by
t (top) or b (bottom), and the position of the page number can be
further specified by l (left), c (center), or r (right). If an
initial top margin value is given with the -I# option, numbering
will be omitted on the first page if it is at the top. Pages are
unnumbered if this option is not specified.
Page 3
LPTOPS(1) Printing Tools LPTOPS(1)
-O # Draw a # unit wide outline for pages/columns. In multi-column mode a
rectangular box is drawn around each column. A 0.4pt width outline
is an optimal choice for this option.
-P # Font point size. The point size also determines the interline
spacing.
-Q Turn on debug messages.
-R # Right margin of #.
-T # Top margin of #.
-U Output pages in unsorted (first to last) order instead of in
sorted (page reversed) order; some PostScript printers have page
handlers that stack the paper in this order. The default is sorted
because this is appropriate for the most common PostScript
printer,the Apple LaserWriter. Note that the newer Apple LaserWriter
II series stacks pages reversed. Therefore, the -U option should be
used when sending print jobs to a LaserWriter II printer.
-V Vertical page orientation (portrait mode) instead of Horizontal
page orientation (landscape mode).
-W Wraps long lines in the text instead of clipping them. lptops reads
the character width information from fontmetric files in
/usr/lib/DPS/AFM to do the line width calculations. If the requested
font's fontmetrics file is not found, then lptops ignores this
switch and defaults to clip mode. Default mode is to clip text in
long lines.
-X Output pages in sorted (last to first) order instead of in
unsorted (-U option) order; some printers have page handlers
that stack the paper in this order. The default is sorted because
this is appropriate for the most common PostScript printer, the
Apple LaserWriter.
Defaults are:
lptops -B0.35in -C1 -FCourier -K66 -L0.35in -M1 -R0.35in -T0.35in -X
BUGS
Currently, lptops is not able to handle files that generate more than
1024 total pages.
FILES
/usr/lib/print/lptops filter to convert text to PostScript.
Page 4
LPTOPS(1) Printing Tools LPTOPS(1)
SEE ALSO
lp(1)
Page 5