+ extended for OS/2

install/readme.txt

@@ -8,25 +8,72 @@
 * Intro
 ****************************************************************************
 
-This package contains a freeware pascal compiler for 386+. The language
-and the runtime library are less or more compatible to TP 7.0. Some Delphi
+This package contains a freeware 32-bit pascal compiler for 386+. The language
+and the runtime library are more or less compatible to TP 7.0. Some Delphi
 additions have also been implemented like exceptions and rtti.
 
+Free Pascal is currently available for the following platforms:
+- DOS, via the DJ Delorie's GO32V1 and GO32V2 Dos extenders
+- Linux (i386), both aout and elf
+- OS/2 & DOS, via the EMX extender
+- Win32 (Win32s, Win95/98 and WinNT)
+- Commodore Amiga
+- Atari ST
+
+More platforms will be supported in the future.
+
+
+****************************************************************************
+* Features
+****************************************************************************
+
+- high speed compiler
+- fully 32-bit code
+- code optimizer:
+  - peephole optimizer
+  - loading of variables into registers
+  - assembler level dataflow analyzer
+  - stack frame eliminations
+- language features:
+  - almost fully compatible with Borland Pascal
+  - long strings, ansi strings
+  - partially compatible with Borland Delphi
+  - procedure overloading
+  - operator overloading
+- integrated BASM (built-in assembler) parser
+  - supports ATT syntax used by GNU C
+  - supports Intel syntax used by Turbo Pascal
+- can compile code into assembler source code for these assemblers:
+  - GNU Assembler (GAS)
+  - Netwide assembler (Nasm)
+  - Microsoft Assembler/Turbo Assembler (Masm/Tasm)
+- can call external C code
+- smartlinking
+- support for the GNU debugger
+- cross-platform API
+- IDE (currently for GO32v2 and Win32 only)
+- can create binaries running natively under both DOS and OS/2 (EMX version)
+
 
 ****************************************************************************
 * Requirements
 ****************************************************************************
 
 386 processor
-DOS:
+DOS (extender GO32v2):
  - DOS 3.3
- - 640 kB RAM
- - hard disk with 8 MB free space
- - 4mb of memory (8+ MB recommended)
+ - 4 MB RAM (8+ MB recommended)
+ - hard disk with free space of 8 MB
  - DMPI server (CWSDPMI is delivered in the go32v2 distro)
 Win32:
- - Win95 or WinNT
- - 8mb of memory (16+ MB recommended)
+ - Win95/98 or WinNT
+ - 8 MB RAM (16+ MB recommended)
+OS/2 and DOS (extender EMX):
+ - either DOS 5.0 and above
+ or OS/2 v2.x and above
+ - 3 MB RAM (8+ MB recommended) for DOS
+ or 8 MB (12 or more MB recommended depending on OS version) for OS/2
+ - EMX runtime package (part of OS/2 distribution)
 
 
 ****************************************************************************
@@ -35,7 +82,9 @@ The current version is only an evaluation version.
 
 Quick start
 -----------
-Download dos09912.zip and unzip it into a temporary directory.
+Download dos09912.zip (version for DOS) or w3209912.zip (version for
+Win9x/NT) or os209912.zip (EMX version - for OS/2 and DOS) and unzip it
+into a temporary directory.
 
 Start the install program INSTALL.EXE and follow the instructions.
 
@@ -43,7 +92,7 @@ Don't forget to set the path as mentioned by the install program.
 
 To test the compiler, change to the demo directory of the compiler
 and type
-        ppc386 hello
+        ppc386 hello          or          ppos2 hello    (for EMX version)
         hello
 
 
@@ -57,14 +106,14 @@ as separate files to reduce file size if the default file is too big.
 
 dos09912.zip specific:
 ----------------------
-  basego32.zip    contains a DOS (Go32V2) compiler, run time library and
-                  additional files.
+  basego32.zip    contains a DOS (Go32V2) compiler, runtime library and
+                  additional files
   asldgo32.zip    contains additional GNU utilities which are necessary:
       AS 2.9.1 for Go32V2
       LD 2.9.1 for Go32V2
       AR 2.8.1 for Go32V2
       Strip 2.8.1 for Go32V2
