

<<Welcome to Clarion for DOS>>

Welcome to Clarion for DOS!!

Clarion for DOS is a database-independent Integrated
Development Environment (IDE) for creating complex high-
performance commercial-quality database applications for PCs.
This product is designed for both casual and professional
software developers who create database applications -- for end-
users or their own personal use.  While it is possible to create
complete applications without writing any code, this product has
been designed for users who have some experience with
programming languages.

The principal features of Clarion for DOS are:

    An Application Generator which produces the source code for
     complex applications interactively and incrementally.

    A database-independent Database Dictionary.  With a
     comprehensive set of replaceable database drivers, this
     produces applications that are compatible with a broad
     range of database managers and accounting packages.

    A fourth-generation language with an optimizing compiler
     and "smart" linker delivers run-time performance that
     matches the C language. The compiler produces standard
     .OBJ files that can be linked with object files produced by
     other languages.

    The project system supports an automatic segment-based
     overlay model that permits an application of several
     megabytes to run on any PC.  The project system optionally
     produces DOS dynamic link libraries (DLLs) so an application
     can be called from another application and distributed in
     segments.

    A Clarion DOS Extender Kit, which produces 16-bit protected
     mode applications for i286 processors and above, is
     available at extra cost.

The video support built into the Clarion language provides a
dazzling array of special visual effects:

    Screens can be larger than the monitor, scrolling
     automatically to make selected fields visible.  All text
     modes are supported: 80x25, 80x43 (EGA), 80x50 (VGA),
     132x44(SVGA), even soft text modes by UltraVision.

    Graphic images (.PCX, .BMP, and .GIF) can be displayed on text
     screens (an exact likeness of the text screen is
     automatically re-painted in graphics mode).

    Graphic images (.PCX, .BMP, and .GIF) can be printed to
     printers which use Printer Control Language (PCL).

    SAA/CUA compliance is built in: smooth mouse cursor,
     pulldown menus, list boxes, radio buttons, check boxes, and
     pushbuttons.  The font table in video ROM can be modified
     with a single statement to provide graphic symbols for the
     mouse cursor, radio buttons, and check boxes in text mode.
     Windows can be painted with "see through" areas, displayed
     with transparent shadows, and can be opened with special
     effects such as zoom, fall, fade, and wipe.  All windows can
     be dragged with the mouse.  No other text-based application
     development product delivers such an arsenal of video
     effects.

Clarion is a true programming language.  Therefore, it is
capable of accomplishing practically anything on a PC which can
be accomplished with any programming language.  The Clarion
language has been optimized for business applications; its
development environment has been designed to make creating
business applications as little "work" on the programmer's part
as possible.  So, whatever your business programming "problem,"
Clarion has a solution -- explore and find it.


<<Using Help>>

The Clarion for DOS Help system is context-sensitive.
Press F1 at any time and the Help text specific to the area of
the Clarion environment in which you are working is displayed.

Each pulldown menu and window in Clarion for DOS has
its own Section within a Help text file.  Each menu selection or
field on a window has its own Topic within the Section.  To see
the Help for any field or menu selection:

     Press F1 to display the Section
     Highlight the desired Topic in Topics list box.


<Help Text Files>
Each major functional area of the Clarion for DOS
environment has a Help text file (on disk with the .TXT
extension).  The Help Index menu selection takes you into each
of these files to look at the Help text for that area.

<The Sections Button>
The Sections button displays a list of all the pulldown menus
and windows which have Help text.  Highlight the Section you
want to display and press ENTER (or DOUBLE-CLICK the mouse) and
that text is displayed in the List box.  While you are within a
Section, you may use the arrow keys to scroll through the entire
Section.  To read the Help text for another Section, you must
select that Section from the list of Sections in the file (press
the Sections button).

<The Topics List Box>

The Topics list box displays a list of the individual topics within
the currently displayed Section. Highlight the Topic you want to
display and the List box takes you immediately to that Topic's Help
text within the current Section.


<<STOP Window Help>>

<The Main STOP Window)
The Main STOP Window

The list box shows the messages issued from the program with the
STOP command.  Optionally, if the dialog was invoked by the
user, the message box displays the message "User Requested
System Attention".

The "Continue" button can be used to resume the operation of the
program at the point where it was interrupted by the STOP
command.

The "Halt" button can be used to terminate the program in an
immediate and orderly fashion.  The program's SHUTDOWN procedure
(if there is one) will be executed before returning to the
operating system.

The "System" button may be used to access various types of
system information.  This button may be dimmed by the
programmer, or by environment configuration settings.

The STOP window is controlled by the "CLASTOP" environment
variable.  This is used to define the hotkey, if any, which
invokes the STOP window during an ASK or ACCEPT statement.  It
also controls the user's access to the system button.

CLASTOP=1085,ON is the default, which says the hotkey is the
ALT= combination, and the user has access to the "System" button
(ON).  This switch can be set from the environment, the .INI
file, or command line.  It can also be set with SETCOMMAND from
within the program.  However, when SETCOMMAND is used, the
hotkey selection has no effect, but the "System" button can be
activated or deactivated.

Pressing F1 on the STOP window brings up a description of the
basic features.  No other help is available in any of the other
STOP window screens.  These are only intended for developers to
access.  This documentation supplies the necessary information
for these screens.

<The System Information Window>
The System Information Window

Clarion Error Code
     This indicates the ERRORCODE of the last error reported.

Clarion File Error
     This indicates the name of the file which reported the last
     file error.

DOS Error Code
     This indicates the last DOS errorcode reported by DOS.

DOS Error Message
     This is the description of the last DOS error.

RUN Return Code
     This is the return code of the last RUN command.

Open File Handles
     This indicates the number of open file handles currently in
     use.  This value may not be exact, but may deviate by 0-5
     handles.

Current Directory
     This field displays the drive and path to the current
     directory.

Current COMMAND Flag Values
     This list displays the values of the COMMAND flags, all
     possible values are displayed, as they are retrieved first
     from the command line, then from the ini file, and then from
     the environment.

Files Button
     The "Files" button provides access to file specific
     information.

Memory Button
     The "Memory" button provides access to memory specific
     information.

Screens Button
     The "Screens" button provides access to Screen specific
     information.

Source Button
     The "Source" button permits a user to view text files from
     the system.  Warning, these files are loaded entirely into
     memory, see notes on this dialog below.

Ok Button
     The "Ok" button returns from the dialog back to the main
     STOP window.

<System File Status Window>
System File Status Window

Open File List
     List of open files

File Driver
     Name of the file driver being used for file selected in
     list.

Record Size
     Size of the selected files record buffer in bytes.

Number Of Keys
     Number of keys for file selected in list.

Number Of Memos
     Number of memos in the selected file.

Attributes Of Selected Files
  Owner:
     Indicates file has an Owner ID.
  Encryption:
     Indicates file is encrypted.
  May Be Created:
     Indicates file may be created.
  Reclaim Space:
     Space is reclaimed from deleted records/keys.
  BOF:
     File pointer is currently at beginning of file.
  EOF:
     File pointer is currently at end of file.
  In Transaction:
     Transaction processing is active for this file.
  Read Access:
     Read Access is enabled for this user
  Write Access:
     Write Access is enabled for this user
  Deny Read:
     Read Access is disabled for other users
  Deny Write:
     Write Access is disabled for other users

Selected File
     Full path and file name of the physical data file.

Fields
     Allows the user to view the current values of the fields in
     the record buffer.

Ok
     Returns to the previous dialog.


<System Memory Status Window>
System Memory Status Window

Active QUEUES
     Displays a list of the sizes and record counts of each
     active QUEUE.  QUEUEs are active (and use some memory) until
     they are FREEd.  The names of the QUEUE's are not available,
     but the size and number of RECORDs in the QUEUE is.  This
     information may be sufficient to identify a QUEUE in this
     list.  The "Fields" button may also be used to view the
     current values of the fields in the QUEUE buffer, for the
     selected QUEUE.

Stack
     Number of K free in the stack

Conventional
     Number of K free in conventional memory.

Logical Virtual (EMS/DISK)
     Number of K free in VIRTUAL memory (Real Mode only)

Logical Ext/Expanded
     Number of K free in EMS or Extended memory driver (Real
     Mode only)

Physical Disk For Drive
     Number of K free for swapping on the disk drive displayed.

Lot/House Size
     Size of the largest allocation unit (Screen save buffer,
     Queue element)

Houses Allowed
     Total number of swappable allocation units manageable.

Split Lot Size
     Size of fractional sized allocation units (used in a memory
     squeeze)

Houses Allocated
     Total number of swappable units allocated.

Houses Swapped
     Number of swappable units residing in EMS/XMS, or on Disk

Lots Allowed
     Number of swap areas permitted in conventional memory.

Lots Allocated
     Number of swap areas actually allocated in conventional
     memory.

EMM In Use
     Displays the form of EMS, or XMS which is being used by the
     Virtual Memory Manager (Real Mode only).  This display also
     shows the version number of the memory manager.

Running In Tiny Model
     Indicates that all virtual memory allocations currently fit
     in the EMS page frame and the program is not using any
     conventional memory for QUEUES, or Screen Saves.

Fields Button
     Button supplies access to values of fields of QUEUEs in
     list.

Next Drive Button
     Selects the next higher drive letter.

Prev Drive Button
     Selects the next lower drive letter.


<Screen System Status Window>
Screen System Status Window

Number Of Current FIELD
     Value returned by the FIELD function.

Current Video Mode
     Current Video Mode.

Number Of Screen FIELDS
     Total number of fields on the screen (the value returned by
     the FIELDS function).

Next SELECTED Field
     Value returned by the SELECTED function.

Active Screen ROWS
     Number of rows on the screen (the value returned by the
     ROWS function).

Active Screen COLS
     Number of columns on the screen (the value returned by the
     COLS function).

Character Waiting In KEYBOARD
     Next character in the Keyboard buffer, 0 if none (the value
     returned by the KEYBOARD function).

Last KEYCODE Entered
     Last key retrieved by the ASK, or ACCEPT (the value returned
     by the KEYCODE function).

Custom STYLE's Active
     Customized style file is in use.

Using CUA Processing
     Screen is in CUA mode.

Physical Screen Rows
     Number of physical rows on screen.

Physical Screen Cols
     Number of physical columns on screen.

Virtual Screen Rows
     Number of virtual rows in the SCREEN.

Virtual Screen Cols
     Number of virtual columns in the SCREEN.

Open PULLDOWNs
     Total number of open PULLDOWN structures.

Open SCREENs
     Total number of open SCREEN structures.

Top Left Position, In The Virtual Screen, Of Active Screen's
Row
     Top left corner of current window lies at this row in
     virtual screen.

Top Left Position, In The Virtual Screen, Of Viewport's Row
     Top left corner of visible screen lies at this row in
     virtual screen.

Top Left Position, In The Virtual Screen, Of Active Screen's
Column
     Top left corner of current window lies at this column in
     virtual screen.

