Museum

Home

Lab Overview

Retrotechnology Articles

⇒ Online Manual

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

commands

config list box

config name

help

main push buttons

options

opt push but

quit

apply delete

add

about

overview

common user tasks

using help

unsupported compilation options

options list

listing

tools

checking

generation

data

source

environment generation

list

show

messages

terminal

dictionary

cross reference

header

include

inline

machine code

source

statistics

table of contents

warnings

file names

routine names

statistics

analysis data

design

diagnostics

comments

placeholders

check

usage

standard

standard type

bounds

case selectors

declarations

overflow

pointers

subrange

uncertain

uninitialized

unused

none

regular

validation

ansi

iso

extended

object

debug

optimize

traceback

symbols

none

noinline

all

double format

D float

G float

old version

error limit

environment

never

absent

always

file name

DECwindows Compiler Interface for Pascal — VMS Pascal_4.0

Additional information available:

<label>commandsconfig list boxconfig namehelpmain push buttons
optionsopt push but

=title Compile a Pascal Program

commands

=title Commands
 Pull down the Commands menu to exit from the DWCI
 dialog box.

 Help information on the menu item in the Commands
 pull-down menu is available below in additional topics.

Additional information available:

quit

quit

=title Quit
 Choose the Quit menu item to cancel the compilation and
 return to the window from which you invoked the DWCI
 dialog box, for example, a FileView window.  (This menu
 item has the same effect as the Cancel button in the
 main dialog box.)

config list box

=title Configurations
 The Configurations list box allows you to establish and
 save named configurations of compilation option
 settings.

 The names of the configurations appear in the list box.
 The first time you access the DWCI dialog box, only the
 configuration name for the default option settings
 (Product_Default) appears in the Configurations list
 box.

 Take the following steps to establish other named sets
 of compilation options:

 1.  Pull down the Options menu, select a menu item, and
     click on the options that you want to establish for
     a particular configuration.  The name in the
     Applied Configuration dialog box changes to
     "**unnamed**" when you click on either the OK
     button or the Apply button associated with the
     option displays.

 2.  Completely erase the character string "**unnamed**"
     from the Applied Configuration dialog box, and type
     the name that you want to assign to that
     configuration.  If you type the original name (or
     any other name displayed in the Configurations list
     box), the new configuration of options replaces the
     old configuration of options associated with that
     name.

 3.  Click on the Add button to add the name to the list
     in the Configurations list box.

 The VAX Pascal compiler's default option settings are
 established as the default configuration whenever you
 invoke the DWCI dialog box.  To establish a new current
 configuration, select the desired name in the
 Configurations list box and click on the Apply button.

 To delete a named configuration from the Configurations
 list box, select the name that you want to delete and
 click on the Delete button.

 Help information on the buttons associated with the
 Configurations list box is available under additional
 topics.

Additional information available:

apply delete

apply delete

=title Delete and Apply Buttons
 Click on the Delete button to delete a configuration
 that you have selected in the Configurations list box.

 Click on the Apply button to establish a selected
 configuration in the Configurations list box as the
 current configuration.  This causes the selected name
 to appear in the Applied Configuration dialog box.  You
 can then perform the following operations:

  o  Initiate a compilation by clicking on the OK
     button.  (The compilation is governed by the option
     settings associated with the current
     configuration.)

  o  Modify the option settings for the current
     configuration using the Options pull-down menu.

     After modifying the option settings for the current
     configuration, you can then use the new, modified
     configuration in the following ways:

      -  You can establish the new set of options as a
         replacement for the old set.

         Type the old name in the Applied Configuration
         dialog box and click on the Add button.  Note
         that option settings for Product_Default cannot
         be modified.

      -  You can establish the new set of options as a
         new, permanent configuration.

         Type a new name in the Applied Configuration
         dialog box and click on the Add button.

      -  You can use the new set of options as a
         temporary configuration.

         Initiate a compilation by clicking on the OK
         button.  The new set of options govern that
         compilation but are not saved by DWCI.



config name

