home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Professional / OS2PRO194.ISO / os2 / progs / pari / pari_137 / readme.emx < prev    next >
Text File  |  1992-09-13  |  6KB  |  164 lines
  1. ===============================================================================
  2. readme.doc        emx 0.8e    INTRODUCTION                          13-Sep-1992
  3. ===============================================================================
  4.  
  5.             *** See history.doc for important information ***
  6.  
  7. Welcome to emx, a common environment for creating 32-bit programs for
  8. OS/2 2.0 and DOS. You can use the GNU C compiler to compile programs
  9. for emx. The main design goal of emx is to simplify porting Unix
  10. software to OS/2 2.0 and DOS. Moreover, you can create `native' OS/2
  11. programs.
  12.  
  13. The emx package includes:
  14.  
  15. - emx.dll and emxio.dll dynamic link libraries for OS/2 2.0
  16.  
  17. - emx.exe DOS extender for running 32-bit programs under DOS
  18.  
  19. - emxbind.exe for creating .exe files which work both under OS/2 2.0
  20.   and DOS
  21.  
  22. - emxomf.exe for converting .o object files (a.out) to .obj object
  23.   files (OMF). With emxomf and LINK386 you can create OS/2 programs
  24.   that don't need emx.dll
  25.  
  26. - C header files and a nearly complete C library with source
  27.  
  28. Additionally, the following GNU programs are available compiled and with
  29. patches and sources (note that these files are not part of emx):
  30.  
  31. - GCC 2.2.2, the GNU C compiler
  32.  
  33. - GAS 1.38.1, the GNU assembler
  34.  
  35. - GDB 4.6, the GNU debugger
  36.  
  37. - ld, the GNU linker
  38.  
  39. - ar, nm, size, strip, objdump: some GNU utilities for dealing with
  40.   binary files
  41.  
  42. - texinfo, the GNU documentation system
  43.  
  44. - Patches for the GNU sources
  45.  
  46. - Patched source for GCC, GAS, GDB, ld, ar, nm, size, strip, objdump,
  47.   info, makeinfo, texindex.  You can compile all these programs with
  48.   the files that come with emx (but you also need a make utility, such
  49.   as NMAKE).
  50.  
  51. - BSD curses library
  52.  
  53. You can get the complete GNU sources by anonymous ftp from
  54. prep.ai.mit.edu and other archives, for instance ftp.uni-stuttgart.de.
  55.  
  56.  
  57. emx is packaged in the following files:
  58.  
  59.   emxdev.zip    emx development system (without compiler)
  60.   emxlib.zip    emx C library source
  61.   emxtest.zip   Test programs (used for testing emx and the library).
  62.                 Includes some sample programs as well
  63.  
  64. GNU programs compiled for emx, patches and patched sources:
  65.  
  66.   gnudev.zip    GNU development tools compiled for emx
  67.   gppdev.zip    Additional GNU programs and files for compiling C++
  68.   gnupat.zip    Patches for GNU sources
  69.   gnudoc.zip    Documentation for GNU programs (texinfo sources)
  70.   gnuinfo.zip   GNU texinfo (includes info file browser)
  71.   gnusrc.zip    Patched GNU sources (ld, ar, nm, size, strip, objdump,
  72.                 termcap)
  73.   gccsrc1.zip   Patched GNU sources (GCC 2.2.2, part 1)
  74.   gccsrc2.zip   Patched GNU sources (GCC 2.2.2, part 2)
  75.   gassrc.zip    Patched GNU sources (GAS 1.38.1)
  76.   gdbsrc.zip    Patched GNU sources (GDB 4.6)
  77.   gppsrc.zip    Patched sources of libg++ 2.2
  78.  
  79. BSD libraries compiled for emx with sources:
  80.  
  81.   bsddev.zip    BSD libraries (curses etc.)
  82.   bsddoc.zip    Documentation for BSD libraries
  83.   bsdsrc.zip    Source for BSD libraries
  84.  
  85. For unpacking, you need unzip v5.0 which is available from many
  86. archives.  Look for files named
  87.  
  88.   unzip50.exe   MSDOS executable for unzip
  89.   unz50_32.exe  OS/2 2.x 32-bit executable
  90.  
  91. To install emx on drive C: (you can use any drive -- all examples use
  92. drive C:), type the following:
  93.  
  94.   c:
  95.   cd \
  96.   unzip emxdev emx\doc\install.doc
  97.  
  98. You may have to specify the complete paths of unzip.exe and
  99. emxdev.zip. PKUNZIP cannot be used.
  100.  
  101. Then, read \emx\doc\install.doc to learn how to continue the
  102. installation.
  103.  
  104. You'll find further information in the following files:
  105.  
  106.   \emx\doc\install.doc          Installation guide
  107.   \emx\doc\emxdev.doc           Application developer's guide
  108.   \emx\doc\gnudev.doc           GNU development tools information
  109.   \emx\doc\bsddev.doc           BSD library information
  110.   \emx\doc\user.doc             User's guide
  111.   \emx\doc\build.doc            Compiling the GNU sources
  112.   \emx\doc\history.doc          Change log
  113.   \emx\doc\future.doc           Things to do
  114.   \emx\doc\emxbind.doc          A diagram showing the .exe file format
  115.   \emx\doc\copying.emx          emx & library license
  116.   \emx\doc\copying              GNU General Public License
  117.   \emx\doc\copying.bsd          BSD license (for libbsd and libcurse)
  118.   \emx\doc\copying.lib          GNU Library General Public License
  119.  
  120.  
  121. NO WARRANTY: No guarantee is made as to the proper functioning of the
  122. software. No liability will be admitted for damage resulting from
  123. using the software.
  124.  
  125. See \emx\doc\copying and \emx\doc\copying.emx for copyright
  126. information.
  127.  
  128. Instead of a list: All the trademarks used in this document and all
  129. the other emx documents are registered to whoever it is that owns
  130. them.
  131.  
  132. emx is available for anonymous ftp on ftp.uni-stuttgart.de
  133. [129.69.1.12] in the directory soft/os2/emx-0.8e. It is also available
  134. from ftp-os2.nmsu.edu.
  135.  
  136. An emx-related mailing list has been created: emx-list. The address
  137. for people to request to be added or removed from the list is:
  138.  
  139.     listserv@ludd.luth.se
  140.  
  141. To subscribe, send a message containing
  142.  
  143.     sub emx-list Joe User
  144.  
  145. to listserv@ludd.luth.se. Of course, you should use your name instead
  146. of Joe User's name.
  147.  
  148.  
  149. The author of emx is
  150.  
  151.   Eberhard Mattes
  152.   Teckstrasse 81                                          (TeX: Teckstra\ss e)
  153.   D-7141 Moeglingen                                       (TeX: M\"oglingen)
  154.   Germany
  155.  
  156.   Internet: mattes@azu.informatik.uni-stuttgart.de        (subject to change)
  157.  
  158. No telephone calls please! It must be stressed that the author does
  159. not reply to letters if you don't include return postage
  160. (international postal reply coupon if you're outside Germany) and a
  161. self-addressed envelope.
  162.  
  163. --------------------------- END OF README.DOC ------------------------------
  164.