===============================================================================
readme.doc emx 0.8c INTRODUCTION 08-Apr-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:

[email protected]

The author of emx is

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

Internet: [email protected] (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 ------------------------------