Additional information available:

<label>commandsconfig list boxconfig namehelphide
main push buttonsoptionsopt push but

=title Compile a <*LANGUAGE*> Program

=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 under additional
 topics.

Additional information available:

quit

=title Quit
 Choose the Quit menu item to cancel the compilation and
 return to the window from which you invoked the dialog
 box, for example, a FileView or LSE window.  (Choosing
 this menu item has the same effect as choosing the
 Cancel button in the main dialog 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 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 <*COMPILER*> compiler's default option settings are
 established as the default configuration the first time
 you invoke the DWCI dialog box.  For subsequent
 invocations, the last previously applied configuration
 will be used as the default.

 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 below under
 additional topics.

=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 the first time DWCI is invoked (that is, a
 compilation request is issued from, for example, a
 FileView window).  For subsequent invocations, the
 established configuration that was current at the time
 of the previous compilation is used.

 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 a new configuration 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 <*DCL_COMMAND*> 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 under additional topics to
 obtain more help information about adding
 configurations to the Configurations list box for
 future use.

Additional information available:

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.

=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 below under additional
 topics.  To view the help information on an additional
 topic, double click on the topic.

Additional information available:

aboutoverview

=title About
=include Help Overview
=include Help About More_About
 <*COMPILER*> Version n.n

 Copyright 1989 by 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).

Additional information available:

more about

=title Additional Trademark and Product Information
 The help information provided with this product is
 subject to change without notice and should not be
 construed as a commitment by Digital Equipment
 Corporation.  Digital Equipment Corporation assumes no
 responsibility for any errors that may appear in the
 help text.

 The software product associated with the help text is
 furnished under a license and may be used or copied
 only in accordance with the terms of such license.

 No responsibility is assumed for the use or reliability
 of software on equipment that is not supplied by
 Digital Equipment Corporation or its affiliated
 companies.

 The following are trademarks of Digital Equipment
 Corporation:

 DEC
 VAX
 VMS

=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 <*DCL_COMMAND*> 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 remain in effect 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, 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.  For information on how to establish
 and use a configuration of compilation options, double
 click on the topic Common User Tasks and then double
 click on the topic Applied Configuration.

Additional information available:

common user tasksusing helpunsupported compilation options

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

  o  To exit from the DWCI dialog box and begin
     compilation of the selected files, using the
     compilation options as displayed, click on the OK
     button or press the Return key.

  o  To cancel the compile operation and return to
     FileView, 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 <*DCL_COMMAND*> 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 <*DCL_COMMAND*> command line to appear
     in the Command subwindow at the bottom of the main
     dialog box.  (The subwindow always displays the
     <*DCL_COMMAND*> command line for the configuration
     identified in the Applied Configuration dialog
     box.)

  o  To have the current configuration used
     automatically for future compilations using this
     language, click on the Hide This Dialog button.
     Later, when you wish to bring up the DWCI dialog
     box to change the configuration, hold down the
     Shift key while clicking on the FileView Compile
     button.

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

=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 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.

=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 you
     specify multiple file names 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
     either compile multiple files as a single program
     or 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 <*LANGUAGE*> source
     modules that you want to include in a compilation,
     you must use the DCL interface; the /LIBRARY
     qualifier has no equivalent in DWCI.

=title Hide This Dialog
 Click on the Hide This Dialog button to indicate that
 you do not wish to see the DWCI dialog box on
 subsequent requests from FileView Compile.  In this
 mode, all subsequent Compile requests will use the
 Configuration in effect when you click the OK button in
 the DWCI dialog box.  To cancel the Hide function from
 FileView, simply hold down the Shift key while clicking
 on the Compile button.

Additional information available:

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 Configuration list box as the
 current configuration.  This causes the selected name
 to appear in the Current 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.

=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 by the Applied Configuration dialog box.

     To review the options associated with the current
     configuration, you have two choices:

      -  You can examine the <*DCL_COMMAND*> 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.

      -  You can 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 below under additional topics.

=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 under additional
 topics.

Additional information available:

options listlistingtoolsgeneration

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


 Tool Options...                   /ANALYSIS_DATA
                                   /DIAGNOSTICS


 Object Code Options...            /DEBUG
                                   /ENABLE or /DISABLE
                                   /OBJECT

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

 All of the categories of listing options are shown
 below in additional topics.  To view help information
 on a particular category, double click on it.

