- improved section "What does Bochs need?"

bochs/doc/docbook/user/user.dbk

@@ -1,7 +1,7 @@
 <!--
 ================================================================
 doc/docbook/user/user.dbk
-$Id: user.dbk,v 1.122 2003-08-02 15:20:53 vruppert Exp $
+$Id: user.dbk,v 1.123 2003-08-03 08:56:02 vruppert Exp $
 
 This is the top level file for the Bochs Users Manual.
 ================================================================
@@ -2613,22 +2613,55 @@ just reboot.
 </chapter>
 
 <chapter id="setup"><title>Setup</title>
-   <section><title>What does Bochs need?</title>
-     <para> &FIXME; </para>
-      <para>
-        <screen>
-        - bochsrc, BIOS, VGABIOS, disk images.
+<section><title>What does Bochs need?</title>
+<para>
+These are the minimum requirements for running an OS inside of Bochs:
+<screen>
+- the bochs executable
+- the bios image (usually called 'BIOS-bochs-latest')
+- the vga bios image (e.g. 'VGABIOS-lgpl-latest')
+- at least one bootable disk image (floppy or harddisk)
+</screen>
+</para>
+<para>
+In that case you have to pass the configuration options on the command
+line or to use the configuration interface to set up Bochs for the simulation.
+Running Bochs is easier if you use a configuration file (we call it 'bochsrc').
+See section <link linkend="bochsrc">bochsrc</link> for all supported options.
+</para>
+
+<para>
+If your keyboard output inside of Bochs is wrong, you may also need a keymap file
+to remap your keyboard layout to the U.S. layout. A set of keymap files for the
+X window system and SDL (Linux port) is distributed with Bochs. If your
+keyboard layout is not supported yet, you should have a look at the section
+<link linkend="keymap">How to write your own keymap table</link>.
+</para>
+
+<para>
+A collection of disk images  of different operating systems can be found at
+<ulink url="http://bochs.sourceforge.net/diskimages.html"></ulink>. Some disk
+images are the size of a floppy disk (1 meg compressed) and others are gigantic
+(160 meg compressed). If you want to create a disk image yourself, please see
+the section <link linkend="diskimagehowto">How to make a disk image</link>.
+</para>
+
+<para> &FIXME; This should be completed </para>
+<para>
+<screen>
+  - (DONE )bochsrc, BIOS, VGABIOS, disk images.
   - (DONE) table of bochsrc options and what they do
   - BIOS/VGABIOS, what do they do?
   - disk images
-          - where to find one pre-made
-          - make a blank one with bximage
+    - (DONE) where to find one pre-made
+    - (DONE) make a blank one with bximage
     - grab one from a real hard disk
-      </screen>
-      </para>
-   </section>
-   <section id="bochsrc">
-   <title>bochsrc</title>
+</screen>
+</para>
+
+</section>
+<section id="bochsrc">
+<title>bochsrc</title>
 <para>
 Bochs uses a configuration file called a <filename>bochsrc</filename> to know
 where to look for disk images, how the Bochs emulation layer should work, etc.
@@ -5988,7 +6021,7 @@ $ ./bxcommit
 ========================================================================
                                bxcommit
               Undoable Disk Image Commit Tool for Bochs
-      $Id: user.dbk,v 1.122 2003-08-02 15:20:53 vruppert Exp $
+      $Id: user.dbk,v 1.123 2003-08-03 08:56:02 vruppert Exp $
 ========================================================================
 
 What is the flat image name?
@@ -8451,7 +8484,7 @@ linux-$ ./bximage
 ========================================================================
                                 bximage
                   Disk Image Creation Tool for Bochs
-        $Id: user.dbk,v 1.122 2003-08-02 15:20:53 vruppert Exp $
+        $Id: user.dbk,v 1.123 2003-08-03 08:56:02 vruppert Exp $
 ========================================================================
 
 Do you want to create a floppy disk image or a hard disk image?