From nobody@FreeBSD.org  Thu Feb 17 01:01:19 2011
Return-Path: <nobody@FreeBSD.org>
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id 8C09C106566B
	for <freebsd-gnats-submit@FreeBSD.org>; Thu, 17 Feb 2011 01:01:19 +0000 (UTC)
	(envelope-from nobody@FreeBSD.org)
Received: from red.freebsd.org (red.freebsd.org [IPv6:2001:4f8:fff6::22])
	by mx1.freebsd.org (Postfix) with ESMTP id 7C5E88FC15
	for <freebsd-gnats-submit@FreeBSD.org>; Thu, 17 Feb 2011 01:01:19 +0000 (UTC)
Received: from red.freebsd.org (localhost [127.0.0.1])
	by red.freebsd.org (8.14.4/8.14.4) with ESMTP id p1H11JhL072985
	for <freebsd-gnats-submit@FreeBSD.org>; Thu, 17 Feb 2011 01:01:19 GMT
	(envelope-from nobody@red.freebsd.org)
Received: (from nobody@localhost)
	by red.freebsd.org (8.14.4/8.14.4/Submit) id p1H11Jr4072984;
	Thu, 17 Feb 2011 01:01:19 GMT
	(envelope-from nobody)
Message-Id: <201102170101.p1H11Jr4072984@red.freebsd.org>
Date: Thu, 17 Feb 2011 01:01:19 GMT
From: Warren Block <wblock@wonkity.com>
To: freebsd-gnats-submit@FreeBSD.org
Subject: [patch] update Handbook for writing memstick image with Windows
X-Send-Pr-Version: www-3.1
X-GNATS-Notify:

>Number:         154837
>Category:       docs
>Synopsis:       [patch] update Handbook for writing memstick image with Windows
>Confidential:   no
>Severity:       non-critical
>Priority:       medium
>Responsible:    keramida
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Thu Feb 17 01:10:04 UTC 2011
>Closed-Date:    Thu Feb 17 09:21:34 UTC 2011
>Last-Modified:  Thu Feb 17 09:21:34 UTC 2011
>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@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:
Responsible-Changed-From-To: freebsd-doc->keramida 
Responsible-Changed-By: keramida 
Responsible-Changed-When: Thu Feb 17 09:12:04 UTC 2011 
Responsible-Changed-Why:  
I'll handle this. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=154837 

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/154837: commit references a PR
Date: Thu, 17 Feb 2011 09:17:48 +0000 (UTC)

 keramida    2011-02-17 09:17:43 UTC
 
   FreeBSD doc repository
 
   Modified files:
     en_US.ISO8859-1/books/handbook/install chapter.sgml 
   Log:
   Add instructions for writing the memstick image from Windows machines.
   
   Switch 'Prepare the Memory Stick' to a more generic title.  Move the dd
   based FreeBSD-specific instructions to a separate <procedure> and add a
   second procedure, that is more useful to Windows users.  The
   instructions for Windows refer to the 'Image Writer' utility, including
   its download location.
   
   PR:             docs/154837
   Submitted by:   Warren Block <wblock@wonkity.com>
   
   Revision  Changes    Path
   1.417     +60 -6     doc/en_US.ISO8859-1/books/handbook/install/chapter.sgml
 _______________________________________________
 cvs-all@freebsd.org mailing list
 http://lists.freebsd.org/mailman/listinfo/cvs-all
 To unsubscribe, send any mail to "cvs-all-unsubscribe@freebsd.org"
 
State-Changed-From-To: open->closed 
State-Changed-By: keramida 
State-Changed-When: Thu Feb 17 09:20:55 UTC 2011 
State-Changed-Why:  
Committed, in revision 1.417 of handbook/install/chapter.sgml 

Thanks! 

http://www.freebsd.org/cgi/query-pr.cgi?pr=154837 
>Unformatted:
