miragextract: detect hybrid iso/mac data tracks

1 files changed, 29 insertions, 27 deletions

diff --git a/miragextract.rst b/miragextract.rst
index 9ac2048..fef2611 100644
--- a/miragextract.rst
+++ b/miragextract.rst
@@ -39,40 +39,41 @@ OPTIONS
 --help
        Print short usage string.
 
--a     Extract only audio tracks. Default is to extract all tracks.
+-a           Extract only audio tracks. Default is to extract all tracks.
 
--b     Sets the base filename for the output files. Default is 'track'.
-       Can be prefixed with a directory to write files in that dir,
-       but the dir must already exist (example: -b extracted/track). See
-       also the -n option.
+-b <name>    Sets the base filename for the output files. Default is **track**.
+             Can be prefixed with a directory to write files in that dir,
+             but the dir must already exist (example: -b extracted/track). See
+             also the -n option.
 
--d     Extract only data tracks. Default is to extract all tracks.
+-d           Extract only data tracks. Default is to extract all tracks.
 
--f     Sets the format and filename extension for the output audio files.
-       Choices are **wav**, **ogg**, **flac**, **cdda** (raw CD audio). Default is **wav**.
+-f           Sets the format and filename extension for the output audio files.
+             Choices are **wav**, **ogg**, **flac**, **cdda** (raw CD audio).
+             Default is **wav**.
 
--l     Lists the tracks in the image without extracting them.
+-l           Lists the tracks in the image without extracting them.
 
--n     Set the base filename to the input filename, minus its extension.
-       E.g. for foo.cue, this is the same as saying "-b foo". Beware of
-       using input filenames with directory separators in them: the output files
-       will be written in the same dir as the input file. Hopefully you
-       have permission to write there.
+-n           Set the base filename to the input filename, minus its extension.
+             E.g. for foo.cue, this is the same as saying "-b foo". Beware of
+             using input filenames with directory separators in them: the output files
+             will be written in the same dir as the input file. Hopefully you
+             have permission to write there.
 
--p     Password for encrypted images. Note that anyone who can run **ps(1)**
-       on your system may be able to view the password. Also note that password
-       support in miragextract is *completely* untested: I have no
-       encrypted images to test with.
+-p <passwd>  Password for encrypted images. Note that anyone who can run **ps(1)**
+             on your system may be able to view the password. Also note that password
+             support in miragextract is *completely* untested: I have no
+             encrypted images to test with.
 
--q     Quality setting for ogg and flac output files. Integer from 0
-       to 10. Default is 7. Has very little effect on flac, and no effect on
-       wav or cdda output.
+-q <qual>    Quality setting for ogg and flac output files. Integer from 0
+             to 10. Default is 7. Has very little effect on flac, and no effect on
+             wav or cdda output.
 
--s     Swaps bytes in audio tracks. Use this if your audio files sound
-       like white noise or gibberish.
+-s           Swaps bytes in audio tracks. Use this if your audio files sound
+             like white noise or gibberish.
 
--t     Takes a track number (1-99), and extracts only that one track.
-       Default behaviour is to extract all tracks.
+-t <track>   Takes a track number (1-99), and extracts only that one track.
+             Default behaviour is to extract all tracks.
 
 Always include a space between an option and its argument (e.g. **-b foo**, not **-bfoo**).
 
@@ -90,8 +91,9 @@ match the encoding set with -f. Note that mp3 is NOT a valid -f option.
 If you need mp3, extract to .wav and then use a tool like lame or ffmpeg
 to convert to mp3.
 
-Output data tracks will be named to end in '.iso', or '.dmg' if they look
-like Apple disk images.
+Output data tracks will be named to end in '.iso' by default, or '.hfs'
+if they look like Apple disk images, or '.hfs.iso' for "hybrid" images
+that can be mounted as either (such as Blizzard's Mac/PC releases).
 
 Images with multiple sessions should be supported, but have not been
 tested. Track numbering just continues, so a disc with 2 sessions of