dos_compilers/Microsoft Pascal v1/READ.ME

126 lines
4.5 KiB
Plaintext
Raw Permalink Normal View History

2024-06-30 15:59:54 +02:00
This describes the contents of the accompanying diskettes. A detailed
description of how to use the compiler and other utilities is given in
the appropriate User manuals. However, since these are still in
preparation and are not available, a brief outline is given below.
Files on this distribution
--------------------------
Pascal Compiler
READ.ME This Memo
PAS1.EXE Pascal Compiler Pass 1
PAS2.EXE Compiler Pass 2 (Common to Fortran and Pascal)
Pascal Run-Time
LINK.EXE Microsoft Linker for .OBJ files
PASCAL.LIB The Pascal Library
To use this distribution of Microsoft Pascal you need an MS-DOS
system with at least least 128K of contiguous main memory, and at least one
standard MS-DOS compatible floppy disk drive.
These files are distributed on two disks because they won't all fit on one
single-density disk. Disk 1 has the compiler first pass, PAS1.EXE; the Pascal
library, PASCAL.LIB; and other assorted files. Disk 2 has the compiler second
pass, PAS2.EXE; and the linker, LINK.EXE. If you have a double-density disk
system, you will find it much more convenient to use the compiler if you copy
all these files onto one double-density disk.
Compiling
---------
To use Microsoft Pascal please follow these instructions:
Place the disk containing pass one of the compiler (PAS1.EXE) in a drive.
Place a disk containing at least 160K free space in the default drive.
The intermediate files generated by the first pass of the compiler will be
put on this disk. If there is sufficient space on the disk with the first
pass of the compiler, it can be used to store the intermediate files.
The source file can be on any drive.
Initiate the first pass of the compiler by typing:
d:PAS1 sourcefile,objectfile,sourcelist,objectlist
You should note the following about the command line:
1. Filemanes can appear on the command line, of (if not enough are
given) the user is prompted for filenames.
2. Commas between filenames, and a trailing semicolon, are optional.
Lower case is always converted to upper case.
3. Filesnames occure in the following order:
source, object, source listing, object listing;
4. The source extension defaults to .PAS.
The object extension defaults to source.OBJ, listing file extensions
to .LST for the source listing, and .COD for the object listing.
Default extensions are given in the prompt.
5. There is no default source filename. Object filename defaults to
the same as the source, and listing filenames default to NUL except
that when a comma preceeds a missing listing filename it defaults to
the source filename as well:
"d:PAS1 SS,,,;" read SS.PAS, write SS.OBJ, SS.LST, SS.COD
"d:PAS1 SS;" read SS.PAS, write SS.OBJ, listings to NUL.
6. Blanks are permitted, except within filenames.
7. If the trailing ";" is missing from the command line and more
files could follow, the prompt sequence starts, giving default to use.
8. A new drive (as in "B:") or extension (as in ".REL") can be given
in any file position to override the default; does not affect the
filename itself.
Examples:
A:PAS1 pascalfn;
B:PAS1
Source file [.PAS]: pascalfn
Object file [.OBJ]: A:
Source list [.LST]: /c/d
Object list [.COD]: ;
Complete the compilation by inserting the disk with the compiler
second pass (PAS2.EXE) and typing:
d:PAS2
PAS2 is the same for Microsoft Fortran and Pascal because both
languages have a common intermediate form. As PAS2 executes,
it will read the intermediate files created by PAS1 from the
default drive and create a new file on the default drive: PASIBF.TMP
as well as the object and listing files. PASIBF.TMP is a temporary
file used by PAS2 for scratch. All of the PASIBF files are
automatically deleted when PAS2 completes normally. The object file
is the relocatable binary object file for input to the Microsoft Linker.
Linking
-------
Link the object program by typing:
LINK objectfile;
The Linker links the object file(s) using PASCAL.LIB as the library.
The command line syntax is similar to that of the Pascal front end,
except that more than one .OBJ file can be specified as input using
"+" as a separator. There are other features as well. Read the
Linker Manual to find out about them.
Running your Program
--------------------
Run the .EXE file by typing the name of the file without the
extension, e.g. to run A.EXE just type:
A