-.TH psf 8 "17 Dec 1991" 2.0.0 Netatalk
-.SH NAME
+'\" t
+.\" Title: psf
+.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author]
+.\" Generator: DocBook XSL Stylesheets v1.74.3 <http://docbook.sf.net/>
+.\" Date: 17 Dec 1991
+.\" Manual: Netatalk 2.1beta
+.\" Source: Netatalk 2.1beta
+.\" Language: English
+.\"
+.TH "PSF" "8" "17 Dec 1991" "Netatalk 2.1beta" "Netatalk 2.1beta"
+.\" -----------------------------------------------------------------
+.\" * set default formatting
+.\" -----------------------------------------------------------------
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.\" -----------------------------------------------------------------
+.\" * MAIN CONTENT STARTS HERE *
+.\" -----------------------------------------------------------------
+.SH "NAME"
psf \- PostScript filter
-.SH SYNOPSIS
-\fBpsf\fR [ \-n \fBname\fR ] [ \-h \fBhost\fR ] [ \-w \fBwidth\fR ] [ \-l \fBlength\fR ] [ \-i \fBindent\fR ] [\-c]
-.SH DESCRIPTION
-psf is an \fIlpd\fR
-filter for PostScript printing. psf interprets the name
-it was called with to determine what filters to invoke. First, if the
-string ``pap'' appears anywhere in the name, psf
-invokes \fIpap\fR to talk to a printer via
-AppleTalk. Next, if the string ``rev'' appears,
-psf invokes \fIpsorder\fR to
-reverse the pages of the job. Finally, if psf was
-called with a filter's name as the leading string, it invokes that
-filter. If there is no filter to run, psf examines the
-magic number of the input, and if the input is not PostScript, converts it
-to PostScript.
-.SH KLUDGE
-In the default configuration, psf supports two
-kludges. The first causes psf to check its name for the
-letter `m'. If this letter is found and accounting is turned on,
-psf calls \fIpap\fR twice,
-once to get an initial page count and to print the job, and another time
-to get a final page count. This is a work\-around for bugs in a variety of
-PAP implementions that cause printers to never properly close the PAP
-output file. A notable example is any printer by Hewlett\-Packard.
+.SH "SYNOPSIS"
+.HP \w'\fBpsf\fR\fB\fR\ 'u
+\fBpsf\fR\fB\fR [\-n\ \fIname\fR] [\-h\ \fIhost\fR] [\-w\ \fIwidth\fR] [\-l\ \fIlength\fR] [\-i\ \fIindent\fR] [\-c]
+.SH "DESCRIPTION"
.PP
-The second kludge causes psf to examine its name
-for the letter `w'. If this letter is found and accounting is turned
-on, psf calls \fIpap\fR with
-the \fB\-w\fR flag. This flag causes \fIpap\fR
-to wait until the printer's status contains the string `idle'.
-Once this string is found, the job is printed as normal. This kludge is a
-work\-around for printers, notably Hewlett\-Packard's LaserJet IV, which
-will report a page count while a previous jobs is still printing.
-.SH EXAMPLE
-The sample \fIprintcap\fR entry below
-invokes psf to print text files, PostScript files,
-\fItroff\fR's C/A/T output, and \fITeX\fR's DVI output, to an AppleTalk connected
-LaserWriter Plus. Since the LaserWriter Plus stacks pages in descending
-order, we reverse the pages and print the burst page last.
+\fBpsf\fR
+is an
+\fBlpd\fR
+filter for PostScript printing\&.
+\fBpsf\fR
+interprets the name it was called with to determine what filters to invoke\&. First, if the string ``pap\'\' appears anywhere in the name,
+\fBpsf\fR
+invokes
+\fBpap\fR
+to talk to a printer via AppleTalk\&. Next, if the string ``rev\'\' appears,
+\fBpsf\fR
+invokes
+\fBpsorder\fR
+to reverse the pages of the job\&. Finally, if
+\fBpsf\fR
+was called with a filter\'s name as the leading string, it invokes that filter\&. If there is no filter to run,
+\fBpsf\fR
+examines the magic number of the input, and if the input is not PostScript, converts it to PostScript\&.
+.SH "KLUDGE"
.PP
+In the default configuration,
+\fBpsf\fR
+supports two kludges\&. The first causes
+\fBpsf\fR
+to check its name for the letter `m\'\&. If this letter is found and accounting is turned on,
+\fBpsf\fR
+calls
+\fBpap\fR
+twice, once to get an initial page count and to print the job, and another time to get a final page count\&. This is a work\-around for bugs in a variety of PAP implementions that cause printers to never properly close the PAP output file\&. A notable example is any printer by Hewlett\-Packard\&.
+.PP
+The second kludge causes
+\fBpsf\fR
+to examine its name for the letter `w\'\&. If this letter is found and accounting is turned on,
+\fBpsf\fR
+calls
+\fBpap\fR
+with the
+\fB\-w\fR
+flag\&. This flag causes
+\fBpap\fR
+to wait until the printer\'s status contains the string `idle\'\&. Once this string is found, the job is printed as normal\&. This kludge is a work\-around for printers, notably Hewlett\-Packard\'s LaserJet IV, which will report a page count while a previous jobs is still printing\&.
+.SH "EXAMPLE"
+.PP
+The sample
+\fBprintcap\fR
+entry below invokes
+\fBpsf\fR
+to print text files, PostScript files,
+\fBtroff\fR\'s C/A/T output, and
+\fBTeX\fR\'s DVI output, to an AppleTalk connected LaserWriter Plus\&. Since the LaserWriter Plus stacks pages in descending order, we reverse the pages and print the burst page last\&.
+.sp
+.if n \{\
+.RS 4
+.\}
.nf
-
-laser|lp|LaserWriter Plus on AppleTalk:\\
- :sd=/usr/spool/lpd/laser:\\
- :lp=/usr/spool/lpd/laser/null:\\
- :lf=/var/adm/lpd\-errs:pw#80:hl:\\
- :of=:LIBEXECDIR:/ofpap:\\
- :if=:LIBEXECDIR:/ifpaprev:\\
- :tf=:LIBEXECDIR:/tfpaprev:\\
+laser|lp|LaserWriter Plus on AppleTalk:\e
+ :sd=/usr/spool/lpd/laser:\e
+ :lp=/usr/spool/lpd/laser/null:\e
+ :lf=/var/adm/lpd\-errs:pw#80:hl:\e
+ :of=:LIBEXECDIR:/ofpap:\e
+ :if=:LIBEXECDIR:/ifpaprev:\e
+ :tf=:LIBEXECDIR:/tfpaprev:\e
:df=:LIBEXECDIR:/dfpaprev:
.fi
+.if n \{\
+.RE
+.\}
.PP
-Note that if the host in question spools to more than one AppleTalk
-printer, \fB/dev/null\fR should not be used for the
-\fIlp\fR capability. Instead, a null device
-should be created with \fImknod\fR for each
-printer, as has been done above.
+Note that if the host in question spools to more than one AppleTalk printer,
+/dev/null
+should not be used for the
+\fBlp\fR
+capability\&. Instead, a null device should be created with
+\fBmknod\fR
+for each printer, as has been done above\&.
.PP
Finally, there is a file in the spool directory,
-\fB/var/spool/lpd/laser\fR, called .paprc,
-which \fIpap\fR reads for the AppleTalk name of
-the printer.
+/var/spool/lpd/laser, called
+\fB\&.paprc\fR, which
+\fBpap\fR
+reads for the AppleTalk name of the printer\&.
.SH "SEE ALSO"
+.PP
\fBpsorder\fR(1),
\fBprintcap\fR(5),
\fBlpd\fR(1),
\fBmknod\fR(1),
-\fBpap\fR(1).
-
+\fBpap\fR(1)\&.
projects / netatalk.git / blobdiff