From 5b430cd70086f535e9673d87d936ce9abd227a44 Mon Sep 17 00:00:00 2001
From: "Jordan K. Hubbard" <jkh@FreeBSD.org>
Date: Mon, 15 Feb 1999 17:54:23 +0000
Subject: [PATCH] Update installation notes for a two floppy world. Remove a
 special character that the sgml formatting tools were complaining about.

---
 handbook/install.sgml    | 95 +++++++++++++++++-----------------------
 handbook/submitters.sgml |  4 +-
 2 files changed, 41 insertions(+), 58 deletions(-)

diff --git a/handbook/install.sgml b/handbook/install.sgml
index 8d28e1e0e7..5d46a99a9d 100644
--- a/handbook/install.sgml
+++ b/handbook/install.sgml
@@ -1,4 +1,4 @@
-<!-- $Id: install.sgml,v 1.67 1998-10-13 09:09:48 jkoshy Exp $ -->
+<!-- $Id: install.sgml,v 1.68 1999-02-15 17:54:23 jkh Exp $ -->
 <!-- The FreeBSD Documentation Project -->
 
 <!--
@@ -14,7 +14,7 @@
       anonymous ftp or NFS.  
 
       Regardless of the installation media you choose, you can
-      get started by creating the <bf>installation disk</bf>
+      get started by creating the <bf>installation disks</bf>
       as described below.  Booting your computer into the FreeBSD installer,
       even if you aren't planning on installing FreeBSD right away, will
       provide important information about compatibility between
@@ -63,20 +63,18 @@
 
 	  <item><p>If either of the two proceeding methods work then you can
 	  simply skip the rest of this section, otherwise your final option
-	  is to create a boot floppy from the <tt>floppies\boot.flp</tt>
-	  image - proceed to step 4 for instructions on how to do
+	  is to create a set of boot floppies from the
+          <tt>floppies\kern.flp</tt> and <tt>floppies\mfsroot.flp</tt>
+	  images - proceed to step 4 for instructions on how to do
 	  this.</p></item>
 	</itemize></P></item>
 
-      <item><p>If you don't have a CDROM distribution then simply download the <url
-	  url="ftp://ftp.FreeBSD.ORG/pub/FreeBSD/&rel.current;-RELEASE/floppies/boot.flp"
-	  name="installation boot disk image"> file to your hard
-	  drive, being sure to tell your browser to
-	  <em>save</em> rather than <em>display</em> the file.
-	  <bf>Note:</bf> This disk image can only be used with
-	  1.44 megabyte 3.5 inch floppy disks.</p></item>
+      <item><p>If you don't have a CDROM distribution then simply read the <url
+	  url="ftp://ftp.FreeBSD.ORG/pub/FreeBSD/&rel.current;-RELEASE/floppies/README.TXT"
+	  name="installation boot image information"> to find out what files
+          you need to download first.
 
-      <item><p>Make the installation boot disk from the image file:
+      <item><p>Make the installation boot disks from the image files:
 	<itemize>
 	  <item><p>If you are using MS-DOS then download 
 	    <url 
@@ -84,17 +82,18 @@ url="ftp://ftp.FreeBSD.ORG/pub/FreeBSD/tools/fdimage.exe"
 	      name="fdimage.exe"> or get it from <tt>tools\fdimage.exe</tt>
 	    on the CDROM and then run it like so:
 <tscreen><verb>
-E:\> tools\fdimage floppies\boot.flp a:
+E:\> tools\fdimage floppies\kern.flp a:
 </verb></tscreen> The <em>fdimage</em>
 	    program will format the A: drive and then copy the