=title Applied Configuration
 The Applied Configuration dialog box contains the name
 of the configuration of compilation options that is
 currently in effect.  Clicking on the OK button in the
 main dialog box initiates a compilation governed by
 these options.

 The name of the product-supplied default configuration
 (Product_Default) appears in the Applied Configuration
 dialog box whenever DWCI is invoked (that is, a
 compilation request is issued from, for example, a
 FileView window).

 You can use the Applied Configuration dialog box in the
 following ways:

  o  To change to another established configuration,
     select its name from the Configurations list box
     and click on the Apply button.

  o  To establish a new configuration of compilation
     options, modify the options associated with the
     current configuration using the Options pull-down
     menu.

     When you change a compilation option setting, the
     name of the current configuration immediately
     changes to "**unnamed**".  At this point, you have
     several options:

      -  You can delete the character string
         "**unnamed**", type the name that you want to
         assign to the new configuration, and click on
         the Add button.

         The new configuration name then appears in the
         Configurations list box (and is available for
         future use).

      -  You can use the new configuration to control a
         single compilation.

         To use it in this way, click on the OK button
         -- without typing in a name and clicking on the
         Add button.  Under these circumstances, the
         configuration is only in effect for a single
         compilation.  It is not retained as a permanent
         configuration (that is, its name does not
         appear in the Configurations list box).


 If you type the name of an existing configuration, the
 new configuration assumes that name, replacing the
 existing configuration.  This allows you to modify
 option settings for an established configuration.

 The equivalent PASCAL command that you would issue at
 the DCL interface level to achieve the same effect as
 the current configuration's option settings is shown in
 the subwindow at the bottom of the main dialog box.

 Double click on the item below in additional topics to
 obtain more help information about adding
 configurations to the Configurations list box for
 future use.

Additional information available:

add

add

=title Add
 Click on the Add button to establish the configuration
 of option settings identified in the Applied
 Configuration dialog box as a permanent configuration
 for future use.

 The name of the configuration is added to the
 Configurations list box after you click on the Add
 button.  If the name in the Applied Configuration
 dialog box is the same as a name in the Configurations
 list box, the configuration of options associated with
 the name in the Configurations list box is replaced by
 the new configuration.

help

=title Help
 Pull down the Help menu to do the following:

  o  Find out information about the compiler:  its name,
     version number, release date, and copyright notice

  o  Get an overview of how to use the DECwindows
     Compiler Interface (DWCI)

 Help information on the menu items in the Help
 pull-down menu is available under additional topics.
 To view the help information on an additional topic,
 double click on the topic.

Additional information available:

aboutoverview

about

=title About
=include Help Overview
 VAX Pascal Version 4.0

 Copyright 1989 Digital Equipment Corporation
 All Rights Reserved

 Double click on Overview (in the Additional Topics
 section of the Help window) for a general description
 of the DECwindows Compiler Interface (DWCI).

overview

=title Overview
 The DECwindows Compiler Interface (DWCI) allows you to
 establish named sets of compilation options for use in
 compiling your programs.

 The Applied Configuration dialog box contains the name
 of the set of compilation options that go into effect
 when you click on the OK button to initiate a
 compilation.  The subwindow at the bottom of the main
 dialog box shows the PASCAL command line that is
 equivalent to the option configuration identified in
 the Applied Configuration dialog box.

 You can establish several named sets of compilation
 options.  The compilation options associated with a
 particular name are fixed until you change them.  This
 allows you to use a particular set of options
 repeatedly, without having to reestablish option
 settings using the Options pull-down menu.  The names
 in the following list are examples of names you might
 specify:

  o  Debug (for interactive debugging situations)

  o  Full Optimization (for debugged applications ready
     for running)

  o  Fast (for syntax checking; no object-code
     generation)

 The names appear in the Configurations list box.  To
 place one of these names in effect as the current
 configuration, you select a name and click on the Apply
 button.

 The product-specified default options are included in
 the Configurations list box under the name
 Product_Default.  This is the only name that is
 predefined; the names for the compilation
 configurations that you establish are defined by you.

 Help information on common user tasks, help, and
 unsupported compilation options is available under
 additional topics.  To view the help information on an
 additional topic, double click on the topic.

Additional information available:

common user tasksusing helpunsupported compilation options

common user tasks

=title Common User Tasks
=include options
=include config_list_box
=include config_name
 The following list describes common user tasks and the
 screen objects associated with them:

  o  To exit from the DWCI dialog box (that is, to
     return to the window from which you invoked the
     DWCI dialog box), click on the Cancel button or
     select the Quit menu item in the Commands pull-down
     menu.

  o  To select compilation options, pull down the
     Options menu and choose the desired option
     categories.

  o  To establish selected compilation options as a
     named configuration, type the name in the Applied
     Configuration dialog box and click on the Add
     button.

  o  To change the current configuration to another
     configuration, select the name of a configuration
     in the Configurations list box and click on the
     Apply button.

  o  To display the PASCAL command (DCL interface) that
     is equivalent to the option settings for a given
     configuration, select the configuration from the
     Configurations list box and click on the Apply
     button.  This causes the equivalent PASCAL command
     line to appear in the subwindow at the bottom of
     the main dialog box.  (The subwindow always
     displays the PASCAL command line for the
     configuration identified in the Applied
     Configuration dialog box.)

 Help information on the screen objects associated with
 these tasks is available under additional topics.

