.\"
.\"
.\"
.TH NLP 1L "@date@" "EN" "Optional Local Tools"
.SH NAME
NLP \- New LP, a frontend for PostScript printers
.SH VERSION
Version @version@
.SH SYNOPSIS
.B "nlp "
[
.I options
]
.I files
[[
.I options
]
.I files
] ...
.SH DESCRIPTION
The
.B nlp
program is a frontend to the standard printing commands
.B lp(1)
(SysV) and
.B lpr(1)
(BSD). It is intended to preprocess input
.IR files ,
(provided as explicit files via real filename, or on
.B stdin
if filename is "-") in
.IR ASCII ,
.IR ISO-Latin-1 ,
.I DVI
or still
.I Postscript
format, before sending out to the Postscript printers via these
commands. The purpose for this preprocessing is to create
valid Postscript code from the various inputs.
.PP
.B Nlp
gives the user full control of this preprocessing step by supporting a
lot of options which will adjust the Postscript generation process.
.SH OPTIONS
.TP 0.5i
.B Input Options:
.TP 0.5i
.BI "\-r "
This
.BR r emoves
the print mode command lines which force the printer to a specific mode. They
are usually generated by the Windows printer drivers and need to be stripped
so
.B nlp
is able to recognize that the output is of type PostScript.
.TP 0.5i
.BI "\-f " command
Applies an externa
.BR f ilter,
i.e. the input gets piped through the command before
.B nlp
tries to manipulate the input. Use this option to call the
various
.B fixXXX
filters from Ghostscript, etc. For instance use the
.B fixwfwps
filter to fix a PostScript file generated by Word for Windows.
.sp 1
.TP 0.5i
.B ASCII to Postscript Options:
.TP 0.5i
.BI "\-F " fontsize
The size (in pixels) of the used
.BR f ont.
Default values for the font size are
6.8 in landscape mode and 9.0 in portrait mode. Be careful when using bigger
fonts: They could lead to longer lines WITHOUT linewrapping!
.TP 0.5i
.B "\-B "
Use
.BR b oldface
version of the font.
.TP 0.5i
.BI "\-t " number
Set the
.BR t ab
character indentation to
.I number
characters. Default value is 8.
.TP 0.5i
.B "\-w "
.BR W rap
lines, i.e. fold lines which won't fit into a single output line.
Default is to truncate the lines.
.TP 0.5i
.BI "\-l " number
Output a maximum
.I number
of
.BR l ines
per page. Default value is full page height.
.TP 0.5i
.B "\-N "
Prepend each output line with its line
.BR n umber.
Use this option to print sources or listings. Folded lines (see option -w)
get only one single linenumber on their left hand side.
.TP 0.5i
.BI "\-H " string
Print a
.BR h eader
on each page with
.I string
as its centered title. Default is to make no headers.
.TP 0.5i
.B "\-m "
Visualize the
.BR m etacharacters
Tab, BackSpace and FormFeed
in caret notation, i.e. print them as
.BR ^I ,
.B ^H
and
.BR ^L .
Default is to interpret them.
.sp 1
.TP 0.5i
.B DVI to Postscript Options:
.TP 0.5i
.BI "\-R " dpi
Generate output with a resolution of
.I dpi
when converting DVI format files into Postscript. This is
done via the
.B dvips
program, so please make sure you have the needed PK or VF files or even a
running METAFONT system which will create those files on demand.
.sp 1
.TP 0.5i
.B Common Layout Options:
.TP 0.5i
.B "\-L "
Print in
.BR l andscape
mode, i.e. rotated 90 degree. Default is to print in portrait mode.
.TP 0.5i
.B "\-2 "
Print
.B 2
logical input pages onto 1 physical output page. Notice: this doesn't
imply landscape mode. To get a real landscape output, use this option
in conjunction with -L.
.TP 0.5i
.B "\-4 "
Print
.B 4
logical input pages onto 1 physical output page.
.TP 0.5i
.BI "\-s " range
.BR S elect
pages from
.I resulting
Postscript file.
Default is all pages, i.e. the complete document. If this option
is used the
.I range
argument can be one of
.PD 0
.TP 1.0i
.RS
.PD 0
.TP
.B #
That specific page only
.TP
.B #-
All pages beginning from that page
.TP
.B -#
All pages up to this page
.TP
.B #-#
All pages from first to second specified page
.TP
.B e
Only even pages
.TP
.B o
Only odd pages
.TP
.B S
First odd, then even pages
.TP
.B r
Reverse order of the pages. Use this option for some clumsy printers to
become the pages in the correct sequence in the output tray
.TP
.B B
Rearrange pages into signatures (for booklets)
.PD
.RE
.TP 0.5i
.B "\-b "
Draw a
.BR b order
around each output page. (Yes, this works for all types of input format
files: ASCII, DVI and Postscript). Default is no border drawing.
.sp 1
.TP 0.5i
.B Output Options:
.TP 0.5i
.BI "\-c " number
Print
.I number
.BR c opies
of each document. This is a simple abbreviation for
multiple runs of the
.B nlp
program. Default is exactly one copy per document.
.TP 0.5i
.B "\-p "
.BR P review
the resulting output Postscript document before actually printing it or
saving it to a file. This is done via the
.B ghostview
program, which in itself uses the
.B ghostscript
program to interpret the Postscript format file. This works
under the X-Window system only, because
.B ghostview
is an X11 application. Default is no previewing.
.TP 0.5i
.BI "\-P " printer
The name of the target
.BR p rinter.
This is the same name you would
give for the analogue (equally named) option from
.B lpr(1)
or for the
.B "\-d"
option from
.BR lp(1).
Default is the printer name set via the environment
variable $PRINTER.
.TP 0.5i
.BI "\-d " printer
Alternative option to specify the target printer. This is provided
with the same option from the SysV
.B lp(1)
command in mind.
.TP 0.5i
.BI "\-o " file
Write resulting
.BR o utput
to
.I file
(or
.B stdout
when file is "-") instead of sending it to the default printer.
.sp 1
.TP 0.5i
.B Printer Options:
.TP 0.5i
.B "\-D "
Print output in
.BR d uplex
mode. Notice: This only works if the destination printer has
a built-in duplex unit. Default is no duplex mode selection.
.TP 0.5i
.B "\-S "
Print output in
.BR s implex
mode. Notice: This only works if the destination printer has
a built-in duplex unit.
Use this option to force a printer in "duplex is on per default" mode to
print simplex. Default is no simplex mode selection.
.TP 0.5i
.BI "\-T " number
Select the paper
.BR t ray
.I number
on the destination printer (where
.I number
usually is in the range 0-n). Notice: This only works if the
destination printer has more than one paper tray. Default
is no papertray selection.
.TP 0.5i
.B "\-M "
Print output in
.BR m anual
paper feed mode. Notice: This only works if the destination printer has
papertrays with a manual feed option.
.sp 1
.TP 0.5i
.B Special Command Options:
.TP 0.5i
.B "\-q "
Display
.BR q ueue
of the specificly selected (using -P or -d) or otherwise default printer
.br
.I THIS OPTION IS NOT YET
.I FULLY IMPLEMENTED !!
.TP 0.5i
.B "\-Q "
Display
.BR q ueue
of all printers
.br
.I THIS OPTION IS NOT YET
.I FULLY IMPLEMENTED !!
.TP 0.5i
.B "\-i "
Display
.BR i nformation
of the specific selected (or default) printer
.br
.I THIS OPTION IS NOT YET
.I FULLY IMPLEMENTED !!
.TP 0.5i
.B "\-I "
Display
.BR i nformation
of all printers
.br
.I THIS OPTION IS NOT YET
.I FULLY IMPLEMENTED !!
.TP 0.5i
.B "\-n "
.BR N otify
the system administrators about a problem with the selected (or default)
printer. Your $EDITOR (or, if not set, the program
.B vi
) is started to enter the message.
.br
.I THIS OPTION IS NOT YET
.I FULLY IMPLEMENTED !!
.TP 0.5i
.B "\-h "
Display a
.BR h elp
page which summarises the complete set of
.B nlp
options.
.TP 0.5i
.B "\-V "
Display the
.BR v ersion
of the
.B nlp
program.
.sp 1
.TP 0.5i
.B General Processing Options:
.TP 0.5i
.B "\-v "
Run in
.BR v erbose
mode, i.e. let the user see what's happening.
.TP 0.5i
.B "\-e "
Run in
.BR e xpert
mode, i.e. do not query the user with "Are you sure" messages.
.TP 0.5i
.B "\-x "
Run in debug mode, i.e. give the user a lot of processing information.
.br
.I THIS OPTION IS NOT YET
.I FULLY IMPLEMENTED !!
.SH OPTIONS SUMMARY
.nf
.RS -.3i
---------------------------------------------------------------------------
Input Options: Output Options:
r remove print mode header c # print multiple copies (def: 1)
p preview output before printing
ASCII to Postscript Options: P,d s select printer (def: $printer)
F # fontsize in points o s write to file instead of printer
B use bold font
t # tabindent (def: 8) Printer Options:
w wrap/fold lines if too long D force duplex mode
l # lines per page (adj.fontsize) S force simplex mode
N line-numbers T # select papertray
H s page header M manual paper input
m visualize metachars TAB,BS,FF
Special Command Options:
DVI to Postscript Options: q display queue of specific printer
R # resolution in DPI (def: 300) Q display queue of all printers
i information about specific printer
Common Layout Options: I information about all printers
L landscape mode (def: portrait) n notify admin about printer trouble
2 two pages on one physical h this page
4 four pages on one physical V version information
s r print only selected pages
b draw surrounding borders General Processing Options:
v verbose mode
#=number e expert mode
f=file x debug mode
s=string
r=range (#,-#,#-,#-#,r,o,e,S,B)
---------------------------------------------------------------------------
.RE
.fi
.SH SPECIALS
You can set the environment variable
.B NLPOPTS
to hold a string containing any part of an
.B nlp
command line. This can be used to set private NLP default options.
For example, use
.nf
.RS 1i
.B NLPOPTS="-D -T1"
.B export NLPOPTS
.RE
.if
(for Bourne-Shell users) or
.nf
.RS 1i
.B setenv NLPOPTS '-D -T1'
.RE
.if
(for C-Shell users) to print in duplex mode on
papertray number 1.
.SH FILES
.TP 0.5i
@libdir@/printer.cap
The printer capability database. Has to be setup by the system administrators
to provide
.B nlp
with information about available printers.
.SH "SEE ALSO"
lpr(1), lp(1)
.SH AUTHOR
.nf
Ralf S. Engelschall
rse@engelschall.com
www.engelschall.com
.fi
.SH COPYRIGHT
.nf
Copyright (c) 1992-1997
Ralf S. Engelschall,
All Rights Reserved.
Copyright (c) 1992-1993 [version 1 only]
software design & management (sd&m) GmbH & Co KG,
All Rights Reserved.
Copyright (c) 1995 [version 2 only]
Technische Universitaet Muenchen (TUM),
All Rights Reserved.
.fi