%@tit DEFT 1.01 - DOS Expert File Tender
%@toc 0003958 Title
%@toc 0004653 Technical Support
%@toc 0005310 Introduction
%@toc 0006045 Copyright Notice
%@toc 0006755 DISCLAIMER NOTICE
%@toc 0007624 Shareware License/Registration/Distribution Notice
%@toc 0011353 Registration Form
%@toc 0013263 Description
%@toc 0014725 Requirements
%@toc 0015267 Installation & Setup
%@toc 0015884 Documentation Syntax Conventions and Notations
%@toc 0018155 Display Screen
%@toc 0021842 Startup: General
%@toc 0022382 Startup: [listi]
%@toc 0026461 Startup: [options]
%@toc 0032773 Startup: Configuration File - General
%@toc 0033049 Startup: Configuration File - Parameter Record
%@toc 0033594 Startup: Configuration File - Function Key Record
%@toc 0034669 Startup: Configuration File - Extension Record
%@toc 0035890 Startup: Configuration File - Alias Record
%@toc 0036792 Keys: Brief Description (Also available via F1)
%@toc 0038093 Keys: ENTER      (execute command areas)
%@toc 0038216 Keys: CTL-ENTER  (display command areas)
%@toc 0038614 Keys: ESC        (clear commands, exit)
%@toc 0039054 Keys: F1         (HelpPrompt)
%@toc 0039790 Keys: F2         (HelpBar, HelpFile)
%@toc 0040148 Keys: Others     (Detailed Descriptions)
%@toc 0042054 Command Area: General
%@toc 0042798 Command Area: Automatic Fileid Appending
%@toc 0043637 Command Area: Automatic Fileid Appending Cancellation
%@toc 0044079 Command Area: Automatic Directory Navigation
%@toc 0044671 Command Area: :EXT (Extension) Processing
%@toc 0045536 Command Area: :ALIAS (Alias) Processing
%@toc 0046465 Command Area: Substitution Strings and Flags
%@toc 0049347 Command Area: Application/Command Execution ('Launching')
%@toc 0050644 Command Area: CD (Change Directory)
%@toc 0051171 Command Area: D: (Drive)
%@toc 0051698 Command Area: RENAME (Move)
%@toc 0052483 Command Area: ERASE/DELETE **WARNING**
%@toc 0054078 DEFT Command: General
%@toc 0054688 DEFT Command: =            (Repeat Previous Command)
%@toc 0055563 DEFT Command: ?            (Reset Previous Command)
%@toc 0057515 DEFT Command: /            (Make first line in display)
%@toc 0059791 DEFT Command: /A           (Search specific file Attributes)
%@toc 0060765 DEFT Command: /B           (Bell is audible or not)
%@toc 0061549 DEFT Command: /CD          (Change Drive/Directory)
%@toc 0063171 DEFT Command: /CL          (Change Drive/Directory and List)
%@toc 0066568 DEFT Command: /D           (Display 'nn' or maximum fileids)
%@toc 0067358 DEFT Command: /DI          (Display <fileid> or specified file)
%@toc 0068301 DEFT Command: /E           (Execute .BAT, .COM, .EXE files)
%@toc 0069090 DEFT Command: /F           (Find fileid with(out) chars)
%@toc 0071775 DEFT Command: /G           (Get Project disk file data)
%@toc 0072968 DEFT Command: /H           (HelpBar visible or not)
%@toc 0073705 DEFT Command: /K           (Display/reset Function Keys)
%@toc 0074224 DEFT Command: /L           (Reset [listi] data and list)
%@toc 0077099 DEFT Command: /L+          (Append [listi] data and list)
%@toc 0079206 DEFT Command: /M           (Mark/Move fileids in the list)
%@toc 0081566 DEFT Command: /O           (Order files by field value)
%@toc 0083087 DEFT Command: /P           (Put fileid|[listi] to disk file)
%@toc 0084802 DEFT Command: /R           (Refresh display after DOS)
%@toc 0085722 DEFT Command: /S           (Maximum RAM Storage required)
%@toc 0086631 DEFT Command: /T           (Search Tree for all occurrences)
%@toc 0087992 DEFT Command: /V           (Set Video characteristics)
%@toc 0088786 DEFT Command: /XI          (Exit DEFT)
%@toc 0089697 DEFT Command: /Y           (Set Substitution Symbol)
%@toc 0090725 Project Files
%@toc 0093674 Resource Utilization & Optimization
%@toc 0095674 Network Execution
%@toc 0096005 Windows Installation
%@toc 0096800 Hints
%@toc 0099056 Version History
%@toc 0099458 HELP Utilization
%@sec Title
%@ign variable text = DEFTA101 1.01 170KB 10/04/92
%@ign condxtrc: bbs = Bulletin Board Service distribution
%@ign condxtrc: dsk = Disk                   distribution
%@ign file: deftread.me2 start



                                 DEFT

                         DOS Expert File Tender


                              Version 1.01

                                 (BBS)

                                10/04/92

          Copyright 1992 Paul J. Dickler, all rights reserved:

Users,  sysops,  and  vendors  are  responsible  for compliance with the
Copyright, DISCLAIMER,  and Shareware  License/Registration/Distribution
notices in this document.
%@ign
%@sec Technical Support
Technical support for installation is via the command:

         DEFTINST

which offers Authenticity Verification information, demonstration
displays (tutorial), video color/attribute selection, registration,
production promotion, and more.


Technical support for 'Requests For Modification' and 'Problem Reports'
is available to registered users via:

Mail:    Paul J. Dickler
         P.O. Box 732
         Denville, NJ 07834


When requesting such support, be sure to specify the DEFT version you
are executing, your system configuration, and where you obtained your
copy of DEFT (BBS, vendor, etc.).
%@ign
%@sec Introduction
DEFT is a full-screen file listing program which provides a convenient
method of accessing and manipulating files from multiple drives and/or
directories simultaneously.  It is intended for PC users executing DOS
commands, batch files, user programs, and utilities, and creates a very
productive working environment.

DEFT commands allow sorting, appending, rebuilding, saving, and
restoring the interactive onscreen file list, and more.  A Configuration
File allows the user to specify command abbreviations and aliases,
default commands for specific file extensions, and function-key
definitions for frequently-issued commands.

Requires: DOS 3.00, 170KB, hard disk.  Registration: US $25/35.
%@ign
%@sec Copyright Notice
"DEFT" (the DEFT program, support programs and files - the "Software")
is copyrighted material, and remains the property of the author.

All users are automatically granted a limited license to distribute and
evaluate the Software in accordance with the terms and conditions in the
"DISCLAIMER NOTICE" and "Shareware License/Registration/Distribution
Notice", which follow.

┌──────────────────────────────────────────────────────────────────────┐
│ Continued use of the Software requires registration and payment,  as │
│ described below.                                                     │
└──────────────────────────────────────────────────────────────────────┘
%@ign
%@sec DISCLAIMER NOTICE
"DEFT" IS LICENSED ON AN "AS IS" BASIS, WITH NO WARRANTIES, EITHER
EXPRESS OR IMPLIED, WITH RESPECT TO ITS MERCHANTABILITY OR FITNESS FOR
ANY PARTICULAR PURPOSE.

ALTHOUGH GREAT EFFORT HAS GONE INTO THE DESIGN, CREATION, AND TESTING OF
THE SOFTWARE, THE VARIABILITY OF COMPUTING ENVIRONMENTS INTO WHICH IT
MAY BE LOADED AND EXECUTED REQUIRES THAT THE USER ACCEPT THE ENTIRE RISK
OF ANY AND ALL DAMAGES WHICH MAY BE SUFFERED.

ANY LIABILITY OF THE AUTHOR IS LIMITED EXCLUSIVELY TO PRODUCT
REPLACEMENT OR REFUND OF REGISTRATION FEE.

THESE TERMS AND CONDITIONS WILL BE CONSTRUED AND ENFORCED IN ACCORDANCE
WITH THE LAWS OF THE STATE OF NEW JERSEY, COUNTY OF MORRIS, USA, AS
APPLIED TO CONTRACTS ENTERED INTO AND PERFORMED WITHIN THAT
JURISDICTION.

SEE "SHAREWARE LICENSE/REGISTRATION/DISTRIBUTION NOTICE" WHICH FOLLOWS.
%@ign
%@sec Shareware License/Registration/Distribution Notice
DEFT is distributed as "shareware".

That is, the author, while retaining all rights, makes the Software
freely available to users, sysops (system operators), and vendors for
distributing, testing, and using under the following terms and
conditions:


License
────────────────────────────────────────────────────────────────────────
DEFT is licensed in 2 phases:

 1. Testing
    License is automatically granted to all users to test DEFT for a
    reasonable period of time.

 2. Using
    If, after the above test period, the user decides to use DEFT on a
    continuing basis, the user must 'register' such usage as follows:

    (See 'Registration Form' below for associated fees.)

Registration
────────────────────────────────────────────────────────────────────────
User Type:
──────────

    Single User
    ───────────
    For each possible simultaneous individual user, 1 registration is
    required.  A single user may place a copy of the Software on any
    number of computers, as long as only 1 copy is being executed at any
    given time.  However, multiple executions by a single user in a
    multi-tasking environment (i.e., multiple windows) are considered an
    individual use.

    Multiple User
    ─────────────
    For each possible simultaneous individual user, 1 registration is
    required.  Multiple users executing a single copy of DEFT in a
    network environment require multiple registrations.  However,
    multiple executions by each user in a multi-tasking environment are
    considered an individual use.

Version Type:
─────────────

    In-use Version
    ──────────────
    Upon registration, user receives instructions on removing the
    Shareware 'reminder' prompt from the DEFT program already in use.

    Upgrade Version
    ───────────────
    Upon registration, user receives instructions on removing the
    Shareware 'reminder' prompt from the DEFT program already in use.
    Also, when available, user receives the next upgrade version of DEFT
    and instructions for removing its reminder prompt.








Distribution:
───────────────────────────────────────────────────────────────────────
DEFT may ONLY be distributed by transmitting or copying the file:

    DEFTA101.ZIP

a compressed, virus-proof, Archive (requires PKUNZIP (PKWARE, Inc)).

Modification of the above, or distribution of any expanded DEFTA101
Archive files is STRICTLY FORBIDDEN, except as follows:

┌──────────────────────────────────────────────────────────────────────┐
│ Sysops and vendors may add files to the DEFTA101 Archive via the     │
│ PKZIP (PKWARE, Inc) program.  However, the ORIGINAL DEFTA101 Archive │
│ MUST BE PRESERVED, because it contains Authenticity Verification     │
│ data, which is cited in the Installation and Setup procedures.       │
└──────────────────────────────────────────────────────────────────────┘

Note:
Since the DEFTA101 Archive contains data encryption technology, it may
not be exported outside the United States or Canada.  Please contact the
author if an export version of the Software is required.

Additionally:

    Users
    ─────
    Users are encouraged to distribute DEFT to friends and other users,
    as above.

    Sysops
    ──────
    Sysops may charge at most the standard rate for the Sysops' services
    for connect time, file transmission, file copying, etc., for the
    above.

    Vendors
    ───────
    Vendors may charge at most US $5 for the above.
    Additionally, vendors must notify the author, in writing, of any
    distribution mechanism in use.