using help

=title Using Help
 Information on how to obtain help on any active screen
 object in the DWCI dialog box can be accessed as
 follows:

 1.  Select the Help menu item in the Help pull-down
     menu in this window, not the Help pull-down menu in
     the DWCI dialog box.

 2.  Double click on "What is Context-Sensitive Help?"
     under additional topics.

 For options (Option List...  items) that are
 inaccessible (dimmed image on screen), you cannot
 obtain help by using the method for active screen
 objects.  To view help for an option that is
 inaccessible, obtain the help frame for the menu item
 that produced the auxiliary dialog box.  Then, double
 click on the appropriate title in the Additional Topics
 section of the help window.

 The help frames for the inaccessible options explain
 which options affect their accessibility.

unsupported compilation options

=title Unsupported Compilation Options
 The following list contains command-line compilation
 options not supported by DWCI:

  o  "Plus" lists and nonalphabetical "comma" lists of
     file names are not supported by DWCI.  (When
     multiple file names are specified using a
     command-line interface and you separate them by
     plus signs (+), the files are concatenated and
     compiled as one program.  When you separate the
     file names by commas (,), the programs are compiled
     separately.)

     You must use the DCL interface if you want to
     compile multiple files as a single program or if
     you want to compile them separately in a sequence
     other than that shown in the FileView window.

     You can select more than one file from the FileView
     window (as with a "comma" list), but you cannot
     change the order in which they are compiled; they
     are compiled in the order shown.

  o  If you have a library of VAX Pascal source modules
     that you want to include in a compilation, you must
     use the DCL interface; the /LIBRARY qualifier has
     no equivalent in DWCI.


main push buttons

=title Cancel and OK Buttons
=include options options_list
 The Cancel and OK buttons have the following effects:

  o  Cancel Button -- Click on the Cancel button to
     cancel the compilation and return to the window
     from which you invoked the DWCI dialog box, for
     example, a FileView window.

  o  OK Button -- Click on the OK button to start the
     compilation process.  The compiler uses the current
     configuration of compilation options, which is
     identified in the Applied Configuration dialog box.

     You can view the compilation options associated
     with the current configuration in either of the
     following ways:

      -  Examine the PASCAL command line (DCL level)
         that appears in the subwindow at the bottom of
         the main dialog box.  The qualifiers shown on
         the command line are equivalent to the options
         established for the current configuration.

      -  Pull down the Options menu, select pertinent
         menu items, and examine the option settings
         established for them.

     A table that maps DCL-level qualifiers to option
     categories in the Options pull-down menu is
     available under additional topics.


options

=title Options
 Pull down the Options menu to review or change
 compilation options.

 To modify any of the options associated with the
 current configuration, choose the appropriate category
 of options from the Options pull-down menu.  When you
 choose an options category, an auxiliary dialog box
 appears.  You use that auxiliary dialog box to
 establish settings for individual compilation options.

 Option categories are listed below in additional
 topics.  To view help information on an option
 category, double click on it.

Additional information available:

options listlistingtoolscheckinggenerationdatasource
environment generation

options list

=title List of Options (by option category)
 --------------------------------------------------------
 Options Category                  Options (Equivalent
 (Options Menu)                    DCL Qualifiers)
 --------------------------------------------------------
 Listing Options                   /CROSS_REFERENCE
                                   /LIST
                                   /MACHINE_CODE
                                   /SHOW
                                   /TERMINAL
                                   /WARNINGS


 Tool Options                      /ANALYSIS_DATA
                                   /DESIGN
                                   /DIAGNOSTICS


 Checking Options                  /CHECK
                                   /STANDARD
                                   /USAGE


 Object Code Options               /DEBUG
                                   /OBJECT
                                   /OPTIMIZE


 Data Interpretation Options       /G_FLOATING


 Source Interpretation Options     /ERROR_LIMIT
                                   /OLD_VERSION


 Environment Generation Options    /ENVIRONMENT

listing

=title Listing Options...
 Choose the Listing Options...  menu to review or change
 any of the compilation options that affect the contents
 of output listings or of terminal display.

 The listing options are shown under additional topics.
 To view help information on a particular topic, double
 click on it.

Additional information available:

listshowmessagesterminal

list