-            boot.flp image onto it (assuming that you're at the top
+            kern.flp image onto it (assuming that you're at the top
             level of a FreeBSD distribution and the floppy images
             live in the floppies subdirectory, as is typically the case).
+            Do the same for the mfsroot.flp image and you're set.
 	    </p></item>
 
-	  <item><p>If you are using a UNIX system to create the floppy image:
+	  <item><p>If you are using a UNIX system to create the floppy images:
 <tscreen>
-% dd if=boot.flp of=<em>disk&lowbar;device</em>
+% dd if=kern.flp of=<em>disk&lowbar;device</em>
 </tscreen>
 	    where <em>disk&lowbar;device</em> is the <tt>/dev</tt>
 	    entry for the floppy drive.  On FreeBSD systems, this
@@ -103,16 +102,12 @@ E:\> tools\fdimage floppies\boot.flp a:
 	</itemize>
       </p></item>
 
-      <item><p>With the installation disk in the A: drive, reboot your
-	computer.  You should get a boot prompt something like this:
-	<tscreen>
-&gt;&gt; FreeBSD BOOT ...<newline>
-Usage: &lsqb;&lsqb;&lsqb;0:&rsqb;&lsqb;wd&rsqb;(0,a)&rsqb;/kernel&rsqb;&lsqb;-abcCdhrsv&rsqb;<newline>
-Use 1:sd(0,a)kernel to boot sd0 if it is BIOS drive 1<newline>
-Use ? for file list or press Enter for defaults<newline>
-Boot: 
-	</tscreen>
-	If you do <em>not</em> type anything, FreeBSD will automatically boot
+      <item><p>With the kern.flp disk in the A: drive, reboot your
+	computer.  The next request you should get is for the mfsroot.flp
+	image, after which the installation will proceed normally.
+
+	If you do <em>not</em> type anything at the boot prompt which
+	appears during this process, FreeBSD will automatically boot
 	with its default configuration after a delay of about
 	five seconds.  As FreeBSD boots, it probes your computer
 	to determine what hardware is installed.  The results of
@@ -134,21 +129,24 @@ Boot:
       sure that your hardware is indeed supported by FreeBSD.  
 
     <p>If your hardware is supported, reset the computer and when
-      the <tt>Boot:</tt> prompt comes up, type <bf>-c</bf>.  This puts
-      FreeBSD into a configuration mode where you can supply
+      the visual kernel configuration choice is presented, take it. 
+      This puts FreeBSD into a configuration mode where you can supply
       hints about your hardware.  The FreeBSD kernel on the
       installation disk is configured assuming that most hardware
       devices are in their factory default configuration in terms
       of IRQs, IO addresses and DMA channels.  If your hardware
       has been reconfigured, you will most likely need to use the
-      <bf>-c</bf> option at boot to tell FreeBSD where things are.
+      confiration editor to tell FreeBSD where things are.
 
     <p>It is also possible that a probe for a device not present
       will cause a later probe for another device that is present
       to fail.  In that case, the probes for the conflicting
       driver(s) should be disabled.
       Do not disable any device you will need during installation, 
-      such as your screen (<tt>sc0</tt>).
+      such as your screen (<tt>sc0</tt>).  If the installation wedges
+      or fails mysteriously after leaving the configuration editor,
+      you've probably removed or changed something you shouldn't have.
+      Simply reboot and try again.
 
     <p>In the configuration mode, you can:
 
@@ -160,12 +158,9 @@ Boot:
 	device driver.</item>
     </itemize>
 
-    <p>While at the <tt>config&gt;</tt> prompt, type
-      <tt>help</tt> for more information on the available
-      commands.  After adjusting the kernel to match how you have
-      your hardware configured, type <tt>quit</tt> at the
-      <tt>config&gt;</tt> prompt to continue booting with the new
-      settings.  
+    <p>After adjusting the kernel to match how you have
+      your hardware configured, type <tt>Q</tt> to continue booting
+      with the new settings.  
 
       After FreeBSD has been installed, changes made in the
       configuration mode will be permanent so you do not have
@@ -408,10 +403,8 @@ Boot:
 	  CDROM distributions may work as well, though we cannot say for certain
 	  as we have no hand or say in how they are created).  You can either
 	  boot into the CD installation directly from DOS using Walnut Creek's