%@ign
%@sec Registration Form
%@ign file: deftreg.frm start
DEFT 1.01 (BBS) - Dos Expert File Tender - Registration Form

                                              Date:  ___________________

Send (and make check/money order payable) to:

                    Paul J. Dickler
                    P.O. Box 732
                    Denville, NJ  07834

From:
         Name:      __________________________________

         (Company:) __________________________________

         Street:    __________________________________

                    __________________________________

         City:      __________________________________

         State/Zip: __________________________________


In-use Version:
---------------
    Version Number:     _________________________

    Vendor/Distributor: _________________________

    Single   user             US $25
     2 - 10  users            US $23 each  Count: ______
    11 - 20  users            US $21 each
    21 & up  users            US $19 each      Sub total:  _____________


Upgrade Version:
----------------
    Single   user             US $35
     2 - 10  users            US $33 each  Count: ______
    11 - 20  users            US $31 each
    21 & up  users            US $29 each      Sub total:  _____________

    Diskette format (circle/check one):

         5.25" ______      3.5" ______

    Distribution is by single diskette -   Count: ______
    Extra copies:             US $5  each      Sub total:  _____________

    Distribution outside of United States
    and Canada:               US $5            Sub total:  _____________

    New Jersey residents -
    Add state tax:             %6.0            Sub total:  _____________


                                    Enclosed Grand total:  _____________
%@ign file: deftread.me2 stop
%@ign file: deftreg.frm stop
%@ign
%@sec Description
DEFT is a full-screen file listing program which provides a convenient
method of accessing and manipulating files from multiple drives and/or
directories simultaneously.  It is intended for PC users executing DOS
commands, batch files, user programs, and utilities, and creates a very
productive working environment.

