From 93f975db15e56a1a423c40d65e1627ac888d42b0 Mon Sep 17 00:00:00 2001
From: "B. Watson" <yalhcru@gmail.com>
Date: Wed, 13 May 2020 03:39:24 -0400
Subject: add man page for audiocue2bincue

---
 miragextract.html | 23 +++++++++++++++++------
 1 file changed, 17 insertions(+), 6 deletions(-)

(limited to 'miragextract.html')

diff --git a/miragextract.html b/miragextract.html
index 677bd2c..04940bc 100644
--- a/miragextract.html
+++ b/miragextract.html
@@ -5,7 +5,7 @@
 <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
 <meta name="generator" content="Docutils 0.14: http://docutils.sourceforge.net/" />
 <title>miragextract</title>
-<meta name="date" content="2020-05-12" />
+<meta name="date" content="2020-05-13" />
 <style type="text/css">
 
 /*
@@ -373,7 +373,7 @@ ul.auto-toc {
 <tr class="manual-group field"><th class="docinfo-name">Manual group:</th><td class="field-body">Urchlay</td>
 </tr>
 <tr><th class="docinfo-name">Date:</th>
-<td>2020-05-12</td></tr>
+<td>2020-05-13</td></tr>
 <tr><th class="docinfo-name">Version:</th>
 <td>0.2.0</td></tr>
 </tbody>
@@ -421,7 +421,13 @@ Choices are <strong>wav</strong>, <strong>ogg</strong>, <strong>flac</strong>, <
 Default is <strong>wav</strong>.</td></tr>
 <tr><td class="option-group">
 <kbd><span class="option">-l</span></kbd></td>
-<td>Lists the tracks in the image without extracting them.</td></tr>
+<td>Lists all tracks in the image without extracting them. Currently
+does not combine with -t, -a, -d as expected (you can't list only
+audio tracks with &quot;-l -a&quot; for instance).</td></tr>
+<tr><td class="option-group">
+<kbd><span class="option">-L</span></kbd></td>
+<td>Lists all tracks in the image without extracting them, with
+extra detail (sector sizes, counts, and exact byte sizes).</td></tr>
 <tr><td class="option-group">
 <kbd><span class="option">-n</span></kbd></td>
 <td>Set the base filename to the input filename, minus its extension.
@@ -450,6 +456,7 @@ like white noise or gibberish.</td></tr>
 Default behaviour is to extract all tracks.</td></tr>
 </tbody>
 </table>
+<p>Option bundling is not supported (e.g. <strong>-d</strong> <strong>-s</strong> is OK, <strong>-ds</strong> is wrong).</p>
 <p>Always include a space between an option and its argument (e.g. <strong>-b foo</strong>, not <strong>-bfoo</strong>).</p>
 </div>
 <div class="section" id="notes">
@@ -465,7 +472,7 @@ to convert to mp3.</p>
 <p>Output data tracks will be named to end in '.iso' by default, or '.hfs'
 if they look like Apple disk images (HFS or HFS+), or '.hfs.iso' for
 &quot;hybrid&quot; images that can be mounted as either ISO9660 or HFS/HFS+
-(such as Blizzard's Mac/PC releases).</p>
+(such as Blizzard's combined Mac/PC releases).</p>
 <p>Images with multiple sessions should be supported, but have not been
 tested. Track numbering just continues, so a disc with 2 sessions of
 8 files each will have tracks numbered 1 to 16 as far as the -t option
@@ -492,8 +499,12 @@ play -x -t cdda track01.cdda
 <p>Not exactly a bug, per se, but miragextract can't deal with multi-file
 images where one of the files is missing or truncated. This is because
 libmirage validates the image when it's loaded, and is unlikely to change.</p>
-<p>Related to the above, there's no attempt to recover from
-errors. miragextract exits as soon as it encounters an error of any kind.</p>
+<p>Related to the above, there's no attempt to recover from errors.
+miragextract exits as soon as it encounters an error of any kind.</p>
+<p>libmirage (as of version 3.2.4) also doesn't really support &quot;wav/cue&quot;
+images (or ogg/cue, mp3/cue, etc). If you try to use miragextract on one,
+you'll get advised to try audiocue2bincue(1). When (if) libmirage gains
+support for these, miragextract should handle them just fine.</p>
 <!-- EXAMPLES -->
 <!-- ======== -->
 </div>
-- 
cgit v1.2.3