Domain Pascal Software Release Document
Software Release 9.7.1
Part No. 05502-B02
This document describes the Pascal compiler
for Domain software release 9.7.1.
APOLLO COMPUTER INC.
330 Billerica Road
Chelmsford, Massachusetts 01824
Confidential and Proprietary. Copyright 1988
Apollo Computer, Inc., Chelmsford, Massachusetts.
Unpublished -- rights reserved under the Copyright
Laws of the United States. All Rights Reserved.
Latest Printing: July, 1988
This document was formatted using the FMT tool distributed with the Domain
computer system.
Apollo and Domain are registered trademarks of Apollo Computer Inc.
UNIX is a registered trademark of AT&T in the USA and other countries. Ada
is a registered trademark of U.S. Government (Ada Joint Program Office).
3DGMR, Aegis, D3M, DGR, Domain/Access, Domain/Ada, Domain/Bridge, Domain/C,
Domain/ComController, Domain/CommonLISP, Domain/CORE, Domain/Debug,
Domain/DFL, Domain/Dialogue, Domain/DQC, Domain/IX, Domain/Laser-26,
Domain/LISP, Domain/PAK, Domain/PCC, Domain/PCI, Domain/SNA, Domain X.25,
DPSS, DPSS/Mail, DSEE, FPX, GMR, GPR, GSR, NLS, Network Computing Kernel,
Network Computing System, Network License Server, Open Dialogue, Open
Network Toolkit, Open System Toolkit, Personal Supercomputer, Personal Super
Workstation, Personal Workstation, Series 3000, Series 4000, Series 10000,
and VCD-8 are trademarks of Apollo Computer Inc.
Apollo Computer Inc. reserves the right to make changes in specifications
and other information contained in this publication without prior notice,
and the reader should in all cases consult Apollo Computer Inc. to determine
whether any such changes have been made.
THE TERMS AND CONDITIONS GOVERNING THE SALE OF APOLLO COMPUTER INC. HARDWARE
PRODUCTS AND THE LICENSING OF APOLLO COMPUTER INC. SOFTWARE PROGRAMS CONSIST
SOLELY OF THOSE SET FORTH IN THE WRITTEN CONTRACTS BETWEEN APOLLO COMPUTER
INC. AND ITS CUSTOMERS. NO REPRESENTATION OR OTHER AFFIRMATION OF FACT
CONTAINED IN THIS PUBLICATION, INCLUDING BUT NOT LIMITED TO STATEMENTS
REGARDING CAPACITY, RESPONSE-TIME PERFORMANCE, SUITABILITY FOR USE OR
PERFORMANCE OF PRODUCTS DESCRIBED HEREIN SHALL BE DEEMED TO BE A WARRANTY BY
APOLLO COMPUTER INC. FOR ANY PURPOSE, OR GIVE RISE TO ANY LIABILITY BY APOLLO
COMPUTER INC. WHATSOEVER.
IN NO EVENT SHALL APOLLO COMPUTER INC. BE LIABLE FOR ANY INCIDENTAL,
INDIRECT, SPECIAL OR CONSEQUENTIAL DAMAGES WHATSOEVER (INCLUDING BUT NOT
LIMITED TO LOST PROFITS) ARISING OUT OF OR RELATING TO THIS PUBLICATION OR
THE INFORMATION CONTAINED IN IT, EVEN IF APOLLO COMPUTER INC. HAS BEEN
ADVISED, KNEW OR SHOULD HAVE KNOWN OF THE POSSIBILITY OF SUCH DAMAGES.
THE SOFTWARE PROGRAMS DESCRIBED IN THIS DOCUMENT ARE CONFIDENTIAL INFORMATION
AND PROPRIETARY PRODUCTS OF APOLLO COMPUTER INC. OR ITS LICENSORS.
Reader_Notice
This document resides online in the /doc directory. To print a copy of this
document, use the prf command with the -npag and -pr options.
prf <file_pathname> -pr <printer_name> -npag
iii
Contents
Section
CHAPTER 1 OVERVIEW OF DOMAIN Pascal Language SR 9.7.1 . . . . . . 1-1
1.1 The -frnd Compile Option . . . . . . . . . . . . . . . . 1-1
1.2 The -cpu fpa1 Compile Option . . . . . . . . . . . . . . 1-2
CHAPTER 2 SOFTWARE INSTALLATION PROCEDURES . . . . . . . . . . . . 2-1
CHAPTER 3 DOCUMENTATION . . . . . . . . . . . . . . . . . . . . . 3-1
CHAPTER 4 BUGS AND BUG FIXES . . . . . . . . . . . . . . . . . . . 4-1
Contents iv
CHAPTER 1
OVERVIEW OF Pascal AT SR9.7.1
Release 9.7.1 of the Pascal language compiler provides two functional
enchancements: a -cpu fpa1 compile option and a -frnd compile option.
Sections 1.1 and 1.2 describe these new options. See Chapter 4 for a list of
bugs fixed.
If you are updating from a 9.6 release of the Pascal compiler, these release
notes are all you need. If you are updating from a previous release, you
should look at the release notes that accompanied the intervening releases.
For instance, if you are going from SR9.2 to SR9.7.1, you should read
"pas.release_notes.sr9.5" and "pas_release_notes.sr9.6" in addition to the
SR9.7.1 release notes. See the online /doc directory for additional release
notes.
1.1 The -frnd compile option
When you use -frnd the compiler follows this sequence:
o Checks to see if any floating point values to be compared are the
result of a computation.
o Checks to see if any floating point values to be compared are in
registers.
o Any single precision (32 bit) values that are in registers and the
result of a computation are rounded to 32 bits. Similarly, any
double precision (64 bit) values that are in registers and the
result of a computation are rounded to 64 bits. The compiler uses
the rounded values for the comparision.
SR9.7.1 Version 1-1 Domain Pascal
NOTE: By default the registers used for floating point calculations are
extended precision (80 bit) registers. Using the -frnd option
causes the compiler to behave as if it were using 32-bit and
64-bit registers. Since the truncation of results to the correct
register size before comparison increases execution time and may
decrease accuracy, we recommend that you use the -frnd option only
if you have a special requirement to make your program behave the
same as a 32/64 bit machine.
1.2 The -cpu fpa1 option
The -cpu fpa1 option directs the compiler to produce optimized code for the
Floating-Point Accelerator (FPA) board that is available with DN4000
workstations. Use of this switch can produce substantially faster code. Do
not use this switch, however, if the target machine does not have an FPA
board.
Domain Pascal 1-2 SR9.7.1 Version
CHAPTER 2
INSTALLATION INFORMATION
You can add Domain Pascal Version 7.54 (the SR9.7.1 version of the compiler)
to a user node (one equipped with monitor and keyboard) or a Domain Server
Processor (DSP) that is running SR9.6 or a more recent version of the Aegis
or Domain/IX operating system. If the user node or DSP is not running SR9.6
or a more recent version, follow the appropriate software update procedures
as described in Installing__Domain__Software (Order No. 008860) or in the
appropriate release notes.
For general instructions on how to install this product, see the manual
Installing__Domain__Software (Order No. 008860). Chapter 5 of that manual, in
particular, describes installation of optional product software. There have
been some enhancements made to the installation procedure since the
publication of the last revision of Installing_Domain_Software; we describe
those changes here.
o Choosing a Target Node
The new installation sets the TARGET area by default to the current
work node. When you are prompted to enter a TARGET, the name of the
current work node appears as the default and can be selected simple
by pressing the <RETURN> key. For example:
The TARGET is the node or subdirectory on which you are installing
software (e.g., '//my_node' or '//my_node/subdirectory').
Enter Target: <//sum> <RETURN>
The program then confirms your choice of target.
TARGET set to : //sum
o Choosing a Source Area
When you choose a source area, the program now confirms your choice by displaying it
on the screen. For example:
The SOURCE AREA is the node or subdirectory from which you are
copying software (e.g., '//node' or '//node/subdirectory').
Enter Source Area: //ergo
SOURCE AREA set to : //ergo
SR9.7.1 Version 2-1 Domain Pascal
o Improved Error Checking and Verification
After you have chosen the TARGET, the INSTALL program describes
constraints on the installation process, and asks if you wish to see
a list of directories affected by those constraints. If you choose to
see such a listing by typing 'yes' or 'y', the tool displays the list
immediately, or prints the message "No errors found." For example:
NOTICE:
Objects will not be installed across
links, nor if unexpected objects currently
exist where directories are needed.
Would you like to see a listing of any
problems of this sort before proceeding?
Yes or No? y
-------------------------------------------------
Listing pathname errors found with TARGET set to //sum
(Please be patient)
//sum/sys/help
//sum/domain_examples
If you answered the question above with a 'yes' or 'y', and the
program displayed one or more 'pathname errors,' the program now
describes the warning messages about link objects that are generated
during a later phase of the installation. Enter 'yes' or 'y' at the
prompt if you wish to see error messages regarding installation of
links. If you wish to suppress such messages, enter 'no' or 'n.'
The program displays a warning message
whenever one of these objects is
encountered during the installation,
although the display of these messages
can be suppressed.
CAUTION : These objects will not be
installed, whether or not the warning
messages are displayed.
Do you want to see the warning messages?
Yes or No? y
NOTE: The user node or DSP must have a minimum of 1343 blocks of
available disk space for a successful installation of this
software.
Domain Pascal 2-2 SR9.7.1 Version
CHAPTER 3
DOCUMENTATION
The current Domain__Pascal_Language_Reference_Manual (Order No. 000792, rev.
05) reflects the compiler released at SR9.5. Chapter 1 of these release
notes tells you about additional features at SR9.7.1.
NOTE: If you have not used any releases between 9.2 and 9.7, then you
probably need to know about changes in the SR9.5 and SR9.6
releases as well as changes at 9.7.1. For information about these
changes, read pas.release_notes.sr9.5 and pas.release_notes.sr9.6.
These documents are online in the /doc directory.
SR9.7.1 Version 3-1 Domain Pascal
CHAPTER 4
BUGS AND BUG FIXES
This chapter lists bugs in the Pascal compiler that have been fixed. There
are no known bugs or limitations in this release of the Pascal compiler.
4.1 Bugs Fixed
The following bugs have been fixed:
o VARYING strings could not be passed as the file name to OPEN.
o Tests for one set being a subset of another were performed
incorrectly.
o Assignments to variables marked with the DEVICE attribute
were sometimes eliminated.
The APRs (Apollo Product Reports) with the following numbers have been fixed:
000DC290
Customer code incorrectly generated error 168.
SR9.7.1 Version 4-1 Domain Pascal