A list of files from any combination of drives and directories is
created and displayed.  DOS commands may then be entered on the screen
which automatically include all (or specified) parts of the displayed
fileids (a file's drive, path, file-name, file-extension) as required,
or desired.

Batch files and applications may be 'launched' in the same manner.

'Project Files' containing file/path information may be created and
subsequently read to display specific collections of files.

DEFT Commands may also be entered to sort, rebuild, append, modify, and
manipulate the onscreen file list and display, and cause special actions
during DOS command processing.

As further aids to productive file manipulation, Configuration Files may
be utilized which can contain:

    * abbreviations and aliases for commands
    * default commands for specific file extensions
    * function-key definitions for frequently-issued commands

Different Configuration Files may be utilized for various combinations
of the above, allowing highly customized working environments for
different projects.
%@ign
%@sec Requirements
DEFT executes on any IBM PC or compatible running DOS 3.xx or higher.

DEFT utilizes approximately 170KB (kilobytes) of RAM, providing a
minimum file list of 200 entries.  Approximately 25 more bytes are
obtained for each additional entry above the 200, up to the current
implementation limit of 2,000.

A hard disk is strongly recommended because DEFT can be instructed to
'swap' itself from RAM to disk during DOS command execution to maximize
available RAM.  See 'Resource Utilization & Optimization'.
%@ign
%@sec Installation & Setup
%@ign file: deftread.me start
DEFT 1.01 (BBS) Installation and Setup (hard disk):
1. Create a new directory ('c' drive assumed here).  Enter:
         C:
         MKDIR \DEFT

2. Make the new directory current. Enter:
         CD \DEFT

3. Download/copy the 'DEFTA101.ZIP' Archive from your Bulletin
   Board Service (BBS) into the new directory.

4. Expand the Archive.  Enter:
         PKUNZIP DEFTA101

   Important: Note all "-AV", warning, and final messages.

5. Continue DEFT Installation and Setup.  Enter:
         DEFTINST
%@ign file: deftread.me stop
%@ign
%@sec Documentation Syntax Conventions and Notations
Syntax Conventions:
───────────────────
Upper-case is generally used to indicate characters or commands which
are to be entered as they appear, although when actually entered,
lower-case may be utilized.

Lower-case is generally used to indicate characters or commands which
are to be replaced by a user-specified parameter.

A REQUIRED parameter, or choice of required parameters, is indicated by
enclosing it within vertical bars.  That is, the following indicate that
'name0', and EITHER 'parm1' OR 'parm2' MUST be specified.  The vertical
bars, however, are not coded:

    |NAME0|        |PARM1|PARM2|        |PARM1|
                                        |PARM2|


An OPTIONAL parameter, or a choice of optional parameters, is indicated
by enclosing them within brackets, separated by a vertical bar, or
enclosed within vertical bars.  That is, the following indicate that
EITHER 'name0', 'name1', 'name2', OR NOTHING may be specified.  The
brackets and bars are not coded:

    [name0]        [name1|name2]       [|name1|]
                                        |name2|


If a parameter may be REPEATED, it will be followed by elipses:

    [...]


Notations:
─────────-
The following notation:

    [pathi]

    is used to indicate a path specification consisting of all or some
    of the following:

         [d:][\path\][fileid]

    where:

         [d:]
              Is a drive letter (A-Z), followed by a colon, as shown.

         [\path\]
              Is a complete path specification to a sub-directory, with
              the backslashes as shown.

         [fileid]
              Is a fileid specification which may contain the '?' and
              '*' characters (as in the DOS DIR command) to represent a
              single character or any number of characters,
              respectively.


The following notation:

    [listi]

    is a list of one or more drives, paths, fileids, 'special' file
    descriptors, or file attribute specifications, and is discussed
    fully in following sections.


The following notation:

    <ENTER>
    <ESC>
    etc...

    indicates that the named key is pressed.
%@ign
%@sec Display Screen
DEFT displays the following screen:
┌─────────────────────────────────────────────────────────────────────┐
│ DEFT v/as <<<<<<<<< current drive/directory >>>>>>>>> calendar/clock│
│  fs/fmax  <<<<<<<<  [listi] specification  >>>>>>>>> (error message)│
│ <fileid>     <size>  <date>  <time>  <path>                         │
│ <fileid>     <size>  <date>  <time>  <path>                         │
│ <fileid>     <DIR>   ------  ------  <path>                         │
│ ...etc...                                                           │
│ ~~ bytes~~  nnnnnn   ------  ------  <path>                         │
│ ...etc...                                                           │
│(<<<<<<<<<<<<<<<<<<<<<<<<<< HelpBar >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>)│
└─────────────────────────────────────────────────────────────────────┘

Where:
    Field                                               Video
         Description                                    Characteristics
    --------------------------------------------------------------------
    DEFT                                                        (Normal)
         Indicates the DEFT program.

    |v/  |                                                      (Normal)
    | /as|                                                     (Intense)
         Indicates the program Version number.

         Or, if the '/A...'  Attribute Specification has been issued,
         this field will indicate the file attributes currently included
         in any subsequent search, with the following characters:

              D - Directory files.
              S - System files.
              H - Hidden files.
              A - Archive flag set.
              R - Ready/only flag set.

    current drive/directory                                    (Hilight)
         Is the DOS Current Drive and Current Directory.

    calendar/clock                                              (Normal)
         Shows the current day, date, and time.
         The clock is updated only when the display is refreshed, not
         dynamically.

    fs/fmax                                                    (Intense)
         Shows the number (within the file list) of the first entry on
         the screen, followed by the total number of entries in the
         list.

    [listi] specification                                      (Intense)
         Is the list information specification which created the file
         list.

    error message                                              (Intense)
         If present, indicates what error occurred.

    |<fileid>| |<size>| <date>  <time>  <path>                  (Normal)
               |<attr>|                                        (Intense)
         Indicate the fileid, size (in bytes), date and time of last
         modification, and path information for each file in the list.

         <fileid> is Intense when Automatic Fileid Appending is in
         effect.

         <size> field is replaced by <DIR> for parent- and sub-
         directories.

         <size> field is replaced by <attr> '/A...' file Attribute
         characters when F3 key is pressed.

     ~~ bytes~~  nnnnnn   ------  ------  <path>                (Normal)
         Indicates the total byte count for all files satisfying the
         last [listi] search in the <path> directory.

    (<< HelpBar >>)                                          (Highlight)
         If turned on (by the <F2> key or '/HY' command), the last
         display line will show the labels for each defined Function
         Key.
%@ign
%@sec Startup: General
DEFT is started by the command:

    DEFT  [listi]  [options]

where:

    [listi]
    [options]

are described in the following sections.

If no [listi] is specified, all files in the Current Directory are
listed.

If no [options] are specified, the default Configuration File
'DEFT.CFG' is read for pre-coded [listi], [options], Function Key
definitions, command aliases, and abbreviations, and file-extension
default actions.  See 'Startup: Configuration File' section for full
details.
%@ign
%@sec Startup: [listi]
[listi] is a list of one or more drives, paths, fileids (possibly
containing 'wild' characters), 'special' file descriptors, or file
attribute specifications, separated by semicolons, as follows (note that
no blanks are allowed):

    |[pathi]   |  [;[pathi]]  [;[/A[x...]]]  [;[/G[fileid]]]
    |T'[pathi] |                             [;[/G@[fileid]]]
    |D'[pathi] |
    |A'[fileid]|
    |P'[fileid]|

where:

[pathi]
    Causes the files in the specified drive and path to be listed.
    If [d:] is not specified, the Current Drive is searched.
    If [\path\] is not specified, the Current Directory is searched.
    If [fileid] is not specified, all files are listed.
    [fileid] may contain the '?' and '*' characters as in the DOS DIR
    command to represent a single character, and any number of
    characters, respectively.

    Example:  c:\dir1\*.wrk;a:

              Lists all .WRK files in the c: drive DIR1 directory and
              all files in the a: drive root (\) directory.

T'[pathi]
    Causes all directories in the directory TREE to be searched.
    That is, all files in the specified (or defaulted) drive and
    directory, and all sub-directories are searched.
    If [d:] is not specified, the Current Drive is used.
    If [\path\] is not specified, the root (\) is used, thus causing a
    search of all directories on the drive.
    [fileid] (with wild characters) may be specified to filter the list.

    Example:  t'*.bak

              Lists all .BAK files on the Current Drive.

D'[pathi]
    Causes a search for sub-Directories only, as with T', above.
    That is, all sub-directories in the specified drive and directory,
    and all sub-directories are listed.
    If [d:] is not specified, the Current Drive is used.
    If [\path\] is not specified, the root (\) is used, thus causing a
    search of all directories on the drive.
    [fileid] may NOT be specified, as only sub-Directories are listed.

    Example:  d'\test\

              Lists all directories in the \TEST directory, and all
              subdirectories.

A'[fileid]
    Causes the Current Directory and each directory in the APPEND
    specification list, if active, to be searched.
    [fileid] (with wild characters) may be specified to filter the list.

    Example:  a'*.exe

              Lists all .EXE files in the APPEND directories.

P'[fileid]
    Causes the Current Directory and each directory in the PATH
    specification list, if active, to be searched.
    [fileid] (with wild characters) may be specified to filter the list.

    Example:  p'*.bat

              Lists all .BAT files in the PATH directories.

/A|N|x[x..]|
    Specifies the file Attributes for subsequent file searches, where
    'x' is as follows:

         N - Normal (all files and directory entries)
         D - Directories
         S - System
         H - Hidden
         A - Archive flag set on
         R - Read/only

    Except for 'N', attributes are exclusive, and additive.
    For example:

         '/AA'  lists only files with the Archive flag set.

         '/AAR' lists files with the Archive OR Read/only flags set.

    This operand takes effect immediately, and must be reset manually.
    Thus, the following:

         deft \work\;/aa;\prod\

    would list all the files in the \WORK directory, but only files with
    the Archive flag in the \PROD directory.

    Subsequent lists will only include files with the Archive flag on,
    until '/AN' (or another Attribute) is specified.


/G[fileid]
    Causes DEFT to Get file/path records from the [fileid] disk file,
    and list them.
    If [fileid] is not specified, 'WRK.DFT' is used.

    See 'Project Files' for full details.


/G@[fileid]
    Causes DEFT to Get the [listi] specification from the [fileid] disk
    file, and list the files described.
    If [fileid] is not specified, 'WRK.DFT' is used.

    See 'Project Files' for full details.
%@ign
%@sec Startup: [options]
DEFT [options] available are as follows:

/B|Y|N|
    Specifies whether the console bell is to be sounded for warnings.
    The bell is always sounded for severe errors.
    If not specified, the default is 'Y'.


/C[fileid]
    Specifies the Configuration File to be read during initialization.
    If not specified, defaults to 'DEFT.CFG', which must reside in the
    current directory or any PATH specification directory.
    If no Configuration File is desired, specify '/CNUL'.

    See 'Startup: Configuration File' for full details.


/D|nn|*|
    Specifies the number of fileids to display on the physical screen.
    Cannot exceed the number of lines in the physical screen.
    '/D*' causes all the lines in the physical screen to be utilized.
    If not specified, all lines in the physical screen are utilized.


/E|Y|N|
    Specifies how Executables (.BAT, .COM, and .EXE files) are to be
    handled:

         Y - A leading blank Command Area causes Execution.
             That is, the Executable <fileid> is pre-pended to any
             Command Area input and passed to DOS.

         N - An all-blank Command Area causes use of the Configuration
             File :EXT definition, if coded, for the above file types.

             See 'Startup: Configuration File' for details.

    If not specified, the default is 'N'.


/H|Y|N|
    Specifies whether the HelpBar is visible or not.

         Y - HelpBar is visible.

         N - HelpBar is not visible.

    If not specified, the default is 'N'.
    The HelpBar is also made visible by the first <F2> keypress.


/O[x[ss,ee]]
    Specifies the file list sort Order, where 'x' is as follows:

         A = Attributes, name, type.
         N = Name, type, path.
         E = Extension,  name, path-order.
         T = Type,       name, path-order (same as, above).
         S = Size, name, type.
         D = Date, time, name, type.
         P = Path,       name, type.
         Css,ee
           = specific Columns of fileid, where 'ss,ee' specify the
             start and end columns, each within the range 1-12.
             The comma (,) must be specified, and the columns in
             ascending order.
         O = sort turned Off.

    If not specified, default is '/ON'.


/R|Y|N|
    Specifies whether to Refresh the DEFT display immediately after
    executing any DOS commands, or wait for a keypress.

         Y - The screen is refreshed with the DEFT display immediately
             after completion of the last DOS command.

         N - The output from DOS commands may be viewed until a keypress
             restores the DEFT display.

             Whenever '/D[nn]' is issued specifying less than the
             maximum number of lines on the physical display, 'Refresh'
             is automatically enabled (/RY).  This leaves any DOS
             command output on the bottom of the display.

             Similarly, when '/D*' or '/D[nn]' specifies the maximum
             number of lines, 'Refresh' is automatically disabled.  This
             causes DEFT to wait for a keypress before restoring the
             file list display.


/S|Y|N|
    Specifies whether maximum RAM Storage is to be allocated for all DOS
    commands or not.

         Y - Causes the maximum RAM Storage to be allocated by
             'swapping' DEFT to a disk file.
             This causes increased processing overhead for each DOS
             command executed.

         N - Causes DOS commands to utilize whatever RAM Storage is
             available while DEFT is resident in RAM.

    If not specified, the default is 'N'.

    See 'Resource Utilization & Optimization' for full details.


/V[c[f,b]]
    Specifies the Video characteristics of various display fields,
    where:

         c   - Specifies which field type is to be set, as follows:

                   N - Is coded as shown, and represents 'Normal'.
                   H - Is coded as shown, and represents 'Highlighted'.
                   I - Is coded as shown, and represents 'Intense'.

               See 'Display Screen' for which field types are used in
               the various display areas.

         f,b - Represent the foreground/background color/attribute
               specifications, as listed below.

    Monochrome attribute specifications:

    1,0  - highlighted                1,8  - underline/blinking
    7,0  - normal                     7,8  - blinking
    9,0  - high intensity/underline   9,8  - high intens/underl./blink.
    14,0 - high intensity             15,8 - high intens/blink.
    7,0  - reverse video              0,15 - reverse video/blink.


    Color Foreground attribute specifications:

    0  - black            6  - brown              11 - light cyan
    1  - blue             7  - white              12 - light red
    2  - green            8  - gray               13 - light magenta
    3  - cyan             9  - light blue         14 - yellow
    4  - red              10 - light green        15 - bright white
    5  - magenta


    Color Background attribute specifications:

    0  - black            6  - brown               11 - cyan/blink.
    1  - blue             7  - white               12 - red/blink.
    2  - green            8  - black/blink.        13 - magenta/blink.
    3  - cyan             9  - blue/blink.         14 - yellow/blink.
    4  - red              10 - green/blink.        15 - white/blink.
    5  - magenta


    For example, to set 'Normal' fields on a color video screen to cyan
    characters on a black background, enter:

         /VN3,0

    During DEFT Installation and Setup, the DEFTINST program has a
    utility screen which makes this task an easy one.


/Y|c|
    Specifies the Substitution Symbol to cause insertion of fileid
    portions in commands, or special Flags to be set during DOS command
    execution.
    If not specified, defaults to '[' (left bracket).

    Note:
    Any Substitution Strings coded in a Configuration File must agree
    with the defaulted or specified Symbol.

    See 'Command Area: Substitution Strings and Flags'.
%@ign
%@sec Startup: Configuration File - General
The Configuration File is read during DEFT initialization, and may
contain the following types of records (all are optional):

    Parameter
    Function Key definition
    Extension default command
    Alias command
%@ign
%@sec Startup: Configuration File - Parameter Record
The 'Parameter' record may contain any valid DEFT command-line
specification:  [listi], and/or [option].

    parameter record

where:
    See 'Startup: [options]' and 'Startup: [listi]' for allowed
    operands.

    Example:

         *.exe;*.com;*.bat  /bn  /ey /od

    This parameter record would list all executable files in the Current
    Directory, turn the bell off for warnings, run executables with a
    blank Command Area, and order the fileids by date.
%@ign
%@sec Startup: Configuration File - Function Key Record
The 'Function Key' record defines a Function Key.

    :Kn  |label|  |[_]command-string|

where:
    :K        Is coded as shown.
    n         Is the Function Key number, in the range 4-12.
    label     Specifies the characters to appear in the HelpBar.
              May be 1-8 characters in length, with no blanks.
    [_]command-string
              Is any number of words, separated by blanks, up to a total
              of 66 characters.
              May contain any DEFT command, DOS command, Substitution
              Symbol, or Flag.
              If a leading blank is desired, code the underbar character
              ('_').

    Example:

         :k4  Refresh  /L=

    This labels the F4 key 'Refresh', which issues the DEFT '/L='
    command.

    Example:

         :k5  C-Comp  cc [n [s

    This labels the F5 key 'C-Comp', which causes execution of the 'cc'
    executable.  The filename is passed as a parameter, and maximum DOS
    storage is allocated.
%@ign
%@sec Startup: Configuration File - Extension Record
The 'Extension' record defines the default command for a particular file
extension to be executed when a blank Command Area is detected.  This
allows associating files with appropriate file viewers, editors, etc.

    :EXT    |ext|  |[_]command-string...|
            |*  |  |*                   |

where:
    :EXT      Is coded as shown.
    ext       Is a valid file extension, with NO period ('.').
              If '*' is coded, every file extension matches.
    [_]command-string...
              Is any number of words, separated by blanks, up to a total
              of 66 characters.
              May contain any DEFT command, DOS command, Substitution
              Symbol, or Flag.
              If a leading blank is desired, code the underbar character
              ('_').
              If '*' is coded, no action is performed.

    Example:

         :ext  doc  browse [r

    Here, a blank Command Area for a '.DOC' file causes the 'browse'
    executable to be run.  After execution, the DEFT display is
    refreshed without a pause.  Note that, by default, the full <fileid>
    will be appended to the command.
%@ign
%@sec Startup: Configuration File - Alias Record
The 'Alias' record defines a command alias/abbreviation.

    :ALIAS  |keyword|  |minlen|  |[_]command-string...|

where:

    :ALIAS    Is coded as shown.
    keyword   Is the 1-to-8 character command which is to be
              replaced.
    minlen    Is the minimum length of 'keyword' which must be
              specified in the Command Area.
    [_]command-string
              Is any number of words, separated by blanks, up to a total
              of 66 characters.
              May contain any DEFT command, DOS command, Substitution
              Symbol, or Flag.
              If a leading blank is desired, code the underbar character
              ('_').

    Example:

         :alias  purge  4  erase

    This defines the following commands to be identical to 'erase':

         purge
         purg
%@ign
%@sec Keys: Brief Description (Also available via F1)
Once the file list is created and displayed, the following keys are
available (full details below):

Esc - Clear cmnd; Clear all cmnds; Exit       Bksp - Backspace char
F1  - HelpPrompt                              Ins  - Toggle Insert mode
F2  - HelpBar, HelpFile                       Del  - Delete character
F3  - Show Alternate Information Fields       Home - First screen input
F4  - }                                       End  - Input start/end
F5  -  }                                  Ctl-Home - Toggle last screen
F6  -   }                                 Ctl-Del  - Delete to line end
F7  -    }                                    PgUp - Next     screen
F8  -     } User-defined: See HelpBar         PgDn - Previous screen
F9  -    }                                Ctl-PgUp - First screen
F10 -   }                                 Ctl-PgDn - Last  screen
F11 -  }                                      Tabf - Next Command Area
F12 - }                                       Tabb - Prev Command Area
                                             Enter - Process Commands
                                         Ctl-Enter - Show DOS commands
                                                     but don't execute
%@ign
%@sec Keys: ENTER      (execute command areas)
Enter
         Causes all Command Areas onscreen to be processed.
%@ign
%@sec Keys: CTL-ENTER  (display command areas)
Ctl-Enter
         Shows DOS commands but doesn't execute them.
         Process all Command Areas, but display resulting DOS commands
         only:  Do not pass them to DOS for execution.  An asterisk
         ('*') is placed before the command when displayed.

         This provides a way of testing a command prior to utilization.
