***How to install BOCHS PC Emulator for the XFreeOS2***

NOTICE: The Bochs PC emulator is still in EXPERIMENTAL stages. Do not expect
        it to work fully.


1) Unzip 144M.zip & 46Mwin95.zip (be sure to have about 50MB free space)
   These are a ready boot floppy 1.44 image file and a 46M HD image file. To 
   install WIN95 you'll need at least a 112 MB HD image file. The one included
   in this package is just for testing the emulator at your machine or run 
   other software.

2) Installing VGA font in global font directory
   # NOTE1: Make sure your DISPLAY variable points to local machine.
   # NOTE2: These steps require root privileges.
   # NOTE3: Your X11 fonts path will vary on different systems. For example:
   #        Solaris 2.x /usr/openwin/lib/X11/fonts
   #        Linux       /usr/lib/X11/fonts/
   #        XFree86/OS2 /XFree86/lib/X11/fonts

   -> cp vga.pcf font-path-here/misc
   -> compress font-path-here/vga.pcf
   -> mkfontdir font-path-here/misc
   -> xset fp rehash

3) Change .bochsrc configuration to make your selections. 

4) Use MTOOLS (mcopy, mdir, etc. ) to copy, dir, etc. files or directories
   from your hard disk or CDROM to your floppy or HD IMAGE files.


 ***How to use MTOOLS***

1) Unzip mtools.zip which is inside BOCHSOS2 directory.

2) Type SET MTOOLSRC=x:/path/mtools.conf

   e.g. set MTOOLSRC=d:/bochsos2/mtools/mtools.conf

3) Change MTOOLS.CONF to point at the correct full pathnames of your own HD
   or Floppy image files.

 
 Run mtools.exe to see a list of available commands.

If you want to use one of those then you have to rename the .EXE to that
command filename. For example if you want to use mcopy do :

          REN MTOOLS.EXE MCOPY.EXE

If later you want to use mdir do:

          REN MCOPY.EXE MDIR.EXE

The original MTOOLS package for *NIX requires a file system that 
supports symbolic links.

If you use TVFS for OS/2 then you can create links to MTOOLS.EXE with the
command filenames! This is cool! Just remember to add the directory of the
links to your path if you want to run it from anywhere.

For example: tvlink x:\path\mtools.exe s:\mcopy.exe 
             tvlink x:\path\mtools.exe s:\mdir.exe and so on.

Note: With this port of mtools you cannot use wildcards neither full pathnames
Instead of doing an 'mcopy * n:/' just in case you want to copy files from your
CDROM to the HD image file type the following statements :

      prompt> x:              (where x is a DRIVE letter or a CDROM letter)

      prompt> cd \sourcepath    
           
      prompt> for %d in ( * ) do mcopy %d n:/targetpath


  

 ***How to create a HD image file using 'dd' on OS/2***


You will need GNUFUTIL.ZIP from HOBBES(hobbes.nmsu.edu or 
LEO (www.leo.org) to use the 'dd' command.

To create a 112M HD image file run the following statement:

   prompt> zero | dd of=112M bs=512 count=229500

where 112M is the filename of the HD image file.

For other HD image file sizes read bochs.html for the appropriate parameters
(HARD DRIVE IMAGE SECTION)



 ***How to install Windows95***

Read windows95.html in ./docs-html directory.

Be carefull, don't let win95 installation wizard do an AUTOMATIC detection of
your hardware. Just select manually only those hardware components specified
in windows95.html help page.


Sorry for my poor english and this awfull README file.


For any help send e-mail to alexspan@med.auth.gr