
<<CSHELL General Information>>

CSHELL is a disk file and directory maintenance program containing
similar functions to many of the DOS shell programs that are
commercially available (XTree Gold, Norton Commander, PCTools,
etc.).  CSHELL may be accessed from almost anywhere within the
Clarion environment by pressing F10, from the DOS Shell menu
selection in the Tools menu, or as a stand-alone program from the
DOS command line.

The four main areas of the CSHELL screen are the Drives List (left),
the Directory Tree (middle), the Files List (right), and the DOS
Command line (above).  The Drives List displays a list of all disk
drives which you may access.  The Directory Tree displays the
directory structure of the currently accessed Drive. The Files List
displays the files contained in the currently accessed directory.
CSHELL's DOS Command line allows you to execute any command which
may be executed from DOS.

<CSHELL Keystroke Conventions>
CSHELL Keystroke Conventions

The CSHELL pulldown menu contains selections for all the
operations which you may perform on files and directories.
There are also "hot" keys for most operations, listed to the
right of the menu item to which it is associated.  The ESC key,
mouse CLICK, or the ALT key and the highlighted letter of any of
the pulldown menu items, activates the pulldown menu.  Once the
pulldown menu is activated, the ESC key, or a mouse CLICK
anywhere outside the menu, de-activates it.

The mouse, the RIGHT ARROW and LEFT ARROW cursor keys, or TAB
and BACKTAB keys may be used to move the highlight bar between
the Files List, Directory Tree, and Drives List.

<<When the highlight bar is in the Files List:>>

When the highlight bar is in the Files List:

     CTRL+T allows you to Tag or Untag the currently highlighted
     file for multiple-file operations.

     CTRL+SPACEBAR allows you to "Flip" the Tags -- Tag all
     Untagged files and Untag all Tagged files -- in the current
     directory, for multiple-file operations.

     CTRL+U Untags all previously Tagged files (in all
     directories).

     The DELETE key deletes the currently highlighted file, or
     all the Tagged files.

     The ENTER key (or DOUBLE-CLICK) executes (in this order of
     precedence) either:

     1) Any command entered on the DOS command line

     2) the program associated with the extension of the currently
     highlighted file (see Hot Extensions... in the Options menu);
     or,

     3) the currently highlighted .BAT, .COM, or .EXE file.

     The GRAY-PLUS key places on the DOS Command line the
     filename and extension of the currently highlighted file.

     The GRAY-MINUS key places on the DOS Command line the
     filename (without extension) of the currently highlighted
     file.

<<When the highlight bar is in the Directory Tree:>>
When the highlight bar is in the Directory Tree:

     When you select the Directory Tree, the prompt "(DIR Locate)"
     appears below the DOS Command line.  The prompt "(DIR Locate)"
     indicates you are in DIRECTORY LOCATE mode. The first character
     you enter causes CSHELL to attempt to locate a subdirectory
     with a matching first character.  If there is no match for the
     character you enter, the character will not appear on the
     command line.  If there is a match CSHELL places the highlight
     bar on the matched directory name. If you enter additional
     characters CSHELL attempts to find a match for all characters
     entered.  To locate a new subdirectory, use the Backspace key
     to erase the previously entered character(s). To exit from "DIR
     Locate" mode, select the Files List or the Drive List.

     The INSERT key allows you to create a new directory.

     The DELETE key allows you to delete an entire directory.
     This option deletes the directory, all the files in that
     directory, and any sub-directories (including their files)
     below the directory being deleted.

     The ENTER key (or DOUBLE-CLICK) selects the currently
     highlighted directory for display in the Files List.

     The GRAY-PLUS key places on the DOS Command line the path
     of the currently highlighted directory with a trailing
     backslash (\).

     The GRAY-MINUS key places on the DOS Command line the path
     of the currently highlighted directory without a trailing
     backslash (\).


<<When the highlight bar is in the Drives List:>>
When the highlight bar is in the Drives List:

     The ENTER key (or DOUBLE-CLICK) selects the currently
     highlighted drive for display in the Directory Tree.

     The GRAY-PLUS and GRAY-MINUS keys both place on the DOS
     Command line the drive letter of the currently highlighted
     directory with a trailing colon (:).

<<On the DOS Command line:>>
On the DOS Command line:

     The ENTER key executes the Command line. If anything is on the
     DOS Command line, pressing ENTER executes it.

     The CTRL+LEFT ARROW key recalls, in the reverse order of
     their execution, the last ten commands executed from the
     DOS Command line.

     The CTRL+RIGHT ARROW key recalls, in the order of their
     execution, the last ten commands executed from the DOS
     Command line.

     If you select the Directory Tree, the prompt "(DIR Locate)"
     will appear below the DOS Command line.  The prompt
     indicates you are in DIRECTORY LOCATE mode.  As you enter
     characters CSHELL will attempt to locate a directory match.
     If there is no match for the character you enter, the
     character will not appear on the command line. To locate a
     new subdirectory, use the Backspace key to erase the
     previously entered character(s). To exit from "DIR
     Locate" mode, select the Files List or the Drive List.

