cuerecover: add -o option, detect MODE1/2048

1 files changed, 18 insertions, 11 deletions

diff --git a/cuerecover.rst b/cuerecover.rst
index d4d932b..813ed4c 100644
--- a/cuerecover.rst
+++ b/cuerecover.rst
@@ -24,15 +24,13 @@ generate .cue file for CD image .bin
 SYNOPSIS
 ========
 
-cuerecover [-s sec] **bin-file** [**bin-file** ...]
+cuerecover [-o output] [-s sec] [-t thresh] **bin-file** [**bin-file** ...]
 
 DESCRIPTION
 ===========
 
 cuerecover attempts to generate a usable cue sheet for CD images which
-are missing their .cue (or .ccd, .mds, etc) files. The generated cue
-sheet is written to standard output [*], so add e.g. "> filename.cue"
-to redirect it to a file.
+are missing their .cue (or .ccd, .mds, etc) files.
 
 If a single .bin file is given, it's assumed to hold all the tracks (which
 might only be one). If multiple .bin files are given, each one is assumed to
@@ -59,19 +57,27 @@ OPTIONS
 --help
              Print short usage string.
 
+-o <file>    Write cue file to *file* rather than standard output. If
+             *file* already exists, cuerecover will refuse to overwrite it,
+             which makes this safer than redirecting stdout.
+
 -s <sec>     Minimum amount of silence for detecting the split point between
-             two audio tracks (default: 2). Argument is in seconds, and
-             non-integers are allowed. 0 means to disable splitting tracks:
-             all the audio tracks will be combined into one in the .cue
-             sheet. This option is ignored when multiple .bin file arguments
-             are given, since they're already split into tracks.
+             two audio tracks. Argument is in seconds, and decimals
+             are allowed. The default is 2, which is the standard sized
+             gap between tracks in the Redbook standard and in most CD
+             authoring software. 0 means to disable splitting tracks:
+             all the audio tracks will be combined into one in the
+             .cue sheet. This option is ignored when multiple .bin file
+             arguments are given, since they're already split into tracks.
 
 -t <thresh>  Silence threshold, 0 to 100. Default is 0. This is
              the percentage of non-zero bytes allowed in a sector for it
              to be considered silent. Sometimes audio tracks have random
              data in the pregap (before the INDEX 01), which will fool
              cuerecover into thinking there's no pregap. This option can
-             help with those, but don't set it too high.
+             help with those, but don't set it too high. This option is ignored
+             when multiple .bin file arguments are given, since they're already
+             split into tracks.
 
 -v           Verbose mode. Prints (on stderr) some extra messages about what
              cuerecover is doing. Probably only of interest to the author.
@@ -96,7 +102,8 @@ assumptions. These are usually valid, but should be mentioned here:
 - If there's a data track, it's a raw image (2352 bytes per sector, includes
   the sync pulse, address, CRC, ECC, etc). If the data track was stored as
   'cooked' data (2048 bytes/sector, MODE1/2048 in the original .cue file),
-  it'll be treated as an audio track. You can check for this by trying to
+  it'll be treated as an audio track, and you'll get a warning that it
+  looks like 'cooked' data. You can check for this by trying to
   mount the .bin file as an ISO or HFS image: if it mounts, the first
   track is 'cooked'. It'll also be obvious if you use the .cue sheet to
   extract the image into files: ISO images don't sound musical at all!