%@ign
%@sec Keys: ESC        (clear commands, exit)
Esc      Clear cmnd; Clear all cmnds; Exit menu
         1st press causes current Command Area to be reset to <fileid>
                   information.
         2nd press causes all Command Areas onscreen to be reset.
         3rd press causes Exit Menu display.
                   Select desired Option with UP/DOWN ARROWs, then
                   <ENTER>, or cancel with <ESC>.
%@ign
%@sec Keys: F1         (HelpPrompt)
F1       HelpPrompt
         Causes a display of available DEFT Commands, Substitution
         Symbols, and Flags with select/insert capability.
         To use:
         * Position the cursor where the Command, Symbol, or Flag is
           required.
         * Press <F1>.
         * Use the ARROW and PAGE keys to select the desired operand.
         * Press <ENTER> to insert the operand at the cursor.
           Or, Press <F2> for HelpFile information on selection.
         * Edit/replace inserted Prompt to complete command input.
         * Press <ENTER> to issue command.

         Also contains a display of keyboard usage (but with no prompt
         capability).
%@ign
%@sec Keys: F2         (HelpBar, HelpFile)
F2       HelpBar, HelpFile
         1st press causes HelpBar to replace last utilized screen line.
         2nd press causes HelpFile display.
                   Once entered, press <F1> for Help on HelpFile.

         HelpBar is also made visible by the '/HY' command, described
         elsewhere.
%@ign
%@sec Keys: Others     (Detailed Descriptions)
F3       AltInfo
         Toggles between left and right portions of pathi fields, and
         HelpBar (if displayed), and Size or Attributes of files.

F4 -
F12      User-definable Function Keys
         These Function Keys may be defined in the Configuration File.

Bksp     Backspace char
         Causes cursor to move left 1 space, the character above it to
         be erased, and all characters to the right to be moved left.

Ins      Toggle Insert mode
         Causes Insert Mode to be turned On, then Off.

Del      Delete character
         Causes character above cursor to be deleted, and all characters
         to the right to move left.

Home     First screen input
         Causes cursor to be placed at the beginning of the first
         Command Area on the current screen.

End      Input start/end
         1st press moves cursor to end of current Command Area input.
         2nd press moves cursor to beginning of current Command Area.

Ctl-Home Toggle last screen
         Whenever a DEFT command causes a 'second' display by appending
         files to the current file list, this keypress will toggle
         between the current and last display positions.

Ctl-Del  Delete to line end
         Deletes all characters from the current cursor position to the
         end of the current line.

PgUp     Next screen
         Display next full screen of file list.

PgDn     Previous screen
         Display previous full screen of file list.

Ctl-PgUp First screen
         Display first screenful of file list.

Ctl-PgDn Last screen
         Display last screenful of file list.

Tabf     Next Command Area
         Move cursor to beginning of next Command Area on screen.

Tabb     Prev Command Area
         Move cursor to beginning of previous Command Area on screen.
%@ign
%@sec Command Area: General
Once the file list is displayed, DOS commands may be entered on any line
accessible by the cursor.  Use the Tab, Arrow, and Page keys to position
the display and cursor and select the desired fileid(s).

When any input is entered, the <size>, <date>, <time>, and <path> fields
are cleared, thus expanding the Command Area.

DOS commands may be entered for any number of the files on a single
screen, but they are not executed until the <ENTER> key is pressed.

After a command is executed, it is 'commented-out' by an asterisk being
placed in column 1 of the Command Area.  If a system error occurs, an
exclamation mark ('!') is placed in column 1 of the Command Area, and
the bell is sounded.
%@ign
%@sec Command Area: Automatic Fileid Appending
If a DOS command begins in column 1 of a Command Area, DEFT auto-
matically adds a blank and the fileid before executing the command.

For example, by simply entering the following (in column 1):

    edit

and pressing <ENTER>, DEFT will pass the command:

    EDIT fileid

to DOS for execution (where 'fileid' is from the <fileid> field).

If the fileid's path is the Current Directory, only the filename and
extension are inserted.

If the fileid's path is not the Current Directory, then the path is also
inserted.

If the fileid's drive is not the Current Drive, then the drive is also
inserted.

As a reminder of Automatic Fileid Appending, DEFT highlights the fileid
whenever the cursor is in column 1 of the Command Area, or if column 1
is not blank.
%@ign
%@sec Command Area: Automatic Fileid Appending Cancellation
If a Command Area begins with 1 or more leading blanks, DEFT cancels
Automatic Fileid Appending.

Therefore, to execute a DOS command with no fileid, simply enter at
least 1 leading blank, then the desired command.

DOS commands, program- and batch-file names may also be entered with
only portions of the fileid.  See 'Substitution Symbols and Flags' for
details.
%@ign
%@sec Command Area: Automatic Directory Navigation
Fileids marked '<DIR>' in the <size> field represent sub-directories.

Fileids '..' represent the parent of the sub-directory in the <path>
field.

By entering a blank on a <DIR> display line and pressing <ENTER>, DEFT
will reset the '<< [listi] specification >>' field from the target
directory, and rebuild the file list.

Note:
The Current Directory is NOT changed.

Note:
When changing to a parent ('..') directory, the new file list is
positioned to the previous sub-directory entry in the list, not at the
top.
%@ign
%@sec Command Area: :EXT (Extension) Processing
If a Command Area is blank (that is, it begins with 1 or more leading
blanks, and has no other characters), a check is performed against
Configuration File :EXT records for a match.  If the <fileid> extension
is found, then the Command Area is set to the associated :EXT
'command-string'.

Thus, for example, if the following Configuration File record was
specified:

    :ext  txt  edit

And, at least 1 blank (and nothing else) was entered on the following
DEFT display line:

    MYFILE   TXT  _   200  06/02/92  10:00  c:\curdir

Then, the following DOS command would be executed:

    edit MYFILE.TXT

Note:
:EXT processing utilizes Automatic Fileid Appending, even though the
Command Area begins with a blank.

See 'Startup:  Configuration File - Extension Record' for details.
%@ign
%@sec Command Area: :ALIAS (Alias) Processing
After the :EXT check is performed, the first word in the Command Area is
compared against Configuration File :ALIAS records for a match.

If a match is found, the first word in the Command Area is replaced by
the associated :ALIAS 'command-string'.