=title Produce a listing file
 Click on the Produce a listing file button to direct
 the compiler to produce an output listing.  By default,
 the listing file is given the name of the source file
 plus the .LIS extension.  You can optionally change the
 file name to any valid name of your choice.

 If you are compiling multiple files and you type in an
 output file name, each listing file is given that name
 (with an incremental version number).

 Equivalent qualifier (DCL interface):

    /[NO]LIST=file-spec]

show

=title Show in listing
 Click on buttons in the Show in listing options list to
 set or cancel specific options that determine the
 contents of the listing file produced by the compiler.

 The Show in listing option is inaccessible when the
 Produce a listing file button is off.  (The Produce a
 listing file button is in the options list associated
 with the Listing Options...  menu item.)

 Help information on the individual options for Show in
 listing is available under additional topics.  To view
 help information on a particular topic, double click on
 it.

Additional information available:

dictionarycross referenceheaderincludeinlinemachine code
sourcestatisticstable of contents

dictionary

=title CDD definitions
 Click on the CDD definitions button to include, in the
 listing file, source code from Common Data Dictionary
 records specified in %DICTIONARY directives.

 Equivalent qualifier (DCL interface):

    /SHOW=[NO]DICTIONARY

cross reference

=title Cross reference
 Click on the Cross reference button to include, in the
 listing file, a cross reference of all identifiers and
 labels used within the source code.

 Equivalent qualifier (DCL interface):

    /[NO]CROSS_REFERENCE

header

=title Page heading
 Click on the Page heading button to request headings at
 the top of each listing page.

 Equivalent qualifier (DCL interface):

    /SHOW=[NO]HEADER

include

=title Contents of %INCLUDE files
 Click on the Contents of %INCLUDE files button to
 include, in the listing file, source code from files
 specified in %INCLUDE directives.

 Equivalent qualifier (DCL interface):

    /SHOW=[NO]INCLUDE

inline

=title Inline summary

 Click on the Inline summary button to include, in the
 listing file, the names of user-defined routines and
 whether these routines were expanded inline.

 The inline summary enabled by the Inline summary button
 shows only the names of routines that were expanded
 inline in the compilation.  If you want to know why
 routines were not expanded inline, you must select an
 additional compilation option with the Optimize code,
 allow inline expansion button.  (The Optimize code,
 allow inline expansion button is in an options list
 associated with the Object Code Options...  menu item.)

 Equivalent qualifier (DCL interface):

    /SHOW=[NO]INLINE

machine code

=title Machine code

 Click on the Machine code button to include, in the
 listing file, a symbolic representation of the object
 code generated by the compiler.

 Equivalent qualifier (DCL interface):

    /[NO]MACHINE_CODE

source

=title Source code
 Click on the Source code button to include, in the
 listing file, a listing of VAX Pascal source code.

 Equivalent qualifier (DCL interface):

    /SHOW=[NO]SOURCE

statistics

=title Compilation statistics
 Click on the Compilation statistics button to include,
 in the listing file, a summary of compiler performance
 statistics.

 Equivalent qualifier (DCL interface):

    /SHOW=[NO]STATISTICS

table of contents

=title Table of contents
 Click on the Table of contents button to include, in
 the listing file, a table of contents.  This option is
 enabled only if a %TITLE or %SUBTITLE directive is
 specified in the source code.

 Equivalent qualifier (DCL interface):

    /SHOW=[NO]TABLE_OF_CONTENTS

messages

=title Compiler Messages
 Click on the button in the Compiler Messages options
 list to set or cancel the option that controls whether
 the compiler issues diagnostic messages in reponse to
 warning-level or informational-level errors.

 Help information on the option for Compiler Messages is
 available under an additional topic.  To view help
 information on this topic, double click on it.

Additional information available:

warnings

warnings

=title Warnings
 Click on the Warnings button to generate diagnostic
 messages in response to warning-level or
 informational-level errors.  A warning or informational
 diagnostic message indicates that the compiler has
 detected acceptable but unorthodox syntax or has
 performed some corrective action; in either case,
 unexpected results may occur.

 Equivalent qualifier (DCL interface):

    /[NO]WARNINGS

terminal

=title Display On terminal
 Click on buttons in the Display On terminal options
 list to set or cancel a list of specific options to be
 displayed on the terminal.

 Help information on the individual options for Display
 On terminal is available under additional topics.  To
 view help information on a particular topic, double
 click on it.

Additional information available:

file namesroutine namesstatistics

file names

=title File names
 Click on the File names button to display all file
 names on the PASCAL command line as they are being
 processed.

 Equivalent qualifier (DCL interface):

    /TERMINAL=[NO]FILE_NAME

routine names

