
<<Text Editor General Information>>

The Clarion Text Editor is a full-featured programmer's editor,
with all the functions necessary to make writing source code as
easy as possible.  The Text Editor is another "core" area of
Clarion for DOS.  It is the tool you use to write the
Clarion language source code to customize your Application
Generator application, or to write your application "from
scratch."  Your screens and reports may also be designed through
the Text Editor's interfaces to the screen and report
formatters.

You may edit as many as nine separate source files at once, with
the ability to "cut and paste" between the files.  Each file is
kept in a separate edit window, numbered from one to nine.
Navigating between the edit windows may be done several ways.
The simplest way is to press the ALT+1 through ALT+9 keys. These
ALT keys take you automatically to the edit window, with the
opportunity to load a file if the edit window has no file
loaded.

Although nine files may be simultaneously open, only one is
currently active.  The currently active edit window is
identified by the blue border and the presence of the cursor;
the border color of an inactive edit window is gray.  An edit
window is activated several ways, one being a mouse CLICK
anywhere within its borders.


<<Clarion Language Statement Syntax>>

<Program Source Code Format>
Program Module Source Code Format:

     PROGRAM
     [ MAP
         procedure and/or function prototypes
       [ MODULE('sourcefile')
           procedure and/or function prototypes
         END ]
       END ]
global data declarations
     CODE
     executable statements
     [RETURN]
procedures or functions


<Source Module Source Code Format:>
Source Module Source Code Format:

  MEMBER('program')
  [ MAP
      procedure and/or function prototypes
    [ MODULE('sourcefile')
        procedure and/or function prototypes
      END ]
    END ]

data declarations local to the module
procedures or functions


<Procedure Source Code Format:>
Procedure Source Code Format:

label          PROCEDURE [(parameter list)]
data declarations local to the procedure
               CODE
               executable statements
               [RETURN]

[label         ROUTINE
               executable statements
               [EXIT]]


<Function Source Code Format:>
Function Source Code Format:

label          FUNCTION [(parameter list)]
data declarations local to the function
               CODE
               executable statements
               RETURN(value)

[label         ROUTINE
               executable statements
               [EXIT]]


<Compiler Directives:>
Compiler Directives:

               BEGIN
                 executable statements
               END

               EMBED('string')
                 embedded source code statements
               ENDEMBED

               COMPILE('terminator')
               COMPILE('terminator',expression)
               EJECT
               EJECT('module subtitle')
               INCLUDE('filename') [,LIST]
               INCLUDE('filename','section') [,LIST]
               OMIT('terminator')
               OMIT('terminator',expression)
               SECTION('string')
               SUBTITLE('module subtitle')
               TITLE('module title')
label          EQUATE(label)
label          EQUATE(constant)
label          EQUATE(picture)
               SIZE(label)
               SIZE(constant)
               SIZE(picture)


<Currency Picture Tokens:>
Currency Picture Tokens:

A currency indicator is either a dollar sign ($) or a character
string enclosed in tildes (~).   The currency indicator must be
either the first or last indicator (except for the B indicator -
blank when zero) in a numeric picture.  If the currency
indicator is first, the currency symbol "floats" immediately to
the left of the high order digit of the number.

             @N$9.2         produces       $4,550.75
             @N~DM~10`2     produces      DM4.550,75
             @N11`2~KR~     produces      4.550,75KR
             @N$(11.2)      produces     $(4,550.75)
             @N~~(11.2)    produces     (4,550.75)


<Date Picture Tokens>
Date Picture Tokens

Date picture tokens begin with an @D followed by a type
specification and an optional separator.

     @D1 mm/dd/yy         (5/22/88)
     @D2 mm/dd/yyyy       (5/22/1988)
     @D3 mmm dd,yyyy      (MAY 22,1988)
     @D4 mmmmmmmm dd,yyyy (May 22,1988)
     @D5 dd/mm/yy         (22/05/88)
     @D6 dd/mm/yyyy       (22/05/1988)
     @D7 dd mmm yy        (22 MAY 88)
     @D8 dd mmm yyyy      (22 MAY 1988)
     @D9  yy/mm/dd        (88/05/22)
     @D10 yyyy/mm/dd      (1988/05/22)
     @D11 yymmdd          (880522)
     @D12 yyyymmdd        (19880522)
     @D13 mm/yy           (5/88)
     @D14 mm/yyyy         (5/1992)
     @D15 yy/mm           (92/05)
     @D16 yyyy/mm         (1992/05)