<<File Menu>>

The File menu contains selections which allow you to maintain
the files on your disks.  Some of these menu selections allow
you to operate on one (currently highlighted) file or several
(tagged) files at once (those menu selections that only operate
on one file at a time are so noted).

Files may be Tagged in several directories at once; Tagged files
remain Tagged when you change to a new directory.  Therefore, it
is necessary that you be aware of which files you have Tagged
before beginning any multiple-file operation.

<Copy >
Copy                                      ( CTRL+C or ALT+F C )
     Copies the currently highlighted file, or all Tagged files,
     to another disk drive and/or directory.  If any files are
     Tagged, the currently highlighted file is copied only if it
     is also Tagged for multiple-file operation.

<Move >
Move                                      ( CTRL+M or ALT+F M )
     Moves the currently highlighted file, or all Tagged files,
     to another disk drive and/or directory.  If any files are
     Tagged, the currently highlighted file is moved only if it
     is also Tagged for multiple-file operation.

<Delete >
Delete                                    ( CTRL+D or ALT+F D )
     Removes the currently highlighted file, or all Tagged
     files, from the drive and directory (the same as the DOS
     DEL command).  If any files are Tagged, the currently
     highlighted file is deleted only if it is also Tagged for
     multiple-file operation.

<Rename >
Rename                                    ( CTRL+R or ALT+F R )
     Renames the currently highlighted file.  This selection
     operates only on the currently highlighted file, whether
     files are Tagged or not.

<View >
View                                      ( CTRL+V or ALT+F V )
     Allows you to examine the contents of the currently
     highlighted file in ASCII text mode.  This selection
     operates only on the currently highlighted file, whether
     files are Tagged or not.

<Edit >
Edit                                      ( CTRL+E or ALT+F E )
     Calls your text editor, allowing you to change the contents
     of the currently highlighted file.  This selection operates
     only on the currently highlighted file, whether files are
     Tagged or not.  The text editor is named in the Options menu.
     EDITOR.EXE is the Clarion Text Editor's name.

<Flashback >
Flashback                                 ( CTRL+F or ALT+F F )
     Recalls the last DOS screen.  This is useful when you
     execute a command which writes to the screen from the
     CSHELL command line.

<Print File >
Print File                                ( CTRL+P or ALT+F P )
     Prints the contents of the currently highlighted file.
     This selection works only with the currently highlighted
     file, whether files are Tagged or not.

<List Directory >
List Directory                            ( CTRL+L or ALT+F L )
     Prints a listing of the files displayed in the Files List.

<Set Tags>
Set Tags                                  ( ALT+F S )
     Displays a sub-menu which allows you to reverse the
     currently Tagged files, clear all tags, or specify files to
     be Tagged by filename, extension, size, or date/time stamp.

<Flip Tags>
Flip Tags                         ( CTRL Space or ALT+F S F )
     Reverses the currently Tagged files, Tagging those files
     that were not Tagged and Untagging those files that were.

<Clear Tags>
Clear Tags                              ( CTRL+U or ALT+F S C )
     Untags all currently Tagged files.

<Specify Tags...>
Specify Tags...                           ( ALT+F S S )
     Allows you to specify the files to be Tagged.  You may Tag
     files by filename, extension, size, or date/time stamp.

<Exit>
Exit                                      ( CTRL+X or ALT+F X )
     Returns you to DOS if invoked from CSHELL.EXE.  If invoked

     area from which you came.


<<Directory Menu>>

The Directory menu contains selections which allow you to
maintain the directories on the disk drive currently accessed in
the Drives List.

<Create>
Create                                    ( ALT+D C )
     Creates a new sub-directory.  It defaults to placing the
     new directory below the currently highlighted directory.
     The default may be overridden by typing in the explicit
     pathname to create over the default value.

<Delete>
Delete                                    ( ALT+D D )
     Deletes the currently highlighted directory.  All files and
     sub-directories below it are also deleted.

<Rename>
Rename                                    ( CTRL+R or ALT+D R )
     Renames the currently highlighted directory. This
     selection can rename only--it may not be used to
     re-structure the Directory Tree.

<Show Size>
Show Size                                 ( ALT+D S )
     Displays the amount of disk space occupied by the files in
     the currently highlighted directory.  All files in any sub-
     directories below it are included in the total.

