svn commit: r45040 - head/en_US.ISO8859-1/books/handbook/bsdinstall

[Warren Block]

Author: wblock
Date: Tue Jun 10 03:35:04 2014
New Revision: 45040
URL: http://svnweb.freebsd.org/changeset/doc/45040

Log:
  Update the section on using dd(1) to write the USB stick.  Add a note on
  using sync(8) on Linux, and fix some terminology.

Modified:
  head/en_US.ISO8859-1/books/handbook/bsdinstall/chapter.xml

Modified: head/en_US.ISO8859-1/books/handbook/bsdinstall/chapter.xml
==============================================================================
--- head/en_US.ISO8859-1/books/handbook/bsdinstall/chapter.xml	Tue Jun 10 03:24:13 2014	(r45039)
+++ head/en_US.ISO8859-1/books/handbook/bsdinstall/chapter.xml	Tue Jun 10 03:35:04 2014	(r45040)
@@ -510,24 +510,24 @@
 	match exactly.  If the checksums do not match, the file is
 	corrupt and should be downloaded again.</para>
 
-      <sect3>
-	<title>Burning an Image File to <acronym>USB</acronym></title>
+      <sect3 xml:id="bsdinstall-usb">
+	<title>Writing an Image File to <acronym>USB</acronym></title>
 
-	<para>Since the <filename>*.img</filename> file is an
+	<para>The <filename>*.img</filename> file is an
 	  <emphasis>image</emphasis> of the complete contents of a
-	  memory stick, it <emphasis>cannot</emphasis> just be copied
-	  to the target device.  Several applications are available
-	  for burning the <filename>*.img</filename> to a
+	  memory stick.  It <emphasis>cannot</emphasis> be copied
+	  to the target device as a file.  Several applications are available
+	  for writing the <filename>*.img</filename> to a
 	  <acronym>USB</acronym> stick.  This section describes two of
 	  these utilities.</para>
 
 	<important>
 	  <para>Before proceeding, back up any important data on the
-	    <acronym>USB</acronym> stick as this procedure will erase
+	    <acronym>USB</acronym> stick.  This procedure will erase
 	    the existing data on the stick.</para>
 	</important>
 
-	<procedure>
+	<procedure xml:id="bsdinstall-usb-dd">
 	  <title>Using <command>dd</command> to Write the
 	    Image</title>
 
@@ -540,8 +540,8 @@
 	  </warning>
 
 	  <step>
-	    <para>The <command>dd</command> command-line utility is
-	      included on BSD, Linux, and &macos; systems.  To burn
+	    <para>The &man.dd.1; command-line utility is
+	      available on BSD, &linux;, and &macos; systems.  To burn
 	      the image using <command>dd</command>, insert the
 	      <acronym>USB</acronym> stick and determine its device
 	      name.  Then, specify the name of the downloaded
@@ -553,11 +553,13 @@
 
 	    <screen>&prompt.root; <userinput>dd if=<replaceable>FreeBSD-10.0-RELEASE-amd64-memstick.img</replaceable> of=/dev/<replaceable>da0</replaceable> bs=64k</userinput></screen>
 
-	    <para>Should this command fail, verify that the
+	    <para>If this command fails, verify that the
 	      <acronym>USB</acronym> stick is not mounted and that the
-	      device name is for the disk, not a partition.  Depending
-	      upon the operating system, this command may need to be
-	      issued using <command>sudo</command>.</para>
+	      device name is for the disk, not a partition.  Some
+	      operating systems might require this command to be run
+	      with &man.sudo.8;.  Systems like &linux; might buffer
+	      writes.  To force all writes to complete, use
+	      &man.sync.8;.</para>
 	  </step>
 	</procedure>
 
@@ -897,9 +899,9 @@ Ethernet address 0:3:ba:b:92:d4, Host ID
     <para>This section shows the order of the
       <application>bsdinstall</application> menus and the type of
       information that will be asked before the system is installed.
-      Use the arrow keys to highlight a menu option, then the
-      <keycap>Space</keycap> key to select or deselect that menu item.
-      When finished, use <keycap>Enter</keycap> to save the selection
+      Use the arrow keys to highlight a menu option, then
+      <keycap>Space</keycap> to select or deselect that menu item.
+      When finished, press <keycap>Enter</keycap> to save the selection
       and move onto the next screen.</para>
 
     <sect2 xml:id="bsdinstall-keymap">