docs/147347: [request] Missing memstick install setup instructions in Handbook

[Glen Barber]

The following reply was made to PR docs/147347; it has been noted by GNATS.

From: Glen Barber <glen.j.barber at gmail.com>
To: bug-followup at FreeBSD.org
Cc:  
Subject: Re: docs/147347: [request] Missing memstick install setup instructions
 in Handbook
Date: Mon, 26 Jul 2010 22:25:37 -0400

 This is a multi-part message in MIME format.
 --------------060203040505040401030906
 Content-Type: text/plain; charset=ISO-8859-1; format=flowed
 Content-Transfer-Encoding: 7bit
 
   Hi,
 
 I haven't received as much feedback as I would have liked on the patch I 
 submitted to doc@, so I will put it out in the open with the original PR.
 
 Regards,
 
 -- 
 Glen Barber
 
 
 --------------060203040505040401030906
 Content-Type: text/plain;
  name="chapter.sgml.txt"
 Content-Transfer-Encoding: 7bit
 Content-Disposition: attachment;
  filename="chapter.sgml.txt"
 
 --- handbook/install/chapter.sgml.orig	2010-07-19 17:03:42.763886000 -0400
 +++ handbook/install/chapter.sgml	2010-07-20 08:44:18.609955721 -0400
 @@ -630,6 +630,10 @@
  	</listitem>
  
  	<listitem>
 +	  <para>A USB Memory Stick</para>
 +	</listitem>
 +
 +	<listitem>
  	  <para>A DOS partition on the same computer</para>
  	</listitem>
  
 @@ -695,6 +699,13 @@
        <procedure>
  	<step>
  	  <title>Acquire the Boot Floppy Images</title>
 +
 +          <important>
 +            <para>Please note, as of &os; release 8.0, floppy disk
 +              images are no longer available.  Please see below for
 +              instructions on how to install &os; using a USB memory
 +              stick.</para>
 +          </important>
  	  
  	  <para>The boot disks are available on your installation media
  	    in the <filename>floppies/</filename> directory, and
 @@ -799,6 +810,70 @@
  	</step>
        </procedure>
  
 +      <para>To create a bootable memory stick, follow these steps:</para>
 +
 +      <procedure>
 +	<step>
 +	  <title>Acquire the Memory Stick Image</title>
 +	  
 +	  <para>The memory stick image can be downloaded from the
 +            <filename>ISO-IMAGES/</filename> directory from
 +	    <literal>ftp://ftp.FreeBSD.org/pub/FreeBSD/releases/<replaceable><arch></replaceable>/ISO-IMAGES/<replaceable><version></replaceable>/&rel.current;-RELEASE-<arch>-memstick.img</literal>.
 +	    Replace <replaceable><arch></replaceable> and
 +	    <replaceable><version></replaceable>
 +	    with the architecture and the version number
 +	    which you want to install, respectively.
 +	    For example, the memory stick images for
 +	    &os;/&arch.i386; &rel.current;-RELEASE are available
 +	    from <ulink url="ftp://ftp.FreeBSD.org/pub/FreeBSD/releases/&arch.i386;/ISO-IMAGES/&rel.current;/&rel.current;-RELEASE-&arch.i386;-memstick.img"></ulink>.</para>
 +
 +	  <para>The memory stick image has a <filename>.img</filename> extension.
 +	    The <filename>ISO-IMAGES/</filename> directory contains a number of
 +	    different images, and the ones you will need to use depends on the
 +	    version of FreeBSD you are installing, and in some cases, the
 +	    hardware you are installing to.</para>
 +
 +	  <important>
 +	    <para>Before proceeding, <emphasis>back up</emphasis> the
 +              data you currently have on your USB stick, as this
 +              procedure will <emphasis>erase</emphasis> it.</para>
 +	  </important>
 +	</step>
 +
 +	<step>
 +	  <title>Prepare the Memory Stick</title>
 +
 +          <warning>
 +            <para>The example below lists <literal>/dev/da0</literal>
 +              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>Replacing <replaceable>da0</replaceable> with the
 +            device your memory stick shows up as, erase the current
 +            data from the memory stick.</para>
 +
 +          <screen>&prompt.root; <userinput>dd if=/dev/zero of=/dev/<replaceable>da0</replaceable> bs=1k count=1</userinput></screen>
 +        </step>
 +	  
 +	<step>
 +	  <title>Write the Image File to the Memory Stick</title>
 +
 +	  <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 images directly to the
 +            disk:</para>
 +
 +          <screen>&prompt.root; <userinput>dd if=&rel.current;-RELEASE-&arch.i386;-memstick.img of=/dev/<replaceable>da0</replaceable> bs=64k</userinput></screen>
 +
 +	</step>
 +      </procedure>
 +
        <para>You are now ready to start installing FreeBSD.</para>
      </sect2>
    </sect1>
 
 --------------060203040505040401030906--