X-Git-Url: https://arthur.barton.de/cgi-bin/gitweb.cgi?a=blobdiff_plain;f=man%2Fman8%2Fpsf.8.tmpl;h=b53d5adefef19bee0d4aaf74df36e191e66a347f;hb=refs%2Ftags%2Fnetatalk-2-1-beta1;hp=57b58b40a372aafe0dbd82315e4c03a3c5aae5e4;hpb=ecfc96169ab669b578e53fa8e13592934fe37788;p=netatalk.git diff --git a/man/man8/psf.8.tmpl b/man/man8/psf.8.tmpl index 57b58b40..b53d5ade 100644 --- a/man/man8/psf.8.tmpl +++ b/man/man8/psf.8.tmpl @@ -1,72 +1,115 @@ -.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 +.\" 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 -\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)\&.