From 9f9315b3b9bdb232d0261bf8da8e431a4591f329 Mon Sep 17 00:00:00 2001 From: "B. Watson" Date: Tue, 12 May 2020 01:50:45 -0400 Subject: auto-regenerate man/html pages --- cuerecover.1 | 32 ++++++++++++++++++++------------ 1 file changed, 20 insertions(+), 12 deletions(-) (limited to 'cuerecover.1') diff --git a/cuerecover.1 b/cuerecover.1 index 0f72d89..7395e91 100644 --- a/cuerecover.1 +++ b/cuerecover.1 @@ -1,6 +1,6 @@ .\" Man page generated from reStructuredText. . -.TH CUERECOVER 1 "2020-05-11" "0.1.0" "Urchlay" +.TH CUERECOVER 1 "2020-05-12" "0.1.0" "Urchlay" .SH NAME cuerecover \- generate .cue file for CD image .bin . @@ -42,13 +42,11 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] . .SH SYNOPSIS .sp -cuerecover [\-s sec] \fBbin\-file\fP [\fBbin\-file\fP ...] +cuerecover [\-o output] [\-s sec] [\-t thresh] \fBbin\-file\fP [\fBbin\-file\fP ...] .SH DESCRIPTION .sp 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. .sp If a single .bin file is given, it\(aqs assumed to hold all the tracks (which might only be one). If multiple .bin files are given, each one is assumed to @@ -74,13 +72,20 @@ messages are printed to standard error. .B \-\-help Print short usage string. .TP +.BI \-o \ +Write cue file to \fIfile\fP rather than standard output. If +\fIfile\fP already exists, cuerecover will refuse to overwrite it, +which makes this safer than redirecting stdout. +.TP .BI \-s \ 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\(aqre 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\(aqre already split into tracks. .TP .BI \-t \ Silence threshold, 0 to 100. Default is 0. This is @@ -88,7 +93,9 @@ 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\(aqs no pregap. This option can -help with those, but don\(aqt set it too high. +help with those, but don\(aqt set it too high. This option is ignored +when multiple .bin file arguments are given, since they\(aqre already +split into tracks. .TP .B \-v Verbose mode. Prints (on stderr) some extra messages about what @@ -114,7 +121,8 @@ data tracks that aren\(aqt the first track on the disc. If there\(aqs a data track, it\(aqs a raw image (2352 bytes per sector, includes the sync pulse, address, CRC, ECC, etc). If the data track was stored as \(aqcooked\(aq data (2048 bytes/sector, MODE1/2048 in the original .cue file), -it\(aqll be treated as an audio track. You can check for this by trying to +it\(aqll be treated as an audio track, and you\(aqll get a warning that it +looks like \(aqcooked\(aq 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 \(aqcooked\(aq. It\(aqll also be obvious if you use the .cue sheet to extract the image into files: ISO images don\(aqt sound musical at all! -- cgit v1.2.3