Top Left Position, In The Virtual Screen, Of Viewport's Column
     Top left corner of visible screen lies at this column in
     virtual screen.

Flashback
     Allows the user to see the application screen. Any key
     press returns to the STOP windows.

<Record Field Information>
Record Field Information

Field Name
     Field's name is displayed if the field has a NAME attribute
     or the file has a CREATE attribute.

Field Type
     Data type of the field is displayed.

Value
     The value of the field is displayed.  Numerics contained in
     GROUPs may be displayed with graphics characters, but the
     numerics are also displayed independently in their normal
     form.

Data Owner Name
     If the record belongs to a file which has an OWNER attribute,
     the owner ID must be supplied before the data is displayed.
     Once the owner ID has been entered and the field completed
     the string is blanked.

<Data Display Window>
Data Display Window

File Data
     List displays text lines read from the file.

Line Number
     Displays the line number of the selected line in the list
     box.

View File Name
     Accepts the name of the file to be viewed.  The file is
     searched for via redirection, so the full path is not
     necessary, but if a full path is supplied it will override
     the redirection.  Note the entire file is loaded into memory.
     Large files may have an adverse effect on the program
     operation.


<<File Menu>>

The File menu contains normal file operations for each of the
functional areas of the Clarion environment.  Opening a specific
type of file automatically places you in the major functional
area which maintains that type of file (Application, Dictionary,
etc.).  These menu items are the "gateway" to all the major
functional areas within the environment.  When you are already
in one major functional area, opening another type of file takes
you into its (different) functional area of the Clarion
environment.

<New...>
New...                                    ( F2 or ALT+F N )

     Creates a new file.  You specify the type of file you are
     creating (Application, Dictionary, Database, Text, or Help) and
     its name.  The new file is created and you are automatically
     placed in that file type's functional area.

<Open...>
Open...                                   ( F3 or ALT+F O )

     Opens an existing file.  You specify the type of file you
     are opening (Application, Dictionary, Database, Text, or Help)
     and the name of the file.  You are automatically placed in that
     file type's major functional area.

<Change Directory...>
Change Directory...                       ( ALT+F D )

     Allows you to change the DOS current directory.  It is
     always a good idea to create applications in their own
     separate sub- directories.  Doing this makes it easy to
     identify the files that are part of an application and to
     delete those that are no longer needed when the application
     is complete (.OBJ files are one good example).

<Printer Setup...>
Printer Setup...                          ( ALT+F T )

     Allows you to setup your printer for the printing tasks you
     do through the Clarion environment.  It allows you to
     specify the destination (a file or the port to which your
     printer is connected), lines and columns per page, and
     pre-print and post-print printer control code strings.

<Exit>
Exit                                      ( CTRL+X or ALT+F X )

     Returns you to DOS from any major functional area of the
     environment.  If your work has not yet been saved to disk,
     you are asked whether to Save the file or not.


<<Project Menu>>

The Project menu contains selections which allow you to generate
source code, compile, link, and debug your applications.

