In DVD burning section:

- Add a line on how to enable DMA access needed for the ATAPI burner
- Various rewordings and additions to improve the text
- Enhance the multisessions part
- Add credits to Andy Polyakov (growisofs author) who helped me a lot,
  thanks to you Andy!

en_US.ISO8859-1/books/handbook/disks/chapter.sgml

@@ -1230,6 +1230,13 @@ cd0: Attempt to query device size failed: NOT READY, Medium not present - tray c
 	  <contrib>Contributed by </contrib>
 	</author>
       </authorgroup>
+      <authorgroup>
+	<author>
+	  <firstname>Andy</firstname>
+	  <surname>Polyakov</surname>
+	  <contrib>With inputs from </contrib>
+	</author>
+      </authorgroup>
       <!-- Feb 2004 -->
     </sect1info>
 
@@ -1292,7 +1299,7 @@ cd0: Attempt to query device size failed: NOT READY, Medium not present - tray c
       <note>
 	<para>A difference must be done between the physical media and
 	  the application.   For example a DVD-Video is a specific
-	  file system that can be written on any recordable DVD
+	  file layout that can be written on any recordable DVD
 	  physical media: DVD-R, DVD+R, DVD-RW etc.  Before choosing
 	  the type of media, you just must be sure the burner and the
 	  DVD-Video player (a standalone player or a DVD-ROM drive on
@@ -1313,6 +1320,12 @@ cd0: Attempt to query device size failed: NOT READY, Medium not present - tray c
 	devices, therefore the <link linkend="atapicam">ATAPI/CAM
 	support</link> must be added to your kernel.</para>
 
+      <para>You also have to enable DMA access for ATAPI devices, this
+	can be done in adding the following line to the
+	<filename>/boot/loader.conf</filename> file:</para>
+
+      <programlisting>hw.ata.atapi_dma="1"</programlisting>
+
       <para>Before attempting to use the
 	<application>dvd+rw-tools</application> you should consult the
 	<ulink
@@ -1347,7 +1360,7 @@ cd0: Attempt to query device size failed: NOT READY, Medium not present - tray c
 	DVD device, <replaceable>/dev/cd0</replaceable>, must be
 	changed according to your configuration.  The
 	<option>-dvd-compat</option> parameter will close the disk,
-	the recording will be unappendable.  This should provide more
+	the recording will be unappendable.  In return this should provide better
 	media compatibility with DVD-ROM drives.</para>
 
       <para>It is also possible to burn a pre-mastered image, for
@@ -1371,9 +1384,9 @@ cd0: Attempt to query device size failed: NOT READY, Medium not present - tray c
     <sect2>
       <title>Burning a DVD-Video</title>
 
-      <para>A DVD-Video is a specific file system based on ISO 9660
+      <para>A DVD-Video is a specific file layout based on ISO 9660
 	and the micro-UDF (M-UDF) specifications.  The DVD-Video also
-	presents a specific file structure hierarchy, it is the reason
+	presents a specific data structure hierarchy, it is the reason
 	why you need a particular program such as <filename
 	role="package">sysutils/dvdauthor</filename> to author the
 	DVD.</para>
@@ -1387,9 +1400,11 @@ cd0: Attempt to query device size failed: NOT READY, Medium not present - tray c
 
       <screen>&prompt.root; <userinput>growisofs -Z <replaceable>/dev/cd0</replaceable> -dvd-video <replaceable>/path/to/video</replaceable></userinput></screen>
 
-      <para>The <option>-dvd-video</option> option will tell
+      <para>The <option>-dvd-video</option> option will be passed down to
-	&man.mkisofs.8; to create a DVD-Video file system
+	&man.mkisofs.8; and will instruct it to create a DVD-Video file system
-	layout.</para>
+	layout.  Beside this, the <option>-dvd-video</option> option
+	implies <option>-dvd-compat</option> &man.growisofs.1;
+	option.</para>
     </sect2>
 
     <indexterm>
@@ -1401,7 +1416,11 @@ cd0: Attempt to query device size failed: NOT READY, Medium not present - tray c
       <title>Using a DVD+RW</title>
 
       <para>Unlike CD-RW, a virgin DVD+RW needs to be formatted before
-	first use.  To format the DVD+RW, use the following:</para>
+	first use.  The &man.growisofs.1; program will take care of it
+	automatically whenever appropriate, which is the
+	<emphasis>recommended</emphasis> way.  However you can use the
+	<command>dvd+rw-format</command> command to format the
+	DVD+RW:</para>
 
       <screen>&prompt.root; <userinput>dvd+rw-format <replaceable>/dev/cd0</replaceable></userinput></screen>
 
@@ -1432,10 +1451,10 @@ cd0: Attempt to query device size failed: NOT READY, Medium not present - tray c
 	initial session should be used during next writes.</para>
 
       <note>
-	<para>You must not use the <option>-dvd-compat</option> option
+	<para>You may want to use the <option>-dvd-compat</option>
-	  during the initial session if you want to be able to append
+	  option if you want better media compatibility with DVD-ROM
-	  any data, or you will have to rewrite a new initial
+	  drives.  In the DVD+RW case, this will not prevent you from
-	  session.</para>
+	  adding data.</para>
       </note>
 
       <para>If for any reason you really want to blank the media, do
@@ -1529,6 +1548,20 @@ cd0: Attempt to query device size failed: NOT READY, Medium not present - tray c
 	will add a new session to the disc:</para>
 
       <screen>&prompt.root; <userinput>growisofs -M <replaceable>/dev/cd0</replaceable> -J -R <replaceable>/path/to/nextdata</replaceable></userinput></screen>
+
+      <para>Using this command with a DVD+RW or a DVD-RW in restricted
+	overwrite mode, will append data in merging the new session to
+	the existing one.  The result will be a single-session disc.
+	This is the way used to add data after an initial write on these
+	medias.</para>
+
+      <note>
+	<para>Some space on the media is used between each session for
+	  end and start of sessions.  Therefore, one should add
+	  sessions with large amount of data to optimize media space.
+	  The number of sessions is limited to 154 for a DVD+R and
+	  about 2000 for a DVD-R.</para>
+      </note>
     </sect2>
 
     <sect2>
@@ -1546,6 +1579,13 @@ cd0: Attempt to query device size failed: NOT READY, Medium not present - tray c
 	web site</ulink> and in the <ulink
 	url="http://lists.debian.org/cdwrite/">cdwrite mailing
 	list</ulink> archives.</para>
+
+      <note>
+	<para>The <command>dvd+rw-mediainfo</command> output of the
+	  resulting recording or the media with issues is mandatory
+	  for any problem report.  Without this output, it will be
+	  quite impossible to help you.</para>
+      </note>
     </sect2>
   </sect1>