Doc rework

[clinton/abcde.git] / FAQ

diff --git a/FAQ b/FAQ
index a62c2fe..0624322 100644 (file)
--- a/FAQ
+++ b/FAQ
@@ -1,4 +1,35 @@
 
+1. INSTALLATION
+   ============
+   
+Q. How can I install abcde on my system?
+A. To get abcde you can use a pre-packaged version, available for Debian, 
+   FreeBSD, OpenBSD, NetBSD and others.
+   In case you want to install your own release, you need to download the
+   sources and install the complementary programs (abcde is just a frontend
+   and its functionality is provided by other programs).
+   Read 
+
+   abcde needs cd-discid. Grab it from:
+   http://www.hispalinux.es/~data/files/cd-discid/
+   
+
+2. EXECUTION
+   =========
+
+3. FORMATS
+   =======
+
+4. MISC PROBLEMS
+   ==== ========
+
+Q. What happened with normalize?
+A. Normalize has changed its name under Debian, which is the GNU/Linux 
+   distribution for developing abcde (well, is The GNU/Linux Distribution
+   i only use, at the moment). Now it is called normalize-audio.
+   If you are using some other flavour of OS, you need to change the name
+   of the executable in your abcde.conf file.
+
 Q. I am using MacOSX and I am having problems to use abcde.
 A. Well, I have a Mac, but I use linux on it. I have not been able to find
    a way to make it work there, since I do not have the development tools
@@ -14,8 +45,9 @@ A. That is not possible, since abcde gets the information from CDDB database.
    You can create a template and fill it with the option "-n".
 
 Q. What formats can I encode my music to?
-A. As for version 2.1.7, abcde includes support for MP3, Ogg/Vorbis, 
-   Ogg/Speex and Flac.
+A. As for version 2.2, abcde includes support for MP3, Ogg/Vorbis, 
+   Ogg/Speex, Flac and MPP/MP+(Musepack). Support for AAC will be added once
+   an FLOSS encoder/decoder is working.
 
 Q. I have a CD with a data track, and abcde complaints it cannot read/encode
    it.
@@ -24,6 +56,8 @@ A. It is not easy to find a data track on a CD. Right now, I can only think
    a "data" track name is found. But the solution is far from been optimal.
    For now, if you find a "data" track and you know the number, restart abcde
    specifying the tracks to be encoded, leaving out the data one.
+   Version 2.2 includes some checkings with cdparanoia, to try to get this
+   right.
 
 Q. How can I separate the different output files I get using multiple-output
    support?
@@ -74,6 +108,16 @@ A. Check that you have modified everything in the right way. For instance, if
    own. If you use the predefined ones (wget, curl and fetch) abcde will try
    to use some defaults. Keep in mind that the output should go to the output
    as standard output, to be saved in a file for later use.
+   
+   If abcde seems to be ignoring your configuration options or not running commands
+   such as the encoder, you may have misquoted something. Config options such as
+   the following do not work:
+
+   LAMEOPTS=-h -k
+
+   Try this instead:
+
+   LAMEOPTS='-h -k'
 
 Q. My hardware player (put it here) does not recognize the playlists created
    with abcde. What I am doing wrong?
@@ -83,8 +127,9 @@ A. Try using "-m" when creating the playlists, or setting DOSPLAYLIST as an
 Q. I am requested to have eject when setting the speed although I do not use
    for anything.
 A. If you do not use cdparanoia, eject is used for setting the speed of the 
-   cdrom drive. You can substitute it for "cdset" with "-x" as the argument,
-   but you have to install it manually.
+   cdrom drive. You can substitute it for "setcd" with "-x" as the argument,
+   but you have to install it manually (setcd is, at least, available in 
+   Debian).
    Another way to get the same results is using the pre_read function, defined
    in your /etc/abcde.conf file.
 
@@ -100,6 +145,17 @@ A. Patches are welcome! ;)
    source/free software, it should be fairly easy to integrate. Support for
    AAC (m4p) should be the next one to be introduced.
 
+Q. (Thanks to Amaya) Where are those options and settings defined? Why dont
+   you include a proper abcde.conf as an example?
+A. I do. It should be installed under /etc/abcde.conf and contains more or
+   less all the defaults abcde uses. You can use $(HOME)/.abcde.conf to 
+   override those defaults. More information can be obtained from the man page
+   which can be consulted using "man abcde".
+
+Q. I am running out of disc space.
+A. You have to options. Use -l or define WAVOUTPUTDIR=/some/other/path to your
+   /etc/abcde.conf or ~/.abcde.conf.
+   
 OBSOLETE
 --------
 Q. I set KEEPWAVS to "y" but abcde insists on erasing my directory, along
@@ -108,3 +164,6 @@ A. The default action set includes clean, which cleans the temp directory,
    if nothing goes wrong. Take the "clean" out from the action list and you
    are done.
    UPDATE: KEEPWAVS unselects now the clean action.
+
+--
+Jesus Climent <jesus.climent@hispalinux.es>