This is now tested; both multi-file and single-file modes work fine,
and multi-file is now fully parallelizable.

(flac): Refactor this to encode one wav file to one flac, instead of
looping over all the wavs for a multi-file mode.  This leaves behind
the fa-rip directories instead of cleaning them up; i left a comment
where the cleanup should happen; easy enough to fix.  When creating or
removing files or directories, test for $!{EEXIST} and $!{ENOENT} on
failure rather than stat(2)ing up front.

(flacloop): Move some of the multi-file processing here into our new
Jobs::run get-jobs function; it manages a queue of wav files so we can
fully parallelize even multi-file jobs, instead of having the disc as
the unit of parallelization.

Improve Jobs package:
 - no longer need global @jobs and @finished
 - @finished is gone completely
 - new run function which takes care of all the details; you just give
   it a function to call to get a new job function, and optional
   reportingi functions.

(flacloop): Oops, remove leftover $SIG{CHLD} setting (still UNTESTED).

UNTESTED: Refactor the job parallelization stuff into a generic Jobs package.

Here's a simple hack to split single cue-containing flac files into
single-track flac files.  It's almost entirely a copy/paste of
parts of fa-flacd and flac2mp3; all the common parts really should
be factored out...

Store TRACKNUMBER tag in multi-file mode (oops).

Fix two minor errors.

Fill in release date (today) now that i've tested r1926.

update

Drop the single quotes in printing post-processor args; they may
contain quotes anyway.

Use better identifers and add comments.

Support multi- and single- file modes.

Fix r1932 (i told you it was untested).

Factor out the flac(1)-running part to run_flac, which is identical
in both versions.

WTF!  I just noticed that i forgot the part of hhlp that would
actually create the array reference, but it worked anyway!  Now i
find out perl has autovivified these since at least 2000.  Yet i'm
sure they weren't being autovivified when i had to do something
similar at Lexmark a couple years ago.  Maybe it was a bug in
whatever Perl version i was using, or more likely i was just smoking
crack...

Kill hhlp.

Untested: make multi-file the default with a single-file option.

Here's my hacked up multi-file support.  Needs a lot of cleanup,
and needs to support single-file mode as well.

(newjob): Should be setting $SIG{CHLD} to 'DEFAULT', not 'IGNORE'.
The former happened to work on NetBSD but isn't right, and doesn't
work on Linux 2.6 (was causing system(flac) to return -1).

Make MusicBrainz querying optional (untested).

Oops, support for untagged files was not complete.  Fix.

Update for version 3.

Update CDDEV explanation to talk about MusicBrainz; this was left over
from when this was a zsh script that tried to figure that out itself.

Lose mkcue and require MusicBrainz::Client >= 0.09 (for release dates).

Add support for reading release dates from MusicBrainz.

Thanks to Matthias Friedrich <matt@mafr.de> for adding this to
MusicBrainz::Client::Simple and suggesting it.

Looks like MusicBrainz::Client exposed the TOC info i needed all
along; stop running mkcue and use that instead.

Thanks to Matthias Friedrich <matt@mafr.de> for the suggestion and
demo code.

Add vorbis comment documentation URLs.

Add DISCNUMBER support.

Single-track support broke multi-track.  Fix both.

Match tag names case-insensitively.

Add notes for recent changes.

(flac2mp3): Force track number argument to int.

Don't stupidly take only one argument; take multiple files.

Support single-track FLAC files (no cue sheet).

If the TRACKNUMBER tag is present, use it on the first MP3 file; this
should only be set on a single-track FLAC file.

Don't blow up if any of the tags we look for are not defined; just
don't use them.

(get_tags): http://us.xiph.org/ogg/vorbis/doc/v-comment.html says the
keys are supposed to be case insensitive.

Support multi-artist flac files.

1. Switch to TITLE[n] style tags
2. Support multi-artist discs

(tags_file): Split all the duplicated candidate-tags file writing
stuff from tags into this new function.  It uses TITLE[n] style tags,
and ARTIST[n] tags for multi-artist discs.

(tags): Use tags_file.  If any of the matching MusicBrainz album
objects' has_various_artists function returns true, make a
candidate-tags-0v file with blank ARTIST[n] entries, as well as
putting them in the candidate-tags-$i file.

Document changes for version 2.

(get_tags): Fix TITLE regexp; it was mistakenly not using ^ like the
others.  Also, as follow-up to r1733, document why we don't match = .

(run_or_die): Print command if verbose mode.

(flac2mp3): Pass --quiet and --verbose options to flac and lame as
appropriate.  If --lame-options given, also pass those to lame.
Previously --preset standard was hard-coded, now it is just the
default if --lame-options is not given.

(MAIN): Now take options: --lame-options, -q/--quiet, -v/--verbose,
and -h/--help.

Work around cperl-mode scanning bug.

