Date: Tue, 21 Apr 92 19:31:31 -0400
From: "Gary McTaggart" <gmt AT reef DOT cis DOT ufl DOT edu>
To: djgpp AT sun DOT soe DOT clarkson DOT edu
Status: O


Hey all,

Here is the README.DOC from EMX for those of you interested in what 
it is.  The FTP site it is available at is:

hobbes.nmsu.edu in pub/downloads/emx-0.8c
rusinfo.rus.uni-stuttgart.de ( don't know which directory )

I don't know if this is of interest to you folks or not, but figured
this didn't hurt.

===============================================================================
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:

    emx-list-request AT mail DOT physics DOT utah DOT edu

The author of emx is

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

  Internet: mattes AT azu DOT informatik DOT uni-stuttgart DOT 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 ------------------------------