<Rebuild Tree>
Rebuild Tree                              ( ALT+D E )
     Rebuilds the list of directories for the currently
     highlighted disk drive.  To speed performance, the
     directory structure for each drive is stored in a file on
     disk.  This selection re-reads the directory structure and
     updates the file used to display the Directory Tree for the
     currently accessed drive.

<List Info>
List Info                                 ( ALT+D L )
     Prints the Directory Tree, along with the amount of disk
     space used by each directory, to a printer or disk file.

<To Printer>
To Printer                                ( ALT+D L P )
     Prints the Directory Tree to the printer.

<To File...>
To File...                                ( ALT+D L F )
     Prints the Directory Tree to the disk file you name.


<<Utilities Menu>>

The Utilities menu contains selections which provide many useful
functions usually only available in commercial DOS shell
programs, not in an application development environment.  The
fact that they are useful to application developers is the
reason they are included.

<Search for File...>
Search for File...                        ( CTRL+S or ALT+U S )
     Searches the currently highlighted disk drive for all
     occurrences of the filename you specify.  The filename may
     include the DOS wildcard characters (? *).  When the search
     is complete, a list of all files (including their path)
     matching the filename is displayed.

<Search for Text...>
Search for Text...                        ( CTRL+Z or ALT+U T )
     Searches files for all occurrences of the text string you
     specify.  You may specify a file mask to limit the files
     searched.  You may also choose to search one directory, or
     one directory (which may be the root directory) and all its
     sub-directories.  When the search is complete, a list of
     all occurrences of the text string is displayed with the
     name of each file and the position within the file at which
     the text string was found.

<Global DOS Command...>
Global DOS Command...                     ( CTRL+G or ALT+U G )
     Allows you to enter one command, as if from the DOS prompt,
     which is executed in every sub-directory on the currently
     highlighted disk drive.

<Split File>
Split File                                ( ALT+U F )
     Allows you to split (copy) one file, too large for a single
     disk, across multiple floppy disks.  You select the target
     media (360K, 720K, 1.2M, or 1.44M), then the disk drive
     letter.  The floppy disks each receive a portion of the
     file, with the file's name and a numeric extension
     indicating which disk it is (filename.001, filename.002,
     filename.003, etc.).

     You can re-construct a split file by copying all the split-
     off portions to a hard disk (with room enough to hold all
     the split files and the original file after
     re-construction), then using the DOS COPY command. The
     COPY command must use the DOS append operator (+) to append
     the split files to the destination file.  It must also use
     a leading /b switch to indicate that the split files are
     binary.  An example re- construction command:

   COPY /b filename.001+filename.002+filename.003 filename.ext

<360K>
360K                                      ( ALT+U F 3 )
     Selects 5.25" Double Density disk as the target media for
     the split file.

<720K>
720K                                      ( ALT+U F 7 )
     Selects 3.5 Double Density disk as the target media for the
     split file.

<1.2M>
1.2M                                      ( ALT+U F 1 )
     Selects 5.25" High Density disk as the target media for the
     split file.

<1.44M>
1.44M                                     ( ALT+U F 4 )
     Selects 3.5 High Density disk as the target media for the
     split file.

<Wipe File>
Wipe File                                 ( CTRL+W or ALT+U W )
     Deletes the currently highlighted file, overwriting the
     disk space used by the file with ones (1), then zeroes (0),
     then random numbers.  This is done for security reasons, to
     prevent possible un-erase of deleted files by unauthorized
     personnel and subsequent compromise of data security.

<Hex Dump...>
Hex Dump...                               ( CTRL+H or ALT+U H )
     Allows you to view the contents of the currently
     highlighted file in Hexadecimal format.  The file is
     displayed with the Hexadecimal values on the left and their
     ASCII display characters on the right.  The ESC key
     activates the pulldown menu, which allows you to:  search
     for text strings or Hex numbers, jump to any byte position
     within the file, edit the file in Hex mode, and undo any
     changes made to the file (before exiting Hex mode, of
     course).

<Change Attributes...>
Change Attributes...                      ( CTRL+A or ALT+U C )
     Allows you to change the Hidden, System, and Read-Only
     attributes of the currently highlighted file.

<Hardware Information...>
Hardware Information...                   ( ALT+U I )
     Displays a screen containing the information reported by
     DOS regarding your computer's:  BIOS, DOS, CPU and
     Co-Processor, video, memory, output ports, and disk drives.


<<Options Menu>>

The Options menu contains selections which allow you to
customize the features available to you in CSHELL.  These
features affect the files display, the manner in which you
launch other programs from CSHELL, and the directory display.

<File Mask...>
File Mask...                              ( ALT+O F )
     Allows you to specify the files displayed in the Files List.
     The default file mask is for all files (*.*).

<Programs Only>
Programs Only                             ( CTRL+O or ALT+O O )
     Specifies that only .BAT, .COM, or .EXE files are displayed
     in the Files List.  This selection is a toggle switch with a
     check mark () displayed when toggled ON.

