home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / pasos2c1.zip / readme.emx < prev    next >
Text File  |  1993-12-17  |  7KB  |  181 lines
  1. ===============================================================================
  2. readme.doc        emx 0.8g    INTRODUCTION                          13-Jul-1993
  3. ===============================================================================
  4.                                      Copyright (c) 1990-1993 by Eberhard Mattes
  5.  
  6.             *** See history.doc for important information ***
  7.  
  8. Welcome to emx 0.8g, 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.4.5 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.9, 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.   emxrt.zip     emx runtime package
  66.   emxdev.zip    emx development system (without compiler)
  67.   emxview.zip   emx documentation in OS/2 .inf format
  68.   emxlib.zip    emx library sources
  69.   emxsrc1.zip   Source for emxomf, emxomfar and emxomfld
  70.   emxample.zip  Sample programs
  71.   emxtest.zip   Test programs (used for testing emx and the libraries)
  72.  
  73. GNU programs compiled for emx, patches and patched sources:
  74.  
  75.   gnudev.zip    GNU development tools compiled for emx
  76.   gnuview.zip   gnudev.inf (gnudev.doc in OS/2 .inf format)
  77.   gppdev.zip    Additional GNU programs and files for compiling C++
  78.   gobjcdev.zip  Additional GNU programs and files for compiling
  79.                 Objective C
  80.   gnupat.zip    Patches for GNU sources
  81.   gnudoc.zip    Documentation for GNU programs (texinfo sources)
  82.   gnuinfo.zip   GNU texinfo (includes info file browser)
  83.   gnusrc.zip    Patched GNU sources (ld, ar, nm, size, strip, objdump,
  84.                 termcap)
  85.   gccsrc1.zip   Patched GNU sources (GCC 2.4.5, part 1)
  86.   gccsrc2.zip   Patched GNU sources (GCC 2.4.5, part 2)
  87.   gccsrc3.zip   Patched GNU sources (GCC 2.4.5, part 3)
  88.   gassrc.zip    Patched GNU sources (GAS 1.38.1)
  89.   gdbsrc.zip    Patched GNU sources (GDB 4.9)
  90.   gppsrc.zip    Patched sources of libg++ 2.2
  91.  
  92. BSD libraries compiled for emx with sources:
  93.  
  94.   bsddev.zip    BSD libraries (curses etc.)
  95.   bsddoc.zip    Documentation for BSD libraries
  96.   bsdsrc.zip    Source for BSD libraries
  97.  
  98. For unpacking, you need unzip v5.0 which is available from many
  99. archives.  Look for files named
  100.  
  101.   unzip50.exe   MS-DOS executable for unzip
  102.   unz50_32.exe  OS/2 2.x 32-bit executable
  103.  
  104. Read INSTALL.DOC to learn how to install emx.
  105.  
  106. After unpacking the emx runtime and development system packages,
  107. you'll find further information in the following files:
  108.  
  109.   \emx\doc\COPYING.EMX          emx & library license
  110.   \emx\doc\COPYING              GNU General Public License
  111.   \emx\doc\install.doc          Installation guide
  112.   \emx\doc\emxrt.doc            User's guide to the emx runtime package
  113.   \emx\doc\emxdev.doc           Application developer's guide
  114.   \emx\doc\libref.doc           C library reference
  115.   \emx\doc\build.doc            Compiling the GNU sources
  116.   \emx\doc\history.doc          Change log
  117.   \emx\doc\future.doc           Things to do
  118.   \emx\book\emxrt.inf           .inf version of emxrt.doc
  119.   \emx\book\emxdev.inf          .inf version of emxdev.doc (optional)
  120.   \emx\book\libref.inf          .inf version of libref.doc (optional)
  121.  
  122. After unpacking the GNU and BSD packages, you'll find further
  123. information in the following files:
  124.  
  125.   \emx\doc\COPYING              GNU General Public License
  126.   \emx\doc\COPYING.LIB          GNU Library General Public License
  127.   \emx\doc\COPYING.BSD          BSD license (for libbsd and libcurse)
  128.   \emx\doc\gnudev.doc           GNU development tools information
  129.   \emx\doc\bsddev.doc           BSD library information
  130.   \emx\book\gnudev.inf          .inf version of gnudev.doc (optional)
  131.  
  132.  
  133. NO WARRANTY: No guarantee is made as to the proper functioning of the
  134. software.  No liability will be admitted for damage resulting from
  135. using the software.
  136.  
  137. See \emx\doc\COPYING.EMX and \emx\doc\COPYING for copyright
  138. information.  emx is not public domain software!
  139.  
  140. Instead of a list: All the trademarks used in this document and all
  141. the other emx documents are registered to whoever it is that owns
  142. them.
  143.  
  144. emx is available for anonymous ftp on
  145.  
  146.   ftp.uni-stuttgart.de [129.69.1.12]: /soft/os2/emx-0.8g
  147.   ftp-os2.nmsu.edu  [128.123.35.151]: /os2/2_x/unix/gnu/emx08g
  148.   src.doc.ic.ac.uk     [146.169.2.1]: /pub/packages/os2/2_x/unix/gnu/emx08g
  149.   ftp.informatik.tu-muenchen.de [131.159.0.198]:
  150.                                       /pub/comp/os/os2/devtools/emx+gcc
  151.  
  152. An emx-related mailing list has been created: emx-list.  The address
  153. for people to request to be added to or removed from the list is:
  154.  
  155.     listserv@ludd.luth.se
  156.  
  157. To subscribe, send a message containing
  158.  
  159.     sub emx-list Joe User
  160.  
  161. to listserv@ludd.luth.se.  Of course, you should use your name instead
  162. of Joe User's name.
  163.  
  164.  
  165. The author of emx is
  166.  
  167.     Eberhard Mattes
  168.     Teckstrasse 81                                      (TeX: Teckstra\ss e)
  169.     D-71696 Moeglingen                                  (TeX: M\"oglingen)
  170.     Germany
  171.  
  172. Internet: mattes@azu.informatik.uni-stuttgart.de  (subject to change)
  173.  
  174. No telephone calls please!  It must be stressed that the author does
  175. not reply to letters if you don't include return postage
  176. (international postal reply coupon if you're outside Germany) and a
  177. self-addressed envelope.
  178.  
  179. --------------------------- END OF README.DOC ------------------------------
  180.  
  181.