4.3BSD/usr/contrib/xns/examples/print/xnsprint.1

.TH xnsprint 1 Cornell
.UC 4
.tr -\-
." differences between troff and nroff compensated here:
.ie t .ds sc \(sc
.el .ds sc section\
.ds lq \&"\"
.ds rq \&"\"
.if t \
.	ds lq ''
.if t \
.	ds rq ``
.SH NAME
xnsprint -- Print an interpress master on a Xerox NS print server
.SH SYNOPSIS
xnsprint [options] file1 ... filen
.SH DESCRIPTION
.I Xnsprint 
delivers each interpress master in \*(lqfile1\*(rq through \*(lqfilen\*(rq
to a Xerox Network Systems
print server for formatting and printing.  
.I Xnsprint 
first requests status
information from the print server, and delays actually sending the file until
the server's spooler is available.  Unless the -q flag is specified, the printer
status information recieved will be written to standard out.
.PP
The possible options are:
.TP
.BI -c \ n
Causes
.I n
copies of the output to be printed.  The default is 1.
.TP
.BI -n \ name
Sets the delivery address of your output (the \*(lqFor\*(rq field on the
cover sheet) to
.IR name .
The default is your full name as recorded in the gecos field of the password
file (\*(lq/etc/passwd\*(rq).
.TP
.BI -b \ banner
Uses
.I banner
to label the output.  It will appear on the cover page on the line labeled
\*(lqDocument\*(rq.  The default is the name of the input file.
.TP
.BI -P \ printer
Delivers the interpress master to
.IR printer ,
where 
.I printer
is the Clearinghouse name of the print server.
If no printer is specified, the first printing service listed in the local
clearinghouse domain will be used.
.TP
.B -r
Causes 
.I xnsprint
to unlink the input file after delivery to the print server.
.TP
.B -q
Causes
.I xnsprint
to be quiet about printer status and file delivery.  Messages indicating that
the printer needs human attention will still be displayed.
.SH FILES
/etc/passwd	for user names
/usr/new/lib/xnscourier/clearinghouse.addresses	for clearinghouse information
.SH NOTES
.I Xnsprint
may also be used as a printing filter by the lpr spooling system.  If used
in this manner, the (otherwise undocumented)
.BI -a logfile
switch may be used to direct log output to a particular file.
.SH "SEE ALSO"
maha(1), dipress(1)
.PP
Interpress Electronic Printing Standard, \s8XSIS\s0 048404
.SH DIAGNOSTICS
Various messages stating that the printer is unavailable or needs some kind
of attention.
.PP
Returns a status of 0 on success, 1 or 2 to indicate a temporary error from 
which the appropriate recovery is to continue retrying, and 3 to indicate
serious errors which can not be recovered by retrying.
.SH BUGS
The printer claims that it \*(lqNeeds Key Operator\*(rq when it is really just
warming up.
.PP
.SH AUTHORS
JQ Johnson and Bill Nesheim
.PP