<Sort By...>
Sort By...                                ( ALT+O S )
     Allows you to select the sort order of the files displayed
     in the Files List.  They may be sorted in ascending or
     descending order by: name, extension, date, time, or size.
     You may also specify no sort, which displays the files in
     the order their entries appear in the DOS File Allocation
     Table (FAT).

<Editor Name...>
Editor Name...                            ( ALT+O N )
     Allows you to specify the text editor called when you Edit
     a file from CSHELL.  The Clarion Text Editor is specified
     by typing in: EDITOR.EXE.

<Hot Extensions...>
Hot Extensions...                         ( ALT+O E )
     Specifies programs to run when you press ENTER or DOUBLE-
     CLICK on the currently highlighted file in the Files List.
     The extension of the file determines which program is
     executed, based on the entries you make in the Hot
     Extensions list.  For example, you may specify that
     EDITOR.EXE is called to edit .CLA files, or PKUNZIP.EXE to
     un-compress .ZIP files.

<Hot Directories...>
Hot Directories...                        ( ALT+O D )
     Allows you to specify up to nine directories to go directly
     to when you press ALT+1 through ALT+9.  The directory
     specification may contain both the drive and the path,
     allowing you to change drives at the same time.

<Tree Location...>
Tree Location...                          ( ALT+O T )
     Names the drive and directory where the files containing
     the Directory Tree information for each disk drive are
     stored.

<Auto Rebuild...>
Auto Rebuild...                           ( ALT+O A )
     Specifies the number of days between automatic rebuild of
     the Directory Tree file for each disk drive.  If zero,
     automatic rebuild is disabled.

<Include Drives...>
Include Drives...                         ( ALT+O I )
     Allows you to specify the disk drives that CSHELL
     recognizes. CSHELL searches for active disk drives when it
     executes. Toggling a drive letter OFF (no check mark) on the
     Include Drives... screen means CSHELL will not look for that
     drive-- even if it exists.  Toggling a drive letter ON means
     CSHELL will look for that drive and display it in the Drives
     List only if it exists.

<Show Hidden>
Show Hidden                               ( ALT+O H )
     Displays all files in the Files List, including those files
     with the DOS Hidden attribute.  This selection is a toggle
     switch with a check mark () displayed when toggled ON.

<43/50 Lines>
43/50 Lines                               ( ALT+O 4 )
     Places the video in 43 or 50 line mode (depending upon
     whether your hardware is EGA or VGA).  This selection is a
     toggle switch with a check mark () displayed when toggled
     ON.

<DOS Pause>
DOS Pause                                 ( ALT+O P )
     Places a "Press any key to continue" message on screen,
     pausing for a keystroke, when returning to CSHELL from
     running any program.  This is true whether the program was
     run from the DOS Command line, a Hot Extension program, an
     executable program in the Files List, or a Menu program.
     This selection is a toggle switch with a check mark ()
     displayed when toggled ON.


<<"Menu">>

The Menu selection does not have an associated menu.  It
displays a screen from which you may create your own menu of
programs that you wish to run from CSHELL.

Selecting Menu from the pulldown action bar displays the
Application Menu screen.  This is a list of the programs you
have added to your menu.  From this screen you may add, change,
or delete programs from your menu.  If there are no programs to
display, you are automatically placed on the screen to add a
program.

When you execute one of your menu programs, CSHELL automatically
releases most of your computer's memory to the program you are
executing.  It also changes to the directory containing your
program.  When you complete execution of your program, CSHELL
returns to the directory from which it started and restores
itself to memory.


<<Tools Menu>>

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

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

<Calculator...>
Calculator...                             ( ALT+T C )
     Calls Clarion's built-in programmer's calculator.  The
     Calculator... selection is covered in its own Help section.

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


<<Help Menu>>

Context-sensitive Help screens are available throughout CSHELL
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 CSHELL,
     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 CSHELL.


<<Calculator Window>>

The Calculator menu selection, in both the Clarion environment
and CSHELL, pops up a full-featured programmer's calculator.
This calculator is specifically designed to supply functions and
operations that programmers need, in addition to the operations
common to all calculators.

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

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

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

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

<Calculator Use>
Calculator Use

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

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

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

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

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

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

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

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

     Enter a value.

     The value is displayed at the top of the screen.

     Complete an Operation Pushbutton.

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

     Enter a second value.

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

     Complete the = Pushbutton.

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

<Calculator Operations>
Calculator Operations

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

Addition

The + Pushbutton allows you to add two values.

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

Subtraction

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

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

Multiplication

The * Pushbutton allows you to multiply two values.

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

Division

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

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

Exponentiation

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

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

Modulus Division

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

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

AND

