diff --git a/bochs/doc/docbook/user/user.dbk b/bochs/doc/docbook/user/user.dbk
index 7e4becfce..4ba1c3e07 100644
--- a/bochs/doc/docbook/user/user.dbk
+++ b/bochs/doc/docbook/user/user.dbk
@@ -1,7 +1,7 @@
@@ -482,15 +509,24 @@ to mention, running DOOM, though at then-pathetic speeds.
Downloading Bochs
-You can download Bochs from our web site at &bochs-sf-net;. On the download
-page, you will find the latest release version (binaries and source code)
-and also some development versions. If you trying to get things working
-for the first time, a release version is recommended since it has been
-tested the most. We have precompiled binaries for many platforms, which
-can save you the troubles (and joys) of compiling Bochs yourself. Most
-binary packages come with a small demo of a guest operating system called DLX
-Linux. If you choose to compile it yourself, you have a lot more flexibility
-in which devices you enable.
+You can download Bochs from our web site at &bochs-sf-net;. First, you
+need to choose what version to get: latest release or a development version.
+If you trying to get things working for the first time, a release version is
+recommended since it has been tested the most. The development versions
+(sometimes called snapshots) may have some newer bug fixes and new features,
+but have not been tested as much as the releases.
+See the Linux RPM Section for more information.
+
+
+
+Second, you can choose to compile Bochs from source code or install a binary
+(if one is available for your platform). Binary packages will be quicker to
+install, and most include a small demo of a guest operating system called DLX
+Linux to get you started. However, some features can only be enabled if you
+compile Bochs yourself, for example the Bochs debugger. For multiuser systems,
+you will probably need system administrator privileges (root) to install a
+binary package. If you only have a user account you can compile Bochs in your
+home directory.
@@ -505,20 +541,102 @@ for details.
Installing a Binary
- Windows
-
- unzip into some directory. Look for DOC-win32.html
- for more instructions. Quick start: find dlxlinux/start.bat and
- double click
-
-
- Unix
-
- rpm -i bochs-<VERSION>;.rpm
- Look for /usr/local/bochs/latest/DOC-linux.html, man pages for
- bochs. Quick start: run bochs-dlx (in /usr/local/bin)
-
-
+
+
+This section is divided up by platform, since installing a binary package
+is different on different platforms.
+
+
+Windows
+
+unzip into some directory. Look for DOC-win32.html
+for more instructions. Quick start: find dlxlinux/start.bat and
+double click
+
+
+
+
+Linux RPM
+
+RPM stands for "RedHat Package Manager." An RPM is a compressed file
+containing files to be installed on your system. Many Linux distributions,
+not just RedHat ones, can install files from an RPM. Debian packages are
+available as well, but this section talks deals with RPMs. First, download the
+Bochs RPM for your architecture to your computer. If you have an
+Intel-compatible computer, be sure to get the RPM that says "for Linux x86
+distributions." Once you have the package on your local disk, you should be
+able to install it as follows
+
+Many distributions have their own RPM installer program, often graphical, and
+they should work as well. It is helpful to be able to see the text output from
+RPM, so if you use a fancy RPM installer, be sure to find the text output and
+check that it looks correct.
+
+:
+
+ user$ su
+ Password:
+ root# ls -l bochs-1.2.1.i386.rpm
+ -rw-rw-r-- 1 user user 1877515 Sep 14 09:02 bochs-1.2.1.i386.rpm
+ root# rpm -i bochs-1.2.1.i386.rpm
+ Looking for fonts to install... /usr/local/bochs/latest/
+ Looking for X11 Font Path... /usr/lib/X11/fonts
+ Installing vga.pcf... ok (it was already there)
+ Running mkfontdir...
+ Done installing Bochs fonts for X11.
+ root# exit
+ user$ _
+
+
+
+
+
+All RPM installations are done as the root user because they require permission
+to update system files and directories. If you do not have root access you
+need to compile Bochs in your home directory.
+
+
+
+
+The Bochs RPM installs three new commands and associated manual pages: bochs,
+bochs-dlx, and bximage. First, let's try out the DLX Linux demo by typing
+bochs-dlx. This command is installed into
+/usr/local/bin, so you might need to add that
+directory to your PATH variable.
+
+
+ user$ bochs-dlx
+ Checking for bochs binary...ok
+ Checking for DLX linux directory...ok
+ Entering /usr/local/bochs/dlxlinux
+ Running bochs
+ ========================================================================
+ Bochs x86 Emulator 1.2.1
+ June 12, 2001
+ ========================================================================
+ 00000000000 [ ] looking for configuration in .bochsrc
+ 00000000000 [ ] looking for configuration in bochsrc
+ 00000000000 [ ] looking for configuration in bochsrc.txt
+ 00000000000 [ ] reading configuration from bochsrc.txt
+ 00000000000 [ ] using log file bochsout.txt
+
+Then you get a new X11 window containing the VGA display of the simulated
+machine. First you see the VGA BIOS screen, then Linux uncompresses and
+boots, and you get a login prompt. Type "root" and ENTER to log in to
+DLX linux.
+
+DLX Linux screenshot, running on Linux
+
+
+
+
+
+&FIXME;
+Look for /usr/local/bochs/latest/DOC-linux.html, man pages for
+bochs.
+
+
+
Compiling from source