crossemx Files

===============================================================================
readme.doc        emx 0.8b     INTRODUCTION                         22-Feb-1992
===============================================================================

Welcome to emx, a common environment for creating 32-bit programs for OS/2 2.0
and MS-DOS. You can use the GNU C compiler to compile programs for emx.

Included in the emx package are:

- emx.dll dynamic link library for OS/2 2.0

- emx.exe DOS extender for running 32-bit programs under MS-DOS

- emxbind.exe for creating .exe files which work both under OS/2 2.0 and
  MS-DOS

- C header files and a nearly complete C library, including source

Additionally, the following GNU programs are available compiled and with
sources (note that these files are not part of emx):

- gcc, the GNU C compiler

- gas, the GNU assembler

- gdb, the GNU debugger

- ld, the GNU linker

- ar, nm, size, strip, objdump: some GNU utilities for dealing with binary
  files

- Patched source for gcc, gas, gdb, ld, ar, nm, size, strip, objdump. You can
  compile all these programs with the files that come with emx (but you also
  need a make utility, such as NMAKE)

- Patches for the GNU sources

Documentation for the GNU programs is not included. Documentation is
usually included in the original GNU sources, available from prep.mit.edu
and other archives.


emx is packaged in the following files:

  emxdev.zip    Development system (w/o compiler)
  emxlib.zip    C library source
  emxtest.zip   Test programs (used for testing emx and the library)

Compiled GNU programs, sources and patches:

  gnudev.zip    GNU development tools compiled for emx
  gnusrc1.zip   Patched GNU sources (ld, ar, nm, size, strip, objdump, termcap)
  gnusrc2.zip   Patched GNU sources (gas 1.37)
  gnusrc3.zip   Patched GNU sources (gcc 1.40)
  gnusrc4.zip   Patched GNU sources (gdb 3.5)
  gnupat.zip    Patches for GNU sources

You'll find further information in the following files:

  \emx\doc\install.doc          Installation guide
  \emx\doc\develop.doc          Application developer's guide
  \emx\doc\user.doc             User's guide
  \emx\doc\build.doc            Compiling the GNU sources
  \emx\doc\history.doc          Change log
  \emx\doc\copying.emx          emx & library license
  \emx\doc\copying              GNU General Public License

No guarantee is made as to the proper functioning of the software. No
liability will be admitted for damage resulting from using the software.

Author of emx:

  Eberhard Mattes
  Teckstrasse. 81                                         (TeX: Teckstra\ss e)
  D-7141 Moeglingen                                       (TeX: M\"oglingen)
  Germany

  Internet: mattes@azu.informatik.uni-stuttgart.de        (subject to change)

No telephone calls please! It must be stressed that the author does not reply
to letters if you don't include return postage (international postal reply
coupon for those outside Germany) and a self-addressed envelop.

--------------------------- END OF README.DOC ------------------------------