diff --git a/install/readme.txt b/install/readme.txt index 5c02e86657..fd51bc6faa 100644 --- a/install/readme.txt +++ b/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: fpc-devel@vekoll.saturnus.vein.hu +e-mail: fpc-devel@vekoll.saturnus.vein.hu 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/ .