add man page for audiocue2bincueHEADmaster

1 files changed, 18 insertions, 5 deletions

diff --git a/miragextract.1 b/miragextract.1
index 6c0a187..e7627d9 100644
--- a/miragextract.1
+++ b/miragextract.1
@@ -1,6 +1,6 @@
 .\" Man page generated from reStructuredText.
 .
-.TH MIRAGEXTRACT 1 "2020-05-12" "0.2.0" "Urchlay"
+.TH MIRAGEXTRACT 1 "2020-05-13" "0.2.0" "Urchlay"
 .SH NAME
 miragextract \- extract audio and data tracks from CD images
 .
@@ -72,7 +72,13 @@ Choices are \fBwav\fP, \fBogg\fP, \fBflac\fP, \fBcdda\fP (raw CD audio).
 Default is \fBwav\fP\&.
 .TP
 .B \-l
-Lists the tracks in the image without extracting them.
+Lists all tracks in the image without extracting them. Currently
+does not combine with \-t, \-a, \-d as expected (you can\(aqt list only
+audio tracks with "\-l \-a" for instance).
+.TP
+.B \-L
+Lists all tracks in the image without extracting them, with
+extra detail (sector sizes, counts, and exact byte sizes).
 .TP
 .B \-n
 Set the base filename to the input filename, minus its extension.
@@ -101,6 +107,8 @@ Takes a track number (1\-99), and extracts only that one track.
 Default behaviour is to extract all tracks.
 .UNINDENT
 .sp
+Option bundling is not supported (e.g. \fB\-d\fP \fB\-s\fP is OK, \fB\-ds\fP is wrong).
+.sp
 Always include a space between an option and its argument (e.g. \fB\-b foo\fP, not \fB\-bfoo\fP).
 .SH NOTES
 .sp
@@ -118,7 +126,7 @@ to convert to mp3.
 Output data tracks will be named to end in \(aq.iso\(aq by default, or \(aq.hfs\(aq
 if they look like Apple disk images (HFS or HFS+), or \(aq.hfs.iso\(aq for
 "hybrid" images that can be mounted as either ISO9660 or HFS/HFS+
-(such as Blizzard\(aqs Mac/PC releases).
+(such as Blizzard\(aqs combined Mac/PC releases).
 .sp
 Images with multiple sessions should be supported, but have not been
 tested. Track numbering just continues, so a disc with 2 sessions of
@@ -160,8 +168,13 @@ Not exactly a bug, per se, but miragextract can\(aqt deal with multi\-file
 images where one of the files is missing or truncated. This is because
 libmirage validates the image when it\(aqs loaded, and is unlikely to change.
 .sp
-Related to the above, there\(aqs no attempt to recover from
-errors. miragextract exits as soon as it encounters an error of any kind.
+Related to the above, there\(aqs no attempt to recover from errors.
+miragextract exits as soon as it encounters an error of any kind.
+.sp
+libmirage (as of version 3.2.4) also doesn\(aqt really support "wav/cue"
+images (or ogg/cue, mp3/cue, etc). If you try to use miragextract on one,
+you\(aqll get advised to try audiocue2bincue(1). When (if) libmirage gains
+support for these, miragextract should handle them just fine.
 .\" EXAMPLES
 .
 .\" ========