Example:
If the following Configuration File record was specified:

    :alias  display 1 viewfile [r

And, the single-character command 'd' was entered on the following DEFT
display line:

    MYFILE   TXT  d   200  06/02/92  10:00  c:\curdir

Then, the following DOS command would be executed:

    viewfile MYFILE.TXT

Additionally, the '[R' flag causes DEFT to refresh the screen
immediately after command execution.  That is, upon exiting the VIEWFILE
program, DEFT will restore the file list display, without user
intervention.

Obviously, you may create abbreviations in addition to aliases.
%@ign
%@sec Command Area: Substitution Strings and Flags
In either the Command Area, :EXT-, or :ALIAS- 'command-string', special
'Substitution Strings' and/or 'Flags' may be specified to cause
insertion of the <fileid> (or parts of it) into the command, or cause
special processing during the DOS command execution.

If the Substitution String contains any part of the fileid, Automatic
Fileid Appending is cancelled.

Note:
The left bracket is the default Substitution Symbol, and thus is
ENTERED AS SHOWN.  This may be changed by the '/Yc' command, described
elsewhere.

String    Action ('*' = Automatic Fileid Appending NOT cancelled)
───────── ──────────────────────────────────────────────────────────
[b        Insert fileid with following blank  ('b' = blank)
[C        Insert fileid with Complete drive and path
[F        Insert fileid with no following blank
[G        Insert fileid without path
[D        Insert file's drive and colon (:)
[N        Insert file name
[T        Insert file type (extension)
[E        Insert file type (extension)
[P        Insert file's path (with drive and colon)
[Q        Insert file's path (without drive)
[+[++..]  Insert next     (1st, 2nd, 3rd, ...) fileid in list
[-[--..]  Insert previous (1st, 2nd, 3rd, ...) fileid in list
[[        Insert Substitution Symbol
[R       *Display can be Refreshed after this DOS command
[S       *Maximum Storage is required for this DOS command

Example:
 ┌───────────────────────────────────────────────────────────────────┐
 │deft 1.01 c:\mydir\                             Mon 01/02/92, 13:45│
 │  1/3     *.fta                                                    │
 │FNAAAA   FTA      100  06/21/92  10:00  c:\mydir\                  │
 │FNBBBB   FTB  erase [n.*<ENTER>                                    │
 │FNCCCC   FTC      300  06/23/92  12:00  c:\mydir\                  │
 └───────────────────────────────────────────────────────────────────┘

Causes the following command to be issued:

    ERASE FNBBBB.*

Note:
Pay careful attention to the Current Drive/Current Directory when
issuing global commands (those with '*' or '?'  -- effecting more than
just the <fileid> file).

See 'Command Area: ERASE/DELETE **WARNING**' for details.

Example:
 ┌───────────────────────────────────────────────────────────────────┐
 │deft 1.01 c:\mydir\                             Mon 01/02/92, 13:45│
 │  1/3     *.fta                                                    │
 │FNAAAA   FTA      100  06/21/92  10:00  c:\mydir\                  │
 │FNBBBB   FTB  compare [ [+<ENTER>                                  │
 │FNCCCC   FTC      300  06/23/92  12:00  c:\mydir\                  │
 └───────────────────────────────────────────────────────────────────┘

Causes the following command to be issued:

    COMPARE  FNBBBB.FTB  FNCCCC.FTC
%@ign
%@sec Command Area: Application/Command Execution ('Launching')
To run an executable (file extension of .BAT, .COM, or .EXE) enter:

    [c<ENTER>

This will cause the Complete <path>/<fileid> to be passed to DOS.

If parameters are desired, they may be entered as follows:

    [c  parm1  parm2  ...<ENTER>

Additionally, if the '/EY' command has been issued, Executables can be
run simply by specifying a leading blank in the Command Area.

Note:
This facility allows you to bypass the normal DOS PATH directory search
order, and run a specific executable.  This is convenient for testing
new versions of programs that are not in the PATH definition.

Example:
 ┌───────────────────────────────────────────────────────────────────┐
 │deft 1.01 c:\mydir\                             Mon 01/02/92, 13:45│
 │  1/3     *.fta                                                    │
 │MYAPPLIC BAT  [c [+ <ENTER>                                        │
 │FNBBBB   FTB      100  06/21/92  10:00  c:\mydir\                  │
 │FNCCCC   FTC      100  06/21/92  10:00  c:\mydir\                  │
 └───────────────────────────────────────────────────────────────────┘

This would cause the following command to be passed to DOS:

    c:\mydir\MYAPPLIC.BAT FNBBBB.FTB
%@ign
%@sec Command Area: CD (Change Directory)
A DOS 'cd' (Change Directory) command is intercepted anywhere in a
Command Area, and even if entered in column 1, is NOT automatically
appended.

The specified directory is made the new Current Directory, the bell is
sounded, and the '<< current directory >>' field is updated.

Note:
The [listi] specification (and thus the current file list) is NOT
changed.

To Change Directory and reset the file list simultaneously, see
'DEFT Command: /CL (Change and List)'.
%@ign
%@sec Command Area: D: (Drive)
The DOS 'd:'  (Drive) command is intercepted anywhere in a Command Area,
and even if entered in column 1, is NOT automatically appended.

After a 'd:'  command completes, the '<<<< current drive/directory >>>>'
display area is updated with the new Current Drive, and the bell is
sounded.

The [listi] specification (and thus the current file list) is NOT
changed.

To change the current Drive and reset the file list simultaneously, see
'DEFT Command: /CL (Change and List)'.
%@ign
%@sec Command Area: RENAME (Move)
The 'RENAME' command is intercepted anywhere in a Command Area, and may
be used to rename files and sub-directories.

Additionally, if you specify a different path in the new name of a file,
it will be removed from the old directory, and placed in the new
directory, thus 'moving' the file.

After a successful rename, the file list and display are updated with
the new fileid and/or path information.

If 'd:'  is included in the old fileid, it must be the same in the new
fileid:  You cannot move a file to a new drive.

If the file is not in the Current Directory, and no directory is
specified in the new fileid, the original (old) directory is assumed.

No 'wild' characters are allowed in either the old or new fileids.
%@ign
%@sec Command Area: ERASE/DELETE **WARNING**
Although no special processing is performed for the DOS 'ERASE' and
'DELETE' commands, they are mentioned here to describe the processing
that DEFT performs for each <fileid> with a DOS command in its Command
Area.

After a DOS command completes, DEFT checks for the existence of <fileid>
in its displayed <path>.  If the file still exists, all the fields in
the display line are updated.  If the file has been erased, the file
statistics fields are replaced with:

    -- not found --

However, if you execute commands or batch files which affect files other
than the one in the <fileid> field, DEFT will not update those fileid's
fields, as it has no way of knowing which files have been affected.

In fact, if a command creates new files, they will not even appear in
the file list until the list is manually re-built.

This facet of DEFT may be overlooked in many cases:
For example, assume you execute a program which updates a <fileid>
already in the file list.  Although the statistics may be incorrect, you
may still access the file, and issue DOS commands against it, so long as
the <fileid> and <path> information remain correct.

However, assume you execute a program which creates a file only
sometimes (for example, a compiler creating an error-message file, only
when errors occur):  Unless the fileid is in the display list prior to
the file's creation, or the list is re-built, the file's existence may
go unnoticed!

See the DEFT Command '/L=' for a quick method of rebuilding the file
list.
%@ign
%@sec DEFT Command: General
In addition to DOS commands, DEFT supports 'DEFT Commands' which
modify the file list, DOS environment, or perform other functions.

DEFT Commands begin in column 1 of the Command Area, and start with
the '/' (slash) character.

Normally they should be executed one-at-a-time, and followed immediately
by <ENTER>.

However, those noted by '##' may be entered multiple times on a screen
prior to <ENTER>.

A concise list of all DEFT Commands with HelpPrompt capability is
available via the <F1> key.

Each DEFT Command is discussed in the following sections.
%@ign
%@sec DEFT Command: =            (Repeat Previous Command)
=         ##  Reset Command Area with last command, and execute.
=?            Reset with Selected previous command, and execute.
              A menu is presented for the selection.

Example:
 ┌───────────────────────────────────────────────────────────────────┐
 │deft 1.01 c:\mydir\                             Mon 01/02/92, 13:45│
 │  1/3     *.fta                                                    │
 │FNAAAA   FTA  erase                                                │
 │FNBBBB   FTB  =                                                    │
 │FNCCCC   FTC  =<ENTER>                                             │
 └───────────────────────────────────────────────────────────────────┘

Results in the following commands:

    ERASE FNAAAA.FTA
    ERASE FNBBBB.FTB
    ERASE FNCCCC.FTC
%@ign
%@sec DEFT Command: ?            (Reset Previous Command)
?         ##  Reset Command Area with last command, but don't execute.
??            Reset with Selected previous command, but don't execute.
              A menu is presented for the selection.

Example:
 ┌───────────────────────────────────────────────────────────────────┐
 │deft 1.01 c:\mydir\                             Mon 01/02/92, 13:45│
 │  1/3     *.fta                                                    │
 │FNAAAA   FTA  erase<ENTER>                                         │
 │FNBBBB   FTB      100  06/21/92  10:00  c:\mydir\                  │
 │FNCCCC   FTC      100  06/21/92  10:00  c:\mydir\                  │
 └───────────────────────────────────────────────────────────────────┘

Followed by:

 ┌───────────────────────────────────────────────────────────────────┐
 │deft 1.01 c:\mydir\                             Mon 01/02/92, 13:45│
 │  1/3     *.fta                                                    │
 │FNAAAA   FTA           -- not found --  c:\mydir\                  │
 │FNBBBB   FTB  ?                                                    │
 │FNCCCC   FTC  ?<ENTER>                                             │
 └───────────────────────────────────────────────────────────────────┘

would result in the following:

 ┌───────────────────────────────────────────────────────────────────┐
 │deft 1.01 c:\mydir\                             Mon 01/02/92, 13:45│
 │  1/3     *.fta                                                    │
 │FNAAAA   FTA           -- not found --  c:\mydir\                  │
 │FNBBBB   FTB  erase                                                │
 │FNCCCC   FTC  erase                                                │
 └───────────────────────────────────────────────────────────────────┘

At this point, you can hit <ENTER> to execute the commands, or <ESC> 2
times, to clear all Command Areas.
%@ign
%@sec DEFT Command: /            (Make first line in display)
/             Make this line first in display.
/[nnn]        Make line number 'nnn' first in display.

Example:
 ┌───────────────────────────────────────────────────────────────────┐
 │deft 1.01 c:\mydir\                             Mon 01/02/92, 13:45│
 │  1/3     *.fta                                                    │
 │FNAAAA   FTA      100  06/21/92  10:00  c:\mydir\                  │
 │FNBBBB   FTB  /<ENTER>                                             │
 │FNCCCC   FTC      100  06/21/92  10:00  c:\mydir\                  │
 └───────────────────────────────────────────────────────────────────┘

Results in the following:
 ┌───────────────────────────────────────────────────────────────────┐
 │deft 1.01 c:\mydir\                             Mon 01/02/92, 13:45│
 │  2/3     *.fta                                                    │
 │FNBBBB   FTB      100  06/21/92  10:00  c:\mydir\                  │
 │FNCCCC   FTC      100  06/21/92  10:00  c:\mydir\                  │
 │                                                                   │
 └───────────────────────────────────────────────────────────────────┘


Example:
 ┌───────────────────────────────────────────────────────────────────┐
 │deft 1.01 c:\mydir\                             Mon 01/02/92, 13:45│
 │  1/3     *.fta                                                    │
 │FNAAAA   FTA  /3                                                   │
 │FNBBBB   FTB      100  06/21/92  10:00  c:\mydir\                  │
 │FNCCCC   FTC      100  06/21/92  10:00  c:\mydir\                  │
 └───────────────────────────────────────────────────────────────────┘

Results in the following:

 ┌───────────────────────────────────────────────────────────────────┐
 │deft 1.01 c:\mydir\                             Mon 01/02/92, 13:45│
 │  3/3     *.fta                                                    │
 │FNCCCC   FTC      100  06/21/92  10:00  c:\mydir\                  │
 │                                                                   │
 │                                                                   │
 └───────────────────────────────────────────────────────────────────┘
%@ign
%@sec DEFT Command: /A           (Search specific file Attributes)
/A|N|x[x..]|  Search Normal, System, Dir, Hidden, Archive, Read-only
              files in subsequent searches.
              See 'Startup: [listi]'  for details.

Example:
 ┌───────────────────────────────────────────────────────────────────┐
 │deft 1.01 c:\mydir\                             Mon 01/02/92, 13:45│
 │  1/3     *.fta                                                    │
 │FNAAAA   FTA  /anr<ENTER>                                          │
 │FNBBBB   FTB      100  06/21/92  10:00  c:\mydir\                  │
 │FNCCCC   FTC      100  06/21/92  10:00  c:\mydir\                  │
 └───────────────────────────────────────────────────────────────────┘

Causes the next files search to include only Read/only files.  The 'n'
sets 'Normal', and the 'r' sets Read/only.

The 'v/as' display field is set to the characters representing the file
attributes specified.
%@ign
%@sec DEFT Command: /B           (Bell is audible or not)
/B|Y|N|       Bell is audible or not for warnings
              The bell is always sounded for severe errors.

Example:
 ┌───────────────────────────────────────────────────────────────────┐
 │deft 1.01 c:\mydir\                             Mon 01/02/92, 13:45│
 │  1/3     *.fta                                                    │
 │FNAAAA   FTA  /bn                                                  │
 │FNBBBB   FTB      100  06/21/92  10:00  c:\mydir\                  │
 │FNCCCC   FTC      100  06/21/92  10:00  c:\mydir\                  │
 └───────────────────────────────────────────────────────────────────┘

Causes the Bell to be silenced for warning messages.
No change in the display occurs.
%@ign
%@sec DEFT Command: /CD          (Change Drive/Directory)
/CD[pathi]    Make specified [drive:][\path\] the Current Drive and
              Current Directory.
              If no [pathi] is supplied, no action is taken.
              If [drive:] is not specified, the Current Drive is used.
              If [\path\] is not specified, the Current Directory on the
              current (or specified) drive is used.

              Note:
              The file list is not changed.

Example:
 ┌───────────────────────────────────────────────────────────────────┐
 │deft 1.01 c:\mydir\                             Mon 01/02/92, 13:45│
 │  1/3     *.fta                                                    │
 │FNAAAA   FTA  /cdb:\backup\                                        │
 │FNBBBB   FTB      100  06/21/92  10:00  c:\mydir\                  │
 │FNCCCC   FTC      100  06/21/92  10:00  c:\mydir\                  │
 └───────────────────────────────────────────────────────────────────┘

This will cause the Current Drive and Directory to be changed, but not
the file list, as follows:

 ┌───────────────────────────────────────────────────────────────────┐
 │deft 1.01 b:\backup\                            Mon 01/02/92, 13:45│
 │  1/3     *.fta                                                    │
 │FNAAAA   FTA      100  06/21/92  10:00  c:\mydir\                  │
 │FNBBBB   FTB      100  06/21/92  10:00  c:\mydir\                  │
 │FNCCCC   FTC      100  06/21/92  10:00  c:\mydir\                  │
 └───────────────────────────────────────────────────────────────────┘
%@ign
%@sec DEFT Command: /CL          (Change Drive/Directory and List)
/CL=          Rebuild file List from Current Directory.

/CL?          Make Current/List from Selected previous specification.
              A menu box is presented with previous [listi]
              specifications, allowing selection.

/CL[pathi]    Make specified [drive:][\path\] the Current Drive and
              Current Directory and List the files therein.
              If no [pathi] is supplied, the Current Directory is used.
              If [drive:] is not specified, the Current Drive is used.
              If [\path\] is not specified, the Current Directory is
              used, unless [drive:] is new, in which case, '\' (the
              root) is used.
              [fileid] may also be specified to filter the list.
              Note:
              [\path\], if coded, must always include the ending '\'
              to indicate [\path\], rather than [fileid].




Example:
 ┌───────────────────────────────────────────────────────────────────┐
 │deft 1.01 c:\mydir\                             Mon 01/02/92, 13:45│
 │  1/3     *.fta                                                    │
 │FNAAAA   FTA  /cl=<ENTER>                                          │
 │FNBBBB   FTB      100  06/21/92  10:00  c:\mydir\                  │
 │FNCCCC   FTC      100  06/21/92  10:00  c:\mydir\                  │
 └───────────────────────────────────────────────────────────────────┘

This will cause all files in the c:\mydir\ directory to be listed.


Example:
 ┌───────────────────────────────────────────────────────────────────┐
 │deft 1.01 c:\mydir\                             Mon 01/02/92, 13:45│
 │  1/3     *.fta                                                    │
 │FNAAAA   FTA  /clb:\prod\*.bat<ENTER>                              │
 │FNBBBB   FTB      100  06/21/92  10:00  c:\mydir\                  │
 │FNCCCC   FTC      100  06/21/92  10:00  c:\mydir\                  │
 └───────────────────────────────────────────────────────────────────┘

This will cause the b:\prod\ directory to become the Current Directory,
and all the .BAT files in it to be listed.  Note the change in drive.


Example:
Assume the following:
 ┌───────────────────────────────────────────────────────────────────┐
 │deft 1.01 c:\mydir\                             Mon 01/02/92, 13:45│
 │  1/3     *.fta                                                    │
 │SUBDIR        <DIR>    --------  -----  c:\mydir\                  │
 │FNBBBB   FTB      100  06/21/92  10:00  c:\mydir\                  │
 │FNCCCC   FTC      100  06/21/92  10:00  c:\mydir\                  │
 └───────────────────────────────────────────────────────────────────┘

Then, the following:
 ┌───────────────────────────────────────────────────────────────────┐
 │deft 1.01 c:\mydir\                             Mon 01/02/92, 13:45│
 │  1/3     *.fta                                                    │
 │SUBDIR        /cl[c\<ENTER>                                        │
 │FNBBBB   FTB      100  06/21/92  10:00  c:\mydir\                  │
 │FNCCCC   FTC      100  06/21/92  10:00  c:\mydir\                  │
 └───────────────────────────────────────────────────────────────────┘

would make the SUBDIR directory the Current Directory, and list all
the files within it.
%@ign
%@sec DEFT Command: /D           (Display 'nn' or maximum fileids)
/D|nn|*|      Display 'nn' or maximum number of fileid's.
              See 'Startup: [options]' for full details.

Example:
 ┌───────────────────────────────────────────────────────────────────┐
 │deft 1.01 c:\mydir\                             Mon 01/02/92, 13:45│
 │  1/3     *.fta                                                    │
 │FNAAAA   FTA  /d*<ENTER>                                           │
 │FNBBBB   FTB      100  06/21/92  10:00  c:\mydir\                  │
 │FNCCCC   FTC      100  06/21/92  10:00  c:\mydir\                  │
 └───────────────────────────────────────────────────────────────────┘

would result in the maximum number of fileids to be displayed on each
screen.
%@ign
%@sec DEFT Command: /DI          (Display <fileid> or specified file)
/DI[fileid]   Display <fileid> or specified file.

              The file is displayed by an internal DEFT routine which
              provides convenient scroll capability.

              Once entered, press <F1> for Help on its use.
Example:
 ┌───────────────────────────────────────────────────────────────────┐
 │deft 1.01 c:\mydir\                             Mon 01/02/92, 13:45│
 │  1/3     *.fta                                                    │
 │FNAAAA   FTA  /di                                                  │
 │FNBBBB   FTB  =                                                    │
 │FNCCCC   FTC  /diabc.def<ENTER>                                    │
 └───────────────────────────────────────────────────────────────────┘

This would cause first the file 'FNAAAA.FTA' to be displayed, then file
'FNBBBB.FTB', then file 'ABC.DEF'
%@ign
%@sec DEFT Command: /E           (Execute .BAT, .COM, .EXE files)
/E|Y|N|       Execute .BAT, .COM, .EXE files, or use Config File :EXT.
              See 'Startup: [options]' for full details.

Example:
 ┌───────────────────────────────────────────────────────────────────┐
 │deft 1.01 c:\mydir\                             Mon 01/02/92, 13:45│
 │  1/3     *.fta                                                    │
 │FNAAAA   FTA  /ey<ENTER>                                           │
 │FNBBBB   FTB      100  06/21/92  10:00  c:\mydir\                  │
 │FNCCCC   FTC      100  06/21/92  10:00  c:\mydir\                  │
 └───────────────────────────────────────────────────────────────────┘

This causes a leading blank Command Area to run executable files.
%@ign
%@sec DEFT Command: /F           (Find fileid with(out) chars)
/F[!][cc.cc]  Find (not) specific fileid in list.
/F[!][ccc]    Find (not) filename with specified characters (in list).
/F[!].[ccc]   Find (not) filetype with specified characters (in list).
/F[!]\        Find (not) same path as this fileid's         (in list).

              Characters specified may be 1-8 for filename searches, and
              1-3 for filetype searches.

              When successful, the <fileid> which satisifes the search
              is made the first <fileid> on the screen.

Example:
 ┌───────────────────────────────────────────────────────────────────┐
 │deft 1.01 c:\mydir\                             Mon 01/02/92, 13:45│
 │  1/3     *.fta                                                    │
 │FNAAAA   FTA  /fnb<ENTER>                                          │
 │FNBBBB   FTB      100  06/21/92  10:00  c:\mydir\                  │
 │FNCCCC   FTC      100  06/21/92  10:00  c:\mydir\                  │
 └───────────────────────────────────────────────────────────────────┘

Results in the following:
 ┌───────────────────────────────────────────────────────────────────┐
 │deft 1.01 c:\mydir\                             Mon 01/02/92, 13:45│
 │  2/3     *.fta                                                    │
 │FNBBBB   FTB      100  06/21/92  10:00  c:\mydir\                  │
 │FNCCCC   FTC      100  06/21/92  10:00  c:\mydir\                  │
 │                                                                   │
 └───────────────────────────────────────────────────────────────────┘

Example:
 ┌───────────────────────────────────────────────────────────────────┐
 │deft 1.01 c:\mydir\                             Mon 01/02/92, 13:45│
 │  1/3     *.fta                                                    │
 │FNAAAA   FTA  /f.tc<ENTER>                                         │
 │FNBBBB   FTB      100  06/21/92  10:00  c:\mydir\                  │
 │FNCCCC   FTC      100  06/21/92  10:00  c:\mydir\                  │
 └───────────────────────────────────────────────────────────────────┘

Results in the following:
 ┌───────────────────────────────────────────────────────────────────┐
 │deft 1.01 c:\mydir\                             Mon 01/02/92, 13:45│
 │  3/3     *.fta                                                    │
 │FNCCCC   FTC      100  06/21/92  10:00  c:\mydir\                  │
 │                                                                   │
 │                                                                   │
 └───────────────────────────────────────────────────────────────────┘
%@ign
%@sec DEFT Command: /G           (Get Project disk file data)
/G[fileid]    Get Project disk file and list files therein.
              If [fileid] is not specified, 'WRK.DFT' is used.
              See 'Project files' for full details.

/G@[fileid]   Get Project disk file [listi] specification and list.
              Specifies a file to be read which contains a [listi]
              specification as the first record.
              If [fileid] is not specified, 'WRK.DFT' is used.
              See 'Project files' for full details.

Example:
 ┌───────────────────────────────────────────────────────────────────┐
 │deft 1.01 c:\mydir\                             Mon 01/02/92, 13:45│
 │  1/3     *.fta                                                    │
 │FNAAAA   FTA  /glist1.dft<ENTER>                                   │
 │FNBBBB   FTB      100  06/21/92  10:00  c:\mydir\                  │
 │FNCCCC   FTC      100  06/21/92  10:00  c:\mydir\                  │
 └───────────────────────────────────────────────────────────────────┘

Results in the file 'LIST1.DFT' being read, and the display being
rebuilt from the <fileid> and <path> records within.
%@ign
%@sec DEFT Command: /H           (HelpBar visible or not)
/H|Y|N|       Specifies whether the HelpBar is visible or not.

              See 'DEFT [options]' for full details.

Example:
 ┌───────────────────────────────────────────────────────────────────┐
 │deft 1.01 c:\mydir\                             Mon 01/02/92, 13:45│
 │  1/3     *.fta                                                    │
 │FNAAAA   FTA  /hy<ENTER>                                           │
 │FNBBBB   FTB      100  06/21/92  10:00  c:\mydir\                  │
 │FNCCCC   FTC      100  06/21/92  10:00  c:\mydir\                  │
 └───────────────────────────────────────────────────────────────────┘

This makes the HelpBar visible.
%@ign
%@sec DEFT Command: /K           (Display/reset Function Keys)
/K[nn]        Display/reset Function Key labels/definitions.

              If 'nn' (which must be in the range 4-12) is entered, the
              specific Function Key label/definition is displayed, and
              the user allowed to reset them.

              The new Function Key definition is valid until reset
              again, or until DEFT is exited.  The new definition is not
              saved in the Configuration File.
%@ign
%@sec DEFT Command: /L           (Reset [listi] data and list)
/L=           Rebuild List with current [listi] specification.
              The Current Directory is not changed.

/L?           Set [listi] with Selected previous specification.
              A menu box is presented with previous [listi]
              specifications, allowing selection.
              The Current Directory is not changed.

/L            Set [listi] with (modified) current specification.
              An input box is presented with the current [listi]
              specification, which may be modified.
              The Current Directory is not changed.

/L[listi]     Set [listi] specification and create new file list.
              All valid [listi] specifications may be entered.

              See 'Startup [listi]' for full details.

              The Current Directory is not changed.

Example:
 ┌───────────────────────────────────────────────────────────────────┐
 │deft 1.01 c:\mydir\                             Mon 01/02/92, 13:45│
 │  1/3     *.fta                                                    │
 │FNAAAA   FTA  /L=<ENTER>                                           │
 │FNBBBB   FTB      100  06/21/92  10:00  c:\mydir\                  │
 │FNCCCC   FTC      100  06/21/92  10:00  c:\mydir\                  │
 └───────────────────────────────────────────────────────────────────┘

Causes the file list to be rebuilt using '*.fta'.  This simply causes
the list to be 'refreshed', and is a good candidate for a Function Key
definition in the Configuration File.


Example:
 ┌───────────────────────────────────────────────────────────────────┐
 │deft 1.01 c:\mydir\                             Mon 01/02/92, 13:45│
 │  1/3     *.fta                                                    │
 │FNAAAA   FTA  /L\dir2\a*.bat<ENTER>                                │
 │FNBBBB   FTB      100  06/21/92  10:00  c:\mydir\                  │
 │FNCCCC   FTC      100  06/21/92  10:00  c:\mydir\                  │
 └───────────────────────────────────────────────────────────────────┘

Causes the [listi] specification to be reset to '\dir2\a*.bat', and any
files meeting that specification to be listed.


Example:
 ┌───────────────────────────────────────────────────────────────────┐
 │deft 1.01 c:\mydir\                             Mon 01/02/92, 13:45│
 │  1/3     *.fta                                                    │
 │FNAAAA   FTA  /L[p<ENTER>              (c:\mydir\)                 │
 │FNBBBB   FTB      100  06/21/92  10:00  c:\mydir\                  │
 │FNCCCC   FTC      100  06/21/92  10:00  c:\mydir\                  │
 └───────────────────────────────────────────────────────────────────┘

Causes the [listi] specification to be reset to 'c:\mydir\', and all
files in that directory to be listed.
%@ign
%@sec DEFT Command: /L+          (Append [listi] data and list)
/L+[listi]    Append current [listi] with new specification, and append
              file list with resulting <fileid>'s.
              '/L+' is specified as shown.
              All valid [listi] specifications may be entered.
              See 'Startup [listi]' for full details.

              If any files are found, they are appended to the current
              file list, and the display is positioned to the new files.

              Toggle current/last display with <CTL-HOME> keypress.

              Execute '/O...'  (Order) or '/M...'  (Move) commands to
              merge both lists.

              The Current Directory is not changed.

Example:
 ┌───────────────────────────────────────────────────────────────────┐
 │deft 1.01 c:\mydir\                             Mon 01/02/92, 13:45│
 │  1/3     *.fta                                                    │
 │FNAAAA   FTA  /L+\dir2\a*.bat<ENTER>                               │
 │FNBBBB   FTB      100  06/21/92  10:00  c:\mydir\                  │
 │FNCCCC   FTC      100  06/21/92  10:00  c:\mydir\                  │
 └───────────────────────────────────────────────────────────────────┘

Causes the listi specification to be appended with '\dir2\a*.bat', and
any files meeting that specification to be added to the list.


Example:
 ┌───────────────────────────────────────────────────────────────────┐
 │deft 1.01 c:\mydir\                             Mon 01/02/92, 13:45│
 │  1/3     *.fta                                                    │
 │FNAAAA   FTA  /L+/aa;\*.bat<ENTER>                                 │
 │FNBBBB   FTB      100  06/21/92  10:00  c:\mydir\                  │
 │FNCCCC   FTC      100  06/21/92  10:00  c:\mydir\                  │
 └───────────────────────────────────────────────────────────────────┘

Causes the [listi] specification to be appended and those files to be
appended to the list.  The specification includes all .BAT files in the
root (\) directory with the Archive flag set on.
%@ign
%@sec DEFT Command: /M           (Mark/Move fileids in the list)
/M        ##  Mark <fileid> for subsequent '/MH' to Move it in list.
              Mark any number of <fileid>'s on any screens in the
              current file list.
              The files will be moved in the order they are marked.
              All files marked on a screen via a single <ENTER>, are
              ordered top to bottom as they appear. To change the
              order, issue <ENTER> after each '/M'.

/MM           Start/end block of <fileids> to Move.
              Enter 2 times anywhere in file list to mark all included
              <fileids> for subsequent '/MH'.

/MH           Move Marked <fileid>'s Here in list.
              Enter after all '/M' or both '/MM' commands.

Example:
 ┌───────────────────────────────────────────────────────────────────┐
 │deft 1.01 c:\mydir\                             Mon 01/02/92, 13:45│
 │  1/3     *.fta                                                    │
 │FNAAAA   FTA      100  06/21/92  10:00  c:\mydir\                  │
 │FNBBBB   FTB      100  06/21/92  10:00  c:\mydir\                  │
 │FNCCCC   FTC  /m<ENTER>                                            │
 └───────────────────────────────────────────────────────────────────┘

Followed by:
 ┌───────────────────────────────────────────────────────────────────┐
 │deft 1.01 c:\mydir\                             Mon 01/02/92, 13:45│
 │  1/3     *.fta                                                    │
 │FNAAAA   FTA  /mh<ENTER>                                           │
 │FNBBBB   FTB      100  06/21/92  10:00  c:\mydir\                  │
 │FNCCCC   FTC  *m                                                   │
 └───────────────────────────────────────────────────────────────────┘

Results in the following:
 ┌───────────────────────────────────────────────────────────────────┐
 │deft 1.01 c:\mydir\                             Mon 01/02/92, 13:45│
 │  1/3     *.fta                                                    │
 │FNCCCC   FTC      100  06/21/92  10:00  c:\mydir\                  │
 │FNAAAA   FTA      100  06/21/92  10:00  c:\mydir\                  │
 │FNBBBB   FTB      100  06/21/92  10:00  c:\mydir\                  │
 └───────────────────────────────────────────────────────────────────┘
%@ign
%@sec DEFT Command: /O           (Order files by field value)
/O[x[ss,ee]]  Order file list by Attrib, Name, Ext. (Type), Size,
                                 Date, Path, Cols ss-ee, Off
              If no Order character is specified, the list is ordered
              according to the current character.

              See 'DEFT [options]' for full details.

Example:
 ┌───────────────────────────────────────────────────────────────────┐
 │deft 1.01 c:\mydir\                             Mon 01/02/92, 13:45│
 │  1/3     *.fta                                                    │
 │FNAAAA   FTA  /od<ENTER>                                           │
 │FNBBBB   FTB      200  06/22/92  10:00  c:\mydir\                  │
 │FNCCCC   FTC      300  06/23/92  10:00  c:\mydir\                  │
 └───────────────────────────────────────────────────────────────────┘

Results in the following:
 ┌───────────────────────────────────────────────────────────────────┐
 │deft 1.01 c:\mydir\                             Mon 01/02/92, 13:45│
 │  1/3     *.fta                                                    │
 │FNCCCC   FTC      300  06/23/92  12:00  c:\mydir\                  │
 │FNBBBB   FTB      200  06/22/92  11:00  c:\mydir\                  │
 │FNAAAA   FTA      100  06/21/92  10:00  c:\mydir\                  │
 └───────────────────────────────────────────────────────────────────┘

Where the file list has been ordered by the <date> and <time> fields, in
descending order.
%@ign
%@sec DEFT Command: /P           (Put fileid|[listi] to disk file)
/P        ##  Put <fileid> and <path> fields to output file.

              The '/P' command writes records to 'Project Files' which
              can subsequently be read by the '/G' (Get) command so that
              specific file lists of <fileid>/<path> information may be
              created, saved, and used.

              See 'Project Files' for full details.

/PO[fileid]   Open file for subsequent Put output.
              If [fileid] not specified, 'WRK.DFT' is used.

/PL           Put current [listi] string to output file.

/PP           Start/Put block of <fileids> to output file.
              Enter 2 times anywhere in file list to Put all
              included <fileids>/<paths>.

/PC           Close current Put file.

Note:
For any Put operation, if no output file is open, the default file
'WRK.DFT' is automatically opened.

All Put operations cause appending to the output file, no existing
records are ever lost.


Example:
 ┌───────────────────────────────────────────────────────────────────┐
 │deft 1.01 c:\mydir\                             Mon 01/02/92, 13:45│
 │  1/3     *.fta                                                    │
 │FNAAAA   FTA  /pp                                                  │
 │FNBBBB   FTB      200  06/22/92  11:00  c:\mydir\                  │
 │FNCCCC   FTC  /pp                                                  │
 └───────────────────────────────────────────────────────────────────┘

Would cause the following records to be written to file 'WRK.DFT':

    FNAAAA.FTA   C:\MYDIR
    FNBBBB.FTB   C:\MYDIR
    FNCCCC.FTC   C:\MYDIR
%@ign
%@sec DEFT Command: /R           (Refresh display after DOS)
/R|Y|N|       Specifies whether to Refresh the screen after executing
              any DOS commands, or clear it and restore the DEFT display
              automatically.

              See 'Startup:  [options]' for full details.

Example:
 ┌───────────────────────────────────────────────────────────────────┐
 │deft 1.01 c:\mydir\                             Mon 01/02/92, 13:45│
 │  1/3     *.fta                                                    │
 │FNAAAA   FTA  /rn                                                  │
 │FNBBBB   FTB      200  06/22/92  11:00  c:\mydir\                  │
 │FNCCCC   FTC      300  06/23/92  12:00  c:\mydir\                  │
 └───────────────────────────────────────────────────────────────────┘

Causes the last screenful of DOS command output to remain visible until
the user hits any key.
%@ign
%@sec DEFT Command: /S           (Maximum RAM Storage required)
/S|Y|N|       Specifies whether maximum RAM Storage is to be allocated
              for all DOS commands or not.

              See 'DEFT [options]' and 'Resource Utilization &
              Optimization' for full details.

Example:
 ┌───────────────────────────────────────────────────────────────────┐
 │deft 1.01 c:\mydir\                             Mon 01/02/92, 13:45│
 │  1/3     *.fta                                                    │
 │FNAAAA   FTA  /sy                                                  │
 │FNBBBB   FTB      200  06/22/92  11:00  c:\mydir\                  │
 │FNCCCC   FTC      300  06/23/92  12:00  c:\mydir\                  │
 └───────────────────────────────────────────────────────────────────┘

Causes the maximum amount of RAM storage to be made available during
every DOS command.
%@ign
%@sec DEFT Command: /T           (Search Tree for all occurrences)
/T[pathi]     Search Tree for all occurrences of fileid.
              If [pathi] is specified, the search begins at
              [drive:][\path\] and includes all sub-directories.
              If [drive:] not specified, the Current Drive is used.
              If [\path\] not specified, the root (\) is used, causing
              entire drive to be searched.
              If [fileid] is not specified, the <fileid> field is used.

              If any files are found, they are appended to the current
              file list, and the display is positioned to the new files.

              Toggle current/last display with Ctl-Home keypress.

Example:
 ┌───────────────────────────────────────────────────────────────────┐
 │deft 1.01 c:\mydir\                             Mon 01/02/92, 13:45│
 │  1/3     *.fta                                                    │
 │FNAAAA   FTA  /ta:                                                 │
 │FNBBBB   FTB      200  06/22/92  11:00  c:\mydir\                  │
 │FNCCCC   FTC      300  06/23/92  12:00  c:\mydir\                  │
 └───────────────────────────────────────────────────────────────────┘

Causes a search of all directories on the 'a:'  drive for file
'FNAAAA.FTA' to be added to the file list.
%@ign
%@sec DEFT Command: /V           (Set Video characteristics)
/V|c|f,b||    Set Video (Normal|Highlited|Intense), fore/background.

              See 'Startup [options]' for details.

Example:
 ┌───────────────────────────────────────────────────────────────────┐
 │deft 1.01 c:\mydir\                             Mon 01/02/92, 13:45│
 │  1/3     *.fta                                                    │
 │FNAAAA   FTA      100  06/21/92  10:00  c:\mydir\                  │
 │FNBBBB   FTB  /vn3,0                                               │
 │FNCCCC   FTC      300  06/23/92  12:00  c:\mydir\                  │
 └───────────────────────────────────────────────────────────────────┘

This sets the 'Normal' fields of the DEFT display to cyan on a black
background.
%@ign
%@sec DEFT Command: /XI          (Exit DEFT)
/XI           Exit DEFT and return to DOS.
              Note:
              The rest of Command Area is ignored, and may contain
              any characters.

Example:
 ┌───────────────────────────────────────────────────────────────────┐
 │deft 1.01 c:\mydir\                             Mon 01/02/92, 13:45│
 │  1/3     *.fta                                                    │
 │FNAAAA   FTA  erase                                                │
 │FNBBBB   FTB  /xise                                                │
 │FNCCCC   FTC  erase                                                │
 └───────────────────────────────────────────────────────────────────┘

Would cause the following command to be issued:

    ERASE FNAAAA.FTA

Then, DEFT would stop processing, and return to DOS. The last 'erase'
command would NOT be issued.
%@ign
%@sec DEFT Command: /Y           (Set Substitution Symbol)
/Y|c|         Specifies the Substitution Symbol to be character 'c'.

              See 'Startup [options]' for details.

Example:
 ┌───────────────────────────────────────────────────────────────────┐
 │deft 1.01 c:\mydir\                             Mon 01/02/92, 13:45│
 │  1/3     *.fta                                                    │
 │FNAAAA   FTA  /y>                                                  │
 │FNBBBB   FTB      200  06/22/92  11:00  c:\mydir\                  │
 │FNCCCC   FTC      300  06/23/92  12:00  c:\mydir\                  │
 └───────────────────────────────────────────────────────────────────┘

Causes the '>' character to become the Substitution Symbol. Thereafter,
for example, to cause the filename to be included in a DOS command, the
user would specify:

     >n

in the Command Area.

Remember that previously coded Configuration File 'command-strings' must
utilize the active Substitution Symbol.
%@ign
%@sec Project Files
DEFT 'Project Files' are disk files containing a [listi] specification
and/or <fileid>/<path> records.

Such a file can be read by the '/G@' (Get [listi]) or '/G' (Get)
commands, to create a file list from the pre-coded information.

When a Project File is processed by '/G@[fileid]', only the first record
is read, and it must be a valid [listi] specification.

When a Project File is read by '/G[fileid]', any record not containing a
<fileid>/<path> specification is simply ignored.  Each file/path
specification is checked, and the file listed, if present.  If the file
is not found, the file statistics fields are replaced with:

    -- not found --


Valid Project File record types are:

    [listi] record
    <fileid>/<path> records


The [listi] record is any valid [listi] specification, except '/G' or
'/G@':

    [listi]

where:

    [listi]
         Is a [listi] specification, which may be read via the
         '/G@[fileid]' command.
         No blanks are allowed.
         This record is optional, but must be first, if coded.


The <fileid>/<path> record(s) describe a file and its location,
which may or may not actually exist:

    |fileid| |path|

where:
    |fileid|
         Is a file-name/file-extension specification, with the
         separating period ('.').

    |pathi|
         Is the drive/path location of the above file, and is separated
         from the |fileid| by at least 1 blank.


Project File records may be created by an editor, or the '/P...'
DEFT Command, described elsewhere.

Example:
A program source file and supporting subroutine file are kept in
different directories because of their differing roles.  However, during
development, it is more convenient to have both files 'visible' and
easily accessible at the same time. So, assume the following file, named
'MYPROJ.DFT':

    mypgmain.c  c:\source
    mypgmsub.c  c:\suptlib


Then,
 ┌───────────────────────────────────────────────────────────────────┐
 │deft 1.01 c:\mydir\                             Mon 01/02/92, 13:45│
 │  1/3     *.fta                                                    │
 │FNAAAA   FTA  /gmyproj.dft                                         │
 │FNBBBB   FTB      200  06/22/92  11:00  c:\mydir\                  │
 │FNCCCC   FTC      300  06/23/92  12:00  c:\mydir\                  │
 └───────────────────────────────────────────────────────────────────┘

would produce the following:
 ┌───────────────────────────────────────────────────────────────────┐
 │deft 1.01 c:\mydir\                             Mon 01/02/92, 13:45│
 │  1/2     /gmyproj.dft                                             │
 │MYPGMAIN C        100  06/21/92  10:00  c:\source\                 │
 │MYPGMSUB C        200  06/22/92  11:00  c:\suptlib\                │
 └───────────────────────────────────────────────────────────────────┘
%@ign
%@sec Resource Utilization & Optimization
At startup, DEFT Version 1.01 requires approximately 170KB RAM,
providing a minimum file list of 200 fileids.  More RAM is obtained as
the file list gets larger.

When DEFT runs an executable, it allocates whatever RAM is still
available in the system.

When the executable completes, the RAM is deallocated.  Therefore,
DO NOT execute TSR's (Terminate and Stay Resident programs) from DEFT.

Swapping:
─────────
If more memory is needed for a particular executable -- you may see
either of the following error messages:

    Cannot execute [pathi][fileid]
or,
    Out of memory

specify the '[S' (maximum Storage required) Flag in the Command Area (or
'command-string' in a Configuration File definition).  DEFT will 'swap'
(write) itself out of RAM into a temporary disk file during the
specified executable, and then read itself back into RAM afterwards.

This will make all but approximately 3KB of RAM available for the
executable, but will also add the processing necessary to perform the
swap operation.

If maximum storage is required for ALL executables, issue the '/SY'
command, or code it on a Configuration File parameter record.

Swap File Allocation:
─────────────────────
When DEFT starts, it allocates the temporary swap disk file according to
the path definition found in the following environment variables, in the
order shown:

    DEFTMP
    TEMP
    TMP

If none of the above have been specified, the swap file is allocated in
the Current Directory.

Therefore, if you want to allocate the swap file to a particular device
or area (a RAM disk is the best candidate), issue the following DOS
command, prior to DEFT startup:

    set deftmp=d:\path\

Where:

    d:\path\
         Is a drive and path designation, which MUST EXIST.


Swap Fileid:
────────────
The swap fileid is 'DEFTnnnn.TMP', where 'nnnn' is automatically
replaced with a unique sequential identifier.
%@ign
%@sec Network Execution
Each invocation of DEFT creates a unique swap file, and thus is
compatible with multi-user network execution.

However, DEFT takes no other action for network execution:  The
appropriate networking environment must be setup for any executables run
('SHARE.EXE' CONFIG.SYS entry, for example).
%@ign
%@sec Windows Installation
DEFT may be installed under Microsoft WINDOWS as follows:

  1. Start Windows.
  2. Select icon for Program Manager.
  3. Select icon for the Program Group in which you want DEFT to appear.
  4. Select File.
  5. Select New...
  6. Select Program Item * OK.
  7. Enter in the Description field:  Deft
  8. Enter in the Command Line field: [pathi]deft.exe [parms]
     where:
         [pathi]
              Is the path describing where DEFT.EXE is located.
         [parms]
              Are any desired DEFT command-line parameters.
              Alternatively, you may leave out the [parms], and enter
              any desired options in the DEFT.CFG Configuration File.

  9.  Select OK.

Now, to run DEFT, just select the "Deft" icon.
%@ign
%@sec Hints
Hint:
─────
A convenient working environment for typical compiling/debugging is the
combination of files ordered by date ('/OD') which places most-recently
created/modified fileids at the top of the list, and a function-key
definition which rebuilds the file list from the Current Directory
('/CL=').

By simply hitting the function-key, the files most likely to require
attention (modified source file, compiler error listing, etc) will
remain in view, at the top of the screen.


Hint:
─────
By combining command repetition and symbolic substitution, the user is
afforded a powerful capability to handle groups of files:

 ┌───────────────────────────────────────────────────────────────────┐
 │deft 1.01 c:\mydir\                             Mon 01/02/92, 13:45│
 │  1/3     *.fta                                                    │
 │FNAAAA   FTA  ren [ [n.old                                         │
 │FNBBBB   FTB  =                                                    │
 │FNCCCC   FTC  =<ENTER>                                             │
 └───────────────────────────────────────────────────────────────────┘

Results in the following commands:

    RENAME  FNAAAA.FTA  FNAAAA.OLD
    RENAME  FNBBBB.FTB  FNBBBB.OLD
    RENAME  FNCCCC.FTC  FNCCCC.OLD


Hint:
─────
A Configuration File can be designed for Application Launching by
combining the '/G' command naming a Project File of applications, and
the '/EY' command allowing 1-blank Command Area executions.  For
instance, assume the Configuration File 'MYAPPLS.CFG', as follows:

    /gmyappls.lst /ey /sy

And assume the 'MYAPPLS.LST' Project File:

    editor.exe    c:\prdctn\
    wordproc.exe  c:\prdctn\
    sprdshet.exe  c:\prdctn\
    calcultr.com  c:\testlib\

Then, the command:

    deft /cmyappls.cfg

would present the above fileids, and enable execution via a single blank
followed by <ENTER>.

Similarly, you may assign the '/Gmyappls.lst' command to a Function Key,
to 'pop-up' a list of applications during a DEFT session.

You would probably have issued the '/SY' and possibly the '/EY' commands
beforehand, to ensure maximum RAM for the applications, and single-blank
execution capability.
%@ign
%@sec Version History
DEFT  Version 1.00  08/04/92
────────────────────────────
This version is the initial public offering of the program.

DEFT  Version 1.01  10/04/92
────────────────────────────
Modification to the system call routine provides access to the primary
environment area variables, allowing executables to successfully access,
modify, and delete environment variables.
%@ign
%@sec HELP Utilization
%@ign (This section is for HELP <F2> processing and must be LAST)
HELP allows reading a file with a Table Of Contents (TOC).  By high-
lighting a particular TOC entry with the Up/Down Arrow keys and pressing
the <ENTER> key, that section is displayed.  HELP also uses the
following keys, as indicated:

                  Key Action, while displaying...
                  ─────────────────────────────────────────────────────
Key               ..Table of Contents (TOC)     ..Selected Section
───────────       ─────────────────────────     ───────────────────────
F1                Display this HELP             Display this HELP
Esc               Exit HELP                     Return to TOC
Down  Arrow       Next TOC entry                Next screen/section
Tab   Forward     Next TOC entry                Next screen/section
Page  Down        Next TOC screenful            Next screen/section
Enter             Display highlited section     Next screen/section
Space             Display highlited section     Next screen/section
Up    Arrow       Previous TOC entry            Previous screen
Tab   Backward    Previous TOC entry            Previous screen
Page  Up          Previous TOC screenful        Previous screen
Home              Top of screen                 Top of section
End               Bottom of screen              ...
Right Arrow       Next     TOC entry            Next     section
Left  Arrow       Previous TOC entry            Previous section
b                 Toggle Bell ON/OFF            Toggle Bell ON/OFF

Whenever the displayed Section changes, the bell is sounded (if ON).
%@ign     <<<<<=====-----.... end-of-file ....-----=====>>>>>
