This package contains Version 3.5/4.0 of the FST (Fitted) Modula-2 Compiler. (C) Copyright 1987-1996 Fitted Software Tools. All rights reserved. DISCLAIMER OF WARRANTY THIS SOFTWARE AND MANUAL ARE PROVIDED "AS IS" AND WITHOUT WARRANTIES AS TO PERFORMANCE OR MERCHANTABILITY. THIS SOFTWARE IS PROVIDED WITHOUT ANY EXPRESS OR IMPLIED WARRANTIES WHATSOEVER. BECAUSE OF THE DIVERSITY OF CONDITIONS AND HARDWARE UNDER WHICH THIS SOFTWARE MAY BE USED, NO WARRANTY OF FITNESS FOR A PARTICULAR PURPOSE IS OFFERED. THE USER IS ADVISED TO TEST THIS SOFTWARE THOROUGHLY BEFORE RELYING ON IT. THE USER MUST ASSUME THE ENTIRE RISK OF USING THIS SOFTWARE. Specifications and availability of the products described are subject to change without notice. >>>>>>>>>>>>>>>>>>>>>> IMPORTANT <<<<<<<<<<<<<<<<<<<<<<<<<<< The dates of the .DEF files must be preserved when copies of this software are passed on. If you somehow get a copy of this software in which the .DEF files' dates were modified, please be careful! You could try using the linker's /K option, which would let you link your programs; But you might be in for REAL TROUBLE if the .DEF files were really modified! Full documentation for this product is in the files M2DOC.TXT (text format) and M2DOC.PS (postcript format). You may print the (text) documentation using the following command: COPY M2DOC.TXT PRN ************************************************************************ * About version 4.0 ************************************************************************ This is the final release of this product. Version 4.0 is nothing more than 3.5 minus the Shareware registration option. Only portions of the documentation were changed for this release; the software remains the same. ------------------------------------------------------------------------ - The version 4.0 distribution ------------------------------------------------------------------------ Listings of all the files included in this distribution is included in the DOC directory under the names "FILES.SHR" (freeware version of the system) and "FILES.REG" (full version of the system). ------------------------------------------------------------------ - Quick install ------------------------------------------------------------------ In this release, we distribute the software in a directory tree that can be simply copied (via xcopy) to your hard disk for installation. Try: MKDIR C:\M2 and copy each floppy with the command: XCOPY A:\ C:\M2 /S Then, set your PATH environment variable to include C:\M2\BIN and the M2LIB environment variable to C:\M2\LIB. ------------------------------- - To recompile the library: ------------------------------- ALL.MOD is a dummy module that imports all the library modules; It is used to help maintain the library. First CD to the directory where the library source files are -- using the installation instructions above, they end up in C:\M2\SRC\LIB); Then: GENMAKE all /l MC all /m or GENMAKE all /obj /l set m2output=obj mc all /m finally, you would install the object files in the LIB directory COPY *.M2O C:\M2\LIB (to build the LARGE MODEL library, "SET M2MODEL=LARGE" before performing the steps above) ------------------------------------------------------------------ To generate the OBJ and BIN object files from the ASM sources, we provide MKBIN.BAT: ------------------------------------------------------------------ MKBIN m2reals MKBIN m2longs MKBIN m2procs Ignore the warnings about lack of stack, during the link phase of the creation of the BIN files. ------------------------------------------------------------------ Using OBJ files: ------------------------------------------------------------------ You may not currently use the OOP features of the compiler if you intend to use OBJ file generation. ------------------------------------------------------------------ The 'C' Runtime option example directory: ------------------------------------------------------------------ The directory \M2\C in this distribution includes an example program (TESTSTOR) that exercises the 'C' library's malloc() and free() functions. Of particular interest are the following modules: main.C - C main module that invokes your M2 main c.DEF - defines some 'C' library functions System.MOD - version of System that works with main.C Storage.MOD - version of Storage that uses malloc() and free() ************************************************************************ I would like to thank Professor Pat Terry, of Rhodes University, for his help with the OOP section of the documentation. To all the FST Modula-2 users, whose support made version 3.5 possible, a warm thank you. Roger Carvalho --------------------- rogerc@metronet.com *** THE END ***