home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 22 gnu / 22-gnu.zip / emx09d.zip / README.DOC < prev   
Text File  |  1998-12-22  |  10KB  |  309 lines
  1. ===============================================================================
  2. readme.doc        emx 0.9d    INTRODUCTION                          21-Dec-1998
  3. ===============================================================================
  4.                                      Copyright (c) 1990-1998 by Eberhard Mattes
  5.  
  6.             *** See history.doc for important information ***
  7.  
  8. Introduction
  9. ------------
  10.  
  11. Welcome to emx 0.9d, an environment for creating 32-bit programs for
  12. OS/2 and DOS.  You can use the GNU C compiler to compile programs for
  13. emx.  The main design goal of emx is to simplify porting Unix software
  14. to OS/2 and DOS.  Moreover, you can create `native' OS/2 programs,
  15. 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
  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 and
  27.   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.8.1, the GNU C compiler, supporting the C, C++, and
  49.   Objective C languages
  50.  
  51. - GAS 2.6, the GNU assembler
  52.  
  53. - GDB 4.16, the GNU debugger
  54.  
  55. - ld, an ancient version of the GNU linker hacked for emx
  56.  
  57. - strip: a member of an ancient version of the GNU binary utilties
  58.  
  59. - ar, nm, size, objdump: a subset of the GNU binary utilities 2.6
  60.  
  61. - gprof, the BSD/GNU profiler
  62.  
  63. - texinfo, the GNU documentation system
  64.  
  65. - Patches for the GNU sources
  66.  
  67. - Patched source for GCC, GAS, GDB, ld, ar, nm, size, strip, objdump,
  68.   info, makeinfo, texindex.  You can compile all these programs with
  69.   the files that come with emx (but you also need a make utility, such
  70.   as dmake).
  71.  
  72. You can get the complete unpatched GNU sources by anonymous ftp from
  73. prep.ai.mit.edu and other archives such as ftp.leo.org.
  74.  
  75. Additionally, the following libraries are provided:
  76.  
  77. - some parts of the BSD C library
  78.  
  79. - the BSD data base library: dbopen()
  80.  
  81. - BSD curses library
  82.  
  83. - Henry Spencer's regexp library
  84.  
  85. - The GNU and BSD termcap libraries
  86.  
  87.  
  88. Packages
  89. --------
  90.  
  91. emx is packaged in the following files:
  92.  
  93.   emxrt.zip     emx runtime package
  94.   emxsrcr.zip   Source for the emx runtime package
  95.   emxdev1.zip   emx development system (without compiler, part 1)
  96.   emxdev2.zip   emx development system (without compiler, part 2)
  97.   emxsrcd1.zip  Source for the emx development system (part 1)
  98.   emxsrcd2.zip  Source for the emx development system (part 2)
  99.   emxview.zip   emx documentation in OS/2 .inf format
  100.   emxample.zip  Sample programs
  101.   emxtest.zip   Test programs (used for testing emx and the libraries)
  102.  
  103. GNU programs compiled for emx, patches and patched sources:
  104.  
  105.   gnudev1.zip   GNU development tools compiled for emx (part 1)
  106.   gnudev2.zip   GNU development tools compiled for emx (part 2)
  107.   gnuview.zip   emxgnu.inf (emxgnu.doc in OS/2 .inf format)
  108.   gppdev1.zip   Additional GNU programs and files for compiling C++
  109.   gppdev2.zip   libg++ 2.8.1.1a
  110.   gobjcdev.zip  Additional GNU programs and files for compiling
  111.                 Objective C
  112.   gnupat.zip    Patches for GNU sources
  113.   gnudoc.zip    Documentation for GNU programs (texinfo sources)
  114.   gnuinfo.zip   GNU texinfo (includes info file browser)
  115.   gnusrc.zip    Patched GNU sources (info, termcap, GPPDEMID)
  116.   gbinusrc.zip  Patched GNU sources (ld, ar, nm, size, strip, objdump, gprof)
  117.   gccsrc1.zip   Patched GNU sources (GCC 2.8.1, part 1)
  118.   gccsrc2.zip   Patched GNU sources (GCC 2.8.1, part 2)
  119.   gccsrc3.zip   Patched GNU sources (GCC 2.8.1, part 3)
  120.   gdbsrc1.zip   Patched GNU sources (GDB 4.16, part 1)
  121.   gdbsrc2.zip   Patched GNU sources (GDB 4.16, part 2)
  122.   gppsrc1.zip   Patched sources of libstdc++ 2.8.1.1
  123.   gppsrc2.zip   Patched sources of libg++ 2.8.1.1a
  124.  
  125. BSD libraries compiled for emx with sources:
  126.  
  127.   bsddev.zip    BSD libraries (curses etc.)
  128.   bsddoc.zip    Documentation for BSD libraries
  129.   bsdsrc.zip    Source for BSD libraries
  130.  
  131.  
  132. Installing emx
  133. --------------
  134.  
  135. For unpacking, you need unzip v5.0 or later which is available from
  136. many archives.  Look for files named
  137.  
  138.   unzip50.exe   MS-DOS executable for unzip
  139.   unz50_32.exe  OS/2 32-bit executable (unzip 5.0)
  140.   unz512x2.exe  OS/2 32-bit executable (unzip 5.12)
  141.   unzip512.exe  OS/2 or DOS executable (unzip 5.12)
  142.  
  143. Read INSTALL.DOC to learn how to install emx.
  144.  
  145. After unpacking the emx runtime and development system packages,
  146. you'll find further information in the following files:
  147.  
  148.   \emx\doc\COPYING.EMX          emx & library license, license overview
  149.   \emx\doc\COPYING              GNU General Public License
  150.   \emx\doc\install.doc          Installation guide
  151.   \emx\doc\emxrt.doc            User's guide to the emx runtime package
  152.   \emx\doc\emxdev.doc           Application developer's guide
  153.   \emx\doc\emxlib.doc           C library reference
  154.   \emx\doc\faq.doc              Frequently asked questions (with answers)
  155.   \emx\doc\build.doc            Compiling the sources
  156.   \emx\doc\history.doc          Change log
  157.   \emx\doc\future.doc           Things to do
  158.   \emx\book\emxrt.inf           .inf version of emxrt.doc
  159.   \emx\book\emxdev.inf          .inf version of emxdev.doc (optional)
  160.   \emx\book\emxlib.inf          .inf version of emxlib.doc (optional)
  161.  
  162. After unpacking the GNU and BSD packages, you'll find further
  163. information in the following files:
  164.  
  165.   \emx\doc\COPYING              GNU General Public License
  166.   \emx\doc\COPYING.LIB          GNU Library General Public License
  167.   \emx\doc\COPYING.BSD          BSD license (for libraries bsd and curses)
  168.   \emx\doc\COPYING.SCP          Additional information for stdc++ library
  169.   \emx\doc\emxgnu.doc           GNU development tools information
  170.   \emx\doc\emxbsd.doc           BSD library information
  171.   \emx\book\emxgnu.inf          .inf version of emxgnu.doc (optional)
  172.   \emx\book\emxbsd.inf          .inf version of emxbsd.doc
  173.  
  174.  
  175. Legal stuff
  176. -----------
  177.  
  178. emx is free software; you can redistribute it and/or modify it
  179. under the terms of the GNU General Public License as published by
  180. the Free Software Foundation; either version 2, or (at your option)
  181. any later version.
  182.  
  183. emx is distributed in the hope that it will be useful,
  184. but WITHOUT ANY WARRANTY; without even the implied warranty of
  185. MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  186. GNU General Public License for more details.
  187.  
  188. You should have received a copy of the GNU General Public License
  189. along with emx; see the file COPYING.  If not, write to
  190. the Free Software Foundation, 59 Temple Place - Suite 330,
  191. Boston, MA 02111-1307, USA.
  192.  
  193. See \emx\doc\COPYING.EMX and \emx\doc\COPYING for details.
  194.  
  195. Instead of a list: All the trademarks used in this document and all
  196. the other emx documents are registered to whoever it is that owns
  197. them.
  198.  
  199.  
  200. Where to get emx
  201. ----------------
  202.  
  203. emx is available for anonymous ftp on
  204.  
  205.   ftp.leo.org:          /pub/comp/os/os2/leo/gnu/emx+gcc/
  206.   ftp-os2.cdrom.com:    /pub/os2/emx09d/
  207.   ftp-os2.nmsu.edu:     /pub/os2/dev/emx/v0.9d/
  208.  
  209.  
  210. Other files of interest
  211. -----------------------
  212.  
  213. emx does not come with a `make' utility.  I recommend dmake 3.8.  It's
  214. available for anonymous ftp on
  215.  
  216.   ftp.leo.org:          /pub/comp/os/os2/leo/devtools/utils/
  217.   ftp-os2.cdrom.com:    /pub/os2/dev16/
  218.  
  219. Executables are in dmake38x.zip, source code is in dmake38s.zip.
  220. dmake38.zip contains both dmake38s.zip and dmake38x.zip.
  221.  
  222. The emx graphics library currently supports only the 320x200 VGA mode
  223. and some 16-color modes.  Johannes Martin has created a graphics
  224. library for various SVGA cards.  It is available for anonymous ftp on
  225.  
  226.   ftp.leo.org:          /pub/comp/os/os2/leo/gnu/emx+gcc/contrib/
  227.   ftp-os2.nmsu.edu:     /pub/os2/dev/emx/contrib/
  228.  
  229. You need svgakt*.zip (or svgakit*.zip) and vesa*.zip (or
  230. vesa_emx*.zip, * is the version number).
  231.  
  232. If you want to convert the texinfo files (GCC documentation, for
  233. instance) to OS/2 on-line books (.inf files), I recommend Andreas
  234. Kaiser's texi2ipf program:
  235.  
  236.   ftp.leo.org:          /pub/comp/os/os2/leo/gnu/doc/txi2ipf1.zip
  237.   ftp-os2.cdrom.com:    /pub/os2/tex/txi2ipf1.zip
  238.  
  239.  
  240. Joining the mailing list
  241. ------------------------
  242.  
  243. An emx-related mailing list has been created.  The address for people
  244. to request to be added to or removed from the list is:
  245.  
  246.     majordomo@iaehv.nl
  247.  
  248. To subscribe, send a message containing
  249.  
  250.     subscribe emx
  251.  
  252. to majordomo@iaehv.nl.  To unsubscribe, send a message containing
  253.  
  254.     unsubscribe emx
  255.  
  256. to majordomo@iaehv.nl.
  257.  
  258. For more information, send a message containing
  259.  
  260.     help
  261.  
  262. to majordomo@iaehv.nl.
  263.  
  264.  
  265. Thanks
  266. ------
  267.  
  268. Thanks to Ron Guilmette <rfg@monkeys.com> for providing copies of the
  269. ANSI C and POSIX.1 standards.
  270.  
  271. Thanks to Kolja Elsaesser, Steffen Haecker
  272. <haecker@mathematik.uni-stuttgart.de>, and Kai Uwe Rommel
  273. <rommel@ars.de> for contributing code to the emx C library.
  274.  
  275. Thanks to Fred Tydeman <tydeman@tybor.com> for help with floating
  276. point math and for testing the emx C library with his FPCE test suite
  277. (blame me, not him, for all the problems found by the test suite and
  278. not fixed yet).
  279.  
  280. Thanks to Holger Veit <Holger.Veit@gmd.de> for preparing the TCP/IP
  281. header files and for providing information about DosProfile.
  282.  
  283. Thanks to Willem Jan Withagen <wjw@IAEhv.nl> for the emx mailing list.
  284.  
  285.  
  286. The author
  287. ----------
  288.  
  289. The author of emx is
  290.  
  291.     Eberhard Mattes
  292.     Teckstrasse 81                                      (TeX: Teckstra\ss e)
  293.     D-71696 Moeglingen                                  (TeX: M\"oglingen)
  294.     Germany
  295.  
  296. Internet:
  297.  
  298.     mattes@azu.informatik.uni-stuttgart.de  (subject to change)
  299.     mattes@windhager.de
  300.  
  301. No telephone calls please!  It must be stressed that the author does
  302. not reply to letters if you don't include return postage
  303. (international postal reply coupon if you are outside Germany) and a
  304. self-addressed envelope.
  305.  
  306. Read \emx\doc\faq.doc before asking the author.
  307.  
  308. --------------------------- END OF README.DOC ------------------------------
  309.