DRAPER PASCAL#
Version 2.1
Copyright 1989 by Norm Draper
For the Atari 400, 800, XL, or XE series computers
Disk Based Documentation#
This document contains the "Getting Started" section plus other sections from the actual Draper Pascal manual. It is designed to get you up and running and doing useful things with Draper Pascal in a very short time. It does not, however, contain a detailed description of all the Draper Pascal definitions or pretend to be a comprehensive tutorial or user's reference. Registered users will receive the actual Draper Pascal manual which does contain a complete description of all definitions plus other information. Details on registering are in the last section titled "Registration Form".
The Shareware Concept#
Draper Pascal is distributed on a Shareware basis. You may use Draper Pascal without charge for the purpose of evaluating it's suitability for your use. If you find that Draper Pascal is worth continuing to use, then you are requested to become a registered user and gain the additional benefits that go along with it. Simply complete the registration form and mail it in to us with the very reasonable payment of only $15.00. When you register your copy of Draper Pascal, you'll receive the latest version of the software if your registered version is not current, along with a comprehensive printed user manual.
If you have received this copy from a Users' Group, "Software Library" or "SIG", and have paid a small fee (usually $3 to $10), you have NOT acquired the registered rights or continued right to use Draper Pascal. This fee was for the convenience of obtaining the diskette with Draper Pascal on it. The fee does NOT apply to the registration fee.
You may freely copy Draper Pascal for distribution under the Shareware concept, without charge.
You may NOT charge any fee for the Draper Pascal program or documentation without our written approval.
You may NOT distribute Draper Pascal or it's documentation in connection with ANY commercial venture, product, publication or service unless you obtain the royalty-free license by registering.
Features#
- Draper Pascal is a complete package allowing the user to create, compile, and execute programs written in the Pascal language.
- Many features from both UCSD and ISO standard Pascals plus many extensions, such as sound and graphics, to make use of the versatile Atari hardware.
- Pascal structured programming features, including IF-THEN-ELSE, WHILE-DO, CASE-OF-ELSE, FOR-TO/DOWNTO-DO, and REPEAT-UNTIL are included.
- FUNCTIONs and PROCEDUREs using local or global variables. Integer type variables can be passed directly.
- Data types supported include: Character, String, Integer, Real, Boolean, Record, and File. One and two dimension arrays are also supported for all data types other than File and Record.
- Only one disk drive and 48K RAM are required. Multiple, and double density, disk drives are supported.
- Machine language subroutines may be loaded and called.
- Program chaining is supported.
- No limit on source program size. "Include" files are supported.
- One-pass compiler generates pseudo code directly.
- Maximum program pseudo code size is about 30K bytes.
- Textual compiler error messages.
- Execution debugging features include instruction trace and stack display.
- Special options for error display and break key disable.
- Single keystroke program execution repeat, exit to DOS, or exit to Main Menu program are featured.
- Includes Editor program to create, modify, and print Pascal source files, or other text type files.
- Includes Main Menu program (Pascal source included) for easy select of Compiler, Editor, or utility functions, such as directory or file listing. Main Menu program may be replaced with a user written program to create a turnkey operation.
- Ramdisk support. Details provided to registered users.
- Works with most popular versions of DOS.
- Easy to use. No linking required. Compile and execute immediately.
- Royalty free license available to registered users.
- Includes sample programs.
- Comprehensive user manual provided to registered users. Complete examples and BASIC equivalents given for each reserved word.
Introduction#
Draper Software welcomes you to the world of Pascal for the Atari 400/800, XL, and XE series Computer systems.
What is Pascal?#
Pascal is a high-level structured programming language developed by Niklaus Wirth in 1971. It is easy to understand and well suited for program development and maintenance.
What is Draper Pascal?#
Draper Pascal is not a "standard" Pascal. It has a number of commands which are exactly like ISO and UCSD versions, some which are similar, and many "extensions" which bring out the true power of the Atari computer in an easy to use manner. It was designed to require only one disk drive for operation, but not be limited to only one. At this time, it has been shown to work with all hardware and software configurations where enough memory is provided. This implementation also has a number of commands which are familiar to Atari BASIC users, such as POKE, PEEK, SETCOLOR, NOTE, POINT, etc..
About this manual#
This manual is intended to familiarize you with all the features of Draper Pascal. It is not intended to teach you how to program in Pascal. However, if you already know Atari BASIC, then you can understand the Pascal statements more easily by referring to their BASIC equivalents shown after the definition of each Pascal reserved word in the complete manual provided to registered users. It is recommended that you read this manual completely to be familiarized with its features and restrictions.
What is Draper Pascal made of?#
This implementation of Pascal is made up of three main components. They are the Supervisor (sometimes referred to as runtime routines), the Compiler, and the Editor. The Supervisor is a high performance machine language program which simulates a 16-bit pseudo computer. The Compiler translates Pascal source code into pseudo-code instructions to be executed by the Supervisor. The Editor is used to enter and modify Pascal source programs. It may also be used to edit data files, or BASIC programs which have been LISTed to a disk or tape. These components are explained in detail within this manual.
For a description of the various files included on the supplied diskette, refer to the 'System Information' section.
About the DOS#
Draper Pascal can be used with most popular Disk Operating Systems. It has been tested with Atari DOS 2.5, SpartaDOS 3.2d, and MYDOS. You should format a diskette with DOS on it to contain the Draper Pascal system. Since the Draper Pascal Supervisor is named AUTORUN.SYS, it will execute immediately after the disk is booted. For XL and XE computers, you do not need to hold down the Option key while booting unless you are using SpartaDOS. If using SpartaDOS, you may want to rename AUTORUN.SYS to PASCAL.COM and create a STARTUP.BAT file containing the following two lines:
BASIC OFF PASCALThis documentation file is not required to be on that same diskette.
Ramdisk support#
Draper Pascal supports the use of the "Ramdisk" capability provided by using a DOS that supports a ramdisk like Atari DOS 2.5 or SpartaDOS 3.x with an Atari computer system having sufficient memory to support the ramdisk. While using this feature, the Editor takes less than two seconds to load and the Compiler takes less than three seconds. Details on setup and use of this feature are provided in the complete manual provided to registered users.
Getting Started#
This section is intended to show by example how to use the Draper Pascal system. You will edit, compile, and run a sample program. Information displayed by the computer is shown in normal type while responses to be entered by you are shown underlined with dashes (---). To begin with, make sure you have 48K RAM installed and no cartridge in place. Boot the disk now by placing it in disk drive 1 and turning on the power to the Atari computer. After the Supervisor has finished loading, you will see a screen that looks like this:
DRAPER PASCAL 1 - Run Program 2 - Disk Directory 3 - Compile Program 4 - Edit a Program 5 - Exit to DOS 6 - List a file 7 - Trace on
DRAPER SOFTWARE
EDITOR
A - Add line(s) at end
C - Change line(s)
D - Delete line(s)
E - Edit a line
F - Filer menu
I - Insert before line
L - List line(s)
M - Menu
P - Print line(s)
Q - Quit
S - Scan line(s)
X - Exit to Compiler
A,C,D,E,F,I,L,M,P,Q,S,X,?->F Select Filer menu
-
A - Append file
D - Directory list
L - Load file
S - Save file
L Load a file
-
Enter filename -> SAMPLE1 Enter the name of the file
------- to be loaded. The name of
the last file edited,
compiled, or run will be
filled in by the Editor.
You may have to overtype
it with the name shown.
A,C,D,E,F,I,L,M,P,Q,S,X,?->L List the file on the
- screen
Line from -> Just press RETURN for
- 'Line from' and 'Line to'.
Line to -> This will give a list of
- the entire program in
memory.
