-.TH PAPSTATUS 8 "17 Dec 1991"
-.SH NAME
-papstatus \- get the status of an AppleTalk-connected printer
-.SH SYNOPSIS
-.B :SBINDIR:/papstatus
-[
-.BI -d
-] [
-.B -p
-.I printer
-] [
-.I retrytime
-]
-.SH DESCRIPTION
-.B papstatus
-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.
-.LP
+'\" t
+.\" Title: papstatus
+.\" 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 "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"
+.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,
-.B papstatus
+\fBpapstatus\fR
looks for a file called
-.B .paprc
-in the current directory and reads it to obtain the name of a printer. The
-.B .paprc
+\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
-.IB object : \c
-.IB type @ \c
-.I zone
+\fIobject\fR\fB:\fR\fItype\fR\fB@\fR\fIzone\fR
where each of
-.IR object ,
-.BI : type ,
+\fIobject\fR,
+\fB:\fR\fItype\fR\fB,\fR
and
-.BI @ zone
-are optional.
-.I type
+\fB@\fR\fIzone\fR
+are optional\&.
+\fItype\fR
and
-.I zone
-must be proceeded by
-.RB ` : '
+\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
-.RB ` @ '
-respectively. Blank lines and lines the begin with a
-.RB ` # '
-are ignored.
-.I type
-and
-.I zone
+\fIzone\fR
default to
-.B LaserWriter
-and the zone of the local host, respectively.
-.SH OPTIONS
-.TP
-.B -d
-Turns on a debugging mode that prints some extra information to standard error.
-.HP
-.B -p
-.I printer
-.br
+\fBLaserWriter\fR
+and the zone of the local host, respectively\&.
+.SH "OPTIONS"
+.PP
+\fB\-d\fR
+.RS 4
+Turns on a debugging mode that prints some extra information to standard error\&.
+.RE
+.PP
+\fB\-p\fR \fIprinter\fR
+.RS 4
Get status from
-.I printer
+\fIprinter\fR
(do not consult any
-.B .paprc
-files to find a printer name). The syntax for
-.I printer
+\fB\&.paprc\fR
+files to find a printer name)\&. The syntax for
+\fIprinter\fR
is the same as discussed above for the
-.B .paprc
-file.
-.TP
-.I retrytime
+\fB\&.paprc\fR
+file\&.
+.RE
+.PP
+\fIretrytime\fR
+.RS 4
Normally,
-.B papstatus
-only gets the status from the printer once. If
-.I retrytime
+\fBpapstatus\fR
+only gets the status from the printer once\&. If
+\fIretrytime\fR
is specified, the status is obtained repeatedly, with a sleep of
-.I retrytime
-seconds between inquiring the printer.
-.SH FILES
-.TP 20
-.B .paprc
+\fIretrytime\fR
+seconds between inquiring the printer\&.
+.RE
+.SH "FILES"
+.PP
+\fB\&.paprc\fR
+.RS 4
file that contains printer name
-.SH SEE ALSO
-.BR nbp (1),
-.BR pap (8)
+.RE
+.SH "SEE ALSO"
+.PP
+\fBnbp\fR(1),
+\fBpap\fR(1)
projects / netatalk.git / blobdiff