From 93f975db15e56a1a423c40d65e1627ac888d42b0 Mon Sep 17 00:00:00 2001 From: "B. Watson" Date: Wed, 13 May 2020 03:39:24 -0400 Subject: add man page for audiocue2bincue --- miragextract.1 | 23 ++++++++++++++++++----- 1 file changed, 18 insertions(+), 5 deletions(-) (limited to 'miragextract.1') 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 . .\" ======== -- cgit v1.2.3