#! /bin/sh /usr/share/dpatch/dpatch-run ## 01_overfiend.dpatch by Branden Robinson ## ## All lines beginning with `## DP:' are a description of the patch. ## DP: Overfiend's giant patch to purge all unholiness from cuetools diff -urN cuetools-1.3-OFFICIAL/doc/cuebreakpoints.1 cuetools-1.3/doc/cuebreakpoints.1 --- cuetools-1.3-OFFICIAL/doc/cuebreakpoints.1 2005-03-22 03:15:25.000000000 -0500 +++ cuetools-1.3/doc/cuebreakpoints.1 2005-08-23 19:26:32.000000000 -0500 @@ -1,46 +1,94 @@ -.TH cuetools 1 -. +.TH cuebreakpoints 1 2005-08-23 "Cuetools 1.3" .SH NAME -cuebreakpoints -. -.SH DESCRIPTION -cuebreakpoints \- print the breakpoints from a cue or toc file -. +cuebreakpoints \- report track breakpoints from a CUE or TOC file .SH SYNOPSIS .B cuebreakpoints -[option...] [file...] -. +[ { +.B \-i +.I format +| +.BR \-\-input\-format =\fIformat\fP +} { +.B \-\-append\-gaps +| +.B \-\-prepend\-gaps +| +.B \-\-split\-gaps +} ] +[ +.I file +\&... ] +.br +.B cuebreakpoints \-\-help +.SH DESCRIPTION +.B cuebreakpoints +reports the track breakpoints found in CUE and TOC files, which are +typically created by compact disc ripping software. +The breakpoints are in a format usable by +.B shnsplit +(part of the shntool package). +.PP +Three approaches to track pregaps are availabe: append (to previous track), +prepend (to succeeding track), and split (from both preceding and +succeeding tracks). +The split approach can result in up to twice as many breakpoints being +reported as there are tracks on the disc. +.PP +The first track's pregap cannot be appended to the previous track, so it is +prefixed to the track in both append and prepend modes. +If you want the track without it, use the +.B \-\-split\-gaps +option. +.PP +If no filenames are specified, +.B cuebreakpoints +reads from standard input, and an input format option +.I must +be specified. +If one or more filenames is provided, but the input format option is not +specified, the input format will be guessed based on each file's suffix +(e.g., +.I .cue +or +.IR .toc ). +This heuristic is case-insensitive. .SH OPTIONS .TP -.B \-h, \--help -print usage information -. +.BR \-h ", " \-\-help +displays a usage message and exits. .TP -.B \-i, \--input-format cue|toc -set format of file(s) -. +.BR \-i " \fIformat\fP, " \-\-input\-format=\fIformat\fP +sets the expected format of the input file(s) to +.IR format , +which must be either +.B cue +or +.BR toc . .TP -.B \--append-gaps -append pregaps to previous track (default) -. +.B \-\-append\-gaps +appends pregaps to the end of the previous track. +This is the default. .TP -.B \--prepend-gaps -prefix pregaps to track -. +.B \-\-prepend\-gaps +prefixes pregaps to the beginning of each subsequent track. .TP -.B \--split-gaps -split at beginning and end of pregaps -. -.SH NOTES -The breakpoints are in a format usable by shnsplit (part of the shntool package). +.B \-\-split\-gaps +separates pregaps from both the preceding and succeeding tracks. .PP -The first track's pregap cannot be appended to the previous track, so it is prefixed to the track in both append and prepend modes. If you want the track without it, use the split mode. -.PP -If no files are specified, stdin is used. If a filename is specified and the format is not specified, the format will be set based on a ".cue" or ".toc" suffix. -. +If more than one of +.BR \-\-append\-gaps , +.BR \-\-prepend\-gaps , +and +.B \-\-split\-gaps +are specified, all except the last encountered are ignored. +.SH "EXIT STATUS" +.B cuebreakpoints +exits with status zero if it successfully generates a report for each +input file, and nonzero if there were problems. .SH AUTHOR -Svend Sorensen -. +Cuetools was written by Svend Sorensen. +Branden Robinson contributed fixes and enhancements to the utilities and +documentation. .SH "SEE ALSO" -cueconvert(1), -cueprint(1) +.BR cueconvert (1), +.BR cueprint (1) diff -urN cuetools-1.3-OFFICIAL/doc/cueconvert.1 cuetools-1.3/doc/cueconvert.1 --- cuetools-1.3-OFFICIAL/doc/cueconvert.1 2005-03-22 03:15:25.000000000 -0500 +++ cuetools-1.3/doc/cueconvert.1 2005-08-23 18:23:23.000000000 -0500 @@ -1,34 +1,79 @@ -.TH cuetools 1 -. +.TH cueconvert 1 2005-08-23 "Cuetools 1.3" .SH NAME -cueconvert -. -.SH DESCRIPTION -cueconvert \- convert between the cue and toc formats -. +cueconvert \- convert files between CUE and TOC formats .SH SYNOPSIS .B cueconvert -[option...] [infile [outfile]] -. +[ +.B \-i +.I format +| +.BR \-\-input\-format =\fIformat\fP +] [ +.B \-o +.I format +| +.BR \-\-output\-format =\fIformat\fP +] [ +.I infile +[ +.I outfile +] ] +.br +.B cueconvert \-\-help +.SH DESCRIPTION +.B cueconvert +coverts files between the CUE and TOC formats, each of which are commonly +used by compact disc ripping software to denote track breakpoints and other +data. +.PP +The operands are optional; if +.I infile +is not specified, +.B cueconvert +reads from standard input, and if +.I outfile +is not specified, it writes to standard output. +.PP +If no filenamess are specified, standard input is used, and an input format +option +.I must +be specified. +The complementary format is used for output. +.PP +If filenames are provided, but format options are not specified, +the input and output formats will be guessed based on each filename's +suffix (e.g., +.I .cue +or +.IR .toc ). +This heuristic is case-insensitive. .SH OPTIONS .TP -.B \-h, \--help -print usage information -. +.BR \-h ", " \-\-help +displays a usage message and exits. .TP -.B \-i, \--input-format cue|toc -set format of input file -. +.BR \-i " \fIformat\fP, " \-\-input\-format=\fIformat\fP +sets the expected format of the input file to +.IR format . .TP -.B \-o, \--output-format cue|toc -set format of output file -. -.SH NOTES -If infile or outfile is not specified, stdin and stdout are used, respectively. If a filename is specified and the format is not specified, the format will be set based on a ".cue" or ".toc" suffix. If the output file format is not specified, and it cannot be determined from the suffix, it will be set to the opposite of the input format. -. +.BR \-o " \fIformat\fP, " \-\-output\-format=\fIformat\fP +sets the format of the generated output file to +.IR format . +.PP +The option argument +.I format +must be either +.B cue +or +.BR toc . +.SH "EXIT STATUS" +.B cueconvert +exits with status zero if it successfully coverts the input file, and +nonzero if there were problems. .SH AUTHOR -Svend Sorensen -. +Cuetools was written by Svend Sorensen. +Branden Robinson contributed fixes and enhancements to the utilities and +documentation. .SH "SEE ALSO" -cuebreakpoints(1), -cueprint(1) +.BR cuebreakpoints (1), +.BR cueprint (1) diff -urN cuetools-1.3-OFFICIAL/doc/cueprint.1 cuetools-1.3/doc/cueprint.1 --- cuetools-1.3-OFFICIAL/doc/cueprint.1 2005-03-22 03:15:25.000000000 -0500 +++ cuetools-1.3/doc/cueprint.1 2005-08-23 19:28:09.000000000 -0500 @@ -1,198 +1,186 @@ -.TH cuetools 1 -. +.TH cueprint 1 2005-08-23 "Cuetools 1.3" .SH NAME -cueprint -. -.SH DESCRIPTION -cueprint \- print disc and track infomation for a cue or toc file -. +cueprint \- report disc and track infomation from a CUE or TOC file .SH SYNOPSIS .B cueprint -[option...] [file...] -. -.SH OPTIONS -.TP -.B \-h, \--help -print usage information -. -.TP -.B \-i, \--input-format cue|toc -set format of file(s) -. -.TP -.B \-n, \--track-number -only print track information for single track. The default is to print information for all tracks. -. -.TP -.B \-d, \--disc-template