crossemx Files

===============================================================================
readme.doc        emx 0.8d    INTRODUCTION                          03-May-1992
===============================================================================

            *** See history.doc for important information ***

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. The main design goal of emx is to simplify porting
Unix software.

The emx package includes:

- 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 with source

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

- gcc 2.1, the GNU C compiler

- gas 1.38.1, the GNU assembler

- gdb 4.4, the GNU debugger

- ld, the GNU linker

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

- Patches for the GNU sources

- 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). Due to space
  restrictions on ftp servers (or diskettes), the patched sources may
  be missing -- you can rebuild them from the original GNU sources
  (available from prep.ai.mit.edu or rusinfo.rus.uni-stuttgart.de) and
  the patches.

You can get the complete GNU sources by anonymous ftp from
prep.ai.mit.edu and other archives, for instance
rusinfo.rus.uni-stuttgart.de.


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, patches and patched sources:

  gnudev.zip    GNU development tools compiled for emx
  gnupat.zip    Patches for GNU sources
  gnudoc.zip    Documentation for gcc and gdb (texinfo)
  gnusrc.zip    Patched GNU sources (ld, ar, nm, size, strip, objdump,
                termcap)

Due to space restrictions on ftp servers, the following patched GNU
source files may be missing -- you can rebuild them from the original
GNU sources (available from prep.ai.mit.edu) and the patches contained
in gnupat.zip:

  gccsrc1.zip   Patched GNU sources (gcc 2.1, part 1)
  gccsrc2.zip   Patched GNU sources (gcc 2.1, part 2)
  gccsrc3.zip   Patched GNU sources (gcc 2.1, part 3)
  gassrc.zip    Patched GNU sources (gas 1.38.1)
  gdbsrc.zip    Patched GNU sources (gdb 4.4)

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\future.doc           Things to do
  \emx\doc\emxbind.doc          A diagram showing the .exe file format
  \emx\doc\copying.emx          emx & library license
  \emx\doc\copying              GNU General Public License

The texinfo source for the gcc and gdb manuals is contained in
gnudoc.zip. Use GNU makeinfo to create info files for on-line help.
Use TeX to print the manual. Of course, I recommend emTeX (available
for anonymous ftp from rusinfo.rus.uni-stuttgart.de, directory
soft/tex/machines/pc/emtex). The following instructions assume that
you're using emTeX. To compile the gcc manual, type

  cd \emx\gnu\gcc-2.1
  tex386 gcc
  tex386 gcc

To compile the gdb manual, type

  cd \emx\gnu\gdb-4.4
  set texinput=%texinput%;..\readline
  tex386 refcard                                <- Reference card
  tex386 gdb-all                                <- User's guide
  tex386 gdb-all
  tex386 gdbint                                 <- gdb internals
  tex386 gdbint


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

Instead of a list: All the trademarks used in this document and all
the other emx documents are registered to whoever it is that owns
them.

emx is available for anonymous ftp on rusinfo.rus.uni-stuttgart.de
[129.69.1.12] in the directory soft/os2/emx. It seems to be also
available from hobbes.nmsu.edu.

An emx-related mailing list has been created. The address for people
to request to be added or removed from the list is:

    emx-list-request@mail.physics.utah.edu

The author of emx is

  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 envelope.

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