diff mbox series

aplay.1: Some remarks and editorial changes for this man page

Message ID 173273656524.5040.9496359435651431008.reportbug@kassi.invalid.is (mailing list archive)
State New
Headers show
Series aplay.1: Some remarks and editorial changes for this man page | expand

Commit Message

Bjarni Ingi Gislason Nov. 27, 2024, 7:47 p.m. UTC
Package: alsa-utils
Version: 1.2.12-1 (Debian testing)
Severity: minor
Tags: patch

   * What led up to the situation?

     Checking for defects with

test-[g|n]roff -mandoc -t -K utf8 -rF0 -rHY=0 -ww -b -z < "man page"

  [Use "groff -e ' $' <file>" to find trailing spaces.]

  ["test-groff" is a script in the repository for "groff"; is not shipped]
(local copy and "troff" slightly changed by me).

  [The fate of "test-nroff" was decided in groff bug #55941.]

   * What was the outcome of this action?


troff: backtrace: file '<stdin>':3
troff:<stdin>:3: warning: trailing space in the line
troff: backtrace: file '<stdin>':87
troff:<stdin>:87: warning: trailing space in the line
troff: backtrace: file '<stdin>':91
troff:<stdin>:91: warning: trailing space in the line
troff: backtrace: file '<stdin>':95
troff:<stdin>:95: warning: trailing space in the line
troff: backtrace: file '<stdin>':99
troff:<stdin>:99: warning: trailing space in the line
troff: backtrace: file '<stdin>':103
troff:<stdin>:103: warning: trailing space in the line
troff: backtrace: file '<stdin>':107
troff:<stdin>:107: warning: trailing space in the line
troff: backtrace: file '<stdin>':111
troff:<stdin>:111: warning: trailing space in the line
troff: backtrace: file '<stdin>':114
troff:<stdin>:114: warning: trailing space in the line
troff: backtrace: file '<stdin>':115
troff:<stdin>:115: warning: trailing space in the line
troff: backtrace: file '<stdin>':118
troff:<stdin>:118: warning: trailing space in the line
troff: backtrace: file '<stdin>':121
troff:<stdin>:121: warning: trailing space in the line
troff: backtrace: file '<stdin>':131
troff:<stdin>:131: warning: trailing space in the line
troff: backtrace: file '<stdin>':215
troff:<stdin>:215: warning: trailing space in the line
troff: backtrace: file '<stdin>':225
troff:<stdin>:225: warning: trailing space in the line
troff: backtrace: file '<stdin>':258
troff:<stdin>:258: warning: trailing space in the line

   * What outcome did you expect instead?

     No output (no warnings).

-.-

  General remarks and further material, if a diff-file exist, are in the
attachments.


-- System Information:
Debian Release: trixie/sid
  APT prefers testing
  APT policy: (500, 'testing')
Architecture: amd64 (x86_64)

Kernel: Linux 6.11.9-amd64 (SMP w/2 CPU threads; PREEMPT)
Locale: LANG=is_IS.iso88591, LC_CTYPE=is_IS.iso88591 (charmap=ISO-8859-1), LANGUAGE not set
Shell: /bin/sh linked to /usr/bin/dash
Init: sysvinit (via /sbin/init)

Versions of packages alsa-utils depends on:
ii  kmod              33+20240816-2
ii  libasound2t64     1.2.12-1+b1
ii  libatopology2t64  1.2.12-1+b1
ii  libc6             2.40-3
ii  libfftw3-single3  3.3.10-1+b3
ii  libncursesw6      6.5-2+b1
ii  libsamplerate0    0.2.2-4+b2
ii  libtinfo6         6.5-2+b1

alsa-utils recommends no packages.

Versions of packages alsa-utils suggests:
pn  dialog  <none>

-- no debconf information
Input file is aplay.1

  Any program (person), that produces man pages, should check the output
for defects by using (both groff and nroff)

[gn]roff -mandoc -t -ww -b -z -K utf8  <man page>

  The same goes for man pages that are used as an input.

  For a style guide use

  mandoc -T lint

-.-

  So any 'generator' should check its products with the above mentioned
'groff', 'mandoc',  and additionally with 'nroff ...'.

  This is just a simple quality control measure.

  The 'generator' may have to be corrected to get a better man page,
the source file may, and any additional file may.

  Common defects:

  Input text line longer than 80 bytes.

  Not removing trailing spaces (in in- and output).
  The reason for these trailing spaces should be found and eliminated.

  Not beginning each input sentence on a new line.
Lines should thus be shorter.

  See man-pages(7), item 'semantic newline'.

-.-

The difference between the formatted output of the original and patched file
can be seen with:

  nroff -mandoc <file1> > <out1>
  nroff -mandoc <file2> > <out2>
  diff -u <out1> <out2>

and for groff, using

"printf '%s\n%s\n' '.kern 0' '.ss 12 0' | groff -mandoc -Z - "

instead of 'nroff -mandoc'

  Add the option '-t', if the file contains a table.

  Read the output of 'diff -u' with 'less -R' or similar.

-.-.

  If 'man' (man-db) is used to check the manual for warnings,
the following must be set:

  The option "-warnings=w"

  The environmental variable:

export MAN_KEEP_STDERR=yes (or any non-empty value)

  or

  (produce only warnings):

export MANROFFOPT="-ww -b -z"

export MAN_KEEP_STDERR=yes (or any non-empty value)


-.-.

Output from "mandoc -T lint  aplay.1 ": (shortened list)

      9 input text line longer than 80 bytes
     16 whitespace at end of input line

-.-.

Output from "test-groff -mandoc -t -ww -b -z aplay.1 ": (shortened list)

     16 trailing space in the line

-.-.

Output from "mandoc -T lint  aplay.1 ":

mandoc: aplay.1:3:67: STYLE: whitespace at end of input line
mandoc: aplay.1:20:119: STYLE: input text line longer than 80 bytes: If filename is not s...
mandoc: aplay.1:78:111: STYLE: input text line longer than 80 bytes: The default is zero,...
mandoc: aplay.1:84:112: STYLE: input text line longer than 80 bytes: The default is zero,...
mandoc: aplay.1:87:31: STYLE: whitespace at end of input line
mandoc: aplay.1:91:33: STYLE: whitespace at end of input line
mandoc: aplay.1:92:101: STYLE: input text line longer than 80 bytes: Open the audio devic...
mandoc: aplay.1:93:91: STYLE: input text line longer than 80 bytes: If this option is no...
mandoc: aplay.1:95:34: STYLE: whitespace at end of input line
mandoc: aplay.1:97:87: STYLE: input text line longer than 80 bytes: If no period time an...
mandoc: aplay.1:99:34: STYLE: whitespace at end of input line
mandoc: aplay.1:101:114: STYLE: input text line longer than 80 bytes: If no buffer time an...
mandoc: aplay.1:103:29: STYLE: whitespace at end of input line
mandoc: aplay.1:105:87: STYLE: input text line longer than 80 bytes: If no period size an...
mandoc: aplay.1:107:29: STYLE: whitespace at end of input line
mandoc: aplay.1:109:114: STYLE: input text line longer than 80 bytes: If no buffer time an...
mandoc: aplay.1:111:34: STYLE: whitespace at end of input line
mandoc: aplay.1:114:34: STYLE: whitespace at end of input line
mandoc: aplay.1:115:48: STYLE: whitespace at end of input line
mandoc: aplay.1:118:34: STYLE: whitespace at end of input line
mandoc: aplay.1:121:33: STYLE: whitespace at end of input line
mandoc: aplay.1:131:34: STYLE: whitespace at end of input line
mandoc: aplay.1:215:66: STYLE: whitespace at end of input line
mandoc: aplay.1:225:43: STYLE: whitespace at end of input line
mandoc: aplay.1:260:10: STYLE: whitespace at end of input line

-.-.

Remove space characters at the end of lines.

Use "git apply ... --whitespace=fix" to fix extra space issues, or use
global configuration "core.whitespace".

3:arecord, aplay \- command\-line sound recorder and player for ALSA 
87:\fI\-M, \-\-mmap\fP            
91:\fI\-N, \-\-nonblock\fP          
95:\fI\-F, \-\-period\-time=#\fP     
99:\fI\-B, \-\-buffer\-time=#\fP     
103:\fI\-\-period\-size=#\fP     
107:\fI\-\-buffer\-size=#\fP     
111:\fI\-A, \-\-avail\-min=#\fP       
114:\fI\-R, \-\-start\-delay=#\fP     
115:Delay for automatic PCM start is # microseconds 
118:\fI\-T, \-\-stop\-delay=#\fP      
121:\fI\-v, \-\-verbose\fP           
131:\fI\-I, \-\-separate\-channels\fP 
215:When recording, SIGINT, SIGTERM and SIGABRT will close the output 
225:22050\-Hz, mono, 8\-bit, Mu\-Law .au file. 
260:.SH BUGS 

-.-.

Add a (no-break, "\ " or "\~") space between a number and a unit,
as these are not one entity.

14:automatically split before the 2GB filesize.

-.-.

Change a HYPHEN-MINUS (code 0x2D) to a minus(-dash) (\-),
if it
is in front of a name for an option,
is a symbol for standard input,
is a single character used to indicate an option,
or is in the NAME section (man-pages(7)).
N.B. - (0x2D), processed as a UTF-8 file, is changed to a hyphen
(0x2010, groff \[u2010] or \[hy]) in the output.

79:Either '-d' or '-s' option is available exclusively.
85:Either '-d' or '-s' option is available exclusively.
148:\fI-m, \-\-chmap=ch1,ch2,...\fP

-.-.

Add a comma (or \&) after "e.g." and "i.e.", or use English words
(man-pages(7)).
Abbreviation points should be protected against being interpreted as
an end of sentence, if they are not, and that independent of the
current place on the line.

211:Disables recovery attempts when errors (e.g. xrun) are encountered; the

-.-.

Wrong distance between sentences in the input file.

  Separate the sentences and subordinate clauses; each begins on a new
line.  See man-pages(7) ("Conventions for source file layout") and
"info groff" ("Input Conventions").

  The best procedure is to always start a new sentence on a new line,
at least, if you are typing on a computer.

Remember coding: Only one command ("sentence") on each (logical) line.

E-mail: Easier to quote exactly the relevant lines.

Generally: Easier to edit the sentence.

Patches: Less unaffected text.

Search for two adjacent words is easier, when they belong to the same line,
and the same phrase.

  The amount of space between sentences in the output can then be
controlled with the ".ss" request.


12:driver. It supports several file formats and multiple soundcards with
13:multiple devices. If recording with interleaved mode samples the file is
16:\fBaplay\fP is much the same, only it plays instead of recording. For
20:If filename is not specified, the standard output or input is used. The \fBaplay\fP utility accepts multiple filenames.
40:Quiet mode. Suppress messages (not sound :))
71:Sampling rate in Hertz. The default rate is 8000 Hertz.
92:Open the audio device in non\-blocking mode. If the device is busy the program will exit immediately.
204:Dump hw_params of the device preconfigured status to stderr. The dump
211:Disables recovery attempts when errors (e.g. xrun) are encountered; the