-  utilgo32.zip    contains additional GNU utilities which are neccessary to
+  utilgo32.zip    contains additional GNU utilities which might be useful to
                   compile the run time library:
       Make 3.76.1
       RM 3.16
@@ -79,15 +128,15 @@ dos09912.zip specific:
 
 w3209912.zip specific:
 ----------------------
-  basew32.zip     contains a Win32 compiler, run time library and
-                  additional files.
+  basew32.zip     contains a Win32 compiler, runtime library and
+                  additional files
   asldw32.zip     contains additional GNU utilities from MinGW32 which are
                   necessary:
       AS 2.9.1 for Win32
       LD 2.9.1 for Win32
       AR 2.9.1 for Win32
       Strip 2.9.1 for Win32
-  utilw32.zip     contains additional GNU utilities which are neccessary to
+  utilw32.zip     contains additional GNU utilities which might be useful to
                   compile the run time library:
       Make 3.76.1
       RM 3.16
@@ -97,14 +146,36 @@ w3209912.zip specific:
       GInstall 3.16
       Date 3.16
       Echo 3.16
-      UPX 0.71
+      UPX 0.72
   gdbw32.zip      contains the GNU Debugger 4.16.1 for Win32
 
-common files in dos09912.zip and w3209912.zip:
+os209912.zip specific:
+----------------------
+  baseemx.zip     contains an EMX (OS/2 and DOS) compiler, runtime library and
+                  additional files
+  asldemx.zip     contains additional GNU utilities which are necessary:
+      AS 2.6 for EMX
+      LD for EMX
+      EMXBIND 0.9d
+      AR 2.6 for EMX
+      Strip for EMX
+  utilemx.zip     contains additional GNU utilities which might be useful to
+                  compile the run time library:
+      Make 3.76.1
+      RM 3.16
+      CP 3.16
+      MV 3.16
+      PWD 3.16
+      GInstall 3.16
+      Date 3.16
+      Echo 3.16
+  gdbemx.zip      contains the GNU Debugger 4.16 for EMX
+
+common files in dos09912.zip, w3209912.zip and os209912.zip:
 ----------------------------------------------
   demo.zip        contains some demo files
-  docs-htm.zip    contains the documentatio in HTML format
-  docs-ps.zip     contains the documentaion in post script
+  docs-htm.zip    contains the documentation in HTML format
+  docs-ps.zip     contains the documentation in PostScript
   install.exe     installation program
   install.dat     installation data
   readme.txt      this readme file
@@ -113,7 +184,7 @@ common files in dos09912.zip and w3209912.zip:
 Optional source package src09912.zip:
 -------------------------------------
   pp09912s.zip    contains the compiler sources
-  rl09912s.zip    contains the run time library sources
+  rl09912s.zip    contains the runtime library sources
   doc120s.zip     contains the TeX sources of the doc
 
 
@@ -121,10 +192,10 @@ Optional source package src09912.zip:
 * Documentation
 ****************************************************************************
 
-The documentations are available as HTML pages.
+The documentation is available as HTML pages.
 The documentation "home page" is doc\fpctoc.htm (FPC Table Of Contents).
 
-The documentation as post script is available at the ftp server.
+The documentation in PostScript is available at the ftp server.
 
 
 ****************************************************************************
@@ -133,8 +204,10 @@ The documentation as post script is available at the ftp server.
 
 Suggestions, Help ...
 ---------------------
-EMail: [email protected]
+e-mail: [email protected]
 WWW: http://tfdec1.fys.kuleuven.ac.be/~michael/fpc/
+(several mirrors exist)
+FTP: ftp://tflily.fys.kuleuven.ac.be/pub/fpc
 Additional informations about mailing lists etc. can be found on the
 web site.
 
@@ -146,5 +219,9 @@ web site.
 The programs and sources come under the GPL, for more informations read
 the file COPYING. Additional informations about the runtime library license
 are found in COPYING.FPC. Some utilities and programs come under the license
-described in COPYING.DJ
+described in COPYING.DJ or COPYING.EMX
 
+NOTE: OS/2 version of the installer uses the library UNZIP32.DLL from
+      Info-ZIP. Info-ZIP's software (Zip, UnZip and related utilities)
+      is free and can be obtained as source code or executables from
+      Internet/WWW sites, including http://www.cdrom.com/pub/infozip/ .