diff options
Diffstat (limited to 'audio/mktoc/mktoc.1')
| -rw-r--r-- | audio/mktoc/mktoc.1 | 257 |
1 files changed, 257 insertions, 0 deletions
diff --git a/audio/mktoc/mktoc.1 b/audio/mktoc/mktoc.1 new file mode 100644 index 0000000000..1da933e170 --- /dev/null +++ b/audio/mktoc/mktoc.1 @@ -0,0 +1,257 @@ +.\" Man page generated from reStructuredText. +. +.TH MKTOC 1 "2018-01-11" "1.3" "SlackBuilds.org" +.SH NAME +mktoc \- create TOC files for audio CDs +. +.nr rst2man-indent-level 0 +. +.de1 rstReportMargin +\\$1 \\n[an-margin] +level \\n[rst2man-indent-level] +level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] +- +\\n[rst2man-indent0] +\\n[rst2man-indent1] +\\n[rst2man-indent2] +.. +.de1 INDENT +.\" .rstReportMargin pre: +. RS \\$1 +. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin] +. nr rst2man-indent-level +1 +.\" .rstReportMargin post: +.. +.de UNINDENT +. RE +.\" indent \\n[an-margin] +.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]] +.nr rst2man-indent-level -1 +.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] +.in \\n[rst2man-indent\\n[rst2man-indent-level]]u +.. +.\" RST source for mktoc(1) man page. Convert with: +. +.\" rst2man.py mktoc.rst > mktoc.1 +. +.\" rst2man.py comes from the SBo development/docutils package. +. +.\" Upstream's README is already RST, I just added some stuff to make +. +.\" it format in man page style. +. +.SH SYNOPSIS +.INDENT 0.0 +.INDENT 3.5 +.sp +.nf +.ft C +mktoc [OPTIONS] < CUE_FILE +mktoc [OPTIONS] [[\-f] CUE_FILE] [[\-o] TOC_FILE] +mktoc [OPTIONS] \-w WAV_FILES [[\-o] TOC_FILE] +.ft P +.fi +.UNINDENT +.UNINDENT +.SH DESCRIPTION +.\" Mktoc // (c) 2011, Patrick C. McGinty +. +.\" mktoc[@]tuxcoder[dot]com +. +.sp +Mktoc simplifies the steps needed to create audio CD TOC files for the +cdrdao CD burning program. For users familiar with ExactAudioCopy or CdrWin, +TOC files are synonymous with CUE sheets. The primary goal of mktoc is to +create TOC files using a previously generated CUE sheet. +.SH FEATURES +.INDENT 0.0 +.IP \(bu 2 +Create a TOC file from a list of WAV files. +.IP \(bu 2 +Convert an ExactAudioCopy (EAC) CUE file to the TOC format that +is usable by cdrdao. +.IP \(bu 2 +Multi\-session aware CUE parsing, necessary for making CDDB and +AccurateRip matchable discs. +.IP \(bu 2 +Non\-compliant CUE sheet support. +.IP \(bu 2 +Support for various pregap methods. +.IP \(bu 2 +Can create offset corrected WAV files for true \(aqbit\-for\-bit\(aq +accurate copies. +.IP \(bu 2 +Fuzzy file name logic can correct common file name spelling +variations. +.IP \(bu 2 +Workaround known TOC file parsing bugs in cdrdao. +.UNINDENT +.SH USAGE +.sp +\fBCUE_FILE\fP must contain a valid CUE format. When \fB*_FILE\fP is not +provided, the program will read from \fBSTDIN\fP\&. All output will be sent to +\fBSTDOUT\fP\&. +.sp +All attempts will be made to preserve any and all information from the input +file. For any case where the CUE file contains unknown or bad values, the +user will be notified on \fBSTDERR\fP\&. +.SH OPTIONS +.INDENT 0.0 +.TP +.B \-\-version +show program\(aqs version number and exit +.TP +.B \-h +show help message and exit +.TP +.B \-\-help +show detailed usage instructions and exit +.TP +.B \-a\fP,\fB \-\-allow\-missing\-wav +do not abort when WAV file(s) are missing, (experts only). It is possible +when using this option that a bug in cdrdao will create a CD that ignores +the pregap definitions in the TOC file. Only use this option if the CUE +file does not contain pregaps, or if you do not wish to retain the pregap +information. +.TP +.BI \-c \ <WAV_OFFSET>\fP,\fB \ \-\-offset\-correction\fB= <WAV_OFFSET> +correct reader/writer offset by creating WAV file(s) shifted by +WAV_OFFSET samples (original data is not modified) +.TP +.B \-d\fP,\fB \-\-debug +enable debugging statements +.TP +.BI \-f \ <CUE_FILE>\fP,\fB \ \-\-file\fB= <CUE_FILE> +specify the input CUE file to read +.TP +.B \-m\fP,\fB \-\-multi +for safety, this option must be set when creating a mulit\-session TOC +file +.TP +.BI \-o \ <TOC_FILE>\fP,\fB \ \-\-output\fB= <TOC_FILE> +specify the output TOC file to write +.TP +.B \-t\fP,\fB \-\-use\-temp +write offset corrected WAV files to /tmp directory +.TP +.B \-w\fP,\fB \-\-wave +write a TOC file using list of WAV files +.TP +.B \-z\fP,\fB \-\-no\-multi +disable multi\-session support; program assumes TOC will be written in +single\-session mode +.UNINDENT +.SH EXAMPLES +.INDENT 0.0 +.IP 1. 3 +Create a TOC file from a set of WAV files: +.INDENT 3.0 +.INDENT 3.5 +.sp +.nf +.ft C +mktoc \-w *.wav +.ft P +.fi +.UNINDENT +.UNINDENT +.IP 2. 3 +Write a TOC file to \fBtoc_file.toc\fP, from a set of WAV files: +.INDENT 3.0 +.INDENT 3.5 +.sp +.nf +.ft C +mktoc \-w *.wav toc_file.toc +mktoc \-w *.wav > toc_file.toc +mktoc \-w *.wav \-o toc_file.toc +.ft P +.fi +.UNINDENT +.UNINDENT +.IP 3. 3 +Create a TOC file from a valid CUE file: +.INDENT 3.0 +.INDENT 3.5 +.sp +.nf +.ft C +mktoc cue_file.cue +mktoc < cue_file.cue +mktoc \-f cue_file.cue +.ft P +.fi +.UNINDENT +.UNINDENT +.IP 4. 3 +Write a TOC file to \fBtoc_file.toc\fP, given an input CUE file: +.INDENT 3.0 +.INDENT 3.5 +.sp +.nf +.ft C +mktoc cue_file.cue toc_file.toc +mktoc < cue_file.cue > toc_file.toc +mktoc \-f cue_file.cue \-o toc_file.toc +.ft P +.fi +.UNINDENT +.UNINDENT +.IP 5. 3 +Tell mktoc to ignore missing WAV file errors. There is a potential that +the result TOC file will cause cdrdao to lose pregap information during +the burn process (see above): +.INDENT 3.0 +.INDENT 3.5 +.sp +.nf +.ft C +mktoc \-a cue_file.cue +.ft P +.fi +.UNINDENT +.UNINDENT +.IP 6. 3 +Adjust WAV files for a CD writer offset value. For example, if your CD +writer has a \-30 sample write offset, it can be corrected by offsetting +the input WAV files by +30 samples. New WAV files will be placed in the +working directory in a new dir called \fBwav+30\fP: +.INDENT 3.0 +.INDENT 3.5 +.sp +.nf +.ft C +mktoc \-c 30 < cue_file.cue +.ft P +.fi +.UNINDENT +.UNINDENT +.IP 7. 3 +Adjust WAV files for a CD writer offset value, but create new files in +the \fB/tmp\fP directory: +.INDENT 3.0 +.INDENT 3.5 +.sp +.nf +.ft C +mktoc \-c 30 \-t < cue_file.cue +.ft P +.fi +.UNINDENT +.UNINDENT +.UNINDENT +.SH CONTACT +.SS E\-mail +.nf +mktoc[@]tuxcoder[dot]com +.fi +.sp +.SS Info +.nf +\fI\%http://packages.python.org/mktoc/\fP +\fI\%https://github.com/cmcginty/mktoc\fP +\fI\%http://blog.tuxcoder.com\fP +.fi +.sp +.\" Generated by docutils manpage writer. +. |