Return to dpost.1 CVS log

Up to [Research Unix] / researchv10no / cmd / post.src / dpost

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

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.