-.-.

Split lines longer than 80 characters into two or more lines.
Appropriate break points are the end of a sentence and a subordinate
clause; after punctuation marks.


Line 20, length 119

If filename is not specified, the standard output or input is used. The \fBaplay\fP utility accepts multiple filenames.

Line 78, length 111

The default is zero, so if this option is omitted then the record/playback process will run until it is killed.

Line 84, length 112

The default is zero, so if this options is omitted then the record/playback process will run until it is killed.

Line 92, length 101

Open the audio device in non\-blocking mode. If the device is busy the program will exit immediately.

Line 93, length 91

If this option is not set the program will block until the audio device is available again.

Line 97, length 87

If no period time and no period size is given then a quarter of the buffer time is set.

Line 101, length 114

If no buffer time and no buffer size is given then the maximal allowed buffer time but not more than 500ms is set.

Line 105, length 87

If no period size and no period time is given then a quarter of the buffer size is set.

Line 109, length 114

If no buffer time and no buffer size is given then the maximal allowed buffer time but not more than 500ms is set.

Line 249, length 99

\fBarecord \-f cd \-t wav \-\-max\-file\-time 3600 \-\-use-strftime %Y/%m/%d/listen-%H-%M-%v.wav\fP


-.-.

Name of a manual is set in bold, the section in roman.
See man-pages(7).