=title Routine names
 Click on the Routine names button to display all
 routine names as code is generated.

 Equivalent qualifier (DCL interface):

    /TERMINAL=[NO]ROUTINE_NAME

statistics

=title Compilation statistics
 Click on the Compilation statistics button to display
 compiler performance statistics.

 Equivalent qualifier (DCL interface):

    /TERMINAL=[NO]STATISTICS

tools

=title Tool Options...
 Choose the Tool Options...  menu item to review or
 change the option settings that determine whether the
 compiler does the following:

  o  Generates an output file containing cross-reference
     and static-analysis information (.ANA files)

  o  Processes program design elements

  o  Generates an output file containing compiler
     messages and diagnostics information (.DIA files)

 The .ANA and .DIA files are reserved for use by Digital
 layered products.  Program design processing is
 associated with the use of Digital layered products.

 The tool options are listed under additional topics.
 To view help information on a particular topic, double
 click on it.

Additional information available:

analysis datadesigndiagnostics

analysis data

=title Produce an SCA analysis data file
 Click on the Produce an SCA analysis data file button
 to generate a file containing cross-reference and
 static-analysis information about the source code.
 Analysis data files are reserved for use by Digital
 layered products (for example, the VAX Source Code
 Analyzer).

 By default, the SCA analysis data file is given the
 name of the source file plus the .ANA extension.
 Optionally, you can change the file name to any valid
 name of your choice.

 The compiler produces one analysis file for each source
 file that it compiles.  If you are compiling multiple
 files and you type in a file name, each analysis file
 is given that name (with an incremental version
 number).

 Equivalent qualifier (DCL interface):

    /[NO]ANALYSIS_DATA[=filespec]

design

=title Program design processing
 Click on buttons in the Program design processing
 options list to set or cancel specific options that
 determine the design elements that the compiler
 recognizes and processes.

 Help information on the individual options for Program
 design processing is available under additional topics.
 To view help information on a particular topic, double
 click on it.

Additional information available:

commentsplaceholders

comments

=title Enable comment analysis
 Click on the Enable comment analysis button to direct
 the compiler to recognize design comments.  Design
 comments are made available to Digital layered products
 (for example, the VAX Source Code Analyzer).

 Equivalent qualifier (DCL interface):

    /DESIGN=[NO]COMMENTS

placeholders

=title Enable placeholder analysis
 Click on the Enable placeholder analysis button to
 direct the compiler to accept placeholders as valid
 program elements.  Placeholders are produced by Digital
 layered products (for example, the VAX
 Language-Sensitive Editor).

 Equivalent qualifier (DCL interface):

    /DESIGN=[NO]PLACEHOLDERS

diagnostics

=title Produce an LSE diagnostics file
 Click on the Produce an LSE diagnostics file button to
 generate a file containing compiler messages and
 diagnostic information about the source code.
 Diagnostics files are reserved for use by Digital
 layered products (for example, the VAX
 Language-Sensitive Editor).

 By default, the LSE diagnostics file is given the name
 of the source file plus the .DIA extension.
 Optionally, you can change the file name to any valid
 name of your choice.

 The compiler produces one diagnostics file for each
 source file it compiles.  If you are compiling multiple
 files and you type in a file name, each diagnostics
 file is given that name (with an incremental version
 number).

 Equivalent qualifier (DCL interface):

    /[NO]DIAGNOSTICS[=filespec]

checking

=title Compile-Time and Run-Time Checking Options...
 Choose the Compile-Time and Run-Time Checking
 Options...  menu to review or change any of the
 compilation options that affect checking.

 The checking options are listed under additional
 topics.  To view help information on a particular
 topic, double click on it.

Additional information available:

checkusagestandardstandard type

check

=title Run-time condition checks
 Click on buttons in the Run-time condition checks
 options list to set or cancel specific options that
 generate code to perform run-time checks.

 Help information on the individual options for Run-time
 condition checks is available under additional topics.
 To view help information on a particular topic, double
 click on it.

Additional information available:

boundscase selectorsdeclarationsoverflowpointerssubrange

bounds

=title Out of bounds references to arrays and strings
 Click on the Out of bounds references to arrays and
 strings button to verify that an index expression is
 within the bounds of an array's index type, that
 character-string sizes are compatible, and that schema
 types are compatible.

 A CHECK attribute within the source code overrides the
 Out of bounds references to arrays and strings option
 setting.

 Equivalent qualifier (DCL interface):

    /CHECK=[NO]BOUNDS

case selectors