The AND Pushbutton allows you to compare the bits of the first
value entered to the bits of the second.  The resulting value
contains only the bits which are on (1) in both values.

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

OR

The OR Pushbutton allows you to compare the bits of the first
value entered to the bits of the second.  The resulting value
contains the bits which are on (1) in either of the values.

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

XOR

The XOR Pushbutton allows you to compare the bits of the first
value entered to the bits of the second.  The resulting value
contains the bits which are on (1) in only one of the values
(not both).

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


NOT

The NOT Pushbutton allows you to reverse the bits of the value
entered.  The resulting value contains zeroes (0) where there
were ones (1) and ones (1) where there were zeroes (0).

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

SHL

The SHL Pushbutton allows you shift left the bits of the first
value entered by the number of bits specified by the second
value.

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

SHR

The SHR Pushbutton allows you shift right the bits of the first
value entered by the number of bits specified by the second
value.

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


<<Copy/Move File Window>>

The Copy/Move File window allows you to enter the destination of
the Copy or Move.  For a File Copy, enter the name of the file
to create.  For a File Move, enter the path to which the file is
to be moved.  This may include a full DOS path.


<<Rename File Window>>

The Rename File window allows you to specify the new name of a
file.  Enter the new name for the file.  This may include a full
DOS path.


<<Rename Subdirectory Window>>

The Rename Subdirectory window allows you to specify the new
name of a directory on disk.

<Rename:>
Rename:
     Displays the current name of the directory.

<To:>
To:
     Enter the new name for the directory.


<<Specify Tags Window>>

The Specify Tags window allows you to set parameters to
automatically tag files.  If you specify more than one parameter
on this screen, only those fields which meet all requirements
are tagged.

<Name is:>
Name is:
     Enter a filename to tag.  The DOS wildcard characters (?
     and *) are allowed.  For example, enter CSHELL.* and all
     files named CSHELL (no matter what extension) are tagged.

<Extension is:>
Extension is:
     Enter a file extension to tag.  The DOS wildcard characters
     (? and *) are allowed.  For example, enter *.K?? and all
     files with an extension beginning with a K are tagged.

<Date is After:>
Date is After:
     Enter a date in mm/dd/yy format.  All files with a date
     later than the date you enter will be tagged.  For example,
     enter 01/01/90 and all files newer than January 1, 1990 are
     tagged.

<Date is Before:>
Date is Before:
     Enter a date in mm/dd/yy format.  All files with a date
     prior to the date you enter will be tagged.  For example,
     enter 01/01/90 and all files older than January 1, 1990 are
     tagged.

<Size is Greater Than:>
Size is Greater Than:
     Enter a number.  All files larger than the number you enter
     will be tagged.  For example, enter 24500 and all files
     larger than that are tagged.

<Size is Less Than:>
Size is Less Than:
     Enter a number.  All files smaller than the number you enter
     will be tagged.  For example, enter 24500 and all files
     smaller than that are tagged.


<<Drive Size Info Window>>

The Drive Size Info window allows you to name a disk file to
receive the printout of the Directory Tree, along with the
amount of disk space used by each directory.

<List to File:>
List to File:
     Enter the filename to print to.


<<Directory Size Window>>

The Directory Size window displays the amount of storage used by
all the files contained in the currently highlighted directory
(and all files in any sub-directories below that directory).


<<File Search Window>>

The File Search window allows you to search the current disk
drive for a specific file or files.

<Search Mask:>
Search Mask:
     Enter the filename for which to search.  The DOS wildcard
     characters (? and *) are allowed.  For example, enter
     CSHELL.* and all files named CSHELL (no matter what
     extension) are found.

<Recall Last Search Button>
Recall Last Search Button
     Calls the Files Matched window to re-display the results of
     the last File Search.


<<Files Matched Window>>

The Files Matched window displays the results of the last File
Search.

<View Button>
View Button
     Press this button to view the contents (in ASCII format) of
     the currently highlighted file in the Files Matched list.


<<Text Search Window>>

The Text Search window allows you to search the current disk
drive for some specific text contained in any file.  The search
may be limited, or "all-inclusive" of all files and sub-
directories on the disk.

<Search For:>
Search For:
     Enter the exact text string for which to search.  For
     example, enter CSHELL and all occurrences of CSHELL in the
     search file(s) are found.  Wildcard characters (? and *)
     are NOT allowed (the search will look for the ? or *
     character at that position in the string).

<File Mask:>
File Mask:
     Enter the filenames to include in the search.  The DOS
     wildcard characters (? and *) are allowed.  For example,
     enter CSHELL.* and only the files named CSHELL (no matter
     what extension) are searched.

<Search Dir:>
Search Dir:
     Enter the sub-directory through which to search.  This
     defaults to the DOS current directory, but you may override
     this to search another directory.