257:amixer(1)

-.-.

Use a no-break space between a number and a (SI) unit

101:If no buffer time and no buffer size is given then the maximal allowed buffer time but not more than 500ms is set.
109:If no buffer time and no buffer size is given then the maximal allowed buffer time but not more than 500ms is set.

-.-.

Use a hyphen between a number and the unit (name) "bit",
see "man-pages(7)", item "Terms to avoid".

64:\-f cd (16 bit little endian, 44100, stereo) [\-f S16_LE \-c2 \-r44100]
65:\-f cdr (16 bit big endian, 44100, stereo) [\-f S16_BE \-c2 \-r44100]
66:\-f dat (16 bit little endian, 48000, stereo) [\-f S16_LE \-c2 \-r48000]

-.-.

Two or more space charaters between printable characters.

When the distance is between sentences,
start the beginning of the second one on a separate line
("semantic newline").

123:This option is accumulative.  The VU meter is displayed when this
132:One file for each channel.  This option disables max\-file\-time
133:and use\-strftime, and ignores SIGUSR1.  The stereo VU meter is
137:Playback.  This is the default if the program is invoked
141:Record.  This is the default if the program is invoked
149:Give the channel map to override or follow.  Pass channel position
185:close it and open a new output file.  Default is the maximum
187:This option has no effect if  \-\-separate\-channels is
196:the strftime facility whenever the output file is opened.  The
198:the month, %H hour, %M minute and %S second.  In addition, %v is
199:the file number, starting at 1.  When this option is specified,
216:file and exit.  SIGUSR1 will close the output file, open a new one,
217:and continue recording.  However, SIGUSR1 does not work with
244:per second, 8 bits per sample.  Start a new file every
245:30 seconds.  File names are mon\-nn.wav, where nn increases
246:from 01.  The file after mon\-99.wav is mon\-100.wav.
250:Record in stereo from the default audio source.  Create a new file
251:every hour.  The files are placed in directories based on their start dates

