4.4BSD/usr/src/contrib/xns/man/xnsprint.n

.TH XNSPRINT 1 Cornell
.\" $Header: xnsprint.n,v 1.4 87/01/15 16:57:15 ed Exp $
.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 rq ''
.if t \
.	ds lq ``
.SH NAME
xnsprint \- Print an interpress master on a Xerox NS print server
.SH SYNOPSIS
xnsprint [options] file [file ...]
.SH DESCRIPTION
.I Xnsprint 
delivers the interpress master in \*(lqfile\*(rq 
to a Xerox Network Systems
print server for formatting and printing.  
If no printer is specified, the value of the environment variable PRINTER 
will be used. If this variable has no value, the first printer found in
the local Clearinghouse is used.
.PP
.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 received will be written to standard out.
If an attempt to send the file(s) to the printer fails, a status value is
returned to the caller which can be used to determine whether retrying is
appropriate.  Currently, a status of 0 indicates that the file was
successfully sent to the printer, a status of 1 indicates that continued
retries are appropriate, 2 suggests retrying a few times then giving up, and
3 indicates a hard error which should make the caller give up.
.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
.TP
.BI -h \ printer
Delivers the interpress master to
.IR printer ,
where 
.I printer
is either the clearinghouse name or the network address of the print server.
If an incomplete clearinghouse name (e.g. \*(lqslander\*(rq) is specified,
domain and organization fields are defaulted using 
.IR CH.default .
.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.
.TP
.BI -a \ filename
Write lpd(8) status information to the file
.IR filename .
.TP
.B -l
Request legal-sized paper.  If the printer has legal paper mounted in one
tray, that tray will be used.
.TP
.BI -s \ papersize
Request
.I papersize
sized paper.  The argument may be an integer or one of ``usLetter,''
``usLegal,'' ``a0,'' etc.  If the requested paper size is not available a
serviceUnavailable error will be returned.
.TP
.BI -m \ message
Use
.I message
as the value for the message field passed to the printer and printed on the
cover sheet.  Default is your
printer's XNS host name, for want of anything better.
.TP
.BI -W
Causes
.I xnsprint
to wait until the files sent are actually printed before returning.
Appropriate status messages are displayed during the waiting period.
.SH FILES
.nf
/etc/passwd		for user names
/usr/new/lib/xnscourier/CH.default	for Clearinghouse defaults
.fi
.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.
.SH BUGS
Probably lots of them.  In particular, the 
.B -l
flag should be generalized.
.PP
The printer claims that it \*(lqNeeds Key Operator\*(rq when it is really just
warming up.
.PP
.SH AUTHORS
JQ Johnson, Larry Parmelee, and Bill Nesheim
.PP