Return to xnsprint.n CVS log

Up to [CSRG BSD Unix] / 43BSDTahoe / new / xns / man

Annotation of 43BSDTahoe/new/xns/man/xnsprint.n, revision 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

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