Initial version...

diff --git a/alsamixer/alsamixer.1 b/alsamixer/alsamixer.1
new file mode 100644 (file)
index 0000000..6c4f9aa
--- /dev/null
+++ b/alsamixer/alsamixer.1
@@ -0,0 +1,119 @@
+.TH ALSAMIXER 1 "25 Nov 1998"
+.SH NAME
+alsamixer \- soundcard mixer for ALSA soundcard driver, with ncurses interface
+.SH SYNOPSIS
+
+\fBalsamixer\fP [\fIoptions\fP]
+
+.SH DESCRIPTION
+\fBalsamixer\fP is an ncurses mixer program for use with the ALSA
+soundcard drivers. It supports multiple soundcards with multiple devices.
+
+.SH INVOKING
+
+\fBalsamixer\fP [\fIoptions\fP]
+
+.SS Options
+
+.TP
+\fI-h, -help\fP 
+Help: show available flags.
+
+.TP
+\fI-c\fP <card number>
+Select the soundcard to use, if you have more than one. Cards are
+numbered from 1 (the default).
+
+.TP
+\fI-m\fP <device number>
+Select the soundcard device to control, if your card has more than
+one. Devices are numbered from 0 (the default). Not to be confused
+with the soundcard mixer channels, which are sometimes also referred
+to as "devices", just to be annoying. Many soundcards will only have
+device 0. Some more complex cards may have more. This flag corresponds
+to the -d flag for \fBamixer\fP, \fBarecord\fP, and \fBaplay\fP.
+
+.TP
+\fI-e\fP
+Start in "exact mode." This will affect the numbers you see displayed
+for volumes, but does not affect operation of the level controls.
+The default behavior is to show levels in percent from 0 to 100. This
+is easy to read, but can mislead you about how much control the
+soundcard actually lets you have. Exact mode, on the other hand, shows
+you the settings as the soundcard itself understands them. In exact
+mode, each channel level is between 0 and a power of 2 minus one
+(e.g. 0-7, or 0-63). Exact mode may also be toggled while alsamixer is
+running, by using \fITAB\fP.
+
+.SH KEYBOARD COMMANDS
+\fBalsamixer\fP recognizes the following keyboard commands to control the soundcard. 
+
+.SS
+General Controls
+
+The \fILeft\fP and \fIright arrow\fP keys are used to select the
+channel (or device, depending on your preferred terminology). You can
+also use \fIn\fP ("next") and \fIp\fP ("previous").
+
+The \fIUp\fP and \fIDown Arrows\fP control the volume for the
+currently selected device. You can also use \fI+\fP or \fI-\fP for the
+same purpose. Both the left and right signals are affected. For
+independent left and right control, see below.
+ 
+\fIM\fP toggles muting for the current channel (both left and right). You can
+mute left and right independently by using \fI,\fP and \fI.\fP respectively.
+
+\fISPACE\fP toggles recording: the current channel will be added or
+removed from the sources used for recording. This only works for valid
+input channels, of course.
+
+\fIL\fP re-draws the screen.
+
+\fITAB\fP toggles the mode for volume display. See description for the
+\fI-e\fP flag above.
+
+.SS
+Quick Volume Changes
+
+\fIPageUp\fP increases volume by 10.
+
+\fIPageDown\fP decreases volume by 10.
+
+\fIHome\fP sets volume to maximum.
+
+\fIEnd\fP sets volume to 0.
+
+You can also control left & right levels for the current channel
+independently, as follows:
+
+[\fIQ\fP | \fIW\fP | \fIE\fP ]  -- turn UP [ left | both | right ]
+
+[\fIZ\fP | \fIX\fP | \fIC\fP ] -- turn DOWN [ left | both | right ]   
+
+If the currently selected mixer channel is not a stereo channel, then
+all UP keys will work like \fIW\fP, and all DOWN keys will work like \fIX\fP.
+
+.SS
+Exiting
+
+Quit the program with \fIALT Q\fP, or by hitting \fIESC\fP.
+
+.SH SEE ALSO
+\fB
+amixer(1),
+arecord(1)
+\fP
+
+.SH BUGS 
+None known. Some terminal emulators (e.g. \fBnxterm\fP) may not
+work quite right with ncurses, but that's their own damn
+fault. Plain old \fBxterm\fP seems to be fine.
+
+.SH AUTHOR
+\fBalsamixer\fP is by Jaroslav Kysela <perex@jcu.cz>
+This document is by Paul Winkler <zarmzarm@erols.com>.
+
+
+
+
+