=title Case selector value within range
 Click on the Case selector value within range button to
 check that the value of a case selector is contained in
 the corresponding case-label list.

 A CHECK attribute within the source code overrides the
 Case selector value within range option setting.

 Equivalent qualifier (DCL interface):

    /CHECK=[NO]CASE_SELECTORS

declarations

=title Invalid non-static type declarations
 Click on the Invalid non-static type declarations
 button to verify that schemata discriminations produce
 legal types and that non-local GOTOs are properly used.

 A CHECK attribute within the source code overrides the
 Invalid non-static type declarations option setting.

 Equivalent qualifier (DCL interface):

    /CHECK=[NO]DECLARATIONS

overflow

=title Integer overflow
 Click on the Integer overflow button to verify that the
 result of integer compuation does not exceed the
 machine representation.

 A CHECK attribute within the source code overrides the
 Integer overflow option setting.

 Equivalent qualifier (DCL interface):

    /CHECK=[NO]OVERFLOW

pointers

=title Pointer equal to NIL
 Click on the Pointer equal to NIL button to verify that
 the value of a pointer variable is not NIL.

 A CHECK attribute within the source code overrides the
 Pointer equal to NIL option setting.

 Equivalent qualifier (DCL interface):

    /CHECK=[NO]POINTERS

subrange

=title Subrange and SET bounds
 Click on the Subrange and SET bounds button to verify
 that values assigned to variables of subrange types are
 within the subrange, that a set expression is
 assignment compatible with a set variable, and that MOD
 operates on positive numbers.

 A CHECK attribute within the source code overrides the
 Subrange and SET bounds option setting.

 Equivalent qualifier (DCL interface):

    /CHECK=[NO]SUBRANGE

usage

=title Variable usage analysis
 Click on buttons in the Variable usage analysis options
 list to set or cancel specific options that direct the
 compiler to perform compile-time checks indicated by
 the chosen options.

 Help information on the individual options for Variable
 usage analysis is available under additional topics.
 To view help information on a particular topic, double
 click on it.

Additional information available:

uncertainuninitializedunused

uncertain

=title Uncertain depending on program flow
 Click on the Uncertain depending on program flow button
 to check for variables that may be uninitialized
 depending on program flow.

 Equivalent qualifier (DCL interface):

    /USAGE=[NO]UNCERTAIN

uninitialized

=title Known to be uninitialized
 Click on the Known to be uninitialized button to check
 for variables known to be unitialized.

 Equivalent qualifier (DCL interface):

    /USAGE=[NO]UNINITIALIZED

unused

=title Declared but never referenced
 Click on the Declared but never referenced button to
 check for variables that were declared but never
 referenced.

 Equivalent qualifier (DCL interface):

    /USAGE=[NO]UNUSED

standard

=title Pascal standard conformance checking
 Click on buttons in the Pascal standard conformance
 checking options list to control whether the compiler
 issues informational diagnostic messages when it
 detects coding in source files that does not conform to
 a specified Pascal standard.

 Help information on the individual options for Pascal
 standard conformance checking is available under
 additional topics.  To view help information on a
 particular topic, double click on it.

Additional information available:

noneregularvalidation

none

=title None
 Click on the None button to disable standards checking.

 Equivalent qualifier (DCL interface):

    /NOSTANDARD

regular

=title Perform checks, signal as informationals
 Click on the Perform checks, signal as informationals
 button to enable standards checking; the compiler
 generates informational diagnostic messages when it
 detects noncompliant features and constructs.

 The Perform checks, signal as informationals option is
 disabled if the Warnings button is off.  (The Warnings
 button is in an options list associated with the
 Listing Options...  menu item.)

 Equivalent qualifier (DCL interface):

    /STANDARD

validation

=title Performs checks, signal as errors
 Click on the Performs checks, signal as errors button
 to enable standards checking; the compiler generates
 error messages when it detects noncompliant features
 and constructs.

 Equivalent qualifier (DCL interface):

    /STANDARD=[NO]VALIDATION

standard type

=title Standard to check against
 Click on buttons in the Standard to check against
 options list to set or cancel specific Pascal
 standards.

 The Standard to check against option is inaccessible
 unless either the Perform Checks, signal as
 informational button or the Performs Checks, signal as
 errors button is on.

 Help information on the individual options for standard
 to check against is available under additional topics.
 To view help information on a particular topic, double
 click on it.

Additional information available:

ansiisoextended

ansi

=title ANSI/IEEE770X3.97-1983
 Click on the ANSI/IEEE770X3.97-1983 button to check
 against the rules of this ANSI standard.

 Equivalent qualifier (DCL interface):

    /STANDARD=ANSI

iso

