more manpages

1 files changed, 206 insertions, 0 deletions

diff --git a/sys/src/cmd/postscript/postdmd/postdmd.1.man b/sys/src/cmd/postscript/postdmd/postdmd.1.man
new file mode 100644
index 000000000..cb3317b14
--- /dev/null
+++ b/sys/src/cmd/postscript/postdmd/postdmd.1.man
@@ -0,0 +1,206 @@
+.ds dQ /usr/lib/postscript
+.TH POSTDMD 1
+.SH NAME
+.B postdmd
+\- PostScript translator for
+.SM DMD
+bitmap files
+.SH SYNOPSIS
+\*(mBpostdmd\f1
+.OP "" options []
+.OP "" files []
+.SH DESCRIPTION
+.B postdmd
+translates
+.SM DMD
+bitmap
+.IR files ,
+as produced by
+.BR dmdps ,
+or
+.I files
+written in the Ninth Edition
+.BR bitfile (9.5)
+format
+into PostScript and writes the results on the
+standard output.
+If no
+.I files
+are specified, or if
+.OP \-
+is one of the input
+.IR files ,
+the standard input is read.
+The following
+.I options
+are understood:
+.TP 0.75i
+.OP \-b num
+Pack the bitmap in the output file using
+.I num
+byte patterns.
+A value of 0 turns off all packing of the output file.
+By default
+.I num
+is 6.
+.TP
+.OP \-c num
+Print
+.I num
+copies of each page.
+By default only one copy is printed.
+.TP
+.OP \-f
+Flip the sense of the bits in
+.I files
+before printing the bitmaps.
+.TP
+.OP \-m num
+Magnify each logical page by the factor
+.IR num .
+Pages are scaled uniformly about the origin,
+which by default is located at the center of
+each page.
+The default magnification is 1.0.
+.TP
+.OP \-n num
+Print
+.I num
+logical pages on each piece of paper,
+where
+.I num
+can be any positive integer.
+By default
+.I num
+is set to 1.
+.TP
+.OP \-o list
+Print pages whose numbers are given in the comma-separated
+.IR list .
+The list contains single numbers
+.I N
+and ranges
+.IR N1\-\|N2 .
+A missing
+.I N1
+means the lowest numbered page, a missing
+.I N2
+means the highest.
+.TP
+.OP \-p mode
+Print
+.I files
+in either \*(mBportrait\fP or \*(mBlandscape\fP
+.IR mode .
+Only the first character of
+.I mode
+is significant.
+The default
+.I mode
+is \*(mBportrait\fP.
+.TP
+.OP \-u
+Disables much of the unpacking for Eighth
+Edition bitmap files.
+Usually results in smaller output files that take longer to print.
+Not a recommended option.
+.TP
+.OP \-x num
+Translate the origin
+.I num
+inches along the positive x axis.
+The default
+coordinate system has the origin fixed at the
+center of the page, with positive
+x to the right and positive y up the page.
+Positive
+.I num
+moves everything right.
+The default offset is 0 inches.
+.TP
+.OP \-y num
+Translate the origin
+.I num
+inches along the positive y axis.
+Positive
+.I num
+moves everything up the page.
+The default offset is 0.
+.TP
+.TP
+.OP \-L file
+Use
+.I file
+as the PostScript prologue.
+.br
+The default is
+.MR \*(dQ/postdmd.ps .
+.PP
+Three options allow insertion of arbitrary PostScript
+at controlled points in the translation process:
+.TP 0.75i
+.OP \-C file
+Copy
+.I file
+to the output file;
+.I file
+must contain legitimate PostScript.
+.TP
+.OP \-P string
+Include
+.I string
+in the output file;
+.I string
+must be legitimate PostScript.
+.TP
+.OP \-R action
+Requests special
+.I action
+(e.g.,
+.MR manualfeed )
+on a per page or global basis.
+The
+.I action
+string can be given as
+.IR request,
+.IM request : page\f1\|,
+or
+.IM request : page : file\f1\|.
+If
+.I page
+is omitted or given as 0, the request applies to all pages.
+If
+.I file
+is omitted, the request lookup is done in
+.MR \*(dQ/ps.requests .
+.PP
+Only one bitmap is printed on each logical page, and each of the input
+.I files
+must contain complete descriptions of at least one bitmap.
+Decreasing the pattern size using the
+.OP \-b
+option may help throughput on printers with fast processors
+(e.g., \s-1PS\s+1-810),
+while increasing the pattern size will often be the right move
+on older models
+(.e.g, \s-1PS\s+1-800).
+.SH DIAGNOSTICS
+A 0 exit status is returned if
+.I files
+were successfully processed.
+.br
+.ne 4v
+.SH FILES
+.MW \*(dQ/postdmd.ps
+.br
+.MW \*(dQ/forms.ps
+.br
+.MW \*(dQ/ps.requests
+.SH SEE ALSO
+.BR dpost (1),
+.BR postdaisy (1),
+.BR postio (1),
+.BR postmd (1),
+.BR postprint (1),
+.BR postreverse (1),
+.BR posttek (1)