home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 22 gnu / 22-gnu.zip / rcs567x.zip / README.EMX < prev    next >
Text File  |  1994-12-03  |  10KB  |  291 lines
  1. ===============================================================================
  2. readme.doc        emx 0.9a    INTRODUCTION                          05-Dec-1994
  3. ===============================================================================
  4.                                      Copyright (c) 1990-1994 by Eberhard Mattes
  5.  
  6.             *** See history.doc for important information ***
  7.  
  8. Introduction
  9. ------------
  10.  
  11. Welcome to emx 0.9a, an environment for creating 32-bit programs for
  12. OS/2 2.x and DOS.  You can use the GNU C compiler to compile programs
  13. for emx.  The main design goal of emx is to simplify porting Unix
  14. software to OS/2 2.x and DOS.  Moreover, you can create `native' OS/2
  15. 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. - emxfpemu, W. Metzenthen's FPU (387) emulator
  25.  
  26. - emxbind.exe for creating .exe files which work both under OS/2 2.x
  27.   and DOS
  28.  
  29. - emxomf.exe for converting .o object files (a.out) to .obj object
  30.   files (OMF).  With emxomf and LINK386 you can create OS/2 programs
  31.   that don't need emx.dll
  32.  
  33. - emximp.exe for creating import libraries
  34.  
  35. - emxexp.exe for creating a list of export definitions from object files
  36.  
  37. - C header files and a complete C library
  38.  
  39. - a simple graphics library for 320x200 (256 colors) mode
  40.  
  41. - a library for screen output in windows
  42.  
  43. - header files and a library for using sockets of IBM TCP/IP for OS/2
  44.  
  45. Additionally, the following GNU programs are available compiled and with
  46. patches and sources:
  47.  
  48. - GCC 2.6.3, the GNU C compiler, supporting the C, C++, and Objective
  49.   C language
  50.  
  51. - GAS 2.3, the GNU assembler
  52.  
  53. - GDB 4.13, the GNU debugger
  54.  
  55. - ld, the GNU linker
  56.  
  57. - ar, nm, size, strip, objdump: some GNU utilities for dealing with
  58.   binary files
  59.  
  60. - texinfo, the GNU documentation system
  61.  
  62. - Patches for the GNU sources
  63.  
  64. - Patched source for GCC, GAS, GDB, ld, ar, nm, size, strip, objdump,
  65.   info, makeinfo, texindex.  You can compile all these programs with
  66.   the files that come with emx (but you also need a make utility, such
  67.   as dmake).
  68.  
  69. You can get the complete unpatched GNU sources by anonymous ftp from
  70. prep.ai.mit.edu and other archives, for instance ftp.uni-stuttgart.de.
  71.  
  72. Additionally, the following libraries are provided:
  73.  
  74. - some parts of the BSD C library
  75.  
  76. - BSD curses library
  77.  
  78. - Henry Spencer's regexp library
  79.  
  80.  
  81. Packages
  82. --------
  83.  
  84. emx is packaged in the following files:
  85.  
  86.   emxrt.zip     emx runtime package
  87.   emxsrcr.zip   Source for the emx runtime package
  88.   emxdev.zip    emx development system (without compiler)
  89.   emxsrcd.zip   Source for the emx development system
  90.   emxview.zip   emx documentation in OS/2 .inf format
  91.   emxample.zip  Sample programs
  92.   emxtest.zip   Test programs (used for testing emx and the libraries)
  93.  
  94. GNU programs compiled for emx, patches and patched sources:
  95.  
  96.   gnudev.zip    GNU development tools compiled for emx
  97.   gnuview.zip   gnudev.inf (gnudev.doc in OS/2 .inf format)
  98.   gppdev.zip    Additional GNU programs and files for compiling C++
  99.   gobjcdev.zip  Additional GNU programs and files for compiling
  100.                 Objective C
  101.   gnupat.zip    Patches for GNU sources
  102.   gnudoc.zip    Documentation for GNU programs (texinfo sources)
  103.   gnuinfo.zip   GNU texinfo (includes info file browser)
  104.   gnusrc.zip    Patched GNU sources (ld, ar, nm, size, strip, objdump,
  105.                 info, termcap, GPPDEMID)
  106.   gccsrc1.zip   Patched GNU sources (GCC 2.6.3, part 1)
  107.   gccsrc2.zip   Patched GNU sources (GCC 2.6.3, part 2)
  108.   gccsrc3.zip   Patched GNU sources (GCC 2.6.3, part 3)
  109.   gassrc.zip    Patched GNU sources (GAS 2.3)
  110.   gdbsrc1.zip   Patched GNU sources (GDB 4.13, part 1)
  111.   gdbsrc2.zip   Patched GNU sources (GDB 4.13, part 2)
  112.   gppsrc.zip    Patched sources of libg++ 2.6.1
  113.  
  114. BSD libraries compiled for emx with sources:
  115.  
  116.   bsddev.zip    BSD libraries (curses etc.)
  117.   bsddoc.zip    Documentation for BSD libraries
  118.   bsdsrc.zip    Source for BSD libraries
  119.  
  120.  
  121. Installing emx
  122. --------------
  123.  
  124. For unpacking, you need unzip v5.0 or later which is available from
  125. many archives.  Look for files named
  126.  
  127.   unzip50.exe   MS-DOS executable for unzip
  128.   unz50_32.exe  OS/2 32-bit executable (unzip 5.0)
  129.   unz512x2.exe  OS/2 32-bit executable (unzip 5.12)
  130.   unzip512.exe  OS/2 or DOS executable (unzip 5.12)
  131.  
  132. Read INSTALL.DOC to learn how to install emx.
  133.  
  134. After unpacking the emx runtime and development system packages,
  135. you'll find further information in the following files:
  136.  
  137.   \emx\doc\COPYING.EMX          emx & library license, license overview
  138.   \emx\doc\COPYING              GNU General Public License
  139.   \emx\doc\install.doc          Installation guide
  140.   \emx\doc\emxrt.doc            User's guide to the emx runtime package
  141.   \emx\doc\emxdev.doc           Application developer's guide
  142.   \emx\doc\libref.doc           C library reference
  143.   \emx\doc\build.doc            Compiling the sources
  144.   \emx\doc\history.doc          Change log
  145.   \emx\doc\future.doc           Things to do
  146.   \emx\book\emxrt.inf           .inf version of emxrt.doc
  147.   \emx\book\emxdev.inf          .inf version of emxdev.doc (optional)
  148.   \emx\book\libref.inf          .inf version of libref.doc (optional)
  149.  
  150. After unpacking the GNU and BSD packages, you'll find further
  151. information in the following files:
  152.  
  153.   \emx\doc\COPYING              GNU General Public License
  154.   \emx\doc\COPYING.LIB          GNU Library General Public License
  155.   \emx\doc\COPYING.BSD          BSD license (for libraries bsd and curses)
  156.   \emx\doc\COPYING.IOS          Additional information for iostream library
  157.   \emx\doc\gnudev.doc           GNU development tools information
  158.   \emx\doc\bsddev.doc           BSD library information
  159.   \emx\book\gnudev.inf          .inf version of gnudev.doc (optional)
  160.   \emx\book\bsddev.inf          .inf version of bsddev.doc
  161.  
  162.  
  163. Legal stuff
  164. -----------
  165.  
  166. emx is free software; you can redistribute it and/or modify it
  167. under the terms of the GNU General Public License as published by
  168. the Free Software Foundation; either version 2, or (at your option)
  169. any later version.
  170.  
  171. emx is distributed in the hope that it will be useful,
  172. but WITHOUT ANY WARRANTY; without even the implied warranty of
  173. MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  174. GNU General Public License for more details.
  175.  
  176. You should have received a copy of the GNU General Public License
  177. along with emx; see the file COPYING.  If not, write to
  178. the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA.
  179.  
  180. See \emx\doc\COPYING.EMX and \emx\doc\COPYING for details.
  181.  
  182. Instead of a list: All the trademarks used in this document and all
  183. the other emx documents are registered to whoever it is that owns
  184. them.
  185.  
  186.  
  187. Where to get emx
  188. ----------------
  189.  
  190. emx is available for anonymous ftp on
  191.  
  192.   ftp.uni-stuttgart.de [129.69.18.15]: /pub/systems/os2/emx-0.9a
  193.   ftp-os2.cdrom.com:  [192.153.46.2]:  /os2/32bit/unix/emx09a
  194.   src.doc.ic.ac.uk     [146.169.2.1]:  /packages/os2/32bit/unix/emx09a
  195.   ftp.informatik.tu-muenchen.de [131.159.0.198]:
  196.                                        /pub/comp/os/os2/devtools/emx+gcc
  197.  
  198. Other files of interest
  199. -----------------------
  200.  
  201. emx does not come with a `make' utility.  I recommend dmake 3.8.  It's
  202. available for anonymous ftp on
  203.  
  204.   ftp.uni-stuttgart.de [129.69.18.15]: /pub/systems/os2/programming/support/
  205.   ftp-os2.cdrom.com:  [192.153.46.2]:  /os2/all/program/
  206.   ftp.informatik.tu-muenchen.de [131.159.0.198]:
  207.                                        /pub/comp/os/os2/devtools/
  208.  
  209. Executables are in dmake38x.zip, source code is in dmake38s.zip.
  210. dmake38.zip contains both dmake38s.zip and dmake38x.zip.
  211.  
  212. The emx graphics library currently supports only the 320x200 VGA mode
  213. and some 16-color modes.  Johannes Martin has created a graphics
  214. library for various SVGA cards.  It is available for anonymous ftp on
  215.  
  216.   ftp.uni-stuttgart.de [129.69.18.15]: /pub/systems/os2/emx-0.9a/contrib/
  217.   ftp-os2.cdrom.com:  [192.153.46.2]:  /os2/32bit/unix/emx09a/contrib/
  218.   ftp.informatik.tu-muenchen.de [131.159.0.198]:
  219.                                        /pub/comp/os/os2/gnu/emx+gcc/contrib/
  220.  
  221. You need svgakt*.zip (or svgakit*.zip) and vesa*.zip (or
  222. vesa_emx*.zip, * is the version number).
  223.  
  224. If you want to convert the texinfo files (GCC documentation, for
  225. instance) to OS/2 on-line books (.inf files), I recommend Andreas
  226. Kaiser's texi2ipf program:
  227.  
  228.   ftp-os2.cdrom.com:  [192.153.46.2]: /os2/32bit/unix/tex/txi2ipf1.zip
  229.   ftp.informatik.tu-muenchen.de [131.159.0.198]:
  230.                                       /pub/comp/os/os2/gnu/doc/txi2ipf1.zip
  231.  
  232.  
  233. Joining the mailing list
  234. ------------------------
  235.  
  236. An emx-related mailing list has been created: emx-list.  The address
  237. for people to request to be added to or removed from the list is:
  238.  
  239.     listserv@eb.ele.tue.nl
  240.  
  241. To subscribe, send a message containing
  242.  
  243.     sub emx-list Joe User
  244.  
  245. to listserv@eb.ele.tue.nl.  Of course, you should use your name
  246. instead of Joe User's name.  To unsubscribe, send a message containing
  247.  
  248.     unsub emx-list
  249.  
  250. to listserv@eb.ele.tue.nl.
  251.  
  252. By default, your messages to emx-list are not acknowledged.  To tell
  253. the list server to send acknowledge your messages, send a message
  254. containing
  255.  
  256.     set emx-list mail ack
  257.  
  258. to listserv@eb.ele.tue.nl.
  259.  
  260.  
  261. Thanks
  262. ------
  263.  
  264. Thanks to Ron Guilmette for providing copies of the ANSI C and POSIX.1
  265. standards.
  266.  
  267. Thanks to Kolja Elsaesser, Steffen Haecker, and Kai Uwe Rommel for
  268. contributing code to the emx C library.
  269.  
  270. Thanks to Holger Veit for preparing the TCP/IP header files.
  271.  
  272.  
  273. The author
  274. ----------
  275.  
  276. The author of emx is
  277.  
  278.     Eberhard Mattes
  279.     Teckstrasse 81                                      (TeX: Teckstra\ss e)
  280.     D-71696 Moeglingen                                  (TeX: M\"oglingen)
  281.     Germany
  282.  
  283. Internet: mattes@azu.informatik.uni-stuttgart.de  (subject to change)
  284.  
  285. No telephone calls please!  It must be stressed that the author does
  286. not reply to letters if you don't include return postage
  287. (international postal reply coupon if you are outside Germany) and a
  288. self-addressed envelope.
  289.  
  290. --------------------------- END OF README.DOC ------------------------------
  291.