 +---------------------------------------------------------------------------+
 |  wm-FPU-emu   an FPU emulator for 80386 and 80486SX microprocessors.      |
 |                                                                           |
 | Copyright (C) 1992,1993,1994                                              |
 |                       W. Metzenthen, 22 Parker St, Ormond, Vic 3163,      |
 |                       Australia.  E-mail   billm@vaxc.cc.monash.edu.au    |
 |                                                                           |
 |    This program is free software; you can redistribute it and/or modify   |
 |    it under the terms of the GNU General Public License version 2 as      |
 |    published by the Free Software Foundation.                             |
 |                                                                           |
 |    This program is distributed in the hope that it will be useful,        |
 |    but WITHOUT ANY WARRANTY; without even the implied warranty of         |
 |    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the          |
 |    GNU General Public License for more details.                           |
 |                                                                           |
 |    You should have received a copy of the GNU General Public License      |
 |    along with this program; if not, write to the Free Software            |
 |    Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.              |
 |                                                                           |
 +---------------------------------------------------------------------------+

This emulator, which I call wm-FPU-emu, is in fact a slightly modified
wm-FPU-emu which I wrote for the Linux operating system. That emulator
is based upon an older emulator which I wrote for use with djgpp.

Released versions:
for djgpp 1.11         wm-FPU-emu version Beta 1.11d   April 1994

See the README file in the /usr/src/linux/drivers/FPU-emu directory
for more information on this emulator.

As a convenience, the Linux FPU-emu sources are included in the .tar
file from which you obtained this README file.

The complete sources for the Linux operating system are available from
many places including:
   numerous anonymous ftp sites including:
                 tsx-11.mit.edu    in pub/linux
                 sunsite.unc.edu   in pub/Linux
                 nic.funet.fi      in pub/OS/Linux
                 kirk.bu.oz.au     in pub/OS/Linux
   numerous bulletin boards,
   and commercial sources on floppy disk, tape, or cdrom.

Despite isolated peculiar opinions to the contrary, program development
is much nicer with Linux than ms-dos. This emulator is designed to be
compiled on the Linux operating system, using the standard tools which
are normally supplied with that system. Currently (mid April 1994),
there is a problem because Linux and djgpp do not use the same object
file format. This problem is easily overcome, but, in order to allow
the emulator to be compiled with just the standard tools, I have chosen
to set up the Makefile to perform the task in two steps:
  (1) Under Linux, gcc is used to produce intermediate assembler files
      and these files are copied to an ms-dos directory. The 'make'
      target 'djgpp' does this.
  (2) Under ms-dos, the djgpp assembler and linker are used for the
      final stages of producing emu387.

The only customization which should be needed for individual
installations is to change the definition of the djgpp directories in
the Linux Makefile.

After setting up the Makefile, wm-FPU-emu can be compiled as follows:
Under Linux:
    ( cd /usr/src/djgpp/wm-FPU-emu; make dep; make djgpp; make clean )
Reboot the machine to ms-dos, cd to the djgpp directory which you defined
in the Linux Makefile and (assuming that you have djgpp installed):
    make
Finally, shift the resulting emu387 to where go32 expects to find it.

Please, DO NOT re-package the emulator source. The current arrangement
allows me to maintain essentially just one set of sources. The
emulator has been subject to fairly intensive debugging under Linux
and should not need any debugging of the main sources under djgpp.


Bill Metzenthen
14th April 1994

