audio/mac: Man page, other enhancements.

Signed-off-by: B. Watson <yalhcru@gmail.com>

Signed-off-by: Willy Sudiarto Raharjo <willysr@slackbuilds.org>

1 files changed, 15 insertions, 2 deletions

diff --git a/audio/mac/README b/audio/mac/README
index d013f5dbfc..87df899452 100644
--- a/audio/mac/README
+++ b/audio/mac/README
@@ -1,7 +1,14 @@
 mac (Monkey's Audio Linux port)
 
-mac is a console frontend to Monkey's Audio, able to encode and 
-decode APE audio files.
+Monkey's Audio (aka APE) is a lossless audio compression format,
+similar to FLAC. mac is a console frontend to Monkey's Audio, able to
+encode and decode APE audio files.
+
+Note: if you just want to listen to APE files, Slackware's mplayer
+and audacious can already play them. If you just want to convert them
+to some other format (wav, mp3, etc), Slackware's ffmpeg can already
+decode them. The only real reason to install this package is for
+converting files *to* APE format.
 
 If you're building this for an old x86 CPU that doesn't support MMX,
 set ASM=no in the script's environment.
@@ -10,3 +17,9 @@ The package is built using upstream's default optimization level,
 which is -O3. If you suspect this is causing problems, rebuild with
 FORCE_SLACK_CFLAGS=yes in the environment (this will force -O2). If this
 actually fixes anything, please email the maintainer with the details.
+
+Note: if you get "invalid input file" trying to encode a wav file, it
+probably means the wav file uses floating point rather than 16-bit
+integer samples. You can convert with sox:
+
+  sox -G input.wav -b16 output.wav