docs/154837: [patch] update Handbook for writing memstick image with Windows

[Warren Block]

>Number:         154837
>Category:       docs
>Synopsis:       [patch] update Handbook for writing memstick image with Windows
>Confidential:   no
>Severity:       non-critical
>Priority:       medium
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Thu Feb 17 01:10:04 UTC 2011
>Closed-Date:
>Last-Modified:
>Originator:     Warren Block
>Release:        8-stable
>Organization:
>Environment:
FreeBSD lightning 8.2-PRERELEASE FreeBSD 8.2-PRERELEASE #0: Tue Feb 15 18:21:28 MST 2011     root at lightning:/usr/obj/usr/src/sys/LIGHTNING  i386
>Description:
Add Windows instructions for writing a FreeBSD memstick.
>How-To-Repeat:
Look for memstick creation instructions for Windows users in the Handbook.
>Fix:
Apply patch.

Patch attached with submission follows:

--- en_US.ISO8859-1/books/handbook/install/chapter.sgml.orig	2011-01-16 23:41:02.000000000 -0700
+++ en_US.ISO8859-1/books/handbook/install/chapter.sgml	2011-01-17 00:51:56.000000000 -0700
@@ -631,35 +631,78 @@
 	</step>
 
 	<step>
-	  <title>Prepare the Memory Stick</title>
-
-	  <warning>
-	    <para>The example below lists
-	      <filename class="devicefile">/dev/da0</filename> as the target device from
-	      which you will be booting.  Be very careful that you
-	      have the correct device as the output target, or you may
-	      destroy your existing data.</para>
-	  </warning>
-
-	  <para>Set the <varname>kern.geom.debugflags</varname> sysctl
-	    to be able to write a master boot record to the target
-	    device.</para>
+	  <title>Write The Image File to the Memory Stick</title>
+	  
+	  <procedure>
+	    <title>Using FreeBSD To Write the Image</title>
 
-	  <screen><userinput>&prompt.root; sysctl kern.geom.debugflags=16</userinput></screen>
-	</step>
+	    <warning>
+	      <para>The example below lists
+	        <filename class="devicefile">/dev/da0</filename> as
+	      the target device where the image will be written. Be
+	      very careful that you have the correct device as the
+	      output target, or you may destroy your existing data.
+	      </para>
+	    </warning>
 
-	<step>
-	  <title>Write the Image File to the Memory Stick</title>
+	    <step>
+	      <title>Writing the Image with &man.dd.1;</title>
+	      
+	      <para>Set the <varname>kern.geom.debugflags</varname> sysctl
+	        to be able to write a master boot record to the target
+	        device.</para>
 
-	  <para>The <filename>.img</filename> file is
-	    <emphasis>not</emphasis> a regular file you copy to the
-	    memory stick.  It is an image of the complete contents of
-	    the disk.  This means that you <emphasis>cannot</emphasis>
-	    simply copy files from one disk to another.  Instead, you
-	    must use &man.dd.1; to write the image directly to the
-	    disk:</para>
+	      <screen><userinput>&prompt.root; sysctl kern.geom.debugflags=16</userinput></screen>
+	  
+	      <para>The <filename>.img</filename> file is
+	        <emphasis>not</emphasis> a regular file you copy to the
+	        memory stick.  It is an image of the complete contents of
+	        the disk.  This means that you <emphasis>cannot</emphasis>
+	        simply copy files from one disk to another.  Instead, you
+	        must use &man.dd.1; to write the image directly to the
+	        disk:</para>
+
+	      <screen>&prompt.root; <userinput>dd if=&os;-&rel.current;-RELEASE-&arch.i386;-memstick.img of=/dev/<replaceable>da0</replaceable> bs=64k</userinput></screen>
+	    </step>
+	  </procedure>
+	  
+	  <procedure>
+	    <title>Using &windows To Write the Image</title>
 
-	  <screen>&prompt.root; <userinput>dd if=&os;-&rel.current;-RELEASE-&arch.i386;-memstick.img of=/dev/<replaceable>da0</replaceable> bs=64k</userinput></screen>
+	    <warning>
+	      <para>The example below lists
+	        <filename class="devicefile">H:</filename> as the
+	        drive letter of the device where the image will be
+	        written.  Be very careful that you have the correct
+	        device as the output target, or you may destroy
+	        existing data.</para>
+	    </warning>
+	    
+	    <step>
+	      <title>Obtaining <application>Image Writer for Windows</application></title>
+	      
+	      <para><application>Image Writer for Windows</application>
+	        is a free application that can correctly write an
+	        image file to a memory stick.  Download it from 
+		<ulink url="http://launchpad.net/win32-image-writer/0.2/0.2/+download/win32diskimager-RELEASE-0.2-r23-win32.zip"></ulink>
+		and extract it into a folder.</para>
+	    </step>
+	    
+	    <step>
+	      <title>Writing The Image with Image Writer</title>
+	      
+	      <para>Double-click the <application>Win32DiskImager</application>
+	        icon to start the program.  Verify that the drive letter
+	        shown under <computeroutput>Device</computeroutput>
+	        is the drive with the memory stick.  Click the folder
+	        icon and select the image to be written to the memory
+	        stick.  Click <guibutton>Save</guibutton> to accept the
+	        image file name.  Verify that everything is correct, and
+	        that no folders on the memory stick are open in other
+	        windows.  Finally, click <guibutton>Write</guibutton> to
+	        write the image file to the drive.</para>
+	    </step>
+	  </procedure>
 	</step>
       </procedure>
 


>Release-Note:
>Audit-Trail:
>Unformatted: