From efa6bda322161687bfc1e6cb057f0177775b1180 Mon Sep 17 00:00:00 2001 From: cinap_lenrek Date: Wed, 4 May 2011 09:14:37 +0000 Subject: more manpages --- sys/src/cmd/postscript/buildtables/buildtables.1 | 214 ------------- .../cmd/postscript/buildtables/buildtables.1.man | 214 +++++++++++++ sys/src/cmd/postscript/mcolor/mcolor.5 | 60 ---- sys/src/cmd/postscript/mcolor/mcolor.5.man | 60 ++++ sys/src/cmd/postscript/misc/laserbar.1 | 41 --- sys/src/cmd/postscript/misc/laserbar.1.man | 41 +++ sys/src/cmd/postscript/picpack/picpack.1 | 123 -------- sys/src/cmd/postscript/picpack/picpack.1.man | 123 ++++++++ sys/src/cmd/postscript/postbgi/postbgi.1 | 243 --------------- sys/src/cmd/postscript/postbgi/postbgi.1.man | 243 +++++++++++++++ sys/src/cmd/postscript/postdaisy/postdaisy.1 | 217 -------------- sys/src/cmd/postscript/postdaisy/postdaisy.1.man | 217 ++++++++++++++ sys/src/cmd/postscript/postdmd/postdmd.1 | 206 ------------- sys/src/cmd/postscript/postdmd/postdmd.1.man | 206 +++++++++++++ sys/src/cmd/postscript/postio/postio.1 | 308 ------------------- sys/src/cmd/postscript/postio/postio.1.man | 308 +++++++++++++++++++ sys/src/cmd/postscript/postmd/postmd.1 | 330 --------------------- sys/src/cmd/postscript/postmd/postmd.1.man | 330 +++++++++++++++++++++ sys/src/cmd/postscript/trofftable/trofftable.1 | 164 ---------- sys/src/cmd/postscript/trofftable/trofftable.1.man | 164 ++++++++++ 20 files changed, 1906 insertions(+), 1906 deletions(-) delete mode 100644 sys/src/cmd/postscript/buildtables/buildtables.1 create mode 100644 sys/src/cmd/postscript/buildtables/buildtables.1.man delete mode 100644 sys/src/cmd/postscript/mcolor/mcolor.5 create mode 100644 sys/src/cmd/postscript/mcolor/mcolor.5.man delete mode 100644 sys/src/cmd/postscript/misc/laserbar.1 create mode 100644 sys/src/cmd/postscript/misc/laserbar.1.man delete mode 100644 sys/src/cmd/postscript/picpack/picpack.1 create mode 100644 sys/src/cmd/postscript/picpack/picpack.1.man delete mode 100644 sys/src/cmd/postscript/postbgi/postbgi.1 create mode 100644 sys/src/cmd/postscript/postbgi/postbgi.1.man delete mode 100644 sys/src/cmd/postscript/postdaisy/postdaisy.1 create mode 100644 sys/src/cmd/postscript/postdaisy/postdaisy.1.man delete mode 100644 sys/src/cmd/postscript/postdmd/postdmd.1 create mode 100644 sys/src/cmd/postscript/postdmd/postdmd.1.man delete mode 100644 sys/src/cmd/postscript/postio/postio.1 create mode 100644 sys/src/cmd/postscript/postio/postio.1.man delete mode 100644 sys/src/cmd/postscript/postmd/postmd.1 create mode 100644 sys/src/cmd/postscript/postmd/postmd.1.man delete mode 100644 sys/src/cmd/postscript/trofftable/trofftable.1 create mode 100644 sys/src/cmd/postscript/trofftable/trofftable.1.man (limited to 'sys/src/cmd/postscript') diff --git a/sys/src/cmd/postscript/buildtables/buildtables.1 b/sys/src/cmd/postscript/buildtables/buildtables.1 deleted file mode 100644 index dd7ce7de9..000000000 --- a/sys/src/cmd/postscript/buildtables/buildtables.1 +++ /dev/null @@ -1,214 +0,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) diff --git a/sys/src/cmd/postscript/buildtables/buildtables.1.man b/sys/src/cmd/postscript/buildtables/buildtables.1.man new file mode 100644 index 000000000..dd7ce7de9 --- /dev/null +++ b/sys/src/cmd/postscript/buildtables/buildtables.1.man @@ -0,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) diff --git a/sys/src/cmd/postscript/mcolor/mcolor.5 b/sys/src/cmd/postscript/mcolor/mcolor.5 deleted file mode 100644 index bf0181fda..000000000 --- a/sys/src/cmd/postscript/mcolor/mcolor.5 +++ /dev/null @@ -1,60 +0,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) diff --git a/sys/src/cmd/postscript/mcolor/mcolor.5.man b/sys/src/cmd/postscript/mcolor/mcolor.5.man new file mode 100644 index 000000000..bf0181fda --- /dev/null +++ b/sys/src/cmd/postscript/mcolor/mcolor.5.man @@ -0,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) diff --git a/sys/src/cmd/postscript/misc/laserbar.1 b/sys/src/cmd/postscript/misc/laserbar.1 deleted file mode 100644 index e845fc9bc..000000000 --- a/sys/src/cmd/postscript/misc/laserbar.1 +++ /dev/null @@ -1,41 +0,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. diff --git a/sys/src/cmd/postscript/misc/laserbar.1.man b/sys/src/cmd/postscript/misc/laserbar.1.man new file mode 100644 index 000000000..e845fc9bc --- /dev/null +++ b/sys/src/cmd/postscript/misc/laserbar.1.man @@ -0,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. diff --git a/sys/src/cmd/postscript/picpack/picpack.1 b/sys/src/cmd/postscript/picpack/picpack.1 deleted file mode 100644 index ee5a428fa..000000000 --- a/sys/src/cmd/postscript/picpack/picpack.1 +++ /dev/null @@ -1,123 +0,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) diff --git a/sys/src/cmd/postscript/picpack/picpack.1.man b/sys/src/cmd/postscript/picpack/picpack.1.man new file mode 100644 index 000000000..ee5a428fa --- /dev/null +++ b/sys/src/cmd/postscript/picpack/picpack.1.man @@ -0,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) diff --git a/sys/src/cmd/postscript/postbgi/postbgi.1 b/sys/src/cmd/postscript/postbgi/postbgi.1 deleted file mode 100644 index 971e14a0c..000000000 --- a/sys/src/cmd/postscript/postbgi/postbgi.1 +++ /dev/null @@ -1,243 +0,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 -Print -.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 -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 \-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) diff --git a/sys/src/cmd/postscript/postbgi/postbgi.1.man b/sys/src/cmd/postscript/postbgi/postbgi.1.man new file mode 100644 index 000000000..971e14a0c --- /dev/null +++ b/sys/src/cmd/postscript/postbgi/postbgi.1.man @@ -0,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 +Print +.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 +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 \-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) diff --git a/sys/src/cmd/postscript/postdaisy/postdaisy.1 b/sys/src/cmd/postscript/postdaisy/postdaisy.1 deleted file mode 100644 index a8716aa2e..000000000 --- a/sys/src/cmd/postscript/postdaisy/postdaisy.1 +++ /dev/null @@ -1,217 +0,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 -Print -.I num -copies of each page. -By default only one copy is printed. -.TP -.OP \-f name -Print -.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 -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 \-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) diff --git a/sys/src/cmd/postscript/postdaisy/postdaisy.1.man b/sys/src/cmd/postscript/postdaisy/postdaisy.1.man new file mode 100644 index 000000000..a8716aa2e --- /dev/null +++ b/sys/src/cmd/postscript/postdaisy/postdaisy.1.man @@ -0,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 +Print +.I num +copies of each page. +By default only one copy is printed. +.TP +.OP \-f name +Print +.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 +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 \-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) diff --git a/sys/src/cmd/postscript/postdmd/postdmd.1 b/sys/src/cmd/postscript/postdmd/postdmd.1 deleted file mode 100644 index cb3317b14..000000000 --- a/sys/src/cmd/postscript/postdmd/postdmd.1 +++ /dev/null @@ -1,206 +0,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 -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) 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) diff --git a/sys/src/cmd/postscript/postio/postio.1 b/sys/src/cmd/postscript/postio/postio.1 deleted file mode 100644 index 3075951b7..000000000 --- a/sys/src/cmd/postscript/postio/postio.1 +++ /dev/null @@ -1,308 +0,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) diff --git a/sys/src/cmd/postscript/postio/postio.1.man b/sys/src/cmd/postscript/postio/postio.1.man new file mode 100644 index 000000000..3075951b7 --- /dev/null +++ b/sys/src/cmd/postscript/postio/postio.1.man @@ -0,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) diff --git a/sys/src/cmd/postscript/postmd/postmd.1 b/sys/src/cmd/postscript/postmd/postmd.1 deleted file mode 100644 index fb67d969e..000000000 --- a/sys/src/cmd/postscript/postmd/postmd.1 +++ /dev/null @@ -1,330 +0,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 -Print -.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 -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 \-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) diff --git a/sys/src/cmd/postscript/postmd/postmd.1.man b/sys/src/cmd/postscript/postmd/postmd.1.man new file mode 100644 index 000000000..fb67d969e --- /dev/null +++ b/sys/src/cmd/postscript/postmd/postmd.1.man @@ -0,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 +Print +.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 +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 \-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) diff --git a/sys/src/cmd/postscript/trofftable/trofftable.1 b/sys/src/cmd/postscript/trofftable/trofftable.1 deleted file mode 100644 index 031e2ed04..000000000 --- a/sys/src/cmd/postscript/trofftable/trofftable.1 +++ /dev/null @@ -1,164 +0,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) diff --git a/sys/src/cmd/postscript/trofftable/trofftable.1.man b/sys/src/cmd/postscript/trofftable/trofftable.1.man new file mode 100644 index 000000000..031e2ed04 --- /dev/null +++ b/sys/src/cmd/postscript/trofftable/trofftable.1.man @@ -0,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) -- cgit v1.2.3