-.-.

Output from "test-groff  -mandoc -t -K utf8 -rF0 -rHY=0 -ww -b -z ":

troff: backtrace: file '<stdin>':3
troff:<stdin>:3: warning: trailing space in the line
troff: backtrace: file '<stdin>':87
troff:<stdin>:87: warning: trailing space in the line
troff: backtrace: file '<stdin>':91
troff:<stdin>:91: warning: trailing space in the line
troff: backtrace: file '<stdin>':95
troff:<stdin>:95: warning: trailing space in the line
troff: backtrace: file '<stdin>':99
troff:<stdin>:99: warning: trailing space in the line
troff: backtrace: file '<stdin>':103
troff:<stdin>:103: warning: trailing space in the line
troff: backtrace: file '<stdin>':107
troff:<stdin>:107: warning: trailing space in the line
troff: backtrace: file '<stdin>':111
troff:<stdin>:111: warning: trailing space in the line
troff: backtrace: file '<stdin>':114
troff:<stdin>:114: warning: trailing space in the line
troff: backtrace: file '<stdin>':115
troff:<stdin>:115: warning: trailing space in the line
troff: backtrace: file '<stdin>':118
troff:<stdin>:118: warning: trailing space in the line
troff: backtrace: file '<stdin>':121
troff:<stdin>:121: warning: trailing space in the line
troff: backtrace: file '<stdin>':131
troff:<stdin>:131: warning: trailing space in the line
troff: backtrace: file '<stdin>':215
troff:<stdin>:215: warning: trailing space in the line
troff: backtrace: file '<stdin>':225
troff:<stdin>:225: warning: trailing space in the line
troff: backtrace: file '<stdin>':258
troff:<stdin>:258: warning: trailing space in the line
diff mbox series

Patch

--- aplay.1	2024-11-27 17:45:09.168911693 +0000
+++ aplay.1.new	2024-11-27 19:40:50.639709777 +0000
@@ -1,6 +1,6 @@ 
 .TH APLAY 1 "1 January 2010"
 .SH NAME
-arecord, aplay \- command\-line sound recorder and player for ALSA 
+arecord, aplay \- command\-line sound recorder and player for ALSA
 soundcard driver
 .SH SYNOPSIS
 \fBarecord\fP [\fIflags\fP] [filename]
@@ -9,15 +9,20 @@  soundcard driver
 
 .SH DESCRIPTION
 \fBarecord\fP is a command\-line soundfile recorder for the ALSA soundcard
