.\" Man page generated from reStructeredText.
.
.TH BURN 1 "2009-07-22" "" "Burn"
.SH NAME
burn \- record from various sources to optical media (CD, DVD)
.
.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
..
.SH SYNOPSIS
.nf
burn \fIMAIN_MODE\fP \fI[OPTIONS]...\fP \fI[FILE/S]...\fP
burn \-\-help
.fi
.sp
.SH DESCRIPTION
.sp
CD\-writing program/script. Features Data\-CD, Audio\-CD, Copy on the
fly, Iso\-CD.
.SH CONFIGURATION
.sp
Configuration files for burn are: \fB~/.burnrc\fP or \fB/etc/burn.conf\fP.
You can edit them to change values.
.sp
If you don\(aqt have these files you can:
.INDENT 0.0
.IP 1. 3
.
use \fBburn\-configure\fP utility
.IP 2. 3
.
take the configuration template, edit and copy it as \fB~/.burnrc\fP
or \fB/etc/burn.conf\fP
.UNINDENT
.SH MAIN MODES
.INDENT 0.0
.TP
.B \-D,  \-\-data\-cd
.
To create Data\-CD
.TP
.B \-I,  \-\-iso\-cd
.
To create ISO\-CD
.TP
.B \-C,  \-\-copy\-cd
.
To copy CDs
.TP
.B \-A,  \-\-audio\-cd
.
To create an audio CD from WAV, MP3 and ogg files
.UNINDENT
.SH EXAMPLES
.sp
.nf
.ft C
# burn \-D \-p /etc/
.ft P
.fi
.sp
Creates a CD with /etc/ contents.
(you will find files and directories contained in /etc in CD\(aqs root.)
.sp
.nf
.ft C
# burn \-D \-p /home/bigpaul/video/summer_2003/spain.tar.gz
.ft P
.fi
.sp
Creates a CD with spain.tar.gz in CD\(aqs root
.sp
.nf
.ft C
# burn \-D \-r /etc/
.ft P
.fi
.sp
Creates a CD containing the whole /etc/ directory. (\-r preserves path)
.sp
.nf
.ft C
# burn \-D \-c /mail_2003 /home/bigpaul/Mail \-p /boot/vmli*
.ft P
.fi
.sp
Creates a CD containing the whole /home/bigpaul/Mail renamed
into /mail_2003. (\-c changes path name). This command also adds
in CD\(aqs root every vmli* file in /boot/ directory
.sp
.nf
.ft C
# burn \-I \-n image.iso
.ft P
.fi
.sp
Burns image.iso
.sp
.nf
.ft C
# burn \-C
.ft P
.fi
.sp
Copy CDs (disk at once).
.sp
.nf
.ft C
# burn \-A \-a *.wav
.ft P
.fi
.sp
Creates an Audio CD. Tracks come from wav files
.sp
.nf
.ft C
# burn \-A \-a *.mp3
.ft P
.fi
.sp
Creates an Audio CD. Tracks come from mp3 files
.sp
.nf
.ft C
# burn \-A \-a *.ogg
.ft P
.fi
.sp
Creates an Audio CD. Tracks come from Ogg Vorbis files
.sp
.nf
.ft C
# burn \-A \-a *.mp3 file.ogg track01.wav
.ft P
.fi
.sp
Creates an Audio CD preserving input order. In this example the first
audio tracks will come from mp3 files, than we will find the one from
\fBfile.ogg\fP and finally the one from \fBtrack01.wav\fP
.SH GENERAL OPTIONS
.INDENT 0.0
.TP
.B \-s,  \-\-simulate
.
to perform a burn simulation
.UNINDENT
.SH DATA-CD OPTIONS
.INDENT 0.0
.TP
.B \-p,  \-\-path
.
add file/s or path\(aqs content to CD\-ROM\(aqs root. e.g.: \fB\-p
/cvs/myproj/\fP. In this example we will find CD\-ROM\(aqs root filled
with \fB/cvs/myproj/\fP contents, but no \fB/cvs/myproj/\fP will be
created
.TP
.B \-r,  \-\-preserve\-path
.
add file/s or path\(aqs content to CD\-ROM preserving original path.
e.g.: \fB\-r /cvs/myproj/\fP. In this example we will find
\fB/cvs/myproj/\fP in CD\-ROM\(aqs root
.TP
.B \-x,  \-\-exclude\-path
.
every file or directory matching this string will not be included
.TP
.B \-c,  \-\-change\-path
.
old_path will be named new_path in CD\-ROM. e.g.: \fB\-c
/my_home/2004_Jan/ /home/bigpaul/\fP. Thus \fB/home/bigpaul/\fP will
be named \fB/my_home/2004_Jan/\fP in CD\-ROM.
.TP
.B \-l,  \-\-follow\-symlink
.
this option allows burn to follow symbolic link directories
.TP
.B \-m,  \-\-multisession
.
this option allows multisession CDs
.UNINDENT
.SH ISO-CD OPTIONS
.INDENT 0.0
.TP
.B \-n,  \-\-name
.
image name
.UNINDENT
.SH AUDIO-CD OPTIONS
.INDENT 0.0
.TP
.B \-a,  \-\-audio\-file
.
mp3, ogg or wav file/s
.UNINDENT
.\" Local variables:
.\" mode: rst
.\" coding: utf-8
.\" time-stamp-format: "%:y-%02m-%02d"
.\" time-stamp-start: "^:Date:[         ]+"
.\" time-stamp-end: "$"
.\" time-stamp-line-limit: 20
.\" End:
.\" vim: filetype=rst fileencoding=utf-8 :
.
.SH AUTHOR
Ben Finney <ben+python@benfinney.id.au>,
Gaetano Paolone <bigpaul@hacknight.org>
.SH COPYRIGHT
This is free software: you may copy, modify, and/or distribute
this work under the terms of the GNU General Public License,
version 2 or later as published by the Free Software Foundation.
No warranty expressed or implied. See the source for details.
.\" Generated by docutils manpage writer.
.\" 
.