Remove broken debug print, whoops
[clinton/abcde.git] / FAQ
diff --git a/FAQ b/FAQ
index 5530971..8e136ae 100644 (file)
--- a/FAQ
+++ b/FAQ
@@ -3,8 +3,10 @@
 
 Q. Who created abcde? Who develops it nowadays?
 A. It was originally created by Robert Woodcook. He decided to give up 
-   maintaining it at some point in 2002 and Jesus Climent took over.  Contact
-   jesus.climent@hispalinux.es if you have a problem or a suggestion.
+   maintaining it at some point in 2002 and Jesus Climent took over. In 2012,
+   Colin Tuckley and Steve McIntyre joined in to help. Contact
+   jesus.climent@hispalinux.es, colint@debian.org or 93sam@debian.org if you
+   have a problem or a suggestion.
 
 
 1. INSTALLATION
@@ -14,7 +16,7 @@ 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
+   source and install the complementary programs (abcde is just a frontend
    and its functionality is provided by other programs).
 
    abcde needs cd-discid. Grab it from:
@@ -24,7 +26,7 @@ A. To get abcde you can use a pre-packaged version, available for Debian,
 
 Q. I have a problem, and I reported some time ago. Have you solved it already?
 A. Maybe. Try downloading the trunk of the development from 
-   http://svn.hispalinux.es/svn/abcde/trunk
+   http://abcde.googlecode.com/svn/trunk/
    
 Q. When are you going to release a new version?
 A. When it is ready. I keep on having new ideas and adding them to the trunk
@@ -114,13 +116,13 @@ A. Use the OUTPUT variable in PLAYLISTFORMAT and OUTPUTFORMAT. It holds the
 
 Q. I have a CD with a data track, and abcde complaints it cannot read/encode
    it.
-A. It is not easy to find a data track on a CD. Right now, I can only think
+A. From version 2.2 onwards, abcde includes some checkings with cdparanoia, to
+   try to get this right.
+   (It is not easy to find a data track on a CD. Right now, I can only think
    of getting the track info from CDDB and ask the user for continuing should
    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.
-   From version 2.2 onwards, abcde includes some checkings with cdparanoia, to
-   try to get this right.
+   specifying the tracks to be encoded, leaving out the data one).
 
 Q. I am requested to have "eject" when setting the speed although I do not use
    it for anything.
@@ -146,11 +148,18 @@ A. Set abcde to rip the first CD and give it the option "-t 101". Use a generic
    name and the tag/comment information.
 
 Q. I have a live concert. I want to encode it in a single file. How do i do it?
-A. Use "-1" and it will be encoded in a single file. Use "-M" to make a CUE
-   sheet file where the information about the tracks is stored.
+A. Use "-1" and it will be encoded in a single file. Use "cue" as an action to
+   make a CUE sheet file where the information about the tracks is stored.
+
+Q. Can I use abcde to take a backup of my CD collection?
+A. Yes. Use "abcde -1 -o flac -a default,cue" and it will create a single-track
+   FLAC file with an embedded cuesheet. Later on, you can use the command
+   "abcde -o vorbis -d flac-file.flac" to extract the individual tracks in
+   Ogg/Vorbis format. Of course you can select whatever format you want.
+   
 
-3. CDDB
-   ====
+3. CDDB and Musicbrainz
+   ====================
 
 Q. I need to go through an HTTP proxy for CDDB access. 
 A. No problem, just export your http_proxy variable first so wget/fetch/curl 
@@ -170,6 +179,13 @@ Q. How can I use some other CDDB information provider?
 A. abcde now uses FreeDB by default. To use a different FreeDB mirror or 
    another CDDB service, change the CDDBURL option in your abcde.conf.
 
+Q. After requesting CDDB data, I received several answers which seem to be
+   quite alike. Can I find out the difference between some of them?
+A. Yes. When asked which one you want to select, use "X,Y" where X and Y are
+   the numbers of the selections you want to find the difference between.
+
+Q. I don't like CDDB/FreeDB. How can I use Musicbrainz instead?
+A. Set CDDBMETHOD=musicbrainz and try it!
 
 3. FORMATS
    =======
@@ -238,9 +254,9 @@ 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
    installed. I have placed a basic support, but some user reports are just
    complaining about abcde not encoding the ripped tracks, as if 
-   cdda2wav/cdparanoia/cddafs would never end reading them. If you have such
-   a system and experience problems, please, report them, and I will try to
-   work them out with your help.
+   icedax/cdda2wav/cdparanoia/cddafs would never end reading them. If you have
+   such a system and experience problems, please, report them, and I will
+   try to work them out with your help.
 
 Q. My hardware player (put it here) does not recognize the playlists created
    with abcde. What I am doing wrong?