<Case Insensitive>
[] Case Insensitive
     Check this box to indicate that all occurrences of the
     Search For string are to be found, whether found in UPPER,
     lower, or Mixed case.

<Recurse Directories>
[] Recurse Directories
     Check this box to indicate that all sub-directories below
     the Search Dir are also included in the search.  If the
     Search Dir is set to the drive's root directory and the
     Recurse Directories box is checked, the entire disk drive
     is searched.


<<Global DOS Command Window>>

The Global DOS Command window allows you to issue one DOS
command which is executed in every sub-directory on the current
disk drive.  For example, enter DEL *.$$$ and all files with the
.$$$ extension will be deleted from every directory on the disk.


<<Split File Window>>

The Split File window allows you to split (copy) one file, too
large for a single disk, across multiple floppy disks.  Enter
the drive letter which contains the media to receive the split
file.  As each disk becomes full, you are automatically prompted
for another disk.  The floppy disks each receive a portion of
the file, with the file's name and a numeric extension
indicating which disk it is (filename.001, filename.002,
filename.003, etc.).

To re-construct a split file, copy all the floppy disk portions
to a hard disk (with room enough to hold all the split files and
the original file after re-construction), then use the DOS COPY
command.  The COPY command must use the DOS append operator (+)
to append the split files to the destination file.  It must also
use a leading /b switch to indicate that the split files are
binary.  An example re-construction command:

  COPY /b filename.001+filename.002+filename.003 filename.ext


<<Wipe File Window>>

The Wipe File window allows you an opportunity to abort the Wipe
File process.  The Wipe File process deletes the currently
highlighted file, overwriting the disk space used by the file
with ones (1), then zeroes (0), then random numbers.  This is
done for security reasons, to prevent possible un-erase of
deleted files by unauthorized personnel and subsequent
compromise of data security.

<Don't Wipe Button>
Don't Wipe Button
     Press this button to abort the wipe file process.

<Wipe Button>
Wipe Button
     Press this button to wipe the file.


<<Hex Dump Worksheet>>

The Hex Dump Worksheet displays the file in Hexadecimal mode in
the left portion of the Worksheet, and ASCII mode in the right
portion.  You may move the cursor from the Hexadecimal side to
the ASCII side with the TAB key.

All the possible tools that you may use in the Hex Dump
Worksheet 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.

File position offsets are listed at the left in Hexadecimal
format.


<<Hex Dump Pulldown Menu>>

The Hex Dump Pulldown Menu allows you to access the tools
available in the Hex Dump Worksheet.

<Search...>
Search...                                 ( CTRL+S or ALT+H S )
     Calls the Search For window to allow you to search for a
     Hexadecimal value or text string.

<Find Next>
Find Next                                 ( CTRL+N or ALT+H F )
     Searches for the next occurrence of the value just searched
     for.

<Jump>
Jump                                      ( CTRL+J or ALT+H J )
     Calls the Jump To Offset (Hex) window to allow you to go
     directly to a specific position within the file.  The
     position is identified by a Hexadecimal Offset from the
     beginning of the file.

<Undo Changes>
Undo Changes                              ( CTRL+U or ALT+H U )
     Aborts all changes made to the file in the Hex Dump
     Worksheet.  The restores the file to the state it was in
     when you entered the Hex Dump Worksheet.

<Mask>
Mask                                      ( CTRL+M or ALT+H M )
     Toggles the ASCII display on the right to display/mask-out
     the "unprintable" ASCII characters.

<Edit>
Edit                                      ( CTRL+E or ALT+H E )
     Toggles the Hex Dump Worksheet's Edit Mode.  When in Edit
     Mode, you may make changes to the file -- either in
     Hexadecimal format on the left, or in ASCII format on the
     right.

<Exit>
Exit                                      ( CTRL+X or ALT+H X )
     Closes the Hex Dump Worksheet, offering you the opportunity
     to save changes to the file, and returns to CSHELL.


<<Search For Window>>

The Search For window allows you to enter a value for which to
search in the file displayed in the Hex Dump Worksheet.  The
value for which to search may be a Hexadecimal number or a text
string.

If there is any possibility that the text string you wish to
search for could be interpreted as an Hexadecimal number, it
must be enclosed in single quotes.  For example, enter F01B and
a Hexadecimal search will ensue -- enter 'F01B' for an ASCII
text search.  Any text string which could not be an Hexadecimal
number may be entered without single quotes.


<<Jump to Offset (Hex) Window>>

The Jump to Offset (Hex) window allows you to enter a position
in the file (in Hexadecimal format) to go to.


<<Change Attribute Window>>

The Change Attribute window allows you to change the DOS file
attributes on the currently highlighted file.