=title ISO 7-185-1983(E)
 Click on the ISO 7-185-1983(E) button to check against
 the rules of this ISO standard.

 Equivalent qualifier (DCL interface):

    /STANDARD=ISO

extended

=title (Proposed) Extended Pascal
 Click on the (Proposed) Extended Pascal button to check
 against the rules of this proposed standard.

 Equivalent qualifier (DCL interface):

    /STANDARD=[NO]EXTENDED

generation

=title Object Code Options...
 Choose the Object Code Options...  menu item to review
 or adjust the settings of compilation options that
 control the following:

  o  Whether to produce an output object file

  o  Whether to include information in the object file
     for use by the VMS Debugger

  o  Whether to optimize the machine code that is
     generated

 The object code options are listed under additional
 topics.  To view help information on a particular
 topic, double click on it.

Additional information available:

objectdebugoptimize

object

=title Produce an object file
 Click on the Produce an object file button to produce
 an object file.

 By default, the object file is given the name of the
 source file plus the .OBJ extension.  Optionally, you
 can change the file name to any valid name of your
 choice.

 If you are compiling multiple files and you type in a
 file name, each object file is given that name (with an
 incremental version number).

 Equivalent qualifier (DCL interface):

    /[NO]OBJECT[=file-spec]

debug

=title Debugger information generation
 Click on buttons in the Debugger information generation
 options list to set or cancel options that control the
 inclusion of information in the object file for use by
 the VMS Debugger.

 The Debugger information generation option is
 inaccessible unless the Produce an object file button
 is on.

 Help information on the individual options for Debugger
 information generation is available under additional
 topics.  To view help information on a particular
 topic, double click on it.

Additional information available:

tracebacksymbols

traceback

=title Traceback records

 Click on the Traceback records button to include
 traceback information in the object file.

 The traceback information consists of an address
 correlation table.  This information allows the VMS
 Debugger and the run-time error traceback routine to
 translate absolute virtual addresses into
 source-program subroutine names and compiler-generated
 line numbers.

 Equivalent qualifier (DCL interface):

    /DEBUG=[NO]TRACEBACK

symbols

=title Symbol table records

 Click on the Symbol table records button to include, in
 the object file, local symbol table information for use
 by the VMS Debugger.

 The symbol table information consists of symbol
 definitions for all identifiers in the compilation.

 Equivalent qualifier (DCL interface):

    /DEBUG=[NO]SYMBOLS

optimize

=title Optimization Level
 Click on buttons in the Optimization Level options list
 to set or cancel options that control the level of
 optimization performed on machine-code language.

 Do not turn on these buttons for compilations that will
 require debugging.  Optimization may make debugging
 difficult and may obscure some sections of the
 compilation unit that you would like to debug.

 Help information on the individual options for
 Optimization Level is available under additional
 topics.  To view help information on a particular
 topic, double click on it.

Additional information available:

nonenoinlineall

none

=title No optimization
 Click on the No optimization button to disable
 optimization.

 An OPTIMIZE or NOOPTIMIZE attribute within the source
 code overrides the No optimization option setting.

 Equivalent qualifier (DCL interface):

    /NOOPTIMIZE

noinline

=title Optimize code, no inline expansion
 Click on the Optimize code, no inline expansion to
 enable all optimization components, except inline
 expansion of routines.

 An OPTIMIZE or NOOPTIMIZE attribute within the source
 code overrides the Optimize code, no inline expansion
 option setting.

 Equivalent qualifier (DCL interface):

    /OPTIMIZE=NOINLINE

all

=title Optimize code, allow inline expansion
 Click on the Optimize code, allow inline expansion to
 enable all optimization components, including inline
 expansion of routines.

 An OPTIMIZE or NOOPTIMIZE attribute within the source
 code overrides the Optimize code, allow inline
 expansion option setting.

 Equivalent qualifier (DCL interface):

    /OPTIMIZE=ALL

data

=title Data Interpretation Options...
 Choose the Data Interpretation Options...  menu item to
 review or adjust the settings of compilation options
 that determine the machine representation of
 floating-point double-precision values.

 The data interpretation options are listed under
 additional topics.  To view help information on a
 particular topic, double click on it.

Additional information available:

double format

double format

=title Floating-point double precision format
 Click on buttons in the Floating-point double-precision
 format options list to choose the format, D_floating or
 G_floating, that you want the compiler to use for
 floating-point double-precision variables.

 Help information on the individual options for
 Floating-point double-precision format is available
 under additional topics.  To view help information on a
 particular topic, double click on it.

Additional information available:

D floatG float

D float

