From: Boyuan Yang <byang@debian.org>
Date: Thu, 24 Mar 2022 14:09:19 -0400
Subject: Add built docs

---
 mp3burn.1    | 417 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 mp3burn.html | 420 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 837 insertions(+)
 create mode 100644 mp3burn.1
 create mode 100644 mp3burn.html

diff --git a/mp3burn.1 b/mp3burn.1
new file mode 100644
index 0000000..d6bcd8a
--- /dev/null
+++ b/mp3burn.1
@@ -0,0 +1,417 @@
+.\" Automatically generated by Pod::Man 2.22 (Pod::Simple 3.07)
+.\"
+.\" Standard preamble:
+.\" ========================================================================
+.de Sp \" Vertical space (when we can't use .PP)
+.if t .sp .5v
+.if n .sp
+..
+.de Vb \" Begin verbatim text
+.ft CW
+.nf
+.ne \\$1
+..
+.de Ve \" End verbatim text
+.ft R
+.fi
+..
+.\" Set up some character translations and predefined strings.  \*(-- will
+.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
+.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
+.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
+.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
+.\" nothing in troff, for use with C<>.
+.tr \(*W-
+.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
+.ie n \{\
+.    ds -- \(*W-
+.    ds PI pi
+.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
+.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
+.    ds L" ""
+.    ds R" ""
+.    ds C` ""
+.    ds C' ""
+'br\}
+.el\{\
+.    ds -- \|\(em\|
+.    ds PI \(*p
+.    ds L" ``
+.    ds R" ''
+'br\}
+.\"
+.\" Escape single quotes in literal strings from groff's Unicode transform.
+.ie \n(.g .ds Aq \(aq
+.el       .ds Aq '
+.\"
+.\" If the F register is turned on, we'll generate index entries on stderr for
+.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
+.\" entries marked with X<> in POD.  Of course, you'll have to process the
+.\" output yourself in some meaningful fashion.
+.ie \nF \{\
+.    de IX
+.    tm Index:\\$1\t\\n%\t"\\$2"
+..
+.    nr % 0
+.    rr F
+.\}
+.el \{\
+.    de IX
+..
+.\}
+.\"
+.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
+.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
+.    \" fudge factors for nroff and troff
+.if n \{\
+.    ds #H 0
+.    ds #V .8m
+.    ds #F .3m
+.    ds #[ \f1
+.    ds #] \fP
+.\}
+.if t \{\
+.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
+.    ds #V .6m
+.    ds #F 0
+.    ds #[ \&
+.    ds #] \&
+.\}
+.    \" simple accents for nroff and troff
+.if n \{\
+.    ds ' \&
+.    ds ` \&
+.    ds ^ \&
+.    ds , \&
+.    ds ~ ~
+.    ds /
+.\}
+.if t \{\
+.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
+.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
+.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
+.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
+.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
+.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
+.\}
+.    \" troff and (daisy-wheel) nroff accents
+.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
+.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
+.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
+.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
+.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
+.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
+.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
+.ds ae a\h'-(\w'a'u*4/10)'e
+.ds Ae A\h'-(\w'A'u*4/10)'E
+.    \" corrections for vroff
+.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
+.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
+.    \" for low resolution devices (crt and lpr)
+.if \n(.H>23 .if \n(.V>19 \
+\{\
+.    ds : e
+.    ds 8 ss
+.    ds o a
+.    ds d- d\h'-1'\(ga
+.    ds D- D\h'-1'\(hy
+.    ds th \o'bp'
+.    ds Th \o'LP'
+.    ds ae ae
+.    ds Ae AE
+.\}
+.rm #[ #] #H #V #F C
+.\" ========================================================================
+.\"
+.IX Title "MP3BURN 1"
+.TH MP3BURN 1 "2010-10-25" "perl v5.10.1" "User Contributed Perl Documentation"
+.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
+.\" way too many mistakes in technical documents.
+.if n .ad l
+.nh
+.SH "NAME"
+mp3burn \- burn audio CDs from MP3, Ogg Vorbis, or FLAC files
+.SH "SYNOPSIS"
+.IX Header "SYNOPSIS"
+\&\fBmp3burn\fR [\s-1OPTION\s0] [mp3,ogg, and flac files]
+.SH "DESCRIPTION"
+.IX Header "DESCRIPTION"
+\&\fBmp3burn\fR
+is a simple command line tool for making audio CDs from
+MP3s without filling up your disk with .wav files.  It uses
+\&\fIPerl\fR\|(1), \fIogg123\fR\|(1), \fImpg321\fR\|(1) or \fImpg123\fR\|(1), \fIcdrecord\fR\|(1), 
+\&\fIflac\fR\|(1), and the \fIMP3::Info\fR\|(3) Perl module.
+.SH "OPTIONS"
+.IX Header "OPTIONS"
+.IP "\fB\-h, \-\-help\fR" 4
+.IX Item "-h, --help"
+Prints out a brief help
+.IP "\fB\-m, \-\-swap\fR" 4
+.IX Item "-m, --swap"
+Manual \f(CW\*(C`cdrecord \-swab\*(C'\fR option mode.  
+Use this to disable the automatic detection for swab mode in case it is
+not working correctly on your system.  (Also, please send email to
+<formorer@formorer.de> or file a bug against the mp3burn package if you
+encounter this problem.)
+.ie n .IP "\fB\-p, \-\-playlist\fR "".m3u playlist""" 4
+.el .IP "\fB\-p, \-\-playlist\fR ``.m3u playlist''" 4
+.IX Item "-p, --playlist .m3u playlist"
+Use a playlist to specify audio files to burn.
+Instead of (or in addition to) listing mp3/ogg/flac files, 
+supply a .m3u playlist (e.g., from xmms) that contains the 
+audio files for your \s-1CD\s0.
+.Sp
+Note:  If you specify both a playlist and audio files, the
+files specified on the command-line will be appended to the list 
+of audio files listed in the playlist.  If a file referenced
+in a playlist cannot be read, it will be skipped.  Be wary of
+playlist editors that use relative paths \- mp3burn cannot know
+what path the playlist editor assumed.
+.ie n .IP "\fB\-t, \-\-tmpdir\fR ""tmpdir""" 4
+.el .IP "\fB\-t, \-\-tmpdir\fR ``tmpdir''" 4
+.IX Item "-t, --tmpdir tmpdir"
+Put temporary files in \fItmpdir\fR.
+Default is to use the current directory.
+.ie n .IP "\fB\-c, \-\-check\fR ""\s-1MMM:SS\s0"" | \s-1ATIP\s0" 4
+.el .IP "\fB\-c, \-\-check\fR ``\s-1MMM:SS\s0'' | \s-1ATIP\s0" 4
+.IX Item "-c, --check MMM:SS | ATIP"
+Time check:  compute the total length of files to be burned
+and warn if greater than \fI\s-1MMM:SS\s0\fR minutes and seconds.  If
+the value \s-1ATIP\s0 is supplied, the total length is checked
+against the length available on the CDR[W] as reported by
+\&\s-1ATIP\s0.
+.Sp
+Note that FLAC-encoded files are assumed to be 1 second long
+(until there is an easy way to get the file duration).  You
+will need to calculate burn-length on your own with \s-1FLAC\s0 files.
+.IP "\fB\-d, \-\-dummy\fR" 4
+.IX Item "-d, --dummy"
+Perform a \*(L"dummy\*(R" run: do everything except actually burn the \s-1CD\s0
+(uses \fIcdrecord\fR\|(1) \f(CW\*(C`\-dummy\*(C'\fR option).
+.ie n .IP "\fB\-o, \-\-cdrecord\fR  ""cdrecord_opts""" 4
+.el .IP "\fB\-o, \-\-cdrecord\fR  ``cdrecord_opts''" 4
+.IX Item "-o, --cdrecord  cdrecord_opts"
+Specify the command line options for cdrecord. 
+The quotes are required to prevent \fBmp3burn\fR from parsing \fIcdrecord\fR\|(1) options.
+Overrides options specified in \fI~/.mp3burnrc\fR.
+.Sp
+Example: \fB\-o\fR \*(L"\-v dev=1,0 speed=4 \-swab\*(R"
+.IP "\fBNote:\fR" 4
+.IX Item "Note:"
+The options \fI\-pad\fR and \fI\-audio\fR are added automatically, since they are
+always necessary.  The script also tries to detect if \fI\-swab\fR  is needed (for
+example on x86 and other little-Endian platforms).  cdrecord is supposed
+to take care of any byte-ordering requirements specific to your burner. 
+(If you end up with a \s-1CD\s0 that merely sounds like static, you most likely
+need to toggle use of \fI\-swab\fR.)  You should also consider using \fI\-v\fR so
+that you can watch the burn in progress. This goes for \fI~/.mp3burnrc\fR also.
+.IP "\fB\-a, \-\-atip\fR" 4
+.IX Item "-a, --atip"
+Lookup the \s-1ATIP\s0 info for the device in the cdburner 
+(using \fIcdrecord\fR\|(1) \f(CW\*(C`\-atip\*(C'\fR) and then exits.  This 
+option can only be used (successfully) in conjuction with \fB\-o\fR.
+.ie n .IP "\fB\-M, \-\-encoder\fR ""\s-1MP3\s0 decoder""" 4
+.el .IP "\fB\-M, \-\-encoder\fR ``\s-1MP3\s0 decoder''" 4
+.IX Item "-M, --encoder MP3 decoder"
+Use an \s-1MP3\s0 decoder other than the default, which is mpg321.  This is
+imperative when burning tracks that have sample rates other than 44.1kHz,
+and the current version of mpg321 will not decode these files.  Specify
+the name of the decoder to be used, e.g. \fImpg123\-oss\-3dnow\fR;  you can
+also specify this in  your .mp3burnrc file with \fB\f(CB$mp3decoder\fB
+=\fR \fImp3decoder\fR.  \fI(Note:  Currently, the \s-1MP3\s0 decoder must be
+able to accept mpg123\-style command-line arguments.)\fR
+.SH "RETURN VALUE"
+.IX Header "RETURN VALUE"
+\&\fBmp3burn\fR returns 0 on success.
+.SH "DIAGNOSTICS"
+.IX Header "DIAGNOSTICS"
+.IP "Error in .mp3burnrc:" 4
+.IX Item "Error in .mp3burnrc:"
+\&\fIPerl\fR\|(1) cannot parse the \fI.mp3burnrc\fR file.
+The following example occurs when a double quote is not terminated:
+.Sp
+.Vb 6
+\&  bash\-2.05$ sudo mp3burn \-d ~/bell.ogg 
+\&  String found where operator expected at (eval 10) line 7, at end of line
+\&          (Missing operator before ?)
+\&  Error in .mp3burnrc:
+\&  Can\*(Aqt find string terminator \*(Aq"\*(Aq anywhere before EOF at (eval 10) line 7.
+\&  bash\-2.05$
+.Ve
+.Sp
+You will experience this error if you define both \f(CW$cdrecord_opts\fR and
+\&\f(CW$mp3decoder\fR without terminating the variable assignments with the ';' 
+character:
+.Sp
+.Vb 8
+\&  $ mp3burn \-d \-t /tmp Theodor_Storm_Aquis_submersus_1.mp3 
+\&  Scalar found where operator expected at (eval 10) line 2, near ""\-v speed=2 dev=0,3,0"
+\&  $mp3decoder"
+\&        (Missing operator before 
+\&  $mp3decoder?)
+\&  Error in .mp3burnrc:
+\&  syntax error at (eval 10) line 2, near ""\-v speed=2 dev=0,3,0"
+\&  $mp3decoder"
+.Ve
+.SH "EXAMPLES"
+.IX Header "EXAMPLES"
+Write an Ogg Vorbis file from a CD-R drive, \fI/dev/scd0\fR, 
+mounted at \fI/mnt/scd0/\fR to a 
+CD-RW drive, \fI/dev/scd1\fR, called \f(CW\*(C`0,1,0\*(C'\fR in \fIcdrecord\fR\|(1) \s-1SCSI\s0 notation.
+Ensure that file is no longer than 50 minutes.
+\&\fIsudo\fR\|(1) is used to get root permissions for \fIcdrecord\fR\|(1).
+.PP
+.Vb 1
+\&  % sudo mp3burn \-c 050:00 \-o "\-v speed=2 dev=0,1,0" /mnt/scd0/bell.ogg
+.Ve
+.PP
+Create a \fI~/.mp3burnrc\fR that prints a message before writing and uses
+a different \s-1MP3\s0 decoder than the default of mpg321.
+.PP
+.Vb 3
+\&  # This is an example.
+\&  $cdrecord_opts="\-v speed=2 dev=0,1,0";
+\&  $mp3decoder = "mpg123\-oss\-3dnow";
+\&
+\&  print "Nine seconds to slap a CD\-R in the drive!\en" ;
+\&
+\&  #
+\&  # See mp3burn(3).
+\&  #
+.Ve
+.PP
+Specify an mp3decoder other than mpg321.
+.PP
+.Vb 1
+\&  $ sudo mp3burn \-M mpg123\-esd ./rush/*mp3
+.Ve
+.SH "FILES"
+.IX Header "FILES"
+.IP "\fI~/.mp3burnrc\fR" 4
+.IX Item "~/.mp3burnrc"
+In this file, you may permanently specify the cdrecord options and
+\&\s-1MP3\s0 decoder you want to use.  The format is:
+.Sp
+.Vb 2
+\&  $cdrecord_opts = "cdrecord options";
+\&  $mp3decoder = "some mp3 decoder";
+.Ve
+.Sp
+You may place comments in this file by beginning a line with \f(CW\*(C`#\*(C'\fR.
+.IP "\fBNote:\fR" 4
+.IX Item "Note:"
+The values of \f(CW$cdrecord_opts\fR and \f(CW$mp3decoder\fR in \fI~/.mp3burnrc\fR are ignored 
+if the \f(CW\*(C`\-o\*(C'\fR or \f(CW\*(C`\-<\*(C'\fRcommand-line options are used, respectively.
+.SH "CAVEATS"
+.IX Header "CAVEATS"
+Has not been tested extensively with Ogg Vorbis files.
+Ogg Vorbis files must be in CD-DA format: 
+i.e. 44100 samples/channel x 16 bits/sample x 2 channels.
+.SH "BUGS"
+.IX Header "BUGS"
+If you execute \fBmp3burn\fR with root permissions, 
+the \fI~/.mp3burnrc\fR will also be executed with root permissions.
+.SH "NOTES"
+.IX Header "NOTES"
+There are a number of \s-1GUI\s0 frontends for \fBmp3burn\fR:
+.IP "Xmp3Burn" 4
+.IX Item "Xmp3Burn"
+http://perso.wanadoo.es/ja_recio/xmp3burn/xmp3burn.html
+.IP "Kmp3burn" 4
+.IX Item "Kmp3burn"
+http://computer.freepage.de/kmp3burn/index.htm
+.IP "GtkMp3Burn" 4
+.IX Item "GtkMp3Burn"
+http://gtkmp3burn.sourceforge.net/
+.SH "SEE ALSO"
+.IX Header "SEE ALSO"
+\&\fIcdrecord\fR\|(1), \fImpg321\fR\|(1), \fIogg123\fR\|(1), \fIogginfo\fR\|(1), \fIflac\fR\|(1), \fIMP3::Info\fR\|(3)
+The \fBmp3burn\fR web page is http://mp3burn.sourceforge.net/.
+The Ogg Vorbis web page is http://www.xiph.org/ogg/vorbis/.
+The \s-1FLAC\s0 web page is http://flac.sourceforge.net/.
+.SH "AUTHOR"
+.IX Header "AUTHOR"
+Copyright (c) 2000 Ryan Richter. 
+Copyright (c) 2003 Alexander Wirt
+.PP
+This script was written by Ryan Richter <bobort@bigfoot.com> with much code
+contributed by Dan Lark <dlark@spinn.net>.
+.PP
+I would like to thank Dan Lark <dlark@spinn.net> for
+contributing the ideas and code for most of the new features,
+and Tony Mancill <tony@mancill.com> for making Debian packages
+and helping with debugging.
+.PP
+Later in 2003 Alexander Wirt continued to write this program.
+.PP
+This program is licensed under the \s-1GNU\s0 General Public License.
+You may fold, spindle, and mutilate this software under the terms of the \s-1GPL\s0.
+.SH "HISTORY"
+.IX Header "HISTORY"
+.IP "20031014 <formorer@formorer.de>" 4
+.IX Item "20031014 <formorer@formorer.de>"
+Switches from standard getopt to GetOpts::Long
+.Sp
+Updated Manpage for the new option format
+.IP "20031012 <formorer@formorer.de>" 4
+.IX Item "20031012 <formorer@formorer.de>"
+Updated mp3burn to use pod2usage
+.Sp
+Added \-h switch for getting help
+.Sp
+Fixed a bug with the output of file in conduction with \s-1FLAC\s0 files
+.Sp
+Added a gracefully exit if there are no valid files left
+.Sp
+Use String::Shellquote to avoid problems with the shell
+.IP "20030203 <tmancill@debian.org>" 4
+.IX Item "20030203 <tmancill@debian.org>"
+hacked in support for \s-1FLAC\s0, as per suggested by <ldm@apartia.org>
+.IP "20021110 <tmancill@debian.org>" 4
+.IX Item "20021110 <tmancill@debian.org>"
+updated to work with new ogginfo output format in vorbis-tools 1.0; 
+modified slightly to not create FIFOs for invalid \s-1MP3/OGG\s0 files
+.IP "20020728 <tmancill@debian.org>" 4
+.IX Item "20020728 <tmancill@debian.org>"
+added \fI\-M \f(CI$mp3decoder\fI\fR switch to support \s-1MP3\s0 decoders other than 
+mpg321 and mpg123\-oss
+.IP "20010917	<tmancill@debian.org>" 4
+.IX Item "20010917	<tmancill@debian.org>"
+added check to automatically add \-swab on ia32 platform
+.Sp
+\&\fIMP3::Info\fR\|(3) replaces MPEG::MP3Info
+.IP "\fBmp3burn\fR 0.02 10/28/00" 4
+.IX Item "mp3burn 0.02 10/28/00"
+Changes since 0.01:
+.Sp
+Bugfixes:
+.Sp
+Spaces, quotes, and other shell metacharacters in filenames
+should no longer problematic, since we use Shell:QuoteString 
+to avoid problems with that (Feedback for that is wished).
+.Sp
+Mono MP3s and MP3s not sampled at 44.1kHz are no longer
+problematic.
+.Sp
+New Features:
+.Sp
+Editing the executable is no longer necessary; cdrecord
+options can be specified on the command line or in \fI~/.mp3burnrc\fR.
+.Sp
+Temp dir for FIFOs may be set to other than the current dir.
+.Sp
+Dummy runs now supported from the command line.
+.Sp
+A time check is now available: \fBmp3burn\fR can abort if total
+time exceeds a threshold.  Requires MPEG::MP3Info.
+.Sp
+Playlist support.
+.SH "POD ERRORS"
+.IX Header "POD ERRORS"
+Hey! \fBThe above document had some coding errors, which are explained below:\fR
+.IP "Around line 583:" 4
+.IX Item "Around line 583:"
+You forgot a '=back' before '=head1'
+.IP "Around line 589:" 4
+.IX Item "Around line 589:"
+\&'=item' outside of any '=over'
diff --git a/mp3burn.html b/mp3burn.html
new file mode 100644
index 0000000..0b33b2c
--- /dev/null
+++ b/mp3burn.html
@@ -0,0 +1,420 @@
+<?xml version="1.0" ?>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml">
+<head>
+<title>mp3burn - burn audio CDs from MP3, Ogg Vorbis, or FLAC files</title>
+<meta http-equiv="content-type" content="text/html; charset=utf-8" />
+<link rev="made" href="mailto:root@localhost" />
+</head>
+
+<body style="background-color: white">
+
+<p><a name="__index__"></a></p>
+<!-- INDEX BEGIN -->
+
+<ul>
+
+	<li><a href="#name">NAME</a></li>
+	<li><a href="#synopsis">SYNOPSIS</a></li>
+	<li><a href="#description">DESCRIPTION</a></li>
+	<li><a href="#options">OPTIONS</a></li>
+	<li><a href="#return_value">RETURN VALUE</a></li>
+	<li><a href="#diagnostics">DIAGNOSTICS</a></li>
+	<li><a href="#examples">EXAMPLES</a></li>
+	<li><a href="#caveats">CAVEATS</a></li>
+	<li><a href="#bugs">BUGS</a></li>
+	<li><a href="#notes">NOTES</a></li>
+	<li><a href="#see_also">SEE ALSO</a></li>
+	<li><a href="#author">AUTHOR</a></li>
+	<li><a href="#history">HISTORY</a></li>
+</ul>
+<!-- INDEX END -->
+
+<hr />
+<p>
+</p>
+<h1><a name="name">NAME</a></h1>
+<p>mp3burn - burn audio CDs from MP3, Ogg Vorbis, or FLAC files</p>
+<p>
+</p>
+<hr />
+<h1><a name="synopsis">SYNOPSIS</a></h1>
+<p><strong>mp3burn</strong> [OPTION] [mp3,ogg, and flac files]</p>
+<p>
+</p>
+<hr />
+<h1><a name="description">DESCRIPTION</a></h1>
+<p><strong>mp3burn</strong>
+is a simple command line tool for making audio CDs from
+MP3s without filling up your disk with .wav files.  It uses
+Perl(1), ogg123(1), <code>mpg321(1)</code> or mpg123(1), cdrecord(1), 
+flac(1), and the <a href="/MP3/Info(3).html">the MP3::Info(3) manpage</a> Perl module.</p>
+<p>
+</p>
+<hr />
+<h1><a name="options">OPTIONS</a></h1>
+<dl>
+<dt><strong><a name="item__2dh_2c__2d_2dhelp"><strong>-h, --help</strong></a></strong>
+
+<dd>
+<p>Prints out a brief help</p>
+</dd>
+</li>
+<dt><strong><a name="item__2dm_2c__2d_2dswap"><strong>-m, --swap</strong></a></strong>
+
+<dd>
+<p>Manual <code>cdrecord -swab</code> option mode.  
+Use this to disable the automatic detection for swab mode in case it is
+not working correctly on your system.  (Also, please send email to
+&lt;<a href="mailto:formorer@formorer.de">formorer@formorer.de</a>&gt; or file a bug against the <em>mp3burn</em> package if you
+encounter this problem.)</p>
+</dd>
+</li>
+<dt><strong><a name="item__2dp_2c__2d_2dplaylist__22_2em3u_playlist_22"><strong>-p, --playlist</strong> ``.m3u playlist''</a></strong>
+
+<dd>
+<p>Use a playlist to specify audio files to burn.
+Instead of (or in addition to) listing mp3/ogg/flac files, 
+supply a .m3u playlist (e.g., from xmms) that contains the 
+audio files for your CD.</p>
+</dd>
+<dd>
+<p>Note:  If you specify both a playlist and audio files, the
+files specified on the command-line will be appended to the list 
+of audio files listed in the playlist.  If a file referenced
+in a playlist cannot be read, it will be skipped.  Be wary of
+playlist editors that use relative paths - mp3burn cannot know
+what path the playlist editor assumed.
+</p>
+</dd>
+<dd>
+<pre>
+
+=cut</pre>
+</dd>
+</li>
+<dt><strong><a name="item__2dt_2c__2d_2dtmpdir__22tmpdir_22"><strong>-t, --tmpdir</strong> ``tmpdir''</a></strong>
+
+<dd>
+<p>Put temporary files in <em>tmpdir</em>.
+Default is to use the current directory.</p>
+</dd>
+</li>
+<dt><strong><a name="item__2dc_2c__2d_2dcheck__22mmm_3ass_22__7c_atip"><strong>-c, --check</strong> ``MMM:SS'' | ATIP</a></strong>
+
+<dd>
+<p>Time check:  compute the total length of files to be burned
+and warn if greater than <em>MMM:SS</em> minutes and seconds.  If
+the value ATIP is supplied, the total length is checked
+against the length available on the CDR[W] as reported by
+ATIP.</p>
+</dd>
+<dd>
+<p>Note that FLAC-encoded files are assumed to be 1 second long
+(until there is an easy way to get the file duration).  You
+will need to calculate burn-length on your own with FLAC files.</p>
+</dd>
+</li>
+<dt><strong><a name="item__2dd_2c__2d_2ddummy"><strong>-d, --dummy</strong></a></strong>
+
+<dd>
+<p>Perform a ``dummy'' run: do everything except actually burn the CD
+(uses <em>cdrecord(1)</em> <code>-dummy</code> option).</p>
+</dd>
+</li>
+<dt><strong><a name="item__2do_2c__2d_2dcdrecord__22cdrecord_opts_22"><strong>-o, --cdrecord</strong>  ``cdrecord_opts''</a></strong>
+
+<dd>
+<p>Specify the command line options for cdrecord. 
+The quotes are required to prevent <strong>mp3burn</strong> from parsing <code>cdrecord(1)</code> options.
+Overrides options specified in <em>~/.mp3burnrc</em>.</p>
+</dd>
+<dd>
+<p>Example: <strong>-o</strong> ``-v dev=1,0 speed=4 -swab''</p>
+</dd>
+</li>
+<dt><strong><a name="item_note_3a"><strong>Note:</strong></a></strong>
+
+<dd>
+<p>The options <em>-pad</em> and <em>-audio</em> are added automatically, since they are
+always necessary.  The script also tries to detect if <em>-swab</em>  is needed (for
+example on x86 and other little-Endian platforms).  cdrecord is supposed
+to take care of any byte-ordering requirements specific to your burner. 
+(If you end up with a CD that merely sounds like static, you most likely
+need to toggle use of <em>-swab</em>.)  You should also consider using <em>-v</em> so
+that you can watch the burn in progress. This goes for <em>~/.mp3burnrc</em> also.</p>
+</dd>
+</li>
+<dt><strong><a name="item__2da_2c__2d_2datip"><strong>-a, --atip</strong></a></strong>
+
+<dd>
+<p>Lookup the ATIP info for the device in the cdburner 
+(using <em>cdrecord(1)</em> <code>-atip</code>) and then exits.  This 
+option can only be used (successfully) in conjuction with <strong>-o</strong>.</p>
+</dd>
+</li>
+<dt><strong><a name="item__2dm_2c__2d_2dencoder__22mp3_decoder_22"><strong>-M, --encoder</strong> ``MP3 decoder''</a></strong>
+
+<dd>
+<p>Use an MP3 decoder other than the default, which is mpg321.  This is
+imperative when burning tracks that have sample rates other than 44.1kHz,
+and the current version of mpg321 will not decode these files.  Specify
+the name of the decoder to be used, e.g. <em>mpg123-oss-3dnow</em>;  you can
+also specify this in  your .mp3burnrc file with <strong>$mp3decoder
+=</strong> <em>mp3decoder</em>.  <em>(Note:  Currently, the MP3 decoder must be
+able to accept mpg123-style command-line arguments.)</em></p>
+</dd>
+</li>
+</dl>
+<p>
+</p>
+<hr />
+<h1><a name="return_value">RETURN VALUE</a></h1>
+<p><strong>mp3burn</strong> returns 0 on success.</p>
+<p>
+</p>
+<hr />
+<h1><a name="diagnostics">DIAGNOSTICS</a></h1>
+<dl>
+<dt><strong><a name="item_error_in__2emp3burnrc_3a">Error in .mp3burnrc:</a></strong>
+
+<dd>
+<p><code>Perl(1)</code> cannot parse the <em>.mp3burnrc</em> file.
+The following example occurs when a double quote is not terminated:</p>
+</dd>
+<dd>
+<pre>
+  bash-2.05$ sudo mp3burn -d ~/bell.ogg 
+  String found where operator expected at (eval 10) line 7, at end of line
+          (Missing operator before ?)
+  Error in .mp3burnrc:
+  Can't find string terminator '&quot;' anywhere before EOF at (eval 10) line 7.
+  bash-2.05$ 
+  
+You will experience this error if you define both $cdrecord_opts and
+$mp3decoder without terminating the variable assignments with the ';' 
+character:</pre>
+</dd>
+<dd>
+<pre>
+  $ mp3burn -d -t /tmp Theodor_Storm_Aquis_submersus_1.mp3 
+  Scalar found where operator expected at (eval 10) line 2, near &quot;&quot;-v speed=2 dev=0,3,0&quot;
+  $mp3decoder&quot;
+        (Missing operator before 
+  $mp3decoder?)
+  Error in .mp3burnrc:
+  syntax error at (eval 10) line 2, near &quot;&quot;-v speed=2 dev=0,3,0&quot;
+  $mp3decoder&quot;</pre>
+</dd>
+</li>
+</dl>
+<p>
+</p>
+<hr />
+<h1><a name="examples">EXAMPLES</a></h1>
+<p>Write an Ogg Vorbis file from a CD-R drive, <em>/dev/scd0</em>, 
+mounted at <em>/mnt/scd0/</em> to a 
+CD-RW drive, <em>/dev/scd1</em>, called <code>0,1,0</code> in <code>cdrecord(1)</code> SCSI notation.
+Ensure that file is no longer than 50 minutes.
+<em>sudo(1)</em> is used to get root permissions for cdrecord(1).</p>
+<pre>
+  % sudo mp3burn -c 050:00 -o &quot;-v speed=2 dev=0,1,0&quot; /mnt/scd0/bell.ogg</pre>
+<p>Create a <em>~/.mp3burnrc</em> that prints a message before writing and uses
+a different MP3 decoder than the default of mpg321.</p>
+<pre>
+  # This is an example.
+  $cdrecord_opts=&quot;-v speed=2 dev=0,1,0&quot;;
+  $mp3decoder = &quot;mpg123-oss-3dnow&quot;;</pre>
+<pre>
+  print &quot;Nine seconds to slap a CD-R in the drive!\n&quot; ;</pre>
+<pre>
+  #
+  # See mp3burn(3).
+  #</pre>
+<p>Specify an mp3decoder other than mpg321.</p>
+<pre>
+  $ sudo mp3burn -M mpg123-esd ./rush/*mp3
+  
+=head1 FILES</pre>
+<dl>
+<dt><strong><a name="item__7e_2f_2emp3burnrc"><em>~/.mp3burnrc</em></a></strong>
+
+<dd>
+<p>In this file, you may permanently specify the cdrecord options and
+MP3 decoder you want to use.  The format is:</p>
+</dd>
+<dd>
+<pre>
+  $cdrecord_opts = &quot;cdrecord options&quot;;
+  $mp3decoder = &quot;some mp3 decoder&quot;;</pre>
+</dd>
+<dd>
+<p>You may place comments in this file by beginning a line with <code>#</code>.</p>
+</dd>
+</li>
+<dt><strong><strong>Note:</strong></strong>
+
+<dd>
+<p>The values of $cdrecord_opts and $mp3decoder in <em>~/.mp3burnrc</em> are ignored 
+if the <code>-o</code> or <code>-&lt;</code>command-line options are used, respectively.</p>
+</dd>
+</li>
+</dl>
+<p>
+</p>
+<hr />
+<h1><a name="caveats">CAVEATS</a></h1>
+<p>Has not been tested extensively with Ogg Vorbis files.
+Ogg Vorbis files must be in CD-DA format: 
+i.e. 44100 samples/channel x 16 bits/sample x 2 channels.</p>
+<p>
+</p>
+<hr />
+<h1><a name="bugs">BUGS</a></h1>
+<p>If you execute <strong>mp3burn</strong> with root permissions, 
+the <em>~/.mp3burnrc</em> will also be executed with root permissions.</p>
+<p>
+</p>
+<hr />
+<h1><a name="notes">NOTES</a></h1>
+<p>There are a number of GUI frontends for <strong>mp3burn</strong>:</p>
+<dl>
+<dt><strong><a name="item_xmp3burn">Xmp3Burn</a></strong>
+
+<dd>
+<pre>
+
+<a href="http://perso.wanadoo.es/ja_recio/xmp3burn/xmp3burn.html">http://perso.wanadoo.es/ja_recio/xmp3burn/xmp3burn.html</a></pre>
+</dd>
+<dt><strong><a name="item_kmp3burn">Kmp3burn</a></strong>
+
+<dd>
+<p><a href="http://computer.freepage.de/kmp3burn/index.htm">http://computer.freepage.de/kmp3burn/index.htm</a></p>
+</dd>
+</li>
+<dt><strong><a name="item_gtkmp3burn">GtkMp3Burn</a></strong>
+
+<dd>
+<p><a href="http://gtkmp3burn.sourceforge.net/">http://gtkmp3burn.sourceforge.net/</a></p>
+</dd>
+</li>
+</dl>
+<p>
+</p>
+<hr />
+<h1><a name="see_also">SEE ALSO</a></h1>
+<p>cdrecord(1), mpg321(1), ogg123(1), ogginfo(1), flac(1), <a href="/MP3/Info(3).html">the MP3::Info(3) manpage</a>
+The <strong>mp3burn</strong> web page is <a href="http://mp3burn.sourceforge.net/.">http://mp3burn.sourceforge.net/.</a>
+The Ogg Vorbis web page is <a href="http://www.xiph.org/ogg/vorbis/.">http://www.xiph.org/ogg/vorbis/.</a>
+The FLAC web page is <a href="http://flac.sourceforge.net/.">http://flac.sourceforge.net/.</a></p>
+<p>
+</p>
+<hr />
+<h1><a name="author">AUTHOR</a></h1>
+<p>Copyright (c) 2000 Ryan Richter. 
+Copyright (c) 2003 Alexander Wirt</p>
+<p>This script was written by Ryan Richter &lt;<a href="mailto:bobort@bigfoot.com">bobort@bigfoot.com</a>&gt; with much code
+contributed by Dan Lark &lt;<a href="mailto:dlark@spinn.net">dlark@spinn.net</a>&gt;.</p>
+<p>I would like to thank Dan Lark &lt;<a href="mailto:dlark@spinn.net">dlark@spinn.net</a>&gt; for
+contributing the ideas and code for most of the new features,
+and Tony Mancill &lt;<a href="mailto:tony@mancill.com">tony@mancill.com</a>&gt; for making Debian packages
+and helping with debugging.</p>
+<p>Later in 2003 Alexander Wirt continued to write this program.</p>
+<p>This program is licensed under the GNU General Public License.
+You may fold, spindle, and mutilate this software under the terms of the GPL.</p>
+<p>
+</p>
+<hr />
+<h1><a name="history">HISTORY</a></h1>
+<ol>
+<li><strong><a name="item__3cformorer_40formorer_2ede_3e">&lt;<a href="mailto:formorer@formorer.de">formorer@formorer.de</a>&gt;</a></strong>
+
+<p>Switches from standard getopt to GetOpts::Long</p>
+<p>Updated Manpage for the new option format</p>
+</li>
+<li><strong>&lt;<a href="mailto:formorer@formorer.de">formorer@formorer.de</a>&gt;</strong>
+
+<p>Updated mp3burn to use pod2usage</p>
+<p>Added -h switch for getting help</p>
+<p>Fixed a bug with the output of file in conduction with FLAC files</p>
+<p>Added a gracefully exit if there are no valid files left</p>
+<p>Use String::Shellquote to avoid problems with the shell</p>
+</li>
+<li><strong><a name="item__3ctmancill_40debian_2eorg_3e">&lt;<a href="mailto:tmancill@debian.org">tmancill@debian.org</a>&gt;</a></strong>
+
+<p>hacked in support for FLAC, as per suggested by &lt;<a href="mailto:ldm@apartia.org">ldm@apartia.org</a>&gt;</p>
+</li>
+<li><strong>&lt;<a href="mailto:tmancill@debian.org">tmancill@debian.org</a>&gt;</strong>
+
+<p>updated to work with new ogginfo output format in vorbis-tools 1.0; 
+modified slightly to not create FIFOs for invalid MP3/OGG files</p>
+</li>
+<li><strong>&lt;<a href="mailto:tmancill@debian.org">tmancill@debian.org</a>&gt;</strong>
+
+<p>added <em>-M $mp3decoder</em> switch to support MP3 decoders other than 
+mpg321 and mpg123-oss</p>
+</li>
+<li><strong>&lt;<a href="mailto:tmancill@debian.org">tmancill@debian.org</a>&gt;</strong>
+
+<p>added check to automatically add -swab on ia32 platform</p>
+<p><a href="/MP3/Info(3).html">the MP3::Info(3) manpage</a> replaces MPEG::MP3Info</p>
+</li>
+<dt><strong><a name="item_mp3burn_0_2e02_10_2f28_2f00"><strong>mp3burn</strong> 0.02 10/28/00</a></strong>
+
+<dd>
+<p>Changes since 0.01:</p>
+</dd>
+<dd>
+<p>Bugfixes:</p>
+</dd>
+<dd>
+<p>Spaces, quotes, and other shell metacharacters in filenames
+should no longer problematic, since we use Shell:QuoteString 
+to avoid problems with that (Feedback for that is wished).
+
+</p>
+</dd>
+<dd>
+<p>Mono MP3s and MP3s not sampled at 44.1kHz are no longer
+problematic.
+
+</p>
+</dd>
+<dd>
+<p>New Features:
+
+</p>
+</dd>
+<dd>
+<p>Editing the executable is no longer necessary; cdrecord
+options can be specified on the command line or in <em>~/.mp3burnrc</em>.
+
+</p>
+</dd>
+<dd>
+<p>Temp dir for FIFOs may be set to other than the current dir.
+
+</p>
+</dd>
+<dd>
+<p>Dummy runs now supported from the command line.
+
+</p>
+</dd>
+<dd>
+<p>A time check is now available: <strong>mp3burn</strong> can abort if total
+time exceeds a threshold.  Requires <a href="/MPEG/MP3Info.html">the MPEG::MP3Info manpage</a>.
+
+</p>
+</dd>
+<dd>
+<p>Playlist support.
+
+</p>
+</dd>
+</li>
+</ol>
+
+</body>
+
+</html>