ref: 440e90159f3babb2b25f01e60d98ee4d3d8123b2
parent: 36c8326a0894c2c98ab77a7ddf184005dc11f3e5
author: cinap_lenrek <cinap_lenrek@centraldogma>
date: Wed May 4 05:14:37 EDT 2011
more manpages
--- a/sys/src/cmd/postscript/buildtables/buildtables.1
+++ /dev/null
@@ -1,214 +1,0 @@
-.ds dF /usr/lib/font
-.ds dQ /usr/lib/postscript
-.TH BUILDTABLES 1 "DWB 3.2"
-.SH NAME
-.B buildtables
-\- build
-.B troff
-tables on a PostScript printer
-.SH SYNOPSIS
-\*(mBbuildtables\f1
-.OP "" options []
-.OP "" "name \(el" []
-.SH DESCRIPTION
-.B buildtables
-builds font width tables or the typesetter description
-file on a PostScript printer.
-No arguments means build a default set of tables;
-usually a superset of the LaserWriter Plus collection.
-The following
-.I options
-are understood:
-.TP 1.0i
-.OP \-b speed
-Transmit data over
-.I line
-at baud rate
-.I speed.
-Recognized baud rates are 1200, 2400, 4800, 9600, and 19200.
-The default
-.I speed
-is 9600 baud.
-.TP 1.0i
-.OP \-l line
-Build the tables on the PostScript printer attached to
-.I line.
-There is no default.
-.TP 1.0i
-.OP \-t name
-Use
-.I name
-as the template for fonts not in the default set.
-Choose
-.MW R
-for proportionally spaced fonts and
-.MW CW
-for fixed width fonts.
-Try
-.MW ZD
-(ZapfDingbats) if the font has a non-standard
-character set.
-The default is
-.MR R .
-.TP 1.0i
-.OP \-C file
-Copy
-.I file
-into each PostScript table program;
-.I file
-must contain legitimate PostScript.
-.TP 1.0i
-.OP \-H hostdir
-Use
-.I hostdir
-as the host-resident font directory.
-A file in
-.I hostdir
-that matches the name of the
-.B troff
-font is assumed to be a host-resident font program and is included
-in the PostScript width table program.
-There is no default.
-.TP 1.0i
-.OP \-S file
-Use
-.I file
-as the shell library file.
-Overrides the choice made with the
-.OP \-T
-option.
-.TP 1.0i
-.OP \-T name
-Set the target device to
-.I name.
-.br
-Device
-.I name
-means
-.ft 2
-.MI \*(dF/dev name /shell.lib
-.ft 1
-is the shell library file.
-There is no default.
-.PP
-If
-.OP \-l
-is omitted output files are the PostScript programs that
-build the tables, rather than the tables themselves.
-One of
-.OP \-T
-or
-.OP \-S
-is required.
-If both are given
-.OP \-S
-wins.
-Although
-.OP \-H
-is the preferred mechanism for including host-resident font files,
-.OP \-C
-makes sense when only one width table is built.
-.PP
-The shell library file defines a collection of functions used to
-build
-.BR troff (1)
-tables.
-The default set of tables is the list of names returned by the
-.MW AllTables
-function.
-Changes to the default list can be made by updating the
-.MW BuiltinTables
-function.
-.PP
-Each
-.B buildtables
-argument
-must be a default table name, or a pair of names enclosed in quotes.
-If the argument is a pair, the first name is the
-.B troff
-font and the second is the full PostScript font name.
-Tables are created in the current directory.
-Each is assigned a name that matches the
-.B troff
-table name.
-.PP
-The PostScript table programs created by
-.BR trofftable (1)
-are written to files that have
-.MW .ps
-appended to the
-.B troff
-table name.
-The
-.MW .ps
-file is deleted after the table is built.
-Options not listed above are passed to
-.B trofftable.
-The PostScript table programs return data to the host computer using
-PostScript's
-.MW print
-operator.
-See
-.BR hardcopy (1)
-if you do not have access to the printer's serial port.
-.SH EXAMPLES
-.PP
-Build the default collection of devpost tables on the printer
-connected to
-.MW /dev/tty00
-(no font name arguments):
-.EX
-buildtables -l/dev/tty00 -Tpost
-.EE
-To do the same and to restrict the tables that are built,
-Add
-.B troff
-font names (or
-.MR DESC )
-to restrict the tables built on the printer connected to
-.MR /dev/tty00 :
-.EX
-buildtables -l/dev/tty00 -Tpost R I B BI DESC S
-.EE
-Enclose the
-.B troff
-and PostScript font names in quotes to
-build the width table for a font not in the default set
-(also on the printer connected to
-.MR /dev/tty00 ):
-.EX
-buildtables -l/dev/tty00 -TLatin1 "GL Garamond-Light"
-.EE
-A font must be available on the printer when the table is built.
-Use
-.OP \-H
-or
-.OP \-C
-to include host-resident fonts.
-.SH WARNINGS
-.PP
-A width table will not build properly if the printer cannot access
-the PostScript font.
-.PP
-The
-.OP \-TLatin1
-option only works on PostScript printers that support the full
-.SM ISO
-Latin-1 character set.
-The error message from older printers will likely indicate a missing
-.MW ISOLatin1Encoding
-array.
-.SH FILES
-.MW \*(dF/dev*/shell.lib
-.br
-.MW \*(dQ/dpost.ps
-.br
-.MW \*(dQ/trofftable.ps
-.br
-.SH SEE ALSO
-.BR dpost (1),
-.BR hardcopy (1),
-.BR postio (1),
-.BR troff (1),
-.BR trofftable (1),
-.BR font (5)
--- /dev/null
+++ b/sys/src/cmd/postscript/buildtables/buildtables.1.man
@@ -1,0 +1,214 @@
+.ds dF /usr/lib/font
+.ds dQ /usr/lib/postscript
+.TH BUILDTABLES 1 "DWB 3.2"
+.SH NAME
+.B buildtables
+\- build
+.B troff
+tables on a PostScript printer
+.SH SYNOPSIS
+\*(mBbuildtables\f1
+.OP "" options []
+.OP "" "name \(el" []
+.SH DESCRIPTION
+.B buildtables
+builds font width tables or the typesetter description
+file on a PostScript printer.
+No arguments means build a default set of tables;
+usually a superset of the LaserWriter Plus collection.
+The following
+.I options
+are understood:
+.TP 1.0i
+.OP \-b speed
+Transmit data over
+.I line
+at baud rate
+.I speed.
+Recognized baud rates are 1200, 2400, 4800, 9600, and 19200.
+The default
+.I speed
+is 9600 baud.
+.TP 1.0i
+.OP \-l line
+Build the tables on the PostScript printer attached to
+.I line.
+There is no default.
+.TP 1.0i
+.OP \-t name
+Use
+.I name
+as the template for fonts not in the default set.
+Choose
+.MW R
+for proportionally spaced fonts and
+.MW CW
+for fixed width fonts.
+Try
+.MW ZD
+(ZapfDingbats) if the font has a non-standard
+character set.
+The default is
+.MR R .
+.TP 1.0i
+.OP \-C file
+Copy
+.I file
+into each PostScript table program;
+.I file
+must contain legitimate PostScript.
+.TP 1.0i
+.OP \-H hostdir
+Use
+.I hostdir
+as the host-resident font directory.
+A file in
+.I hostdir
+that matches the name of the
+.B troff
+font is assumed to be a host-resident font program and is included
+in the PostScript width table program.
+There is no default.
+.TP 1.0i
+.OP \-S file
+Use
+.I file
+as the shell library file.
+Overrides the choice made with the
+.OP \-T
+option.
+.TP 1.0i
+.OP \-T name
+Set the target device to
+.I name.
+.br
+Device
+.I name
+means
+.ft 2
+.MI \*(dF/dev name /shell.lib
+.ft 1
+is the shell library file.
+There is no default.
+.PP
+If
+.OP \-l
+is omitted output files are the PostScript programs that
+build the tables, rather than the tables themselves.
+One of
+.OP \-T
+or
+.OP \-S
+is required.
+If both are given
+.OP \-S
+wins.
+Although
+.OP \-H
+is the preferred mechanism for including host-resident font files,
+.OP \-C
+makes sense when only one width table is built.
+.PP
+The shell library file defines a collection of functions used to
+build
+.BR troff (1)
+tables.
+The default set of tables is the list of names returned by the
+.MW AllTables
+function.
+Changes to the default list can be made by updating the
+.MW BuiltinTables
+function.
+.PP
+Each
+.B buildtables
+argument
+must be a default table name, or a pair of names enclosed in quotes.
+If the argument is a pair, the first name is the
+.B troff
+font and the second is the full PostScript font name.
+Tables are created in the current directory.
+Each is assigned a name that matches the
+.B troff
+table name.
+.PP
+The PostScript table programs created by
+.BR trofftable (1)
+are written to files that have
+.MW .ps
+appended to the
+.B troff
+table name.
+The
+.MW .ps
+file is deleted after the table is built.
+Options not listed above are passed to
+.B trofftable.
+The PostScript table programs return data to the host computer using
+PostScript's
+.MW print
+operator.
+See
+.BR hardcopy (1)
+if you do not have access to the printer's serial port.
+.SH EXAMPLES
+.PP
+Build the default collection of devpost tables on the printer
+connected to
+.MW /dev/tty00
+(no font name arguments):
+.EX
+buildtables -l/dev/tty00 -Tpost
+.EE
+To do the same and to restrict the tables that are built,
+Add
+.B troff
+font names (or
+.MR DESC )
+to restrict the tables built on the printer connected to
+.MR /dev/tty00 :
+.EX
+buildtables -l/dev/tty00 -Tpost R I B BI DESC S
+.EE
+Enclose the
+.B troff
+and PostScript font names in quotes to
+build the width table for a font not in the default set
+(also on the printer connected to
+.MR /dev/tty00 ):
+.EX
+buildtables -l/dev/tty00 -TLatin1 "GL Garamond-Light"
+.EE
+A font must be available on the printer when the table is built.
+Use
+.OP \-H
+or
+.OP \-C
+to include host-resident fonts.
+.SH WARNINGS
+.PP
+A width table will not build properly if the printer cannot access
+the PostScript font.
+.PP
+The
+.OP \-TLatin1
+option only works on PostScript printers that support the full
+.SM ISO
+Latin-1 character set.
+The error message from older printers will likely indicate a missing
+.MW ISOLatin1Encoding
+array.
+.SH FILES
+.MW \*(dF/dev*/shell.lib
+.br
+.MW \*(dQ/dpost.ps
+.br
+.MW \*(dQ/trofftable.ps
+.br
+.SH SEE ALSO
+.BR dpost (1),
+.BR hardcopy (1),
+.BR postio (1),
+.BR troff (1),
+.BR trofftable (1),
+.BR font (5)
--- a/sys/src/cmd/postscript/mcolor/mcolor.5
+++ /dev/null
@@ -1,60 +1,0 @@
-.ds dP /usr/lib/postscript
-.ds dT /usr/lib/tmac
-.TH MCOLOR 5
-.SH NAME
-.B mcolor
-\- color and reverse video macro
-.SH SYNOPSIS
-\*(mBtroff \-mcolor\f1
-.OP "" options []
-.OP "" files []
-.SH DESCRIPTION
-.B mcolor
-is a macro package for color selection and reverse video printing
-on PostScript printers.
-The package is compatible with most existing macro packages
-and includes the following macro:
-.TP 1.25i
-.MI .CL "\0color\0text"
-Prints
-.I text
-in
-.IR color .
-No arguments restores the default color (black).
-If
-.I text
-is omitted the selected
-.I color
-remains in effect until another
-.I color
-is selected.
-If two arguments are given the
-.I text
-is printed in
-.I color
-and then the default color is restored.
-.PP
-Both the text and background color can be selected.
-A
-.I color
-argument of
-.RI `` color1
-.MW on
-.IR color2 ''
-prints text in
-.I color1
-on a background in
-.I color2 .
-.PP
-Named colors must be listed in the
-``colordict''
-dictionary in file
-.MR \*(dP/color.ps .
-.SH FILES
-.MW \*(dT/tmac.color
-.br
-.MW \*(dP/color.ps
-.SH SEE ALSO
-.BR troff (1),
-.BR dpost (1),
-.BR mps (5)
--- /dev/null
+++ b/sys/src/cmd/postscript/mcolor/mcolor.5.man
@@ -1,0 +1,60 @@
+.ds dP /usr/lib/postscript
+.ds dT /usr/lib/tmac
+.TH MCOLOR 5
+.SH NAME
+.B mcolor
+\- color and reverse video macro
+.SH SYNOPSIS
+\*(mBtroff \-mcolor\f1
+.OP "" options []
+.OP "" files []
+.SH DESCRIPTION
+.B mcolor
+is a macro package for color selection and reverse video printing
+on PostScript printers.
+The package is compatible with most existing macro packages
+and includes the following macro:
+.TP 1.25i
+.MI .CL "\0color\0text"
+Prints
+.I text
+in
+.IR color .
+No arguments restores the default color (black).
+If
+.I text
+is omitted the selected
+.I color
+remains in effect until another
+.I color
+is selected.
+If two arguments are given the
+.I text
+is printed in
+.I color
+and then the default color is restored.
+.PP
+Both the text and background color can be selected.
+A
+.I color
+argument of
+.RI `` color1
+.MW on
+.IR color2 ''
+prints text in
+.I color1
+on a background in
+.I color2 .
+.PP
+Named colors must be listed in the
+``colordict''
+dictionary in file
+.MR \*(dP/color.ps .
+.SH FILES
+.MW \*(dT/tmac.color
+.br
+.MW \*(dP/color.ps
+.SH SEE ALSO
+.BR troff (1),
+.BR dpost (1),
+.BR mps (5)
--- a/sys/src/cmd/postscript/misc/laserbar.1
+++ /dev/null
@@ -1,41 +1,0 @@
-.TH LASERBAR 1
-.SH NAME
-laserbar \- produce bar codes on a PostScript laser printer
-.SH SYNOPSIS
-.B laserbar
-[\fB-r\fP rotate] [\fB-x\fP xoffset] [\fB-y\fP yoffset]
-[\fB-X\fP xscale] [\fB-Y\fP yscale] [\fB-lns\fP] string
-.SH DESCRIPTION
-.I Laserbar
-prints on the standard output the PostScript text that will produce
-(on a suitable laser printer) the \s-2CODE-39\s+2 bar code
-corresponding to
-.I string.
-The \fBr\fP option may be used to specify a rotation (in
-degrees) of the bar code.
-The \fBx\fP, \fBy\fP, \fBX\fP, and \fBY\fP options may be used to specify
-an x- or y-axis offset (in inches) or scaling factor, respectively.
-(The offset is measured from the lower left corner of the page
-to the upper left corner of the bar
-code. By default, the bar code produced is one inch high, and is scaled
-so that the narrowest elements are each 1/72-inch \- i.e., one point \- wide.)
-If the \fBl\fP option is specified, the bar code produced is labeled.
-If the \fBn\fP option is specified, the resulting PostScript text
-includes a leading \f(CWnewpath\fP command, so that the text may stand
-alone or precede any other PostScript commands.
-If the \fBs\fP option is specified, the resulting PostScript text includes
-a trailing \f(CWshowpage\fP command, so that the text may stand alone
-or follow any other PostScript commands.
-.P
-This manual page (if it appears with a bar code printed on it) was
-produced by something like the following sequence:
-.IP
-.ft CW
-laserbar -x 2.5 -y 3 -l -n ABC123xyz > tempfile
-.br
-troff -man -Tpost laserbar.1 | dpost >> tempfile
-.br
-prt -dprinter -lpostscript tempfile
-.ft P
-.SH SEE ALSO
-laserbar(3), prt(1), dpost(1), postbgi(1), postprint(1), postdmd(1), posttek(1), etc.
--- /dev/null
+++ b/sys/src/cmd/postscript/misc/laserbar.1.man
@@ -1,0 +1,41 @@
+.TH LASERBAR 1
+.SH NAME
+laserbar \- produce bar codes on a PostScript laser printer
+.SH SYNOPSIS
+.B laserbar
+[\fB-r\fP rotate] [\fB-x\fP xoffset] [\fB-y\fP yoffset]
+[\fB-X\fP xscale] [\fB-Y\fP yscale] [\fB-lns\fP] string
+.SH DESCRIPTION
+.I Laserbar
+prints on the standard output the PostScript text that will produce
+(on a suitable laser printer) the \s-2CODE-39\s+2 bar code
+corresponding to
+.I string.
+The \fBr\fP option may be used to specify a rotation (in
+degrees) of the bar code.
+The \fBx\fP, \fBy\fP, \fBX\fP, and \fBY\fP options may be used to specify
+an x- or y-axis offset (in inches) or scaling factor, respectively.
+(The offset is measured from the lower left corner of the page
+to the upper left corner of the bar
+code. By default, the bar code produced is one inch high, and is scaled
+so that the narrowest elements are each 1/72-inch \- i.e., one point \- wide.)
+If the \fBl\fP option is specified, the bar code produced is labeled.
+If the \fBn\fP option is specified, the resulting PostScript text
+includes a leading \f(CWnewpath\fP command, so that the text may stand
+alone or precede any other PostScript commands.
+If the \fBs\fP option is specified, the resulting PostScript text includes
+a trailing \f(CWshowpage\fP command, so that the text may stand alone
+or follow any other PostScript commands.
+.P
+This manual page (if it appears with a bar code printed on it) was
+produced by something like the following sequence:
+.IP
+.ft CW
+laserbar -x 2.5 -y 3 -l -n ABC123xyz > tempfile
+.br
+troff -man -Tpost laserbar.1 | dpost >> tempfile
+.br
+prt -dprinter -lpostscript tempfile
+.ft P
+.SH SEE ALSO
+laserbar(3), prt(1), dpost(1), postbgi(1), postprint(1), postdmd(1), posttek(1), etc.
--- a/sys/src/cmd/postscript/picpack/picpack.1
+++ /dev/null
@@ -1,123 +1,0 @@
-.TH PICPACK 1
-.SH NAME
-.B picpack
-\- PostScript picture packing preprocessor
-.SH SYNOPSIS
-\*(mBpicpack\f1
-.OP "" options []
-.OP "" files []
-.SH DESCRIPTION
-.B picpack
-copies
-.I files
-to stdout, expanding picture inclusion requests
-(marked by the
-.MW .BP
-or
-.MW .PI
-macros) into an in-line
-format that can be passed through
-.B troff
-and handled by
-.BR dpost .
-If no
-.I files
-are specified
-or if
-.OP \-
-is one of the input
-.I files
-standard input is read.
-The following
-.I options
-are understood:
-.TP 0.75i
-.OP \-k list
-.I list
-is a comma- or space-separated string of words used to locate
-picture inclusion requests.
-The start of every line in the input
-.I files
-is compared with each word in
-.I list .
-If there is a match, the second string on the line is
-taken as the pathname of a picture file that is added
-to the output file.
-The default
-.I list
-is
-.RM `` ".BP .PI ''.
-.TP
-.OP \-q
-Suppress ``missing picture file'' error messages.
-.PP
-.B picpack
-is a trivial preprocessor that, in a sense, duplicates some of the
-picture inclusion capabilities already available in
-.BR dpost .
-.B picpack
-should not be used if your formatting command line includes
-a call to
-.BR dpost .
-Its only purpose is to combine picture files with text in a single
-file that can be passed through
-.B troff
-and unpacked, at some later time, by
-.BR dpost .
-The original picture inclusion mechanism, with files are pulled in by
-.BR dpost ,
-is the preferred approach.
-.SH EXAMPLES
-A typical application might be in a distributed printing environment
-where everything up to
-.B troff
-is run by the user and everything after
-.B troff
-is handled by a spooling daemon (perhaps
-.BR lp ).
-In that case the command line would be,
-.EX
-pic \f2file\fP | tbl | eqn | picpack | troff -mm -Tpost | lp
-.EE
-A poor example, although one that should still work, would be,
-.EX
-pic \f2file\fP | tbl | eqn | picpack | troff -mm -Tpost | dpost >\f2file\fP.ps
-.EE
-In this case picture inclusion requests could (and should) be handled by
-.BR dpost .
-Running
-.B picpack
-is not needed or even recommended.
-It should be dropped from any pipeline that includes a call to
-.BR dpost .
-.SH DIAGNOSTICS
-A 0 exit status is returned if
-.I files
-were successfully processed.
-.SH WARNINGS
-.PP
-Combining pictures and text using the capabilities available in
-.B dpost
-is the recommended approach and is always guaranteed to be more
-efficient than
-.BR picpack .
-Running
-.B picpack
-and
-.B dpost
-in the same pipeline makes little sense.
-.PP
-Using
-.B picpack
-will likely result in files that can no longer be reliably passed
-through other important
-.B troff
-postprocessors like
-.BR proof .
-At present
-.B picpack
-is only guaranteed to work with
-.BR dpost .
-.SH SEE ALSO
-.BR dpost (1),
-.BR troff (1)
--- /dev/null
+++ b/sys/src/cmd/postscript/picpack/picpack.1.man
@@ -1,0 +1,123 @@
+.TH PICPACK 1
+.SH NAME
+.B picpack
+\- PostScript picture packing preprocessor
+.SH SYNOPSIS
+\*(mBpicpack\f1
+.OP "" options []
+.OP "" files []
+.SH DESCRIPTION
+.B picpack
+copies
+.I files
+to stdout, expanding picture inclusion requests
+(marked by the
+.MW .BP
+or
+.MW .PI
+macros) into an in-line
+format that can be passed through
+.B troff
+and handled by
+.BR dpost .
+If no
+.I files
+are specified
+or if
+.OP \-
+is one of the input
+.I files
+standard input is read.
+The following
+.I options
+are understood:
+.TP 0.75i
+.OP \-k list
+.I list
+is a comma- or space-separated string of words used to locate
+picture inclusion requests.
+The start of every line in the input
+.I files
+is compared with each word in
+.I list .
+If there is a match, the second string on the line is
+taken as the pathname of a picture file that is added
+to the output file.
+The default
+.I list
+is
+.RM `` ".BP .PI ''.
+.TP
+.OP \-q
+Suppress ``missing picture file'' error messages.
+.PP
+.B picpack
+is a trivial preprocessor that, in a sense, duplicates some of the
+picture inclusion capabilities already available in
+.BR dpost .
+.B picpack
+should not be used if your formatting command line includes
+a call to
+.BR dpost .
+Its only purpose is to combine picture files with text in a single
+file that can be passed through
+.B troff
+and unpacked, at some later time, by
+.BR dpost .
+The original picture inclusion mechanism, with files are pulled in by
+.BR dpost ,
+is the preferred approach.
+.SH EXAMPLES
+A typical application might be in a distributed printing environment
+where everything up to
+.B troff
+is run by the user and everything after
+.B troff
+is handled by a spooling daemon (perhaps
+.BR lp ).
+In that case the command line would be,
+.EX
+pic \f2file\fP | tbl | eqn | picpack | troff -mm -Tpost | lp
+.EE
+A poor example, although one that should still work, would be,
+.EX
+pic \f2file\fP | tbl | eqn | picpack | troff -mm -Tpost | dpost >\f2file\fP.ps
+.EE
+In this case picture inclusion requests could (and should) be handled by
+.BR dpost .
+Running
+.B picpack
+is not needed or even recommended.
+It should be dropped from any pipeline that includes a call to
+.BR dpost .
+.SH DIAGNOSTICS
+A 0 exit status is returned if
+.I files
+were successfully processed.
+.SH WARNINGS
+.PP
+Combining pictures and text using the capabilities available in
+.B dpost
+is the recommended approach and is always guaranteed to be more
+efficient than
+.BR picpack .
+Running
+.B picpack
+and
+.B dpost
+in the same pipeline makes little sense.
+.PP
+Using
+.B picpack
+will likely result in files that can no longer be reliably passed
+through other important
+.B troff
+postprocessors like
+.BR proof .
+At present
+.B picpack
+is only guaranteed to work with
+.BR dpost .
+.SH SEE ALSO
+.BR dpost (1),
+.BR troff (1)
--- a/sys/src/cmd/postscript/postbgi/postbgi.1
+++ /dev/null
@@ -1,243 +1,0 @@
-.ds dQ /usr/lib/postscript
-.TH POSTBGI 1 "DWB 3.2"
-.SH NAME
-.B postbgi
-\- PostScript translator for
-.SM BGI
-(Basic Graphical Instructions) files
-.SH SYNOPSIS
-\*(mBpostbgi\f1
-.OP "" options []
-.OP "" files []
-.SH DESCRIPTION
-.B postbgi
-translates
-.SM BGI
-(Basic Graphical Instructions)
-.I files
-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 \-c num
-.I num
-copies of each page.
-By default only one copy is printed.
-.TP
-.OP \-f name
-Print text using font
-.IR name .
-Any PostScript font can be used,
-although the best results will only be
-obtained with constant width fonts.
-The default font is Courier.
-.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
-.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
-.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 \-w num
-Set the line width used for graphics to
-.I num
-points, where a point is approximately 1/72
-of an inch.
-By default
-.I num
-is set to 0 points, which forces lines to be
-one pixel wide.
-.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 inches.
-.TP
-.OP \-E name
-Set the character encoding for text fonts to
-.IR name .
-Requesting
-.I name
-means include file
-.MI \*(dQ name .enc \f1.
-A nonexistent encoding file is silently ignored.
-The default selects file
-.MR \*(dQ/Default.enc .
-.TP
-.OP \-L file
-Use
-.I file
-as the PostScript prologue.
-.br
-The default is
-.MR \*(dQ/postbgi.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
-.B postbgi
-can handle
-.SM STARE
-(black and white) and
-.SM PRISM
-(color)
-.SM BGI
-jobs.
-By default plots are rigidly scaled to fill the page, which produces
-the good results for most
-.SM STARE
-jobs.
-.SM PRISM
-jobs typically fill regions with colors, and often require device
-specific tuning to produce acceptable results.
-Adding the
-.MW \-P"/prism\ true\ def"
-option is strongly recommended when
-.B postbgi
-is translating
-.SM PRISM
-jobs.
-.br
-.ne 7v
-.SH EXAMPLES
-For most
-.SM STARE
-jobs,
-.EX
-postbgi \f2file
-.EE
-gives good results, while
-.EX
-postbgi \-P"/prism true def" \f2file
-.EE
-is recommended when translating
-.SM PRISM
-jobs.
-.SH DIAGNOSTICS
-A 0 exit status is returned if
-.I files
-were successfully processed.
-.SH BUGS
-The default line width is too small for write-white
-print engines, like the one used by the PS-2400.
-Several
-.SM BGI
-opcodes have not been implemented.
-.SH FILES
-.MW \*(dQ/postbgi.ps
-.br
-.MW \*(dQ/forms.ps
-.br
-.MW \*(dQ/ps.requests
-.SH SEE ALSO
-.BR dpost (1),
-.BR postdaisy (1),
-.BR postdmd (1),
-.BR postio (1),
-.BR postmd (1),
-.BR postprint (1),
-.BR postreverse (1),
-.BR posttek (1),
-.BR psencoding (1)
--- /dev/null
+++ b/sys/src/cmd/postscript/postbgi/postbgi.1.man
@@ -1,0 +1,243 @@
+.ds dQ /usr/lib/postscript
+.TH POSTBGI 1 "DWB 3.2"
+.SH NAME
+.B postbgi
+\- PostScript translator for
+.SM BGI
+(Basic Graphical Instructions) files
+.SH SYNOPSIS
+\*(mBpostbgi\f1
+.OP "" options []
+.OP "" files []
+.SH DESCRIPTION
+.B postbgi
+translates
+.SM BGI
+(Basic Graphical Instructions)
+.I files
+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 \-c num
+.I num
+copies of each page.
+By default only one copy is printed.
+.TP
+.OP \-f name
+Print text using font
+.IR name .
+Any PostScript font can be used,
+although the best results will only be
+obtained with constant width fonts.
+The default font is Courier.
+.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
+.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
+.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 \-w num
+Set the line width used for graphics to
+.I num
+points, where a point is approximately 1/72
+of an inch.
+By default
+.I num
+is set to 0 points, which forces lines to be
+one pixel wide.
+.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 inches.
+.TP
+.OP \-E name
+Set the character encoding for text fonts to
+.IR name .
+Requesting
+.I name
+means include file
+.MI \*(dQ name .enc \f1.
+A nonexistent encoding file is silently ignored.
+The default selects file
+.MR \*(dQ/Default.enc .
+.TP
+.OP \-L file
+Use
+.I file
+as the PostScript prologue.
+.br
+The default is
+.MR \*(dQ/postbgi.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
+.B postbgi
+can handle
+.SM STARE
+(black and white) and
+.SM PRISM
+(color)
+.SM BGI
+jobs.
+By default plots are rigidly scaled to fill the page, which produces
+the good results for most
+.SM STARE
+jobs.
+.SM PRISM
+jobs typically fill regions with colors, and often require device
+specific tuning to produce acceptable results.
+Adding the
+.MW \-P"/prism\ true\ def"
+option is strongly recommended when
+.B postbgi
+is translating
+.SM PRISM
+jobs.
+.br
+.ne 7v
+.SH EXAMPLES
+For most
+.SM STARE
+jobs,
+.EX
+postbgi \f2file
+.EE
+gives good results, while
+.EX
+postbgi \-P"/prism true def" \f2file
+.EE
+is recommended when translating
+.SM PRISM
+jobs.
+.SH DIAGNOSTICS
+A 0 exit status is returned if
+.I files
+were successfully processed.
+.SH BUGS
+The default line width is too small for write-white
+print engines, like the one used by the PS-2400.
+Several
+.SM BGI
+opcodes have not been implemented.
+.SH FILES
+.MW \*(dQ/postbgi.ps
+.br
+.MW \*(dQ/forms.ps
+.br
+.MW \*(dQ/ps.requests
+.SH SEE ALSO
+.BR dpost (1),
+.BR postdaisy (1),
+.BR postdmd (1),
+.BR postio (1),
+.BR postmd (1),
+.BR postprint (1),
+.BR postreverse (1),
+.BR posttek (1),
+.BR psencoding (1)
--- a/sys/src/cmd/postscript/postdaisy/postdaisy.1
+++ /dev/null
@@ -1,217 +1,0 @@
-.ds dQ /usr/lib/postscript
-.TH POSTDAISY 1 "DWB 3.2"
-.SH NAME
-.B postdaisy
-\- PostScript translator for Diablo 630 files
-.SH SYNOPSIS
-\*(mBpostdaisy\f1
-.OP "" options []
-.OP "" files []
-.SH DESCRIPTION
-.B postdaisy
-translates Diablo 630 daisy-wheel
-.I files
-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 \-c num
-.I num
-copies of each page.
-By default only one copy is printed.
-.TP
-.OP \-f name
-.I files
-using font
-.IR name .
-Any PostScript font can be used,
-although the best results will only be
-obtained with constant width fonts.
-The default font is Courier.
-.TP
-.OP \-h num
-Set the initial horizontal motion index to
-.IR num .
-Determines the character advance and the default
-point size, unless the
-.OP \-s
-option is used.
-The default is 12.
-.TP
-.OP \-m num
-Magnify each logical page by the factor
-.IR num .
-Pages are scaled uniformly about the origin,
-which is located near the upper left corner of
-each page.
-The default magnification is 1.0.
-.TP
-.OP \-n num
-.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
-.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 \-r num
-Selects carriage return and line feed behavior.
-If
-.I num
-is 1 a line feed generates a carriage return.
-If
-.I num
-is 2 a carriage return generates a line feed.
-Setting
-.I num
-to 3 enables both modes.
-.TP
-.OP \-s num
-Use point size
-.I num
-instead of the default value set by the
-initial horizontal motion index.
-.TP
-.OP \-v num
-Set the initial vertical motion index to
-.IR num .
-The default is 8.
-.TP
-.OP \-x num
-Translate the origin
-.I num
-inches along the positive x axis.
-The default
-coordinate system has the origin fixed near the
-upper left corner of the page, with positive
-x to the right and positive y down the page.
-Positive
-.I num
-moves everything right.
-The default offset is 0.25 inches.
-.TP
-.OP \-y num
-Translate the origin
-.I num
-inches along the positive y axis.
-Positive
-.I num
-moves text down the page.
-The default offset is 0.25 inches.
-.TP
-.OP \-E name
-Set the character encoding for text fonts to
-.IR name .
-Requesting
-.I name
-means include file
-.MI \*(dQ/ name .enc \f1.
-A nonexistent encoding file is silently ignored.
-The default selects file
-.MR \*(dQ/Default.enc .
-.TP
-.OP \-L file
-Use
-.I file
-as the PostScript prologue.
-.br
-The default is
-.MR \*(dQ/postdaisy.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 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 .
-.SH DIAGNOSTICS
-A 0 exit status is returned if
-.I files
-were successfully processed.
-.SH FILES
-.MW \*(dQ/postdaisy.ps
-.br
-.MW \*(dQ/forms.ps
-.br
-.MW \*(dQ/ps.requests
-.SH SEE ALSO
-.BR dpost (1),
-.BR postdmd (1),
-.BR postio (1),
-.BR postmd (1),
-.BR postprint (1),
-.BR postreverse (1),
-.BR posttek (1),
-.BR psencoding (1)
--- /dev/null
+++ b/sys/src/cmd/postscript/postdaisy/postdaisy.1.man
@@ -1,0 +1,217 @@
+.ds dQ /usr/lib/postscript
+.TH POSTDAISY 1 "DWB 3.2"
+.SH NAME
+.B postdaisy
+\- PostScript translator for Diablo 630 files
+.SH SYNOPSIS
+\*(mBpostdaisy\f1
+.OP "" options []
+.OP "" files []
+.SH DESCRIPTION
+.B postdaisy
+translates Diablo 630 daisy-wheel
+.I files
+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 \-c num
+.I num
+copies of each page.
+By default only one copy is printed.
+.TP
+.OP \-f name
+.I files
+using font
+.IR name .
+Any PostScript font can be used,
+although the best results will only be
+obtained with constant width fonts.
+The default font is Courier.
+.TP
+.OP \-h num
+Set the initial horizontal motion index to
+.IR num .
+Determines the character advance and the default
+point size, unless the
+.OP \-s
+option is used.
+The default is 12.
+.TP
+.OP \-m num
+Magnify each logical page by the factor
+.IR num .
+Pages are scaled uniformly about the origin,
+which is located near the upper left corner of
+each page.
+The default magnification is 1.0.
+.TP
+.OP \-n num
+.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
+.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 \-r num
+Selects carriage return and line feed behavior.
+If
+.I num
+is 1 a line feed generates a carriage return.
+If
+.I num
+is 2 a carriage return generates a line feed.
+Setting
+.I num
+to 3 enables both modes.
+.TP
+.OP \-s num
+Use point size
+.I num
+instead of the default value set by the
+initial horizontal motion index.
+.TP
+.OP \-v num
+Set the initial vertical motion index to
+.IR num .
+The default is 8.
+.TP
+.OP \-x num
+Translate the origin
+.I num
+inches along the positive x axis.
+The default
+coordinate system has the origin fixed near the
+upper left corner of the page, with positive
+x to the right and positive y down the page.
+Positive
+.I num
+moves everything right.
+The default offset is 0.25 inches.
+.TP
+.OP \-y num
+Translate the origin
+.I num
+inches along the positive y axis.
+Positive
+.I num
+moves text down the page.
+The default offset is 0.25 inches.
+.TP
+.OP \-E name
+Set the character encoding for text fonts to
+.IR name .
+Requesting
+.I name
+means include file
+.MI \*(dQ/ name .enc \f1.
+A nonexistent encoding file is silently ignored.
+The default selects file
+.MR \*(dQ/Default.enc .
+.TP
+.OP \-L file
+Use
+.I file
+as the PostScript prologue.
+.br
+The default is
+.MR \*(dQ/postdaisy.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 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 .
+.SH DIAGNOSTICS
+A 0 exit status is returned if
+.I files
+were successfully processed.
+.SH FILES
+.MW \*(dQ/postdaisy.ps
+.br
+.MW \*(dQ/forms.ps
+.br
+.MW \*(dQ/ps.requests
+.SH SEE ALSO
+.BR dpost (1),
+.BR postdmd (1),
+.BR postio (1),
+.BR postmd (1),
+.BR postprint (1),
+.BR postreverse (1),
+.BR posttek (1),
+.BR psencoding (1)
--- a/sys/src/cmd/postscript/postdmd/postdmd.1
+++ /dev/null
@@ -1,206 +1,0 @@
-.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
-.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
-.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
-.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)
--- /dev/null
+++ b/sys/src/cmd/postscript/postdmd/postdmd.1.man
@@ -1,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
+.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
+.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
+.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)
--- a/sys/src/cmd/postscript/postio/postio.1
+++ /dev/null
@@ -1,308 +1,0 @@
-.TH POSTIO 1 "DWB 3.2"
-.SH NAME
-.B postio
-\- serial interface for PostScript printers
-.SH SYNOPSIS
-\*(mBpostio\f1
-.OP \-l line
-.OP "" options []
-.OP "" files []
-.SH DESCRIPTION
-.B postio
-sends
-.I files
-to the PostScript printer attached to
-.IR line .
-If no
-.I files
-are specified the standard input is sent.
-The first group of
-.I options
-should be sufficient for most applications:
-.TP 0.75i
-.OP \-b speed
-Transmit data over
-.I line
-at baud rate
-.I speed.
-Recognized baud rates are 1200, 2400, 4800, 9600, and 19200.
-The default
-.I speed
-is 9600 baud.
-.TP
-.OP \-c
-Do not send
-.MR ^C s
-(interrupts) to the printer,
-which means
-.B postio
-does not force a busy printer into the idle state.
-.TP
-.OP \-l line
-Connect to printer attached to
-.IR line .
-In most cases there is no default and
-.B postio
-must be able to read and write
-.IR line .
-If
-.I line
-does not begin with
-.MW /
-it is treated as a Datakit destination.
-.TP
-.OP \-q
-Prevents status queries while
-.I files
-are being sent to the printer.
-When status queries are disabled a dummy message is appended
-to the log file before each block is transmitted.
-.TP
-.OP \-B num
-Set internal buffer size for reading and writing
-.I files
-to
-.I num
-bytes
-(default is 2048 bytes).
-.TP
-.OP \-D
-Enable debug mode.
-Guarantees that everything read on
-.I line
-will be added to the log file (standard error by default).
-.TP
-.OP \-L file
-Data received on
-.I line
-gets put in
-.IR file .
-The default log
-.I file
-is standard error.
-Printer or status messages that do not indicate a change in state
-are not normally written to
-.I file
-but can be forced out using the
-.OP \-D
-option.
-.TP
-.OP \-P string
-Send
-.I string
-to the printer before any of the input files.
-The default
-.I string
-is simple PostScript code that disables timeouts.
-.TP
-.OP \-R num
-Run
-.B postio
-as a single process if
-.I num
-is 1 or as separate read and write processes if
-.I num
-is 2.
-By default
-.B postio
-runs as a single process.
-.PP
-The next two
-.I options
-are provided for users who expect to run
-.B postio
-on their own.
-Neither is suitable for use in spooler interface
-programs:
-.TP 0.35i
-.OP \-i
-Run the program in interactive mode.
-Any
-.I files
-are sent first and followed by the standard input.
-Forces separate read and write processes
-and overrides many other options.
-To exit interactive mode use your interrupt or quit character.
-To get a friendly interactive connection with the printer type
-.MW executive
-on a line by itself.
-.TP
-.OP \-t
-Data received on
-.I line
-and not recognized as printer or status information is written to
-the standard output.
-Forces separate read and write processes.
-Convenient if you have a PostScript program that
-will be returning useful data to the host.
-.PP
-The last option is not generally recommended and should only
-be used if all else fails to provide a reliable connection:
-.TP 0.35i
-.OP \-S
-Slow the transmission of data to the printer.
-Severely limits throughput, runs as a single process,
-disables the
-.OP \-q
-option, limits the internal buffer size to 1024 bytes,
-can use an excessive amount of
-.SM CPU
-time, and does nothing in interactive mode.
-.PP
-Best performance is usually obtained by using
-a large internal buffer
-.OP -B "" ) (
-and by running the program as separate read and write processes
-.OP \-R2 "" ). (
-Inability to fork the additional process causes
-.B postio
-to continue as a single read/write process.
-When one process is used, only data sent to the printer is flow-controlled.
-.PP
-The options are not all mutually exclusive.
-The
-.OP \-i
-option always wins, selecting its own settings for whatever is
-needed to run interactive mode, independent of anything else
-found on the command line.
-Interactive mode runs as separate read and write processes
-and few of the other
-.I options
-accomplish anything in the presence of the
-.OP \-i
-option.
-The
-.OP \-t
-option needs a reliable two way connection to the printer and
-therefore tries to force separate read and write processes.
-The
-.OP \-S
-option relies on the status query mechanism, so
-.OP \-q
-is disabled and the program runs as a single process.
-.PP
-In most cases
-.B postio
-starts by making a connection to
-.I line
-and then attempts to force the printer into the
-.SM IDLE
-state by sending an appropriate sequence of
-.MW ^T
-(status query),
-.MW ^C
-(interrupt), and
-.MW ^D
-(end of job) characters.
-When the printer goes
-.SM IDLE
-.I files
-are transmitted along with an occasional
-.MW ^T
-(unless the
-.OP \-q
-option was used).
-After all the
-.I files
-are sent the program waits until it is reasonably sure the
-job is complete.
-Printer generated error messages received at any time
-except while establishing the initial connection
-(or when running interactive mode) cause
-.B postio
-to exit with a non-zero status.
-In addition to being added to the log file, printer error messages
-are also echoed to standard error.
-.SH EXAMPLES
-Run as a single process at 9600 baud and send
-.I file1
-and
-.I file2
-to the printer attached to
-.MR /dev/tty01 :
-.EX
-postio -l /dev/tty01 \f2file1 file2
-.EE
-Same as above except two processes are used,
-the internal buffer is set to 4096 bytes,
-and data returned by the printer gets put in file
-.MR log :
-.EX
-postio -R2 -B4096 -l/dev/tty01 -Llog \f2file1 file2
-.EE
-Establish an interactive connection with the printer at Datakit
-destination
-.MR my/printer :
-.EX
-postio -i -l my/printer
-.EE
-Send file
-.MW program
-to the printer connected to
-.MR /dev/tty22 ,
-recover any data in file
-.MR results ,
-and put log messages in file
-.MR log :
-.EX
-postio -t -l /dev/tty22 -L log program >results
-.EE
-.SH DIAGNOSTICS
-A 0 exit status is returned if the files ran successfully.
-System errors (e.g., ``can't open the line'') set the low order
-bit in the exit status, while PostScript errors set bit 1.
-An exit status of 2 usually means the printer
-detected a PostScript error in the input
-.IR files .
-.SH WARNINGS
-.PP
-The input
-.I files
-are handled as a single PostScript job.
-Sending several different jobs, each with their own internal
-end of job mark
-.RM ( ^D )
-is not guaranteed to work properly.
-.B postio
-may quit before all the jobs have completed and could be restarted
-before the last one finishes.
-.PP
-All the capabilities described above may not be available on every
-machine or even across the different versions of
-.SM UNIX
-that are currently supported by the program.
-For example, the code needed to connect to a Datakit destination may only
-work on System\ V and may require that the
-.SM DKHOST
-software package be available at compile time.
-.PP
-There may be no default
-.I line
-so using
-.OP \-l
-option is strongly recommended.
-If omitted
-.B postio
-may attempt to connect to the printer using the standard output.
-If Datakit is involved the
-.OP \-b
-may be ineffective and attempts by
-.B postio
-to flow control data in both directions may not work.
-The
-.OP \-q
-option can help if the printer is connected to \s-1RADIAN\s+1.
-The
-.OP \-S
-option is not generally recommended and should only be used if
-all else fails to establish a reliable connection.
-.SH SEE ALSO
-.BR buildtables (1),
-.BR dpost (1),
-.BR postdaisy (1),
-.BR postdmd (1),
-.BR postmd (1),
-.BR postprint (1),
-.BR postreverse (1),
-.BR posttek (1),
-.BR printfont (1)
--- /dev/null
+++ b/sys/src/cmd/postscript/postio/postio.1.man
@@ -1,0 +1,308 @@
+.TH POSTIO 1 "DWB 3.2"
+.SH NAME
+.B postio
+\- serial interface for PostScript printers
+.SH SYNOPSIS
+\*(mBpostio\f1
+.OP \-l line
+.OP "" options []
+.OP "" files []
+.SH DESCRIPTION
+.B postio
+sends
+.I files
+to the PostScript printer attached to
+.IR line .
+If no
+.I files
+are specified the standard input is sent.
+The first group of
+.I options
+should be sufficient for most applications:
+.TP 0.75i
+.OP \-b speed
+Transmit data over
+.I line
+at baud rate
+.I speed.
+Recognized baud rates are 1200, 2400, 4800, 9600, and 19200.
+The default
+.I speed
+is 9600 baud.
+.TP
+.OP \-c
+Do not send
+.MR ^C s
+(interrupts) to the printer,
+which means
+.B postio
+does not force a busy printer into the idle state.
+.TP
+.OP \-l line
+Connect to printer attached to
+.IR line .
+In most cases there is no default and
+.B postio
+must be able to read and write
+.IR line .
+If
+.I line
+does not begin with
+.MW /
+it is treated as a Datakit destination.
+.TP
+.OP \-q
+Prevents status queries while
+.I files
+are being sent to the printer.
+When status queries are disabled a dummy message is appended
+to the log file before each block is transmitted.
+.TP
+.OP \-B num
+Set internal buffer size for reading and writing
+.I files
+to
+.I num
+bytes
+(default is 2048 bytes).
+.TP
+.OP \-D
+Enable debug mode.
+Guarantees that everything read on
+.I line
+will be added to the log file (standard error by default).
+.TP
+.OP \-L file
+Data received on
+.I line
+gets put in
+.IR file .
+The default log
+.I file
+is standard error.
+Printer or status messages that do not indicate a change in state
+are not normally written to
+.I file
+but can be forced out using the
+.OP \-D
+option.
+.TP
+.OP \-P string
+Send
+.I string
+to the printer before any of the input files.
+The default
+.I string
+is simple PostScript code that disables timeouts.
+.TP
+.OP \-R num
+Run
+.B postio
+as a single process if
+.I num
+is 1 or as separate read and write processes if
+.I num
+is 2.
+By default
+.B postio
+runs as a single process.
+.PP
+The next two
+.I options
+are provided for users who expect to run
+.B postio
+on their own.
+Neither is suitable for use in spooler interface
+programs:
+.TP 0.35i
+.OP \-i
+Run the program in interactive mode.
+Any
+.I files
+are sent first and followed by the standard input.
+Forces separate read and write processes
+and overrides many other options.
+To exit interactive mode use your interrupt or quit character.
+To get a friendly interactive connection with the printer type
+.MW executive
+on a line by itself.
+.TP
+.OP \-t
+Data received on
+.I line
+and not recognized as printer or status information is written to
+the standard output.
+Forces separate read and write processes.
+Convenient if you have a PostScript program that
+will be returning useful data to the host.
+.PP
+The last option is not generally recommended and should only
+be used if all else fails to provide a reliable connection:
+.TP 0.35i
+.OP \-S
+Slow the transmission of data to the printer.
+Severely limits throughput, runs as a single process,
+disables the
+.OP \-q
+option, limits the internal buffer size to 1024 bytes,
+can use an excessive amount of
+.SM CPU
+time, and does nothing in interactive mode.
+.PP
+Best performance is usually obtained by using
+a large internal buffer
+.OP -B "" ) (
+and by running the program as separate read and write processes
+.OP \-R2 "" ). (
+Inability to fork the additional process causes
+.B postio
+to continue as a single read/write process.
+When one process is used, only data sent to the printer is flow-controlled.
+.PP
+The options are not all mutually exclusive.
+The
+.OP \-i
+option always wins, selecting its own settings for whatever is
+needed to run interactive mode, independent of anything else
+found on the command line.
+Interactive mode runs as separate read and write processes
+and few of the other
+.I options
+accomplish anything in the presence of the
+.OP \-i
+option.
+The
+.OP \-t
+option needs a reliable two way connection to the printer and
+therefore tries to force separate read and write processes.
+The
+.OP \-S
+option relies on the status query mechanism, so
+.OP \-q
+is disabled and the program runs as a single process.
+.PP
+In most cases
+.B postio
+starts by making a connection to
+.I line
+and then attempts to force the printer into the
+.SM IDLE
+state by sending an appropriate sequence of
+.MW ^T
+(status query),
+.MW ^C
+(interrupt), and
+.MW ^D
+(end of job) characters.
+When the printer goes
+.SM IDLE
+.I files
+are transmitted along with an occasional
+.MW ^T
+(unless the
+.OP \-q
+option was used).
+After all the
+.I files
+are sent the program waits until it is reasonably sure the
+job is complete.
+Printer generated error messages received at any time
+except while establishing the initial connection
+(or when running interactive mode) cause
+.B postio
+to exit with a non-zero status.
+In addition to being added to the log file, printer error messages
+are also echoed to standard error.
+.SH EXAMPLES
+Run as a single process at 9600 baud and send
+.I file1
+and
+.I file2
+to the printer attached to
+.MR /dev/tty01 :
+.EX
+postio -l /dev/tty01 \f2file1 file2
+.EE
+Same as above except two processes are used,
+the internal buffer is set to 4096 bytes,
+and data returned by the printer gets put in file
+.MR log :
+.EX
+postio -R2 -B4096 -l/dev/tty01 -Llog \f2file1 file2
+.EE
+Establish an interactive connection with the printer at Datakit
+destination
+.MR my/printer :
+.EX
+postio -i -l my/printer
+.EE
+Send file
+.MW program
+to the printer connected to
+.MR /dev/tty22 ,
+recover any data in file
+.MR results ,
+and put log messages in file
+.MR log :
+.EX
+postio -t -l /dev/tty22 -L log program >results
+.EE
+.SH DIAGNOSTICS
+A 0 exit status is returned if the files ran successfully.
+System errors (e.g., ``can't open the line'') set the low order
+bit in the exit status, while PostScript errors set bit 1.
+An exit status of 2 usually means the printer
+detected a PostScript error in the input
+.IR files .
+.SH WARNINGS
+.PP
+The input
+.I files
+are handled as a single PostScript job.
+Sending several different jobs, each with their own internal
+end of job mark
+.RM ( ^D )
+is not guaranteed to work properly.
+.B postio
+may quit before all the jobs have completed and could be restarted
+before the last one finishes.
+.PP
+All the capabilities described above may not be available on every
+machine or even across the different versions of
+.SM UNIX
+that are currently supported by the program.
+For example, the code needed to connect to a Datakit destination may only
+work on System\ V and may require that the
+.SM DKHOST
+software package be available at compile time.
+.PP
+There may be no default
+.I line
+so using
+.OP \-l
+option is strongly recommended.
+If omitted
+.B postio
+may attempt to connect to the printer using the standard output.
+If Datakit is involved the
+.OP \-b
+may be ineffective and attempts by
+.B postio
+to flow control data in both directions may not work.
+The
+.OP \-q
+option can help if the printer is connected to \s-1RADIAN\s+1.
+The
+.OP \-S
+option is not generally recommended and should only be used if
+all else fails to establish a reliable connection.
+.SH SEE ALSO
+.BR buildtables (1),
+.BR dpost (1),
+.BR postdaisy (1),
+.BR postdmd (1),
+.BR postmd (1),
+.BR postprint (1),
+.BR postreverse (1),
+.BR posttek (1),
+.BR printfont (1)
--- a/sys/src/cmd/postscript/postmd/postmd.1
+++ /dev/null
@@ -1,330 +1,0 @@
-.ds dQ /usr/lib/postscript
-.TH POSTMD 1 "DWB 3.2"
-.SH NAME
-.B postmd
-\- matrix display program for PostScript printers
-.SH SYNOPSIS
-\*(mBpostmd\f1
-.OP "" options []
-.OP "" files []
-.SH DESCRIPTION
-.B postmd
-reads a series of floating point numbers from
-.IR files ,
-translates them into a PostScript gray scale image,
-and writes the results on the standard output.
-In a typical application the numbers might be
-the elements of a large matrix,
-written in row major order,
-while the printed image could help locate
-patterns in the matrix.
-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
-.I num
-copies of each page.
-By default only one copy is printed.
-.TP
-.OP \-d dimen
-Sets the default matrix dimensions for all input
-.I files
-to
-.IR dimen .
-The
-.I dimen
-string can be given as rows or rows\^\(mu\^columns.
-If columns is omitted it will be set to rows.
-By default
-.B postmd
-assumes each matrix is square and sets the number of rows
-and columns to the square root of the number of elements in
-each input file.
-.TP
-.OP \-g list
-.I list
-is a comma- or space-separated string of integers, each lying between
-0 and 255 inclusive,
-that assigns PostScript gray scales to the regions of the real line
-selected by the
-.OP \-i
-option.
-255 corresponds to white and 0 to black.
-.B postmd
-assigns a default gray scale that omits white (i.e., 255) and gets
-darker as the regions move from left to right along the real line.
-.TP
-.OP \-i list
-.I list
-is a comma- or space-separated string of
-.I N
-floating point numbers that
-partition the real line into
-.RI 2 N +1
-regions.
-The
-.I list
-must be given in increasing numerical order.
-The partitions are used to map floating point numbers read from the input
-.I files
-into gray scale integers that are assigned automatically by
-.B postmd
-or arbitrarily selected using the
-.OP \-g
-option.
-The default interval
-.I list
-is ``\*(mB\-1,0,1\fP'' which partions the real line into 7 regions.
-.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
-.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
-.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 \-w window
-.I window
-is a comma- or space-separated list of four positive integers that
-select the upper left and lower right corners of a submatrix from
-each of the input
-.IR files .
-Row and column indices start at 1 in the upper left corner and the
-numbers in the input
-.I files
-are assumed to be written in row major order.
-By default the entire matrix is displayed.
-.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
-.OP \-E name
-Set the character encoding for text fonts to
-.IR name .
-Requesting
-.I name
-means include file
-.MI \*(dQ/ name .enc \f1.
-A nonexistent encoding file is silently ignored.
-The default selects file
-.MR \*(dQ/Default.enc .
-.TP
-.OP \-L file
-Use
-.I file
-as the PostScript prologue.
-.br
-The default is
-.MR \*(dQ/postmd.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 matrix is displayed on each logical page,
-and each of the input
-.I files
-must contain complete descriptions of exactly one matrix.
-Matrix elements are floating point numbers arranged in row major order in
-each input file.
-White space, including newlines, is not used to determine matrix
-dimensions.
-By default
-.B postmd
-assumes each matrix is square and sets the number of rows and columns
-to the square root of the number of elements in the input file.
-Supplying default dimensions on the command line using the
-.OP \-d
-option overrides this default behavior, and in that case the
-dimensions apply to all input
-.IR files .
-.PP
-An optional header can be supplied with each input file and is used
-to set the matrix dimensions, the partition of the real line, the gray scale
-map, and a window into the matrix.
-The header consists of keyword/value pairs, each on a separate line.
-It begins on the first line of each input file and ends with the
-first unrecognized string, which should be the first matrix element.
-Values set in the header take precedence, but only apply to the
-current input file.
-Recognized header keywords are
-.MR dimension ,
-.MR interval ,
-.MR grayscale ,
-and
-.MR window .
-The syntax of the value string that follows each keyword parallels what is
-accepted by the
-.OP \-d ,
-.OP \-i ,
-.OP \-g ,
-and
-.OP \-w
-options.
-.SH EXAMPLES
-For example, suppose
-.I file
-initially contains the 1000 numbers
-in a 20\(mu50 matrix.
-Then the command line:
-.EX
-postmd -d20x50 -i"-100 100" -g0,128,254,128,0 \f2file
-.EE
-and prepending the header,
-.EX
-dimension 20x50
-interval -100.0 .100e+3
-grayscale 0 128 254 128 0
-.EE
-to
-.I file
-and typing the command line:
-.EX
-postmd \f2file
-.EE
-produce exactly the same output.
-The interval list partitions the real line into five regions and
-the gray scale list maps numbers less than \-100 or greater than 100
-into 0 (i.e., black), numbers equal to \-100 or 100 into 128
-(i.e., 50 percent
-black), and numbers between \-100 and 100 into 254 (i.e., almost white).
-.SH DIAGNOSTICS
-A 0 exit status is returned if
-.I files
-were successfully processed.
-.SH WARNINGS
-The largest matrix that can be adequately displayed is a function
-of the interval and gray scale lists, the printer resolution,
-and the paper size.
-A 600\(mu600 matrix is an optimistic upper bound for a two element interval
-list (i.e. five regions) using 8.5\(mu11 inch paper on a 300 dpi printer.
-.PP
-Using white (i.e., 255) in a gray scale list is not recommended and will not
-show up in the legend and bar graph that
-.B postmd
-displays below each image.
-.SH FILES
-.MW \*(dQ/postmd.ps
-.br
-.MW \*(dQ/forms.ps
-.br
-.MW \*(dQ/ps.requests
-.SH SEE ALSO
-.BR dpost (1),
-.BR postdaisy (1),
-.BR postdmd (1),
-.BR postio (1),
-.BR postprint (1),
-.BR postreverse (1),
-.BR posttek (1),
-.BR psencoding (1)
--- /dev/null
+++ b/sys/src/cmd/postscript/postmd/postmd.1.man
@@ -1,0 +1,330 @@
+.ds dQ /usr/lib/postscript
+.TH POSTMD 1 "DWB 3.2"
+.SH NAME
+.B postmd
+\- matrix display program for PostScript printers
+.SH SYNOPSIS
+\*(mBpostmd\f1
+.OP "" options []
+.OP "" files []
+.SH DESCRIPTION
+.B postmd
+reads a series of floating point numbers from
+.IR files ,
+translates them into a PostScript gray scale image,
+and writes the results on the standard output.
+In a typical application the numbers might be
+the elements of a large matrix,
+written in row major order,
+while the printed image could help locate
+patterns in the matrix.
+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
+.I num
+copies of each page.
+By default only one copy is printed.
+.TP
+.OP \-d dimen
+Sets the default matrix dimensions for all input
+.I files
+to
+.IR dimen .
+The
+.I dimen
+string can be given as rows or rows\^\(mu\^columns.
+If columns is omitted it will be set to rows.
+By default
+.B postmd
+assumes each matrix is square and sets the number of rows
+and columns to the square root of the number of elements in
+each input file.
+.TP
+.OP \-g list
+.I list
+is a comma- or space-separated string of integers, each lying between
+0 and 255 inclusive,
+that assigns PostScript gray scales to the regions of the real line
+selected by the
+.OP \-i
+option.
+255 corresponds to white and 0 to black.
+.B postmd
+assigns a default gray scale that omits white (i.e., 255) and gets
+darker as the regions move from left to right along the real line.
+.TP
+.OP \-i list
+.I list
+is a comma- or space-separated string of
+.I N
+floating point numbers that
+partition the real line into
+.RI 2 N +1
+regions.
+The
+.I list
+must be given in increasing numerical order.
+The partitions are used to map floating point numbers read from the input
+.I files
+into gray scale integers that are assigned automatically by
+.B postmd
+or arbitrarily selected using the
+.OP \-g
+option.
+The default interval
+.I list
+is ``\*(mB\-1,0,1\fP'' which partions the real line into 7 regions.
+.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
+.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
+.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 \-w window
+.I window
+is a comma- or space-separated list of four positive integers that
+select the upper left and lower right corners of a submatrix from
+each of the input
+.IR files .
+Row and column indices start at 1 in the upper left corner and the
+numbers in the input
+.I files
+are assumed to be written in row major order.
+By default the entire matrix is displayed.
+.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
+.OP \-E name
+Set the character encoding for text fonts to
+.IR name .
+Requesting
+.I name
+means include file
+.MI \*(dQ/ name .enc \f1.
+A nonexistent encoding file is silently ignored.
+The default selects file
+.MR \*(dQ/Default.enc .
+.TP
+.OP \-L file
+Use
+.I file
+as the PostScript prologue.
+.br
+The default is
+.MR \*(dQ/postmd.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 matrix is displayed on each logical page,
+and each of the input
+.I files
+must contain complete descriptions of exactly one matrix.
+Matrix elements are floating point numbers arranged in row major order in
+each input file.
+White space, including newlines, is not used to determine matrix
+dimensions.
+By default
+.B postmd
+assumes each matrix is square and sets the number of rows and columns
+to the square root of the number of elements in the input file.
+Supplying default dimensions on the command line using the
+.OP \-d
+option overrides this default behavior, and in that case the
+dimensions apply to all input
+.IR files .
+.PP
+An optional header can be supplied with each input file and is used
+to set the matrix dimensions, the partition of the real line, the gray scale
+map, and a window into the matrix.
+The header consists of keyword/value pairs, each on a separate line.
+It begins on the first line of each input file and ends with the
+first unrecognized string, which should be the first matrix element.
+Values set in the header take precedence, but only apply to the
+current input file.
+Recognized header keywords are
+.MR dimension ,
+.MR interval ,
+.MR grayscale ,
+and
+.MR window .
+The syntax of the value string that follows each keyword parallels what is
+accepted by the
+.OP \-d ,
+.OP \-i ,
+.OP \-g ,
+and
+.OP \-w
+options.
+.SH EXAMPLES
+For example, suppose
+.I file
+initially contains the 1000 numbers
+in a 20\(mu50 matrix.
+Then the command line:
+.EX
+postmd -d20x50 -i"-100 100" -g0,128,254,128,0 \f2file
+.EE
+and prepending the header,
+.EX
+dimension 20x50
+interval -100.0 .100e+3
+grayscale 0 128 254 128 0
+.EE
+to
+.I file
+and typing the command line:
+.EX
+postmd \f2file
+.EE
+produce exactly the same output.
+The interval list partitions the real line into five regions and
+the gray scale list maps numbers less than \-100 or greater than 100
+into 0 (i.e., black), numbers equal to \-100 or 100 into 128
+(i.e., 50 percent
+black), and numbers between \-100 and 100 into 254 (i.e., almost white).
+.SH DIAGNOSTICS
+A 0 exit status is returned if
+.I files
+were successfully processed.
+.SH WARNINGS
+The largest matrix that can be adequately displayed is a function
+of the interval and gray scale lists, the printer resolution,
+and the paper size.
+A 600\(mu600 matrix is an optimistic upper bound for a two element interval
+list (i.e. five regions) using 8.5\(mu11 inch paper on a 300 dpi printer.
+.PP
+Using white (i.e., 255) in a gray scale list is not recommended and will not
+show up in the legend and bar graph that
+.B postmd
+displays below each image.
+.SH FILES
+.MW \*(dQ/postmd.ps
+.br
+.MW \*(dQ/forms.ps
+.br
+.MW \*(dQ/ps.requests
+.SH SEE ALSO
+.BR dpost (1),
+.BR postdaisy (1),
+.BR postdmd (1),
+.BR postio (1),
+.BR postprint (1),
+.BR postreverse (1),
+.BR posttek (1),
+.BR psencoding (1)
--- a/sys/src/cmd/postscript/trofftable/trofftable.1
+++ /dev/null
@@ -1,164 +1,0 @@
-.ds dF /usr/lib/font
-.ds dQ /usr/lib/postscript
-.TH TROFFTABLE 1 "DWB 3.2"
-.SH NAME
-.B trofftable
-\- output a PostScript program that builds a font width table
-.SH SYNOPSIS
-\*(mBtrofftable\f1
-.OP "" options []
-.OP "" shortname
-.OP "" longname []
-.SH DESCRIPTION
-.B trofftable
-writes a PostScript program on the standard output that builds a
-font width table or typesetter description file.
-The following
-.I options
-are understood:
-.TP 1.0i
-.OP \-t name
-Use
-.I name
-as the template for fonts not in the default set.
-Choose
-.MW R
-for proportionally spaced fonts and
-.MW CW
-for fixed width fonts.
-Try
-.MW ZD
-(ZapfDingbats) if the font has a non-standard
-character set.
-The default is
-.MR R .
-.TP 1.0i
-.OP \-C file
-Copy
-.I file
-into each PostScript table program;
-.I file
-must contain legitimate PostScript.
-.TP 1.0i
-.OP \-H hostdir
-Use
-.I hostdir
-as the host resident font directory.
-A file in
-.I hostdir
-that matches the name of the troff font is assumed to be a host
-resident font program and is included in the PostScript width
-table program.
-There is no default.
-.TP 1.0i
-.OP \-L file
-Use
-.I file
-as the PostScript prologue.
-.br
-The default is
-.MW \*(dQ/trofftable.ps
-.TP 1.0i
-.OP \-S file
-Use
-.I file
-as the shell library file.
-Overrides the choice made with the
-.OP \-T
-option.
-.TP 1.0i
-.OP \-T name
-Set the target device to
-.IR name .
-Device
-.I name
-means
-.br
-.MI \*(dF/dev name /shell.lib
-is the shell library file.
-There is no default.
-.PP
-One of
-.OP \-T
-or
-.OP \-S
-is required.
-If both are given
-.OP \-S
-wins.
-Either
-.OP \-H
-or
-.OP \-C
-can be used to include a host resident font.
-.PP
-The shell library file defines a collection of functions used to
-build troff tables.
-The default set of tables is the list of names returned by the
-.MW AllTables
-function.
-Changes to the default list can be made by updating the
-.MW BuiltinTables
-function.
-.PP
-.I Shortname
-is the name of the
-.B troff
-font and
-.I longname
-is the name of the PostScript font;
-.I longname
-can be omitted only if
-.I shortname
-is a default table name.
-PostScript table programs created by
-.B trofftable
-return data to the host computer using PostScript's
-.MW print
-operator.
-See
-.BR hardcopy (1)
-if you don't have access to the printer's serial port.
-.SH EXAMPLES
-Get the PostScript program that builds a width table for font
-.MR R :
-.EX
-trofftable -Tpost R >R.ps
-.EE
-If a font is not in the default set include the
-.B troff
-and PostScript font names:
-.EX
-trofftable -TLatin1 GL Garamond-Light >GL.ps
-.EE
-A font must be available on the printer when the table is built.
-Use
-.OP \-H
-or
-.OP \-C
-to include host resident fonts.
-.SH WARNINGS
-A width table will not build properly if the printer cannot access
-the PostScript font.
-.PP
-The
-.OP -TLatin1
-option only works on PostScript printers that support the full
-.SM ISO
-Latin-1 character set.
-The error message from older printers will likely indicate a missing
-.MW ISOLatin1Encoding
-array.
-.SH FILES
-.MW \*(dF/dev*/shell.lib
-.br
-.MW \*(dQ/dpost.ps
-.br
-.MW \*(dQ/trofftable.ps
-.SH SEE ALSO
-.BR dpost (1),
-.BR hardcopy (1),
-.BR postio (1),
-.BR troff (1),
-.BR buildtables (1),
-.BR font (5)
--- /dev/null
+++ b/sys/src/cmd/postscript/trofftable/trofftable.1.man
@@ -1,0 +1,164 @@
+.ds dF /usr/lib/font
+.ds dQ /usr/lib/postscript
+.TH TROFFTABLE 1 "DWB 3.2"
+.SH NAME
+.B trofftable
+\- output a PostScript program that builds a font width table
+.SH SYNOPSIS
+\*(mBtrofftable\f1
+.OP "" options []
+.OP "" shortname
+.OP "" longname []
+.SH DESCRIPTION
+.B trofftable
+writes a PostScript program on the standard output that builds a
+font width table or typesetter description file.
+The following
+.I options
+are understood:
+.TP 1.0i
+.OP \-t name
+Use
+.I name
+as the template for fonts not in the default set.
+Choose
+.MW R
+for proportionally spaced fonts and
+.MW CW
+for fixed width fonts.
+Try
+.MW ZD
+(ZapfDingbats) if the font has a non-standard
+character set.
+The default is
+.MR R .
+.TP 1.0i
+.OP \-C file
+Copy
+.I file
+into each PostScript table program;
+.I file
+must contain legitimate PostScript.
+.TP 1.0i
+.OP \-H hostdir
+Use
+.I hostdir
+as the host resident font directory.
+A file in
+.I hostdir
+that matches the name of the troff font is assumed to be a host
+resident font program and is included in the PostScript width
+table program.
+There is no default.
+.TP 1.0i
+.OP \-L file
+Use
+.I file
+as the PostScript prologue.
+.br
+The default is
+.MW \*(dQ/trofftable.ps
+.TP 1.0i
+.OP \-S file
+Use
+.I file
+as the shell library file.
+Overrides the choice made with the
+.OP \-T
+option.
+.TP 1.0i
+.OP \-T name
+Set the target device to
+.IR name .
+Device
+.I name
+means
+.br
+.MI \*(dF/dev name /shell.lib
+is the shell library file.
+There is no default.
+.PP
+One of
+.OP \-T
+or
+.OP \-S
+is required.
+If both are given
+.OP \-S
+wins.
+Either
+.OP \-H
+or
+.OP \-C
+can be used to include a host resident font.
+.PP
+The shell library file defines a collection of functions used to
+build troff tables.
+The default set of tables is the list of names returned by the
+.MW AllTables
+function.
+Changes to the default list can be made by updating the
+.MW BuiltinTables
+function.
+.PP
+.I Shortname
+is the name of the
+.B troff
+font and
+.I longname
+is the name of the PostScript font;
+.I longname
+can be omitted only if
+.I shortname
+is a default table name.
+PostScript table programs created by
+.B trofftable
+return data to the host computer using PostScript's
+.MW print
+operator.
+See
+.BR hardcopy (1)
+if you don't have access to the printer's serial port.
+.SH EXAMPLES
+Get the PostScript program that builds a width table for font
+.MR R :
+.EX
+trofftable -Tpost R >R.ps
+.EE
+If a font is not in the default set include the
+.B troff
+and PostScript font names:
+.EX
+trofftable -TLatin1 GL Garamond-Light >GL.ps
+.EE
+A font must be available on the printer when the table is built.
+Use
+.OP \-H
+or
+.OP \-C
+to include host resident fonts.
+.SH WARNINGS
+A width table will not build properly if the printer cannot access
+the PostScript font.
+.PP
+The
+.OP -TLatin1
+option only works on PostScript printers that support the full
+.SM ISO
+Latin-1 character set.
+The error message from older printers will likely indicate a missing
+.MW ISOLatin1Encoding
+array.
+.SH FILES
+.MW \*(dF/dev*/shell.lib
+.br
+.MW \*(dQ/dpost.ps
+.br
+.MW \*(dQ/trofftable.ps
+.SH SEE ALSO
+.BR dpost (1),
+.BR hardcopy (1),
+.BR postio (1),
+.BR troff (1),
+.BR buildtables (1),
+.BR font (5)
--
⑨