From 5210f4862406958214b69629b801d7feb5d3fb61 Mon Sep 17 00:00:00 2001
From: Jaroslav Kysela <perex@perex.cz>
Date: Wed, 26 Sep 2001 13:08:14 +0000
Subject: [PATCH] More examples, more updates (toggle)

---
 amixer/amixer.1 | 40 ++++++++++++++++++++++++++++++----------
 1 file changed, 30 insertions(+), 10 deletions(-)

diff --git a/amixer/amixer.1 b/amixer/amixer.1
index ea77d60..37a0a9c 100644
--- a/amixer/amixer.1
+++ b/amixer/amixer.1
@@ -32,11 +32,11 @@ Shows a complete list of simple mixer controls.
 Shows a complete list of simple mixer controls with their contents.
 
 .TP
-\fIsset\fP <\fISCONTROL\fP> <\fIPARAMETER\fP> ...
+\fIset\fP or \fIsset\fP <\fISCONTROL\fP> <\fIPARAMETER\fP> ...
 Sets the simple mixer control contents. The parameter can be the volume
 either as a percentage from 0% to 100% or an exact hardware value.
-The parameters \fIcapture, nocapture, mute, unmute\fP are used to
-toggle capture (recording) and muting for the group specified.
+The parameters \fIcapture, nocapture, mute, unmute, toggle\fP are used to
+change capture (recording) and muting for the group specified.
 The parameters \fIfront, rear, center, woofer\fP are used to specify
 channels to be changed. When plus(+) or minus(-) letter is appended after
 volume value, the volume is incremented or decremented from the current
@@ -46,7 +46,7 @@ A simple mixer control must be specified. Only one device can be controlled
 at a time.
 
 .TP
-\fIsget\fP <\fISCONTROL\fP>
+\fIget\fP or \fIsget\fP <\fISCONTROL\fP>
 Shows the simple mixer control contents.
 
 A simple mixer control must be specified. Only one device can be controlled
@@ -62,13 +62,14 @@ Shows a complete list of card controls with their contents.
 
 .TP
 \fIcset\fP <\fICONTROL\fP> <\fIPARAMETER\fP> ...
-Sets the card control contents. This feature is not documented and is intended
-for experienced users only.
+Sets the card control contents. The identifier has these components: iface,
+name, index, device, subdevice, numid. The next argument specifies the value
+of control.
 
 .TP
 \fIcget\fP <\fICONTROL\fP>
-Shows the card control contents. This feature is not documented and is
-intended for experienced users only.
+Shows the card control contents. The identifier has same syntax as for
+the \fIcset]fP command.
 
 .SS Options
 
@@ -85,7 +86,7 @@ Help: show syntax.
 Quiet mode. Do not show results of changes.
 
 .SS
-Example: 
+Example #1:
 
 .RS
 \fBamixer -c 1 sset Line,0 80%,40% unmute capture\fR
@@ -93,7 +94,26 @@ Example:
 .ID
 will set the second soundcard's left line input volume to 80% and
 right line input to 40%, unmute it, and select it as a source for
-capture (recording).
+capture (recording).\fR
+
+.SS
+Example #2:
+
+.RS
+\fBamixer -c 2 cset iface=MIXER,name='Line Playback Volume",index=1 40%\fR
+
+.ID
+will set the third soundcard's second line playback volume(s) to 40%
+
+.SS
+Example #3:
+
+.RS
+\fBamixer -c 2 cset numid=34 40%\fR
+
+.ID
+will set the 34th soundcard element to 40%
+
 .SH BUGS 
 None known.
 .SH AUTHOR
-- 
2.47.1