Annotation of researchv10dc/man/man8/postscript.8, revision 1.1.1.1

1.1       root        1: .TH POSTSCRIPT 8
                      2: .CT 1 sa_auto
                      3: .SH NAME
                      4: dpost, postdaisy, postdmd, postprint \- filters to produce postscript
                      5: .SH SYNOPSIS
                      6: .B /usr/bin/postscript/dpost
                      7: [
                      8: .I option ...
                      9: ] [
                     10: .I file ...
                     11: ]
                     12: .PP
                     13: .B /usr/bin/postscript/postdaisy
                     14: [
                     15: .I option ...
                     16: ] [
                     17: .I file ...
                     18: ]
                     19: .PP
                     20: .B /usr/bin/postscript/postdmd
                     21: [
                     22: .I option ...
                     23: ] [
                     24: .I file ...
                     25: ]
                     26: .PP
                     27: .B /usr/bin/postscript/postprint
                     28: [
                     29: .I option ...
                     30: ] [
                     31: .I file ...
                     32: ]
                     33: .PP
                     34: .B /usr/bin/postscript/posttek
                     35: [
                     36: .I option ...
                     37: ] [
                     38: .I file ...
                     39: ]
                     40: .SH DESCRIPTION
                     41: These programs convert files of various formats into
                     42: PostScript.
                     43: The input formats are
                     44: .nr xx \w'\fL-p\ \fImode\ 'u
                     45: .TP \n(xxu
                     46: .I dpost
                     47: .IR troff (1)
                     48: output
                     49: .TP
                     50: .I postdaisy
                     51: Diablo 1640 daisy-wheel
                     52: .TP
                     53: .I postdmd
                     54: .IR bitfile (9.5)
                     55: files, as produced by
                     56: .IR blitblt (9.1)
                     57: .TP
                     58: .I postprint
                     59: .SM
                     60: ASCII
                     61: text
                     62: .TP
                     63: .I posttek
                     64: Tektronix 4014 graphics
                     65: .PP
                     66: Except as noted,
                     67: the options are common to all the programs:
                     68: .TP \n(xxu
                     69: .BI \-c num
                     70: Print
                     71: .I num
                     72: copies of each page.
                     73: By default only one copy is printed.
                     74: .TP
                     75: .BI \-m num
                     76: Magnify each logical page by the factor
                     77: .I num.
                     78: Pages are scaled uniformly about the origin,
                     79: located near the upper left corner of
                     80: the page.
                     81: The default magnification is 1.0.
                     82: .TP
                     83: .BI \-n num
                     84: Print
                     85: .I num
                     86: logical pages on each piece of paper.
                     87: The default is 1.
                     88: .TP
                     89: .BI \-o list
                     90: Print only pages specified in
                     91: the comma-separated
                     92: .I list
                     93: of numbers and ranges.
                     94: A range
                     95: .IB N - M
                     96: means pages
                     97: .I N
                     98: through
                     99: .IR M ;
                    100: an initial
                    101: .BI - N
                    102: means
                    103: from the beginning to page
                    104: .IR N ;
                    105: and a final
                    106: .IB N -
                    107: means
                    108: from
                    109: .I N
                    110: to the end.
                    111: Print only pages whose numbers are given in the comma-separated
                    112: .IR list .
                    113: The list contains single numbers
                    114: .I N
                    115: and ranges
                    116: .IB N1 \- N2.
                    117: A missing 
                    118: .I N1
                    119: means the lowest numbered page, a missing
                    120: .I N2
                    121: means the highest.
                    122: .TP
                    123: .BI \-p mode
                    124: Print
                    125: in
                    126: .I mode
                    127: .B p
                    128: (portrait)
                    129: or
                    130: .B l
                    131: (landscape).
                    132: The default is
                    133: .BR p .
                    134: .TP
                    135: .BI \-x num
                    136: Translate the origin
                    137: .I num
                    138: inches along the positive x axis.
                    139: By default,
                    140: the origin is
                    141: fixed near the
                    142: upper left corner of the page, with positive
                    143: x to the right and positive y down the page.
                    144: Positive
                    145: .I num
                    146: moves everything right.
                    147: The default offset is 0 inches.
                    148: .TP
                    149: .BI \-y num
                    150: Translate the origin
                    151: .I num
                    152: inches along the positive y axis.
                    153: Positive
                    154: .I num
                    155: moves text down the page.
                    156: The default offset is 0.
                    157: .TP
                    158: .BI \-A file
                    159: Append a simple accounting record to
                    160: .I file
                    161: after all input
                    162: .I files
                    163: have been successfully translated.
                    164: By default no accounting data is produced.
                    165: .TP
                    166: .BI \-L file
                    167: Use
                    168: .I file
                    169: as the PostScript prologue.
                    170: .TP
                    171: .BI \-f name
                    172: Print
                    173: .I files
                    174: using font
                    175: .I name.
                    176: Any PostScript font can be used,
                    177: but constant width fonts yield the best results.
                    178: The default font is Courier.
                    179: .RI ( postdaisy,
                    180: .IR postprint,
                    181: and
                    182: .IR posttek
                    183: only)
                    184: .TP
                    185: .BI \-f
                    186: Flip the sense of the bits in
                    187: .I files
                    188: before printing the bitmaps.
                    189: .RI ( postdmd
                    190: only)
                    191: .PP
                    192: In addition, three options allow the insertion of arbitrary PostScript
                    193: at controlled points in the translation process:
                    194: .TP \n(xxu
                    195: .BI \-C file
                    196: Copy
                    197: .I file
                    198: to the output file.
                    199: .I File
                    200: follows the prologue but
                    201: precedes any job initialization commands.
                    202: .I File
                    203: becomes part of the job's global environment
                    204: and must contain legitimate PostScript commands.
                    205: .TP
                    206: .BI \-P string
                    207: Like
                    208: .BR -C ,
                    209: using a
                    210: .I string
                    211: instead of the contents of a file.
                    212: .TP
                    213: .BI \-R action
                    214: Requests special
                    215: .I action
                    216: (e.g. manualfeed) on a per page or global basis.
                    217: The
                    218: .I action
                    219: string has the general form
                    220: .IB request : page : file,
                    221: from which 
                    222: .BI : page : file
                    223: or
                    224: .B : file
                    225: can be omitted.
                    226: An omitted or 0 page number
                    227: applies to all pages.
                    228: If file is omitted the request
                    229: lookup is done in 
                    230: .FR /usr/lib/postscript/ps.requests .
                    231: The collection of recognized requests can be modified or extended
                    232: by changing this file.
                    233: Multiple occurrences of the
                    234: .B \-R
                    235: option behave as expected.
                    236: .SH FILES
                    237: .TF /usr/lib/font/devpost/charlib/*
                    238: .TP
                    239: .F /usr/lib/font/devpost/*.out
                    240: .TP
                    241: .F /usr/lib/font/devpost/charlib/*
                    242: .TP
                    243: .F /usr/lib/postscript/*.ps
                    244: default prologues 
                    245: .TP
                    246: .F /usr/lib/tmac/tmac.pictures
                    247: .I troff
                    248: macros for PostScript
                    249: .SH SEE ALSO
                    250: .IR lp (1),
                    251: .IR postio (8)
                    252: .SH DIAGNOSTICS
                    253: Exit status 2
                    254: usually means a syntax error in some input file.
                    255: .SH BUGS
                    256: Output files
                    257: will often violate Adobe's
                    258: file structuring conventions.
                    259: Pipe the output of
                    260: .I dpost
                    261: through
                    262: .I postreverse
                    263: to produce a minimally conforming PostScript file.
                    264: .PP
                    265: Although
                    266: .I dpost
                    267: can handle files formatted for any 
                    268: .IR troff
                    269: device, emulation is expensive and
                    270: can easily double the print time and the size of the output file.
                    271: .PP
                    272: No attempt has been made to implement the character sets
                    273: or fonts available on all devices supported by
                    274: .I troff.
                    275: Missing characters are replaced by white space;
                    276: unrecognized fonts are replaced by one of the Times fonts.
                    277: .PP
                    278: .I Dpost
                    279: requires an
                    280: .B x res
                    281: command before the first
                    282: .B x init
                    283: and any file data.

unix.superglobalmegacorp.com

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