<<Welcome to Clarion Database Developer>>

Welcome to Clarion Database Developer!!

Clarion Database Developer 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 Database Developer 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 and .GIF) can be displayed on text
     screens (an exact likeness of the text screen is
     automatically re-painted in graphics mode).

    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 Database Developer 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 Database Developer 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
     Press the Topics button
     Highlight the desired Topic
     Press Enter

<Help Text Files>
Each major functional area of the Clarion Database Developer
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 Button>
The Topics button 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, Report, 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, Report,
     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 essay in the Programmer'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.COM).

<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 four 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 four 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 four 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 four 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 Report...>
Load Report...                            ( F7 or ALT-C R )
     Allows you to select one of the last four Report Definition
     files in which you worked, or to create or open a Report
     Definition file not on the task list.  This selection takes
     you directly into the Report Writer with the selected file
     loaded.  SHIFT-F7 immediately loads the last Report on which
     you worked.

<Load Text...>
Load Text...                              ( F8 or ALT-C T )
     Allows you to select one of the last four 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 four 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).

<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 Clarion Software (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
     essay in the Programmer'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 essay in the Programmer'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 Database Developer 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 Database
     Developer.


<<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 Database Developer.

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.

<Report>
() Report
     Creates a new .RWF file and takes you into the Report Writer.
     The Report Writer is a functional area in which you define
     run-time Reports (reports which are not part of a specific
     application).  Specify only the filename (without extension)
     in the Filename field, the .RWF extension is automatically
     appended.

<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,
     Report, 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.

<Report>
() Report
     Opens an existing .RWF file and takes you into the Report
     Writer.  The Report Writer is a functional area in which you
     define run-time Reports (reports which are not part of a
     specific application).

<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 essay on Project and
Redirection Files in the Programmer'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 essay on Overlays and Dynamic
     Link Libraries (DLLs) in the Programmer'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 Clarion Software.  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 Database Developer 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 CDD 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 Clarion Software at an additional
    cost.  Call Clarion Software at 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 Programmer'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--see the essay on Project and Redirection
     Files in the Programmer's Guide).

<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 Programmer'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 Database Developer 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 Programmer'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.

The biggest 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.

Another major benefit to programmers 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 essay on Screen Color
Schemes in the Programmer'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 four
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 Database Developer 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
     Database Developer 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:
     Name the printer control file you want the Clarion Database
     Developer 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).

<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 and 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 Clarion
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, dictionary, or report writer 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
  Report Writer File    .RWF         .R$$           .BWF


*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:

<Exit Button>
Exit 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.


