r168@frost: data | 2005-09-19 10:27:33 +0300
[abcde.git] / abcde.1
diff --git a/abcde.1 b/abcde.1
index 3f5326f..85831f3 100644 (file)
--- a/abcde.1
+++ b/abcde.1
@@ -116,6 +116,10 @@ the REMOTEHOSTS configuration variable.
 Add replaygain information to the id3 or tag information for play
 normalization. Only works with MP3 and Ogg/Vorbis.
 .TP
+.B \-s [fields...]
+List, separated by comas, the fields to be shown in the CDDB parsed entries.
+Right now it only uses "year" and "genre".
+.TP
 .B \-S [speed]
 Set the speed of the CD drive. Needs CDSPEED and CDSPEEDOPTS set properly
 and both the program and device must support the capability.
@@ -197,6 +201,10 @@ Actually use the stored copies of the CDDB entries. Can be overriden using the
 "-L" flag (if is CDDBUSELOCAL in "n"). If an entry is found, we always give 
 the choice of retrieving a CDDB entry from the internet.
 .TP
+.B SHOWCDDBFIELDS
+Coma-separated list of fields we want to parse during the CDDB parsing.
+Defaults to "year,genre".
+.TP
 .B OGGENCODERSYNTAX
 Specifies the style of encoder to use for the Ogg/Vorbis encoder. Valid options 
 are \'oggenc\' (default for Ogg/Vorbis) and \'vorbize\'.
@@ -231,6 +239,10 @@ Specifies the style of cdrom reader to use. Valid options are \'cdparanoia\'
 and \'debug\'. It is used for querying the CDROM and obtain a list of valid
 tracks and DATA tracks. Right now, only cdparanoia is supported.
 .TP
+.B CUEREADERSYNTAX
+Specifies the syntax of the program we use to read the CD CUE sheet. Right now
+we only support \'mkcue\', but in the future other readers might be used.
+.TP
 .B KEEPWAVS
 It defaults to no, so if you want to keep those wavs ripped from your CD,
 set it to "y". You can use the "-k" switch in the command line. The default
@@ -239,7 +251,7 @@ files even you have requested the "clean" action.
 .TP
 .B PADTRACKS
 If set to "y", it adds 0's to the file numbers to complete a two-number 
-holder. Usefull when encoding tracks 1-9.
+holder. Useful when encoding tracks 1-9.
 .TP
 .B INTERACTIVE
 Set to "n" if you want to perform automatic rips, without user intervention.
@@ -276,6 +288,10 @@ The default actions to be performed when reading a disc.
 If set, it points to the CD-Rom device which has to be used for audio
 extraction. Abcde tries to guess the right device, but it may fail.
 .TP
+.B CDPARANOIACDROMBUS
+Defined as "d" when using cdparanoia with an IDE bus and as "g" when using
+cdparanoia with the ide-scsi emulation layer.
+.TP
 .B OUTPUTDIR
 Specifies the directory to place completed tracks/playlists in.
 .TP
@@ -378,16 +394,22 @@ for the first time, during abcde execution. It can be used to close the CDROM
 tray, to set its speed (via "setcd" or via "eject", if available) and other
 preparation actions. The default function is empty.
 .TP
+.B post_read
+post_read () is a shell function which is executed after the CDROM is read
+(and, if applies, before the CDROM is ejected). It can be used to read a TOC
+from the CDROM, or to try to read the DATA areas from the CD (if any exist).
+The default function is empty.
+.TP
 .B EJECTCD
 If set to "y", abcde will call eject(1) to eject the cdrom from the drive
 after all tracks have been read.
 .TP
 .B EXTRAVERBOSE
 If set to "y", some operations which are usually now shown to the end user
-are visible, such as CDDB queries. Usefull for initial debug and if your
+are visible, such as CDDB queries. Useful for initial debug and if your
 network/CDDB server is slow.
 .SH EXAMPLES
-Possible ways one can call abcdeÑ
+Possible ways one can call abcde
 .TP
 .B abcde
 Will work in most systems