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