r121@frost: data | 2005-08-19 00:00:16 +0300
[clinton/abcde.git] / abcde.1
diff --git a/abcde.1 b/abcde.1
index 3f5326f..8e5e62c 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
 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.
 .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
 "-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\'.
 .B OGGENCODERSYNTAX
 Specifies the style of encoder to use for the Ogg/Vorbis encoder. Valid options 
 are \'oggenc\' (default for Ogg/Vorbis) and \'vorbize\'.
@@ -239,7 +247,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 
 .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.
 .TP
 .B INTERACTIVE
 Set to "n" if you want to perform automatic rips, without user intervention.
@@ -276,6 +284,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
 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
 .B OUTPUTDIR
 Specifies the directory to place completed tracks/playlists in.
 .TP
@@ -378,16 +390,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
 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
 .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
 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
 .TP
 .B abcde
 Will work in most systems