diff --git a/aplay/arecord.1 b/aplay/arecord.1
new file mode 100644 (file)
index 0000000..043a830
--- /dev/null
+++ b/aplay/arecord.1
@@ -0,0 +1,112 @@
+.TH APLAY 1 "25 Nov 1998"
+.SH NAME
+arecord, aplay \- command-line sound recorder and player for ALSA soundcard driver
+.SH SYNOPSIS
+
+[\fBarecord\fP | \fBaplay\fP ] [\fIflags\fP] filename
+
+.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. 
+
+\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.
+
+.SH INVOKING
+
+[\fBarecord\fP | \fBaplay\fP ] [\fIflags\fP] filename
+
+.SS Options
+.TP
+\fI-h, --help\fP 
+Help: show syntax.
+.TP
+\fI-V, --version\fP
+Print current version.
+.TP
+\fI-l\fP
+List all available soundcards and devices. 
+.TP
+\fI-c\fP <card number>
+Select the soundcard to use, if you have more than one. Cards are
+numbered from 1 (the default).
+.TP
+\fI-d\fP <device number>
+Select the soundcard device to use, if your card has more than
+one. Devices are numbered from 0 (the default). Not to be confused
+with the soundcard mixer channels, which are sometimes also referred
+to as "devices", just to be annoying. Many soundcards will only have
+device 0. Some more complex cards may have mor. Try using \fI-l\fP
+and see what you get.
+
+.TP
+\fI-q\fP
+Quiet mode. Suppress messages (not sound :))
+
+.TP
+\fI-w\fP 
+Use Wave soundfile format (.wav)
+.TP
+\fI-r\fP 
+Use raw soundfile format. Requires -s, -b, and -p flags?
+.TP
+\fI-u\fP 
+Use Sparc Audio soundfile format (.au)
+.TP
+\fI-v\fP 
+Use Voc soundfile format
+.TP
+\fI-S\fP 
+Soundfile is stereo. Mono is the default for headerless files.
+.TP
+\fI-t \fP<secs>
+Time limit for recording, in seconds.
+.TP
+\fI-s \fP<Hz> 
+Sampling rate in Hertz.
+.TP
+\fI-b \fP<bits> 
+Bit depth (8 or 16 bits).
+.TP
+\fI-m\fP 
+Set to CD standard quality (44100 Hz, stereo, 16-bit linear).
+.TP
+\fI-M \fP<bits> 
+Set to DAT quality (48000 Hz, stereo, 16-bit linear).
+.TP
+\fI-p \fP<type>
+Compression type (alaw, ulaw, adpcm).
+
+.SS
+Example: 
+
+.RS
+\fBaplay -c 2 -r -u -s 22050 -b 8 -p ulaw foobar\fR
+
+.ID
+will play the raw file "foobar" as a
+22050-Hz, mono, 8-bit, Mu-Law .au file, using the second soundcard. 
+
+\fBarecord -t 10 -m -w foobar.wav\fP
+
+will record foobar.wav as a 10-second, CD-quality wave file.
+
+.SH SEE ALSO
+\fB
+alsamixer(1),
+amixer(1)
+\fP
+
+.SH BUGS 
+Note that .aiff files are not currently supported.
+
+.SH AUTHOR
+\fBarecord\fP and \fBaplay\fP are by Jaroslav Kysela <perex@jcu.cz>
+This document is by Paul Winkler <zarmzarm@erols.com>.
+
+
+
+
+