Annotation of researchv10no/cmd/post.src/postprint/postprint.1, revision 1.1

1.1     ! root        1: .ds dQ /usr/lib/postscript
        !             2: .TH POSTPRINT 1 "DWB 3.2"
        !             3: .SH NAME
        !             4: .B postprint
        !             5: \- PostScript translator for text files
        !             6: .SH SYNOPSIS
        !             7: \*(mBpostprint\f1
        !             8: .OP "" options []
        !             9: .OP "" files []
        !            10: .SH DESCRIPTION
        !            11: .B postprint
        !            12: translates text
        !            13: .I files
        !            14: into PostScript and writes the results on the
        !            15: standard output.
        !            16: If no
        !            17: .I files
        !            18: are specified, or if
        !            19: .OP \-
        !            20: is one of the input
        !            21: .IR files ,
        !            22: the standard input is read.
        !            23: The following
        !            24: .I options
        !            25: are understood:
        !            26: .TP 0.75i
        !            27: .OP \-c num
        !            28: Print
        !            29: .I num
        !            30: copies of each page.
        !            31: By default only one copy is printed.
        !            32: .TP 
        !            33: .OP \-f name
        !            34: Print
        !            35: .I files
        !            36: using font
        !            37: .IR name .
        !            38: Any PostScript font can be used,
        !            39: although the best results will only be
        !            40: obtained with constant width fonts.
        !            41: The default font is Courier.
        !            42: .TP 
        !            43: .OP \-l num
        !            44: Set the length of a page to
        !            45: .I num
        !            46: lines.
        !            47: By default
        !            48: .I num
        !            49: is 66.
        !            50: Setting
        !            51: .I num
        !            52: to 0 is allowed, and will cause
        !            53: .B postprint
        !            54: to guess a value, based on the point size that is being used.
        !            55: .TP 
        !            56: .OP \-m num
        !            57: Magnify each logical page by the factor
        !            58: .IR num .
        !            59: Pages are scaled uniformly about the origin,
        !            60: which is located near the upper left corner of
        !            61: each page.
        !            62: The default magnification is 1.0.
        !            63: .TP 
        !            64: .OP \-n num
        !            65: Print
        !            66: .I num
        !            67: logical pages on each piece of paper,
        !            68: where
        !            69: .I num
        !            70: can be any positive integer.
        !            71: By default
        !            72: .I num
        !            73: is set to 1.
        !            74: .TP 
        !            75: .OP \-o list
        !            76: Print pages whose numbers are given in the comma-separated
        !            77: .IR list .
        !            78: The list contains single numbers
        !            79: .I N
        !            80: and ranges
        !            81: .IR N1\-\|N2 .
        !            82: A missing
        !            83: .I N1
        !            84: means the lowest numbered page, a missing
        !            85: .I N2
        !            86: means the highest.
        !            87: .TP 
        !            88: .OP \-p mode
        !            89: Print
        !            90: .I files
        !            91: in either \*(mBportrait\fP or \*(mBlandscape\fP
        !            92: .IR mode .
        !            93: Only the first character of
        !            94: .I mode
        !            95: is significant.
        !            96: The default
        !            97: .I mode
        !            98: is \*(mBportrait\fP.
        !            99: .TP 
        !           100: .OP \-r num
        !           101: Selects carriage return behavior.
        !           102: Carriage returns are ignored if
        !           103: .I num
        !           104: is 0,
        !           105: cause a return to column 1 if
        !           106: .I num
        !           107: is 1,
        !           108: and generate a newline if
        !           109: .I num
        !           110: is 2.
        !           111: The default
        !           112: .I num
        !           113: is 0.
        !           114: .TP 
        !           115: .OP \-s num
        !           116: Print
        !           117: .I files
        !           118: using point size
        !           119: .IR num .
        !           120: When printing in landscape mode
        !           121: .I num
        !           122: is scaled by a factor that depends on the
        !           123: imaging area of the device.
        !           124: The default size for portrait mode is 10.
        !           125: .TP 
        !           126: .OP \-t num
        !           127: Assume tabs are set every
        !           128: .I num
        !           129: columns, starting with the first column.
        !           130: By default tabs are set every 8 columns.
        !           131: .TP 
        !           132: .OP \-x num
        !           133: Translate the origin
        !           134: .I num
        !           135: inches along the positive x axis.
        !           136: The default
        !           137: coordinate system has the origin fixed near the
        !           138: upper left corner of the page, with positive
        !           139: x to the right and positive y down the page.
        !           140: Positive
        !           141: .I num
        !           142: moves everything right.
        !           143: The default offset is 0.25 inches.
        !           144: .TP 
        !           145: .OP \-y num
        !           146: Translate the origin
        !           147: .I num
        !           148: inches along the positive y axis.
        !           149: Positive
        !           150: .I num
        !           151: moves text down the page.
        !           152: The default offset is 0.25 inches.
        !           153: .TP 
        !           154: .OP \-E name
        !           155: Set the character encoding for text fonts to
        !           156: .IR name .
        !           157: Requesting
        !           158: .I name
        !           159: means include file
        !           160: .MI \*(dQ/ name .enc \f1.
        !           161: A nonexistent encoding file is silently ignored.
        !           162: The default selects file
        !           163: .MR \*(dQ/Default.enc .
        !           164: .TP 
        !           165: .OP \-L file
        !           166: Use
        !           167: .I file
        !           168: as the PostScript prologue.
        !           169: .br
        !           170: The default is
        !           171: .MR \*(dQ/postprint.ps .
        !           172: .PP
        !           173: Three options allow insertion of arbitrary PostScript
        !           174: at controlled points in the translation process:
        !           175: .TP  0.75i
        !           176: .OP \-C file
        !           177: Copy
        !           178: .I file
        !           179: to the output file;
        !           180: .I file
        !           181: must contain legitimate PostScript.
        !           182: .TP 
        !           183: .OP \-P string
        !           184: Include
        !           185: .I string
        !           186: in the output file;
        !           187: .I string
        !           188: must be legitimate PostScript.
        !           189: .TP 
        !           190: .OP \-R action
        !           191: Requests special
        !           192: .I action
        !           193: (e.g.,
        !           194: .MR manualfeed )
        !           195: on a per page or global basis.
        !           196: The
        !           197: .I action
        !           198: string can be given as
        !           199: .IR request ,
        !           200: .IM request : page\f1\|,
        !           201: or
        !           202: .IM request : page : file\f1\|.
        !           203: If
        !           204: .I page
        !           205: is omitted or given as 0, the request
        !           206: applies to all pages.
        !           207: If
        !           208: .I file
        !           209: is omitted, the request
        !           210: lookup is done in
        !           211: .MR \*(dQ/ps.requests .
        !           212: .PP
        !           213: A new logical page is started after 66 lines have been printed
        !           214: on the current page, or whenever an
        !           215: .SM ASCII
        !           216: form feed character is read.
        !           217: The number of lines per page can be changed using the
        !           218: .OP \-l
        !           219: option.
        !           220: Unprintable
        !           221: .SM ASCII
        !           222: characters are ignored,
        !           223: and lines that are too long are silently truncated
        !           224: by the printer.
        !           225: .SH EXAMPLES
        !           226: .PP
        !           227: Print
        !           228: .I file1
        !           229: and
        !           230: .I file2
        !           231: in landscape mode:
        !           232: .EX
        !           233: postprint -pland \f2file1 file2
        !           234: .EE
        !           235: Print three logical pages on each physical page in portrait mode:
        !           236: .EX
        !           237: postprint -n3 \f2file
        !           238: .EE
        !           239: .SH DIAGNOSTICS
        !           240: A 0 exit status is returned if
        !           241: .I files
        !           242: were successfully processed.
        !           243: .SH FILES
        !           244: .MW \*(dQ/postprint.ps
        !           245: .br
        !           246: .MW \*(dQ/forms.ps
        !           247: .br
        !           248: .MW \*(dQ/ps.requests
        !           249: .SH SEE ALSO
        !           250: .BR dpost (1),
        !           251: .BR postdaisy(1),
        !           252: .BR postdmd(1),
        !           253: .BR postio(1),
        !           254: .BR postmd(1),
        !           255: .BR postreverse(1),
        !           256: .BR posttek(1),
        !           257: .BR psencoding (1)

unix.superglobalmegacorp.com

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