1 files changed, 28 insertions, 14 deletions
diff --git a/audio/volume.app/README b/audio/volume.app/README
index 56a635125db9b..2601947aa48ea 100644
--- a/audio/volume.app/README
+++ b/audio/volume.app/README
@@ -12,18 +12,32 @@ ALSA's OSS emulation.
 
 
 ==========================================================================
-NOTE1: look into "config.h.in" to set some options as needed;
-
-NOTE2: If the system is on "ALSA's OSS emulation" and the app didn't run OK,
-       remove the package and re-create it with those procedures:
-
-       'cat /proc/asound/oss/sndstat' and search the "Mixers" section.
-        locate the desired 'mixer number' and then modify file "config.h.in",
-        at "DEFAULT_MIXER_DEVICE" parameter. Then, re-create the package.
-      
-        Eg: if desired mixer is "2", modify "config.h.in" as below:
-       
-            DEFAULT_MIXER_DEVICE "/dev/mixer"
-               ( to )
-            DEFAULT_MIXER_DEVICE "/dev/mixer2"
+
+NOTE:  The hacks/mods are for "ALSA's OSS emulation" in ALSA systems.
+
+NOTE2: There are two 'mod' files: "config.h.in.mod" and "volume.app.c.mod".
+       If you want to use them, simple rename them to each "original filename"
+       (remove ".mod" on filename).
+
+       "volume.app.c.mod" is a hack to fix the mute/unmute problem
+       for ALSA systems. (It uses "amixer" command as background).
+
+       "config.h.in.mod" is just a covenience to set some parameters.
+       eg: If is notified that the app is not running on the right mixer
+          (more than 1 soundcard), you may try to set the default mixer
+          before creating the package!
+
+          'cat /proc/asound/oss/sndstat' and search the "Mixers" section.
+          locate the desired 'mixer number' and then modify file
+          "config.h.in.mod" at "DEFAULT_MIXER_DEVICE" parameter.
+
+          Eg2: if desired mixer is "2", modify "config.h.in.mod" as below:
+
+          DEFAULT_MIXER_DEVICE "/dev/mixer"
+          ( to )
+          DEFAULT_MIXER_DEVICE "/dev/mixer2"
+
+        Again, do not forget to rename the file "config.h.in.mod" to
+        "config.h.in" before creating the package.
+
 ==========================================================================