Annotation of researchv10no/cmd/postscript/postprint/postprint.1, revision 1.1.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.