Add debug mode.

Add support for a post-processor hook.

(fa-flacd):
    Document the hook.

    (flac): Execute and remove the hook if it exists before removing
    the temporary directory.

(fa-rip):
    (make_post_processor): New function to create the post-processor
    file, if defined.

    (MAIN): Take new -p/--post-processor option.

Need the g (global) flag on that substitution operation.

Copy run_or_die from fa-rip and use that to run flac | lame.

Make handling of child process death consistent.

(get_tags): Just match /TITLE/ instead of /TITLE=/, to support the
TITLE[1] .. TITLE[n] tag style.

Note GNU make requirement.

Remove debugging bits accidentally committted.

Add  URL keyword.

Make Getopt::Long behave sanely, as i do elsewhere.

Use Getopt::Long and Pod::Usage instead of Getopt::Std.  As a side
effect, support long options.  Add OPTIONS documentation section.

Collapse fa-rip and fa-tags into a single Perl program, fa-rip.
Fix up the documentation.

Support a -t track-count option to fa-rip and mkcue, so we can skip
stupid data tracks.

No more .toc file now that we use mkcue.

Ah-hah!  I have finally found the bug that caused my mp3s to include a
bit of the next track at the end of one, but only sometimes.  The
hundredths of a second vs. sector was certainly a bug, but was not
this bug.

(get_decode_args): Use sprintf %02d for each field.  Previously i
was just stringing them together with colon and dot, so "9" becomes
"9" instead of "09", which flac sees as 90!

(get_decod_args): The third time field is *sectors*, not hundredths of
a second.  One second is 75 sectors.

Don't count tracks twice.

Use mkcue to make cue sheets, instead of cdrdao.

Sanitize filename sanitization and quoting.  I'm not sure why i was
s/[:'"]/_/g, momentary insanity i suppose.  All i need do is replace /
with _ on output filenames and replace ' with '\'' on filenames that
will go to the shell surrouned by '' quotes, instead of being passed
directly into a program's argv.

fa-flacd:
    (flac): Do / sanitization only, since we're not going through the
    shell, but running flac directly.

flac2mp3:
    (flac2mp3): We weren't sanitizing the input filename; start doing
    so.  Only do ' sanitization for input file and output id3tag
    information, additionally do / sanitization on $outfile.

(get_tags): Properly handle errors from metaflac.

(flac): Whoops, need to use sanitized version in some more places.

(flac): Copy filename sanitization from flac2mp3.

(flac2mp3: Put XXX comment where it belongs.

(flac2mp3): Use for "loop" for s/// filename sanitization.

(reaper): Why was i passing 0 to waitpid?  All the documentation says
to pass -1.  0 worked on NetBSD 1.6 but hangs on 2.0.  Now pass -1 as
we're supposed to.

No longer use CDDBURL environment variable.

Whoops, missed part of fa-tags doc update (SYNOPSIS).

Print usage error message to stderr.

Explain why DATE is never set (MusicBrainz doesn't have it).

De-zsh this so it will work in ksh93 and bash.

Print error message to stderr.

Export CDDEV to the environment if we set it here.

Support CDDEV environment variable.

Update fa-tags documentation.

Reformat requirements and add MusicBrainz::Client.

Reference mktemp -d.

Reference documentation in fa-flacd.

Drop references to abcde and its license.

fa-tags:
    Rewrite in Perl using MusicBrainz::Client::Simple.

fa-rip:
    Adapt to new fa-tags.  Use mktemp(1) to create work directory now
    that we don't have cd-discid.

README:
    No longer need cddb-tool and cd-discid.

(flac2mp3): Put the track number in the filename.

First crack at mp3 transcode script.

Add .PRECIOUS: %.1 so gmake doesn't remove .1 files if you say 'gmake foo.0'.

(fa-flacd.1): Replace this with an implicit rule (%.1: %).

(.1.0): Replace this with a gmake implicit rule (%.0: %.1).

Stop extracting the DATE tag; we only need to treat ARTIST and ALBUM
specially.

(verbose): Use for instead of map.

Clarify abcde dependency; all we need from there is cddb-tool.

Fully automate the install target.

Rename, since i'm about to use some GNU make features.

Use zsh arithmetic for loop instead of jot(1).

(newjob): Perl's fork returns undef for failure, not -1.

(deljob): This was trying to call WIFEXITED, WEXITSTATUS, etc. on the
value returned by WEXITSTATUS.  Oops!

(flac): return 0

(newjob): Child now exits with flac's return value.

Try counting audio track lines in the cue file for the number of the
last track instead of $discid[2].  This seems to work better (so far)
for discs with data tracks.

(get_tags): Catch errors on close.

Change L<> formatting codes for man page references to C<> according
to podchecker(1) recommendations.

Document zsh 4 requirement.

Here's flac-archive, version 1.