diff DOCS/xml/en/cd-dvd.xml @ 21521:b210a229fbcb

General reformatting round: - fix some " -> &quot; - reindent with more consistency - visual markup of <sect?> tags - break overly long lines - add missing <replaceable> tags in examples - cola truck standing by

--- a/DOCS/xml/en/cd-dvd.xml	Fri Dec 08 09:50:12 2006 +0000
+++ b/DOCS/xml/en/cd-dvd.xml	Fri Dec 08 11:38:06 2006 +0000
@@ -14,16 +14,18 @@
 
 <itemizedlist>
 <listitem><para>
-There have been reports of read errors at high speeds, especially
-with badly pressed CD-ROMs. Reducing the speed can prevent data loss under
-these circumstances.
+  There have been reports of read errors at high speeds, especially
+  with badly pressed CD-ROMs. Reducing the speed can prevent data loss under
+  these circumstances.
 </para></listitem>
 
 <listitem><para>
-Many CD-ROM drives are annoyingly loud, a lower speed may reduce the noise.
+  Many CD-ROM drives are annoyingly loud, a lower speed may reduce the noise.
 </para></listitem>
 </itemizedlist>
 
+<!-- ********** -->
+
 <sect2 id="drives_linux">
 <title>Linux</title>
 
@@ -49,28 +51,30 @@
 This sets prefetched file reading to 2MB, which helps with scratched CD-ROMs.
 If you set it to too high, the drive will continuously spin up and down, and
 will dramatically decrease the performance.
-It is recommended that you also tune your CD-ROM drive with <command>hdparm</command>:
+It is recommended that you also tune your CD-ROM drive
+with <command>hdparm</command>:
 <screen>hdparm -d1 -a8 -u1 <replaceable>[cdrom device]</replaceable></screen>
 </para>
 
 <para>
-This enables DMA access, read-ahead, and IRQ unmasking (read the <command>hdparm</command>
-man page for a detailed explanation).
+This enables DMA access, read-ahead, and IRQ unmasking (read the
+<command>hdparm</command> man page for a detailed explanation).
 </para>
 
 <para>
-Please refer to &quot;<filename>/proc/ide/<replaceable>[cdrom device]</replaceable>/settings</filename>&quot;
+Please refer to
+&quot;<filename>/proc/ide/<replaceable>[cdrom device]</replaceable>/settings</filename>&quot;
 for fine-tuning your CD-ROM.
 </para>
 
 <para>
-SCSI drives do not have a uniform way of setting these parameters (Do you know one?
-Tell us!) There is a tool that works for
+SCSI drives do not have a uniform way of setting these parameters (Do you know
+one? Tell us!) There is a tool that works for
 <ulink url="http://das.ist.org/~georg/">Plextor SCSI drives</ulink>.
 </para>
-
 </sect2>
 
+<!-- ********** -->
 
 <sect2 id="drives_freebsd">
 <title>FreeBSD</title>
@@ -92,13 +96,18 @@
 </sect1>
 
 
+<!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -->
+
 
 <sect1 id="dvd">
 <title>DVD playback</title>
+
 <para>
 For the complete list of available options, please read the man page.
 The syntax to play a standard DVD is as follows:
-<screen>mplayer dvd://<replaceable>&lt;track&gt;</replaceable> [-dvd-device <replaceable>&lt;device&gt;</replaceable>]</screen>
+<screen>
+mplayer dvd://<replaceable>&lt;track&gt;</replaceable> [-dvd-device <replaceable>&lt;device&gt;</replaceable>]
+</screen>
 </para>
 
 <para>
@@ -200,12 +209,15 @@
 </sect1>
 
 
+<!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -->
+
 
 <sect1 id="vcd">
 <title>VCD playback</title>
+
 <para>
-For the complete list of available options, please read the man page. The Syntax for a
-standard Video CD (VCD) is as follows:
+For the complete list of available options, please read the man page. The
+Syntax for a standard Video CD (VCD) is as follows:
 <screen>mplayer vcd://<replaceable>&lt;track&gt;</replaceable> [-cdrom-device <replaceable>&lt;device&gt;</replaceable>]</screen>
 Example:
 <screen>mplayer vcd://2 -cdrom-device /dev/hdc</screen>
@@ -230,50 +242,50 @@
 
 <formalpara>
 <title>VCD structure</title>
-
 <para>
 A Video CD (VCD) is made up of CD-ROM XA sectors, i.e. CD-ROM mode 2
-form 1 and 2 tracks:</para>
-</formalpara>
-
+form 1 and 2 tracks:
 <itemizedlist>
 <listitem><para>
