-.TH PSF 8 "17 Dec 1991" "netatalk 1.2"
-.SH NAME
+'\" t
+.\" Title: psf
+.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author]
+.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
+.\" Date: 17 Dec 1991
+.\" Manual: Netatalk 2.1
+.\" Source: Netatalk 2.1
+.\" Language: English
+.\"
+.TH "PSF" "8" "17 Dec 1991" "Netatalk 2.1" "Netatalk 2.1"
+.\" -----------------------------------------------------------------
+.\" * 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
-.B psf
-[
-.B -n
-.I name
-] [
-.B -h
-.I host
-] [
-.B -w
-.I width
-] [
-.B -l
-.I length
-] [
-.B -i
-.I indent
-] [
-.B -c
-]
-.SH DESCRIPTION
-.B psf
+.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
+\fBpsf\fR
is an
-.B lpd
-filter for PostScript printing.
-.B psf
-interprets the name it was called with to determine what filters to
-invoke. First, if the string ``pap'' appears anywhere in the name,
-.B psf
+\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
-.B pap
-to talk to a printer via AppleTalk. Next, if the string ``rev'' appears,
-.B psf
+\fBpap\fR
+to talk to a printer via AppleTalk\&. Next, if the string ``rev\'\' appears,
+\fBpsf\fR
invokes
-.B psorder
-to reverse the pages of the job. Finally, if
-.B psf
-was called with a filter's name as the leading string, it invokes that
-filter. If there is no filter to run,
-.B psf
-examines the magic number of the input, and if the input is not
-PostScript, converts it to PostScript.
-.SH KLUDGE
+\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,
-.B psf
-supports two kludges. The first causes
-.B psf
-to check its name for the letter `m'. If this letter is found and accounting
-is turned on,
-.B psf
+\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
-.B pap
-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.
-.LP
+\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
-.B psf
-to examine its name for the letter `w'. If this letter is found and
-accounting is turned on,
-.B psf
+\fBpsf\fR
+to examine its name for the letter `w\'\&. If this letter is found and accounting is turned on,
+\fBpsf\fR
calls
-.B pap
+\fBpap\fR
with the
-.B \-w
-flag. This flag causes
-.B pap
-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
+\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
-.B printcap
+\fBprintcap\fR
entry below invokes
-.B psf
+\fBpsf\fR
to print text files, PostScript files,
-.BR troff 's
-C/A/T output, and
-.BR TeX '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.
+\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
-.RS
+.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
-.sp
-Note that if the host in question spools to more than one AppleTalk
-printer,
-.B /dev/null
+.\}
+.PP
+Note that if the host in question spools to more than one AppleTalk printer,
+/dev/null
should not be used for the
-.B lp
-capability. Instead, a null device should be created with
-.B mknod
-for each printer, as has been done above.
-.LP
+\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,
-.BR /var/spool/lpd/laser ,
-called
-.BR .paprc ,
-which
-.B pap
-reads for the AppleTalk name of the printer.
-.SH SEE ALSO
-.BR psorder (1),
-.BR printcap (5),
-.BR lpd (8),
-.BR mknod (8),
-.BR pap (8).
+/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)\&.
projects / netatalk.git / blobdiff