How to compile & test bochs:

1) Change directory to config/

   > cd config

2) There are two types of configuration files, one is a "C" header file,
   "cfg-XXXX-XXX", and the second is a file which gets included by the
   Makefile's in the top-level directory and in the iodev/ directory,
   "mfc-XXXX-XXX".  Find a pair of files which exist for your
   environment, or make them if your system isn't already supported.
   If they don't exist, copy them from a similar system, and edit
   them accordingly.

3) Copy the two files into the main directory.

  > cp cfg-linux-gcc.h ../config.h
  > cp mfc-linux-gcc   ../Makefile.config

4) Go back to the top-level directory.

  > cd ..

5) Customize the "config.h" & "Makefile.config" files to your system.

6) Compile.

  > make

7) create a bootable 1.44M floppy image file.  To do this you'll need
   access to a DOS box.  Format a floppy with system files.  Optionally,
   add a few executables.  From a Linux machine, or any other !nix
   machine, copy the raw floppy disk to an image file named "1.44" and
   put it under the bochs/ directory.

   example on linux:
   >  dd if=/dev/fd1H1440 ibs=512 of=1.44


8) run bochs.  Use the "-use-mda" & "-log" options for now.  If there
   are problems, errors and other miscellaneous messages are written
   to the log file.  Currently, keyboard input is hardwired and
   will run the "dir" & "ver" commands.  You'll have to break out
   after this.

  > bx_8086 -use-mda -log bochs.log

9) report any problems to bochs-developers@aris.com

=====================================================================

NOTES:
  The "Makefile.config" file is included by both the Makefile in the
  top-level directory & the iodev/ directory.  If you can't get your
  make program to allow for file inclusion, (try using gmake), then
  manually include the contents of "Makefile.config" (after copying
  it from one of the config/ files as per above) in both the
  ./Makefile & ./iodev/Makefile.


Thank you,
Kevin Lawton