Compiling and linking are controlled by Project (.PR) files (see the
Project and Redirection Files section in the User's Guide).

Each application you create has one Project file. A Project file
always has the same filename as the application, with a .PR
extension.  New Project files are automatically created for you by
the Application Generator and Text Editor (if necessary).

The Project file contains commands which tell the compiler and
linker how to create your application's .EXE file, such as:

     Whether to link in the debug information necessary for you
     to use VID to debug the application.

     The type of hardware that will be required for your
     application to run (8088, 80286, 80386, 80486, Math Co-
     processor).

     The type of .EXE file to be created--static-linked, overlay,
     or DLL.

<Make and Run>
Make and Run                              ( ALT+A or ALT+P A )

     Compiles and links your application to an .EXE file.  When
     the .EXE file is complete, your application is executed.

<Make and Debug>
Make and Debug                            ( ALT+K or ALT+P K )

     Compiles and links your application to an .EXE file.  When
     the .EXE file is complete, your application is executed
     under the Visual Interactive Debugger (VID).  You must have
     already specified Debug Settings in the application's
     Project file, otherwise VID will not execute the application
     (see the VID documentation in the User's Guide).

<Make>
Make                                      ( ALT+M or ALT+P M )

     Compiles and links your application to an .EXE file.

<Run>
Run                                       ( ALT+R or ALT+P R )

     Runs your application (.EXE file).  This assumes that you
     have already compiled and linked.

<Debug>
Debug                                     ( ALT+D or ALT+P D )

     Runs your application under VID.  This assumes that you
     have already compiled and linked with the debug settings in
     the Project file set ON.

<Change Project File...>
Change Project File...                    ( ALT+N or ALT+P N )

     Maintains the settings in the currently loaded Project file.
     The Project file settings determine the modules to be
     compiled and linked into your application's, as well as the
     model and code generation options for making the .EXE, .LIB
     and .DLL files.

<Load Project File...>
Load Project File...                      ( ALT+L or ALT+P L )

     Loads an existing Project file or creates a new one with the
     name you specify.  The Project menu selections operate only
     on the currently loaded Project.  The Application Generator
     and Text Editor automatically load (or create) the correct
     Project file for the application in which you are currently
     working.  From the opening main menu, you must load the
     Project file yourself to compile and link your application.
     Defaults for new projects are determined by inspecting the
     'CLARION.PR' file in the \CLARION3 directory. These
     settings may be adjusted by loading the \CLARION3\CLARION.PR
     project file, and saving it, with the desired default
     settings.

<<Tools Menu>>

The Tools menu contains a number of utilities which are useful
throughout the environment.

<DOS Shell>
DOS Shell                                 ( F10 or ALT+T D )

     Calls Clarion's disk maintenance program (CSHELL.EXE).

<DOS Prompt>
DOS Prompt                                ( ALT+T R )

     Temporarily exits to DOS to execute some DOS command(s).
     It saves the current state of the Clarion environment to a
     temporary file, frees most of the memory used by the Clarion
     environment, and loads a second copy of COMMAND.COM.  To
     return to Clarion from this DOS prompt, type "Exit" and
     press ENTER.

<Calculator...>
Calculator...                             ( ALT+T C )

     Calls Clarion's built-in programmer's calculator.

<ASCII Chart...>
ASCII Chart...                            ( ALT+T A )

     Brings up a list of all the ASCII codes.  The chart contains
     each ASCII display character, and the Decimal, Hexadecimal,
     and Octal numbers which represent that character.

<Color Chart...>
Color Chart...                            ( ALT+T L )

     Displays a list of all the Color Style Codes.  Each possible
     color combination is in the list along with the decimal
     number which represents it.

<Keycode Chart...>
Keycode Chart...                          ( ALT+T K )

     Displays a list of all the Clarion Keycodes.  Each possible
     key combination is in the list along with the decimal number
     which represents it.


<<Clarion Menu>>

The top section of items in the Clarion menu bring up "task
lists" of the last several projects you worked with in each of the
major functional areas.  This allows you to return directly to
a task you've already worked on, without the necessity of going
through the Open... screen from the File menu.  Selecting a
previous task from one of these lists does not automatically
change to the directory which contains the file.

In addition to re-selecting a previous task, you may also access
the New... and Open... screens through the task list screen by
selecting the New... or Open... Pushbutton.  This allows you to
check for a previous task, then immediately create or open the
file you want without returning to the File menu if the desired
task is not in the list.

<Load Application...>
Load Application...                       ( F4 or ALT+C A )

     Allows you to select one of the last several Application files
     in which you worked, or to create or open an Application not
     on the task list.  This selection takes you directly into
     the Application Generator with the selected file loaded.
     SHIFT+ F4 immediately loads the last Application on which
     you worked.

<Load Dictionary...>
Load Dictionary...                        ( F5 or ALT+C D )

     Allows you to select one of the last several Dictionary files
     in which you worked, or to create or open a Dictionary not
     on the task list.  This selection takes you directly into
     the Dictionary Editor with the selected file loaded.
     SHIFT+F5 immediately loads the last Dictionary on which you
     worked.

<Load Database...>
Load Database...                          ( F6 or ALT+C B )

     Allows you to select one of the last several Database files in
     which you worked, or to create or open a Database not on the
     task list.  This selection takes you directly into the
     Database Manager with the selected file loaded.  SHIFT+F6
     immediately loads the last Database on which you worked.


<Load Text...>
Load Text...                              ( F8 or ALT+C T )

     Allows you to select one of the last several Text files in
     which you worked, or to create or open a Text file not on
     the task list.  This selection takes you directly into the
     Text Editor with the selected file loaded.  SHIFT+F8
     immediately loads the last Text file on which you worked.

<Load Help...>
Load Help...                              ( F9 or ALT+C H )

     Allows you to select one of the last several Help files in
     which you worked, or to create or open an Help file not on
     the task list.  This selection takes you directly into the
     Help Editor with the selected file loaded.  SHIFT+F9
     immediately loads the last Help file on which you worked.

<43/50 Line Mode >
43/50 Line Mode                           ( ALT+C 4 )

     Places the video in 43 or 50 line mode (depending upon
     whether your hardware is EGA or VGA).  This menu selection
     is a toggle switch with a check mark () displayed when
     toggled ON.  The setting is saved in the Clarion
     configuration file.

<System Setup >
System Setup                              ( ALT+C S )

     Displays a sub-menu containing items which allow you to set
     system-wide options.  These are options that affect the
     entire Clarion Environment.

<Options...>
Options...                                ( ALT+C S O )

     Allows you to select environment options such as the  Color
     Styles file for the Clarion environment's use, or specify
     the use of your own text editor, and DOS shell program (other
     than the Text Editor and DOS Shell which are part of Clarion
     environment). You may also specify Clarion's ReportWriter (an
     add-on product) so that it can be executed from the IDE's main
     menu.

<Database Drivers...>
Database Drivers...                       ( ALT+C S D )

     Registers new database file drivers.  There are many more
     database file system drivers available than were provided
     in the shipping disks.  These extra file drivers are
     available directly from TopSpeed (call Customer Service at 800-
     354-5444 or (305) 785-4555 for more information). Once you
     receive a new file system driver, you must register its
     presence before the Clarion environment will be able to use it.

<Search Paths... >
Search Paths...                           ( ALT+C S S )

     Maintains Redirection files.  Redirection files are used by
     the Project system.  They provide individual search paths
     for specific files the compiler and linker need to find to
     accomplish their tasks (see the Project and Redirection Files
     section in the User's Guide).

<Edit Styles...>
Edit Styles...                            ( ALT+C S E )

     Maintains any Color Style Code file.  Color Style Code
     files are ASCII files containing a list of color codes used
     in your application's SCREEN structures and the actual
     colors to be used for those codes (see the Screen Color
     Schemes chapter in the User's Guide).

<Printer Controls...>
Printer Controls...                       ( ALT+C S P )

     Allows you to maintain Printer Control files for the
     Clarion environment and your applications (logical printer
     support through the PRINTER report attribute).  It allows
     you to specify the port to which each printer is connected
     and printer control code strings for the print effects of
     which each printer is capable.


<<Help Menu>>

Context-sensitive Help screens are available throughout the
Clarion for DOS environment through the F1 key.  The
Help menu contains selections which provide separate access to
the Help system.

<Using Help >
Using Help                                ( ALT+H U )

     Provides information on how to use the Help system.

<Help Index >
Help Index                                ( ALT+H H )

     Displays an Index of all Help screens available in the
     major functional area, allowing you to view a Help screen
     for a particular context when not actively in that context.

<About...>
About...                                  ( ALT+H A )

     Displays a screen with the program and copyright
     information for this specific release of Clarion for
     DOS.


<<New File Window>>

The New File window allows you to create a file.  These are the
files that are used to create and maintain the programs and data
files you develop in Clarion for DOS.

The type of file you choose to create determines the major
functional area of the Clarion environment to which you go.  The
Radio buttons at the top of the New File window allow you to
declare the type of file to create:

<Application>
() Application

     Creates a new .APP file and takes you directly into the
     Application Generator.  The Application Generator is the
     functional area in which you design the procedures and
     functions used by your application.  Specify only the
     filename (without extension) in the Filename field, the .APP
     extension is automatically appended.

<Dictionary>
() Dictionary

     Creates a new .DCT file and takes you directly into the
     Dictionary Editor.  The Dictionary Editor is the functional
     area in which you define the Database Dictionary, which
     contains the definitions of all the data files to be used by
     your application(s).  Specify only the filename (without
     extension) in the Filename field, the .DCT extension is
     automatically appended.

<Database>
() Database

     Creates an empty data file (whether or not the file's
     definition has the CREATE attribute).  A window appears
     asking for the Database Dictionary which contains the
     file's definition.  Once you specify the Dictionary, another
     window appears to choose the file definition to use.  It
     then creates the empty data file and takes you into the
     Database Manager to allow you to add records to the new data
     file.  A file with the .DBM extension is also created for
     the Database Manager's use (to store settings between
     Database Manager sessions).  The Database Manager is the
     functional area in which you may directly maintain the data
     contained in your files.  When creating a new Database file
     you must specify the entire filename, with extension, in the
     Filename field. The extension is necessary because each file
     system uses its own data filename extension conventions.

<Text>
() Text

     Creates a new text file and takes you directly into the
     Text Editor.  The Text Editor is the functional area in
     which you create and maintain any type of ASCII text file.
     You may specify only the filename (without extension) in
     the Filename field and the .CLA extension is automatically
     appended.  If you specify a filename with an extension, your
     complete filename is used.  To create a file without any
     extension, terminate the filename with a period (.).

<Help>
() Help

     Creates a new .HLP file and takes you directly into the
     Help Editor.  The Help Editor is the functional area in
     which you create and maintain Help files for your
     application(s). Specify only the filename (without
     extension) in the Filename field, the .HLP extension is
     automatically appended.

<Filename:>
Filename:

     Enter the new file's name.  You do not need to specify the
     file extension when creating an Application, Dictionary,
     or Help file -- the appropriate extension is automatically
     added.  If you do not supply an extension when creating a Text
     file, the .CLA extension is automatically supplied. You must
     specify the complete filename when creating a Database file.


<<File Open Window>>

The File Open window allows you to open an existing file.  The
type of file you choose to open determines the major functional
area of the Clarion environment to which you go.  The Radio
buttons at the top of the New File window allow you to declare
the type of file to open:

<Application>
() Application

     Opens an existing .APP file and takes you directly into the
     Application Generator.  The Application Generator is the
     functional area in which you design the procedures and
     functions used by your application.

<Dictionary>
() Dictionary

     Opens an existing .DCT file and takes you directly into the
     Dictionary Editor.  The Dictionary Editor is the functional
     area in which you define the Database Dictionary, which
     contains the definitions of all the data files to be used by
     your application(s).

<Database>
() Database

     Opens an existing .DBM file and its associated data file,
     then takes you directly into the Database Manager.  The
     Database Manager is the functional area in which you may
     directly maintain the data contained in your files.

     You may specify the data file's name (with extension) in
     the Filename field if there is no existing .DBM file
     associated with the data file.  The Database Manager then
     automatically creates the .DBM file for its use.

<Text>
() Text

     Opens an existing text file and takes you directly into the
     Text Editor.  The Text Editor is the functional area in
     which you create and maintain any type of ASCII text file.

     To open a Text file, with an extension other than the .CLA
     extension, type the filename or a new file mask in the
     Filename field.

<Help>
() Help

     Opens an existing .HLP file and takes you directly into the
     Help Editor.  The Help Editor is the functional area in
     which you create and maintain Help files for your
     application(s).

<Filename:>
Filename:

     The Filename field automatically displays the file mask
     appropriate for the type of file you select. You may
     change the mask or type in an explicit filename (with or
     without path) in the Filename field.  If you use a file
     mask, the Directories and Files List boxes allow you to
     choose the correct file to open.

<Directory:>
Directory:

     The Directory field displays the path of the files
     currently displayed in the File List.

<Files List>
Files List

     The Files List displays all files, in the directory
     selected in the Directories List, which match the file mask
     specified in the Filename field.

<Directories List>
Directories List

     The Directories List allows you to navigate to any drive or
     directory on your computer to find the file to open.  This
     allows you to select the file to open from anywhere in your
     computer.  This does not change the DOS current directory.

     The letters in the square brackets (i.e. [-C-]) allow you
     to select another disk drive.  The double-period (..\)
     entry allows you to select the "parent" of the currently
     displayed directory.

<*.* Button>
*.* Button

     When you complete this Pushbutton, the file mask displayed
     in the Filename field changes to *.* and the Files List
     displays all files in the directory.  This Pushbutton then
     changes to the default file mask (*.APP, *. DCT, etc.).


<<Change Directory Window>>

The Change Directory window allows you to change the DOS current
directory.  Creating all your applications in their own separate
sub-directories is a good habit to acquire because it makes disk
and directory maintenance more manageable.  Therefore, when
opening a file in another directory, it is a good idea to change
to the directory in which its files exist.  This ensures that
all files (temporary and/or otherwise) are written to the
correct directory.

<Switch To:>
Switch To:

     Displays the target directory.  You may explicitly type in
     the name of the directory to which to change, or select a
     directory from the Directories List at the right.

<Current:>
Current:

     Displays the DOS current directory.

<Directories List>
Directories List

     The Directories List allows you to select any drive or
     directory on your computer to which to change.  The letters
     in the square brackets (i.e. [-C-]) allow you to select
     another disk drive.  The double-period (..\) entry allows
     you to select the "parent" of the currently displayed
     directory.

<Change Button>
Change Button

     Once you have selected the directory to which to change,
     the Change Button executes the change to that directory.


<<Printer Setup Window>>

The Printer Setup window allows you to setup your printer for
the printing tasks you do through the Clarion environment.  The
settings you specify on this window are saved to the
CLARION3.INI file in the CLAPRINTDEVICE environment variable.

<Output To:>
Output To:

     Select the destination for printed output.  This may be the
     port to which your printer is connected (LPT1-4 or COM1-4)
     or a disk file.

<File:>
File:

     Enter the name of the disk file to receive the printed
     output.

<Printer Characteristics:>
Printer Characteristics:

     Specify the options you want when you print.

<Print Line Numbers>
[] Print Line Numbers

     Check this box to automatically place line numbers on each
     line of the output.

<Print Page Numbers>
[] Print Page Numbers

     Check this box to automatically place page numbers on each
     page of the output.  Page numbers are printed at the bottom
     of each page (centered).  Page numbers are not printed if
     Lines Per Page is 0.

<Extra Formfeed At End>
[] Extra Formfeed At End

     Check this box to automatically issue an extra Formfeed
     command to the printer at the end of each print job.  This
     should only be necessary for those printers whose paper
     handling characteristics do not allow you to remove a
     printout without an extra sheet feed.

<Lines Per Page:>
Lines Per Page:

     Enter the maximum number of print lines to place on a page
     before a Formfeed is issued to the printer. If zero, no
     form feeds are issued.

<Columns Per Line:>
Columns Per Line:

     Enter the maximum number of characters lines to print on a
     single line of the printout.  Any text line longer than
     that is truncated.

<Control Before:>
Control Before:

     Enter a printer control sequence to send before output
     begins.  For example, you could place the printer in
     compressed text mode to print greater than 80-column text.
     ASCII values may be included in the control string as
     numbers within angle brackets.  For example, '<27,15>'
     sends two characters to the printer -- ASCII 27 and ASCII
     15.

<Control After:>
Control After:

     Enter a printer control sequence to send after output ends.
     This is typically used to send a printer reset after
     sending a "Control Before" printer control sequence.


<<Load Printer Control File Window>>

The Load Printer Control File window allows you to type in the
name of the Printer Control file to load.  If you type in the
name of a non-existent Printer Control file, a new file is
created for you with the name you entered.  If you leave the
Filename field blank and complete the Ok button (or press
ENTER), another window appears which allows you to select the
file to load.


<<Printers Window>>

The Printers window displays a list of the names of all the
printers (and their output port) defined within the currently
loaded Printer Control file.

<Import Button>
Import Button

     Allows you to copy a printer definition from any Printer
     Control file to the currently loaded Printer Control file.
     This calls the Import Printer Model window to select the
     file from which to copy (may be the same file as currently
     loaded), then a second window to select the printer
     definition to copy.

<Insert, Change, and Delete Buttons>
Insert, Change, and Delete Buttons

     Allow you to maintain the individual printer definitions
     contained within the currently loaded Printer Control file.
     This calls the Add/Update Printer Model window.


<<Import Printer Model Window>>

The Import Printer Model window allows you to select the printer
definition to copy.  It displays a list of all the printer
definitions contained in the Printer Control file you specified
to copy from.


<<Add/Update Printer Model Window>>

The Add/Update Printer Model window allows you to name the
printer and its output port.

<Name:>
Name:

     Enter the name of the printer as it should appear in the
     Printers List window.

<Port:>
Port:

     Specify the output port to which the printer is attached.

<Controls Button>
Controls Button

     Calls the Printer Control Sequences window to allow you to
     maintain the control codes for the printer.


<<Delete Printer Model Window>>

The Delete Printer Model window allows you to remove a printer
defintion from the Printer Control file.


<<Duplicate Printer Window>>

The Duplicate Printer window warns you that you are attempting
to add a printer already defined in the Printer Control file.


<<Printer Control Sequences Window>>

The Printer Control Sequences window displays a list of all the
Control Sequences for all the printers defined within the
currently loaded Printer Control file.  The specific control
codes defined for the printer you are currently updating are
displayed at the right edge of the list.  If nothing is
displayed at the right of the entry, there is no control code
defined for this printer.

<Insert and Change Buttons>
Insert and Change Buttons

     Allow you to maintain the individual Printer Control
     Sequences defined for the printer you are currently
     updating. This calls the Add/Update Printer Control
     Sequences window.

<Delete Button>
Delete Button

     Calls the Delete Printer Control window.


<<Delete Printer Control Window>>

The Delete Printer Control window allows you to delete a control
code for a single printer, or for all printers in the Printer
Control file.

<THIS Printer Button>
THIS Printer Button

     Complete this Pushbutton if you want to delete only the
     control code sequence for this printer. This does not
     delete the Name of the control sequence, but only the code
     sequence.

<ALL Printers Button>
ALL Printers Button

     Complete this Pushbutton if you want to delete the Name of
     the control sequence and the control codes for every
     printer in the Printer Control file.


<<Add/Update Printer Control Sequences Window>>

The Add/Update Printer Control Sequences window allows you to
name the Control Sequence and its associated control codes for
the printer you are currently updating.

<Name:>
Name:

     Type in the name of the Printer Control Sequence.  This is
     the label which identifies the control code for each
     printer in the Printer Control file.  It is the value you
     use in the CONTROL field of a REPORT structure to identify
     which printer control code to issue when you specify the
     PRINTER attribute on your REPORT.

<Control:>
Control:

     Enter a string constant containing the control code to send
     to the printer when the Printer Control Sequence is called
     by a CONTROL field in a REPORT (see CONTROL in the Language
     Reference).  The control code you enter here is the
     specific code the printer will execute for the print effect
     you want. Consult the printer's documentation for the
     control code to accomplish a given print effect.

     ASCII values may be included in the control string as
     numbers within angle brackets.  For example, '<27,15>'
     sends two characters to the printer -- ASCII 27 and ASCII
     15.


<<Project Settings Window>>

The Project Settings window allows you to maintain your
applications' Project files.  A Project (ApplicationName.PR) file is
required to compile and link an application.  The Application
Generator and Text Editor automatically create Project files for
you.  (See the Project and Redirection Files section in the User's
Guide.)

The settings you specify here determine the output of the compiler
and linker.  You may select specific settings for debug options,
output file type (.EXE, .LIB, or .DLL), target hardware, and
inclusion of library modules in the link step.

<Project Name:>
Project Name:

     Displays the source file or application to be processed by
     the project system.

<Memory Management>
Memory Management

     These options allow you to specify the memory model to be used
     when linking.  See the chapter on Overlays and Dynamic Link
     Libraries (DLLs) in the User's Guide for a discussion of the
     concepts involved in linking, Overlays, and DLLs.

() Static Model

     Creates a static-linked .EXE (no overlays). This means the
     entire program is loaded into conventional memory at run time.
     Although some data is swapped all code stays fixed.

() Overlay Model

     Creates an .EXE which automatically uses overlays. Overlay
     programs dynamically swap code and data segments in and out of
     conventional memory as needed for program execution. This
     allows very large applications to run within the DOS 640K
     conventional memory constraint.  Enabling the use of EMS memory
     will dramatically improve the performance of these programs,
     XMS is not used.

() Protected Mode

     Creates an .EXE which runs in protected mode. This eliminates
     the DOS 640K "barrier."  Protected mode applications are able
     to address all the memory installed in the computer (up to
     16Mb). These programs are vastly more efficient than DOS
     overlays and add an additional layer of security from obscure
     bugs with no performance penalty. Protected mode requires an
     i80286 or greater and 2MegRAM.

     This option is only available if you have purchased the DOS
     Extender from TopSpeed. Otherwise, it is dimmed out and
     unavailable.

[] Use Runtime Libraries

     This specifies an overlay or protected mode program which uses
     DLLs.  This option speeds up link time, since the Clarion
     standard library functions do not need to be linked into your
     application's .EXE, but are instead accessed at run time from
     the DDVCLA.DLL file (as are the file drivers' DLLs). The
     resulting .EXE file requires that DDVCLA.DLL and the file
     drivers' DLL files be available (either in the same directory
     or through the DOS PATH) to correctly execute.

<Application Access Method>
Application Access Method

     These options determine the type of file created when you
     "Make" your application.

() Executable Program

     Creates an .EXE file. This is the default and most common
     target file type.

() Procedure Call Library

     Creates either an .LIB or a .DLL and .LIB file. If Use Runtime
     Libraries is checked ON, you make a .DLL and .LIB, otherwise,
     only an .LIB is created.  Once you have made the .LIB or .DLL
     and .LIB, the procedures and functions you have written in them
     may be used in your other applications by simply linking in the
     .LIB.  This eliminates re-compiling them in every application.

<Target Filename:>
Target Filename:

     Enter the name of the file you wish to create.  This allows
     you to override the default .EXE, .LIB, or .DLL filename
     and create a new file which does not overwrite an existing
     file.

     There is a project system "expansion macro" -- %clapfx% --
     which specifies that the target file name is prefixed with
     a three-character identifier of the memory model being used
     to create the file.  This is usually used only when
     creating Procedure Call Libraries.  The prefixes
     substituted for each memory model are:

         Static                  : DXV
         Overlay (Non-DLL)       : DOV
         Overlay (DLL)           : DDV
         Protected Mode (Non-DLL): DEV
         Protected Mode (DLL)    : DES

     If you use the %clapfx% prefix you may only specify five
     more characters for the filename.  For example, with the
     Static Model and Procedure Call Library radio buttons
     selected, if you enter:

         %clapfx%LKUPS

     the file created will be:

         DXVLKUPS.LIB

     This macro is the ONLY project system expansion macro
     recognized in the Clarion for DOS environment.
     You may use it in the Application Generator to indicate
     that an External Object Module's name will be appropriately
     prefixed with the selected memory model for the application.

     NOTE: Once your library has been compiled and linked in ALL
     available memory models, it is available for them all.

[] Use PenDOS Library

    This option is used when Clarion for DOS is being used to develop
    applications which use the PenDOS device driver. This
    causes the project system to link the appropriate required
    core libraries.  The prefix for the pen libraries is P??
    (ie:PXV for static pen application).

    This is available from TopSpeed at an additional cost. Call
    800 354-5444 or (305) 785-4555 for more information on the
    Clarion PenDos Library.

<Debug Button>
Debug Button

     Calls the Debug Settings window which allows you to modify
     the whole application's debug settings (which may be
     overridden on specific modules).  This determines the manner
     in which the debugger (VID) may function.

<Module Button>
Module Button

     Calls the Advanced Module Settings window which allows you
     to specify other related source files and libraries to be
     linked with your application.

<Directory Button>
Directory Button

     Calls the Search Directories window which allows you to
     maintain redirection files (the system CLARION.RED or a
     local CLARION.RED).  The redirection file specifies the
     search path of source files, include files, etc. (see the
     essay on Project and Redirection Files in the User's Guide).

<Hardware Button>
Hardware Button

     Calls the Target Hardware window which allows you to
     specify the CPU for which the generated code is optimized.


<<Debug Settings Window>>

The Debug Settings window allows you to modify the debug
settings for the current application.  This determines the
manner in which Clarion's Visual Interactive Debugger (VID)
functions.

<Debugging Options>
Debugging Options

     Select the settings which enable VID for testing your
     application:

[] Enable Source Debugging

     Generates the internal code necessary to debug the program
     using the Visual Interactive Debugger (VID).

[] Debug in Graphics

     Required when the debugger will be used with a program
     containing screens opened in graphics mode.

[] Abort Make on First Error

     Automatically aborts the compile and link cycle when the
     first compile error is encountered.

<Code Generation Options>
Code Generation Options

     Select settings for error trapping and code optimization in
     your application:

[] Stack Flow Checking

     Traps for an error if you are nested too deeply within a
     stack segment. Note: this can only check entry sequences
     into procedures in source modules compiled with this option
     set.  This means the possibility for catastrophic failure
     still exists within the core libraries because they do not
     have stack checking on.

[] Null Parameter Checking

     Generates extra code to alert the developer when a
     referenced parameter has not been passed.

[] Array Index Checking

     Generates extra code to alert the developer when a
     subscript of an array is out of range.

[] Optimizations On

     Produces optimized code.  The Optimizations On option is
     automatically switched off when debugging. Thus, you can
     not use VID to determine if the code has been sufficiently
     optimized.


<Linker Options>
Linker Options

     Select linker options for your application:

[] Build Symbol Map

     Builds a Symbol Map (.MAP) file for use with VID as well as
     Codeview compatible debuggers.

[] Case Sensitive Linking

     Required only when linking foreign .OBJs which are case
     sensitive.  Clarion's .OBJs are not case sensitive.

[] Generate Line Numbers

     Required only when using a Codeview compatible debugger.
     VID keeps track of line numbers automatically.

<Conditional Switches>
Conditional Switches

     Specify up to four On/Off (1/0) switches whose value may be
     checked in the main program module (or any other module).
     These switch values can be checked by the second parameter
     of the COMPILE and OMIT compiler directives.

     For example, type in the word "NET" then toggle ON the
     Check box to set its value to one (1).  Your application's
     Clarion source code should include a compiler directive to
     test the value of the switch:

            OMIT('NetworkCode',NET=0)
                   !some executable code statements
            ! NetworkCode                   !End of omittable code

     This code does not compile the section of code bounded by
     the OMIT and its search string "NetworkCode" when the value
     of NET is zero.  In this case, since NET is set to one, the
     code would be included in the compile.

<Command Line Parameters:>
Command Line Parameters:

     Enter any command line parameters your application may
     require at run time.  This allows you to test your
     application's command line settings through the Clarion
     environment.

     NOTE: You may NOT enter command line parameters for
           VID on this line.

<Stack Size:>
Stack Size:

     Specify how much space is allocated to the local stack for
     storing local dynamic data (variables defined within a
     procedure).  The default is 16K.

<One Item Per Segment Size:>
One Item Per Segment Size:

     Specify the threshold size at which a data element is
     automatically assigned a new segment by the compiler.  Any
     data element larger than the specified size is assigned its
     own segment.  The maximum size of a segment is 64K.  This
     threshold parameter prevents segment overflow at compile
     time.


<<Advanced Module Settings Window>>

The Advanced Module Settings window displays a list of the
related source code files and libraries to be linked into your
application.

<Project Module Entries List>
Project Module Entries List

     Displays a list of all the modules included in the project.
     The list displays the Type of module and its Status
     (whether debug settings are specified for a module which
     override the Project's Debug Settings window settings).

<Insert, Change, and Delete Buttons>
Insert Change, and Delete Buttons

     Calls the Module Attributes window which will allow you to
     maintain the modules in the Project.

<Move Up Button>
Move Up Button

     Moves the currently highlighted module up one position in
     the list.

<Move Down Button>
Move Down Button

     Moves the currently highlighted module down one position in
     the list.

<<Module Attributes Window>>

The Module Attributes window allows you to specify the name and
type of module, and debug settings which pertain ONLY to that
module.

<Module Name:>
Module Name:

     Enter the filename of the module (with extension, without
     path).  Entering a path is unnecessary because the file is
     found by the compiler and linker through the Redirection file
     (CLARION.RED).

<Module Type>
Module Type

     Select the type of module (file) you are including in the
     project.

() External Source File

     Specifies a Clarion source code (.CLA) file which was not
     generated by the Application Generator.  This file is compiled
     and linked into the application.

() Generated Source File

     Specifies a Clarion source code (.CLA) file which was
     generated by the Application Generator.  This file is
     compiled and linked into the application.

() External OBJ/LIB File

     Specifies an .OBJ or .LIB file to be linked into the
     application.

() Overlay Control File

     Specifies the module is an Overlay Control (.EXP) file.
     Normally the project system will automatically generate this
     file.  It is used to declare special attributes on overlay
     segments, and items in a DLL which are to be accessed from
     other libraries.  When projects become very large it is more
     efficient to remove unnecessary items, and to manage these
     files manually.  In order to recover control of this file from
     the project system, add a module of this type with the same
     primary name as the project file.

() Project Control File

     Specifies the module is a Project (.PR) file. Other projects
     can be invoked from within a project file. This may be useful
     for ensuring that all the dependent libraries for a particular
     system are are up to date.  When a project is called from
     within a project file, the child project receives the model of
     the calling project.

() Project Statement

     Specifies that the Module Name field actually contains a
     Project statement, not the name of a file. Any valid Project
     file statement may be entered here.

<Module Settings>
Module Settings

     The Module Settings allow for more advanced error checking
     during run-time and debugging sessions for the module selected.
     Any settings specified here automatically override settings
     made on the Debug Settings window.

[] Called From This DLL Only

     This option indicates that all procedures in this module are
     are private to the DLL into which the module is being linked.
     When checked on, all the procedures in the module may be called
     from other modules in the DLL, but may not be called from
     procedures outside of the DLL.  Entries are made in the .EXP
     file

     Without an entry in the Export file, no procedure outside the
     DLL may call any procedure in this module.  There are some
     performance penalties with large Export files. Therefore, only
     those modules which contain procedures which must be accessed
     by procedures outside the DLL should have Export file entries.

[] Use Override Settings

     Activates the override settings. If this Check box is not ON,
     the settings specified on the Debug Settings window are in
     effect for this module.

[] Stack Flow Checking

     Traps for an error in this module if you are nested too deep
     within a stack segment.

[] Null Parameter Checking

     Generates extra code in this module to alert the developer when
     a referenced omitted parameter has not been passed.

[] Array Index Checking

     Generates extra code to alert the developer when a subscript of
     an array is out of range.

[] Enable Source Debugging

     Generates the internal code necessary to debug the module using
     the Visual Interactive Debugger (VID). This allows you to
     specify debugging only for specific modules.

<Conditional Switches:>
Conditional Switches:

     Allows you to specify up to four On/Off (1/0) switches whose
     value may be checked in this module.  Switch values may be
     checked in the second parameter of the COMPILE and OMIT
     compiler directives.  For example, type in the word "NET" in
     the Conditional Switch, then activate the Check box to set its
     value to one (1).  Your application's Clarion source code then
     includes a compiler directive to tests the value of the switch,
     such as:

            OMIT('NetworkCode',NET=0)
                   !some executable code statements
            ! NetworkCode                   !End of omittable code

     This code does not compile the section of code bounded by
     the OMIT and its search string "NetworkCode" when the value
     of NET is zero.  In this case, since NET is set to one, the
     code would be included in the compile.

     Some conditional switches are used by the project system
     itself:

     The switch "maincode" is used on the main module when
     libraries are being made. When this switch is turned off,
     it forces the compiler to call the main entry code
     procedure programname$main instead of _main, avoiding
     duplication conflicts.

     The GENERATED switch is used on source modules created by
     the Application Generator.  The project system uses its
     existence to flag generated modules for special processing.
     Generated modules cannot be deleted from the project system,
     they must be deleted from the Application Generator.  A
     generated source module also cannot be changed to any other
     type of module from within the project system.


<<Search Directories Window>>

The Search Directories window allows you to maintain Redirection
(CLARION.RED) files.  See the essay on Project and Redirection
Files in the User's Guide for a discussion of the use of Redirection
files.

<File Spec/Search Path List Box>
File Spec/Search Path List Box

     Displays the contents of the redirection file (CLARION.RED).
     The Redirection file controls the search paths of the project
     system and its related files.

<Save Local Redirection Button>
Save Local Redirection Button

     Saves the currently displayed Redirection file (CLARION.RED) to
     the same directory as the currently loaded Project file, or the
     DOS current directory if no Project file is loaded.

<Save System Redirection Button>
Save System Redirection Button

     Saves the currently displayed Redirection file (CLARION.RED) to
     the directory in which Clarion for DOS was installed. This
     option is not available if the currently displayed Redirection
     file is a local Redirection file.

<Insert, Change, and Delete Buttons>
Insert, Change, and Delete Buttons

     Allow you to maintain the entries in the Redirection file.

<Locate Button>
Locate Button

     Calls the Locate Visible Files window to search for
     specific files through the paths specified in the
     Redirection file. This allows you to determine exactly what
     files are being accessed by the compiler and linker through
     the Redirection file.

<Validate Button>
Validate Button

     Validates that all the search paths entered reference existing
     sub-directories.  It will also warn you if a named directory
     contains no files.  The "No Files Exist At D:\SOMEDIR\*.*"
     warning indicates that a disk directory is specified in the
     Redirection file which either does not exist, or contains no
     files of the type specified.


<<Redirection Form Window>>

The Redirection Form window allows you to maintain Redirection
(CLARION.RED) file entries.  See the essay on Project and
Redirection Files in the User's Guide for a discussion of the use of
Redirection files.

<File Spec:>
File Spec:

     Enter the name of the file to include in the Redirection
     file.  This may be an explicit filename, or you may use the
     DOS wildcards (? and *).

<Search Directories:>
Search Directories:

     Enter the search path to use for the File Spec. This path is
     specified in the same manner as a DOS PATH statement. The
     delimiter between search directories is "; " (semi-colon
     followed by a space).  A period (.) indicates the DOS current
     directory, double-period indicates the parent of the DOS
     current directory.


<<Project Confirm Deletion Window>>

The Project Confirm Deletion window allows you to confirm a
delete request before the action is taken.  Press the Ok button
to confirm the delete.


<<Locate Visible Files Window>>

The Locate Visible Files window allows you to perform a file search
through the currently active Redirection file (CLARION.RED --
whether system or local), or the DOS path.  With this window you may
determine exactly which files are being accessed by the compiler and
linker for a specific project.  You may also locate any file visible
through the DOS path.

<File Specification:>
File Specification:

     Enter the filename to locate. The DOS wildcard characters (*
     and ?) are valid in this field.

<Use Redirection>
() Use Redirection

     Specifies that the search use the currently active Redirection
     file (CLARION.RED).  If there is a CLARION.RED file in the DOS
     current directory, it is used.  If not, the system Redirection
     file is used.

<Use DOS Path>
() Use DOS Path

     Specifies that the search use the DOS path (ignoring the
     Redirection file) to locate the file.

<Visible Files Matching Spec:>
Visible Files Matching Spec:

     Displays a list of all files, visible through the search paths
     specified in the Redirection file, which match the File
     Specification you entered.


<<Target Hardware Window>>

The Target Hardware window allows you to optimize the machine code
generated by the compiler for a specific CPU and/or Co- processor
combination.  The Radio buttons determine the system for which your
program will be optimized.

() 8086/8088 Thru 80486

     This is the "lowest common denominator" selection. When this
     option is selected, the resulting .EXE will execute correctly
     on any IBM-compatible PC.

() 80286 Or Later

     Select this option to optimize the resulting .EXE for the 80286
     CPU.  It will also execute correctly on an 80386 or 80486
     computer.  It will not execute on an 8086 or 8088-based
     computer.

() 80386 Or Later

     Select this option to optimize the resulting .EXE for the 80386
     CPU.  It will also execute correctly on an 80286 and 80486
     computer.  It will not execute on an 8086, 8088 based computer.

() 80486 Or Later

     Select this option to optimize the resulting .EXE for the 80486
     CPU.  It will not execute on an 8086, 8088, computer.

[] Math Coprocessor Active

    When this option is checked on it tells the system that a
    math-coprocessor will be present and that the emulator may be
    omitted.  The emulator is always linked in for Clarion overlayed
    and extended programs.  The math co-processor is automatically
    used if it exists on the target machine regardless of this
    setting.

<<Load Project File Window>>

The Load Project File window allows you to type in the name of the
Project (.PR) file to load.  The Application generator and Text
Editor normally load or create the appropriate Project file for you.
 If you want to compile and link an application from anywhere else
in the environment, you must first load the correct Project file.

If you type in the name of a non-existent Project file, a new
Project file is created for you with the name you entered.  If you
leave the Filename field blank and complete the Ok button (or press
ENTER), another window appears which allows you to select the file
to load.


<<Project Monitor Window>>

The Project Monitor window displays your application's status as it
is being compiled and linked to an .EXE, .LIB, or .DLL file.

The compile process may be aborted by pressing ESC. The compiler
will complete the module it is currently processing then return
control to the user.

The top two lines display various activity messages, and module
names.  The progress bar is also displayed in the top right corner.
The progress bar makes two full sweeps for each module: once for
syntax interpretation, and once for native code generation.

The following fields display information applicable to the
current module being processed:

Source Lines:

     Displays the source line number being compiled (in real time).

Object File Size:

     Total size (code+data) of the object module just created.

Syntax Errors:

     Number of syntax errors encountered in the source module
     being compiled.

Compiler Warnings:

     Total number of warning messages issued by the compiler for
     the module.

<Project Statistics:>
Project Statistics:

     The fields in this section display project wide statistics.

Name:

     The name of the project file.

Modules Compiled:

     Total number of modules compiled.

Total Compile Time:

     Total compile time for all modules. The clock is subject
     to interruption in it's update for the sake of
     compiler/linker performance. The final displayed time is
     accurate to within 1 second.

Target Module Size:

     Size of the created (.EXE, .LIB/.DLL) file.

Total Errors:

     Total number of errors received from the compiler or linker
     for all modules.

Total Warnings:

     Total number of warnings for all modules compiled.

Generated Code:

     Total number of bytes allocated in CODE segments generated.

Generated Data:

     Total number of bytes allocated in DATA segments generated.

<Edit Errors Button>
Edit Errors Button

     Calls the Text Editor to allow you to modify the source
     code when syntax errors are detected.

<Print Button>
Print Button

     Writes the compiler messages to the device defined by the
     CLAPRINTDEVICE environment variable (set in the Printer
     Setup selection on the File menu).

<Ship List... Button>
Ship List... Button

     Calls the Ship List window to display the files which
     contain the native code and data necessary to use the
     application.


<<Ship List Window>>

The Ship List window displays a list of the Distribution Files
Needed to use the target file.  For example, if the target file is
an .EXE which will Use Runtime Libraries, the list displays the
appropriate .DLL files which must be distributed with the .EXE for
its proper execution.

<Print Button>
Print Button

     Writes the list to the device defined by the CLAPRINTDEVICE
     environment variable (set in the Printer Setup selection on the
     File menu).


<<Select A File Window>>

This window allows you to open an existing file of the type
specified in the window's Title.

<Filename:>
Filename:

     The Filename field automatically displays the file mask
     appropriate to the type of file you are looking for. You
     may type in an explicit filename or use the Directories and
     Files List boxes to choose the correct file to open.

<Directory:>
Directory:

     The Directory field displays the path of the files currently
     displayed in the File List.

<Files List>
Files List

     The Files List displays all files in the directory selected in
     the Directories List which match the file mask specified in the
     Filename field.

<Directories List>
Directories List
     The Directories List allows you to navigate to any drive or
     directory on your computer to find the file to open.  This
     allows you to select the file to open from anywhere in your
     computer.  This does not change the DOS current directory.

     The letters in the square brackets (i.e. [-C-]) allow you to
     select another disk drive.  The double-period (..\) entry
     allows you to select the "parent" of the currently displayed
     directory.


<<Calculator Window>>

The Calculator is a full-featured programmer's calculator. This
calculator is specifically designed to supply functions and
operations that programmers need, in addition to the operations
common to all calculators.

One major benefit of using the Clarion programmer's calculator is
the ability to perform any of the operations in the Decimal (base
10), Hexadecimal (base 16), or Binary (base 2) number systems. These
three number systems are the ones most commonly used by programmers.
All operations the calculator performs will work in all three number
systems.  However, numbers with fractional portions are only
available in the Decimal system.

Converting the currently displayed value from one number system to
another is a simple matter of selecting the new number system--the
conversion is automatic and displays immediately. For any Decimal
value containing a fractional portion, only the integer portion is
converted to Hexadecimal or Binary--the fractional portion is
truncated, not rounded.

Other useful features are the bitwise operations: AND, OR, XOR
(eXclusive OR), NOT, SHL (SHift Left), and SHR (SHift Right). These
operations are not normally a part of most calculators. These
operations directly reflect the results you may expect from the
Clarion language BAND(), BOR(), BXOR(), and BSHIFT() functions.

The Bit Size entry field allows you to limit the values displayed to
only those that will fit in the number of bits you specify here.
 This means you can make the bitwise operations emulate the expected
results for the fixed number of bits in each of the Clarion language
data types.  With a Bit Size specified, any operation which causes a
bit to "fall off" to the left is signaled by an "Overflow" warning
message.  If the Bit Size is set to zero, the limits are disabled.

<Calculator Usage>

<Calculator Use>
Calculator Use

You may use the Clarion Calculator with a mouse, or the keyboard. To
use the mouse, simply CLICK on the desired Pushbutton to complete
it. The keyboard use conventions are also fairly straight-forward:

     The single character displayed in each Pushbutton on screen
     is the keyboard character used to complete that Pushbutton.

     The keystrokes that complete the bitwise operations
     Pushbuttons are displayed in parentheses on the Pushbutton.

     The "Clear" Pushbutton (the top left C Pushbutton) is
     completed by the ESC key.

     Number system conversion is accomplished with the CTRL+D
     (Decimal), CTRL+H (Hexadecimal), and CTRL+B (Binary)
     keystrokes.

     The ALT+B key completes the Bit Size entry field.

     Either ALT+X or CTRL+X completes the Exit Pushbutton.

The Clarion Calculator operates in a similar manner to any hand-
held calculator.

     Enter a value.

     The value is displayed at the top of the screen.

     Complete an Operation Pushbutton.

     The single character denoting the operator type is displayed
     to the right of the first value entered.

     Enter a second value.

     The second value is displayed at the top of the screen,
     overwriting the first value.

     Complete the = Pushbutton.

     The resulting value of the operation is displayed at the top
     of the screen, overwriting the second value.

<Calculator Operations>
Calculator Operations

The Clarion Calculator contains all the arithmetic operations you
would normally expect to have in a hand-held calculator: Addition,
Subtraction, Multiplication, and Division.  It also contains
Exponentiation, Modulus Division, and the bitwise operations
previously discussed.

Addition

The + Pushbutton allows you to add two values.

                    2          First value entered (decimal)
                +   3          Second value entered (decimal)
                ---------
                    5          Result of the operation (decimal)

Subtraction

The - Pushbutton allows you to subtract the second value entered
from the first.

                    3          First value entered (decimal)
                -   2          Second value entered (decimal)
                ---------
                    1          Result of the operation (decimal)

Multiplication

The * Pushbutton allows you to multiply two values.

                    3          First value entered (decimal)
                *   2          Second value entered (decimal)
                ---------
                 6             Result of the operation (decimal)

Division

The / Pushbutton allows you to divide the first value entered by
the second.  Note that division by zero is impossible.

                    8          First value entered (decimal)
                /   2          Second value entered (decimal)
                ---------
                    4          Result of the operation (decimal)

Exponentiation

The EXP Pushbutton allows you to raise the first value entered
to the power of the second (multiply the first value by itself
the number of times specified by the second value).

                    8          First value entered (decimal)
                EXP 2          Second value entered (decimal)
                ---------
                   64          Result of the operation (decimal)

Modulus Division

The MOD Pushbutton allows you to divide the first value entered
by the second, giving the remainder as the result.

                   11          First value entered (decimal)
                MOD 3          Second value entered (decimal)
                ---------
                2              Result of the operation (decimal)

AND

The AND Pushbutton allows you to compare the bits of the first
value entered to the bits of the second.  The resulting value
contains only the bits which are on (1) in both values.  This
example's result is equivalent to the result obtained from the
Clarion language BAND(0110b,1100b) function.

                    0110       First value entered (binary)
                AND 1100       Second value entered (binary)
                ---------
                    0100       Result of the operation (binary)

OR

The OR Pushbutton allows you to compare the bits of the first
value entered to the bits of the second.  The resulting value
contains the bits which are on (1) in either of the values.
This example's result is equivalent to the result obtained from
the Clarion language BOR(0110b,1100b) function.

                    0110       First value entered (binary)
                OR  1100       Second value entered (binary)
                ---------
                    1110       Result of the operation (binary)

XOR

The XOR Pushbutton allows you to compare the bits of the first
value entered to the bits of the second.  The resulting value
contains the bits which are on (1) in only one of the values
(not both).  This example's result is equivalent to the result
obtained from the Clarion language BXOR(0110b,1100b) function.

                    0110       First value entered (binary)
                XOR 1100       Second value entered (binary)
                ---------
                    1010       Result of the operation (binary)

NOT

The NOT Pushbutton allows you to reverse the bits of the value
entered.  The resulting value contains zeroes (0) where there
were ones (1) and ones (1) where there were zeroes (0).  This
example's result is equivalent to the result obtained from the
Clarion language BXOR(0110b,1111b) function.

                    0110       First value entered (binary)
                NOT            Second value entered (binary)
                ---------
                    1001       Result of the operation (binary)

SHL

The SHL Pushbutton allows you shift left the bits of the first
value entered by the number of bits specified by the second
value.  This example's result is equivalent to the result
obtained from the Clarion language BSHIFT(0110b,1) function.

                    0110       First value entered (binary)
                SHL    1       Second value entered (binary)
                ---------
                    1100       Result of the operation (binary)

SHR

The SHR Pushbutton allows you shift right the bits of the first
value entered by the number of bits specified by the second
value.  This example's result is equivalent to the result
obtained from the Clarion language BSHIFT(0110b,-1) function.

                    0110       First value entered (binary)
                SHR    1       Second value entered (binary)
                ---------
                    0011       Result of the operation (binary)


<<ASCII Chart Window>>

The ASCII Chart window displays a list of all the ASCII codes in
the decimal, hexadecimal, and octal number systems.  The display
character associated with each code is displayed at the left.


<<Color Chart Window>>

The Color Chart window displays a list of all possible Color Style
Codes.  The color combination each represents is displayed at the
right.  For more discussion of colors, see Color Style Codes in the
Language Reference and the Screen Color Schemes chapter in the
User's Guide.


<<Keycode Chart Window>>

The Keycode Chart window displays a list of all possible Clarion
Keycodes which the Clarion KEYCODE() function may return.  The
keycode values listed at the right of each key represent the keycode
when the key is pressed alone, and in conjunction with the CTRL,
ALT, and SHIFT keys.

Normally, the KEYCODES.EQU keycode equates file is included in
your application's source code.  This file allows you to use
mnemonic equate labels for the keys and eliminates the need to
know the specific numbers returned for each keycode.


<<Select File Window>>

The Select File window displays a task list of the last several
files you worked with of the type displayed at the top of the
screen.  Highlight the file with which you want to work and press
ENTER (or DOUBLE-CLICK).  If the file you want is not listed, CLICK
on (or TAB to and press ENTER) the New... or Open... button to
create or select another file.


<<System Options Window>>

The System Options window allows you to tailor the Clarion
environment to your preferences.  You may specify the use of your
own Color Styles file, text editor, and DOS shell program. Selecting
one of the buttons on the right side of the window allows you to
change specific Clarion for DOS system settings (any change to these
settings take effect only after you restart the Clarion
environment).

<Style File:>
Style File:

     Name the Color Style Codes file you want the Clarion for DOS
     environment to use. This allows you to customize the
     environment to the color scheme which suits you best. The file
     you name is specified in the STYLE_FILE environment variable
     (contained in CLARION3.INI).

<Printer Controls:>
Printer Controls:

     Specify the Printer Control File for the Clarion environment to
     use. PRINTER.CTL is the default. The file you name is specified
     in the CLAPRINTER environment variable (contained in
     CLARION3.INI).

<Editor Name:>
Editor Name:

     Name the text editor you want to use in place of the Clarion
     Text Editor.  If you specify another editor here, the Clarion
     environment will run your editor and allow you to edit the file
     when you open or create a Text file.  When you exit your
     editor, you return to the Clarion environment.  A note of
     caution: text editors and word processing programs are not the
     same--this option must name a text editor.  The editor you name
     is specified in the EDITOR_NAME environment variable (contained
     in CLARION3.INI).

     The main advantage of specifying your own text editor is your
     own familiarity with it, which eliminates the "learning
     curve" required before becoming proficient with the Clarion
     Text Editor.  The main disadvantage of specifying your own
     text editor is the loss of the use of the SCREEN, REPORT,
     and PULLDOWN menu formatting tools, which are all integral
     parts of the Clarion Text Editor.  This means the only way
     to format a SCREEN, REPORT, or PULLDOWN menu would be to use
     the formatting tools in the Application Generator (or to
     directly edit the data structure code--not recommended).

<Shell Name:>
Shell Name:

     Name the DOS Shell program you wish to use in place of CSHELL.
      When you select DOS Shell from the pulldown menu (or press
     F10), your DOS Shell program is executed.  When you exit from
     your shell program, you return to the Clarion environment. The
     shell program you name is specified in the SHELL_NAME
     environment variable (contained in CLARION3.INI).

<ReportWriter .EXE:>
ReportWriter .EXE:

    If you have purchased Clarion ReportWriter (an add-on product),
    specify the executable filename here. This enables it to be run
    from the IDE's main menu.

<Video Settings:>
Video Settings:

    These settings specify the "graphical" behavior of the Clarion
    environment in text mode.

[] Use Smooth Mouse Cursor

     Specifies that the arrow mouse cursor moves smoothly over
     the characters on screen.  When off, the arrow is one block
     character which moves over the screen one character at a
     time.  This sets the CLASMOOTH environment variable
     (contained in CLARION3.INI) to ON.

[] Use Graphical Fonts

     Specifies that the Clarion environment (in VGA text mode)
     uses an arrow mouse cursor, square check boxes, and
     circular radio buttons.  This replaces some of the ASCII
     characters with the arrow, square, and circle characters
     (see LOADSYMBOLS in the Language Reference).  This sets the
     CLAFONTS environment variable (contained in CLARION3.INI)
     to ON.

[] Graphical Intro. Screen

     Specifies that the Clarion environment opens with text-mode
     graphics displaying the Clarion logo.  The "Use Graphical
     Fonts" toggle must be turned on for this option to be valid.
     This sets the CLAINTRO environment variable (contained in
     CLARION3.INI) to ON.

<Month Names... Button>
Month Names... Button

     Calls the Update Month Names window to allow you to change
     the display text for each individual month name and its
     abbreviation.

<AM/PM Labels... Button>
AM/PM Labels... Button

     Calls the Update AM/PM Indicators Names window to allow you
     to change the display text for AM/PM indicators on fields
     with @T display pictures.

<Collating Seq... Button>
Collating Seq... Button

     Calls the Update Collating Sequence window to allow you to
     change the default soft order of ASCII characters.  This
     gives your application the ability to support the natural
     sort order of a language other than English.

<Character Case... Button>
Character Case... Button

     Calls the Update Character Case window to allow you to
     specify the subset of characters used for upper and lower
     case.  This gives your application the ability to support a
     language other than English.

<Graphics Mode... Button>
Graphics Mode... Button

     Calls the Graphics Mode Setup window, which allows you to
     specify the video driver used when the Clarion environment
     is started.

<Stop Window... Button>
Stop Window... Button

     Calls the STOP Window Setup window to allow you to specify
     the key used to activate the STOP window, and whether or not
     system-level information is accessible from that window.


<<Update Month Names/Abbreviations Window>>

The Update Month Names/Abbreviations window allows you to change the
text used to display month full names and abbreviations. This sets
the CLAMONTH and CLAMON environment variables (contained in
CLARION3.INI) to the values you specify.  Changes only take effect
after you re-start the Clarion Environment.

Each month's full name field on the window may be selected by
the ALT+ key in conjunction with its highlighted hot key.  Once
selected, you may change its display text.  When you change a
month full name and press TAB to move the cursor to the
corresponding abbreviation field, the abbreviation automatically
defaults to the first three characters of the month full name.

<Reset Default Button>
Reset Default Button

     Restores the pre-defined (English) month full names and
     abbreviations.


<<Update AM/PM Indicators Window>>

The Update AM/PM Indicator window allows you to change the text used
to indicate AM or PM as a part of a time display field. This sets
the CLAAMPM environment variable (contained in CLARION3.INI) to the
values you specify.  Changes only take effect after the Clarion
Environment is restarted.

<Reset Default Button>
Reset Default Button

     Restores the pre-defined (English) AM and PM indicators.


<<Update Collating Sequence Window>>

The Update Collating Sequence window allows you to change the
default sort order of ASCII characters 32 through 254 (inclusive),
excepting 127.  This gives your application the ability to support
the natural sort order of a language other than English. This sets
the CLACOLSEQ environment variable (contained in CLARION3.INI) to
the sequence you specify. Changes only take effect after the Clarion
Environment is restarted.

The Collating Sequence specified in the CLACOLSEQ environment
variable must be an exact length of 223 characters.  If the length
is incorrect, the default collating sequence will automatically be
loaded.  If you maintain the collating sequence through this window,
the length will always be correct. Therefore, changes to CLACOLSEQ
should NOT be made directly in the CLARION3.INI file.

<Char / Pos>
Char / Pos

     A list of the characters you may re-sequence and their
     current positions.

<Current:>
Current:

     Displays the selected character and its current numeric
     order.  The text field below "Current:" is a representation
     of the current collating sequence (in order).

<Move Character Up Button>
Move Character Up Button

     Moves the selected character up in the collating sequence.
     Grey Minus may also be used.

<Move Character Down Button>
Move Character Down Button

     Moves the selected character down in the collating sequence.
     Grey Plus may also be used.

<Reset Default Button>
Reset Default Button

     Restores the pre-defined (English) collating sequence.


<<Update Character Case Window>>

The Update Character Case window allows you to change the subset of
characters used for upper and lower case.  The two fields, Uppercase
and Lowercase, must be exactly the same length.  This sets the
CLACASE environment variable (contained in CLARION3.INI) to the
values you specify.  Changes only take effect after the Clarion
Environment is restarted.

<Uppercase:>
Uppercase:

     Allows you to specify the character subset used for upper
     case.  Must be the same length as Lowercase:.

<Lowercase:>
Lowercase:

     Allows you to specify the character subset used for lower
     case.  Must be the same length as Uppercase:.

<Reset Default Button>
Reset Default Button

     Restores the pre-defined (English) case assignments.


<<Graphics Mode Setup Window>>

The Graphics Mode Setup window allows you to specify the video
driver used when the Clarion environment is started.  This sets the
CLAGRAPH environment variable (contained in CLARION3.INI) to the
values you specify.  Changes only take effect after the Clarion
Environment is restarted.

<Default>
Default

     Allows the Clarion environment to determine the correct
     video driver to use.

<EGA>
EGA

     Forces use of the EGA video driver.

<VGA>
VGA

     Forces use of the VGA video driver.

<SVGA256>
SVGA256

     Forces use of the 256-color Super-VGA video driver.

<Always>
Always

     Forces the Clarion environment into graphics mode ALWAYS.

<Never>
Never

     NEVER allows the Clarion environment to go into graphics
     mode.


<<STOP Window Setup>>

The STOP Window Setup window allows you to specify the key used to
activate the Clarion STOP window, and whether or not system- level
information is accessible from that window.  This sets the CLASTOP
environment variable (contained in CLARION3.INI) to the values you
specify.  Changes only take effect after the Clarion Environment is
restarted.

<STOP Key:>
STOP Key:

     Select the ALT+ or CTRL+ keystroke sequence for the key that
     activates the Clarion STOP window.

<System-Level Information>
[] System-Level Information

     Turns on/off the ability to display system-level
     information when the Clarion STOP window is displayed.

<Reset Default Button>
Reset Default Button

     Restores the pre-defined settings for the Clarion STOP
     window (ALT+EQUAL and System-Level Information enabled).


<<Restart Requested Window>>

Certain system option settings (e.g. CLASTOP, CLAGRAPH, CLACOLLATE,
etc.) are loaded as the Clarion environment is started. Therefore,
if these system option settings have been changed (using the System
Options window), the environment must be restarted for your changes
to take effect.  To activate your new system settings, exit the
Clarion environment and restart.


<<Style File Window>>

The Style File window allows you to enter the name of the Style file
you want to edit.  The default value is CLARION.STY.  If you want to
edit another Style file, type in the name of the file (including the
extension) or delete CLARION.STY and press ENTER or CLICK on the Ok
Pushbutton.  When you complete the Ok Pushbutton without a name
entered, the Pick File window appears to allow you to select the
Styles file to edit.


<<Edit Style File Window>>

The Edit Style File window displays a list of the Color Styles
defined in the Style file (see Color Style Codes and GETSTYLES in
the Language Reference).  A description of each code is at the right
in the list.  The number displayed at the left is the internal array
element number to which the Color Style Code you choose is assigned
at runtime.  This is the number you use in all COLOR attributes of
your SCREEN and PULLDOWN structures.

<Insert and Change Buttons>
Insert and Change Buttons

     Calls the Edit Style window to allow you to specify the Color
     Style Codes associated with the Style currently highlighted in
     the list.

<Delete Button>
Delete Button

     Calls the Delete Style window to allow you to confirm that you
     want to delete the style from the list.


<Up and Down Buttons>
Up and Down Buttons

     Moves the currently highlighted Style up or down in the list.
     The internal array element numbers do not need to be listed in
     order in the file.  Therefore, you may order the Styles as you
     choose.

<Sort Button>
Sort Button

     Allows you to sort the Style file entries in either
     alphabetical order (by description), or numerical order.

<Color:>
Color:

     Displays the Color Style Code used for Color video for the
     currently highlighted Style.

<Mono:>
Mono:

     Displays the Color Style Code used for Monochrome video for the
     currently highlighted Style.


<<Select Color Window>>

The Select Color window displays a list of the Color Styles defined
in the Style file (see Color Style Codes and GETSTYLES in the
Language Reference) for your selection.  A description of each code
is at the right in the list.  The number displayed at the left is
the internal array element number to which the Color Style Code you
choose is assigned at runtime.  This is the number you use in all
COLOR attributes of your SCREEN and PULLDOWN structures.

<Select Button>
Select Button

     Press this button to use the currently highlighted Style.

<Cancel Button>
Cancel Button

     Press this button to abort without choosing a Style.

<Insert and Change Buttons>
Insert and Change Buttons

     Calls the Edit Style window to allow you to specify the Color
     Style Codes associated with the Style currently highlighted in
     the list.

<Delete Button>
Delete Button

     Calls the Delete Style window to allow you to confirm that you
     want to delete the style from the list.

<Up and Down Buttons>
Up and Down Buttons

     Moves the currently highlighted Style up or down in the list.
     The internal array element numbers do not need to be listed in
     order in the file.  Therefore, you may order the Styles as you
     choose.

<Sort Button>
Sort Button

     Allows you to sort the Style file entries in either
     alphabetical order (by description), or numerical order.

<Color:>
Color:

     Displays the Color Style Code used for Color video for the
     currently highlighted Style.

<Mono:>
Mono:

     Displays the Color Style Code used for Monochrome video for the
     currently highlighted Style.

<No Color Selection>
[] No Color Selection

     Check this box to eliminate the COLOR attribute and use
     whatever Color Style is associated with the area of the screen
     on which you are placing the field or literal text.

<Paint Transparent Area>
[] Paint Transparent Area

     Adds the TRN attribute to allow the underlying screen to "show
     through" at run time.


<<Select Color for Field Window>>

The Select Color for Field window displays the Color Styles selected
for the field.  A description of each color code is at the right in
the list.  The number displayed is the number placed in the COLOR
attribute of the field.

<Normal>
Normal

     Highlight this to change the Color Style Code for the field
     when it is displayed but not the current field for user entry.

<Selected>
Selected

     Highlight this to change the Color Style Code for the field
     when it is selected for user entry.

<Disabled>
Disabled

     Highlight this to change the Color Style Code for the field
     when it has been made unavailable for user entry with the
     DISABLE statement.

<Hot Normal>
Hot Normal

     Highlight this to change the Color Style Code for the field's
     "hot" letter when the field is displayed but not the current
     field for user entry.

<Hot Selected>
Hot Selected

     Highlight this to change the Color Style Code for the field's
     "hot" letter when the field is selected for user entry.

<No Color Selection>
[] No Color Selection

     Check this box to eliminate the COLOR attribute and use
     whatever Color Style is associated with the area of the screen
     on which you are placing the field.

<Foreground Color Only>
[] Foreground Color Only

     Adds the TRN attribute to the field. In Graphics mode, this
     allows the field to be placed over an IMAGE field, allowing the
     image to "show through" transparently.

<Insert and Change Buttons>
Insert and Change Buttons

     Calls the Edit Style window to allow you to specify the Color
     Style Codes associated with the Style currently highlighted in
     the list.


<<Edit Style Window>>

The Edit Style window allows you to change the Color Style Codes
defined for the Style.

<Style Code:>
Style Code:
     Enter the internal array element number and the description
     of the Style.  The internal array element number is the
     number that is used in the COLOR attribute in SCREEN and
     PULLDOWN structures.

<Color Code Button>
Color Code Button
     Calls the Select Color window to allow you to pick the
     Color Style Code assigned to the internal array element when
     a color video monitor is detected.  This Color Style Code
     determines the foreground/background color combination
     actually displayed when this Style is used in a SCREEN or
     PULLDOWN.

<Monochrome Button>
Monochrome Button

     Calls the Select Color window to allow you to pick the Color
     Style Code assigned to the internal array element when a
     monochrome video monitor is detected.  This Color Style Code
     determines the foreground/background color combination actually
     displayed when this Style is used in a SCREEN or PULLDOWN.


<<Delete Style Window>>

The Delete Style window allows you to remove a Style.  Press the
Ok button to delet, or Cancel to abort the deletion.


<<Sort Style Window>>

The Sort Style window allows you to change the display order of
the Color Style Codes in the Edit Style File Window.

<Numeric by Code>
() Numeric by Code

     When selected, the Styles appear in the order in which they are
     defined in the internal style codes array (see GETSTYLES in the
     Language Reference).

<Alphabetic by Name>
() Alphabetic by Name

     When selected, the Styles appear in the order of their
     description.


<<Select Color Attribute Window>>

The Select Color Attribute window allows you to pick a specific
foreground and background color combination from the palette of all
possible combinations.

<Enhanced/Blink Background>
[] Enhanced/Blink Background

     Toggle this ON to change the background colors to the enhanced
     background colors.  Enhanced background colors are available on
     EGA, VGA, and SVGA monitors when the SETNOBLINK statement has
     turned off video blinking.  If the SETBLINK statement is then
     issued, the background reverts to the un- enhanced color and
     the foreground blinks.

<No Color Selection>
[] No Color Selection

     Indicates that the field is displayed without a COLOR
     attribute.  Therefore, it takes the color of the SCREEN
     statement's COLOR attribute, or the color specified for its
     area of the screen by a PAINT statement.

<Paint Transparent Area>
[] Paint Transparent Area

     When painting an area on screen, this check box appends the TRN
     attribute to the PAINT statement.  This allows the existing
     text on screen to continue to be displayed, without being
     overwritten, in the PAINT color selected.

     When selecting a color for a field on screen, this check box
     appends the TRN attribute to the field.  In Graphics mode
     (only), this indicates the field is displayed (probably on top
     of a graphic image) in its foreground color only, allowing the
     existing background to show through.


<<Track Selection Window>>

The Track Selection window allows you to select your desired
tracking scheme or character.  A sample area displays the
currently-selected tracking selection.  When "Custom" tracking is
selected, you may use the arrow keys, HOME, END, and the mouse to
move a highlight box around the enabled custom track selection area.
 TAB and BACKTAB can be used to move from field-to-field, as well as
the mouse.

During tracking, the left mouse button and arrow keys may be
used to draw tracks.  The BACKSPACE, SHIFT+BACKSPACE, and right
mouse button are used for Undo functions.  If the SHIFT key is
held down while tracking, the cursor moves, but existing screen
characters will not be overwritten with tracks (nondestructive
tracking).

Note that since the screen library must remap certain characters
within the collating sequence to provide graphical symbols and a
smooth mouse, these fonts may interfere with tracking. Character
locations that are remapped for graphical symbols (fonts) are
displayed in the sample area and on the custom track selection area
as highlighted characters.  Likewise, smooth mouse character
locations appear as the letter "S" in a highlight color. While
tracking, these characters will be displayed as they are CURRENTLY
ASSIGNED, and the characters for smooth mouse (if enabled) are
assigned DYNAMICALLY.

If you wish to design screens that use these remapped characters,
but don't want them to be remapped while you are painting the
tracks, you may do so by going into:

         Clarion->System Setup->Options

Simply turn off Smooth Mouse and/or Graphical Fonts. However, to
prevent the remapped fonts from appearing in your completed
application, you must also provide an INI file with your application
program that includes the lines:

CLASMOOTH=OFF
CLAFONTS=OFF

<Track Style:>
Track Style:

     Select the desired tracking scheme. Using one of these scheme
     maintaing the correct connectors at track intersections and
     turns.  The Custom selection allows for a custom-defined
     tracking symbol.

() Single

     When selected, the single-line tracking scheme is used.

() Double

     When selected, the double-line tracking scheme is used.

() Mixed 1

     When selected, a mixed tracking scheme is used, with
     single-line vertical, and double-line horizontal tracks.

() Mixed 2

     When selected, a mixed tracking scheme is used, with
     single-line horizontal, and double-line vertical tracks.

() Block

     When selected, the full-block tracking scheme is used.

() Custom

     When selected, the custom track area (to the right) is
     enabled.  You may then select a track character using the
     highlight box.

<Color Button>
Color Button

     Allows you to change the display color used for tracks. This
     button is disabled in the Clarion Editor and Report Formatter.

<<Window Resize Utility>>

The screen formatter's Window Resize Utility allows you to change
the dimensions of an existing window, or change the window to full
screen.

Windows cannot be sized smaller than 1 by 1.  Any field spanned
by an edge will prevent any further contraction of that edge.

If the window has the CENTER attribute when entering window
resize, and the SCREEN you are designing is still a window when
you exit window resize, the window is centered again.

<...Data and ...Paint Effects>
...Data and ...Paint Effects

     When the ...Data toggle is off, borders will not be expanded
     as the window is resized.  When on, borders will be dragged.

     The ...Paint toggle has no effect unless the ...Data toggle
     is also on.  When both the ...Data and ...Paint toggles are
     on, paint will also be expanded when borders are expanded.


<Window Resize Keys:>
Window Resize Keys:

The keys you may use to resize the window are:

Mouse

     The mouse can be used to highlight or move edges.

UP

     The up arrow moves the top or bottom edge, or highlights the
     top edge if the currently highlighted edge is left or right.

DOWN

     The down arrow moves the top or bottom edge, or highlights
     the  bottom edge if the currently highlighted edge is left or
     right.

LEFT

     The left arrow moves the left or right edge, or highlights
     the left edge if the currently highlighted edge is top or
     bottom.

RIGHT

     The right arrow moves the left or right edge, or highlights
     the right edge if the currently highlighted edge is top or
     bottom.

HOME

     Highlights the left edge.

END

     Highlights the right edge.

PGUP

     Highlights the top edge.

PGDN

     Highlights the bottom edge.

GREYPLUS

     Expands the window one character in all four directions.

GREYMINUS

     Contracts the window one character in all four directions.

CTRL+W

     Toggles between window and full screen.

ENTER

     Saves the resize changes.

ESC

     Cancels the resize changes.


<<Error Window>>

The Error Window pops up whenever some error has occurred.  The
message should give you some indication of the problem.  If the
cause of the problem is not immediately evident, call TopSpeed
Technical Support at (305) 785-4556.  Be sure to have your Product
Registration number ready.  Also, it is a good idea to write down
the error message and the point at which it occurred before calling.


<<Set Field Defaults Window>>

The Set Field Defaults Window displays a list of everything which
may have a COLOR attribute.  This allows you to specify the default
colors for each SCREEN or PULLDOWN menu.

<Change Button>
Change Button

     Calls the Color Selection window to select the appropriate
     default colors for the currently highlighted item.


<<Keycode Lookup Window>>

The Keycode Lookup window displays a list of keycode EQUATEs from
the KEYCODES.EQU file, allowing you to select a keycode.

<Select Button>
Select Button

     Passes the currently highlighted keycode EQUATE back to the
     field from which the Keycode Lookup wiundow was called.

<<Session Backup File Warning Window>>
<Session Back-up File>

A "Session Back-up" file is created upon loading an existing
application, or dictionary file. The session back-up file represents
a snap-shot of the file upon entry to the session.

<Clarion Control Files>

The following file extensions are utilized by the Clarion
environment for storage and back-up control:

                       Current   Session Back-up   Back-up
                       -------   ---------------   -------
  Application File      .APP         .A$$           .BPP
  Dictionary File       .DCT         .D$$           .BCT


*ALL UPDATE ACTIVITY DURING A SESSION OCCURS TO THE CURRENT FILE.*


Upon normal termination when changes are saved, the session
back-up file is renamed to the back-up file and the current file
is closed.  If changes are not saved then the session back-up
file is renamed to the current file and the back-up file remains
the same.

The session back-up file should not exist after normal
termination from any session.  Upon entry to a session, if the
session back-up file already exists then there is a good chance
a prior session may have terminated abnormally.

If a session back-up file is detected, you are presented with
the following options from the Session Backup File Warning
window:

<Close Button>
Close Button

   Press this button to exit the session immediately without
   changing any of the existing files.  This is the recommended
   option.

   By selecting this option, you can back out of the session and
   take more extensive recovery actions.  It is recommended that
   you save copies of all existing files (the current, session
   back-up, and back-up files), outside of the working
   directory, prior to starting a new session.

<Rename Button>
Rename Button

   Press this button to access the Rename Session Backup File
   Window which enables you to rename the found session back-up
   file to another name prior to continuing.

   After renaming the existing session back-up file, the system
   will continue by creating a new session back-up file for the
   current session.

<Delete Button>
Delete Button

   Press this button to delete the found session back-up file
   and continue.  This option is not recommended.  It should only
   be used if you are confident in the current file's integrity.

   After deleting the existing session back-up file, the system
   will continue by creating a new session back-up file for the
   current session.

<<Rename Session Backup File Window>>

This dialog enables you to rename the found session back-up file
to another name prior to continuing. The found session back-up
file name is displayed at the top of the dialog.

<To Field:>
To Field:

   Enter the rename file specification in this entry field. The
   file specification cannot be the name of an existing file.

   You may include both drive and path in the specification.

<Ok Button>
Ok Button

   Press this button to rename the session back-up file to the
   entered file specification and continue.

<Cancel Button>
Cancel Button

   Press this button to cancel the rename dialog and return to
   the Session Backup File Warning window.

<<Message Window>>
Message Window

The Clarion IDE displays a message in this window to inform you
of a change in settings or report an error condition.
