More work on musicbrainz support
[abcde.git] / abcde.conf
index df4877c..8a7fcda 100644 (file)
@@ -23,6 +23,7 @@
 # are cached locally in $CDDBLOCALDIR
 #CDDBCOPYLOCAL="n"
 #CDDBLOCALDIR="$HOME/.cddb"
+#CDDBLOCALRECURSIVE="n"
 
 # If NOSUBMIT is set to y, then abcde will never prompt asking if you
 # wish to submit your edited cddb file.
 # so they can be reused when ripping CDs.
 #CDDBUSELOCAL="n"
 
+# List, separated with a comma, the fields we want the parsing function to
+# output. Defaults to YEAR and GENRE, for a complete list of fields provided by
+# CDDB.
+# The fields are not case sensitive. Actually, "y,g" will work as fine as "Y,G"
+# or "YEAR, GENRE"
+#SHOWCDDBFIELDS=year,genre
+
 # Specify the style of encoder to use here - 
 # oggenc, vorbize - for OGGENCODERSYNTAX
 # lame, gogo, bladeenc, l3enc, xingmp3enc, mp3enc - for MP3ENCODERSYNTAX
 #NORMALIZERSYNTAX=default
 
 # CD reader program to use - currently recognized options are 'cdparanoia',
-# 'cdda2wav', 'dagrab' and 'cddafs' (Mac OS X only).
+# 'cdda2wav', 'dagrab', 'cddafs' (Mac OS X only) and 'flac'.
 #CDROMREADERSYNTAX=cdparanoia
 
+# CUE reader program to use.
+# Right now we only support 'mkcue', but this might change in the future.
+#CUEREADERSYNTAX=default
+
 # Keep the wav files after encoding. Set it to "y" and remove "clean" from
 # the list of default actions, since we purge the temp directory as default.
 #KEEPWAVS=n
 
 # Paths of programs to use
 #LAME=lame
+#TOOLAME=toolame
 #GOGO=gogo
 #BLADEENC=bladeenc
 #L3ENC=l3enc
 #CDSPEED=eject
 #VORBISGAIN=vorbisgain
 #MKCUE=mkcue
+#MKTOC=cdrdao
+#DIFF=diff
 
 # Options to call programs with:
 
 
 # MP3:
 #LAMEOPTS=
+#TOOLAMEOPTS=
 #GOGOOPTS=
 #BLADEENCOPTS=
 #L3ENCOPTS=
 #CDSPEEDOPTS="-x"
 #CDSPEEDVALUE=""
 #MKCUEOPTS=""
+#MKTOCOPTS=""
+#DIFFOPTS=""
 #VORBISCOMMENTOPTS="-R"
 #METAFLACOPTS="--no-utf8-convert"
+#DIFFOPTS=""
 
 # Actions to take
 # Comma-separated list of one or more of the following:
 #ACTIONS=cddb,read,encode,tag,move,clean
 
 # CD device you want to read from
+# It can be defined as a singletrack flac file, but since it might change from
+# file to file it makes little sense to define it here.
 #CDROM=/dev/cdrom
 # If we are using the IDE bus, we need CDPARANOIACDROMBUS defined as "d"
 # If we are using the ide-scsi emulation layer, we need to define a "g"
 #LOWDISK=n
 
 # If set to y, enables batch mode normalization, which preserves relative
-# volume differences between tracks of an album. Also enables nogap encoding
-# when using the 'lame' encoder.
-#BATCH=n
+# volume differences between tracks of an album. 
+#BATCHNORM=n
+
+# Enables nogap encoding when using the 'lame' encoder.
+#NOGAP
 
 # Set the playlist file location format. Uses the same variables and format
 # as OUTPUTFORMAT. If the playlist is specified to be in a subdirectory, it
 # * Translate spaces and forward slashes to underscores
 # * Translate stars into pluses.
 # To change that, redefine the mungefilename function.
-# mungefilename recieves the CDDB data (artist, track, title, whatever)
+# mungefilename receives the CDDB data (artist, track, title, whatever)
 # as $1 and outputs it on stdout.
 #mungefilename ()
 #{
 
 # Custom genre munging:
 # By default we just transform uppercase to lowercase. Not much of a fancy
-# function, with not much use, but one can disable it ot just turn the first
+# function, with not much use, but one can disable it or just turn the first
 # Uppercase.
 #mungegenre ()
 #{
 
 # Custom pre-read function
 # By default it does nothing.
-# You can set some things to get abcde funtion in better ways:
+# You can set some things to get abcde function in better ways:
 # * Close the CD tray using eject -t (if available in eject and supported by 
 #   your CD device.
 # * Set the CD speed. You can also use the built-in options, but you can also 
 
 # Custom post-read function
 # By default it does nothing.
-# You can set some things to get abcde funtion in better ways:
+# You can set some things to get abcde function in better ways:
 # * Store a copy of the CD TOC.
 # KEEP IN MIND that executables included in post_read must be in your $PATH or
 # you have to define them with full /path/to/binary
 #REMOTEHOSTS=foo,bar,baz,quux,qiix
 
 # Set to obtain some information about actions happening in the background
-# Usefull if you have a slow network or CDDB servers seem irresponsive.
+# Useful if you have a slow network or CDDB servers seem unresponsive.
 #EXTRAVERBOSE=n