New sentence, new line. Sort options. Bump Dd for .wav-file handling.

Some nits.
This commit is contained in:
wiz 2002-10-13 01:03:48 +00:00
parent eb0d04136f
commit 900f387c29
1 changed files with 36 additions and 29 deletions

View File

@ -1,4 +1,4 @@
.\" $NetBSD: audiorecord.1,v 1.28 2002/10/13 00:56:44 mrg Exp $
.\" $NetBSD: audiorecord.1,v 1.29 2002/10/13 01:03:48 wiz Exp $
.\"
.\" Copyright (c) 1998-1999 Matthew R. Green
.\" All rights reserved.
@ -26,20 +26,20 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.Dd January 15, 2002
.Dd October 13, 2002
.Dt AUDIORECORD 1
.Os
.Sh NAME
.Nm audiorecord
.Nd record audio files
.Sh SYNOPSIS
.Nm
.Nm ""
.Op Fl afhV
.Op Fl b Ar balance
.Op Fl F Ar format
.Op Fl c Ar channels
.Op Fl d Ar device
.Op Fl e Ar encoding
.Op Fl F Ar format
.Op Fl i Ar info
.Op Fl m Ar monvol
.Op Fl P Ar precision
@ -55,12 +55,13 @@ program copies the audio device to the named audiofile or to the standard
output if no file is named.
.Pp
The output file will contain either a Sun/NeXT audio header, a
RIFF/WAVE audio header or no header at all. Sun output files
using a linear PCM encoding are written with big-endian signed samples,
possibly after converting these from little-endian or unsigned
samples. RIFF/WAVE files are written in little-endian, signed
samples, also converting if necessary. The default output is
Sun/NeXT format, but if the output file
RIFF/WAVE audio header or no header at all.
Sun output files using a linear PCM encoding are written with big-endian
signed samples, possibly after converting these from little-endian or
unsigned samples.
RIFF/WAVE files are written in little-endian, signed samples, also
converting if necessary.
The default output is Sun/NeXT format, but if the output file
.Ar file
ends with a
.Pa .wav
@ -74,15 +75,6 @@ Append to the specified file, rather than overwriting.
Set the balance to
.Ar balance .
This value must be between 0 and 63.
.It Fl F
Set the output header format to
.Ar format .
Currently supported formats are
.Dq sun ,
.Dq wav
and
.Dq none
for Sun/NeXT audio, WAV and no header, respectively.
.It Fl c
Set number of channels to
.Ar channels .
@ -112,10 +104,21 @@ Setting the argument to
still may be important since it is used in an
.Xr ioctl 2
call to the kernel to choose the kind of data provided.
.It Fl F
Set the output header format to
.Ar format .
Currently supported formats are
.Dq sun ,
.Dq wav
and
.Dq none
for Sun/NeXT audio, WAV and no header, respectively.
.It Fl f
Force. Normally when appending to audiofiles using the
Force.
Normally when appending to audiofiles using the
.Fl a
option, the sample rates must match. The
option, the sample rates must match.
The
.Fl f
option will allow a discrepancy to be ignored.
.It Fl h
@ -129,8 +132,8 @@ to the output header.
.It Fl m
Set the monitor volume.
.It Fl P
Set the precision. This value is the number of bits per sample, and is
normally either
Set the precision.
This value is the number of bits per sample, and is normally either
.Dq 8
or
.Dq 16 ,
@ -151,11 +154,13 @@ are
and
.Dq line .
.It Fl s
Set the sampling rate. This value is per-second. Typical values are
8000, 44100 and 48000, which are the telephone, CD Audio and DAT Audio
default sampling rates.
Set the sampling rate.
This value is per-second.
Typical values are 8000, 44100 and 48000, which are the telephone,
CD Audio and DAT Audio default sampling rates.
.It Fl t
Sets the maximum amount of time to record. Format is [hh:]mm:ss.
Sets the maximum amount of time to record.
Format is [hh:]mm:ss.
.It Fl q
Be quiet.
.It Fl V
@ -201,7 +206,8 @@ the audio device to be used.
.Sh HISTORY
The
.Nm
program was first seen in SunOS 5. It was first made available in
program was first seen in SunOS 5.
It was first made available in
.Nx 1.4 .
RIFF/WAVE support, and support for converting signed/unsigned and
big/little-endian samples was first made available in
@ -209,7 +215,8 @@ big/little-endian samples was first made available in
.Sh AUTHORS
The
.Nm
program was written by Matthew R. Green \*[Lt]mrg@eterna.com.au\*[Gt].
program was written by
.An Matthew R. Green Aq mrg@eterna.com.au .
.Sh BUGS
WAV big-endian samples are converted to little-endian, rather than
a RIFX header being written.