Additional information available:

listshowcref

=title Produce a Listing File

 Click on the Produce a Listing File button to direct
 the assembler to produce a listing of the source file.
 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 assembling multiple files and you type in a
 file name, each listing file is given that name (with
 an incremental version number).

 Equivalent qualifier (DCL interface):

    /[NO]LIST[=file-spec]

=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 assembler.

 The Show in Listing option is inaccessible unless the
 Produce a Listing File button is on.  (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 below in additional topics.

 Equivalent qualifier (DCL interface):

    /[NO]SHOW[=(function[,...])

Additional information available:

conditionalscallsdefinitionsexpansionsbinary

=title Unsatisfied conditionals

 Click on the Unsatisfied Conditionals button to
 include, in the listing file, unsatisfied conditional
 code associated with .IF and .ENDC directives.

 Equivalent qualifier (DCL interface):

    /SHOW=CONDITIONALS

=title Macro calls, repeat range expansions

 Click on the Macro Calls, Repeat Range Expansions
 button to include, in the listing file, macro calls and
 repeat range expansions.

 Equivalent qualifier (DCL interface):

    /SHOW=CALLS

=title Macro definitions

 Click on the Definitions button to include macro
 definitions in the listing file.

 Equivalent qualifier (DCL interface):

    /SHOW=DEFINITIONS

=title Macro expansions

 Click on the Macro Expansions button to include macro
 expansions in the listing file.

 Equivalent qualifier (DCL interface):

    /SHOW=EXPANSIONS

=title Macro code binary expansions

 Click on the Macro Code Binary Expansions button to
 include, in the listing file, binary code generated by
 the expansion of macro calls.

 Equivalent qualifier (DCL interface):

    /SHOW=BINARY

=title Cross Reference in Listing

 Click on buttons in the Cross Reference in Listing
 options list to set or cancel options that determine
 whether a cross-reference list is included in the
 listing file.  A cross-reference list identifies the
 places in the source file where the following items are
 defined or referred to:  directives, macros, operation
 codes, registers, and symbols.

 Help information on the individual options for Cross
 Reference in Listing is available below in additional
 topics.

 Equivalent qualifier (DCL interface):

    /[NO]CROSS_REFERENCE[=(function[,...])]

Additional information available:

alldirectivesmacrosopcodesregisterssymbols

=title Cross reference directives, macros, opcodes,
 regs, syms

 Click on the Cross Reference Directives, Macros,
 Opcodes, Regs, Syms button to include, the listing
 file, cross-references for the items identified by the
 name of this button.

 Equivalent qualifier (DCL interface):

    /CROSS_REFERENCE=ALL

=title Cross reference directives

 Click on the Cross Reference Directives button to
 include cross-references for directives in the listing
 file.

 Equivalent qualifier (DCL interface):

    /CROSS_REFERENCE=DIRECTIVES

=title Cross reference macros

 Click on the Cross Reference Macros button to include
 macro cross-references in the listing file.

 Equivalent qualifier (DCL interface):

    /CROSS_REFERENCE=MACROS

=title Cross reference opcodes

 CLick on the Cross Reference Opcodes button to include
 operation code cross-references in the listing file.

 Equivalent qualifier (DCL interface):

    /CROSS_REFERENCE=OPCODES

=title Cross reference registers

 Click on the Cross Reference Registers button to
 include cross-references for registers in the listing
 file.

 Equivalent qualifier (DCL interface):

    /CROSS_REFERENCE=REGISTERS

=title Cross reference symbols

 Click on the Cross Reference Symbols button to include
 symbol cross-references in the listing file.

 Equivalent qualifier (DCL interface):

    /CROSS_REFERENCE=SYMBOLS

=title Tool Options...
 Choose the Tool Options...  menu item to review or
 change the option settings that determine whether
 output files containing the following types of
 information are created:

  o  Cross-reference and static-analysis information
     (.ANA files)

  o  Assembler messages and diagnostics information
     (.DIA files)

 These files are reserved for use by DIGITAL layered
 products.

 Tool options are listed below in additional topics.  To
 view help information on a particular tool option,
 double click on it.

Additional information available:

analysis datadiagnostics

=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.  You
 can optionally 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 a different version number).

 Equivalent qualifier (DCL interface):

    /[NO]ANALYSIS_DATA[=file-spec]

=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.  You can
 optionally 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 a different version
 number).

 Equivalent qualifier (DCL interface):

    /[NO]DIAGNOSTICS[=file-spec]