=title D_floating

 Click on the D_floating button to direct the compiler
 to format declarations and constants of type DOUBLE in
 VAX D_floating format.

 A G_FLOATING attribute within the source code causes a
 warning diagnostic message if the D_floating option
 setting is enabled.

 Equivalent qualifier (DCL interface):

    /NOG_FLOATING

G float

=title G_floating

 Click on the G_floating button to direct the compiler
 to format declarations and constants of type DOUBLE in
 VAX G_floating format.

 A NOG_FLOATING attribute within the source code causes
 a warning diagnostic message if the G_floating option
 setting is enabled.

 Equivalent qualifier (DCL interface):

    /G_FLOATING

source

=title Source Interpretation Options...

 Choose the Source Interpretation Options...  menu item
 to review or change the settings of compilation options
 that determine the rules the compiler will use to
 interpret the source code.

 The source interpretation options are listed under
 additional topics.  To view help information on a
 particular topic, double click on it.

Additional information available:

old versionerror limit

old version

=title Conform to Pascal V1 rules
 Click on the Conform to Pascal V1 rules button to
 resolve differences betweeen VAX Pascal Version 1.0 and
 subsequent version by using the Version 1.0 definition
 of the language.

 Equivalent qualifier (DCL interface):

    /[NO]OLD_VERSION

error limit

=title Maximum number of errors
 Click on the Maximum number of errors button to
 terminate compilation after the occurrence of a
 specified number of error-level messages.

 Equivalent qualifier (DCL interface):

    /[NO]ERROR_LIMIT[= n]

environment generation

=title Environment Generation Options...
 Choose the Environment Generation Options...  menu to
 review or change any of the compilation options that
 affect environment file generation.

 The environment generation options are shown under
 additional topics.  To view help information on a
 particular topic, double click on it.

Additional information available:

environment

environment

=title Produce Pascal environment file
 Click on buttons in the Produce Pascal environment file
 options list to set or cancel specific options that
 determine whether an environment file is produced.

 Help information on the individual options for Produce
 Pascal environment file is available under additional
 topics.  To view help information on a particular
 topic, double click on it.

Additional information available:

neverabsentalwaysfile name

never

=title Never
 Click on the Never button to prevent an environment
 file from being produced.  This option overrides any
 ENVIRONMENT attributes specified in the source file.

 Equivalent qualifier (DCL interface):

    /NOENVIRONMENT

absent

=title Based on ENVIRONMENT attribute in source
 Click on the Based on ENVIRONMENT attribute in source
 button to produce an environment file according to the
 ENVIRONMENT attribute specifications in the source
 file.

 Equivalent qualifier (DCL interface):

    none

always

=title Always
 Click on the Always button to produce an environment
 file whether there is an ENVIRONMENT attribute in the
 source file or not.

 Equivalent qualifier (DCL interface):

    /ENVIRONMENT

file name

=title Environment file name
 Click on the Environment file name button to change the
 name of the environment file from the default name to
 any valid name of your choice.  By default, the
 environment file is given the name of the source file
 plus the .PEN extension.

 The Environment file name option is inaccessible unless
 the Always button is on.

 Equivalent qualifier (DCL interface):

    /ENVIRONMENT[=file-spec]

opt push but

=title Option Buttons -- OK, Apply, Reset, and Cancel
 The effects of the OK, Apply, Reset, and Cancel buttons
 are as follows:

  o  OK Button -- Click on the OK button to update the
     current configuration to reflect the compilation
     options you have chosen.  This action also removes
     the auxiliary dialog box in which the OK button
     resides.

  o  Apply Button -- Click on the Apply button to update
     the current configuration with any changes you have
     made to the compilation options.

     The auxiliary dialog box remains in effect when you
     click on the Apply button.  This allows you to
     establish or change several options during a single
     invocation of the auxiliary dialog box in which the
     Apply button resides.  Thus, you can set the
     options with the Apply button either one at a time
     or as a group.

  o  Reset Button -- Click on the Reset button to purge
     any options that you have chosen but not applied
     (Apply button) to a configuration.

     The auxiliary dialog box containing the Reset
     button remains in effect when you click on the
     Reset button.

  o  Cancel Button -- Click on the Cancel button to
     purge all options that have been chosen but not
     applied (Apply button) to a configuration.  This
     action also removes the auxiliary dialog box in
     which the Cancel button resides.

     The main dialog box remains in effect when you
     click on the Cancel button.  This allows you to
     establish or change more than one configuration of
     compilation options without having to exit and
     reenter the main dialog box.


Typewritten Software • bear@typewritten.org • Edmonds, WA 98026