-driver. It supports several file formats and multiple soundcards with
-multiple devices. If recording with interleaved mode samples the file is
-automatically split before the 2GB filesize.
-
-\fBaplay\fP is much the same, only it plays instead of recording. For
-supported soundfile formats, the sampling rate, bit depth, and so
-forth can be automatically determined from the soundfile header.
-
-If filename is not specified, the standard output or input is used. The \fBaplay\fP utility accepts multiple filenames.
+driver.
+It supports several file formats
+and multiple soundcards with multiple devices.
+If recording with interleaved mode samples
+the file is automatically split before the 2\~GB filesize.
+
+\fBaplay\fP is much the same, only it plays instead of recording.
+For supported soundfile formats,
+the sampling rate, bit depth, and so forth
+can be automatically determined from the soundfile header.
+
+If filename is not specified,
+the standard output or input is used.
+The \fBaplay\fP utility accepts multiple filenames.
 
 .SH OPTIONS
 .TP
@@ -61,100 +66,122 @@  Some of these may not be available on se
 .br
 The available format shortcuts are:
 .nf
-\-f cd (16 bit little endian, 44100, stereo) [\-f S16_LE \-c2 \-r44100]
-\-f cdr (16 bit big endian, 44100, stereo) [\-f S16_BE \-c2 \-r44100]
-\-f dat (16 bit little endian, 48000, stereo) [\-f S16_LE \-c2 \-r48000]
+\-f cd (16-bit little endian, 44100, stereo) [\-f S16_LE \-c2 \-r44100]
+\-f cdr (16-bit big endian, 44100, stereo) [\-f S16_BE \-c2 \-r44100]
+\-f dat (16-1251bit little endian, 48000, stereo) [\-f S16_LE \-c2 \-r48000]
 .fi
 If no format is given U8 is used.
 .TP
 \fI\-r, \-\-rate=#<Hz>\fP
-Sampling rate in Hertz. The default rate is 8000 Hertz.
-If the value specified is less than 300, it is taken as the rate in kilohertz.
-Valid values are 2000 through 192000 Hertz.
+Sampling rate in hertz.
+The default rate is 8000 hertz.
+If the value specified is less than 300,
+it is taken as the rate in kilohertz.
+Valid values are 2000 through 192000 hertz.
 .TP
 \fI\-d, \-\-duration=#\fP
 Interrupt after # seconds.
 A value of zero means infinity.
-The default is zero, so if this option is omitted then the record/playback process will run until it is killed.
-Either '-d' or '-s' option is available exclusively.
+The default is zero,
+so if this option is omitted
+then the record/playback process will run until it is killed.
+Either '\-d' or '\-s' option is available exclusively.
 .TP
 \fI\-s, \-\-samples=#\fP
 Interrupt after transmission of # PCM frames.
 A value of zero means infinity.
-The default is zero, so if this options is omitted then the record/playback process will run until it is killed.
-Either '-d' or '-s' option is available exclusively.
+The default is zero,
+so if this options is omitted
+then the record/playback process will run until it is killed.
+Either '\-d' or '\-s' option is available exclusively.
 .TP
-\fI\-M, \-\-mmap\fP            
+\fI\-M, \-\-mmap\fP
 Use memory\-mapped (mmap) I/O mode for the audio stream.
-If this option is not set, the read/write I/O mode will be used.
+If this option is not set,
+the read/write I/O mode will be used.
 .TP
-\fI\-N, \-\-nonblock\fP          
-Open the audio device in non\-blocking mode. If the device is busy the program will exit immediately.
-If this option is not set the program will block until the audio device is available again.
+\fI\-N, \-\-nonblock\fP
+Open the audio device in non\-blocking mode.
+If the device is busy the program will exit immediately.
+If this option is not set
+the program will block until the audio device is available again.
 .TP
-\fI\-F, \-\-period\-time=#\fP     
+\fI\-F, \-\-period\-time=#\fP
 Distance between interrupts is # microseconds.
-If no period time and no period size is given then a quarter of the buffer time is set.
-.TP
-\fI\-B, \-\-buffer\-time=#\fP     
-Buffer duration is # microseconds
-If no buffer time and no buffer size is given then the maximal allowed buffer time but not more than 500ms is set.
+If no period time and no period size is given
+then a quarter of the buffer time is set.
 .TP
