Minor typos.
[clinton/abcde.git] / FAQ
diff --git a/FAQ b/FAQ
index 7e934bc..5504bf7 100644 (file)
--- a/FAQ
+++ b/FAQ
@@ -14,24 +14,42 @@ 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
 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).
    and its functionality is provided by other programs).
-   Read 
 
    abcde needs cd-discid. Grab it from:
    http://www.hispalinux.es/~data/files/cd-discid/
 
    Read the README files for a complete list of requirements.
 
    abcde needs cd-discid. Grab it from:
    http://www.hispalinux.es/~data/files/cd-discid/
 
    Read the README files for a complete list of requirements.
+
+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 
+   https://subversion.pumuki.org/svn/abcde/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
+   (stored in the URL above), so I dont release until all the ideas are
+   finished.
+
 
 2. EXECUTION
    =========
 
 
 2. EXECUTION
    =========
 
+Q. I want to force abcde 2.x to behave more like 1.x. How do I do it?
+A. Put these options in your abcde.conf:
+
+   INTERACTIVE=n
+   OUTPUTTYPE=mp3
+   ID3TAGV=1
+
 Q. Low on disk space?
 A. abcde has different algorithms to schedule ripping and encoding - to 
    optimize for disk conservation, use -l. You can also define
    WAVOUTPUTDIR=/some/other/path to your /etc/abcde.conf or ~/.abcde.conf to
    store the WAV files on another NFS shared fisk, for example.
 Q. Low on disk space?
 A. abcde has different algorithms to schedule ripping and encoding - to 
    optimize for disk conservation, use -l. You can also define
    WAVOUTPUTDIR=/some/other/path to your /etc/abcde.conf or ~/.abcde.conf to
    store the WAV files on another NFS shared fisk, for example.
+   Also, UNIX pipes have also been implemented, using "-P", so abcde reads and
+   encodes the tracks from the CD at once. However, it has the drawback that
+   only one format can be encoded at a time.
 
 Q. How can i make abcde encode faster? My CD reader is way faster than the pace
    it can encode my tracks.
 
 Q. How can i make abcde encode faster? My CD reader is way faster than the pace
    it can encode my tracks.
@@ -44,10 +62,11 @@ A. abcde can take advantage of SMP systems, just like make. Try 'abcde -j 2' -
    address). Use this in combination with '-j 0' to shift all encoding off the
    local machine.
 
    address). Use this in combination with '-j 0' to shift all encoding off the
    local machine.
 
-Having trouble getting cdparanoia to read from your drive as a user?  Add
-yourself to the cdrom group, change the permissions on your cdrom device to 660,
-and if you have a SCSI cdrom drive, check the permissions on
-/dev/sg* as well.
+Q. I am having problems with *my CD reading program* reading the drive as a
+   user.
+A. You might have to add yourself (or the users who want to use abcde) to the
+   cdrom group and change the permissions of the cdrom device to 660. If you
+   have a SCSI cdrom drive, check the permissions of /dev/sg* as well.
 
 Q. I would like to give the trackname and the artist_name directly to the
    encoder (in my case oggenc), but found no documentation.
 
 Q. I would like to give the trackname and the artist_name directly to the
    encoder (in my case oggenc), but found no documentation.
@@ -95,13 +114,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.
 
 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
    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.
-   Version 2.2 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.
 
 Q. I am requested to have "eject" when setting the speed although I do not use
    it for anything.
@@ -119,11 +138,23 @@ A. Set abcde to rip the first CD and give it the option "-t 101". Use a generic
    entries. Use "-t 201" for the second CD and so on. Use "-w <comment>" to
    add a comment about the CD you are ripping (-w "disc #"). Alternatively you
    can use only the "-t ###" option and then move all the files to the same
    entries. Use "-t 201" for the second CD and so on. Use "-w <comment>" to
    add a comment about the CD you are ripping (-w "disc #"). Alternatively you
    can use only the "-t ###" option and then move all the files to the same
-   directory. If you want the tagged track number to be set to the modified
-   number you should use "-T ###".
+   directory, but the tag/comment information on the files will differ. If you
+   want the tagged track number to be set to the modified number you should use
+   "-T ###". 
+   Even better! If you use "-W <cd_number>", abcde will put a comment to every
+   CD set ("CD <number>") and modify the number of the tracks both in the file
+   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?
 
 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.
+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
    ====
@@ -146,6 +177,11 @@ 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.
 
 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.
+
 
 3. FORMATS
    =======
 
 3. FORMATS
    =======
@@ -178,14 +214,14 @@ A. Since MP3 is considered non-free (you get it for free, but hardware players
    now. For that reason some people prefer to encode to MP3.
 
    UPDATE *** UPDATE
    now. For that reason some people prefer to encode to MP3.
 
    UPDATE *** UPDATE
-   There are at least 3 known brands already selling Ogg/Vorbis portable
-   players: Rio, iRiver and Neuros.
+   There are known brands already selling Ogg/Vorbis portable players: Rio,
+   iRiver, Neuros, iAudio,...
    Go buy one and you have no more reasons to use MP3.
    
    If you are among those individuals, you might need to add support for MP3
    encoding to your system:
    Go buy one and you have no more reasons to use MP3.
    
    If you are among those individuals, you might need to add support for MP3
    encoding to your system:
-   Debian : check http://marillat.free.fr to install lame in your system.
-            others prefer bladeenc. Check www.apt-get.org or google.
+   Debian : check http://ftp.nerim.net/debian-marillat to install lame in your
+            system. Others prefer bladeenc. Check www.apt-get.org or google.
    RedHat : search on rpmfind.net
    FreeBSD: By default includes LAME support.
    OpenBSD: Available by specifying you want to install the port with LAME
    RedHat : search on rpmfind.net
    FreeBSD: By default includes LAME support.
    OpenBSD: Available by specifying you want to install the port with LAME