home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / rcs567s.zip / README.EMX < prev    next >
Text File  |  1993-12-14  |  9KB  |  250 lines
  1. ===============================================================================
  2. readme.doc        emx 0.8h    INTRODUCTION                          14-Dec-1993
  3. ===============================================================================
  4.                                      Copyright (c) 1990-1993 by Eberhard Mattes
  5.  
  6.             *** See history.doc for important information ***
  7.  
  8. Introduction
  9. ------------
  10.  
  11. Welcome to emx 0.8h, a common environment for creating 32-bit programs
  12. for OS/2 2.x and DOS.  You can use the GNU C compiler to compile
  13. programs for emx.  The main design goal of emx is to simplify porting
  14. Unix software to OS/2 2.x and DOS.  Moreover, you can create `native'
  15. OS/2 programs, including Presentation Manager applications.
  16.  
  17. The emx package includes:
  18.  
  19. - emx.dll, emxio.dll, emxwrap.dll and emxlibc.dll dynamic link
  20.   libraries for OS/2 2.x
  21.  
  22. - emx.exe DOS extender for running 32-bit programs under DOS
  23.  
  24. - emxbind.exe for creating .exe files which work both under OS/2 2.x
  25.   and DOS
  26.  
  27. - emxomf.exe for converting .o object files (a.out) to .obj object
  28.   files (OMF).  With emxomf and LINK386 you can create OS/2 programs
  29.   that don't need emx.dll
  30.  
  31. - emximp.exe for creating import libraries
  32.  
  33. - emxexp.exe for creating a list of export definitions from object files
  34.  
  35. - C header files and a nearly complete C library with source
  36.  
  37. - a simple graphics library for 320x200 (256 colors) mode, with source
  38.  
  39. - a library for screen output in windows, with source
  40.  
  41. Additionally, the following GNU programs are available compiled and with
  42. patches and sources (note that these files are not part of emx):
  43.  
  44. - GCC 2.5.7, the GNU C compiler (requires a 387 coprocessor under
  45.   MS-DOS!)
  46.  
  47. - GAS 1.38.1, the GNU assembler
  48.  
  49. - GDB 4.11, the GNU debugger
  50.  
  51. - ld, the GNU linker
  52.  
  53. - ar, nm, size, strip, objdump: some GNU utilities for dealing with
  54.   binary files
  55.  
  56. - texinfo, the GNU documentation system
  57.  
  58. - Patches for the GNU sources
  59.  
  60. - Patched source for GCC, GAS, GDB, ld, ar, nm, size, strip, objdump,
  61.   info, makeinfo, texindex.  You can compile all these programs with
  62.   the files that come with emx (but you also need a make utility, such
  63.   as NMAKE).
  64.  
  65. - BSD curses library
  66.  
  67. You can get the complete GNU sources by anonymous ftp from
  68. prep.ai.mit.edu and other archives, for instance ftp.uni-stuttgart.de.
  69.  
  70.  
  71. Packages
  72. --------
  73.  
  74. emx is packaged in the following files:
  75.  
  76.   emxrt.zip     emx runtime package
  77.   emxdev.zip    emx development system (without compiler)
  78.   emxview.zip   emx documentation in OS/2 .inf format
  79.   emxlib.zip    emx library sources
  80.   emxsrc1.zip   Source for emxomf, emxomfar, emxomfld, emxexp and emxload
  81.   emxample.zip  Sample programs
  82.   emxtest.zip   Test programs (used for testing emx and the libraries)
  83.  
  84. GNU programs compiled for emx, patches and patched sources:
  85.  
  86.   gnudev.zip    GNU development tools compiled for emx
  87.   gnuview.zip   gnudev.inf (gnudev.doc in OS/2 .inf format)
  88.   gppdev.zip    Additional GNU programs and files for compiling C++
  89.   gobjcdev.zip  Additional GNU programs and files for compiling
  90.                 Objective C
  91.   gnupat.zip    Patches for GNU sources
  92.   gnudoc.zip    Documentation for GNU programs (texinfo sources)
  93.   gnuinfo.zip   GNU texinfo (includes info file browser)
  94.   gnusrc.zip    Patched GNU sources (ld, ar, nm, size, strip, objdump,
  95.                 info, termcap, GPPDEMID)
  96.   gccsrc1.zip   Patched GNU sources (GCC 2.5.7, part 1)
  97.   gccsrc2.zip   Patched GNU sources (GCC 2.5.7, part 2)
  98.   gccsrc3.zip   Patched GNU sources (GCC 2.5.7, part 3)
  99.   gassrc.zip    Patched GNU sources (GAS 1.38.1)
  100.   gdbsrc1.zip   Patched GNU sources (GDB 4.11, part 1)
  101.   gdbsrc2.zip   Patched GNU sources (GDB 4.11, part 2)
  102.   gppsrc.zip    Patched sources of libg++ 2.5.2
  103.  
  104. BSD libraries compiled for emx with sources:
  105.  
  106.   bsddev.zip    BSD libraries (curses etc.)
  107.   bsddoc.zip    Documentation for BSD libraries
  108.   bsdsrc.zip    Source for BSD libraries
  109.  
  110.  
  111. Installing emx
  112. --------------
  113.  
  114. For unpacking, you need unzip v5.0 which is available from many
  115. archives.  Look for files named
  116.  
  117.   unzip50.exe   MS-DOS executable for unzip
  118.   unz50_32.exe  OS/2 2.x 32-bit executable
  119.  
  120. Read INSTALL.DOC to learn how to install emx.
  121.  
  122. After unpacking the emx runtime and development system packages,
  123. you'll find further information in the following files:
  124.  
  125.   \emx\doc\COPYING.EMX          emx & library license
  126.   \emx\doc\COPYING              GNU General Public License
  127.   \emx\doc\install.doc          Installation guide
  128.   \emx\doc\emxrt.doc            User's guide to the emx runtime package
  129.   \emx\doc\emxdev.doc           Application developer's guide
  130.   \emx\doc\libref.doc           C library reference
  131.   \emx\doc\build.doc            Compiling the GNU sources
  132.   \emx\doc\history.doc          Change log
  133.   \emx\doc\future.doc           Things to do
  134.   \emx\book\emxrt.inf           .inf version of emxrt.doc
  135.   \emx\book\emxdev.inf          .inf version of emxdev.doc (optional)
  136.   \emx\book\libref.inf          .inf version of libref.doc (optional)
  137.  
  138. After unpacking the GNU and BSD packages, you'll find further
  139. information in the following files:
  140.  
  141.   \emx\doc\COPYING              GNU General Public License
  142.   \emx\doc\COPYING.LIB          GNU Library General Public License
  143.   \emx\doc\COPYING.BSD          BSD license (for libraries bsd and curses)
  144.   \emx\doc\COPYING.IOS          Additional information for iostream library
  145.   \emx\doc\gnudev.doc           GNU development tools information
  146.   \emx\doc\bsddev.doc           BSD library information
  147.   \emx\book\gnudev.inf          .inf version of gnudev.doc (optional)
  148.   \emx\book\bsddev.inf          .inf version of bsddev.doc
  149.  
  150.  
  151. Legal stuff
  152. -----------
  153.  
  154. NO WARRANTY: No guarantee is made as to the proper functioning of the
  155. software.  No liability will be admitted for damage resulting from
  156. using the software.
  157.  
  158. See \emx\doc\COPYING.EMX and \emx\doc\COPYING for copyright
  159. information.  emx is not public domain software!
  160.  
  161. Instead of a list: All the trademarks used in this document and all
  162. the other emx documents are registered to whoever it is that owns
  163. them.
  164.  
  165.  
  166. Where to get emx
  167. ----------------
  168.  
  169. emx is available for anonymous ftp on
  170.  
  171.   ftp.uni-stuttgart.de [129.69.8.13]: /pub/systems/os2/emx-0.8h
  172.   ftp-os2.cdrom.com:  [192.153.46.2]: /os2/2_x/unix/gnu/emx08h
  173.   src.doc.ic.ac.uk     [146.169.2.1]: /pub/packages/os2/2_x/unix/gnu/emx08h
  174.   ftp.informatik.tu-muenchen.de [131.159.0.198]:
  175.                                       /pub/comp/os/os2/devtools/emx+gcc
  176.  
  177. Other files of interest
  178. -----------------------
  179.  
  180. emx does not come with a `make' utility.  I recommend dmake 3.8.  It's
  181. available for anonymous ftp on
  182.  
  183.   ftp.uni-stuttgart.de [129.69.8.13]: /pub/systems/os2/programming/support/
  184.   ftp-os2.cdrom.com:  [192.153.46.2]: /os2/all/program/
  185.   ftp.informatik.tu-muenchen.de [131.159.0.198]:
  186.                                       /pub/comp/os/os2/devtools/
  187.  
  188. Executables are in dmake38x.zip, source code is in dmake38s.zip.
  189. dmake38.zip contains both dmake38s.zip and dmake38x.zip.
  190.  
  191. The emx graphics library currently supports only the 320x200 VGA mode.
  192. Johannes Martin has created a graphics library for various SVGA cards.
  193. It's available for anonymous ftp on
  194.  
  195.   ftp.uni-stuttgart.de [129.69.8.13]: /pub/systems/os2/emx-0.8h/contrib/
  196.   ftp-os2.cdrom.com:  [192.153.46.2]: /os2/2_x/unix/gnu/emx08h/contrib/
  197.   ftp.informatik.tu-muenchen.de [131.159.0.198]:
  198.                                       /pub/comp/os/os2/gnu/emx+gcc/contrib/
  199.  
  200. You need svgakt*.zip (or svgakit*.zip) and vesa*.zip (or
  201. vesa_emx*.zip, * is the version number).
  202.  
  203. If you want to convert the texinfo files (GCC documentation, for
  204. instance) to OS/2 on-line books (.inf files), I recommend Andreas
  205. Kaiser's texi2ipf program:
  206.  
  207.   ftp-os2.cdrom.com:  [192.153.46.2]: /os2/2_x/unix/tex/txi2ipf1.zip
  208.   ftp.informatik.tu-muenchen.de [131.159.0.198]:
  209.                                       /pub/comp/os/os2/gnu/doc/txi2ipf1.zip
  210.  
  211.  
  212. Joining the mailing list
  213. ------------------------
  214.  
  215. An emx-related mailing list has been created: emx-list.  The address
  216. for people to request to be added to or removed from the list is:
  217.  
  218.     listserv@eb.ele.tue.nl
  219.  
  220. To subscribe, send a message containing
  221.  
  222.     sub emx-list Joe User
  223.  
  224. to listserv@eb.ele.tue.nl.  Of course, you should use your name
  225. instead of Joe User's name.  To unsubscribe, send a message containing
  226.  
  227.     unsub emx-list
  228.  
  229. to listserv@eb.ele.tue.nl.
  230.  
  231.  
  232. The author
  233. ----------
  234.  
  235. The author of emx is
  236.  
  237.     Eberhard Mattes
  238.     Teckstrasse 81                                      (TeX: Teckstra\ss e)
  239.     D-71696 Moeglingen                                  (TeX: M\"oglingen)
  240.     Germany
  241.  
  242. Internet: mattes@azu.informatik.uni-stuttgart.de  (subject to change)
  243.  
  244. No telephone calls please!  It must be stressed that the author does
  245. not reply to letters if you don't include return postage
  246. (international postal reply coupon if you're outside Germany) and a
  247. self-addressed envelope.
  248.  
  249. --------------------------- END OF README.DOC ------------------------------
  250.