-\fI\-\-period\-size=#\fP     
-Distance between interrupts is # frames
-If no period size and no period time is given then a quarter of the buffer size is set.
+\fI\-B, \-\-buffer\-time=#\fP
+Buffer duration is # microseconds.
+If no buffer time and no buffer size is given
+then the maximal allowed buffer time,
+but not more than 500\~ms,
+is set.
+.TP
+\fI\-\-period\-size=#\fP
+Distance between interrupts is # frames.
+If no period size and no period time is given
+then a quarter of the buffer size is set.
 .TP
-\fI\-\-buffer\-size=#\fP     
+\fI\-\-buffer\-size=#\fP
 Buffer duration is # frames
-If no buffer time and no buffer size is given then the maximal allowed buffer time but not more than 500ms is set.
+If no buffer time and no buffer size is given
+then the maximal allowed buffer time,
+but not more than 500\~ms,
+is set.
 .TP
-\fI\-A, \-\-avail\-min=#\fP       
+\fI\-A, \-\-avail\-min=#\fP
 Min available space for wakeup is # microseconds
 .TP
-\fI\-R, \-\-start\-delay=#\fP     
-Delay for automatic PCM start is # microseconds 
+\fI\-R, \-\-start\-delay=#\fP
+Delay for automatic PCM start is # microseconds
 (relative to buffer size if <= 0)
 .TP
-\fI\-T, \-\-stop\-delay=#\fP      
+\fI\-T, \-\-stop\-delay=#\fP
 Delay for automatic PCM stop is # microseconds from xrun
 .TP
-\fI\-v, \-\-verbose\fP           
+\fI\-v, \-\-verbose\fP
 Show PCM structure and setup.
-This option is accumulative.  The VU meter is displayed when this
-is given twice or three times.
+This option is accumulative.
+The VU meter is displayed
+when this is given twice or three times.
 .TP
 \fI\-V, \-\-vumeter=TYPE\fP
-Specifies the VU\-meter type, either \fIstereo\fP or \fImono\fP.
+Specifies the VU\-meter type,
+either \fIstereo\fP or \fImono\fP.
 The stereo VU\-meter is available only for 2\-channel stereo samples
 with interleaved format.
 .TP
-\fI\-I, \-\-separate\-channels\fP 
-One file for each channel.  This option disables max\-file\-time
-and use\-strftime, and ignores SIGUSR1.  The stereo VU meter is
-not available with separate channels.
+\fI\-I, \-\-separate\-channels\fP
+One file for each channel.
+This option disables max\-file\-time
+and use\-strftime, and ignores SIGUSR1.
+The stereo VU meter is not available with separate channels.
 .TP
 \fI\-P\fP
-Playback.  This is the default if the program is invoked
-by typing aplay.
+Playback.
+This is the default
+if the program is invoked by typing aplay.
 .TP
 \fI\-C\fP
-Record.  This is the default if the program is invoked
-by typing arecord.
+Record.
+This is the default
+if the program is invoked by typing arecord.
 .TP
 \fI\-i, \-\-interactive\fP
 Allow interactive operation via stdin.
 Currently only pause/resume via space or enter key is implemented.
 .TP
-\fI-m, \-\-chmap=ch1,ch2,...\fP
-Give the channel map to override or follow.  Pass channel position
-strings like \fIFL\fP, \fIFR\fP, etc.
-
-If a device supports the override of the channel map, \fBaplay\fP
-tries to pass the given channel map.
-If it doesn't support the channel map override but still it provides
-the channel map information, \fBaplay\fP tries to rearrange the
-channel order in the buffer to match with the returned channel map
-from the device.
+\fI\-m, \-\-chmap=ch1,ch2,...\fP
+Give the channel map to override or follow.
+Pass channel position strings like \fIFL\fP, \fIFR\fP, etc.
+
+If a device supports the override of the channel map,
+\fBaplay\fP tries to pass the given channel map.
+If it doesn't support the channel map override
+but still it provides the channel map information,
+\fBaplay\fP tries to rearrange the channel order in the buffer
+to match with the returned channel map from the device.
 .TP
 \fI\-\-disable\-resample\fP
 Disable automatic rate resample.