-	  supplied ``install.bat'' batch file or you can make a boot floppy with
-	  the ``makeflp.bat'' command.  [NOTE:  If you are running
-	  FreeBSD 2.1-RELEASE and have an IDE CDROM, use the
-	  inst&lowbar;ide.bat or atapiflp.bat batch files instead].
+	  supplied ``install.bat'' batch file or you can make boot floppies with
+	  the ``makeflp.bat'' command.
 
 	  For the easiest interface of all (from DOS), type
 	  ``view''.  This will bring up a DOS menu utility that
@@ -419,7 +412,7 @@ Boot:
 
 	  If you are creating the boot floppy from a UNIX machine,
 	  see <ref id="install" name="the beginning of this
-	  guide"> for examples. of how to create the boot floppy.
+	  guide"> for examples. of how to create the boot floppies.
 
 	  Once you have booted from DOS or floppy, you should then
 	  be able to select CDROM as the media type in the Media
@@ -740,7 +733,7 @@ ftp://foo.bar.com:1234/pub/FreeBSD
 	provided on the boot floppy for a list of possible
 	solutions.
 
-	The FreeBSD boot floppy contains all the on-line
+	The FreeBSD boot floppies contains all the on-line
 	documentation you should need to be able to navigate
 	through an installation and if it does not then we would
 	like to know what you found most confusing.  Send your
@@ -755,11 +748,12 @@ ftp://foo.bar.com:1234/pub/FreeBSD
 	installation sequence'' to be helpful:
 
 	<enum>
-	  <item>Boot the boot floppy.  After a boot sequence
-	    which can take anywhere from 30 seconds to 3
+	  <item>Boot the kern.flp floppy and, when asked, remove it and
+	    insert the mfsroot.flp floppy and hit return.  After a boot
+	    sequence which can take anywhere from 30 seconds to 3
 	    minutes, depending on your hardware, you should be
 	    presented with a menu of initial choices.  If the
-	    floppy does not boot at all, or the boot hangs at some
+	    kern floppy does not boot at all, or the boot hangs at some
 	    stage, go read the Q&amp;A section of the Hardware Guide
 	    for possible causes.
 
@@ -845,14 +839,3 @@ ftp://foo.bar.com:1234/pub/FreeBSD
 <tscreen><verb>
 mount -t msdos /dev/sd0s5 /dos_d
 </verb></tscreen>
-
-	<bf>Can I run MS-DOS binaries under FreeBSD?</bf>
-
-	BSDI has donated their DOS emulator to the BSD world and
-	this has been ported to FreeBSD.
-
-	There is also a (technically) nice application available in the
-	<ref id="ports" name="The Ports Collection"> called pcemu
-	which allows you to run many basic MS-DOS text-mode binaries
-	by entirely emulating an 8088 CPU.
-
diff --git a/handbook/submitters.sgml b/handbook/submitters.sgml
index 11ba9c300d..21881da580 100644
--- a/handbook/submitters.sgml
+++ b/handbook/submitters.sgml
@@ -1,4 +1,4 @@
-<!-- $Id: submitters.sgml,v 1.291 1999-02-13 17:41:52 jkh Exp $ -->
+<!-- $Id: submitters.sgml,v 1.292 1999-02-15 17:54:23 jkh Exp $ -->
 <!-- The FreeBSD Documentation Project -->
 
 <chapt><heading>Contributing to FreeBSD<label id="contrib"></heading>
@@ -2803,7 +2803,7 @@ id="contrib:additional"></heading>
         name='&lt;mouse@Collatz.McRCIM.McGill.EDU&gt;'></tt>
   <item>frf <tt><htmlurl url='mailto:frf@xocolatl.com'
         name='&lt;frf@xocolatl.com&gt;'></tt>
-  <item>Ege Rekk <tt><htmlurl url='mailto:aagero@aage.priv.no'
+  <item>Ege Rekk <tt><htmlurl url='mailto:aagero@aage.priv.no'
         name='&lt;aagero@aage.priv.no&gt;'></tt>
 </itemize>