Annotation of 43BSDTahoe/new/xns/man/xnsprint.n, revision 1.1.1.1

1.1       root        1: .TH XNSPRINT 1 Cornell
                      2: .\" $Header: xnsprint.n,v 1.4 87/01/15 16:57:15 ed Exp $
                      3: .UC 4
                      4: .tr -\-
                      5: ." differences between troff and nroff compensated here:
                      6: .ie t .ds sc \(sc
                      7: .el .ds sc section\
                      8: .ds lq \&"\"
                      9: .ds rq \&"\"
                     10: .if t \
                     11: .      ds rq ''
                     12: .if t \
                     13: .      ds lq ``
                     14: .SH NAME
                     15: xnsprint \- Print an interpress master on a Xerox NS print server
                     16: .SH SYNOPSIS
                     17: xnsprint [options] file [file ...]
                     18: .SH DESCRIPTION
                     19: .I Xnsprint 
                     20: delivers the interpress master in \*(lqfile\*(rq 
                     21: to a Xerox Network Systems
                     22: print server for formatting and printing.  
                     23: If no printer is specified, the value of the environment variable PRINTER 
                     24: will be used. If this variable has no value, the first printer found in
                     25: the local Clearinghouse is used.
                     26: .PP
                     27: .I Xnsprint 
                     28: first requests status
                     29: information from the print server, and delays actually sending the file until
                     30: the server's spooler is available.  Unless the -q flag is specified, the printer
                     31: status information received will be written to standard out.
                     32: If an attempt to send the file(s) to the printer fails, a status value is
                     33: returned to the caller which can be used to determine whether retrying is
                     34: appropriate.  Currently, a status of 0 indicates that the file was
                     35: successfully sent to the printer, a status of 1 indicates that continued
                     36: retries are appropriate, 2 suggests retrying a few times then giving up, and
                     37: 3 indicates a hard error which should make the caller give up.
                     38: .PP
                     39: The possible options are:
                     40: .TP
                     41: .BI -c \ n
                     42: Causes
                     43: .I n
                     44: copies of the output to be printed.  The default is 1.
                     45: .TP
                     46: .BI -n \ name
                     47: Sets the delivery address of your output (the \*(lqFor\*(rq field on the
                     48: cover sheet) to
                     49: .IR name .
                     50: The default is your full name as recorded in the gecos field of the password
                     51: file (\*(lq/etc/passwd\*(rq).
                     52: .TP
                     53: .BI -b \ banner
                     54: Uses
                     55: .I banner
                     56: to label the output.  It will appear on the cover page on the line labeled
                     57: \*(lqDocument\*(rq.  The default is the name of the input file.
                     58: .TP
                     59: .BI -P \ printer
                     60: .TP
                     61: .BI -h \ printer
                     62: Delivers the interpress master to
                     63: .IR printer ,
                     64: where 
                     65: .I printer
                     66: is either the clearinghouse name or the network address of the print server.
                     67: If an incomplete clearinghouse name (e.g. \*(lqslander\*(rq) is specified,
                     68: domain and organization fields are defaulted using 
                     69: .IR CH.default .
                     70: .TP
                     71: .B -r
                     72: Causes 
                     73: .I xnsprint
                     74: to unlink the input file after delivery to the print server.
                     75: .TP
                     76: .B -q
                     77: Causes
                     78: .I xnsprint
                     79: to be quiet about printer status and file delivery.  Messages indicating that
                     80: the printer needs human attention will still be displayed.
                     81: .TP
                     82: .BI -a \ filename
                     83: Write lpd(8) status information to the file
                     84: .IR filename .
                     85: .TP
                     86: .B -l
                     87: Request legal-sized paper.  If the printer has legal paper mounted in one
                     88: tray, that tray will be used.
                     89: .TP
                     90: .BI -s \ papersize
                     91: Request
                     92: .I papersize
                     93: sized paper.  The argument may be an integer or one of ``usLetter,''
                     94: ``usLegal,'' ``a0,'' etc.  If the requested paper size is not available a
                     95: serviceUnavailable error will be returned.
                     96: .TP
                     97: .BI -m \ message
                     98: Use
                     99: .I message
                    100: as the value for the message field passed to the printer and printed on the
                    101: cover sheet.  Default is your
                    102: printer's XNS host name, for want of anything better.
                    103: .TP
                    104: .BI -W
                    105: Causes
                    106: .I xnsprint
                    107: to wait until the files sent are actually printed before returning.
                    108: Appropriate status messages are displayed during the waiting period.
                    109: .SH FILES
                    110: .nf
                    111: /etc/passwd            for user names
                    112: /usr/new/lib/xnscourier/CH.default     for Clearinghouse defaults
                    113: .fi
                    114: .SH "SEE ALSO"
                    115: maha(1), dipress(1)
                    116: .PP
                    117: Interpress Electronic Printing Standard, \s8XSIS\s0 048404
                    118: .SH DIAGNOSTICS
                    119: Various messages stating that the printer is unavailable or needs some kind
                    120: of attention.
                    121: .SH BUGS
                    122: Probably lots of them.  In particular, the 
                    123: .B -l
                    124: flag should be generalized.
                    125: .PP
                    126: The printer claims that it \*(lqNeeds Key Operator\*(rq when it is really just
                    127: warming up.
                    128: .PP
                    129: .SH AUTHORS
                    130: JQ Johnson, Larry Parmelee, and Bill Nesheim
                    131: .PP

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.