=title Object Code Options...
 Choose the Object Code Options...  menu item to review
 or adjust the settings of assembly 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

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

Additional information available:

objectdebugenable

=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.  You can
 optionally 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 a
 different version number).

 Equivalent qualifier (DCL interface):

    /[NO]OBJECT[=file-spec]

=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 below in additional
 topics.

 Equivalent qualifier (DCL interface):

    /[NO]DEBUG[=option]

Additional information available:

symbolstraceback

=title Local symbols

 Click on the Local Symbols button to include all local
 symbols in the object module (for use by the debugger).

 Equivalent qualifier (DCL interface):

    /DEBUG=SYMBOLS
    /ENABLE=DEBUG

=title Traceback records

 Click on the Traceback Records button to include
 traceback information in the object module (for use by
 the debugger.)

 Equivalent qualifier (DCL interface):

    /DEBUG=TRACEBACK
    /ENABLE=TRACEBACK

=title Enable Information Generation

 Click on button in the options list for the Enable
 Information Generation menu item to provide initial
 settings for the functions controlled by the assembler
 directives .ENABLE and .DISABLE.

 Equivalent qualifier (DCL interface):

    /[NO]ENABLE=(function[,...])
    /[NO]DISABLE=(function[,...])

 Note that TRACEBACK and DEBUG functions, which can be
 specified in the preceding DCL qualifiers, are handled
 by the options list for the Debugger Information
 Generation menu item.

 Help information on the individual options for Enable
 Information Generation is available below in additional
 topics.

Additional information available:

absolutegloballocalsuppressiontruncationvector

=title Relative addr modes treated as absolute

 Click on the Relative Addr Modes Treated as Absolute
 button to direct the assembler to assemble all relative
 addresses as absolute addresses.

 Equivalent qualifier (DCL interface):

    /[NO]ENABLE=ABSOLUTE
    /[NO]DISABLE=ABSOLUTE

=title Undefined assumed external

 Click on the Undefined Assumed External button to
 direct the assembler to treat all undefined symbols in
 the assembly as external symbols.  When the button is
 off, any undefined symbol that is not listed in an
 .EXTERNAL directive causes an assembly error.

 Equivalent qualifier (DCL interface):

    /[NO]ENABLE=GLOBAL
    /[NO]DISABLE=GLOBAL

=title Start new local label block

 Click on the Start New Local Label Block button to end
 the currrent local label block and start a new one.  If
 this button is off, the current local label block is
 ended, but a new one is not started.  d.b1 Equivalent
 qualifier (DCL interface):

    /[NO]ENABLE=LOCAL_BLOCK
    /[NO]DISABLE=LOCAL_BLOCK

=title List only referenced symbols in symbol table

 Click on the List Only Referenced Symbols in Symbol
 Table button to suppress the listing of unreferenced
 symbols in the symbol table.

 Equivalent qualifier (DCL interface):

    /[NO]ENABLE=SUPPRESSION
    /[NO]DISABLE=SUPPRESSION

=title Truncate FP numbers

 Click on the Truncate FP Numbers button to direct the
 assembler to truncate floating-point numbers (if
 truncation is disabled, such numbers are rounded).
 G_floating, D_floating, and H_floating numbers are not
 affected.

 Equivalent qualifier (DCL interface):

    /[NO]ENABLE=TRUNCATION
    /[NO]DISABLE=TRUNCATION

=title Assemble vector instructions

 Click on the Assemble Vector Instructions button to
 direct the assembler to allow and assemble vector
 instructions in the source code.  This implies that the
 symbols V0-V15 will be treated as reserved vector
 register symbols and cannot be user-defined symbols.

 Equivalent qualifier (DCL interface):

    /[NO]ENABLE=VECTOR
    /[NO]DISABLE=VECTOR

=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 to
     a configuration (with the Apply button).

     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 to a configuration (with the Apply button).

     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.