X-Git-Url: https://arthur.barton.de/cgi-bin/gitweb.cgi?a=blobdiff_plain;f=man%2Fman8%2Fpapstatus.8.tmpl;h=ad4b6fbde4b9c17f8391140b3f56247a05ae55e0;hb=5d553a87713c1f9568a9bb6b4a942bbec3802ad2;hp=ee33f1143a61a8a587d91e2b01b4279f9ca77408;hpb=ecfc96169ab669b578e53fa8e13592934fe37788;p=netatalk.git diff --git a/man/man8/papstatus.8.tmpl b/man/man8/papstatus.8.tmpl index ee33f114..ad4b6fbd 100644 --- a/man/man8/papstatus.8.tmpl +++ b/man/man8/papstatus.8.tmpl @@ -1,46 +1,94 @@ -.TH papstatus 8 "17 Dec 1991" 2.0.0 Netatalk -.SH NAME +'\" t +.\" Title: papstatus +.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] +.\" Generator: DocBook XSL Stylesheets v1.75.2 +.\" Date: 17 Dec 1991 +.\" Manual: Netatalk 2.1 +.\" Source: Netatalk 2.1 +.\" Language: English +.\" +.TH "PAPSTATUS" "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" papstatus \- get the status of an AppleTalk\-connected printer -.SH SYNOPSIS -\fB:SBINDIR:/papstatus\fR [\-d] [ \-p \fBprinter\fR ] [\fBretrytime\fR] -.SH DESCRIPTION -\fIpapstatus\fR is used to obtain the -current status message from an AppleTalk connected printer. It uses the -Printer Access Protocol (PAP) to obtain the status information. +.SH "SYNOPSIS" +.HP \w'\fB:SBINDIR:/papstatus\fR\fB\fR\ 'u +\fB:SBINDIR:/papstatus\fR\fB\fR [\-d] [\-p\ \fIprinter\fR] [\fIretrytime\fR] +.SH "DESCRIPTION" +.PP +\fBpapstatus\fR +is used to obtain the current status message from an AppleTalk connected printer\&. It uses the Printer Access Protocol (PAP) to obtain the status information\&. +.PP +If no printer is specified on the command line, +\fBpapstatus\fR +looks for a file called +\fB\&.paprc\fR +in the current directory and reads it to obtain the name of a printer\&. The +\fB\&.paprc\fR +file should contain a single line of the form +\fIobject\fR\fB:\fR\fItype\fR\fB@\fR\fIzone\fR +where each of +\fIobject\fR, +\fB:\fR\fItype\fR\fB,\fR +and +\fB@\fR\fIzone\fR +are optional\&. +\fItype\fR +and +\fIzone\fR +must be proceeded by `\fB:\fR\' and `\fB@\fR\' respectively\&. Blank lines and lines the begin with a `\fB#\fR\' are ignored\&. +\fItype\fR +and +\fIzone\fR +default to +\fBLaserWriter\fR +and the zone of the local host, respectively\&. +.SH "OPTIONS" .PP -If no printer is specified on the command line, \fIpapstatus\fR -looks for a file called .paprc in the current directory -and reads it to obtain the name of a printer. The .paprc -file should contain a single line of the form \fIobject\fR\fI:\fR\fI\fR\fItype\fR\fI@\fR\fI\fR\fIzone\fR -where each of \fIobject\fR, \fI:\fR\fItype\fR\fI,\fR and \fI@\fR\fIzone\fR are optional. -\fItype\fR and \fIzone\fR -must be proceeded by `\fI:\fR' and `\fI@\fR' respectively. Blank lines and lines the begin -with a `\fI#\fR' are ignored. \fItype\fR and \fIzone\fR default -to \fILaserWriter\fR and the zone of the local -host, respectively. -.SH OPTIONS -.TP \fB\-d\fR -Turns on a debugging mode that prints some extra information -to standard error. -.TP +.RS 4 +Turns on a debugging mode that prints some extra information to standard error\&. +.RE +.PP \fB\-p\fR \fIprinter\fR -Get status from \fIprinter\fR (do not -consult any .paprc files to find a printer name). -The syntax for \fIprinter\fR is the same as -discussed above for the .paprc file. -.TP +.RS 4 +Get status from +\fIprinter\fR +(do not consult any +\fB\&.paprc\fR +files to find a printer name)\&. The syntax for +\fIprinter\fR +is the same as discussed above for the +\fB\&.paprc\fR +file\&. +.RE +.PP +\fIretrytime\fR +.RS 4 +Normally, +\fBpapstatus\fR +only gets the status from the printer once\&. If \fIretrytime\fR -Normally, \fIpapstatus\fR only gets -the status from the printer once. If \fIretrytime\fR is specified, the status is obtained repeatedly, with a sleep of -\fIretrytime\fR seconds between inquiring -the printer. -.SH FILES -.TP -\&.paprc +\fIretrytime\fR +seconds between inquiring the printer\&. +.RE +.SH "FILES" +.PP +\fB\&.paprc\fR +.RS 4 file that contains printer name +.RE .SH "SEE ALSO" +.PP \fBnbp\fR(1), \fBpap\fR(1) -