@@ -177,26 +204,31 @@  Expression for validation is: coef * (bu
 Minimum value is 1.
 .TP
 \fI\-\-test\-nowait\fP
-Do not wait for the ring buffer \(hy eats the whole CPU.
+Do not wait for the ring buffer \(en eats the whole CPU.
 .TP
 \fI\-\-max\-file\-time\fP
-While recording, when the output file has been accumulating
-sound for this long,
-close it and open a new output file.  Default is the maximum
-size supported by the file format: 2 GiB for WAV files.
-This option has no effect if  \-\-separate\-channels is
-specified.
+While recording,
+when the output file has been accumulating sound for this long,
+close it and open a new output file.
+Default is the maximum size supported by the file format:
+2\~GiB for WAV files.
+This option has no effect
+if  \-\-separate\-channels is specified.
 .TP
 \fI\-\-process\-id\-file <file name>\fP
-aplay writes its process ID here, so other programs can
-send signals to it.
+aplay writes its process ID here,
+so other programs can send signals to it.
 .TP
 \fI\-\-use\-strftime\fP
-When recording, interpret %\-codes in the file name parameter using
-the strftime facility whenever the output file is opened.  The
-important strftime codes are: %Y is the year, %m month, %d day of
-the month, %H hour, %M minute and %S second.  In addition, %v is
-the file number, starting at 1.  When this option is specified,
+When recording,
+interpret %\-codes in the file name parameter using the strftime facility
+whenever the output file is opened.
+The important strftime codes are:
+%Y is the year, %m month, %d day of the month,
+%H hour, %M minute and %S second.
+In addition,
+%v is the file number, starting at 1.
+When this option is specified,
 intermediate directories for the output file are created automatically.
 This option has no effect if \-\-separate\-channels is specified.
 .TP
@@ -208,21 +240,22 @@  For raw device hw:X this option basicall
 the soundcard.
 .TP
 \fI\-\-fatal\-errors\fP
-Disables recovery attempts when errors (e.g. xrun) are encountered; the
+Disables recovery attempts when errors (e.g., xrun) are encountered; the
 aplay process instead aborts immediately.
 
 .SH SIGNALS
-When recording, SIGINT, SIGTERM and SIGABRT will close the output 
-file and exit.  SIGUSR1 will close the output file, open a new one,
-and continue recording.  However, SIGUSR1 does not work with
-\-\-separate\-channels.
+When recording,
+SIGINT, SIGTERM and SIGABRT will close the output file and exit.
+SIGUSR1 will close the output file, open a new one,
+and continue recording.
+However, SIGUSR1 does not work with \-\-separate\-channels.
 
 .SH EXAMPLES
 
 .TP
 \fBaplay \-c 1 \-t raw \-r 22050 \-f mu_law foobar\fR
 will play the raw file "foobar" as a
-22050\-Hz, mono, 8\-bit, Mu\-Law .au file. 
+22050\-Hz, mono, 8\-bit, Mu\-Law .au file.
 
 .TP
 \fBarecord \-d 10 \-f cd \-t wav \-D copy foobar.wav\fP
@@ -240,24 +273,26 @@  pcm.copy {
 
 .TP
 \fBarecord \-t wav \-\-max\-file\-time 30 mon.wav\fP
-Record from the default audio source in monaural, 8,000 samples
-per second, 8 bits per sample.  Start a new file every
-30 seconds.  File names are mon\-nn.wav, where nn increases
-from 01.  The file after mon\-99.wav is mon\-100.wav.
+Record from the default audio source in monaural,
+8,000 samples per second, 8 bits per sample.
+Start a new file every 30 seconds.
+File names are mon\-nn.wav, where nn increases from 01.
+The file after mon\-99.wav is mon\-100.wav.
 
 .TP
-\fBarecord \-f cd \-t wav \-\-max\-file\-time 3600 \-\-use-strftime %Y/%m/%d/listen-%H-%M-%v.wav\fP
-Record in stereo from the default audio source.  Create a new file
-every hour.  The files are placed in directories based on their start dates
+\fBarecord \-f cd \-t wav \-\-max\-file\-time 3600 \-\-use-strftime \
+%Y/%m/%d/listen-%H-%M-%v.wav\fP
+Record in stereo from the default audio source.
+Create a new file every hour.
+The files are placed in directories based on their start dates
 and have names which include their start times and file numbers.
 
 .SH SEE ALSO
-\fB
-alsamixer(1),
-amixer(1)
-\fP
+.BR \
+alsamixer "(1), " \
+amixer (1)
 
-.SH BUGS 
+.SH BUGS
 Note that .aiff files are not currently supported.
 
 .SH AUTHOR