@Dns for n = 1 or 2, and s = (.), (-), (`), or (_):

     @Dn. 1 = (5.22.88)  2 = (5.22.1988)
     @Dn` 1 = (5,22,88)  2 = (5,22,1988)
     @Dn- 1 = (5-22-88)  2 = (5-22-1988)
     @Dn_ 1 = (5 22 88)  2 = (5 22 1988)


<Formatted Picture Tokens>
Formatted Picture Tokens

A formatted picture is a "do-it-yourself" picture for an
integer.  The picture token for a formatted picture consists of
@P, followed by a picture format, followed by P.  The picture
format is a character string which contains < or # in the
positions that the integer is to occupy.  Any character other
than < or # is considered an edit character and appears in the
final picture string.  The < means "print the high order zero as
a space," and # means "print the high order zero as a zero."  An
upper case P can be included in a picture format by using lower
case p delimiters (for example, @p<#:##PMp).  Likewise, a lower
case p can be included in a picture format by using upper case
P delimiters.

     Picture                Value                Result

     @P###-##-####P         246732453            246-73-2453
     @p#' <#"p              511                  5' 11"
     @P<#lb. <#oz.P         902                  9lb. 2oz.
     @p4##A-#p              112                  411A-2
     @P###-####P            6726441              672-6441


<Scientific Picture Tokens:>
Scientific Picture Tokens:

Scientific notation formatting uses the form @Em.n with m
characters and n places to the left of the decimal point.  The
leading character of the field is always reserved for a minus
sign if needed.

     Picture         Value               Result

     @E9.0           1,967,865           .20e+007
     @E12.1         ,967,865           1.9679e+006
     @E12.1         -1,967,865          -1.9679e+006
     @E12.1         .000000032           3.2000e-008
     @E12.1B         0


<Time Picture Tokens:>
Time Picture Tokens:

Time picture tokens begin with an @T followed by a type
specification and an optional connector.

     @T1 hh:mm        (14:30)
     @T2 hhmm         (1430)
     @T3 hh:mmxM      ( 2:30PM)
     @T4 hh:mm:ss     (14:30:15)
     @T5 hhmmss       (143015)
     @T6 hh:mm:ssXM   ( 2:30:15PM)

@Tnc for n = 1 to 6 and c as a connector:

@Tn.     time format n using period as connector 1 = (14.30)
@Tn-     time format n using dash as connector   4 = (14-30-15)
@Tn`     time format n using comma as connector  1 = (14,30)
@Tn_     time format n using space as connector  4 = (14 30 15)


<Numeric Picture Tokens:>
Numeric Picture Tokens:

Numeric                  Result

@N9                    4,550,000
@N_9B                    4550000
@N09                   004550000
@N*9                   ***45,000
@N9_                   4 550 000
@N9.                   4.550.000
@N9.2                   4,550.75
@N_9.2B                  4550.75
@N_9`2                   4550,75
@N9.`2                  4.550,75
@N9_`2                  4 550,75
@N-9.2B                -2,347.25
@N9.2-                  2,347.25-
@N(10.2)               (2,347.25)


<Key-in Template Pictures:>
Key-in Template Pictures:

All key-in template pictures begin with the @K delimiter and end
with the K delimiter.  The case of the delimiters must be the
same.  Key-in pictures may contain integer positions ( # < ),
alphabet character positions ( @ ^ _ ), any character positions
( ? ), and display characters.  Any character other than a
formatting indicator is considered a display character, which
appears in the formatted picture string.  The @K and K
delimiters are case sensitive.  Therefore, an upper case "K" may
be included as a display character if the delimiters are both
lower case "k" and vice-versa.

Key-in pictures are used specifically with STRING, PSTRING, and
CSTRING screen ENTRY fields to allow custom field editing
control and validation.  Using a key-in picture containing any
of the alphabet indicators ( @ ^ _ ) on a numeric entry field
produces unpredictable results.

Picture              Value Entered            Result String

@K###-##-####K           215846377              215-84-6377
@K####|-####K                33064               33064
@K####|-####K            330643597               33064-3597
@K<# ^^^ ##K               10AUG59                10 AUG 59
@K(###)@@@-##\@##K      305abc4555            (305)abc-45@55
@K###/?##-####K            7854555             000/785-4555
@k<#:##^Mk                    530P                   5:30PM
@K<#' <#"K                     506                   5'  6"
@K4#_#A-#K                    1g12                   41g1A-2


<Assignment Statements:>
Assignment Statements:

     variable  = expression
     variable += expression
     variable -= expression
     variable *= expression
     variable /= expression
     variable ^= expression
     variable %= expression
     CLEAR(variable)
     CLEAR(variable,1)
     CLEAR(variable,-1)


<Program Control Structures:>
Program Control Structures:

     CASE condition
     OF expression [TO expression]
     [OROF expression] [TO expression]
       executable statements
     [ELSE]
       executable statements
     END

     EXECUTE expression
       executable statement 1
       executable statement 2
       [BEGIN
         executable statements
       END]
       executable statement n
     END

     IF logical expression THEN statement.
     IF logical expression THEN statement ELSE statement.

     IF logical expression [THEN]
       executable statements
     [ELSIF logical expression] [THEN]
       executable statements
     [ELSE]
       executable statements
     END

     LOOP
       executable statements
     END

     LOOP count TIMES
       executable statements
     END

     LOOP i = initial TO limit [BY step]
       executable statements
     END

     LOOP UNTIL logical expression
       executable statements
     END

     LOOP WHILE logical expression
       executable statements
     END


<Program Control Statements:>
Program Control Statements:

     BREAK
     CHAIN(program)
     CYCLE
     DO label
     EXIT
     GOTO label
     HALT
     HALT(errorlevel)
     HALT(errorlevel,message)
     NOTIFY(procedure,event)
     RESTART
     RESTART(procedure)
     RETURN
     RETURN(expression)
     RUN(command)
     RUN(command,screen save)
     RUN(command,screen save,pause message)
     RUNSMALL(command)
     RUNSMALL(command,screen save)
     RUNSMALL(command,screen save,pause message)
     SHUTDOWN
     SHUTDOWN(procedure)
     STOP
     STOP(message)


<Video Procedures:>
Video Procedures:

     BLANK
     BLANK(row,column,rows,columns)
     PAINT
     PAINT(row,column,rows,columns)
     SCROLL
     SCROLL(row,column,rows,columns,count)
     SETBLINK
     SETCOLOR(color)
     SETCURSOR
     SETCURSOR(row,column)
     SETGRAPHIC(mode)
     SETMOUSE
     SETMOUSE(row,column)
     SETNOBLINK
     SETTEXT(rows,columns)
     SHOW( [row] , [column] ,expression [,picture])
     TYPE(string)


<Video Functions:>
Video Functions

     BACKCOLOR(row,column)
     COLOR(row,column)
     FORECOLOR(row,column)
     GRAPHIC(n)
     LOOK(row,column,picture)
     MAKECOLOR(foreground,background)
     MOUSECOL( )
     MOUSEROW( )


<Keyboard Procedures:>
Keyboard Procedures:

     ALIAS
     ALIAS(keycode,new-keycode)
     ASK
     PRESS(keycode)
     PRESS(string)
     SETKEYCODE(keycode)


<Keyboard Functions:>
Keyboard Functions:

     ENTRY(row,column,picture)
     KEYBOARD( )
     KEYCODE( )


<Screen Procedures:>
Screen Procedures:

     ACCEPT
     ALERT
     ALERT(keycode)
     ALERT(first-keycode,last-keycode)
     BEEP
     BEEP(frequency,duration)
     CLOSE(label)
     DISABLE(field)
     DISABLE(first field,last field)
     DISPLAY
     DISPLAY(field)
     DISPLAY(first field,last field)
     ENABLE(field)
     ENABLE(first field,last field)
     ERASE
     ERASE(field)
     ERASE(first field,last field)
     GETSTYLES
     GETSTYLES(file)
     HELP
     HELP(helpfile)
     HELP(helpfile,window-id)
     IDLE
     IDLE(procedure)
     IDLE(procedure,separation)
     LOADBORDER
     LOADBORDER(string)
     LOADSYMBOLS
     LOADSYMBOLS(string)
     OPEN(screen label)
     OPEN(pulldown label)
     OPEN(pulldown label,value)
     SELECT
     SELECT(field)
     SELECT(field,cursor position)
     SETAREA(rows,columns)
     SETMSG(row,col,length [,color])
     SETSTYLES(program array)
     SHOWIMAGE(row,col, [rows] , [cols] ,file,usepal)
     UPDATE
     UPDATE(field)
     UPDATE(first field,last field)
     USESYMBOLS
     USESYMBOLS(string)


<Screen Functions:>
Screen Functions:

     CHOICE( )
     CHOICE(field)
     COL(screen)
     COL(field)
     COL(variable)
     COLS(screen)
     COLS(field)
     COLS(variable)
     CONTENTS(field)
     FIELD( )
     FIELDS( )
     REFER( )
     ROW(screen)
     ROW(field)
     ROW(variable)
     ROWS(screen)
     ROWS(field)
     ROWS(variable)
     SELECTED( )
     STYLES( )


<Report Procedures:>
Report Procedures:

     OPEN(report)
     CLOSE(report)
     PRINT(structure)
     PRINT(string)


<Report Functions:>
Report Functions:

     ROWS(print structure)


<Data File Access Procedures:>
Data File Access Procedures:

     BUILD(file)
     BUILD(key)
     BUILD(index)
     BUILD(index,components)
     CLOSE(file)
     COPY(file label,new filename)
     CREATE(file)
     EMPTY(file)
     FLUSH(file)
     LOCK(file)
     LOCK(file,seconds)
     OPEN(file)
     OPEN(file,access mode)
     PACK(file)
     REMOVE(file)
     RENAME(file label,new filename)
     SHARE(file)
     SHARE(file,access mode)
     STREAM(file)
     UNLOCK(file)


<Data Record Access Procedures:>
Data Record Access Procedures:

     ADD(file)
     ADD(file,length)
     APPEND(file)
     APPEND(file,length)
     DELETE(file)
     GET(file,key)
     GET(file,filepointer)
     GET(file,filepointer,length)
     GET(key,keypointer)
     HOLD(file)
     HOLD(file,seconds)
     NEXT(file)
     PREVIOUS(file)
     PUT(file)
     PUT(file,filepointer)
     PUT(file,filepointer,length)
     RELEASE(file)
     RESET(sequence,position string)
     SET(file)
     SET(file,key)
     SET(file,filepointer)
     SET(key)
     SET(key,key)
     SET(key,keypointer)
     SET(key,key,filepointer)
     SKIP(file,count)


<Data File Functions:>
Data File Functions:

     BOF(file)
     BYTES(file)
     DUPLICATE(key)
     DUPLICATE(file)
     EOF(file)
     POINTER(file)
     POINTER(key)
     POSITION(sequence)
     RECORDS(file)
     RECORDS(key)
     SEND(file,message)
     COMMIT
     LOGOUT(timeout ,file [,file,...,file])
     ROLLBACK


<Memory Queue Procedures:>
Memory Queue Procedures:

     ADD(queue)
     ADD(queue,pointer)
     ADD(queue,[+]key,...,[-]key)
     ADD(queue,name string)
     DELETE(queue)
     FREE(queue)
     GET(queue,pointer)
     GET(queue,[+]key,...,[-]key)
     GET(queue,name string)
     PUT(queue,[+]key,...,[-]key)
     PUT(queue,name string)
     SORT(queue,[+]key,...,[-]key)
     SORT(queue,name string)


<Memory Queue Functions:>
Memory Queue Functions:

     POINTER(queue)
     RECORDS(queue)


<Mathematical Functions:>
Mathematical Functions:

     ABS(expression)
     INRANGE(expression,low,high)
     INT(expression)
     LOGE(expression)
     LOG10(expression)
     RANDOM(low,high)
     ROUND(expression,order)
     SQRT(expression)
     SIN(radians)
     COS(radians)
     TAN(radians)
     ASIN(expression)
     ACOS(expression)
     ATAN(expression)


<String Functions:>
String Functions:

     ALL(string)
     ALL(string,length)
     CENTER(string)
     CENTER(string,length)
     CHR(code)
     CLIP(string)
     DEFORMAT(string,picture)
     FORMAT(value,picture)
     INSTRING(substring,string [,step] [,start])
     LEFT(string)
     LEFT(string,length)
     LEN(string)
     LOWER(string)
     NUMERIC(string)
     RIGHT(string)
     RIGHT(string,length)
     SUB(string,position,length)
     UPPER(string)
     VAL(character)


<Bitwise Functions:>
Bitwise Functions:

     BAND(value,mask)
     BOR(value,mask)
     BXOR(value,mask)
     BSHIFT(value,count)


<Time Procedures and Functions:>
Time Procedures and Functions:

     TODAY( )
     SETTODAY(date)
     CLOCK( )
     SETCLOCK(time)
     DATE(month,day,year)
     DAY(date)
     MONTH(date)
     YEAR(date)
     AGE(birthdate)
     AGE(birthdate,base date)


<DOS Procedures and Functions:>
DOS Procedures and Functions:

     COMMAND(flag)
     COMMAND(flag,operation)
     MEMORY( )
     MEMORY(n)
     PATH( )
     RUNCODE( )
     SETCOMMAND(commandline)
     SETPATH(drive and path)


<Miscellaneous Procedures and Functions:>
Miscellaneous Procedures and Functions:

     ADDRESS(variable)
     ADDRESS(segment,offset)
     ERROR( )
     ERRORCODE( )
     ERRORFILE( )
     IN(port,input)
     MAXIMUM(variable,subscript)
     NAME(label)
     OMITTED(position)
     OUT(port,output)
     PEEK(segment:offset,destination)
     POKE(segment:offset,source)
     STATUS(printer port)
     STATUS(drive letter)
     STATUS(file label)
     STATUS(keyboard)


<Alphabetical List of Executable Statements:>
Alphabetical List of Executable Statements:

     ABS(expression)
     ACCEPT
     ACOS(expression)
     ADD(file)
     ADD(file,length)
     ADD(queue)
     ADD(queue,name string)
     ADD(queue,pointer)
     ADD(queue,[+]key,...,[-]key)
     ADDRESS(segment,offset)
     ADDRESS(variable)
     AGE(birthdate)
     AGE(birthdate,base date)
     ALERT
     ALERT(first-keycode,last-keycode)
     ALERT(keycode)
     ALIAS
     ALIAS(keycode,new-keycode)
     ALL(string)
     ALL(string,length)
     APPEND(file)
     APPEND(file,length)
     ASIN(expression)
     ASK
     ATAN(expression)
     BACKCOLOR(row,column)
     BAND(value,mask)
     BEEP
     BEEP(frequency,duration)
     BLANK
     BLANK(row,column,rows,columns)
     BOF(file)
     BOR(value,mask)
     BREAK
     BSHIFT(value,count)
     BUILD(file)
     BUILD(index)
     BUILD(index,components)
     BUILD(key)
     BXOR(value,mask)
     BYTES(file)
     CENTER(string)
     CENTER(string,length)
     CHAIN(program)
     CHOICE( )
     CHOICE(field)
     CHR(code)
     CLEAR(variable)
     CLEAR(variable,-1)
     CLEAR(variable,1)
     CLIP(string)
     CLOCK( )
     CLOSE(file)
     CLOSE(label)
     CLOSE(report)
     COL(field)
     COL(screen)
     COL(variable)
     COLOR(row,column)
     COLS(field)
     COLS(screen)
     COLS(variable)
     COMMAND(flag)
     COMMAND(flag,operation)
     COMMIT
     CONTENTS(field)
     COPY(file label,new filename)
     COS(radians)
     CREATE(file)
     CYCLE
     DATE(month,day,year)
     DAY(date)
     DEFORMAT(string,picture)
     DELETE(file)
     DELETE(queue)
     DISABLE(field)
     DISABLE(first field,last field)
     DISPLAY
     DISPLAY(field)
     DISPLAY(first field,last field)
     DO label
     DUPLICATE(file)
     DUPLICATE(key)
     EMPTY(file)
     ENABLE(field)
     ENABLE(first field,last field)
     ENTRY(row,column,picture)
     EOF(file)
     ERASE
     ERASE(field)
     ERASE(first field,last field)
     ERROR( )
     ERRORCODE( )
     ERRORFILE( )
     EXIT
     FIELD( )
     FIELDS( )
     FLUSH(file)
     FORECOLOR(row,column)
     FORMAT(value,picture)
     FREE(queue)
     GET(file,filepointer,length)
     GET(file,filepointer)
     GET(file,key)
     GET(key,keypointer)
     GET(queue,name string)
     GET(queue,pointer)
     GET(queue,[+]key,...,[-]key)
     GETSTYLES
     GETSTYLES(file)
     GOTO label
     GRAPHIC(n)
     HALT
     HALT(errorlevel)
     HALT(errorlevel,message)
     HELP
     HELP(helpfile)
     HELP(helpfile,window-id)
     HOLD(file)
     HOLD(file,seconds)
     IDLE
     IDLE(procedure)
     IDLE(procedure,separation)
     IN(port,input)
     INRANGE(expression,low,high)
     INSTRING(substring,string [,step] [,start])
     INT(expression)
     KEYBOARD( )
     KEYCODE( )
     LEFT(string)
     LEFT(string,length)
     LEN(string)
     LOADBORDER
     LOADBORDER(string)
     LOADSYMBOLS
     LOADSYMBOLS(string)
     LOCK(file)
     LOCK(file,seconds)
     LOG10(expression)
     LOGE(expression)
     LOGOUT(timeout ,file [,file,...,file])
     LOOK(row,column,picture)
     LOWER(string)
     MAKECOLOR(foreground,background)
     MAXIMUM(variable,subscript)
     MEMORY( )
     MEMORY(n)
     MONTH(date)
     MOUSECOL( )
     MOUSEROW( )
     NAME(label)
     NEXT(file)
     NOTIFY(procedure,event)
     NUMERIC(string)
     OMITTED(position)
     OPEN(file)
     OPEN(file,access mode)
     OPEN(pulldown label,value)
     OPEN(pulldown label)
     OPEN(report)
     OPEN(screen label)
     OUT(port,output)
     PACK(file)
     PAINT
     PAINT(row,column,rows,columns)
     PATH( )
     PEEK(segment:offset,destination)
     POINTER(file)
     POINTER(key)
     POINTER(queue)
     POKE(segment:offset,source)
     POSITION(sequence)
     PRESS(keycode)
     PRESS(string)
     PREVIOUS(file)
     PRINT(string)
     PRINT(structure)
     PUT(file)
     PUT(file,filepointer)
     PUT(file,filepointer,length)
     PUT(queue,name string)
     PUT(queue,[+]key,...,[-]key)
     RANDOM(low,high)
     RECORDS(file)
     RECORDS(key)
     RECORDS(queue)
     REFER( )
     RELEASE(file)
     REMOVE(file)
     RENAME(file label,new filename)
     RESET(sequence,position string)
     RESTART
     RESTART(procedure)
     RETURN
     RETURN(expression)
     RIGHT(string)
     RIGHT(string,length)
     ROLLBACK
     ROUND(expression,order)
     ROW(field)
     ROW(screen)
     ROW(variable)
     ROWS(field)
     ROWS(print structure)
     ROWS(screen)
     ROWS(variable)
     RUN(command)
     RUN(command,screen save,pause message)
     RUN(command,screen save)
     RUNCODE( )
     RUNSMALL(command)
     RUNSMALL(command,screen save,pause message)
     RUNSMALL(command,screen save)
     SCROLL
     SCROLL(row,column,rows,columns,count)
     SELECT
     SELECT(field)
     SELECT(field,cursor position)
     SELECTED( )
     SEND(file,message)
     SET(file)
     SET(file,filepointer)
     SET(file,key)
     SET(key)
     SET(key,key)
     SET(key,key,filepointer)
     SET(key,keypointer)
     SETAREA(rows,columns)
     SETBLINK
     SETCLOCK(time)
     SETCOLOR(color)
     SETCOMMAND(commandline)
     SETCURSOR
     SETCURSOR(row,column)
     SETGRAPHIC(mode)
     SETKEYCODE(keycode)
     SETMOUSE
     SETMOUSE(row,column)
     SETMSG(row,col,length [,color])
     SETNOBLINK
     SETPATH(drive and path)
     SETSTYLES(program array)
     SETTEXT(rows,columns)
     SETTODAY(date)
     SHARE(file)
     SHARE(file,access mode)
     SHOW([row],[column] ,expression [,picture])
     SHOWIMAGE(row,col,[rows],[cols],file,usepal)
     SHUTDOWN
     SHUTDOWN(procedure)
     SIN(radians)
     SKIP(file,count)
     SORT(queue,name string)
     SORT(queue,[+]key,...,[-]key)
     SQRT(expression)
     STATUS(drive letter)
     STATUS(file label)
     STATUS(keyboard)
     STATUS(printer port)
     STOP
     STOP(message)
     STREAM(file)
     STYLES( )
     SUB(string,position,length)
     TAN(radians)
     TODAY( )
     TYPE(string)
     UNLOCK(file)
     UPDATE
     UPDATE(field)
     UPDATE(first field,last field)
     UPPER(string)
     USESYMBOLS
     USESYMBOLS(string)
     VAL(character)
     YEAR(date)


<<File Menu>>

The File menu contains selections for the normal file operations
of the Text Editor.

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

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

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

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

<Close>
Close                                               ( ALT+F C )

     Closes the open Text file in the currently active edit
     window.  Since you may have up to nine files open
     simultaneously, Close exits the Text Editor and returns you
     to the Clarion opening screen only when you close the last
     open Text file.  You may also close the currently active edit
     window with a mouse CLICK on the top left corner of the edit
     window (on the  character).

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

<Save>
Save                                                ( ALT+F S )

     Saves the open Text file without closing the file or exiting
     the Text Editor.

<Save As... >
Save As...                                          ( ALT+F A )

     Saves the open Text file to the new name you specify, leaving
     you in the new file.  This allows you to copy an entire Text
     file to a new name, then immediately modify the new file.

<Save All >
Save All                                            ( ALT+F L )

     Saves all open Text files without closing the files or
     exiting the Text Editor.

<Auto Save...>
Auto Save...                                        ( ALT+F A )

     Automatically saves the files in all open edit windows to
     "auto-save" files (your file's filename with an .ASV
     extension).  In case of system crash while editing, when you
     restore the system and return to the Text Editor these "auto-
     save" files are detected.  You are then given the opportunity
     to restore your files.

<Import>
Import                                              ( ALT+F I )

     Calls a sub-menu which allows you to import another Text
     file, or file declarations from a Database Dictionary.

<Text>
Text

     Import the entire contents of another text file into the
     current file.

<File Structure>
File Structure

     Import data FILE declaration source code for one (or all)
     file(s) in a Database Dictionary.

<Export>
Export                                              ( ALT+F E )

     Write a block of text to the file you specify.  If the file
     exists, the block is appended to the existing file.

<Print File>
Print File                                          ( ALT+F P )

     Prints the Text file in the currently active edit window to
     the printer specified in the Printer Setup... selection.

<Print Block>
Print Block                                         ( ALT+F B )

     Prints a block of text from in the currently active edit
     window to the printer specified in the Printer Setup...
     selection.

<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 )

     Closes all open Text files, offering the opportunity to save
     any changes, and returns you to the Clarion opening screen.


<<Edit Menu>>

The Edit menu contains selections which allow you to maintain
the text within the Text file.

<Undo>
Undo                                      ( CTRL+U or ALT+E U )

     Restore the text previously deleted by the Delete menu
     selection.

<Copy>
Copy                                      ( CTRL+C or ALT+E C )

     Copy existing text to the same or another file.

<Move>
Move                                      ( CTRL+M or ALT+E M )

     Move existing text to another position in the same or another
     file.

<Delete>
Delete                                    ( CTRL+D or ALT+E D )

     Remove text from the file.

<Mark Block>
Mark Block                                ( CTRL+B or ALT+E B )

     Marks a block to Copy, Move, Delete, Search, Replace, Export,
     or Print Block.

<Full Line Mode>
Full Line Mode                            ( CTRL+L or ALT+E L )

     Toggles between Line and Character modes for Copy, Move, or
     Delete.  This selection is a toggle switch with a check mark
     () displayed when toggled ON (Line mode).

<Draw Track>
Draw Track                                ( CTRL+T or ALT+E T )

     Place tracking characters in your text file.

<Format>
Format                                    ( CTRL+F or ALT+E F )

     Displays a sub-menu which allows you to call the Screen,
     Report, or Pulldown Menu Formatter to create or maintain a
     SCREEN, REPORT or PULLDOWN data structure.

     The sub-menu also contains a Field selection which allows you
     to look up a field label from a database dictionary and insert
     it into your source code.

<Screen>
Screen                                ( CTRL+F S or ALT+E F S )

     Calls the Screen Formatter to create or maintain a SCREEN
     data structure.  When the cursor is placed directly on the
     SCREEN statement, the existing data structure is brought into
     the formatter for maintenance.  If the cursor is not directly
     on the SCREEN statement, a new data structure is created.

<Report>
Report                                ( CTRL+F R or ALT+E F R )

     Calls the Report Formatter to create or maintain a REPORT
     data structure.  When the cursor is placed directly on the
     REPORT statement, the existing data structure is brought into
     the formatter for maintenance.  If the cursor is not directly
     on the REPORT statement, a new data structure is created.

<Pulldown>
Pulldown                              ( CTRL+F P or ALT+E F P )

     Calls the Pulldown Menu Formatter to create or maintain a
     PULLDOWN data structure.  When the cursor is placed directly
     on the PULLDOWN statement, the existing data structure is
     brought into the formatter for maintenance.  If the cursor is
     not directly on the PULLDOWN statement, a new data structure
     is created.

<Duplicate>
Duplicate                                           ( ALT+E U )

     Displays a sub-menu which allows you to duplicate text. You
     may duplicate the entire line, or individual characters
     (while the cursor moves left or right).

<Line>
Line                                    ( CTRL+2 or ALT+E U L )

     Duplicates the line the cursor is on.

<Character Left >
Character Left                ( SHIFT+GRAY-MINUS or ALT+E U C )

     Duplicates the character on the line immediately above the
     cursor.  The cursor then moves one position to the left.

<Character Right>
Character Right                ( SHIFT+GRAY-PLUS or ALT+E U R )

     Duplicates the character on the line immediately above the
     cursor.  The cursor then moves one position to the right.

<Change Case>
Change Case                               ( CTRL+\ or ALT+E H )

     Changes the case of the character at the current cursor
     position.

<Options...>
Options...                                ( CTRL+O or ALT+E O )

     Loads, saves, and modifies Text Editor Option Sets.  Option
     Sets are linked to specific file extensions and allow you to
     specify Tab Settings, Word Wrap, and other options.  Macros
     are stored in the Option Set, which allows each Option Set to
     have Macros specific to the type of file (by file extension).

<Keyboard Macro>
Keyboard Macro                           ( CTRL+K or ALT+E K )

     Record multiple keystrokes, which are assigned to one
     keystroke, to automate repetitive tasks.  You define the
     macro's "hot" key (the "hot" key may be any key), record the
     keystrokes, then press CTRL+K to end recording.  Once
     recorded, the macro is replayed through the Play Macro or
     View Macro menu selections.

     Macros are kept in the Option Set, which allows separate sets
     of Macros specific to the type of file (by file extension).

<Play Macro>
Play Macro                                ( CTRL+P or ALT+E P )

     Replays a recorded macro.  Once Play Macro is invoked, the
     macro's "hot" key replays the macro.

<View Macro...>
View Macro...                             ( CTRL+V or ALT+E V )

     Displays a list of previously recorded macros.  From this
     list you may record more macros, play existing macros (once
     or multiple times), or delete macros.


<<Search Menu>>

The Search menu contains selections which allow you to find
specific items within the Text file.

<Search...>
Search...                                 ( CTRL+S or ALT+S S )

     Allows you to search for the text string you specify.  This
     search is conducted through the file in the currently active
     edit window.  If the text string is not found a No More
     Occurrences message is displayed at the bottom of the screen.

     The vertical bar character (|) must be used to terminate a
     search string which contains a specific number of blank
     spaces at its end.

<Replace...>
Replace...                                ( CTRL+R or ALT+S R )

     Allows you to search for and replace a text string with a new
     text string which you specify.  You may replace only the
     first occurrence of the string, or every occurrence within a
     block which you mark.  This search and replace is conducted
     through the file in the currently active edit window.  If the
     text string is not found, the No More Occurrences message
     displays at the bottom of the screen.

     The vertical bar character (|) must be used to terminate a
     search string, or replacement string, which contains a
     specific number of blank spaces at its end.

<Find Next >
Find Next                                 ( CTRL+N or ALT+S N )

     Places the cursor at the next occurrence of the text string
     searched for with either Search... or Replace...  If the text
     string is not found, the No More Occurrences message displays
     at the bottom of the screen.

<Find Next Error>
Find Next Error                           ( CTRL+E or ALT+S E )

     Opens the Error window and retrieves errors based on the
     currently active Project, placing the cursor on the first
     error in the file.  Subsequent calls places the cursor on the
     next Clarion language syntax error discovered by the
     compiler. The compiler error message displays at the bottom
     of the screen.  When all errors have been displayed, the No
     More Errors message is displayed at the bottom of the screen.

<Find Delimiter >
Find Delimiter                                      ( ALT+S D )

     Places the cursor on the matching delimiter to the delimiter
     the cursor is on when Find Delimiter is invoked.  Normal
     delimiters are:  parentheses (), square brackets [], curly
     braces {}, and angle brackets <>.  If the cursor is not on
     one of these delimiters, Find Delimiter places the cursor on
     the next occurrence of the character the cursor is on.

     The matching delimiter is found either forward or backward
     through the file, depending upon whether the cursor starts on
     a beginning or ending delimiter (only valid for the above-
     named delimiters).  The correct matching delimiter is found
     within nested delimiters, enabling you to determine which
     delimiter completes or begins a nesting level in complex
     expressions.

<Jump To Line...>
Jump To Line...                           ( CTRL+J or ALT+S J )

     Places the cursor on the line number you specify of the file
     in the currently active edit window.


<<Window Menu>>

The Window menu contains selections which allow you to
manipulate the edit windows in the Text Editor.

<Zoom>
Zoom                                      ( CTRL+Z or ALT+W Z )

     Allows you to re-size the currently active edit window to
     full-screen when it is not already in full-screen mode.  When
     the window is already full-screen size, it toggles back to
     the window's original size.  You may also Zoom the currently
     active edit window with a mouse CLICK on the top right corner
     of the edit window (on the  character).

<Hide>
Hide                                      ( CTRL+H or ALT+W H )

     Removes the currently active edit window from the video
     display without closing the edit window or the file.  To "un-
     hide" a window, press ALT and the window number or use the
     Change Window menu selection.

<Arrange>
Arrange                                   ( CTRL+A or ALT+W A )

     Allows you to arrange the open edit windows.  They may be
     displayed in Cascade or Tile fashion.

<Cascade>
Cascade                               ( CTRL+A C or ALT+W A C )

     Arranges the open edit windows.  In Cascade display, each
     edit window is configured for almost the full screen and
     displayed, overlapping each other in numerical order, from
     the top left to the bottom right of the screen.

<Tile>
Tile                                  ( CTRL+A T or ALT+W A T )

     Arranges the open edit windows.  In Tile display, each edit
     window is displayed in its own portion of the screen with no
     overlap.

<Resize/Move>
Resize/Move                                         ( ALT+W R )

     Allows you to change the display size and position of the
     currently active edit window.  Once Resize/Move is invoked,
     the ARROW cursor keys re-position the window and the SHIFT+
     ARROW keys resize the window.  In addition to the Resize/Move
     menu selection, you can resize the currently active edit
     window with a mouse CLICK-AND-DRAG on the bottom right corner
     of the edit window (on the  character).  You can also move
     the currently active edit window to a new position on screen
     with a mouse CLICK-AND-DRAG anywhere on the top row of the
     edit window.

<Change Window...>
Change Window...                                    ( ALT+W C )

     Allows you to change the currently active edit window.  This
     pops up a list of all the edit windows and their contents.
     Selecting an edit window with no contents provides you the
     opportunity to specify a file to load or create.  You can
     also select an edit window to be the currently active edit
     window with the ALT+1 through ALT+9 keys.

<Next Window>
Next Window                               ( CTRL+W or ALT+W W )

     Allows you to change the currently active edit window.  Next
     Window cycles through all the open edit windows in numerical
     order.


<<Project Menu>>

The Project menu contains selections which allow you to compile
and link your application.  These menu selections perform the
same functions as described in the Clarion Environment chapter.

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

<Check Syntax>
Check Syntax                               ( ALT+X or ALT+P X )

     Compiles your application without linking (creating an .EXE
     file).  This allows the compiler to verify that the Clarion
     language source code you have written meets all the rules for
     valid syntax.

<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 exactly what is compiled
     and linked into your application's .EXE file.

<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.  Anywhere else in the Clarion environment, you must
     load the Project file yourself to compile and link your
     application.


<<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 built-in disk maintenance program (CSHELL).

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

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

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

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

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

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

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

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

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

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


<<Clarion Menu>>

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

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

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

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

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

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

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

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

 <Load Text...>

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

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

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

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

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

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

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

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

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

     Allows you to select a Color Styles file for the Clarion
     environment's use, and/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 TopSpeed Software (call Customer Service at 800-
     354-5444 for more information).  Once you receive a new file
     system driver, you must register its presence before the
     Clarion environment will be able to use it.

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

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

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

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

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

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


<<Help Menu>>

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

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

     Provides information on how to use the Help system.

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

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

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

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


<<Save File As Window>>

The Save File As window saves the open Text file in the current Edit
Window to the new name you specify, leaving you in the new file.
This allows you to copy an entire Text file to a new name, then
immediately modify the new file.

<Save File As:>
Save File As:

     Enter the new name of the file.  This must meet all the
     requirements of a valid DOS filename, and may include a full
     path.



<<File Load Window>>

The File Load window allows you to open a new edit window with the
filename you select.  This will create a new file or open an
existing file.

<Filename:>
Filename:
     Enter the name of the file to load.  You may include a full
     path, if opening an existing file, or creating a new file, in
     another directory.


<<Window Close Window>>

The Window Close window allows you to close an active editor window,
and gives you the option to save your changes.

<Yes Button>
Yes Button
     SAVEs any file changes to disk and closes the edit window.

<No Button>
No Button
     ABANDONs any file changes and closes the edit window.

<Edit Button>
Edit Button
     Returns to your edit session without closing the edit window.


<<Auto Save Window>>

The Auto Save window allows you to configure the Text Editor's
auto save feature.  This feature automatically and periodically
writes to disk any changes made in an open edit window.  This
feature exists primarily for disaster recovery.  This window
allows you to specify the time period between saves.

<Minutes to Auto Save:>
Minutes to Auto Save:

     Enter the number of minutes between automatic saves to disk.
     Changes are saved to an .ASV file in the same location (path)
     as the current open edit window filename.  A value of 5 or 10
     minutes is typical.  The .ASV file is deleted during a normal
     window close.


<<Get File Window>>

The Get File window allows you to select a file whose contents
will be inserted into the selected open edit window at a
destination that you specify.


<<Shared File Access Window>>

The Shared File Access window allows you to specify the "sharing
mode" of a file which has already been opened in another Edit
Window.

<Loaded in Window:>
Loaded in Window:

     Displays the number of the Edit Window in which the file is
     already open.

<Share Button>
Share Button

     Opens the file in the second Edit Window for "shared" access.
     Any changes to the file in either Edit Window are displayed
     in both.

<Load Button>
Load Button

     Opens the file in the second Edit Window for "non-shared"
     access -- completely independent of the other Edit Window.
     Changes to the file in one Edit Window are not displayed in
     the other.


<<Embedded Source Open Window>>

The Open window allows you to specify opening an Embedded source
window or a text file.

<Embedded Source>
()  Embedded Source

     Select this radio button to open another Embedded Source code
     window for the procedure.

<File>
()  File

     Select this radio button to open any text file.


<<Put Block to File Window>>

The Put Block to File window allows you to select the file to
which the currently marked block is to be written.  If the file
you specify exists, the marked block will be appended to the
file.

<Filename to Put Block:>
Filename to Put Block:

     Enter the name of the file to receive the marked block.  This
     may include a full path. If the specified file exists, the
     block is appended to the file.


<<Printer Setup Window>>

The Printer Setup window allows you to select the destination
and some general formatting for the Text Editor's print
operations.

<Output to:>
Output to:

     Specify the DOS device to use as the output destination.  You
     may select any one of LPT1-4 or COM1-4 for the output
     destination.

<Printer Characteristics>
Printer Characteristics

     Allows general setup for formatting output.

[] Formfeed After

     Specifies that a form feed is sent to the printer after the
     output is complete.

[] Line Numbers

     Specifies that line numbers are printed on each line before
     the text.

[] Page Numbers

     Specifies that page numbers are printed at the bottom of each
     page.

<Lines Per Page:>
Lines Per Page:

     Enter the number of lines to print per output page.

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

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


<<View Macro Table Window>>

The View Macro Table window displays a list of all the Macros
defined in the Option Set active for the Current Edit Window.
The list displays the Macro's activation Key and Description.

<Record Button>
Record Button

     Invokes the keystroke Macro Record process to allow you to
     add another Macro.  First, it requests the activation Key,
     then calls the Macro Description window to enter a
     description of the Macro's purpose.

<Play Button>
Play Button

     Executes the currently highlighted Macro.

<Repeat Button>
Repeat Button

     Calls the Repeat Macro window to allow you to execute the
     currently highlighted Macro a specific number of iterations.

<Delete Button>
Delete Button

     Deletes the currently highlighted Macro.


<<Repeat Macro Window>>

The Repeat Macro window allows you to specify the number of
times to execute a Macro.

<Number of Times to Repeat Macro>
Number of Times to Repeat Macro

     Enter the number of times to execute the Macro.


<<Macro Description Window>>

The Macro Description window allows you to enter the description
which will appear in the View Macro Table window's List box.

<Macro Key:>
Macro Key:

     Displays the Macro's activation key.

<Description:>
Description:

     Enter a description of the Macro's function.


<<Edit Options Window>>

The Edit Options window allows you to configure edit features
(Option Sets) specific to certain DOS file extensions.  For
example, you may have personal preferences for specific tab
stops and editing features for your *.CLA files.  When your
specific Options Set is saved, it will be the option set loaded
each time a .CLA file is opened to edit.

Whenever a file is opened to edit, the first existing Option Set
with that file's extension is used (in the order created).

<Option Set:>
Option Set:

     Displays the name of the current Option Set.

<For Extension(s):>
For Extension(s):

     Enter the filename extensions for which this Option Set will
     be automatically loaded.  You may enter up to eight (8)
     extensions for a single Option Set.

<Insert Within Column>
[] Insert Within Column

     Toggles "zone" insert.  This allows edit operations (Insert
     text, backspace, delete key, Grey Plus/Minus, etc.) to act
     only on the text in a particular text "zone".  A "zone" is
     specified by multiple blanks spaces between text on the line.

<Indent New Line>
[] Indent New Line

     Causes word-wrap or carriage return to indent the next line
     to the same position as the previous line.  When toggled OFF,
     the cursor returns to column one after a Carriage Return or
     word-wrap line break.

<Split Line at Cursor>
[] Split Line at Cursor

     Carriage return moves any text to the right of the cursor to
     the next line as it adds a new line.

<Automatic Word Wrap>
[] Automatic Word Wrap

     Enables the Word Wrap editing.  This automatically moves text
     that overlaps the end of one line (text that hits the right
     window bound) to the beginning of the next line as you type.
     This prevents a word from spanning two lines.

<Recognize Scroll Lock>
[] Recognize Scroll Lock

     Tells the Editor that when the scroll lock key is pressed to
     start scrolling at the cursor position. Keeps the cursor
     stationary during scroll up and down operations.  In effect,
     this scrolls the text surrounding the cursor, but leaves the
     cursor in the same position.

<Load... Button>
Load... Button

     Calls the Load Options window to pick an Option Set to load.

<Save Button>
Save Button

     Saves the current Options to disk.

<Save As... Button>
Save As... Button

     Renames and saves the current Option Set.

<Delete Button>
Delete Button

     Removes the current Option Set from the list of Option Sets
     which you may Load.

<Set Tabs... Button>
Set Tabs... Button

     Allows you to set tab stops appropriate for the Option Set.


<<Load Options Window>>

The Load Options Window allows you to select a pre-saved Option
Set to load.  If you plan on re-configuring an Option Set, you
must load it first.

<Load Button>
Load Button

     Loads the currently highlighted Option Set.


<<Save Option Set Window>>

The Save Option Set window allows you to name the current Option
Set you have configured and save the settings to disk.

<Option Set Name:>
Option Set Name:

     Enter the name to display for the current Option Set switch
     settings.  For example, you may want to name text file Option
     Sets as "Text" for extensions *.TXT and *.DOC.


<<Delete Option Set Window>>

The Delete Option Set window allows you to remove the current
Option Set from the list of available Option Sets.  You may not
delete the Default Option Set.


<<Text Search Window>>

The Text Search window allows you to specify a search string for
which to search, and whether the search should be case-
sensitive.

<Search for:>
Search for:

     Enter the string for which to search.  If any trailing spaces
     are part of the search string, you must terminate the string
     with the vertical bar (|) character.

<Ignore Case>
[] Ignore Case

     Specifies that the search is not case-sensitive.


<<Replace Text Window>>

The Replace Text window allows you to specify search-and-replace
text.

<Search for:>
Search for:

     Enter the string for which to search.  If any trailing spaces
     are part of the search string, you must terminate the string
     with the vertical bar (|) character.

<Ignore Case>
[] Ignore Case

     Specifies that the search is not case-sensitive.

<Replace with:>
Replace with:

     Enter the replacement string for the "Search for:" string.
     If any trailing spaces are part of the replace string, you
     must terminate the string with the vertical bar (|)
     character.

<Confirm Replace>
[] Confirm Replace

     Enables confirmation for each replacement of the "Search
     for:" string.

<Replace Within Block>
[] Replace Within Block

     Limits the scope of a search-and-replace to a marked block.

<First Occurrence Only>
[] First Occurrence Only

     Stops the search-and-replace after the first occurrence of
     the "Search for:" string.

<<Replace Text Confirm Window>>

The Replace Text window allows you to confirm a replace action.

<Replace Button>
Replace Button

     Replaces the currently highlighted instance of the Search
     string with the Replace text and continues the Search-and-
     Replace operation.

<Skip Button>
Skip Button

     Does not replace the currently highlighted instance of the
     Search string with the Replace text and continues the Search-
     and-Replace operation.

<Cancel Button>
Cancel Button

     Discontinues the Search-and-Replace operation.


<<Jump to Line Window>>

The Jump to Line window allows you to specify a file line to
which the cursor is repositioned.

<Jump to Line:>
Jump to Line:

     Enter the line number within the file to which you wish to
     move the cursor.


<<Window Lookup Window>>

The Window Lookup window allows you to select any of the open
edit windows to become the active window for editing.  You are
immediately switched to the window you select.  The ALT+1
through ALT+9 "hot" keys also invoke this switch to another edit
window, without first calling the Window Lookup window.


<<Screen Formatter>>

The Screen Formatter in the Text Editor has slightly a different
user interface from the one in the Application Generator.  The
differences result from Application Generator's need to generate
executable source code in addition to the SCREEN data structure.
The Text Editor's Screen Formatter only generates the SCREEN
data structure -- not executable source code.

A SCREEN is a data structure which defines the video data entry
and display fields for the procedure.  All the possible tools
that you may use in the Screen Formatter are accessible through
the pulldown menu.  The ESC key activates the pulldown menu.
Many of the tools have shortcut "hot" keys which are displayed
at the right of each tool's menu selection.

<Screen Formatter Hot Keys>
Screen Formatter Hot Keys

        CTRL+O     Screen Properties
        CTRL+W     Set Window Area
        CTRL+G     Get Captured Screen
        CTRL+U     Undo
        CTRL+C     Copy
        CTRL+M     Move
        CTRL+D     Delete
        CTRL+6     Center on Line
        CTRL+\     Change Case
        CTRL+P     Paint
        CTRL+K     Keyin Color
        CTRL+A     Change Attribute
        CTRL+T     Draw Track
        CTRL+B     Draw Border
        CTRL+R     Use Rulers
        CTRL+F     Process Fields
        CTRL+E     Reorder Fields
        CTRL+S     Resize Field

        CTRL+X     Exit

<<Screen Formatter's Screen Menu>>

The Screen menu contains selections which affect the entire
screen design:

<Properties>
Properties                                ( CTRL+O or ALT+S O )

     Displays the Screen Properties window.  This window allows
     you to specify attributes of the SCREEN statement such as the
     screen opening method (ZOOM, FADE, WIPE, FALL) and basic
     color of the screen (COLOR).

<Set Window Area>
Set Window Area                           ( CTRL+W or ALT+S W )

     Allows you to declare the SCREEN's size.  This puts the
     number of rows and columns (SCREEN(rows,cols)) on the SCREEN
     statement.  When these are specified, any video overwritten
     when this SCREEN is opened is saved and restored when it is
     closed.  Access by the keyboard marks a side of the window
     which can be dragged in or out to resize the screen.  The
     mouse can be used by holding down the Ctrl key and clicking
     an edge of the window with mouse button1.  That edge may then
     be dragged in and out as long as mouse button1 is pressed.

<Get Captured Screen>
Get Captured Screen                                 ( ALT+S G )

     Imports a screen design previously captured by Clarion's
     SCRCAP.COM text-mode screen capture TSR (see SCRCAP.COM in
     the User's Guide).  This imports the design only -- any
     screen fields the procedure requires must still be declared.

<Enable Blink>
Enable Blink                                        ( ALT+S B )

     Enables foreground blinking (which disables the enhanced
     background colors).  This selection is a toggle switch with
     a check mark () displayed when toggled ON.

<Exit>
Exit                                                ( ALT+S X )

     Closes the Screen Formatter, saving the screen design if you
     choose, and returns to the Text Editor.


<<Screen Formatter's Edit Menu>>

The Edit menu contains selections which affect individual items
placed on the screen.

<Undo>
Undo                                      ( CTRL+U or ALT+S U )

     Restore the last item deleted by the Delete menu selection.

<Copy>
Copy                                      ( CTRL+C or ALT+E C )

     Copy a portion of the screen design to another part of the
     screen.

<Move>
Move                                      ( CTRL+M or ALT+E M )

     Move a portion of the screen design to another part of the
     screen.

<Delete>
Delete                                    ( CTRL+D or ALT+E D )

     Remove a portion of the screen design from the screen.

<...Data>
...Data                                             ( ALT+E A )

     Enables the Copy, Move, and Delete menu selections to act on
     the data placed on the screen.  This selection is a toggle
     switch with a check mark () displayed when toggled ON.

<...Paint>
...Paint                                            ( ALT+E I )

     Enables the Copy, Move, and Delete menu selections to act on
     the colors placed on the screen.  This selection is a toggle
     switch with a check mark () displayed when toggled ON.

<Paint>
Paint                                     ( CTRL+P or ALT+E P )

     Paint a portion of the screen design a color different from
     the basic color of the screen.

<Keyin Color>
Keyin Color                               ( CTRL+K or ALT+E K )

     Select the color the next literals placed on screen will
     have.

<Change Attribute>
Change Attribute                          ( CTRL+A or ALT+E A )

     Changes the video display attribute at the cursor's current
     screen position to the color specified by the Keyin Color and
     moves the cursor one position to the right.  If no Keyin
     Color has been specified, no change occurs.

<Draw Track>
Draw Track                                ( CTRL+T or ALT+E T )

     Place tracking characters (most commonly, single or double
     lines) in your screen design.

<Draw Border>
Draw Border                               ( CTRL+B or ALT+E B )

     Allows you to place tracking characters in a rectangle around
     your screen design.

<Ruler Line>
Ruler Line                                ( CTRL+R or ALT+E R )

     Displays numbered vertical and horizontal lines on screen.
     This is an aid to determine exact placement (row and column
     position) of your fields on screen.


<<Screen Formatter's Fields Menu>>

Field placement in the Text Editor is very similar to that in
the Application Generator.  When you place a field in your
screen design, you should first position the cursor to the spot
where you want the field to be placed.  If you do not position
the cursor first, you could define two fields to occupy the same
place.

<Process Fields>
Process Fields                            ( CTRL+F or ALT+F F )

     Displays the same type of listing of all fields already
     placed on the SCREEN as in the Application Generator. Through
     this screen you can add, change, or delete screen fields. You
     may also change the order in which the fields appear in the
     Field List (changing the normal selection order of the fields
     at run-time).

<Reorder Fields>
Reorder Fields                            ( CTRL+E or ALT+F E )

     Invokes a process which allows you to change the normal
     selection order of the fields already placed on the screen.
     This process re-orders the fields within the SCREEN data
     structure.

<Resize Field>
Resize Field                              ( CTRL+S or ALT+F S )

     Allows a List Box, Text field, or Image field to be
     dynamically resized on the formatter worksheet using the
     mouse or keyboard.  The resizing will automatically adjust
     the Rows and Columns entries for the field.  When selected
     by the keyboard, an edge of the field is highlighted and can
     be dragged in or out using the cursor keys.  Resize is
     completed when Enter is pressed. To select with a mouse,
     position the mouse cursor on an edge of the field, hold down
     the Ctrl key, and click and hold mouse button1.  The edge can
     then be dragged in or out as long as mouse button1 is pressed.

<Set Default Colors...>
Set Default Colors...                               ( ALT+F T )

     Select the default display colors for each type of screen
     field.  These default color selections are stored in the
     application's Style file, if the application uses one, or the
     Clarion configuration file (CLARION3.INI), if it doesn't.

<Reapply Default Colors...>
Reapply Default Colors...                           ( ALT+F R )

     Automatically re-selects the default display colors for each
     screen field.  This allows you to change the default colors
     and change all fields to use those colors without re-creating
     the colors for each field individually.


<<Screen Formatter's 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).

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


<<Screen Formatter's Help Menu>>

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

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

     Provides information on how to use the Help system.

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

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

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

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


<<Select New Background Style Window>>

When the Select New Background Style window appears, the system
is warning you that your background color may have changed.  You
may have selected a new styles file, or you may have chosen to
not use a styles file.  In any case, you have the option of
selecting a new background style, or using the same one.


<<Add Field Window>>

The Add Field window allows you to select the type of field to
add to the screen design.  All these screen field types are
fully described in the Language Reference.

<String>
String

     Adds a STRING field (may be placed within an OPTION
     structure).

<Prompt>
Prompt

     Adds a PROMPT field.

<Entry>
Entry

     Adds an ENTRY field.

<Text>
Text

     Adds a TEXT field.

<Button>
Button

     Adds a BUTTON field.

<Option>
Option

     Adds an OPTION structure.

<Radio Button>
Radio Button

     Adds a RADIO field (valid only within an OPTION structure).

<Check Box>
Check Box

     Adds a CHECK field (may be placed within an OPTION
     structure).

<List Box>
List Box

     Adds a LIST field.

<Image>
Image

     Adds an IMAGE field.

<Repeat>
Repeat

     Adds a REPEAT structure.

<Point>
Point

     Adds a POINT field (valid only within a REPEAT structure).

<Pause>
Pause

     Adds a PAUSE field.


<<Entry Field Properties Window>>

The Entry Field Properties window allows you to change all of
the applicable parameters that define a screen ENTRY field.  An
ENTRY field allows operator input and editing of the USE
variable.

<Use:>
Use:

     Enter the variable which receives values entered in the
     field.  For "dummy" fields, this may be a field equate label.

<Picture:>
Picture:

     Enter the display Picture to format characters entered into
     the Use variable.  The picture may be a different length than
     the variable specified in the "Use:" field.

<Colors Button>
Colors Button

     Allows you to change the field's display colors.

<Attributes Button>
Attributes Button

     Allows you to specify the applicable attributes for this
     field.


<<Text Field Properties Window>>

The Text Field Properties window allows you to change all of the
applicable parameters that define a screen TEXT field.  A TEXT
field is a multiple-row string field with word-wrap and vertical
scrolling in a SCREEN structure.

<Use:>
Use:

     Enter the variable which receives values entered in the TEXT
     field.

<Rows:>
Rows:

     Enter an integer constant specifying the number of display
     rows in the TEXT field.

<Columns:>
Columns:

     Enter an integer constant specifying the number of display
     columns in the TEXT field.

<Word wrap>
[] Word Wrap

     Enables Word-wrap (places the LFT attribute on the TEXT
     field).  Word-wrapping pads the end of the display row with
     blanks to force a word to the next line if it would span two
     segments.  Therefore, USE variables of TEXT fields become
     "width sensitive."  If a width sensitive variable is used in
     a TEXT field with a different width, unnecessary spaces
     appear between words, and words may span rows.

<Colors Button>
Colors Button

     Allows you to change the field's display colors.

<Attributes Button>
Attributes Button

     Allows you to specify the applicable attributes for this
     field.


<<String Field Properties Window>>

The String Field Properties window allows you to specify all of
the applicable parameters that define a screen STRING field.

<Parameter:>
Parameter:

     You may specify one of the following:

     A string constant or variable containing the initial value of
     the string.  The length of the  STRING is set to the length
     of the initial value string.

     A numeric constant which defines the length of the display
     STRING.  This is usually used with a STRING which has a
     Label, and so may be assigned values in the executable code.

     A picture token used to format values assigned to the STRING.
     This is usually used with a STRING which has a Label, and so
     may be assigned values in the executable code.  The length is
     the size needed to contain the formatted STRING.

<Label:>
Label:

     An optional name which allows the field to be referenced in
     executable code.

<Colors Button>
Colors Button

     Allows you to change the field's display colors.

<Attributes Button>
Attributes Button

     Allows you to specify the applicable attributes for this
     field.


<<Pause Field Properties Window>>

The Pause Field Properties window allows you to change all of
the applicable parameters that define a screen PAUSE field.
When a PAUSE field is selected, the associated string is
displayed.  Any key other than ESC or BACKTAB completes the
PAUSE field.  Completing the PAUSE field causes the string to
disappear from the screen.

<String:>
String:

     Enter string constant or variable containing a message to
     display.

<Use:>
Use:

     Enter a field equate label which allows this field to be
     referenced in executable code.

<Colors Button>
Colors Button

     Allows you to change the field's display colors.

<Attributes Button>
Attributes Button

     Allows you to specify the applicable attributes for this
     field.

<<Prompt Field Properties Window>>

The Prompt Field Properties window allows you to define a PROMPT
field on the screen.  PROMPT fields are used for SAA/CUA
compliance to allow the user to navigate directly to the ENTRY,
TEXT, LIST, or OPTION field with which it is associated, using
the ALT key and the highlighted letter displayed in the PROMPT.

<Prompt Name:>
Prompt Name:

     Enter a string constant or variable containing the text to
     display as a prompt for the ENTRY, TEXT, LIST, or OPTION
     field following the PROMPT in the Field List.  An ampersand
     (&) indicates the next letter is the letter to be highlighted
     (the "hot" key used with the ALT key).

<Colors Button>
Colors Button

     Calls the Color Selection window, which allows you to select
     the display colors for the field.  If you do not specifically
     select colors for the field, the default colors (defined by
     you) for the type of field you are creating are used.

<Attributes Button>
Attributes Button

     Calls the Field Attributes window, which allows you to select
     the data entry attributes the field will use.


<<Repeat Properties Window>>

The Repeat Properties window allows you to change all of the
applicable parameters that define a screen REPEAT structure.  A
REPEAT structure may be thought of as an "array on screen."
Each repetition of the structure corresponds to one element of
an array.

<Repeat:>
Repeat:

     Rows:  Enter an integer constant specifying the number of
            REPEAT elements down the screen (default 1).

     Cols:  Enter an integer constant specifying the number of
            REPEAT elements across the screen (default 1).

     Rows * Columns = total number of REPEAT elements.

<Every:>
Every:

     Rows:  Enter an integer constant specifying the number of rows
            separating the beginning of each REPEAT element down the
            screen (default 1).

     Cols:  Enter an integer constant specifying the number of
            columns separating the beginning of each column of
            REPEAT elements across the screen (default 1).

     If omitted, the default is EVERY(1,1).

<Index:>
Index:

     Enter the name of the INDEX variable for the REPEAT
     structure.  The value contained in the INDEX variable
     indicates which REPEAT element is currently active.

<Pre:>
Pre:

     Enter an optional prefix for field labels within the REPEAT
     structure.  This is placed in the REPEAT structure's PRE
     attribute.

<Max:>
Max:

     Enter the name of the MAX variable for the REPEAT structure.
     The value contained in the MAX variable indicates the total
     number of screen rows used by the REPEAT structure at run-
     time.  This allows the executable code to vary the number of
     REPEAT elements displayed depending upon the screen text mode
     actually used at run time.


<<Point Field Properties Window>>

The Point Field Properties window allows you to change all of
the applicable parameters that define a screen POINT field.  A
POINT field creates the highlight bar that allows the operator
to select an item from a REPEAT structure.  This, in turn, sets
the REPEAT INDEX value.

<Rows:>
Rows:

     Enter an integer constant for the number of rows in the POINT
     field's highlight bar.

<Cols:>
Cols:

     Enter an integer constant for the number of columns in the
     POINT field's highlight bar.

<Use:>
Use:

     Enter the field equate label which allows this field to be
     referenced in executable code.

<Colors Button>
Colors Button

     Allows you to change the field's display colors.

<Attributes Button>
Attributes Button

     Allows you to specify the applicable attributes for this
     field.


<<Option Field Properties Window>>

The Option Field Properties window allows you to change all of
the applicable parameters that define a screen OPTION structure.
The OPTION structure specifies a menu on a SCREEN.  There are
three field types available in an OPTION structure: CHECK boxes,
RADIO buttons, and STRINGs.  Field types may not be mixed within
a particular OPTION structure.

<Use:>
Use:

     Enter a variable or field equate label.  This parameter is
     valid on RADIO or STRING OPTION structures.

<Parameter:>
Parameter:

     Enter an optional picture token to format characters for
     display or assignment to the USE variable.  This parameter is
     valid only on STRING OPTION structures.

<Colors Button>
Colors Button

     Allows you to change the field's display colors.

<Attributes Button>
Attributes Button

     Allows you to specify the applicable attributes for this
     field.


<<Checkbox Field Properties Window>>

The Checkbox Field Properties window allows you to change all of
the applicable parameters that define a screen CHECK field.
CHECK is an on/off toggle field on a SCREEN structure.  A box is
placed one space to the left of the string designated as the
parameter of the CHECK statement.  The USE variable receives a
value of one if checked, or zero is not checked.

<Use:>
Use:

     Enter an integer variable or field equate label.

<Name:>
Name:

     Enter a string constant or variable containing the string to
     be displayed.

<Colors Button>
Colors Button

     Allows you to change the field's display colors.

<Attributes Button>
Attributes Button

     Allows you to specify the applicable attributes for this
     field.


<<Button Field Properties Window>>

The Button Field Properties window allows you to change all of
the applicable parameters that define a screen BUTTON field.

<Button Text:>
Button Text:

     Enter a string constant or variable containing the string to
     be displayed.

<Equate Label:>
Equate Label:

     Enter a field equate label which allows the field to be
     referenced in program statements.

<Hot Key:>
Hot Key:

     Enter a keycode which the user may press to complete the
     BUTTON field at run time.  This is separate from and in
     addition to any ampersand (&) hot key (defined in the Button
     Text) used with the ALT key to complete the BUTTON field.

<Shadow>
[] Shadow

     Specifies that a "ten o'clock" shadow will automatically be
     placed around the BUTTON.

<Colors Button>
Colors Button

     Allows you to change the field's display colors.

<Attributes Button>
Attributes Button

     Allows you to specify the applicable attributes for this
     field.


<<List Box Field Properties Window>>

The List Box Field Properties window allows you to change all of
the applicable parameters that define a screen LIST field.  A
LIST box displays a number of items from a field in a memory
QUEUE.

<Rows:>
Rows:

     Enter the number of rows (items) to display in this LIST box.

<Columns:>
Columns:

     Enter the number of columns to display in this LIST box.

<Fixed Rows:>
Fixed Rows:

     Enter an integer constant which specifies the number of rows
     in the LIST for "static" display.  This allows static column
     headers in the LIST display.


<Lines/Row:>
Lines/Row:

     Enter an integer constant for the number of lines per row.

<Queue Label:>
Queue Label:

     Enter the label of the QUEUE or QUEUE field to display.  This
     may be a GROUP.

<Equate Label:?>
Equate label:?

     Enter a field equate label which allows the LIST to be
     referenced in executable code statements.

<Fill Label:?>
Fill Label:?

     Enter the field equate label for the field to receive the
     item selected from the LIST.

<COLS String:>
COLS String:

     Enter a string constant or variable containing the column
     definitions to place in the first parameter of the LIST box
     COLS attribute.

<Variable:>
Variable:

     Enter a variable name to place in the second parameter of the
     LIST box COLS attribute.

<Spacing:>
Spacing:

     Enter an integer constant to place in the third parameter of
     the LIST box COLS attribute.

<Colorize:>
[]  Colorize:

     Check this box to enable colorization of fields in a list box.

<Colorize Delimiters>

     Enter two characters to be used to identify the
     colorize attributes in the QUEUE. You may accept the
     default square brackets ([]) or specify your own.


<Horizontal Scroll>
[] Horizontal Scroll

     Places a horizontal scroll bar at the bottom of the LIST box,
     which occupies 1 row.

<Vertical Scroll>
[] Vertical Scroll

     Places a vertical scroll bar at the right of the LIST box,
     which occupies 1 column.

<Colors Button>
Colors Button

     Allows you to change the field's display colors.

<Attributes Button>
Attributes Button

     Allows you to specify the applicable attributes for this
     field.


<<Image Field Properties Window>>

The Image Field Properties window allows you to change all of
the applicable parameters that define a screen IMAGE field.
This field defines a graphics display area on a SCREEN structure
with the GRAPHIC attribute.  The .PCX or .GIF image is
automatically re-sized (if necessary) to fit the IMAGE field.

<Rows:>
Rows:

     Enter the number of rows in the IMAGE field -- maximum 25.

<Columns:>
Columns:

     Enter the number of columns in the IMAGE field -- maximum 80.

<Display From File>
() Display From File

     Designates that the graphics IMAGE will come from a .PCX, .BMP
     or .GIF file on disk.

<Image File:>
Image File:

     Enter the filename of the .PCX, .BMP, or .GIF file to display.

<Use:?>
Use:?

     Enter a field equate label which allows the IMAGE to be
     referenced in executable code statements.

<Display From Field>
() Display From Field

     Designates that the graphics IMAGE will come from a field,
     typically a MEMO field with the BINARY attribute.

<Use:>
Use:

     Enter a field equate label which allows the IMAGE to be
     referenced in executable code statements.

<Use Current Color Palette>
[] Use Current Color Palette

     In 256-color SVGA mode, the IMAGE will use the color palette
     defined by another .PCX or .GIF image already on-screen, or
     the video card's default palette, on a "best-fit" basis.

<Use Image as a Pushbutton>
[] Use Image as a Pushbutton

     Allows the IMAGE to act as a BUTTON field.  It may have a
     field equate label so it may be referenced in code
     statements. The user may: TAB to it and press ENTER, click on
     it with the mouse, or press the KEY attribute's "hot" key --
     ACCEPT completes the field.  A blinking diamond () displays
     in the IMAGE field's top left corner when the field is the
     currently active field.

<Hot Key:>
Hot Key:

     Enter a keycode "hot" key which immediately completes the
     IMAGE field. This is dimmed unless the image is being used as a
     pushbutton.

<Attributes Button>
Attributes Button

     Allows you to specify the applicable attributes for this
     field.


<<Radio Button Properties Window>>

The Radio Button Properties window allows you to change all of
the applicable parameters that define a screen RADIO field.
RADIO buttons are menu selections within an OPTION structure.
Only one RADIO button within an OPTION may be selected at a
time.

<Name:>
Name:

     Enter a string constant or variable to be displayed as the
     RADIO button.

<Colors Button>
Colors Button

     Allows you to change the field's display colors.

<Attributes Button>
Attributes Button

     Allows you to specify the applicable attributes for this
     field.


<<Get Captured Screen Window>>

The Get Captured Screen window allows you to retrieve a captured
screen stored in text format and import it into your screen.
These screens are usually captured with the SCRCAP.COM program
supplied with Clarion for DOS.  Enter the name of the
file containing the screen to retrieve.


<<Report Formatter>>

The Report Formatter in the Application Generator and the Text
Editor have differences in user interface.  Most of the
differences are result from Application Generator's need to
generate executable source code in addition to the REPORT data
structure.

<Report Formatter Hot Keys>
Report Formatter Hot Keys

        CTRL+O     Report Properties
        CTRL+B     Band Properties
        CTRL+U     Undo
        CTRL+C     Copy
        CTRL+M     Move
        CTRL+D     Delete
        CTRL+L     Toggle Full Line Mode
        CTRL+6     Center on Line
        CTRL+2     Duplicate Line
        CTRL+\     Change Case
        CTRL+T     Draw Track
        CTRL+R     Use Rulers
        CTRL+F     Process Fields
        CTRL+N     Create New Detail Band
        CTRL+S     Suppress Line

        CTRL+X     Exit

<<Report Formatter's Report Menu>>

The Report menu contains selections which affect the entire
report design:

<Clear>
Clear                                               ( ALT+R C )

     Deletes everything from the report design: data fields,
     literals, and controls fields.

<Report Properties...>
Report Properties...                                ( ALT+R L )

     Calls the Report Properties window to specify attributes of
     the Report.

<Band Properties...>
Band Properties...                                  ( ALT+R B )

     Calls the Band Properties window to specify the attributes of
     the report band.  This selection is only active when the
     cursor is resting on the tracking characters delimiting the
     top of the report band.

<Exit>
Exit                                                ( ALT+R X )

     Closes the Report Formatter, saving the report design if you
     choose, and returns to the Text Editor.


<<Report Formatter's Fields Menu>>

When you place a field in your screen design, you should first
position the cursor to the spot where you want the field to be
placed.  If you do not position the cursor first, you could
define two fields to occupy the same place.

<Data...>
Data...                                             ( ALT+F D )

     Places a STRING field on the report.  This allows you to
     print the contents of any variable, or to create a report
     field to receive the value to print.

<Image...>
Image...

     Places a graphic image on a report. This enables you to print a
     graphic image to printers which use Printer Control Language
     (PCL). To print images make sure your printer supports PCL
     codes and is set to the correct emulation mode.

<Control...>
Control...                             ( ALT+F L )

     Places a CONTROL field on the report.  This allows you to
     send control strings to the printer at any point in the
     report.

<Text...>
Text...                                             ( ALT+F L )

     Places a TEXT field on the report.  A TEXT field prints
     multiple lines of text in the report, depending upon the
     amount of data to be printed.  Normally, a TEXT field prints
     the data contained in a MEMO field or a long STRING variable.


<<Report Formatter's Edit Menu>>

The Edit menu contains selections which affect individual items
placed on the report.

<Undo>
Undo                                      ( CTRL+U or ALT+E U )

     Restore the last item deleted by the Delete menu selection.

<Copy>
Copy                                      ( CTRL+C or ALT+E C )

     Copy a portion of the report design to another part of the
     report.

<Move>
Move                                      ( CTRL+M or ALT+E M )

     Move a portion of the report design to another part of the
     report.

<Delete>
Delete                                    ( CTRL+D or ALT+E D )

     Remove a portion of the report design from the report.

<Full Line Mode>
Full Line Mode                            ( CTRL+L or ALT+E L )

     Toggles between Line and Character modes for Copy, Move, or
     Delete.  This selection is a toggle switch with a check mark
     () displayed when toggled ON (Line mode).

<Draw Track>
Draw Track                                ( CTRL+T or ALT+E T )

     Allows you to place tracking characters (most commonly,
     single or double lines) in your report design.

<Duplicate>
Duplicate                                           ( ALT+E U )

     Displays a sub-menu which allows you to duplicate text.  You
     may duplicate the entire line, or individual characters
     (while the cursor moves left or right).

<Line>
Line                                    ( CTRL+2 or ALT+E U L )

     Duplicates the line the cursor is on.

<Character Left >
Character Left                ( SHIFT+GRAY-MINUS or ALT+E U C )

     Duplicates the character on the line immediately above the
     cursor.  The cursor then moves one position to the left.

<Character Right>
Character Right                ( SHIFT+GRAY-PLUS or ALT+E U R )

     Duplicates the character on the line immediately above the
     cursor.  The cursor then moves one position to the right.


<<Report Formatter's Options Menu>>

The Options Menu contains menu selections which allow you to do
specific things not covered by any other menu box.

<Suppress Line>
Suppress Line

     Specify a line of the report which is only printed if all
     fields on that line contain some value (are not blank).  This
     prevents the line from printing if there is no information to
     print.  Common use would be for a second address line which
     may or may not contain data.

<Create New Detail>
Create New Detail

     Add another DETAIL structure to the report.


<<Report Formatter's 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).

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


<<Report Formatter's Help Menu>>

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

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

     Provides information on how to use the Help system.

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

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

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

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


<<Report Properties Window>>

The Report Properties window allows you to declare the
attributes which are placed on the REPORT statement.  In this
window, you specify all of the global properties for the report.

<Label:>
Label:

     Enter the name of the REPORT which allows the report to be
     referenced in executable code statements.

<Page:>
Page:

     Enter the name of the variable for the PAGE attribute.

<Device:>
Device:

     Enter a string constant or variable containing the report's
     output DEVICE.

<Line:>
Line:

     Enter the name of the variable for the LINE attribute.

<Printer:>
Printer:

     A string expression, constant, or variable containing the
     name of the printer to be used for the report, as it appears
     in the printer control file (the PRINTER attribute).

<Prefix:>
Prefix:

     Enter the prefix for the report's PRE attribute.

<Length:>
Length:

     Enter an integer constant or variable containing the maximum
     number of lines to print per page (the LENGTH attribute).

<Width:>
Width:

     Enter the maximum number of columns per line (the WIDTH
     attribute).

<Append Report>
[] Append Report

     Check this box to add the APPEND attribute to the REPORT
     structure.  This will append the report to the end of any
     existing file when the report is directed to a disk file (or
     create the file if it does not exist).


<<Band Properties Window>>

The Band Properties window allows you to set up the attributes
of the DETAIL, HEADER, or FOOTER structure (see the Language
Reference) in which the cursor is currently positioned.  Each
band is a portion of the report which is printed separately.

<Fixed>
[] Fixed

     FIXED It ensures that the structure always uses a fixed
     number of print lines on the page.  Mailing labels are a good
     example of a report that would need to SUPPRESS blank lines,
     yet still print filed length labels.  FIXED is usually used
     along with SUPPRESS and pads the structure with the same
     number of blank lines as have been SUPPRESSed.

<Alone>
[] Alone

     The ALONE attribute specifies that the DETAIL structure is to
     be printed on the page without any HEADER or FOOTER.  The
     normal use would be for separate title and grand total pages.

<Separate>
[] Separate

     The SEPARATE attribute's value specifies the number of blank
     lines to print immediately following the structure.  The
     value can be an integer constant or variable.  The variable
     select arrow can only be selected when the Separate checkbox
     is ON.

<Allow>
[] Allow

     The ALLOW attribute specifies the minimum number of lines
     that must be left to print more DETAIL structures after
     printing the HEADER, DETAIL, or FOOTER structure.  Page
     overflow occurs if there are not enough lines available.
     ALLOW is designed to eliminate "widows" when the report
     prints.  The value can be an integer constant or variable.
     The variable select arrow can only be selected when the Allow
     checkbox is enabled (ON).

<Last>
[] Last

     The LAST attribute specifies that the DETAIL structure is the
     last DETAIL on the page.  Therefore, automatic page overflow
     occurs to print the FOOTER then the HEADER.  This attribute
     would normally be used on the DETAIL structure for a group
     footer.

<Label:>
Label:

     Enter the label of the HEADER, DETAIL, or FOOTER structure.

<Prefix:>
Prefix:

     Enter an (optional) label prefix for the report structure.


<<Field Selection Window>>

The Field Selection window allows you to define a report STRING
field.

<Use:>
Use:

     Specify the variable which supplies the value to print
     (placed in the USE attribute).

<Parameter:>
Parameter:

     You may specify one of the following:

     A string constant to print.  The length of the STRING field
     is set to the length of the initial value string.

     A numeric constant which defines the length of the print
     STRING.  This is usually used with a STRING field which has
     a Label, and so may be assigned values in the executable
     code.

     A picture token used to format values assigned to the STRING.
     This is usually used with a STRING which has a Label, and so
     may be assigned values in the executable code.  The length is
     the size needed to contain the formatted STRING.

<Label:>
Label:

     Enter the name of the report STRING which allows the field to
     be referenced in executable code statements.

<Overprint Next>
[] Overprint Next

     Specifies that at the end of printing this line, a Carriage
     Return with no line feed is sent to the printer.  Therefore,
     the next text line overprints the current line.

<Suppress Row/Col>
[] Suppress Row/Col

     Specifies that this STRING prints in the first column to the
     right of the preceding field.  This is used in conjunction
     with the CLIP attribute on a preceding field to the left.

<Attributes Button>
Attributes Button

     Allows you to specify the applicable attributes for this
     field.


<<Field Properties Window>>

The Field Properties window allows you to specify attributes for
a report field.

<Normal>
() Normal

     The first "Normal" selection specifies that the field will
     print "as-is" without justification.

<Left Justify>
() Left Justify

     Specifies that the value is left-justified within the field.

<Right Justify>
() Right Justify

     Specifies that the value is right-justified within the field.

<Center>
() Center

     Specifies that the value is centered within the field.

<Normal>
() Normal

     The second "Normal" selection specifies that the field will
     print as-is, with no case changes.

<Uppercase>
() Uppercase

     Specifies that the value is forced to uppercase when printed.

<Lowercase>
() Lowercase

     Specifies that the value is forced to lowercase when printed.

<Caps>
() Caps

     Specifies that the value is forced to proper-name case when
     printed.  The first letter of each word (each first letter
     following a blank space) in the field is capitalized, and all
     other letters are in lower case.

<Clip>
[] Clip

     Removes trailing spaces from the field.  Usually used in
     conjunction with the "Suppress Row/Col" selection on fields
     to its right to adjust their print position based on the
     number of trailing spaces removed from this field.


<<Control Fields Window>>

The Control Fields window allows you to declare a character
string that controls printer action.  This is a report CONTROL
field.

<Use:>
Use:

     Enter the name of the variable which contains the control
     code.

<Parameter:>
Parameter:

     You may specify one of the following:

     A string constant to send to the printer.  ASCII codes may be
     expressed in decimal form as in this example: '<27,15>'  This
     sends two characters to the printer: ASCII 27 and ASCII 15.

     A numeric constant which defines the length of the control
     code contained in the USE variable.  It must be the same
     length as the USE variable.

     A picture token used to format the values assigned to the
     CONTROL  field, or the values in the USE variable.  The
     initial value is set to spaces.

<Label:>
Label:

     The optional label of the CONTROL field, allowing the field
     to be referenced in executable code statements.


<<Text Field Window>>

The Text Field window allows you to declare a multiple-line
field to be printed.  This is a report TEXT field.

<Rows:>
Rows:

     Enter the maximum number of rows to print.

<Columns:>
Columns:

     Enter the number of columns of the TEXT field.

<Label:>
Label:

     Enter an optional label of the TEXT field, which allows the
     field to be referenced in executable code statements.

<Use:>
Use:

     Enter the name of the field to print.

<Word Wrap>
[] Word Wrap

     Enables automatic word-wrapping in a TEXT field.  This
     ensures that words are not split across print lines by
     padding the end of the line with blanks to push the word to
     the beginning of the next line.

<Suppress Row/Col>
[] Suppress Row/Col

     Allows you to specify that this TEXT field will print in the
     first column to the right of the preceding field.  This is
     used in conjunction with the CLIP attribute on the preceding
     field.

<Attributes Button>
Attributes Button

     Allows you to specify the applicable attributes for this
     field.


<<Pulldown Menu Formatter>>

The Pulldown Menu Formatter maintains PULLDOWN structures.  A
PULLDOWN is a data structure which defines the pulldown menu
design.

The PULLDOWN data structure allows you to place MENU and ITEM
fields within it.  A MENU is a structure containing other MENUs
and ITEMs in a menu.  An ITEM is a menu selection which, when
selected by the user, executes some procedure.

<Designing a Pulldown Menu>
Designing a Pulldown Menu

Since you are designing a pulldown menu, there is no executable
pulldown menu to allow selection of the formatter's functions.
Therefore, the available commands are described in the box
displayed in the middle of the screen.  Your menu design appears
as the pulldown menu displayed at the top of the screen.

The first selection on your pulldown menu is automatically
created for you as a MENU with an associated menu box.  The
ENTER key allows you to change this.  The INSERT key allows you
to add another top-level menu selection.  DELETE allows you to
remove the currently highlighted selection.

The DOWN ARROW takes you into the menu associated with a top-
level MENU.  The first item in the menu is automatically created
for you as an ITEM (without an associated menu).  The INSERT key
allows you to add another menu selection.  When you add another
MENU (with an associated menu) within a menu box, the RIGHT
ARROW takes you into its menu, allowing you to specify its
items.

The ESC key returns you to the previous level throughout the
menu.  When you are on the top level, ESC returns you to the
Application Generator.


<<Pulldown Menu Properties Window>>

The Pulldown Menu Properties window allows you to specify attributes
which are placed directly on the PULLDOWN statement of the PULLDOWN
menu data structure.

<Name:>
Name:

     Enter the label by which the PULLDOWN structure is referenced
     in source code statements.  This must be a valid Clarion
     label (only letters, numbers, colon, and underscore allowed -
     - it must begin with a letter or underscore).

<Help ID:>
Help ID:

     Enter the identifier for the Help screen which the user will
     see when F1 is pressed on any item which does not have its
     own Help ID.  The value you enter here is placed in the
     PULLDOWN statement's HLP attribute.  You may enter either a
     string constant (in single quotes) or variable name.

<Hot Key:>
Hot Key:

     Enter the Keycode Equate label (see Appendix A of the
     Language Reference) of a keystroke which will automatically
     activate the Pulldown menu when it is open but not currently
     displayed on screen.  The value you enter here is placed in
     the PULLDOWN statement's KEY attribute.

<Styles:>
Styles:

     Enter the name of the Styles file to use when you make color
     selections for your menu design.

<At Row:>
At Row:

     Enter the row number on which the Pulldown menu's Action bar
     will be displayed.  This value is placed in the PULLDOWN
     statement's AT attribute.  The default value is one (1).

<Local>
[] Local

     Check this box to indicate the Pulldown menu is displayed on
     line one of the physical screen without re-positioning the
     virtual screen (if its top line has scrolled off the
     display).  This places the LOCAL attribute on the PULLDOWN
     statement.

<Shadow>
[] Shadow

     Check this box to indicate that menu boxes display with a
     "ten o'clock" shadow.

<Border:>
Border:

     Select the Radio button for the type of border you want on
     the menu boxes which drop from the action bar:

     ()  Single -- single line tracks
          Places the SINGLE attribute on the PULLDOWN statement.

     ()  Double -- double line tracks
          Places the DOUBLE attribute on the PULLDOWN statement.

     ()  Half -- half-size block characters
          Places the HALF attribute on the PULLDOWN statement.

     ()  Full -- full-size block characters
          Places the FULL attribute on the PULLDOWN statement.

<Border Color Button>
Border Color Button

     Calls the Color Selection window to allow you to select the
     color style code parameter placed in the SINGLE, DOUBLE,
     HALF, or FULL attribute.

<Set Default Colors Button>
Set Default Colors Button

     Calls the Set Field Defaults window to allow you to select the
     default color style codes for all types of screen and pulldown
     menu fields.


<<Add/Change Menu Item Window>>

The Add/Change Menu Item window allows you to create or modify a
pulldown menu.  There are two types of pulldown fields:  MENU and
ITEM.  A MENU has an associated menu box containing other MENU
and/or ITEMs.  An ITEM appears in a MENU's menu box and is the only
type of pulldown field which completes the PULLDOWN structure,
causing the ACCEPT statement to return program control to your
executable source code.

<Type:>
Type:

     Select the type of menu selection to create.

() Standard

     Declares a MENU or ITEM.  If the Menu Box field is checked
     ON, a MENU is created.  If OFF, an ITEM is created.

() Toggle

     Specifies an ITEM with the TOGGLE attribute.  When turned on,
     the toggle variable is set to one, and a check mark displays
     beside the ITEM Name.  When turned off, the toggle variable
     is set to zero and the check mark disappears.

() Separator

     Separates selections in a menu box with a horizontal line.

<Name:>
Name:

     Enter a string constant which specifies the screen display
     for the ITEM.

<Field:>
Field:

     Enter the name of the field to receive the current state of
     an ITEM with the TOGGLE attribute.

<Help ID:>
Help ID:

     Enter the identifier for the Help screen which the user will
     see when F1 is pressed on the item.  The value you enter here
     is placed in the MENU or ITEM statement's HLP attribute.  You
     may enter either a string constant (in single quotes) or
     variable name.

<Use:>
Use:

     Enter a menu equate label which allows the ITEM field to be
     referenced in executable code statements.

<Hot Key:>
Hot Key:

     Specify the Clarion Keycode number or Keycode EQUATE label
     used to select and immediately execute this menu option.  The
     KEY attribute contains the value you enter here.

<Message:>
Message:

     Enter the message you want to be displayed when the user is
     on this pulldown menu item.  The value you enter here is
     placed in the menu field's MSG attribute.  By default, the
     message is displayed on the bottom line of the screen
     (unless changed by the SETMSG statement).

<Menu Box>
[] Menu Box

     Specifies a MENU structure which may contain other MENUs and
     ITEMs.

<Right>
Right

     Specifies that the menu item will display on the right side of
     the Action Bar.

<Menu Colors Button>
Menu Colors Button

Allows you to specify the color styles.


<<Save Current Changes Window>>

The Save Current Changes window verifies that you wish to save
changes you've made to your PULLDOWN MENU structure.

<Yes Button>
Yes Button

     Saves your changes and exits to the Text Editor.

<No Button>
No Button

     Abandons your changes and exits to the Text Editor.

<Cancel Button>
Cancel Button

     Returns you to the PULLDOWN MENU formatter, retaining your
     changes.

<<Auto Restore Window>>

This window appears only when you have exited a prior editing
session abnormally.

<Yes Button>
Yes Button

     Loads the AutoSaved version of your file (*.ASV).

<No Button>
No Button

     Loads the last saved version of your file.


<<Field Pick List>>
Field Pick List
     This window allows you to select a field from Dictionary Files.

<Files:>
Files:
     This List box displays the Files in the dictionary.

<Fields:>
Fields:
     This List box displays all the fields of the file selected
     from the Files List.  To select a file, highlight it and
     press ENTER, or DOUBLE-CLICK. Once you have selected a
     File, highlight the Field you want and press ENTER, or
     DOUBLE-CLICK on the field in the Fields List.

<Select Button>
Select Button
     Selects the currently highlighted field from the Fields
     List and returns to Editor. If the highlight bar is in the Files
     List, all fields in the highlighted file are displayed in
     the Fields List and the highlight bar moves to the Fields
     List.