<Hidden>
[] Hidden
     When checked, the file will not appear in a directory list
     using the DOS DIR command.

<System>
[] System
     When checked, the file will not appear in a directory list
     using the DOS DIR command.

<Read-Only>
[] Read-Only
     When checked, you can read the file but may not write to it.


<<Hardware Information Window>>

The Hardware Information window displays low-level information
about your computer.  This information can be important for
technical support if you are experiencing problems.


<<File Mask Window>>

The File Mask window allows you to specify a sub-set of files to
include in CSHELL's Files List display.

<File Mask:>
File Mask:
     Enter the filenames to include in the display.  The DOS
     wildcard characters (? and *) are allowed.  For example,
     enter CSHELL.* and only the files named CSHELL (no matter
     what extension) are displayed.


<<Sort Options Window>>

The Sort Options window allows you to define the order in which
files appear in CSHELL's Files List display.

<Sort By>
Sort By
     Select the appropriate Radio button for your desired sort
     order:

() Name
     When selected, files appear in the Files List in
     alphabetical order by the filename.

() Extension
     When selected, files appear in the Files List in
     alphabetical order by the extension.

() Date
     When selected, files appear in the Files List in the order
     of their date stamp.

() Time
     When selected, files appear in the Files List in the order
     of their time stamp.

() Size
     When selected, files appear in the Files List in the order
     of their relative size.

() None
     When selected, files appear in the Files List in the order
     of their appearance in the DOS File Allocation Table (FAT).

<Direction>
Direction
     Select the appropriate Radio button for the direction in
     which you want the files listed:

() Ascending
     When selected, files appear in the Files List in ascending
     order -- alphabetically from A to Z; date/time from Old to
     New; file size from Small to Large.

() Descending
     When selected, files appear in the Files List in descending
     order -- alphabetically from Z to A; date/time from New to
     Old; file size from Large to Small.


<<Editor Setup Window>>

The Editor Setup window allows you to specify the Text Editor
which CSHELL calls when you want to edit a file from within
CSHELL.

<Editor Name:>
Editor Name:
     Enter the name of the Text Editor to call. This may
     include a full path and must include the extension.  For
     example, to setup CSHELL to call Clarion's Text Editor,
     enter: EDITOR.EXE.

<Parameters:>
Parameters:
     Enter any command line parameters your Text Editor may
     require.  This does not include the name of the file to
     edit, since the file to edit is always supplied by CSHELL
     when you invoke your Text Editor through the Edit (CTRL+E)
     menu selection.


<<Hot Extensions Window>>

The Hot Extensions window displays a list of file extensions
which automatically execute programs you define when a file with
that extension is highlighted in the Files List and you press
ENTER or DOUBLE-CLICK the mouse.

<Add Button>
Add Button
     Calls the Update Hot Extension window to allow you to add a
     new file extension to your list.

<Change Button>
Change Button
     Calls the Update Hot Extension window to allow you to
     update the currently highlighted file extension in your
     list.

<Delete Button>
Delete Button
     Calls the Update Hot Extension window to allow you to
     delete the currently highlighted file extension in your
     list.


<<Update Hot Extension Window>>

The Update Hot Extension window allows you to define a file
extensions which will automatically execute a program you define
when a file with that extension is highlighted in the Files List
and you press ENTER or DOUBLE-CLICK the mouse.

<Extension:>
Extension:
     Enter the DOS filename extension which will "trigger" the
     program to execute.  This may include the period, but it is
     not necessary.

<Execute:>
Execute:
     Enter the command to execute.  This may include the full path
     to the program, MUST include the program's extension (.BAT,
     .EXE, or .COM), and may also have any command line parameters
     the program may require.

     If the name of the file is required in the program's command
     line, you may represent it three ways: %1, %N, or %E.

     %1 -- inserts the filename and extension of the currently
     highlighted file in the Files List at the time you press
     ENTER or DOUBLE-CLICK the mouse.

     %N -- inserts the filename (without extension) of the
     currently highlighted file in the Files List at the time you
     press ENTER or DOUBLE-CLICK the mouse.

     %E -- inserts the extension (only) of the currently
     highlighted file in the Files List at the time you press
     ENTER or DOUBLE-CLICK the mouse.


<<Hot Directories Window>>

The Hot Directories window allows you to maintain a list of up
to 9 sub-directories to change to immediately.  Pressing the ALT
key in conjunction with a number from 1 to 9 changes the DOS
current directory to the directory you specify in this list.

<Change Button>
Change Button
     Calls the Update Directory Path window to update the
     currently highlighted directory selection.

<Change To Button>
Change To Button
     Press this button to change to the currently highlighted
     directory.


<<Update Directory Path Window>>

The Update Directory Path window allows you to maintain a Hot
Directory entry.  You must enter a full path (including the
drive designator) to any existing directory on any drive to
which you have access.  To delete the Hot Directory, simply
delete all the text in the entry.


