summaryrefslogtreecommitdiffstats
path: root/usr.sbin
diff options
context:
space:
mode:
authorru <ru@FreeBSD.org>2001-01-11 08:16:46 +0000
committerru <ru@FreeBSD.org>2001-01-11 08:16:46 +0000
commit57085b0c62ecd52c3a1ba964226ba89319fc25b2 (patch)
tree3d32c8dc63fb54d9c61401db07786181c237874e /usr.sbin
parent9d27a6e8b5c8262fff7b20ceaa4c327139687574 (diff)
downloadFreeBSD-src-57085b0c62ecd52c3a1ba964226ba89319fc25b2.zip
FreeBSD-src-57085b0c62ecd52c3a1ba964226ba89319fc25b2.tar.gz
mdoc(7) police: formatting fixes.
Diffstat (limited to 'usr.sbin')
-rw-r--r--usr.sbin/burncd/burncd.884
1 files changed, 52 insertions, 32 deletions
diff --git a/usr.sbin/burncd/burncd.8 b/usr.sbin/burncd/burncd.8
index 24ba84f..850e5a0 100644
--- a/usr.sbin/burncd/burncd.8
+++ b/usr.sbin/burncd/burncd.8
@@ -1,4 +1,4 @@
-.\"
+.\"
.\" Copyright (c) 2000,2001 Søren Schmidt
.\" All rights reserved.
.\"
@@ -38,13 +38,13 @@
.Op Fl f Ar device
.Op Fl s Ar speed
.Op Fl e
-.Op Fl l
+.Op Fl l
.Op Fl m
.Op Fl p
.Op Fl q
.Op Fl t
-.Ar [command]
-.Ar [command filename...]
+.Op Ar command
+.Op Ar command Ar
.Sh DESCRIPTION
The
.Nm
@@ -53,13 +53,14 @@ utility is used to burn CD-R/RW media using the ATAPI cd driver.
Available options and operands:
.Pp
.Bl -tag -width XXXXXXXXXXXX
-.It Fl f Ar device
+.It Fl f Ar device
set the device to use for the burning process.
.It Fl s Ar speed
-set the speed of the burner device. Defaults to 1.
+set the speed of the burner device.
+Defaults to 1.
.It Fl e
eject the media when done.
-.It Fl l
+.It Fl l
read a list of image files from filename.
.It Fl m
close disk in multisession mode (otherwise disk is closed as singlesession).
@@ -71,62 +72,79 @@ quiet, do not print progress messages.
test write, do not actually write on the media.
.El
.Pp
-.Ar command
+.Ar command
may be one of:
.Pp
.Bl -tag -width XXXXXXXXXXXX
-.It Ar msinfo
-Show the first LBA of the last track on the media
+.It Cm msinfo
+Show the first LBA of the last track on the media
and the next writeable address on the media for use with the
.Xr mkisofs 1 Ns 's
-.Fl C
+.Fl C
switch when adding additional data to ISO filesystems with extra sessions.
-.It Ar blank
+.It Cm blank
Blank a CD-RW medium.
-This uses the fast blanking method, so data are not physically overwritten, only those areas that make the media appear blank for further usage are erased.
-.It Ar erase
+This uses the fast blanking method, so data are not physically overwritten,
+only those areas that make the media appear blank for further usage are erased.
+.It Cm erase
Erase a CD-RW medium.
-This erases the entire media. Can take up to 1 hour to finish.
-.It Ar fixate
-Fixate the medium so that the TOC is generated and the media can be used in an ordinary CD drive. The driver defaults to creating singlesession media (see -m option).
-Should be the last command to
+This erases the entire media.
+Can take up to 1 hour to finish.
+.It Cm fixate
+Fixate the medium so that the TOC is generated and the media can be used
+in an ordinary CD drive.
+The driver defaults to creating singlesession media (see
+.Fl m
+option).
+Should be the last command to
.Nm
as the program exits when this has been done.
-.It Ar raw | audio
-Set the write mode to produce audio (raw mode) tracks for the following images on the command line.
-.It Ar data | mode1
-Set the write mode to produce data (mode1) tracks for the following image files
+.It Cm raw | audio
+Set the write mode to produce audio (raw mode) tracks for the following
+images on the command line.
+.It Cm data | mode1
+Set the write mode to produce data (mode1) tracks for the following
+image files
on the command line.
-.It Ar mode2
-Set the write mode to produce data (mode2) tracks for the following image files
+.It Cm mode2
+Set the write mode to produce data (mode2) tracks for the following
+image files
on the command line.
-.It Ar XAmode1
+.It Cm XAmode1
Set the write mode to produce data (XAmode1) tracks for the following image
files on the command line.
-.It Ar filename
-All other arguments are treated as filenames of images to write to the media, or
-in case the -l option is used as files containing lists of images.
+.It Ar file
+All other arguments are treated as filenames of images to write to the media,
+or in case the
+.Fl l
+option is used as files containing lists of images.
.El
.Pp
-Files whose length are not a multiple of the current media blocksize are quietly zero padded to fit the blocksize requirement. The conventional filename "-" refers to stdin, and can only be used once.
-.Pp
+Files whose length are not a multiple of the current media blocksize are
+quietly zero padded to fit the blocksize requirement.
+The conventional filename
+.Fl
+refers to stdin, and can only be used once.
.Sh EXAMPLES
The typical usage for burning a data CD-R:
.Bd -literal
# burncd -f /dev/acd0c data file1 fixate
+.Ed
.Pp
The typical usage for burning an audio CD-R:
.Bd -literal
# burncd -f /dev/acd0c audio file1 file2 file3 fixate
+.Ed
.Pp
The typical usage for burning a mixed mode CD-R:
.Bd -literal
# burncd -f /dev/acd0c data file1 audio file2 file3 fixate
+.Ed
.Pp
The typical usage for burning from a compressed image file on stdin:
.Bd -literal
# gunzip -c file.iso.gz | burncd -f /dev/acd0c data - fixate
-.Pp
+.Ed
.Sh BUGS
Probably, please report when found.
.Sh HISTORY
@@ -138,4 +156,6 @@ command appeared in
The
.Nm
command and this manpage was contributed by
-.An S\(/oren Schmidt, Denmark (sos@freebsd.org).
+.An S\(/oren Schmidt ,
+Denmark
+.Pq sos@FreeBSD.org .
OpenPOWER on IntegriCloud