summaryrefslogtreecommitdiffstats
path: root/man4
diff options
context:
space:
mode:
authorAlejandro Colomar <alx@kernel.org>2022-10-23 17:43:43 +0200
committerAlejandro Colomar <alx@kernel.org>2022-10-29 23:51:10 +0200
commit4279e42dd98a11b31fa4e1fcebbb00b7a677bb70 (patch)
tree68afd1d743f86e186dafa44c0376ee1861e2146a /man4
parent2ff309be8a6205bdb3412f7fb563ba2252d9c636 (diff)
Many pages: Use .TP for tagged paragraphs
Reported-by: Mike Frysinger <vapier@gentoo.org> Cc: <groff@gnu.org> Acked-by: Douglas McIlroy <douglas.mcilroy@dartmouth.edu> Signed-off-by: Alejandro Colomar <alx@kernel.org>
Diffstat (limited to 'man4')
-rw-r--r--man4/dsp56k.415
-rw-r--r--man4/fd.454
-rw-r--r--man4/lp.430
-rw-r--r--man4/st.411
4 files changed, 73 insertions, 37 deletions
diff --git a/man4/dsp56k.4 b/man4/dsp56k.4
index fdd7db974..7aa324b7d 100644
--- a/man4/dsp56k.4
+++ b/man4/dsp56k.4
@@ -46,14 +46,16 @@ The following
.BR ioctl (2)
calls are used to control the
\fIdsp56k\fP device:
-.IP \fBDSP56K_UPLOAD\fP
+.TP
+.B DSP56K_UPLOAD
resets the DSP56001 and uploads a program.
The third
.BR ioctl (2)
argument must be a pointer to a \fIstruct dsp56k_upload\fP with members
\fIbin\fP pointing to a DSP56001 binary program, and \fIlen\fP set to
the length of the program, counted in 24-bit words.
-.IP \fBDSP56K_SET_TX_WSIZE\fP
+.TP
+.B DSP56K_SET_TX_WSIZE
sets the transmit word size.
Allowed values are in the range 1 to 4,
and is the number of bytes that will be sent at a time to the
@@ -61,14 +63,16 @@ DSP56001.
These data quantities will either be padded with bytes containing zero,
or truncated to fit the native 24-bit data format of the
DSP56001.
-.IP \fBDSP56K_SET_RX_WSIZE\fP
+.TP
+.B DSP56K_SET_RX_WSIZE
sets the receive word size.
Allowed values are in the range 1 to 4,
and is the number of bytes that will be received at a time from the
DSP56001.
These data quantities will either truncated, or padded with
a null byte (\(aq\e0\(aq) to fit the native 24-bit data format of the DSP56001.
-.IP \fBDSP56K_HOST_FLAGS\fP
+.TP
+.B DSP56K_HOST_FLAGS
read and write the host flags.
The host flags are four
general-purpose bits that can be read by both the hosting computer and
@@ -85,7 +89,8 @@ If bit 0 or 1 is set in the
to the host flags.
The state of all host flags will be returned in
the lower four bits of the \fIstatus\fP member.
-.IP \fBDSP56K_HOST_CMD\fP
+.TP
+.B DSP56K_HOST_CMD
sends a host command.
Allowed values are in the range 0 to 31, and is a
user-defined command handled by the program running in the DSP56001.
diff --git a/man4/fd.4 b/man4/fd.4
index 7172d1f6b..1ffe833d2 100644
--- a/man4/fd.4
+++ b/man4/fd.4
@@ -126,58 +126,76 @@ _
The following
.BR ioctl (2)
calls are supported by \fBfd\fP devices:
-.IP \fBFDCLRPRM\fP
+.TP
+.B FDCLRPRM
clears the media information of a drive (geometry of disk in drive).
-.IP \fBFDSETPRM\fP
+.TP
+.B FDSETPRM
sets the media information of a drive.
The media information will be
lost when the media is changed.
-.IP \fBFDDEFPRM\fP
+.TP
+.B FDDEFPRM
sets the media information of a drive (geometry of disk in drive).
The media information will not be lost when the media is changed.
This will disable autodetection.
In order to reenable autodetection, you
have to issue an \fBFDCLRPRM\fP.
-.IP \fBFDGETDRVTYP\fP
+.TP
+.B FDGETDRVTYP
returns the type of a drive (name parameter).
For formats which work
in several drive types, \fBFDGETDRVTYP\fP returns a name which is
appropriate for the oldest drive type which supports this format.
-.IP \fBFDFLUSH\fP
+.TP
+.B FDFLUSH
invalidates the buffer cache for the given drive.
-.IP \fBFDSETMAXERRS\fP
+.TP
+.B FDSETMAXERRS
sets the error thresholds for reporting errors, aborting the operation,
recalibrating, resetting, and reading sector by sector.
-.IP \fBFDSETMAXERRS\fP
+.TP
+.B FDSETMAXERRS
gets the current error thresholds.
-.IP \fBFDGETDRVTYP\fP
+.TP
+.B FDGETDRVTYP
gets the internal name of the drive.
-.IP \fBFDWERRORCLR\fP
+.TP
+.B FDWERRORCLR
clears the write error statistics.
-.IP \fBFDWERRORGET\fP
+.TP
+.B FDWERRORGET
reads the write error statistics.
These include the total number of
write errors, the location and disk of the first write error, and the
location and disk of the last write error.
Disks are identified by a
generation number which is incremented at (almost) each disk change.
-.IP \fBFDTWADDLE\fP
+.TP
+.B FDTWADDLE
Switch the drive motor off for a few microseconds.
This might be
needed in order to access a disk whose sectors are too close together.
-.IP \fBFDSETDRVPRM\fP
+.TP
+.B FDSETDRVPRM
sets various drive parameters.
-.IP \fBFDGETDRVPRM\fP
+.TP
+.B FDGETDRVPRM
reads these parameters back.
-.IP \fBFDGETDRVSTAT\fP
+.TP
+.B FDGETDRVSTAT
gets the cached drive state (disk changed, write protected et al.)
-.IP \fBFDPOLLDRVSTAT\fP
+.TP
+.B FDPOLLDRVSTAT
polls the drive and return its state.
-.IP \fBFDGETFDCSTAT\fP
+.TP
+.B FDGETFDCSTAT
gets the floppy controller state.
-.IP \fBFDRESET\fP
+.TP
+.B FDRESET
resets the floppy controller under certain conditions.
-.IP \fBFDRAWCMD\fP
+.TP
+.B FDRAWCMD
sends a raw command to the floppy controller.
.PP
For more precise information, consult also the \fI<linux/fd.h>\fP and
diff --git a/man4/lp.4 b/man4/lp.4
index a96aff6ed..edbef79f0 100644
--- a/man4/lp.4
+++ b/man4/lp.4
@@ -29,7 +29,8 @@ The default is polling.
The following
.BR ioctl (2)
calls are supported:
-.IP "\fBint ioctl(int \fP\fIfd\fP\fB, LPTIME, int \fP\fIarg\fP\fB)\fP"
+.TP
+.BR "int ioctl(int " fd ", LPTIME, int " arg )
Sets the amount of time that the driver sleeps before rechecking the printer
when the printer's buffer appears to be filled to
.IR arg .
@@ -38,7 +39,8 @@ if you have a slow printer, then increase it.
This is in hundredths of a second, the default 2
being 0.02 seconds.
It influences only the polling driver.
-.IP "\fBint ioctl(int \fP\fIfd\fP\fB, LPCHAR, int \fP\fIarg\fP\fB)\fP"
+.TP
+.BR "int ioctl(int " fd ", LPCHAR, int " arg )
Sets the maximum number of busy-wait iterations which the polling driver does
while waiting for the printer to get ready for receiving a character to
.IR arg .
@@ -46,26 +48,30 @@ If printing is too slow, increase this number; if the
system gets too slow, decrease this number.
The default is 1000.
It influences only the polling driver.
-.IP "\fBint ioctl(int \fP\fIfd\fP\fB, LPABORT, int \fP\fIarg\fP\fB)\fP"
+.TP
+.BR "int ioctl(int " fd ", LPABORT, int " arg )
If
.I arg
is 0, the printer driver will retry on errors, otherwise
it will abort.
The default is 0.
-.IP "\fBint ioctl(int \fP\fIfd\fP\fB, LPABORTOPEN, int \fP\fIarg\fP\fB)\fP"
+.TP
+.BR "int ioctl(int " fd ", LPABORTOPEN, int " arg )
If
.I arg
is 0,
.BR open (2)
will be aborted on error, otherwise error will be ignored.
The default is to ignore it.
-.IP "\fBint ioctl(int \fP\fIfd\fP\fB, LPCAREFUL, int \fP\fIarg\fP\fB)\fP"
+.TP
+.BR "int ioctl(int " fd ", LPCAREFUL, int " arg )
If
.I arg
is 0, then the out-of-paper, offline, and error signals are
required to be false on all writes, otherwise they are ignored.
The default is to ignore them.
-.IP "\fBint ioctl(int \fP\fIfd\fP\fB, LPWAIT, int \fP\fIarg\fP\fB)\fP"
+.TP
+.BR "int ioctl(int " fd ", LPWAIT, int " arg )
Sets the number of busy waiting iterations to wait before strobing the
printer to accept a just-written character, and the number of iterations to
wait before turning the strobe off again,
@@ -77,7 +83,8 @@ already enough.
For that reason, the default value is 0.
.\" FIXME . Actually, since Linux 2.2, the default is 1
This is used for both the polling and the interrupt driver.
-.IP "\fBint ioctl(int \fP\fIfd\fP\fB, LPSETIRQ, int \fP\fIarg\fP\fB)\fP"
+.TP
+.BR "int ioctl(int " fd ", LPSETIRQ, int " arg )
This
.BR ioctl (2)
requires superuser privileges.
@@ -88,10 +95,12 @@ As a side effect, the printer will be reset.
When
.I arg
is 0, the polling driver will be used, which is also default.
-.IP "\fBint ioctl(int \fP\fIfd\fP\fB, LPGETIRQ, int *\fP\fIarg\fP\fB)\fP"
+.TP
+.BR "int ioctl(int " fd ", LPGETIRQ, int *" arg )
Stores the currently used IRQ in
.IR arg .
-.IP "\fBint ioctl(int \fP\fIfd\fP\fB, LPGETSTATUS, int *\fP\fIarg\fP\fB)\fP"
+.TP
+.BR "int ioctl(int " fd ", LPGETSTATUS, int *" arg )
Stores the value of the status port in
.IR arg .
The bits have the following meaning:
@@ -106,7 +115,8 @@ LP_PERRORP unchanged error input, active low
.IP
Refer to your printer manual for the meaning of the signals.
Note that undocumented bits may also be set, depending on your printer.
-.IP "\fBint ioctl(int \fP\fIfd\fP\fB, LPRESET)\fP"
+.TP
+.BR "int ioctl(int " fd ", LPRESET)"
Resets the printer.
No argument is used.
.SH FILES
diff --git a/man4/st.4 b/man4/st.4
index 9ce9ac630..de926bd9b 100644
--- a/man4/st.4
+++ b/man4/st.4
@@ -410,18 +410,21 @@ Booleans counted as one item.)
A value having zeros in the high-order 4 bits will be used to set the
drive's buffering mode.
The buffering modes are:
-.RS 12
-.IP 0 4
+.RS
+.TP
+.B 0
The drive will not report
.B GOOD
status on write commands until the data
blocks are actually written to the medium.
-.IP 1
+.TP
+.B 1
The drive may report
.B GOOD
status on write commands as soon as all the
data has been transferred to the drive's internal buffer.
-.IP 2
+.TP
+.B 2
The drive may report
.B GOOD
status on write commands as soon as (a) all