-The first track is in mode 2 form 2 format which means it uses L2
-error correction. The track contains an ISO-9660 filesystem with 2048
-bytes/sector. This filesystem contains VCD metadata information, as
-well as still frames often used in menus. MPEG segments for menus can
-also be stored in this first track, but the MPEGs have to be broken up
-into a series of 150-sector chunks. The ISO-9660 filesystem may
-contain other files or programs that are not essential for VCD
-operation.
+  The first track is in mode 2 form 2 format which means it uses L2
+  error correction. The track contains an ISO-9660 filesystem with 2048
+  bytes/sector. This filesystem contains VCD metadata information, as
+  well as still frames often used in menus. MPEG segments for menus can
+  also be stored in this first track, but the MPEGs have to be broken up
+  into a series of 150-sector chunks. The ISO-9660 filesystem may
+  contain other files or programs that are not essential for VCD
+  operation.
 </para></listitem>
 
 <listitem><para>
-The second and remaining tracks are generally raw 2324 bytes/sector
-MPEG (movie) tracks, containing one MPEG PS data packet per
-sector. These are in mode 2 form 1 format, so they store more data per
-sector at the loss of some error correction. It is also legal to have
-CD-DA tracks in a VCD after the first track as well.
-On some operating systems there is some trickery that goes on to make
-these non-ISO-9660 tracks appear in a filesystem. On other operating
-systems like GNU/Linux this is not the case (yet). Here the MPEG data
-<emphasis role="bold">cannot be mounted</emphasis>. As most movies are
-inside this kind of track, you should try <option>vcd://2</option>
-first.</para></listitem>
+  The second and remaining tracks are generally raw 2324 bytes/sector
+  MPEG (movie) tracks, containing one MPEG PS data packet per
+  sector. These are in mode 2 form 1 format, so they store more data per
+  sector at the loss of some error correction. It is also legal to have
+  CD-DA tracks in a VCD after the first track as well.
+  On some operating systems there is some trickery that goes on to make
+  these non-ISO-9660 tracks appear in a filesystem. On other operating
+  systems like GNU/Linux this is not the case (yet). Here the MPEG data
+  <emphasis role="bold">cannot be mounted</emphasis>. As most movies are
+  inside this kind of track, you should try <option>vcd://2</option>
+  first.
+</para></listitem>
 
 <listitem><para>
-There exist VCD disks without the first track (single track and no filesystem
-at all). They are still playable, but cannot be mounted.
+  There exist VCD disks without the first track (single track and no filesystem
+  at all). They are still playable, but cannot be mounted.
 </para></listitem>
 
-<listitem><para> The definition of the Video CD standard is called the
-Philips "White Book" and it is not generally available online as it
-must be purchased from Philips. More detailed information about Video
-CDs can be found in the
-<ulink url="http://www.vcdimager.org/pub/vcdimager/manuals/0.7/vcdimager.html#SEC4">vcdimager documentation</ulink>.
+<listitem><para>
+  The definition of the Video CD standard is called the
+  Philips "White Book" and it is not generally available online as it
+  must be purchased from Philips. More detailed information about Video
+  CDs can be found in the
+  <ulink url="http://www.vcdimager.org/pub/vcdimager/manuals/0.7/vcdimager.html#SEC4">vcdimager documentation</ulink>.
 </para></listitem>
-
 </itemizedlist>
+</para>
+</formalpara>
 
 <formalpara>
 <title>About .DAT files</title>
@@ -287,12 +299,13 @@
 be found in the Linux version of PowerDVD. It has a modified iso9660 filesystem
 (<filename>vcdfs/isofs-2.4.X.o</filename>) driver, which is able to emulate the
 raw tracks through this shadow .DAT file. If you mount the disc using their
-driver, you can copy and even play .DAT files with <application>MPlayer</application>. But it will not
+driver, you can copy and even play .DAT files with
+<application>MPlayer</application>. But it will not
 work with the standard iso9660 driver of the Linux kernel! Use
 <option>vcd://</option> instead. Alternatives for VCD copying are the
 new <ulink url="http://www.elis.rug.ac.be/~ronsse/cdfs/">cdfs</ulink> kernel
-driver (not part of the official kernel) that shows CD sessions as image files and
-<ulink url="http://cdrdao.sf.net/">cdrdao</ulink>, a bit-by-bit
+driver (not part of the official kernel) that shows CD sessions as image files
+and <ulink url="http://cdrdao.sf.net/">cdrdao</ulink>, a bit-by-bit
 CD grabbing/copying application.
 </para>
 </formalpara>