![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Return to dpost.1 CVS log ![[TXT]](/cvsweb/icons/text.gif){kind=icon}
![[DIR]](/cvsweb/icons/dir.gif){kind=icon}
Up to [Research Unix] / researchv10no / cmd / postscript / dpost|
Return to dpost.1 CVS log | Up to [Research Unix] / researchv10no / cmd / postscript / dpost |
1.1 ! root 1: .ds dF /usr/lib/font ! 2: .ds dQ /usr/lib/postscript ! 3: .TH DPOST 1 "DWB 3.2" ! 4: .SH NAME ! 5: .B dpost ! 6: \- ! 7: .B troff ! 8: postprocessor for PostScript printers ! 9: .SH SYNOPSIS ! 10: \*(mBdpost\f1 ! 11: .OP "" options [] ! 12: .OP "" files [] ! 13: .SH DESCRIPTION ! 14: .B dpost ! 15: translates ! 16: .I files ! 17: created by ! 18: .BR troff (1) ! 19: into PostScript and writes the results on the ! 20: standard output. ! 21: If no ! 22: .I files ! 23: are specified, or if ! 24: .OP \- ! 25: is one of the input ! 26: .IR files , ! 27: the standard input is read. ! 28: The following ! 29: .I options ! 30: are understood: ! 31: .TP 0.75i ! 32: .OP \-c num ! 33: Print ! 34: .I num ! 35: copies of each page. ! 36: By default only one copy is printed. ! 37: .TP ! 38: .OP \-m num ! 39: Magnify each logical page by the factor ! 40: .IR num ! 41: (default is 1.0). ! 42: Pages are scaled uniformly about the origin, ! 43: which is located near the upper left corner of ! 44: each page. ! 45: .TP ! 46: .OP \-n num ! 47: Print ! 48: .I num ! 49: logical pages on each piece of paper, ! 50: where ! 51: .I num ! 52: can be any positive integer. ! 53: By default, ! 54: .I num ! 55: is set to 1. ! 56: .TP ! 57: .OP \-o list ! 58: Print pages whose numbers are given in the comma-separated ! 59: .IR list . ! 60: The list contains single numbers ! 61: .I N ! 62: and ranges ! 63: .IR N1\-\|N2 . ! 64: A missing ! 65: .I N1 ! 66: means the lowest numbered page, a missing ! 67: .I N2 ! 68: means the highest. ! 69: .TP ! 70: .OP \-p mode ! 71: Print ! 72: .I files ! 73: in either \*(mBportrait\fP or \*(mBlandscape\fP mode. ! 74: Only the first character of ! 75: .I mode ! 76: is significant. ! 77: The default ! 78: .I mode ! 79: is \*(mBportrait\fP. ! 80: .TP ! 81: .OP \-w num ! 82: Set the line width used to implement ! 83: .B troff ! 84: graphics commands to ! 85: .I num ! 86: points, where a point is approximately 1/72 ! 87: of an inch. ! 88: By default ! 89: .I num ! 90: is set to 0.3 points. ! 91: .TP ! 92: .OP \-x num ! 93: Translate the origin ! 94: .I num ! 95: inches along the positive x axis. ! 96: The default ! 97: coordinate system has the origin fixed near the ! 98: upper left corner of the page, with positive ! 99: x to the right and positive y down the page. ! 100: Positive ! 101: .I num ! 102: moves everything right. ! 103: The default offset is 0 inches. ! 104: .TP ! 105: .OP \-y num ! 106: Translate the origin ! 107: .I num ! 108: inches along the positive y axis. ! 109: Positive ! 110: .I num ! 111: moves text down the page. ! 112: The default offset is 0. ! 113: .TP ! 114: .OP \-B ! 115: Include ! 116: .MW %%BoundingBox ! 117: comments in the output file. ! 118: Should only be used when the comments are needed ! 119: for picture inclusion. ! 120: Output is forced onto an 8.5\(mu11-inch page. ! 121: .TP ! 122: .OP \-E name ! 123: Set the character encoding for text fonts to ! 124: .IR name . ! 125: Requesting ! 126: .I name ! 127: means include file ! 128: .MI \*(dQ/ name .enc \f1. ! 129: A nonexistent encoding file is silently ignored. ! 130: There is no default. ! 131: .TP ! 132: .OP \-F dir ! 133: Use ! 134: .I dir ! 135: as the font directory. ! 136: The default ! 137: .I dir ! 138: is ! 139: .MR \*(dF , ! 140: and ! 141: .B dpost ! 142: reads ! 143: .SM ASCII ! 144: font files from directory ! 145: .MR \*(dF/devpost . ! 146: .TP ! 147: .OP \-H dir ! 148: Use ! 149: .I dir ! 150: as the host-resident font directory. ! 151: A file in ! 152: .I dir ! 153: that matches the name of the ! 154: .B troff ! 155: font is assumed to be a host resident font program ! 156: and is included in ! 157: .B dpost ! 158: output. ! 159: There is no default. ! 160: .TP ! 161: .OP \-L \^file ! 162: Use ! 163: .I file ! 164: as the PostScript prologue. ! 165: The default is ! 166: .MR \*(dQ/dpost.ps . ! 167: .TP ! 168: .OP \-T name ! 169: Use font files for device ! 170: .I name ! 171: as the best description of available PostScript fonts. ! 172: By default, ! 173: .I name ! 174: is ! 175: \*(mBpost\fP ! 176: and ! 177: .B dpost ! 178: reads ! 179: .SM ASCII ! 180: files from ! 181: .MR \*(dF/devpost . ! 182: .br ! 183: .ne 1i ! 184: .PP ! 185: Three options allow insertion of arbitrary PostScript ! 186: at controlled points in the translation process: ! 187: .TP 0.75i ! 188: .OP \-C \^file ! 189: Copy ! 190: .I file ! 191: to the output file; ! 192: .I file ! 193: must contain legitimate PostScript. ! 194: .TP ! 195: .OP \-P string ! 196: Include ! 197: .I string ! 198: in the output file; ! 199: .I string ! 200: must be legitimate PostScript. ! 201: .TP ! 202: .OP \-R action ! 203: Requests special ! 204: .I action ! 205: (e.g., ! 206: .MR manualfeed ) ! 207: on a per page or global basis. ! 208: The ! 209: .I action ! 210: string can be given as ! 211: .IR request \|, ! 212: .IM request : page\f1\|, ! 213: or ! 214: .IM request : page : file\f1\|. ! 215: If ! 216: .I page ! 217: is omitted or given as 0 the request ! 218: applies to all pages. ! 219: If ! 220: .I file ! 221: is omitted the request ! 222: lookup is done in ! 223: .MR \*(dQ/ps.requests . ! 224: .PP ! 225: All ! 226: .I files ! 227: should be prepared by ! 228: .B troff ! 229: for the same device. ! 230: Device tables that describe real PostScript fonts that can be ! 231: used by ! 232: .B dpost ! 233: should include ! 234: .EX ! 235: PDL PostScript ! 236: .EE ! 237: in their ! 238: .SM DESC ! 239: file. ! 240: Tables that depend on a non-standard character set encoding indicate ! 241: that fact by an ! 242: .MW Encoding ! 243: entry in their ! 244: .SM DESC ! 245: file. ! 246: For example, ! 247: .EX ! 248: Encoding Latin1 ! 249: .EE ! 250: means include file ! 251: .MR \*(dQ/Latin1.enc . ! 252: The ! 253: .OP \-E ! 254: option overrides the ! 255: .SM DESC ! 256: setting. ! 257: .SH EXAMPLES ! 258: .PP ! 259: A typical command line might be: ! 260: .EX ! 261: pic \f2files\fP | tbl | eqn | troff -mm | dpost ! 262: .EE ! 263: .SH DIAGNOSTICS ! 264: A 0 exit status is returned if ! 265: .I files ! 266: were successfully translated, ! 267: while 2 often indicates a syntax error in the input ! 268: .IR files . ! 269: .SH WARNINGS ! 270: .PP ! 271: .B dpost ! 272: output does not usually conform to Adobe's file-structuring conventions. ! 273: Send the output through ! 274: .B postreverse ! 275: to produce a minimally conforming PostScript file. ! 276: .PP ! 277: Emulation is expensive and does not always produce satisfactory results. ! 278: No attempt has been made to implement the character sets or fonts available ! 279: on all devices supported by ! 280: .BR troff . ! 281: Missing characters are replaced by white space, and unrecognized ! 282: fonts default to one of the Times fonts (e.g., ! 283: .MR R , ! 284: .MR I , ! 285: .MR B , ! 286: or ! 287: .MR BI ). ! 288: .SH FILES ! 289: .MW \*(dF/devpost/* ! 290: .br ! 291: .MW \*(dF/devpost/charlib/* ! 292: .br ! 293: .MW \*(dQ/dpost.ps ! 294: .br ! 295: .MW \*(dQ/color.ps ! 296: .br ! 297: .MW \*(dQ/draw.ps ! 298: .br ! 299: .MW \*(dQ/forms.ps ! 300: .br ! 301: .MW \*(dQ/ps.requests ! 302: .SH SEE ALSO ! 303: .BR buildtables (1), ! 304: .BR postio (1), ! 305: .BR postprint (1), ! 306: .BR postreverse (1), ! 307: .BR psencoding (1), ! 308: .BR troff (1), ! 309: .BR font (5), ! 310: .BR troff (5)
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.