<<Directory Trees Location Window>>

The Directory Trees Location window allows you to specify the
directory where CSHELL's Directory Tree information is stored.
Each disk drive you may access has an associated Directory Tree
file.  This eliminates the need for CSHELL to constantly read
the disk to determine what sub-directories it contains.  For
example, the Directory Tree for drive C: is stored in the
CSHELL_C.TRE file.

If you do not specify a location for the Directory Tree files,
the file for each drive is stored in the root directory of that
drive.

<Drive/Directory:>
Drive/Directory:
     Enter a full path (including the drive designator) to any
     existing directory on any drive to which you have access.


<<Automatic Tree Rebuild Window>>

The Automatic Tree Rebuild window allows you to specify the
number of days which must pass before CSHELL Automatically
Rebuilds its Directory Tree files.  Each disk drive you may
access has an associated Directory Tree file.  This eliminates
the need for CSHELL to constantly read the disk to determine
what sub-directories it contains.  For example, the Directory
Tree for drive C: is stored in the CSHELL_C.TRE file.  If you do
not specify a location for the Directory Tree files, the file
for each drive is stored in the root directory of that drive.

CSHELL automatically updates its Directory Trees files if you
make any changes to the directory structure from within CSHELL.
However, it is possible to make directory changes of which
CSHELL is unaware.  Therefore, the Directory Tree files must
occasionally be rebuilt.

There are two ways to get CSHELL to rebuild its Directory Tree
files:  select the Rebuild Trees menu selection, or activate
Automatic Rebuild.  Automatic Rebuild enables CSHELL to ensure
that the Directory Tree displayed in the Directories List
accurately reflects the directories on the disk.

<Rebuild Every:>
Rebuild Every:
     Enter the number of days which must pass before CSHELL
     Automatically Rebuilds its Directory Tree files.  Enter zero
     (0) to disable Automatic Rebuild.


<<Include Drives Window>>

The Include Drives window allows you to specify the disk drives
which CSHELL will attempt to access.  CSHELL's Drives List is
built from the drives that are checked on this window.  Only
those drives which actually have existing disk drives associated
with them are included in the Drives List.


<<Application Menu Window>>

The Application Menu window displays a list of applications
which you may "launch" from within CSHELL.  You create the list
of applications that you want to appear on the menu.  Any
program available to you on your computer may be added to your
list.

<Run Button>
Run Button
     Executes the currently highlighted application.  This unloads
     CSHELL, freeing your computer's memory (all but about 1K) for
     the "launched" application's use, and runs the program.

<Delete Button>
Delete Button
     Removes the currently highlighted application from the list.

<Add Button>
Add Button
     Calls the Update Application window to add a new application
     to the list.

<Change Button>
Change Button
     Calls the Update Application window to update the currently
     highlighted application.

<Move Button>
Move Button
     Changes position within the list of the currently highlighted
     application.


<<Update Application Window>>

The Update Application window allows you to maintain the
applications which you can "launch" from within CSHELL.

<Program Name:>
Program Name:
     Enter the text that you want to be displayed in the
     Application Menu list.

<Drive:>
Drive:
     Enter the disk drive which contains the program's executable
     file.

<Path:>
Path:
     Enter the full path to the directory which contains the
     program's executable file.

<Filename:>
Filename:
     Enter the command to execute.  This MUST include the
     program's extension (.BAT, .EXE, or .COM).

<Parameters:>
Parameters:
     Enter any command line parameters the program may require.


<<ASCII Chart Window>>

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


<<Color Chart Window>>

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


<<Keycode Chart Window>>

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

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


<<Delete Files Window>>

The Delete Files window allows you to confirm or abort a file
deletion operation.

<Don't Delete Button>
Don't Delete Button
     Press this button to abort the deletion.

<Delete Button>
Delete Button
     Press this button to confirm the deletion.


<<Delete Subdirectories Window>>

The Delete Subdirectories window allows you to confirm or abort
a directory deletion operation.

<Don't Delete Button>
Don't Delete Button
     Press this button to abort the deletion.

<Delete Button>
Delete Button
     Press this button to confirm the deletion.


<<Create Directory Window>>

The Create Directory window allows you to make a new sub-
directory on disk.  This is equivalent to the DOS MkDir command.
The entry field defaults to the current directory, allowing you
to create a new directory without re-typing the currrent path.
You may override this default and create any directory you may
choose.


<<View File Window>>

The View File window displays a file in ASCII text mode.  The
cursor keys allow you to scroll through the file, both
vertically and horizontally.

PgUp and PgDn move you one screen page at a time.  CTRL+PgUp and
CTRL+PgDn take you to the beginng and end of the file.


