home *** CD-ROM | disk | FTP | other *** search
/ High Voltage Shareware / high1.zip / high1 / DIR4 / TBOX14.ZIP / TBOX.DOC < prev    next >
Text File  |  1993-11-14  |  124KB  |  2,942 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.                                   ToolBOX
  12.  
  13.  
  14.  
  15.  
  16.                                    (TBOX)
  17.  
  18.  
  19.  
  20.  
  21.                                 USER MANUAL
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.                             *
  33.                           *   *
  34.                         *       *
  35.                       *           *               The
  36.                     *               *
  37.                   *                   *           Binary
  38.                  *                     *
  39.                  *                     *          Toolshed
  40.                  *                     *
  41.                  *                     *
  42.                  *  ******             *
  43.                  *        *            *
  44.                  *        *            *          Version 1.4
  45.                  *        *            *          November 14, 1993
  46.                  *        *            *
  47.                  *        *            *
  48.                   ********             *
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.                               TABLE OF CONTENTS
  60.  
  61.     1.0 INTRODUCTION......................................................1
  62.     1.1 General...........................................................1
  63.     1.2 About This Manual.................................................2
  64.     1.3 Documentation Conventions.........................................4
  65.     1.4 Words You Should Know.............................................4
  66.  
  67.     2.0 QUICK START PROCEDURE.............................................8
  68.  
  69.     3.0 INSTALLATION......................................................9
  70.     3.1 System Requirements...............................................9
  71.     3.2 Installation Configuration........................................9
  72.  
  73.     4.0 PROGRAM STARTUP..................................................10
  74.     4.1 Program Environment..............................................10
  75.     4.2 Startup Settings.................................................10
  76.  
  77.     5.0 OPERATIONAL OVERVIEW.............................................18
  78.     5.1 Introduction.....................................................18
  79.     5.2 The Basics.......................................................18
  80.     5.3 Directory/Select Modes...........................................20
  81.     5.4 Help Facility....................................................20
  82.     5.5 Popup Menu Window................................................20
  83.     5.6 Error Reporting..................................................21
  84.     5.7 Exit To DOS......................................................22
  85.  
  86.     6.0 DIRECTORY DISPLAY................................................23
  87.     6.1 Introduction.....................................................23
  88.     6.2 The DIR Command..................................................24
  89.     6.3 The CD Command...................................................26
  90.  
  91.     7.0 KEYBOARD COMMAND LINE PROCESSING.................................27
  92.     7.1 Introduction.....................................................27
  93.     7.2 Editing..........................................................27
  94.     7.3 Keyboard Command Stack...........................................27
  95.     7.4 DOS/ToolBOX Command Processing...................................28
  96.     7.5 Memory Utilization...............................................28
  97.     7.6 Command Line Variables...........................................29
  98.     7.7 External Command Access..........................................30
  99.  
  100.     8.0 COMMAND SEQUENCING...............................................31
  101.     8.1 Introduction.....................................................31
  102.     8.2 File Selection...................................................31
  103.     8.3 Soft Selection...................................................32
  104.     8.4 Basic Point-and-Shoot Operations.................................32
  105.     8.5 Command Sequencing...............................................32
  106.     8.6 Display Output...................................................33
  107.  
  108.     9.0 ADDITIONAL COMMANDS..............................................34
  109.     9.1 Window Control...................................................34
  110.     9.2 Directory Control................................................35
  111.  
  112.  
  113.  
  114.  
  115.     9.3 Window Contents..................................................36
  116.     9.4 DOS Commands.....................................................37
  117.     9.5 Quick Commands...................................................38
  118.     9.6 Inferred Batch File Selection....................................39
  119.     9.7 Explicit Program Requests........................................41
  120.  
  121.     10.0 INTRINSIC COMMANDS..............................................42
  122.     10.1 Typical Usage...................................................42
  123.     10.2 Intrinsic DIR command...........................................42
  124.     10.3 Intrinsic CD command............................................42
  125.     10.4 Intrinsic DEL Command...........................................42
  126.     10.5 Intrinsic KILLDIR Command.......................................43
  127.     10.6 Intrinsic SEL Command...........................................43
  128.  
  129.  
  130.     APPENDIX A : ToolBOX COMMAND LINE ARGUMENT SUMMARY...................44
  131.  
  132.     APPENDIX B : DIRECTORY DISPLAY PARAMETERS............................46
  133.  
  134.     APPENDIX C : COMMAND SUMMARY.........................................48
  135.  
  136.     APPENDIX D : INTRINSIC COMMAND SUMMARY...............................52
  137.  
  138.  
  139. ToolBOX User Manual                                                   Page 1
  140. ____________________________________________________________________________
  141.  
  142.  
  143.  
  144. 1.0 INTRODUCTION
  145.  
  146. 1.1 General
  147.  
  148.     Computers are getting bigger, faster, and more complex.  It is essent-
  149.     ial to find a way to simplify the process of accessing and controlling
  150.     the myriad of data and programs on our systems.  The ToolBOX will help
  151.     in achieving that goal.
  152.  
  153.     In simple terms, ToolBOX presents a window showing a directory display
  154.     of the files in a chosen directory.  These files can be selected and
  155.     involved in copy, delete, or user defined operations - often with only
  156.     a single keystroke.  If the file selected is an application program or
  157.     one of its data files, such as a word processor document, just one
  158.     keystroke gets you up and running.  Equally applicable to the casual or
  159.     experienced user,  ToolBOX provides an alternate and extended interface
  160.     to the conventional DOS command line.  Your existing knowledge of DOS
  161.     commands is not wasted as DOS commands are handled directly through
  162.     ToolBOX.
  163.  
  164.     ToolBOX continues after other similar file management systems have
  165.     exhausted their capabilities.  With this highly configurable system you
  166.     can almost "write" your own version of ToolBOX.  A version that will
  167.     complement your personal or business needs.  Virtually everything can
  168.     be changed: the colors, the sound levels, the operations associated
  169.     with the keys or the key assignments themselves.  All of your favorite
  170.     and specialized utilities can be incorporated into ToolBOX through its
  171.     configuration capability.
  172.  
  173.     Features include:
  174.  
  175.           o an easily manipulated directory display, including control over
  176.             display format and sort technique.
  177.  
  178.           o point-and-shoot operations to invoke programs or change
  179.             directories.
  180.  
  181.           o direct execution of DOS command lines, including the ability to
  182.             reference files that have been selected within the directory
  183.             display.
  184.  
  185.           o memory requirement can be reduced to less than 2KB.
  186.  
  187.           o multiple windows provide simultaneous views of the directory
  188.             display and DOS command data.
  189.  
  190.           o keyboard command stack of most recent command lines.  Commands
  191.             can be recalled for editing or reuse.
  192.  
  193.           o stack of most recently entered directories.  A single keystroke
  194.             can be used to cycle through these directories.
  195.  
  196.           o designated batch files invoked, for files selected with
  197.             specific match strings.
  198. ToolBOX User Manual                                                   Page 2
  199. ____________________________________________________________________________
  200.  
  201.  
  202.  
  203.           o configuration capability to change colors, change display
  204.             format rules, bind multiple command lines to a single
  205.             keystroke, and much more.
  206.  
  207.     There are many reasons for using ToolBOX.  Visibility is better than
  208.     with DOS, repetitious operations are simplified, and EGA and VGA are
  209.     fully exploited.  Perhaps it's just because the month is spelled out in
  210.     dates or that commas are placed in numeric displays.  Maybe it's that
  211.     elusive warmer feeling; not that we at the Toolshed are in any way
  212.     biased.  Whatever your reason for adopting ToolBOX, enjoy.
  213.  
  214.  
  215.  
  216.  
  217. 1.2 About This Manual
  218.  
  219.     This manual describes the operational activities associated with the
  220.     ToolBOX program.  ToolBOX is a highly configurable program.  The major
  221.     configuration capabilities are accomplished through the separate
  222.     TBOXCFG program as described in detail in the TBOXCFG User Manual.
  223.     Start with this operational manual to learn how to use ToolBOX with the
  224.     default settings.  Then move on to learn how to personalize your
  225.     version of ToolBOX.
  226.  
  227.          Section 1       Be sure to finish reading Section 1 to familiarize
  228.                          yourself with the terminology peculiar to this
  229.                          manual.
  230.  
  231.          Section 2       A "Quick Start" introduction provides the user
  232.                          with sufficient information to experiment and
  233.                          become familiar with ToolBOX before delving into
  234.                          the details of the manual.
  235.  
  236.          Section 3       This section describes the installation and system
  237.                          requirements.
  238.  
  239.          Section 4       This section describes the ToolBOX command line
  240.                          arguments needed to alter the program operation
  241.                          each time the program is started.
  242.  
  243.     The ToolBOX program has three separate types of functions: basic
  244.     unchangeable functions, functions that can be altered via
  245.     configurations, and lastly, intrinsic commands that can be entered via
  246.     the keyboard command line.
  247.  
  248.          Section 5       This section provides an overview of ToolBOX's
  249.                          operation.  The basic functions that are not
  250.                          configurable are explained.
  251.  
  252.          Section 6       This section describes the directory display's
  253.                          default settings and the methods for manipulating
  254.                          the presentation data.
  255.  
  256. ToolBOX User Manual                                                   Page 3
  257. ____________________________________________________________________________
  258.  
  259.  
  260.          Section 7       This section explains the entry of keyboard
  261.                          command lines and related facilities.
  262.  
  263.          Section 8       This section describes the point-and-shoot
  264.                          operations which can be modified by the conf-
  265.                          iguration program.
  266.  
  267.          Section 9       This section describes additional keystroke
  268.                          commands available.
  269.  
  270.          Section 10      This section describes the lower level commands
  271.                          (intrinsics) that are entered as separate command
  272.                          lines.  Refer to the TBOXCFG User Manual for
  273.                          additional intrinsic commands that are available
  274.                          during the configuration process.
  275.  
  276.  
  277.  
  278.          Appendix A      Summarizes the command line arguments.
  279.  
  280.          Appendix B      Summarizes the factory default settings for the
  281.                          directory display format and sort techniques.
  282.  
  283.          Appendix C      Summarizes the single keystroke commands.
  284.  
  285.          Appendix D      Summarizes the intrinsic commands.
  286.  
  287.  
  288.     This manual assumes you already have a basic understanding of DOS.
  289.     That you are familiar with such concepts as batch files, the PATH
  290.     variable, DOS files and directory structure, and the syntax of DOS
  291.     commands.  If not, refer to your DOS User Manual.
  292.  
  293.     It is also assumed you are familiar, at least at the conceptual level,
  294.     with other programs from The Binary Toolshed.  In particular with
  295.     TBOXCFG, BTSPATCH, VIEW, and TREE which can be used in conjunction with
  296.     ToolBOX.  These programs are briefly described in the glossary
  297.     contained in Section 1.4, and in detail in the Utilities User Manual.
  298.  
  299.  
  300.  
  301. ToolBOX User Manual                                                   Page 4
  302. ____________________________________________________________________________
  303.  
  304.  
  305. 1.3 Documentation Conventions
  306.  
  307.     Conventions employed in examples throughout this manual include:
  308.  
  309.           [ | | | ]      square brackets enclose optional items, of which
  310.                          one may be selected.
  311.  
  312.  
  313.           case           has no significance unless stated otherwise.
  314.  
  315.  
  316.           <KEY STROKE>   all keys to be struck simultaneously are enclosed
  317.                          in angle brackets.  For example
  318.  
  319.                               <ALT d>, <PG-DN> and <CTRL c>.
  320.  
  321.  
  322.                         the diamond is the prefix character used for
  323.                          variables within a command line.  It is created
  324.                          with the CTRL key.  For example f is created by
  325.                          <CTRL f>.
  326.  
  327.                          Note: If this manual has been filtered with the
  328.                          TOASCII utility, the diamond appears as an
  329.                          asterisk - *.
  330.  
  331.  
  332.           - and /        while the two are actually interchangeable, this
  333.                          manual uses "-" as the prefix for the initial
  334.                          ToolBOX command line arguments and "/" as the
  335.                          prefix for parameters for keyboard and intrinsic
  336.                          commands.
  337.  
  338.  
  339.  
  340. 1.4 Words You Should Know
  341.  
  342.      The following definitions are useful as you read this manual.  This
  343.      glossary is a subset of the one contained in the General Product
  344.      Overview Manual.
  345.  
  346.  
  347.           argument            an option field on the ToolBOX command line.
  348.                               Note, the convention used within this manual
  349.                               is that  "arguments" refer to the ToolBOX
  350.                               startup command line, while "parameters" (see
  351.                               below) refer to options on command lines
  352.                               within ToolBOX.
  353.  
  354.  
  355.           BTSPATCH.EXE        a separate Binary Toolshed (BTS) utility
  356.                               program that allows the user to set their own
  357.                               default startup command line within each of
  358.                               the supplied BTS programs, including ToolBOX.
  359.                               Refer to the Utilities User Manual for more
  360. ToolBOX User Manual                                                   Page 5
  361. ____________________________________________________________________________
  362.  
  363.  
  364.                               information.
  365.  
  366.  
  367.           command line        a single processable line of text.  This may
  368.                               be a DOS command line or a ToolBOX intrinsic.
  369.  
  370.  
  371.           command set         a collection of ToolBOX command lines.  This
  372.                               grouping is created through the TBOXCFG
  373.                               program.
  374.  
  375.  
  376.           DOS                 Disk Operating System, the control program
  377.                               for IBM Personal Computers.  The term refers
  378.                               to both the Microsoft (MS DOS) and the IBM
  379.                               (PC DOS) versions.
  380.  
  381.                               Refer to your DOS users manual for further
  382.                               explanations of DOS commands such as PATH,
  383.                               COPY, FORMAT, RD, and RENAME, as well as
  384.                               descriptions of wildcard characters, batch
  385.                               files, directories, and so on.
  386.  
  387.  
  388.           environment variables
  389.                               also referred to as set variables, these are
  390.                               user defined DOS names that can be associated
  391.                               with any desired text string.  Programs can
  392.                               interrogate these strings and act
  393.                               accordingly.  Use the DOS SET command to
  394.                               modify these variables - such as BTS, or
  395.                               PATH.
  396.  
  397.  
  398.           factory defaults    the initialization settings contained within
  399.                               the distribution version of The Binary
  400.                               Toolshed products.  These default values can
  401.                               be overridden by the BTSPATCH or TBOXCFG
  402.                               programs.
  403.  
  404.  
  405.           intrinsics          command lines understood and processed
  406.                               directly by ToolBOX, i.e. they are not passed
  407.                               on to DOS.  These command lines consist of a
  408.                               command word (e.g. "sel" or "del") and
  409.                               optionally one or more parameters.
  410.  
  411.  
  412.           key binding         the association of a command set with a
  413.                               particular keyboard keystroke.
  414.  
  415.  
  416.           keyboard command    a command line (DOS or intrinsic) entered
  417.                               manually through the ToolBOX command line as
  418.                               shown at the bottom of the directory display.
  419. ToolBOX User Manual                                                   Page 6
  420. ____________________________________________________________________________
  421.  
  422.  
  423.  
  424.  
  425.           keystroke           a single identifiable entry through the
  426.                               keyboard.  This may be one key or multiple
  427.                               keys.  For example <a> or <CTRL ALT F9>.
  428.  
  429.  
  430.           matchlist           a file selection specification list that can
  431.                               specify a drive, path, and one or more file
  432.                               specifications.  Each file specification can
  433.                               use the DOS wildcard characters and be
  434.                               preceded by "!" to  indicate matching files
  435.                               should be removed from the selected list
  436.                               rather than added.  For example:
  437.  
  438.                                   c:\dos\*.* !*.com !*.exe
  439.  
  440.  
  441.           parameter           separate option field(s) following the
  442.                               command word on a command line.  Refer above
  443.                               to "argument".
  444.  
  445.  
  446.           PATH                the DOS reserved environment variable which
  447.                               designates alternate directories to be
  448.                               searched for program files.
  449.  
  450.  
  451.           path                a DOS directory specification consisting of
  452.                               an optional leading drive indicator and one
  453.                               or more directory names, e.g.
  454.  
  455.                                    d:\dos\5.00\
  456.  
  457.  
  458.           pathname            a DOS file specification consisting of a
  459.                               filename with an optional leading path, e.g.
  460.  
  461.                                    d:\dos\5.00\command.com
  462.  
  463.  
  464.           point-and-shoot     the ability to cursor to an object such as a
  465.                               file (hence point) and when <ENTER> is
  466.                               pressed (hence shoot) have a particular
  467.                               operation carried out based on some charac-
  468.                               teristic of the selected object - such as the
  469.                               extension.
  470.  
  471.  
  472.           popup menu          a window of menu selections that appears in
  473.                               the "middle" of the current screen.  The menu
  474.                               options may initiate actions directly or
  475.                               bring up further menus with more options.
  476.  
  477. ToolBOX User Manual                                                   Page 7
  478. ____________________________________________________________________________
  479.  
  480.  
  481.           quick command line  single predefined command lines that may be
  482.                               initiated separately from the command sets
  483.                               bound to particular keystrokes.
  484.  
  485.  
  486.           redirection         a DOS capability which allows the normal
  487.                               input or output of a command to be altered to
  488.                               come from or go to a specified file.  Redir-
  489.                               ection can be used for the DOS command lines
  490.                               within ToolBOX.
  491.  
  492.  
  493.           toggle              to switch between alternatives: ON to OFF,
  494.                               from INSERT to OVERWRITE mode, from the DOS
  495.                               display to the ToolBOX display, etc.
  496.  
  497.  
  498.           TBOX.EXE            the main program from The Binary Toolshed, as
  499.                               documented in this manual.  While the
  500.                               documentation uses the "ToolBOX" designation,
  501.                               the actual program is abbreviated to "TBOX"
  502.                               to simplify keyboard entry.  If you find this
  503.                               confusing, simply rename the program file to
  504.                               the expected "TOOLBOX.EXE".
  505.  
  506.  
  507.           TBOXCFG.EXE         a separate BTS configuration program that
  508.                               allows extensive modifications to the basic
  509.                               ToolBOX operational capabilities.  Refer to
  510.                               the TBOXCFG User Manual for more details.
  511.  
  512.           TREE.EXE            a BTS utility program that graphically
  513.                               depicts the directory structure in the form
  514.                               of a tree that can be traversed with the
  515.                               cursor keys.  The user can cursor through the
  516.                               structure to change directories or examine
  517.                               files.  Refer to the Utilities User Manual
  518.                               for more information.
  519.  
  520.  
  521.           tsr                 a Transient and Stay Resident program.  These
  522.                               programs permanently retain a small portion
  523.                               of memory while they lie dormant waiting for
  524.                               a particular action.  These programs must be
  525.                               initiated before ToolBOX is run.
  526.  
  527.  
  528.           verification window A prompt window issued by ToolBOX to ensure
  529.                               the requested operation is really desired.
  530.  
  531.           VIEW.EXE            a BTS utility program that displays the
  532.                               contents of text files for viewing or
  533.                               browsing.  Refer to the Utilities User Manual
  534.                               for more information.
  535.  
  536. ToolBOX User Manual                                                   Page 8
  537. ____________________________________________________________________________
  538.  
  539.  
  540. 2.0 QUICK START PROCEDURE
  541.  
  542.     Chances are, ToolBOX is not the first program of this form that you
  543.     have used.  This means you are familiar with normal keyboard and
  544.     windowing techniques.  If this is the case, you should feel comfortable
  545.     with ToolBOX without any special training.
  546.  
  547.     For most people, the fastest way to learn about a program is to use it.
  548.     For this reason we suggest you start using ToolBOX right away.  This
  549.     advance familiarity will provide you with a better understanding when
  550.     you come back and read the balance of this manual.
  551.  
  552.     For this sample session, you can bypass the installation and command
  553.     line argument descriptions in the following sections.  Just run the
  554.     TBOX.EXE executable without arguments.
  555.  
  556.     Once started, ToolBOX presents a directory display window.  Use the
  557.     cursor keys to move about the display, <SPACE> to select files (try
  558.     <ALT SPACE> and <CTRL SPACE> too), and <RETURN> to invoke point-and-
  559.     shoot operations on selected files.  DOS command lines can be entered
  560.     at any time.  For a help screen showing additional features, enter
  561.     <F1>.  Most functions should be obvious.
  562.  
  563.     This brief session should introduce you to most of the basic capabil-
  564.     ities of ToolBOX.  Ultimately you will need to return to this manual to
  565.     take full advantage of the program.  Return to learn such things as
  566.     what the "." to the left of the displayed directory name means, or what
  567.     to do when <ALT SPACE> won't work under MS Windows, or how to best take
  568.     advantage of your particular video card, or that you don't need to
  569.     enter the normal "C:" then "CD \BIN".  ToolBOX understands the
  570.     shorthand equivalent "C:\BIN".  With the additional information from
  571.     this manual at your fingertips, it can only get better.
  572.  
  573.  
  574.  
  575.  
  576. ToolBOX User Manual                                                   Page 9
  577. ____________________________________________________________________________
  578.  
  579.  
  580. 3.0 INSTALLATION
  581.  
  582. 3.1 System Requirements
  583.  
  584.     ToolBOX has minimal system requirements:
  585.  
  586.           DOS       : 3.0 or higher
  587.  
  588.           Memory    : Varies with directory size but typically in the order
  589.                       of 80KB.  As ToolBOX in turn initiates other programs
  590.                       when requested, the more memory the better.
  591.  
  592.           VIDEO     : MDA, CGA, EGA, or VGA.
  593.  
  594.           DISK      : no specific requirements.
  595.  
  596.  
  597.  
  598. 3.2 Installation Configuration
  599.  
  600.     Installation is straight forward.  Place ToolBOX.EXE in the current
  601.     directory or any directory referenced by the PATH variable.
  602.  
  603.     This also applies to all files referenced during ToolBOX's operation,
  604.     including VIEW.EXE, TREE.EXE and the DOS COMMAND.COM file.  Note, it is
  605.     not sufficient to simply direct COMSPEC to this file.
  606.  
  607.     No changes are required to the CONFIG.SYS, however, there may be
  608.     advantages with using the ANSI.SYS driver.  These advantages are
  609.     discussed in Section 4 of this manual.  Refer to your DOS User manual
  610.     for instructions on adding this driver to your CONFIG.SYS file.
  611.  
  612.     If you are using swap facility, you may wish to set the TEMP
  613.     environment variable to a suitable directory.
  614.  
  615. ToolBOX User Manual                                                  Page 10
  616. ____________________________________________________________________________
  617.  
  618.  
  619. 4.0 PROGRAM STARTUP
  620.  
  621. 4.1 Program Environment
  622.  
  623.     ToolBOX can run with all known programs.  ToolBOX has no unique
  624.     hardware, or software requirements that should cause problems for other
  625.     programs.
  626.  
  627.     The only stipulation is that TSR programs to be run at the same time as
  628.     ToolBOX must be installed before ToolBOX is started.
  629.  
  630.  
  631.  
  632. 4.2 Startup Settings
  633.  
  634.      Many of ToolBOX's operational aspects can be adjusted at the time the
  635.      program is started.  Arguments to control these features are specified
  636.      in any of four ways:
  637.  
  638.           o on the DOS command line following the program name.
  639.  
  640.           o by a DOS SET command for the "BTS" environment variable. For
  641.             example in your AUTOEXEC.BAT or at the DOS prompt enter
  642.  
  643.                 SET BTS=args
  644.  
  645.           o saved in the TBOX.EXE executable file by the BTSPATCH
  646.             program.
  647.  
  648.           o set in the configuration file established by the TBOXCFG
  649.             program.
  650.  
  651.      Which technique you use depends on a variety of factors such as
  652.      desired permanence of the argument or impact on other users or uses.
  653.      Any or all techniques can be used.  The same encoding rules apply to
  654.      all forms.
  655.  
  656.      Arguments are specified by a dash or a slash followed by one or more
  657.      characters that identify a particular action.  For example, to select
  658.      colors for a gray scale monochrome graphics monitor use:
  659.  
  660.                     -CG
  661.  
  662.      Note:
  663.  
  664.           o all arguments are optional, must begin with a dash or slash,
  665.             and may not contain spaces within the sequence.  Spaces between
  666.             arguments are optional.
  667.  
  668.           o case is not important unless specified otherwise.
  669.  
  670.           o the order of arguments is important only if there are
  671.             conflicting options, then the last argument has precedence.
  672.  
  673.           o an audible tone sounds if any argument isn't understood.
  674. ToolBOX User Manual                                                  Page 11
  675. ____________________________________________________________________________
  676.  
  677.  
  678.             Subsequent arguments are typically still processed.
  679.  
  680.     The precedence of the various configuration mechanisms, from lowest to
  681.     highest level, is:
  682.  
  683.           o internal program (factory) defaults.
  684.  
  685.           o default settings established by BTSPATCH.
  686.  
  687.           o the environment set variable BTS.
  688.  
  689.           o command line arguments.
  690.  
  691.           o where applicable, requests entered at run-time by the user.
  692.  
  693.     When provided, settings for each level supersede settings from the
  694.     preceding level.  Configuration files from the TBOXCFG program expand
  695.     in place where defined (e.g. in the set variable or command line
  696.     argument list).
  697.  
  698.     In the following argument definitions, enclosing brackets [ ] identify
  699.     a sequence of options of which one must be used.  For example, for the
  700.     definition -C[ b c g ], the three valid argument sequences are -Cb -Cc
  701.     and -Cg.
  702.  
  703.     All the following arguments are optional; in their absence ToolBOX will
  704.     select values that are suitable for the current environment.
  705.  
  706.  
  707.        SELECT VIDEO OUTPUT FORM:
  708.  
  709.                -V[b m c s e v] [25 43 50]
  710.  
  711.           By default, ToolBOX will select a video mode applicable to the
  712.           hardware(m,c) state at program startup.  The -V argument is used
  713.           to override this selection in order to use a different monitor
  714.           type (m,c,s,e,v), to use a different output technique (b,s) or to
  715.           alter the screen resolution (25, 43, 50).
  716.  
  717.                b    use BIOS output routines.  Normally video data is
  718.                     issued directly to the video card.  Using the BIOS will
  719.                     slow down the video update rate but may be necessary
  720.                     for some incompatible systems.
  721.  
  722.                m    assume monochrome text (MDA) video card.
  723.  
  724.                c, e, or v
  725.                     assume color graphics (CGA, EGA, or VGA) video card.
  726.                     All 3 settings have the same effect.
  727.  
  728.                s    assume CGA graphics video card and do processing to
  729.                     remove snow on screen.  This option slows down the
  730.                     update rate and should be avoided unless necessary.
  731.  
  732.                25   assume 25 visible lines of text.
  733. ToolBOX User Manual                                                  Page 12
  734. ____________________________________________________________________________
  735.  
  736.  
  737.  
  738.                43   assume EGA/VGA card and use the 43 line by 80 column
  739.                     mode.
  740.  
  741.                50   assume VGA card and use the 50 line by 80 column mode.
  742.  
  743.  
  744.        DEFAULT COLOR SELECTION:
  745.  
  746.                -C[m c g]
  747.  
  748.           Selects one of the predefined color tables.  If the option is not
  749.           provided the current video hardware configuration is examined and
  750.           m or c assumed.  Any setting can be used with any monitor.  Also,
  751.           there is no connection between the -C and -V settings.
  752.  
  753.                m    monochrome text displays.
  754.  
  755.                c    color displays.
  756.  
  757.                g    gray scale displays, where LCD or monochrome monitors
  758.                     are driven from color video cards.  The color coding is
  759.                     greatly affected by the particular combination of video
  760.                     card and display device.  The configuration file
  761.                     facility may produce superior results.
  762.  
  763.  
  764.        SELECT EXECUTION ASPECTS:
  765.  
  766.                -X [Hh] [Dd] [Cc] [Xx] [Rr] [Pp] [Tt] [a#] [Mm]
  767.  
  768.           The following eXecution arguments are two state settings. Case is
  769.           important.  The uppercase value sets the condition.
  770.  
  771.           The default is:
  772.  
  773.                          -XhdcXrTa7m
  774.  
  775.  
  776.                H/h  include hidden and system files in directory displays.
  777.  
  778.                D/d  perform directory display and exit.  Both the C and D
  779.                     options use the screen line count from DOS; any -V##
  780.                     argument is ignored.
  781.  
  782.                C/c  perform directory display and exit only if the
  783.                     directory display fits within the single screen.  If
  784.                     the conditional exit is not taken, ToolBOX starts in
  785.                     DIRECTORY phase.
  786.  
  787.                X/x  go directly to SELECT phase.
  788.  
  789.                R/r  restore DOS screen on exit rather than the ToolBOX
  790.                     directory.
  791.  
  792. ToolBOX User Manual                                                  Page 13
  793. ____________________________________________________________________________
  794.  
  795.  
  796.                P/p  set the default PAUSE state.  Following the execution
  797.                     of DOS commands, the PAUSE state determines whether the
  798.                     DOS output screen should be temporarily held or
  799.                     immediately replaced by the ToolBOX screen.  In either
  800.                     case the data of the DOS screen is retained and can be
  801.                     reviewed at a later time.  The PAUSE state can also be
  802.                     set through the popup menu (See Section 5.5) or through
  803.                     configuration flags on the individual command sets (see
  804.                     the TBOXCFG User Manual).
  805.  
  806.                T/t  when in EGA/VGA split screen mode, tell DOS specific-
  807.                     ally about available lines in split area.  DOS, as well
  808.                     as many application programs, refer to a BIOS variable
  809.                     to determine if they have 25, 43, or 50 lines
  810.                     available.  To work correctly with ToolBOX's split
  811.                     screen mode, DOS must be limited to 25 lines.  In most
  812.                     cases it is preferable to let other programs use the
  813.                     full screen which in split mode is the full 43 or 50
  814.                     lines.  If you are using DOS 3 or 4, this can be done
  815.                     if you are using the DOS ANSI screen driver which
  816.                     automatically forces DOS to scroll within the top 25
  817.                     lines, regardless of the actual screen size.  With
  818.                     ANSI.SYS and the "t" option the BIOS variable can
  819.                     reflect the actual physical lines available so programs
  820.                     such as VIEW, LIST, TED, DIRMATCH etc. use the full
  821.                     screen yet DOS is restricted to the top 25 lines.
  822.  
  823.                     This does not apply to DOS 5.0 or other ANSI drivers
  824.                     such as VANSI, or PC Magazines ANSI.COM.  For these
  825.                     systems use the default "T" setting.
  826.  
  827.                     ToolBOX will operate correctly with or without ANSI.SYS
  828.                     installed.  The only possible restriction being that in
  829.                     43 or 50 line mode without ANSI.SYS, some application
  830.                     programs may be needlessly restricted to 25 lines with
  831.                     DOS 3 or 4.
  832.  
  833.                a#   select permitted audible tones.  Add the numbers for
  834.                     the particular sounds you wish to hear.
  835.  
  836.                          1 border violations.  Short beeps for attempts to
  837.                            cursor beyond screen borders.
  838.  
  839.                          2 syntax.  Brief chirp made when ToolBOX is unable
  840.                     to
  841.                            understand a keyboard request.  Typically an
  842.                            unexpected character was entered.
  843.  
  844.                          4 error.  Longer warble made when a requested
  845.                            operation could not be carried out.  For example
  846.                            a file could not be deleted because it had read-
  847.                            only attributes .
  848.  
  849.                     The default is a7 - all sounds are enabled.
  850.  
  851. ToolBOX User Manual                                                  Page 14
  852. ____________________________________________________________________________
  853.  
  854.  
  855.                M/m  retain file matchlist specification.  If the matchlist
  856.                     specification isn't retained, it is temporary and will
  857.                     revert to *.* the first time the directory display is
  858.                     updated.  This has no effect if a matchlist specific-
  859.                     ation argument isn't also present.
  860.  
  861.  
  862.        SELECT MEMORY UTILIZATION OPTIONS FOR SECONDARY PROGRAM INITIATION:
  863.  
  864.                -M [Aa] [Pp] [Dd] [Cc]
  865.  
  866.           When ToolBOX initiates an external program or application it can
  867.           optionally reduce its own size to less than 2KB by swapping
  868.           itself out of memory.  This makes more room available for the
  869.           initiated program/application.  Refer to Section 7.5 for an
  870.           explanation of why this may or may not be an advantage.
  871.  
  872.           The following Memory arguments are two state settings. Case is
  873.           important.  The uppercase value sets the condition.
  874.  
  875.           The default is:
  876.  
  877.                          -MaPDc
  878.  
  879.  
  880.                A/a  always swap external programs.
  881.  
  882.                P/p  swap to EMS (Expanded Memory System) memory if pos-
  883.                     sible.  Requires EMS 3.2 or better.  If both P and D
  884.                     are specified, expanded memory will be tried first - if
  885.                     insufficient EMS room exists, disk space will be used.
  886.  
  887.                D/d  swap to disk.  The directory used will be that
  888.                     indicated by the DOS TEMP environemnt variable.  If
  889.                     this does not exist, the DOS PATH string will be
  890.                     searched in order until a directory is found with
  891.                     sufficient room for the temporary file used during the
  892.                     swap process.
  893.  
  894.                     Normally this file is automatically deleted.  However
  895.                     if the initiated program crashes for any reason,
  896.                     ToolBOX may not be able to delete these temporary
  897.                     files.  These files show in the directory as SWP###,
  898.                     where ### is a numeric sequence number.  These files
  899.                     should be manually deleted if they occur.
  900.  
  901.                     Swapping to disk is considerably faster if the TEMP
  902.                     variable or the first directory on the PATH corresponds
  903.                     to a ramdisk.
  904.  
  905.                C/c  use the current directory for these temporary disk
  906.                     files in preference to the PATH directory.
  907.  
  908. ToolBOX User Manual                                                  Page 15
  909. ____________________________________________________________________________
  910.  
  911.  
  912.         MATCH LIST SPECIFICATION FOR DIRECTORY PATH/FILE :
  913.  
  914.                [d:][path]matchlist
  915.  
  916.           Identifies the directory and/or set of files to be displayed on
  917.           startup.  This is for display purposes only, the current
  918.           directory remains unchanged.
  919.  
  920.                [d:][path]matchlist
  921.                     This is essentially a valid DOS file specification
  922.                     containing one or more of a disk drive, directory path,
  923.                     and any number of filename.ext match specifications.
  924.                     The wildcard characters "*" and "?" may be used within
  925.                     the file specification.  Each filename.ext may be
  926.                     prefixed by "!" to indicate files matching this
  927.                     specification are to be removed from the list of
  928.                     previously matched files.  If not provided, the parts
  929.                     default to the current drive, the current path, and *.*
  930.                     respectively.
  931.  
  932.           This is the only argument for which the leading prefix (-) is not
  933.           required.  Any argument that does not begin with a dash is
  934.           assumed to be a match-string within the matchlist specification.
  935.           Although the drive and directory can only be stated once, the
  936.           file specification field may be repeated any number of times.
  937.  
  938.           To permit dashes within filespecs, the specification is assumed
  939.           to continue until the next blank.
  940.  
  941.           If the matchlist specification is provided, only files matching
  942.           this criteria are displayed.  Unless the -xM option was also
  943.           specified, this will only remain in effect until the directory
  944.           window is redisplayed for any reason, when it will revert to
  945.           ".\*.*".  If -xM was provided, the specification will remain in
  946.           effect until a keyboard DIR command with a corresponding /M
  947.           option is entered.
  948.  
  949.  
  950.         SELECT DIRECTORY DISPLAY FORMAT:
  951.  
  952.                -F#
  953.  
  954.           Selects one of the pre-configured presentation display formats
  955.           for the files in the directory window.  This is equivalent to the
  956.           /F# display format parameter of the DIR command, or the format
  957.           option of the <F2><f> popup menu.  These are described in Section
  958.           6.2 and Section 5.5 respectively.
  959.  
  960.                #    single character specification for one of the 8
  961.                     settings.  This is stated as the index 1 through 8 or
  962.                     as the single identification letter used in the option
  963.                     window.  The identification letters and the display
  964.                     fields associated with them are shown in Appendix B.
  965.  
  966. ToolBOX User Manual                                                  Page 16
  967. ____________________________________________________________________________
  968.  
  969.  
  970.                     The default setting is the 2 column Master format:
  971.  
  972.                           -F1
  973.  
  974.  
  975.         SELECT DIRECTORY SORT CRITERIA:
  976.  
  977.                -S#
  978.  
  979.            Selects one of the pre-configured sort procedures used for file
  980.            entries in the directory window.  This is equivalent to the /S#
  981.            sort parameter of the DIR command, or the sort option of the
  982.            <F2><s> popup menu.
  983.  
  984.                #    single character specification for one of the 8
  985.                     possible sort criteria. This is stated as the index 1
  986.                     through 8, or as the single identification letter used
  987.                     in the option window.  The identification letter and
  988.                     sort rules associated with each of the 8 indexes are
  989.                     shown in Appendix B.
  990.  
  991.                     The default sort is first by extension, and then by
  992.                     name:
  993.                           -S1
  994.  
  995.  
  996.          SPECIFY CONFIGURATION FILE:
  997.  
  998.                @cfgfile
  999.  
  1000.            This argument selects a configuration file that has been
  1001.            established by the TBOXCFG program.  Only one configuration file
  1002.            may be referenced.
  1003.  
  1004.            If the file is not in the current directory, the full path must
  1005.            be provided.  An extension of ".CFG" is assumed if one is not
  1006.            specified.
  1007.  
  1008.            The contents of the configuration file (which may contain
  1009.            additional command line arguments) are processed immediately at
  1010.            the spot in the command line where the reference occurs.
  1011.  
  1012.  
  1013. ToolBOX User Manual                                                  Page 17
  1014. ____________________________________________________________________________
  1015.  
  1016.  
  1017.      EXAMPLES OF COMMAND LINE ARGUMENTS (including equivalent BTS SET
  1018.      variable assignments and BTSPATCH program usage):
  1019.  
  1020.           o the defaults are equivalent to :
  1021.  
  1022.  
  1023.                >SET BTS=-V25 -XshdcXrTa7m *.* -MaPDc -F1 -S1
  1024.  
  1025.                     NOTE: The non-stated video and color defaults are
  1026.                           automatically determined on startup.
  1027.  
  1028.  
  1029.           o the typical use:
  1030.  
  1031.                >SET BTS=
  1032.                >TBOX
  1033.  
  1034.           o allocate 43 screen lines for a gray scale monitor, sort by
  1035.             date, display hidden files, don't show .bak or .pag files
  1036.             display only file name and extension information in the
  1037.             directory display, turn off the audio and because we're using
  1038.             ANSI.SYS and not DOS 5, don't tell DOS it must only use 25
  1039.             lines:
  1040.  
  1041.                >SET BTS=-Vv43-Cg-F4-S4 !*.pag
  1042.                >TBOX -Xa0Ht !*.bak
  1043.  
  1044.           o or, equivalent to the above:
  1045.  
  1046.                >BTSPATCH BTS= -V43 -XH
  1047.                >TBOX -S4-F4 -Xa0 -Cg-Xt !*.bak !*.pag
  1048.  
  1049.           o to setup a simple menu for initiating BASIC files from a
  1050.             different directory:
  1051.  
  1052.                >TBOX -F5 -XM c:\basic\*.bas
  1053.  
  1054.           o our personal favorite here at the Binary Toolshed (for DOS 3.3)
  1055.  
  1056.                >BTSPATCH TBOX=-ve43-Xt
  1057.  
  1058. ToolBOX User Manual                                                  Page 18
  1059. ____________________________________________________________________________
  1060.  
  1061.  
  1062. 5.0 OPERATIONAL OVERVIEW
  1063.  
  1064. 5.1 Introduction
  1065.  
  1066.     ToolBOX simultaneously provides directory display operations, point-
  1067.     and-shoot functions, and a direct pass through mechanism for DOS
  1068.     commands.  The balance of this manual outlines the basic keyboard
  1069.     commands for performing these functions.
  1070.  
  1071.     In particular, Sections 5 through 9 describe features available through
  1072.     the factory default command settings.  The default settings will be
  1073.     sufficient for most users.  The TBOXCFG User Manual describes the lower
  1074.     level ToolBOX functions used to implement these operations, as well as
  1075.     the configuration facility for augmenting or altering the basic
  1076.     commands.  There are many configuration capabilities that are probably
  1077.     not obvious from reading this manual such as changing the top banner
  1078.     line or the colors, or recognizing particular programs and accordingly
  1079.     altering the program swap, screen swap, or pause state.  Refer to the
  1080.     TBOXCFG manual for a complete list of the configuration capabilities.
  1081.  
  1082.     Because of the configurability of ToolBOX, the descriptions in this
  1083.     manual refer to the factory default settings within the program before
  1084.     any possible replacement by user configuration files.  Configuration
  1085.     files could alter the function keys or the functions associated with
  1086.     these keys.  Refer to the on-line help for the particular commands that
  1087.     are actually available.
  1088.  
  1089.     Unless noted otherwise, commands described in the following sections
  1090.     can be executed at any time the system is in its normal directory
  1091.     display state.
  1092.  
  1093.  
  1094.  
  1095. 5.2 The Basics
  1096.  
  1097.     The program starts with a directory display.  ToolBOX fills the screen
  1098.     window with a display of files in the current directory.  See Figure
  1099.     5.2/1.  The header portion of the display identifies global information
  1100.     such as volume, directory name, amount of space used by the displayed
  1101.     directory and the amount of free space on the disk volume.  The lower
  1102.     portion displays the actual files organized in serpentine fashion in a
  1103.     varying number of columns across the window.  This is the view you will
  1104.     have virtually all the time you are in ToolBOX.
  1105.  
  1106.     The <LEFT>, <RIGHT>, <UP>, <DOWN>, <PG UP>, and <PG DN> keys move the
  1107.     cursor through the directory display.  <HOME> and <END> move the cursor
  1108.     to the top and bottom lines of the current display respectively, while
  1109.     <HOME><HOME> and <END><END> move the cursor to the extreme bounds of
  1110.     the file list.  <TAB> is similar to the <DOWN> key except that at the
  1111.     end of a column <TAB> will automatically move to the start of the
  1112.     succeeding column.
  1113.  
  1114.     <SPACE> selects the file at the current cursor position.  Selected
  1115.     files (or directories) may either be used in point-and-shoot operations
  1116.     or referenced by DOS command lines.  Various video attributes indicate
  1117. ToolBOX User Manual                                                  Page 19
  1118. ____________________________________________________________________________
  1119.  
  1120.  
  1121.     the current cursor position and which files are selected.
  1122.  
  1123.     <RETURN> initiates the point-and-shoot operation on selected files.
  1124.  
  1125.  
  1126.     ╒═The Binary Toolshed ══════════ ToolBOX ═════════ Tue Jly14/93 10:34:10═╕
  1127.     │ . D:\DOS50\*.*                                              Vol: SYS   │
  1128.     │   521,277 bytes in 33 files                        815,104 free (2%)   │
  1129.     ╞════════════════════════════════════════════════════════════════════════╡
  1130.     │\        ..    <DIR>                 FDISK   .EXE 57,224  09Apr91 05:00 │
  1131.     │ ASSIGN  .COM  6,399  09Apr91 05:00  LABEL   .EXE  9,390  09Apr91 05:00 │
  1132.     │rCOMMAND .COM 47,845  09Apr91 05:00  MEM     .EXE 39,818  09Apr91 05:00 │
  1133.     │ DISKCOMP.COM 10,652  09Apr91 05:00  REPLACE .EXE 20,226  09Apr91 05:00 │
  1134.     │ DISKCOPY.COM 11,793  09Apr91 05:00  SETVER  .EXE 12,007  09Apr91 05:00 │
  1135.     │ DOSKEY  .COM  5,883  09Apr91 05:00  SHARE   .EXE 10,912  09Apr91 05:00 │
  1136.     │ FORMAT  .COM 32,911  09Apr91 05:00  SUBST   .EXE 18,478  09Apr91 05:00 │
  1137.     │ MODE    .COM 23,537  09Apr91 05:00  UNDELETE.EXE 13,924  09Apr91 05:00 │
  1138.     │ MORE    .COM  2,618  09Apr91 05:00  XCOPY   .EXE 15,804  09Apr91 05:00 │
  1139.     │ SYS     .COM 13,440  09Apr91 05:00  QC      .INI    573  10Jly91 22:58 │
  1140.     │ UNFORMAT.COM 18,576  09Apr91 05:00  ANSI    .SYS  9,029  09Apr91 05:00 │
  1141.     │ APPEND  .EXE 10,774  09Apr91 05:00  DRIVER  .SYS  5,409  09Apr91 05:00 │
  1142.     │ ATTRIB  .EXE 15,796  09Apr91 05:00  HIMEM   .SYS 11,552  09Apr91 05:00 │
  1143.     │ CHKDSK  .EXE 16,200  09Apr91 05:00  PRINTER .SYS 18,804  09Apr91 05:00 │
  1144.     │ COMP    .EXE 14,282  09Apr91 05:00  RAMDRIVE.SYS  5,873  09Apr91 05:00 │
  1145.     │ EXPAND  .EXE 14,563  09Apr91 05:00  SMARTDRV.SYS  8,335  09Apr91 05:00 │
  1146.     │ FC      .EXE 18,650  09Apr91 05:00                                     │
  1147.     │                                                                        │
  1148.     │                                                                        │
  1149.     │                                                                        │
  1150.     ╘════════════════════════════════════════════════════════════════════════╛
  1151.  
  1152.     FIGURE 5.2/1  Sample ToolBOX Display of Directory for DOS 5.0
  1153.  
  1154.  
  1155.     DOS commands are entered at any time simply by typing them in.  On the
  1156.     first character entered a command line will appear at the bottom of the
  1157.     screen.  Use the cursor keys, <INS>, <DEL>, etc. as required to edit the
  1158.     command line text.  Then <ENTER> to have it executed.  Use the
  1159.     <UP>/<DOWN> keys to scroll through the text of recently entered command
  1160.     lines.
  1161.  
  1162.     Operations such as deleting files or exiting to DOS generate
  1163.     verification prompt windows.  The desired action can be chosen with the
  1164.     <UP>/<DOWN> keys and selected with the <ENTER> key.  <ESC> is equivalent
  1165.     to the negative response.
  1166.  
  1167.     Use <ESC> at any time to back out of the current operation, such as the
  1168.     entry of a DOS command line, the current help window, the verification
  1169.     prompt, or simply to exit from ToolBOX.
  1170.  
  1171.     As this indicates, ToolBOX's basic operation is straight forward.  If
  1172.     you haven't done so already, try using ToolBOX before reading further
  1173.     sections.  Some experimentation at this point may help you in
  1174.     understanding the nuances and features you will read about.
  1175.  
  1176. ToolBOX User Manual                                                  Page 20
  1177. ____________________________________________________________________________
  1178.  
  1179.  
  1180.  
  1181.  
  1182. «X1»5.3 Directory/Select Modes
  1183.  
  1184.     ToolBOX functions in either of 2 modes: DIRECTORY or SELECT.  Normally
  1185.     the program starts and remains in SELECT mode.  DIRECTORY mode is a
  1186.     special state optimized for use as a basic directory display.
  1187.  
  1188.     The modes are similar in that both permit DOS command lines and other
  1189.     single key operations, and they both display directory data.  However,
  1190.     in SELECT mode the commands may reference and operate on individual
  1191.     files preselected from within the directory display.
  1192.  
  1193.     As there is no need to select individual files in DIRECTORY mode, all
  1194.     the cursor control keys move through the screen display in a slightly
  1195.     different manner than when in SELECT mode.
  1196.  
  1197.     <ALT F10> toggles between DIRECTORY and SELECT mode.  The <SPACE> key
  1198.     will also change the state from DIRECTORY to SELECT mode.
  1199.  
  1200.     Again, DIRECTORY mode is provided for use when ToolBOX is essentially a
  1201.     replacement for the DOS DIR command.  Unless stated otherwise, the
  1202.     balance of this manual assumes the user is in SELECT mode.
  1203.  
  1204.  
  1205.  
  1206. 5.4 Help Facility
  1207.  
  1208.     HELP is obtained by entering <F1>.
  1209.  
  1210.     Two levels of help are available:
  1211.  
  1212.           <F1>      single line descriptions of each command showing:
  1213.                          o selected file match string requirement, or
  1214.                            "----" if not applicable.
  1215.                          o keyboard key used to initiate the command.
  1216.                          o short description.
  1217.  
  1218.           <ALT F1>  description lines as above plus the actual command
  1219.                     lines (DOS or ToolBOX intrinsics) used to carry out the
  1220.                     operation.
  1221.  
  1222.     Within the help screen, commands are listed in command search order.
  1223.  
  1224.     Use <UP>,<DOWN>, <PG UP>, <PG DN>, <HOME>, <END> to scroll within the
  1225.     help screens.  Use <ESC> to exit the help mode and return to the
  1226.     directory display.
  1227.  
  1228.  
  1229.  
  1230. 5.5 Popup Menu Window
  1231.  
  1232.     A popup menu can be invoked with <F2>, or </>.  This menu provides an
  1233.     alternative mechanism for entering several of the more commonly used
  1234.     ToolBOX commands.
  1235. ToolBOX User Manual                                                  Page 21
  1236. ____________________________________________________________________________
  1237.  
  1238.  
  1239.  
  1240.     Within the popup window use <UP> and <DOWN> to move the highlighted
  1241.     cursor position to another option.  Use <RETURN> to either invoke the
  1242.     option at the current cursor, or if applicable to select the next level
  1243.     of options.  <ESC> to exit without making any changes.
  1244.  
  1245.     Where applicable, a diamond appears beside the option corresponding to
  1246.     the current setting.
  1247.  
  1248.     All of the command functions available through the popup menu are
  1249.     available elsewhere, although usually in a less intuitive form.
  1250.  
  1251.     In particular, the functions:
  1252.  
  1253.           . execute a quick command line.  Section 9.5 describes how quick
  1254.             command lines are created, executed, or deleted.  The popup menu
  1255.             is the only method for displaying the quick command lines.
  1256.  
  1257.           . select one of the 8 possible directory display formats.  See
  1258.             Section 6.2.
  1259.  
  1260.           . select one of the 8 possible directory display sort algorithms.
  1261.             See Section 6.2.
  1262.  
  1263.           . set the state of the PAUSE flag.  The flag determines what
  1264.             happens to the DOS screen on completion of DOS commands.  See
  1265.             Section 9.3.
  1266.  
  1267.           . set the state of the DIRECTION flag. See Section 9.3.
  1268.  
  1269.  
  1270.  
  1271. 5.6 Error Reporting
  1272.  
  1273.     Four levels of audio tones of increasing significance denote invalid
  1274.     data entry:
  1275.  
  1276.           o Level 1     : signals attempts to move past the extremes of the
  1277.                           directory display.
  1278.  
  1279.           o Level 2     : signals a keystroke entry is not understood.
  1280.  
  1281.           o Level 3     : signals a requested operation was not successful,
  1282.                           such as a file could not be deleted.
  1283.  
  1284.           o Level 4     : for serious problems that shouldn't have been
  1285.                           feasible to fail or for which continued operation
  1286.                           is questionable: a TSR program was run after
  1287.             ToolBOX,
  1288.                           insufficient memory available, internal errors,
  1289.                           etc.
  1290.  
  1291.     The first three levels can be selectively disabled with the -Xa# command
  1292.     line argument.
  1293.  
  1294. ToolBOX User Manual                                                  Page 22
  1295. ____________________________________________________________________________
  1296.  
  1297.  
  1298.  
  1299.  
  1300. 5.7 Exit To DOS
  1301.  
  1302.     Entering <ESC> in SELECT or DIRECTORY mode will generate a verification
  1303.     window.  It asks if you really want to end the ToolBOX program and
  1304.     return to DOS.
  1305.  
  1306.     Usually, when returning to DOS, the directory display will remain on the
  1307.     screen, although the window border will disappear.  If using the -XR
  1308.     command line argument when starting ToolBOX (see Section 4.2), the last
  1309.     DOS window is restored rather than retaining the current ToolBOX
  1310.     directory display.
  1311.  
  1312.  
  1313. ToolBOX User Manual                                                  Page 23
  1314. ____________________________________________________________________________
  1315.  
  1316.  
  1317. 6.0 DIRECTORY DISPLAY
  1318.  
  1319. 6.1 Introduction
  1320.  
  1321.     As illustrated in Section 5.2/1, the normal ToolBOX display window has
  1322.     two sections: the header area with directory summary information, and
  1323.     the larger bottom area with information on specific files within the
  1324.     directory.
  1325.  
  1326.     Most of the header fields are straight forward: current time, disk drive
  1327.     volume name, total file space used within the displayed directory, and
  1328.     available free space on the drive.  The directory path field within the
  1329.     header contains the file matchlist used to determine the files displayed
  1330.     in the lower file section.  The default is "*.*" so all files within the
  1331.     directory are displayed.  A "." to the left of the directory path
  1332.     indicates that the displayed directory is also the current directory.
  1333.  
  1334.     The bottom portion of the ToolBOX display window is similar to the
  1335.     information provided by the DOS DIR command.  Usually this shows files
  1336.     from the current directory.  Files are displayed/sorted in balanced
  1337.     vertical columns across the width of the window.  Excess file entries
  1338.     exist to the top or bottom of the visible window, not to the sides.
  1339.  
  1340.     The information presented for each file varies with each of the 8
  1341.     display formats, but contains one or more of the file name, file
  1342.     extension, size in bytes, last modification date, and status character.
  1343.     This status character, in order of precedence from the highest to the
  1344.     lowest, is:
  1345.  
  1346.                s   system file
  1347.                h   hidden file
  1348.                r   read-only file
  1349.                \   subdirectory
  1350.  
  1351.     The status character is blank if none of these conditions are
  1352.     applicable.
  1353.  
  1354.     Alter the display by changing the current directory, or by adjusting the
  1355.     presentation rules.  Each time the directory data is updated, a sequence
  1356.     of incrementing numbers appear randomly around the screen.  This has no
  1357.     practical purpose other than to fill in the time.
  1358.  
  1359.     Section 7 elaborates on entering command lines.  Regarding the commands
  1360.     described in the balance of this section,  just accept for the moment
  1361.     that DOS-like command lines can be entered at any time.  Also, while the
  1362.     ToolBOX "dir" and "cd" commands are not identical to the DOS
  1363.     equivalents, they are very similar.
  1364.  
  1365. ToolBOX User Manual                                                  Page 24
  1366. ____________________________________________________________________________
  1367.  
  1368.  
  1369. 6.2 The DIR Command
  1370.  
  1371.     The "dir" command controls the presentation aspects.  Neither case
  1372.     (except for the dir itself) nor parameter order (except for the
  1373.     matchlist "!" fields) are significant.
  1374.  
  1375.         dir [ [d:][path][matchlist] ] [/f#] [/s#] [/hH] [/m]
  1376.  
  1377.  
  1378.             [d:][path][matchlist]
  1379.                     Identifies directory display drive, path and one or more
  1380.                     file match-string specifications.  The "?" and "*"
  1381.                     wildcard characters are permitted in each of the file
  1382.                     match specifications.
  1383.  
  1384.                     The "!" character can be used as a prefix to indicate
  1385.                     that files matching that specification will be removed
  1386.                     from the file list selected by previous selections.
  1387.                     Evaluation is always done left to right.  If the first
  1388.                     field begins with "!", an implied leading "*.*" is
  1389.                     assumed.
  1390.  
  1391.                     Again note, the drive and path can only occur once, but
  1392.                     the file specification with or without the "!" can occur
  1393.                     any number of times.
  1394.  
  1395.  
  1396.             /f#     Selects one of 8 pre-configured display formats.  # may
  1397.                     be a numeric index (1 through 8) or the letter corres-
  1398.                     ponding to the first capital in the option labels.
  1399.                     While summarized here, these labels and the correspond-
  1400.                     ing display formats are described in detail in Appendix
  1401.                     B.
  1402.                               1  Master
  1403.                               2  filename-Size
  1404.                               3  filename-Date
  1405.                               4  Filename
  1406.                               5  Name
  1407.                               6  mAster (B)
  1408.                               7  siZe-filename
  1409.                               8  filename-sizE (B)
  1410.  
  1411.                     The number of columns automatically adjusts to
  1412.                     accommodate the varying amounts of information for each
  1413.                     selection.  Leaving the # field blank restores the
  1414.                     program startup setting.
  1415.  
  1416.  
  1417.             /s#     Selects one of 8 pre-configured sort algorithms.  # may
  1418.                     be a numeric index (1 through 8) or the letter corres-
  1419.                     ponding to the first capital in the option description
  1420.                     label.  These labels, used in the <F2> popup window are
  1421.                     described in Appendix B.  This appendix also explains
  1422.                     the specific sort criteria used for each of the 8
  1423.                     selections.
  1424. ToolBOX User Manual                                                  Page 25
  1425. ____________________________________________________________________________
  1426.  
  1427.  
  1428.  
  1429.                               1  eXtension-name
  1430.                               2  Date-name
  1431.                               3  Size-name
  1432.                               4  dOs order
  1433.                               5  Name-extension
  1434.                               6  extension-daTe
  1435.                               8  extension-siZe
  1436.                               8  Reverse-date-name
  1437.  
  1438.                     Again, leaving the # field blank restores the program
  1439.                     startup setting.
  1440.  
  1441.  
  1442.             /m      Locks in the matchlist specification.  Without this
  1443.                     parameter the matchlist is used for this display update
  1444.                     only, with the display reverting back to the prior
  1445.                     matchlist specification on the next update.  The "/m"
  1446.                     makes the matchlist specification permanent until
  1447.                     another DIR command with a "/m" parameter is used.
  1448.  
  1449.             /h or /H
  1450.                     Setting to exclude or include hidden and system files in
  1451.                     the display directory:
  1452.  
  1453.                               h  do not include hidden and system files.
  1454.                               H  include hidden and system files.
  1455.  
  1456.                     If not stated, the hidden and system files are displayed
  1457.                     as per the ToolBOX -X[hH] command line argument
  1458.  
  1459.     The following example displays all the files in c:\DOS directory having
  1460.     an extension starting with c except for .com files, sorted in the
  1461.     natural DOS order, and showing only the size and filename for each file:
  1462.  
  1463.           dir /fs c:\dos\*.c /so !*.com
  1464.  
  1465.     The /f and /s parameters are permanently retained.  If the above command
  1466.     is followed by the simple
  1467.  
  1468.          dir d:\bin
  1469.  
  1470.     then /fs and /so remain in effect, but the file matchlist for d:\bin is
  1471.     assumed from what was in place prior to the first example.
  1472.  
  1473.  
  1474.  
  1475. ToolBOX User Manual                                                  Page 26
  1476. ____________________________________________________________________________
  1477.  
  1478.  
  1479. 6.3 The CD Command
  1480.  
  1481.  
  1482.     The change directory command ( cd ) is similar to the DOS counterpart
  1483.     but has fewer restrictions.
  1484.  
  1485.         [cd] [d:][path]
  1486.  
  1487.             [d:]    valid DOS drive.
  1488.  
  1489.             [path]  any valid DOS directory specification.
  1490.  
  1491.      Drive changes can be combined with the directory change.  Also, the
  1492.      command name itself is optional.  It is assumed that if the first
  1493.      command word is a directory, then the only logical operation is to
  1494.      change directories to it.  The ToolBOX command:
  1495.  
  1496.                c:\utl
  1497.  
  1498.      is equivalent to the DOS commands:
  1499.  
  1500.                c:
  1501.                cd \utl
  1502.  
  1503.  
  1504.  
  1505. ToolBOX User Manual                                                  Page 27
  1506. ____________________________________________________________________________
  1507.  
  1508.  
  1509. 7.0 KEYBOARD COMMAND LINE PROCESSING
  1510.  
  1511. 7.1 Introduction
  1512.  
  1513.     The keyboard command line is used to create text (command) lines that
  1514.     are subsequently processed, either by DOS or directly by ToolBOX.
  1515.     Pressing any printable character on the keyboard (or <CTRL f>, see
  1516.     Section 7.6) will place ToolBOX into command line mode.  The command
  1517.     line is on the bottom of the screen with a "CMD>" prefix.  Command lines
  1518.     may contain up to 76 characters.
  1519.  
  1520.     In this document, the term command line refers to any text that is
  1521.     subsequently processed as a command, by DOS or ToolBOX.  This text may
  1522.     originate from a quick command, be one of many within a command set
  1523.     associated with a function key, or be manually entered through the
  1524.     keyboard line at the bottom of the screen.  The actual source is not
  1525.     relevant unless specifically identified.
  1526.  
  1527.  
  1528.  
  1529. 7.2 Editing
  1530.  
  1531.     Editing keys are available for modifying the keyboard command line prior
  1532.     to pressing the <RETURN> key that starts processing.  <LEFT>, <RIGHT>,
  1533.     <HOME>, <END>, <DELETE> and <BACKSPACE> all behave as expected.  The
  1534.     <INSERT> key  toggles between insert mode (denoted with a lower line
  1535.     cursor) and overstrike mode (denoted with a block cursor).  <ESC>
  1536.     aborts the command line entry.  The cursor does not need to be at the
  1537.     end of the line when <RETURN> is pressed.
  1538.  
  1539.     Some commands, such as the <ALT f> format key binding discussed in
  1540.     Section 9.4, produce an initial command line that can be altered or
  1541.     completed before <RETURN> is entered.  If a portion of this line is
  1542.     displayed in reverse video, this field will be replaced if any printable
  1543.     characters are entered.
  1544.  
  1545.  
  1546. 7.3 Keyboard Command Stack
  1547.  
  1548.     ToolBOX maintains a command stack of the most recent command lines.
  1549.     When editing a command line, use <UP> or <DOWN> to scroll through
  1550.     previously entered commands.  Once recalled, these commands can be
  1551.     edited and modified, as if they were entered directly through the
  1552.     keyboard.  Duplicate command lines are not retained in the command
  1553.     stack.  The oldest commands are discarded when the 500 character
  1554.     capacity of the command stack is exceeded.
  1555.  
  1556.     When the command line is not visible, pressing <INSERT> will recall the
  1557.     most recent command line from the command stack.
  1558.  
  1559.  
  1560.  
  1561. ToolBOX User Manual                                                  Page 28
  1562. ____________________________________________________________________________
  1563.  
  1564.  
  1565. 7.4 DOS/ToolBOX Command Processing
  1566.  
  1567.     Excluding the keys used for editing or for manipulating the directory
  1568.     cursor, all keyboard data entry ultimately generates a line of text
  1569.     (command line) that must be processed by ToolBOX.  This command text can
  1570.     originate from many sources.  Manually entered in the command line at
  1571.     the bottom of the screen or perhaps generated from quick commands or
  1572.     command sets triggered by a single keystroke.  Regardless, the resulting
  1573.     command lines are processed in the same way.
  1574.  
  1575.     ToolBOX uses DOS to process some commands and handles others itself.
  1576.     These internal ToolBOX commands (or intrinsics) include dir, del, and
  1577.     cd.  Intrinsic commands can be entered as either upper or lower case.
  1578.     If the DOS equivalent is desired, enter the command characters in mixed
  1579.     case.  The command line will then be passed to DOS which is case
  1580.     insensitive.  For example "dir a:\*.c" will be processed by ToolBOX to
  1581.     update its window, while "Dir a:\*.c" will generate the traditional
  1582.     scrolling column of file information.
  1583.  
  1584.     By default any command line that doesn't start with one of the known
  1585.     intrinsic commands is assumed to be a DOS command line.  These reserved
  1586.     intrinsic command words described in the next subsections are cd, d:,
  1587.     dir, del, killdir, sel, tbx, t*x, or a directory name.
  1588.  
  1589.     The non-intrinsic command lines are essentially identical to those you
  1590.     would enter at the DOS prompt and are processed as if entered there.
  1591.     There are a few exceptions.  Operations specific to batch files are not
  1592.     supported (e.g. labels, errorLevel, or the GOTO command), nor are
  1593.     commands which modify environment variables (e.g. SET or PATH).  Also,
  1594.     you cannot invoke programs that establish TSR segments.  These programs
  1595.     should be installed prior to running ToolBOX.  If an invoked program
  1596.     does establish a resident TSR segment, ToolBOX will issue a warning of
  1597.     the imminent problem.  At best the memory space occupied by ToolBOX will
  1598.     be unusable by DOS on exit; at worst the conflicting memory requirements
  1599.     of ToolBOX and the TSR could cause either to crash.
  1600.  
  1601.     Programs, for which a specific path is not stated, may exist in the
  1602.     current directory or in any directory referenced by the PATH.
  1603.  
  1604.     Programs having .EXE or .COM extensions are executed directly - yielding
  1605.     a marginal speed and memory (about 4 KB) advantage.  For the others
  1606.     including programs without extensions, .BAT files, DOS internal commands
  1607.     or any command line with piping or redirection of STDIN or STDOUT, a
  1608.     secondary COMMAND.COM shell is invoked to process the command line.
  1609.  
  1610.  
  1611.  
  1612. 7.5 Memory Utilization
  1613.  
  1614.     If memory utilization is an issue, ToolBOX is capable of reducing its
  1615.     own memory requirements to less than 2Kb prior to invoking any external
  1616.     program.  ToolBOX can be rolled out (or swapped) simply by prefixing the
  1617.     command line with "@".  For example
  1618.  
  1619.                @wp whatever.txt
  1620. ToolBOX User Manual                                                  Page 29
  1621. ____________________________________________________________________________
  1622.  
  1623.  
  1624.  
  1625.     will allow WordPerfect to have essentially as much memory as if it had
  1626.     been run without ToolBOX.
  1627.  
  1628.     ToolBOX startup arguments (see Section 4.2) identify whether this
  1629.     rollout occurs automatically or only when the "@" is specified.  These
  1630.     arguments also specify whether EMS memory and/or disk is used for the
  1631.     intermediate storage.
  1632.  
  1633.     Most programs neither need nor can take advantage of significant amounts
  1634.     of memory.  When using EMS memory or a ram-disk, while admittedly small,
  1635.     there is always a speed penalty for swapping ToolBOX out of active
  1636.     memory.  It is suggested that the "@" function be reserved for programs
  1637.     where there is a specific advantage to doing so.
  1638.  
  1639.  
  1640. 7.6 Command Line Variables
  1641.  
  1642.     Variables, inserted into keyboard command lines by <CTRL letter>,
  1643.     simplify the entry of filenames and related information.  The typical
  1644.     command line use for these variables is to reference files selected
  1645.     within the directory display, although not all variables require
  1646.     selected files.  The variables and the values they are used to represent
  1647.     are:
  1648.  
  1649.           <CTRL d>    display drive letter
  1650.           <CTRL p>    display path
  1651.           <CTRL n>    1 to 8 character file name
  1652.           <CTRL x>    0 to 3 character extension
  1653.  
  1654.           <CTRL f>    minimized pathname, i.e. sufficient information to
  1655.                       uniquely reference the selected file from the current
  1656.                       directory
  1657.  
  1658.           <CTRL D>    current drive letter
  1659.           <CTRL P>    current path
  1660.  
  1661.     Within the keyboard command line, these variables are displayed as a
  1662.     diamond prefix followed by the alphabetic character.
  1663.  
  1664.     If the directory display is for the current directory then the current
  1665.     and display directories coincide, however, this need not be the case.
  1666.  
  1667. ToolBOX User Manual                                                  Page 30
  1668. ____________________________________________________________________________
  1669.  
  1670.  
  1671.     As an example, if the selected file is C:\DOS\XCOPY.COM then the
  1672.     respective variables when C:\DOS is displayed from two alternate
  1673.     directories, are:
  1674.  
  1675.                CURRENT DIR IS C:\DOS      CURRENT DIR IS A:\
  1676.                DISPLAY DIR IS C:\DOS      DISPLAY DIR IS C:\DOS
  1677.                ─────────────────────      ─────────────────────
  1678.      <CTRL D>            C                        A
  1679.      <CTRL d>            C                        C
  1680.      <CTRL P>            \DOS                     \
  1681.      <CTRL p>            \DOS                     \DOS
  1682.      <CTRL n>            XCOPY                    XCOPY
  1683.      <CTRL x>            COM                      COM
  1684.      <CTRL f>            XCOPY.COM                C:\DOS\XCOPY.COM
  1685.  
  1686.     Typically <CTRL f> is used to reference any file from the directory
  1687.     display as it automatically provides all required components and
  1688.     delimeters.  For example, to use the DOS COPY command to move the above
  1689.     file to a:\tmp when in a:\, the following are all correct and
  1690.     equivalent:
  1691.  
  1692.           copy c:\dos\xcopy.com a:\tmp
  1693.           copy <CTRL f> a:\tmp
  1694.           copy <CTRL d>:<CTRL p>\<CTRL n>.<CTRL x> <CTRL D>:\tmp
  1695.  
  1696.     Variables are especially useful for commands used with multiple
  1697.     selections from the directory display.  For example, to delete any
  1698.     number of selected directory entries, enter:
  1699.  
  1700.           rd <CTRL f>
  1701.  
  1702.     Command lines that contains a variable reference will be executed once
  1703.     for each selected file.
  1704.  
  1705.     Variables also make it easier to re-use command lines in the command
  1706.     stack.  There is usually less editing required.
  1707.  
  1708.  
  1709.  
  1710. 7.7 External Command Access
  1711.  
  1712.     While in keyboard command line mode, it is still possible to execute
  1713.     several of the single key stroke ToolBOX functions.  As a simple
  1714.     guideline, any command can be used as long as it does not conflict with
  1715.     characters used for editing the command lines, change the current
  1716.     directory, or reference the currently selected files.  The commands that
  1717.     can be used include those that alter the number of screen lines, change
  1718.     the split screen status, change the display sort and format settings,
  1719.     toggle ToolBOX/DOS views etc.  If you enter an inappropriate command, an
  1720.     audible tone will sound.
  1721.  
  1722.  
  1723. ToolBOX User Manual                                                  Page 31
  1724. ____________________________________________________________________________
  1725.  
  1726.  
  1727. 8.0 COMMAND SEQUENCING
  1728.  
  1729. 8.1 Introduction
  1730.  
  1731.  
  1732.     Commands are initiated in many ways within ToolBOX.  They may be
  1733.     manually entered DOS-like command lines, pre-configured sets of command
  1734.     lines or quicklines activated with a single key, a result of a point-
  1735.     and-shoot operation, or options chosen from popup menus.  The term
  1736.     point-and-shoot refers to the ability to cursor to a given object, and
  1737.     then have an operation carried out based on a characteristic of the
  1738.     selected item.
  1739.     Regardless of the source, the commands all share the same capabilities:
  1740.     all can access ToolBOX or DOS command facilities and all can optionally
  1741.     incorporate selected display files.
  1742.  
  1743.     This section describes the selection of files, and the determination of
  1744.     the operation to be performed on the selected files.
  1745.  
  1746.  
  1747.  
  1748. 8.2 File Selection
  1749.  
  1750.  
  1751.     In SELECT MODE files can be selected (or tagged) for inclusion in
  1752.     subsequent command execution.  Later sections will detail the actual
  1753.     execution.
  1754.  
  1755.     Move the cursor to a particular file, then use the following commands
  1756.     to select or unselect a file or groups of files:
  1757.  
  1758.  
  1759.             <SPACE>         toggle status of file at cursor.
  1760.  
  1761.             <SHIFT SPACE>   toggle status of file at cursor and then move
  1762.                             cursor to the next file (equivalent to <SPACE>
  1763.                             <TAB>).
  1764.  
  1765.             <SHIFT cursor-key> toggles a range of files that can be extended
  1766.                             in any direction by the <SHIFT LEFT>, <SHIFT
  1767.                             RIGHT>, <SHIFT UP>, or <SHIFT DOWN> keys.
  1768.  
  1769.             <ALT SPACE>     toggle status of all files with the same
  1770.                             extension as the file at the cursor.
  1771.  
  1772.             <CTRL SPACE>    toggle status of all files.
  1773.  
  1774.  
  1775.     All of the select commands toggle the current select state rather than
  1776.     specifically setting or resetting the status.  For group selects, the
  1777.     initial status is determined from the file at the cursor.  For example
  1778.     to select or reset all files, enter <CTRL SPACE> once or twice.
  1779.  
  1780.     ToolBOX remembers the order of selection.  For group selections, this is
  1781.     the file at the cursor followed by the other files in the order they
  1782. ToolBOX User Manual                                                  Page 32
  1783. ____________________________________________________________________________
  1784.  
  1785.  
  1786.     appear in the display.
  1787.  
  1788.     The display uses color combinations (or equivalent) to distinguish the
  1789.     selected files and the cursor position.
  1790.  
  1791.     In addition to the above commands, files can be de-selected by changing
  1792.     directories or by executing a command line which references the selected
  1793.     files.
  1794.  
  1795.  
  1796.  
  1797. 8.3 Soft Selection
  1798.  
  1799.     With soft selection, the file at the current cursor position is assumed
  1800.     to be selected if and only if no other files are selected.   This
  1801.     obviously is only applicable to commands that actually reference
  1802.     selected files.
  1803.  
  1804.  
  1805.  
  1806. 8.4 Basic Point-and-Shoot Operations
  1807.  
  1808.     Through the TBOXCFG program, it is possible to associate keyboard keys
  1809.     and selected file match strings with a particular operation.  When the
  1810.     key and file-match occur together, the operation is initiated -
  1811.     typically this is a specific program or batch file.  The default setup
  1812.     supports four standard point-and-shoot functions; all with the <RETURN>
  1813.     key.  These are:
  1814.  
  1815.             KEY     MATCHSTRING    ACTION
  1816.  
  1817.           <RETURN>  Directory *.*  Change directory
  1818.           <RETURN>  *.BAT          Execute batch file
  1819.           <RETURN>  *.COM          Execute .COM program
  1820.           <RETURN>  *.EXE          Execute .EXE program
  1821.           <RETURN>  *.*            VIEW *.*
  1822.  
  1823.     As this sequence is searched in order when <RETURN> is entered, VIEW
  1824.     will automatically be invoked to display any file that does not match
  1825.     one of the prior match-strings.  Also, refer to Section 9.6 for inferred
  1826.     batch file initiation.
  1827.  
  1828.     The TBOXCFG program can easily extend the list.  Then, based on a given
  1829.     match-string, your link program, data base application, editor, word
  1830.     processor, make facility, archive extract utility, spreadsheet, picture
  1831.     viewer, and so on, will automatically be initiated.  Use other keys as
  1832.     well.  For example ( <RETURN> *.asm ) could be used to edit a file and
  1833.     ( <ALT RETURN> *.asm ) to assemble the file.
  1834.  
  1835.  
  1836. 8.5 Command Sequencing
  1837.  
  1838.     The point-and-shoot function described above is a practical example of
  1839.     ToolBOX's generalized command system.  When an initial keystroke is
  1840.     entered, ToolBOX searches its list of possible commands.  Each command
  1841. ToolBOX User Manual                                                  Page 33
  1842. ____________________________________________________________________________
  1843.  
  1844.  
  1845.     in the list has a particular keystroke requirement and optionally a file
  1846.     match specification for a selected file.  The action taken by ToolBOX is
  1847.     based on the first definition matching the keystroke and the optional
  1848.     file selection.
  1849.  
  1850.     If the command set (or keyboard command) being executed did not contain
  1851.     a file match reference to a selected file, then the command executes
  1852.     once and only once.  Otherwise, the command selection and execution
  1853.     process will be performed once for each selected file.
  1854.  
  1855.     Within ToolBOX, virtually everything, except the cursor commands, is
  1856.     implemented through this command control facility.  The <F1> help
  1857.     screens list these commands in the natural search order and, for each,
  1858.     shows the keystroke and the optional file match requirements.
  1859.  
  1860.     If the sequence of operations being performed on the selected files
  1861.     should be aborted for any reason, enter <CTRL c> or <CTRL BREAK>.  The
  1862.     effectiveness of this attempted abort will depend on the timing of the
  1863.     entered characters and whether the program(s) being stopped also reads
  1864.     the abort characters.
  1865.  
  1866.  
  1867.     8.6 Display Output
  1868.  
  1869.     For intrinsic ToolBOX commands, or others that ToolBOX knows about and
  1870.     is aware won't affect the current display, ToolBOX performs the
  1871.     operation transparently without any visible effect on the directory
  1872.     display.
  1873.  
  1874.     For the other commands, ToolBOX first restores the DOS screen as it
  1875.     existed following the most recent ToolBOX initiated command line.  A
  1876.     pseudo command line preceded by two diamonds is generated on the DOS
  1877.     screen, followed by the normal command output.  On completion of the
  1878.     command, ToolBOX restores its directory display.  In many cases this
  1879.     will occur so rapidly it will be difficult to see what happened.  There
  1880.     are several mechanisms for retaining these results:
  1881.  
  1882.           o enter the -xP command line argument, /p, or <ALT F2> to set the
  1883.             PAUSE state.  Following commands with PAUSE set to ON, ToolBOX
  1884.             will wait until you are ready before erasing the DOS screen.
  1885.  
  1886.           o entering <F10> at any time will toggle between the ToolBOX
  1887.             directory display and the most recent DOS screen.
  1888.  
  1889.           o for those with EGA or VGA, entering <F9> will split the visible
  1890.             window so ToolBOX's directory display and the DOS screen can
  1891.             coexist simultaneously.
  1892.  
  1893.     The control of the window screens is explained in detail in Section 9.1.
  1894.  
  1895. ToolBOX User Manual                                                  Page 34
  1896. ____________________________________________________________________________
  1897.  
  1898.  
  1899. 9.0 ADDITIONAL COMMANDS
  1900.  
  1901. 9.1 Window Control
  1902.  
  1903.     The default ToolBOX display is in SELECT mode and contains 25 rows by 80
  1904.     columns.
  1905.  
  1906.  
  1907.       ADJUST NUMBER OF DISPLAY LINES
  1908.  
  1909.           <ALT 2>   Switch to 25 line mode
  1910.           <ALT 4>   Switch to 43 line mode
  1911.           <ALT 5>   Switch to 50 line mode
  1912.           <ALT 0>   Switch to current number of DOS lines
  1913.  
  1914.                     To work correctly, these require that you have the
  1915.                     proper video adapter.  EGA or VGA are required for 43
  1916.                     line mode.  VGA is required for 50 line mode.
  1917.  
  1918.       CHANGE WINDOW DISPLAY MODE
  1919.  
  1920.           <F10>     Switch between the ToolBOX and DOS window.  Use this
  1921.                     function after a DOS command has completed and you wish
  1922.                     to see the last complete DOS screen.  The DOS window is
  1923.                     for presentation purposes only.  You will be prompted to
  1924.                     enter any key to return to the ToolBOX window.
  1925.  
  1926.           <ALT F10> Toggle between SELECT and DIRECTORY modes.  While the
  1927.                     modes are similar, DIRECTORY mode simplifies the
  1928.                     operational use when using ToolBOX as a file directory
  1929.                     display program.  Visually, identify SELECT mode by the
  1930.                     bright border around the directory display.
  1931.  
  1932.           <F9>      Toggle DOS/ToolBOX split screen.  In this mode the top
  1933.                     25 screen lines are used by DOS with the ToolBOX file
  1934.                     window displayed in the balance of the lines at the
  1935.                     bottom.  As the ToolBOX and DOS screens are visible at
  1936.                     the same time, it not necessary to switch back and forth
  1937.                     during execution of DOS commands.
  1938.  
  1939.                     This requires at least EGA for the 43 line mode; it is
  1940.                     not available for MDA or CGA video cards.  If the system
  1941.                     is in 25 line mode, it will automatically switch to 43
  1942.                     or 50 line mode before performing the split.
  1943.  
  1944.                     In split screen mode it may not be obvious when the DOS
  1945.                     command has been completed and ToolBOX is again in
  1946.                     control.  Refer to the clock in the ToolBOX directory
  1947.                     header. While the invoked program is in control the
  1948.                     seconds field contains "--" rather than the incrementing
  1949.                     time.
  1950.  
  1951.     All of the above can be entered directly during the entry of keyboard
  1952.     command lines.
  1953.  
  1954. ToolBOX User Manual                                                  Page 35
  1955. ____________________________________________________________________________
  1956.  
  1957.  
  1958.  
  1959.  
  1960. 9.2 Directory Control
  1961.  
  1962.     In addition to the commands already mentioned for changing directories,
  1963.     the following keystroke sequences are also available:
  1964.  
  1965.  
  1966.       DIRECTORY DISPLAY ADJUSTMENTS
  1967.  
  1968.           <F8>      Refresh directory display.  Re-read the directory data
  1969.                     and update the display.  This may be necessary if the
  1970.                     screen is corrupted or if adjustments have been made to
  1971.                     the current directory files that ToolBOX is not yet
  1972.                     aware of (for example if diskettes are exchanged or on a
  1973.                     multiple user network).
  1974.  
  1975.           <ALT F8>  Move to display directory.  Ensures the current dir-
  1976.                     ectory corresponds to the display directory by changing
  1977.                     the current directory if required.
  1978.  
  1979.           <CTRL F8> Display current directory.  Ensures the directory
  1980.                     display corresponds to the current working directory by
  1981.                     changing the display directory if required.
  1982.  
  1983.  
  1984.       DIRECTORY STACK
  1985.  
  1986.           <keypad ->
  1987.                     Cycle backward through directories in the stack.
  1988.           <keypad +>
  1989.                     Cycle forward through directories in the stack.
  1990.  
  1991.                     ToolBOX maintains a stack of the most recently entered
  1992.                     directories, along with the last known cursor position
  1993.                     in each.  Entering <keypad +> or <keypad -> is
  1994.                     effectively equivalent to issuing a change directory
  1995.                     command to the next directory on the stack.
  1996.  
  1997.                     While data dependent, the stack typically can maintain
  1998.                     the last 20 unique directories entered.
  1999.  
  2000.  
  2001.       DISK DRIVE SHIFTS
  2002.  
  2003.           <CTRL PgDn> Change to the next lower installed drive.
  2004.           <CTRL PgUp> Change to the next higher installed drive.
  2005.  
  2006.                     These commands will sequence the current drive through
  2007.                     all valid drives, from a: to b: to c: etc.  This will
  2008.                     cycle around at the end of the sequence.
  2009.  
  2010.  
  2011.  
  2012. ToolBOX User Manual                                                  Page 36
  2013. ____________________________________________________________________________
  2014.  
  2015.  
  2016. 9.3 Window Contents
  2017.  
  2018.     These commands allow manipulation of the ToolBOX directory display
  2019.     window.
  2020.  
  2021.  
  2022.       FILE DISPLAY
  2023.  
  2024.  
  2025.           <ALT F9>  Select next sort criteria.
  2026.           <CTRL F9> Select next file display format.
  2027.  
  2028.                     These keys provide single key control of the file
  2029.                     display characteristics.  Each cycles to the next of the
  2030.                     eight possible settings.  This is similar to the <F2>
  2031.                     popup window or the command line "dir" command.
  2032.  
  2033.                     These are accessible during the entry of keyboard
  2034.                     commands.
  2035.  
  2036.  
  2037.       CONTROL FEATURES
  2038.  
  2039.           <ALT F2>  Toggle pause status.  The default state is OFF.  If ON,
  2040.                     ToolBOX will stay on the DOS screen after executing the
  2041.                     DOS command(s).  Entering any key will restore the
  2042.                     ToolBOX window.
  2043.  
  2044.                     The paused screen is identical to the DOS window
  2045.                     displayed with the <F10> command.  Concluding batch
  2046.                     files with the DOS PAUSE command achieves a similar
  2047.                     effect.  Pause mode is not required in split screen
  2048.                     mode.
  2049.  
  2050.                     Also try the <F2><p> popup menu command described in
  2051.                     Section 5.5.
  2052.  
  2053.  
  2054.  
  2055.           <CTRL F2> Toggle direction flag.  Normally <TAB>, <SHIFT SPACE>,
  2056.                     <ALT F9>, and <CTRL F9> move forward.  Toggling the
  2057.                     direction flag will cause them to go in the opposite
  2058.                     direction.
  2059.  
  2060.                     Also try the <F2><d> popup menu command described in
  2061.                     Section 5.5.
  2062.  
  2063. ToolBOX User Manual                                                  Page 37
  2064. ____________________________________________________________________________
  2065.  
  2066.  
  2067. 9.4 DOS Commands
  2068.  
  2069.         SINGLE KEYSTROKES FOR DOS FUNCTIONS
  2070.  
  2071.           <ALT d>   Delete selected file(s).  A prompt appears for
  2072.                     confirmation before deleting the selected files.
  2073.  
  2074.                     The one notable difference between the ToolBOX and DOS
  2075.                     implementations is that ToolBOX will not delete subdir-
  2076.                     ectories (i.e. the files in the next directory level).
  2077.                     This is intentional to prevent the accidental erasure of
  2078.                     directories, which is  easily done in a point-and-shoot
  2079.                     environment.  To delete subdirectories, either:
  2080.  
  2081.                          o move into the subdirectory itself.
  2082.  
  2083.                          o insert at least one capital in the "del" command
  2084.                            so the regular DOS version is used.
  2085.  
  2086.                          o use the ToolBOX killdir command described in
  2087.                            Section 9.7.
  2088.  
  2089.                     ToolBOX will beep if it cannot delete one of the
  2090.                     selected files.  Selected directories are ignored, i.e.
  2091.                     if deleting everything it's not necessary to
  2092.                     specifically de-select the directories.
  2093.  
  2094.                     The delete command is also available as an intrinsic,
  2095.                     entered as a keyboard command line:
  2096.  
  2097.                          del [d:][path]matchlist
  2098.  
  2099.                     This has the same particulars as explained above for
  2100.                     <ALT d>.  Refer to Section 10.4.
  2101.  
  2102.  
  2103.           <ALT p>   Print selected file(s).  This uses the DOS copy command
  2104.                     to copy selected files to the printer (PRN:).
  2105.  
  2106.  
  2107.           <ALT s>   Shell to DOS.  This will invoke a second version of the
  2108.                     DOS COMMAND.COM shell.  Enter DOS commands as required,
  2109.                     and then enter the EXIT command to return to ToolBOX.
  2110.                     Unlike exiting to DOS via <ESC>, this does not terminate
  2111.                     ToolBOX.  Shelling to DOS allows ToolBOX to retain its
  2112.                     initialization data, command line stack, directory
  2113.                     stack, and so on.
  2114.  
  2115.                     The current DOS prompt string is prefixed with "TBOX"
  2116.                     to serve as a reminder that you must eventually return
  2117.                     to ToolBOX.  Again, enter "EXIT" to cancel the DOS shell
  2118.                     and return to ToolBOX.
  2119.  
  2120.  
  2121.  
  2122. ToolBOX User Manual                                                  Page 38
  2123. ____________________________________________________________________________
  2124.  
  2125.  
  2126.       DOS COMMAND LINE TEMPLATES
  2127.  
  2128.           The following are not conventional commands.  Rather, each places
  2129.           a text string into the keyboard command line buffer.  This text
  2130.           can be edited as if it were entered through the keyboard.  This
  2131.           facility simply provides a quick way of generating standard
  2132.           command lines.  Edit the fields in the template as required to
  2133.           produce the desired command line.  Some templates produce fields
  2134.           highlighted in reverse video.  Enter <RETURN> to accept the
  2135.           highlighted text as is; entering any printable text causes the
  2136.           highlighted text to be deleted and replaced by the newly entered
  2137.           characters.
  2138.  
  2139.           The f parameter field in the following commands will be replaced
  2140.           by the selected file name when the command is actually processed.
  2141.  
  2142.  
  2143.           <ALT c>   Template for using the DOS COPY command to copy selected
  2144.                     files.  To use this template without further editing,
  2145.                     move to the target directory and then display the source
  2146.                     directory before you select the applicable files.
  2147.  
  2148.                          COPY f
  2149.  
  2150.  
  2151.           <ALT f>   Template for DOS FORMAT command.
  2152.  
  2153.                          FORMAT A:
  2154.  
  2155.  
  2156.           <ALT r>   Template for using the DOS RENAME command to rename
  2157.                     selected files.
  2158.  
  2159.                          RENAME f
  2160.  
  2161.  
  2162. 9.5 Quick Commands
  2163.  
  2164.     ToolBOX maintains a list of single line commands that can be executed at
  2165.     any time.  Use this facility for predefined directory change commands or
  2166.     commands that are used repeatedly.  This is the only mechanism available
  2167.     to configure commands from within ToolBOX without the TBOXCFG program.
  2168.  
  2169.     Quick commands can be predefined through the configuration file or
  2170.     created dynamically as explained below with <ALT F7> and <SHIFT F7>.
  2171.     Quick command contents, limited to one line, must be consistent with
  2172.     what ToolBOX can support through its keyboard command line.  Each is
  2173.     associated with a single letter designation label.  These are not
  2174.     templates that can be edited before being executed.  They are processed
  2175.     exactly as defined.  The currently defined quick commands can be viewed
  2176.     (or initiated) through the <F2><q> popup window.  There are no factory
  2177.     default quick commands defined.
  2178.  
  2179.     All quick commands are 2 keystroke sequences, the command key ( ' )
  2180.     followed by the label character.  There is no visual screen indication
  2181. ToolBOX User Manual                                                  Page 39
  2182. ____________________________________________________________________________
  2183.  
  2184.  
  2185.     that the second label character is expected.  Label characters may be
  2186.     any of the 94 printable ASCII characters on the keyboard; i.e. case is
  2187.     significant.
  2188.  
  2189.       COMMANDS FOR MANIPULATING QUICK COMMANDS
  2190.  
  2191.           <F7><x>        Execute quick command x.
  2192.                    or
  2193.           <'><x>         Execute quick command x.
  2194.  
  2195.                          These commands are identical.  A single letter
  2196.                          quick command definition label code (denoted as x)
  2197.                          corresponding to an existing quick command
  2198.                          definition is expected following this initial
  2199.                          command key.  ToolBOX will beep if the next char-
  2200.                          acter does not correspond to a defined quick
  2201.                          command label.
  2202.  
  2203.                          Quick lines execute once only; not once for each
  2204.                          selected file.  Variables within the quick line are
  2205.                          assumed to reference the entry at the current
  2206.                          cursor position.
  2207.  
  2208.           <SHIFT F7><x>  Make the current keyboard command line quick
  2209.                          command x.  This places the present keyboard
  2210.                          command line in quick command x.  A single letter
  2211.                          quick command definition label is expected
  2212.                          following the command key.  If the letter you chose
  2213.                          for your label is already assigned to an existing
  2214.                          quick command, it will automatically be redefined
  2215.                          and the old quick command lost.  The keyboard
  2216.                          command line (which must exist) is cleared
  2217.                          following this operation.
  2218.  
  2219.           <ALT F7><x>    Create quick command x, which will change to the
  2220.                          current directory. This quick command line is
  2221.                          equivalent to a <SHIFT F7><x> command if the
  2222.                          keyboard command line contains a change directory
  2223.                          (CD) command to the current directory.  If the
  2224.                          label existed previously, the old contents are
  2225.                          lost.
  2226.  
  2227.           <CTRL F7><x>   Delete quick command x.  Deletes the quick command
  2228.                          defined by the <x> label character.  ToolBOX beeps
  2229.                          if no such quick command is defined.
  2230.  
  2231.  
  2232.  
  2233. 9.6 Inferred Batch File Selection
  2234.  
  2235.     The point-and-shoot operations described in Section 8 executed the
  2236.     currently selected program.  While similar, the inferred batch file
  2237.     operation doesn't directly invoke this file.  Rather, based on the key-
  2238.     stroke entered, and optionally on the extension of the filename pointed
  2239.     at, ToolBOX composes the name of a corresponding batch file.  If it
  2240. ToolBOX User Manual                                                  Page 40
  2241. ____________________________________________________________________________
  2242.  
  2243.  
  2244.     exists, it is invoked, otherwise an alternate procedure is performed.
  2245.     Usually this alternate action is to use the VIEW.EXE utility program to
  2246.     display the selected file.
  2247.  
  2248.     These commands and the corresponding match-strings are:
  2249.  
  2250.              KEY      MATCHSTRING       ACTION
  2251.  
  2252.           <RETURN>       *.xxx     Execute TBX--xxx.BAT if accessible,
  2253.                                    otherwise use VIEW to display *.xxx
  2254.  
  2255.           <CTRL RETURN>  *.xxx     Execute TBXC-xxx.BAT if accessible,
  2256.                                    otherwise use VIEW to display *.xxx
  2257.  
  2258.           <ALT RETURN>   *.xxx     Execute TBXA-xxx.BAT if accessible,
  2259.                                    otherwise use VIEW to display *.xxx
  2260.  
  2261.           <ALT key-x>     ---      Execute TBX-ALTx.BAT if accessible.
  2262.  
  2263.           <CTRL key-x>    ---      Execute TBX-CTLx.BAT if accessible.
  2264.  
  2265.                     xxx  indicates any file extension of up to 3 characters.
  2266.                          These characters are used in the composed file
  2267.                          name.
  2268.  
  2269.                     ---  indicates no file match is required.  The - and --
  2270.                          used in the filenames are actual dashes.
  2271.  
  2272.                   key-x  indicates any keyboard character.  The character
  2273.                          (denoted by x) is used in the composed file name.
  2274.  
  2275.     ToolBOX searches for the composed batch file name in the current
  2276.     directory and then on each directory referenced within the PATH.  If
  2277.     found, the batch file is invoked with variable parameters.
  2278.  
  2279.     For the operations with match-strings, the matched filename is passed as
  2280.     a single filespec and as individual components.  For example:
  2281.  
  2282.           TBX--xxx.BAT f d:p\n.x d p n x
  2283.  
  2284.     For the operations that do not require a match-string, only the
  2285.     minimized pathname is passed.  For example:
  2286.  
  2287.           TBX-ALTx.BAT f
  2288.  
  2289.     As there is no requirement for a match-string, this command will execute
  2290.     only once per keystroke.  It will not be repeated even if multiple files
  2291.     are selected.  The first selected file is passed only as a possible
  2292.     convenience.  The selected file will remain selected even after
  2293.     completion of the command.
  2294.  
  2295.     Keystrokes such as <ALT c> and <ALT d> are not available for inferred
  2296.     batch files since they are already associated with the higher priority
  2297.     COPY and DELETE functions.
  2298.  
  2299. ToolBOX User Manual                                                  Page 41
  2300. ____________________________________________________________________________
  2301.  
  2302.  
  2303. 9.7 Explicit Program Requests
  2304.  
  2305.     Other commands available include:
  2306.  
  2307.             KEY       MATCHSTRING       ACTION
  2308.  
  2309.  
  2310.            <ALT v>       *.*       VIEW selected file(s).  The VIEW program
  2311.                                    is invoked to display the contents of
  2312.                                    each selected file.
  2313.  
  2314.                                    Note that each file is viewed independ-
  2315.                                    ently.  It is not possible within VIEW to
  2316.                                    request the next or previous file.
  2317.  
  2318.            <ALT k>       *.*       Killdir - delete directory and its cont-
  2319.                       (Directory)  ents, including multiple levels.  For
  2320.                                    each selected directory, killdir issues a
  2321.                                    prompt window allowing the user to select
  2322.                                    between 3 options for the directory:
  2323.  
  2324.                                        o delete all files and directories
  2325.                                          for all levels
  2326.  
  2327.                                        o delete all files for all levels
  2328.  
  2329.                                        o delete all files for the first
  2330.                                          level
  2331.  
  2332.                                    This operation is sometimes referred to
  2333.                                    as pruning.
  2334.  
  2335. ToolBOX User Manual                                                  Page 42
  2336. ____________________________________________________________________________
  2337.  
  2338.  
  2339. 10.0 INTRINSIC COMMANDS
  2340.  
  2341. 10.1 Typical Usage
  2342.  
  2343.     All ToolBOX commands described up to this point are implemented through
  2344.     a second level of intrinsic commands.  These intrinsics are understood
  2345.     and processed directly by ToolBOX.  While accessible during normal
  2346.     command line entry, knowledge of them and their operations is not
  2347.     necessary for most ToolBOX activities.
  2348.  
  2349.     Section 10 describes the intrinsics intended for entry through the
  2350.     keyboard command line.  Some of these have been discussed before.
  2351.     Additional intrinsic commands, which are more often found in the command
  2352.     sets bound to particular keystrokes, are described in the TBOXCFG User
  2353.     Manual.
  2354.  
  2355.  
  2356.  
  2357. 10.2 Intrinsic DIR command
  2358.  
  2359.     Section 6.2 explains the features of the dir command:
  2360.  
  2361.        dir [ [d:][path][matchlist] ] [/s[+-!]#] [/f[+-!]#] [/m] [/hH]
  2362.  
  2363.     Further to the specification in Section 6.2, the sort or format select-
  2364.     ion character may also be stated as +, -, or !.  Rather than selecting a
  2365.     specific setting, these respectively infer moving one setting up, down,
  2366.     or in the direction of the DIRECTION flag.
  2367.  
  2368.  
  2369. 10.3 Intrinsic CD command
  2370.  
  2371.     For an explanation of the ToolBOX "cd" command, see Section 6.3.
  2372.  
  2373.           [cd] [d:][path]
  2374.  
  2375.     It emulates the DOS equivalent except as follows:
  2376.  
  2377.           o the path may optionally include the drive specification.
  2378.           o the "cd" command itself is optional.
  2379.  
  2380.     On completion the directory data is read and the display updated,
  2381.     regardless of whether the cd command actually specified a new directory.
  2382.     ToolBOX beeps if the directory is not located.
  2383.  
  2384.  
  2385. 10.4 Intrinsic DEL Command
  2386.  
  2387.     The ToolBOX del command is essentially equivalent to the internal DOS
  2388.     command.  Section 9.4 describes the del command in detail.
  2389.  
  2390.           del [d:][path]matchlist
  2391.  
  2392.     ToolBOX will not delete subdirectories, although they are included in
  2393.     the count for the verification window.  ToolBOX will beep if a file
  2394. ToolBOX User Manual                                                  Page 43
  2395. ____________________________________________________________________________
  2396.  
  2397.  
  2398.     cannot be deleted or if nothing was deleted.
  2399.  
  2400.     Be careful with the file specification; ToolBOX assumes that for all
  2401.     specifications without an extension ".*" can be assumed.
  2402.  
  2403.  
  2404. 10.5 Intrinsic KILLDIR Command
  2405.  
  2406.     The killdir command is used to delete directory trees or branches, hence
  2407.     the occasional use of the term prune.
  2408.  
  2409.           killdir directory
  2410.  
  2411.     The command always prompts to determine how much should be deleted: all
  2412.     files and directories, all files, or just the files in the first
  2413.     directory.  For saftey reasons, KILLDIR won't let you delete the ".."
  2414.     parent directory.
  2415.  
  2416.     Using the intrinsic directly, rather than <ALT k>, it is possible to
  2417.     delete the complete contents of a disk with a single command;
  2418.  
  2419.           e.g.: killdir a:\
  2420.  
  2421.  
  2422. 10.6 Intrinsic SEL Command
  2423.  
  2424.     The sel command performs the file selection operation based on a
  2425.     matchlist.  Each match-string within the matchlist may contain the DOS *
  2426.     and ? wildcard characters.
  2427.  
  2428.           sel [ @ + - ] matchlist
  2429.  
  2430.     The optional character for the first argument is:
  2431.  
  2432.           @    toggle the select state of matched files based on the file
  2433.                at the file cursor.
  2434.  
  2435.           +    always set the matching files.
  2436.  
  2437.           -    always reset the matching files.
  2438.  
  2439.     Without the optional parameter, the matched files are toggled based on
  2440.     the state of the first matching file.  As per the explanation in 6.2,
  2441.     the matchlist can contain any number of file specifications, each
  2442.     optionally with a leading negation "!" character.
  2443.  
  2444.     The searches (which determine the order of selection) are carried out in
  2445.     directory display order from the beginning; i.e. no special consider-
  2446.     ation is given to the file at the cursor location.  All files
  2447.     corresponding to the match-string are altered to the same select state.
  2448.  
  2449. ToolBOX User Manual                                                  Page 44
  2450. ____________________________________________________________________________
  2451.  
  2452.  
  2453. APPENDIX A : ToolBOX COMMAND LINE ARGUMENT SUMMARY
  2454.  
  2455.  
  2456.  
  2457.  
  2458.      TBOX [d:][path]matchlist @cfgfile -F# -S#
  2459.           -V [b m s c e v] [25 43 50] -C[m c g]
  2460.           -X [Hh] [Dd] [Cc] [Xx] [Rr] [Pp] [Tt] [a#] [Mm]
  2461.           -M [Aa] [Pp] [Dd] [Cc]
  2462.  
  2463.  
  2464.  
  2465.   where :
  2466.  
  2467.  
  2468.  
  2469.           [d:][path]matchlist   for directory/files to be displayed
  2470.  
  2471.           -@cfgfile             configuration data file
  2472.  
  2473.           -display Format # (1 to 8, or letter)
  2474.  
  2475.           -Sort format # (1 to 8, or letter)
  2476.  
  2477.           -Video[bIOS|mONOCHROME|sNOW|cGA|eGA|vGA] [25LINES|43LINES|50LINES]
  2478.  
  2479.           -Color[mONOCHROME|cOLOR|gRAYSCALE]
  2480.  
  2481.           -eXecute
  2482.                hH   include Hidden and system files
  2483.                dD   do directory and exit
  2484.                cC   do directory and conditionally exit
  2485.                xX   go directly to select phase
  2486.                rR   restore DOS screen on exit
  2487.                pP   set pause state following DOS commands
  2488.                tT   tell DOS about available lines
  2489.                a#   permitted audio tones for different errors:
  2490.                     1 (border) + 2 (syntax) + 4 (execution)
  2491.                mM   make Match-list permanent
  2492.  
  2493.           -Memory
  2494.                Aa   always swap
  2495.                Pp   swap to EMS expanded memory
  2496.                Dd   swap to Disk
  2497.                Cc   for disk swaps, use current directory
  2498.  
  2499.  
  2500.  
  2501.  
  2502. ToolBOX User Manual                                                  Page 45
  2503. ____________________________________________________________________________
  2504.  
  2505.  
  2506.                NOTE :
  2507.  
  2508.                     o all fields are optional
  2509.  
  2510.                     o matchlist :
  2511.  
  2512.                          [!]file-match-string  . . .
  2513.  
  2514.                     o default
  2515.                          -v25 -XhdcXrTa7m -MaPDc *.* -F1 -S1
  2516.  
  2517. ToolBOX User Manual                                                  Page 46
  2518. ____________________________________________________________________________
  2519.  
  2520.  
  2521. APPENDIX B : DIRECTORY DISPLAY PARAMETERS
  2522.  
  2523.  
  2524.     DIRECTORY DISPLAY FORMATS (Factory Defaults)
  2525.     ────────────────────────────────────────────
  2526.  
  2527.  
  2528.           #    OPTION NAME         COLS EXAMPLE DISPLAY FORMAT
  2529.           ─    ──────────────────  ──── ────────────────────────────────────
  2530.           1    Master               2   hSAMPLE  .COM    1,234 14Jly93 13:00
  2531.           2    filename-Size        3    SAMPLE  .COM    1,234
  2532.           3    filename-Date        3   hSAMPLE  .COM Jly93 13:00
  2533.           4    Filename             5    SAMPLE  .COM
  2534.           5    Name                 7    SAMPLE
  2535.           6    mAster (B)           2      1,234 hSAMPLE  .COM 14Jly93 13:00
  2536.           7    siZe-filename        2      1,234  SAMPLE  .COM
  2537.           8    filename-sizE (B)    3    hSAMPLE  .COM   1,234
  2538.  
  2539.  
  2540.  
  2541.                NOTE:
  2542.                       - examples are for the hidden file SAMPLE.COM,
  2543.                         containing 1,234 bytes, and whose last modification
  2544.                         date was 1PM July 14, 1993.
  2545.  
  2546.                       - formats 1, 3, 6, and 8 prefix the filename with a
  2547.                         special designator character under the following
  2548.                         conditions:
  2549.  
  2550.                               CHAR      DESCRIPTION
  2551.  
  2552.                                 s       system file
  2553.                                 h       hidden file
  2554.                                 r       read only file
  2555.                                 \       directory
  2556.  
  2557.                         If more that one is applicable, only the first is
  2558.                         displayed.
  2559.  
  2560.                       - formats 4, 5, and 7 prefix the filename with a \
  2561.                         character to denote a directory
  2562.  
  2563.  
  2564.  
  2565. ToolBOX User Manual                                                  Page 47
  2566. ____________________________________________________________________________
  2567.  
  2568.  
  2569.      SORT CRITERIA
  2570.      ─────────────
  2571.  
  2572.           #    OPTION NAME              SORT CRITERIA (first, second)
  2573.           ─    ──────────────────       ──────────────────────────────
  2574.           1    eXtension-name           extension, filename
  2575.           2    Date-name                date, filename
  2576.           3    Size-name                size, filename
  2577.           4    dOs order                none -natural directory order
  2578.           5    Name-extension           filename, extension
  2579.           6    extension-daTe           extension, date
  2580.           7    extension-siZe           extension, size
  2581.           8    Reverse-date-name        inverted : date, filename
  2582.  
  2583.  
  2584.  
  2585.                NOTE : - the second sort field resolves ties remaining from
  2586.                         the first sort.
  2587.  
  2588. ToolBOX User Manual                                                  Page 48
  2589. ____________________________________________________________________________
  2590.  
  2591.  
  2592. APPENDIX C : COMMAND SUMMARY
  2593.  
  2594.  
  2595.  
  2596.        GENERAL INFORMATION:
  2597.  
  2598.           o the COMMAND KEYS section is completely reassignable through the
  2599.             TBOXCFG configuration program.
  2600.  
  2601.           o as a general convention <CTRL letter> keys are reserved for user
  2602.             customizations.  ToolBOX uses the function keys and <ALT letter>
  2603.             keys for its own operations.
  2604.  
  2605.           o the <F2> and <F7> keys are duplicated on the ' and / keys
  2606.             respectively for convenience.
  2607.  
  2608.           o refer to Section 4 and 10 for a description of variables and
  2609.             intrinsics.
  2610.  
  2611.  
  2612.  
  2613.     BASIC COMMAND KEYS
  2614.     ══════════════════
  2615.  
  2616.           CURSOR CONTROL
  2617.  
  2618.                <LEFT> <RIGHT> <UP> <DOWN> <PG UP> <PG DN> <Tab>
  2619.                <HOME> <HOME><HOME> <END> <END><END>
  2620.  
  2621.           Select file at cursor:
  2622.  
  2623.                <Space>
  2624.  
  2625.           Select region:
  2626.  
  2627.                <SHIFT LEFT> <SHIFT RIGHT> <SHIFT UP> <SHIFT DOWN>
  2628.  
  2629.           Cancel current operation:
  2630.  
  2631.                <ESC>
  2632.  
  2633.  
  2634.  
  2635. ToolBOX User Manual                                                  Page 49
  2636. ____________________________________________________________________________
  2637.  
  2638.  
  2639.     CONFIGURABLE COMMAND KEYS USED IN DIRECTORY/SELECT MODE
  2640.     ───────────────────────────────────────────────────────
  2641.  
  2642.                          MATCH
  2643.           KEYSTROKE      STRING    DESCRIPTION
  2644.           ═════════      ══════    ════════════════════════════════════════
  2645.  
  2646.           <any ASCII>    ---       Start keyboard command.
  2647.  
  2648.           <INSERT>       ---       Recall last keyboard command line.
  2649.  
  2650.           <ALT SPACE>    *.*       Toggle status of all files with the same
  2651.                                    extension as the file at the cursor.
  2652.  
  2653.           <CTRL SPACE>   *.*       Toggle selection status of all files.
  2654.  
  2655.           <keypad ─>     ---       Change directory to the next oldest stack
  2656.                                    entry.
  2657.  
  2658.           <keypad +>     ---       Change directory to the next most recent
  2659.                                    stack entry.
  2660.  
  2661.           <F1>           ---       Help (Single line descriptions).
  2662.  
  2663.           <ALT F1>       ---       Help (Incorporates command set
  2664.                                    information).
  2665.  
  2666.           <F2> or /      ---       Initiate pop up window for
  2667.                                    sort/display/quick commands/direction and
  2668.                                    pause.
  2669.  
  2670.           <CTRL PGDN>    ---       Change to next lower installed drive.
  2671.  
  2672.           <CTRL PGUP>    ---       Change to next higher installed drive.
  2673.  
  2674.           <ALT F2>       ---       Toggle PAUSE status.
  2675.  
  2676.           <CTRL F2>      ---       Toggle direction flag.
  2677.  
  2678.           <F7><x> or '<x>---       Execute quick command command x.
  2679.  
  2680.           <ALT F7><x>    ---       Assign the current directory to quick
  2681.                                    command x.
  2682.  
  2683.           <CTRL F7><x>   ---       Delete quick command x.
  2684.  
  2685.           <SHIFT F7><x>  ---       Make keyboard command quick command x.
  2686.  
  2687. ToolBOX User Manual                                                  Page 50
  2688. ____________________________________________________________________________
  2689.  
  2690.  
  2691.                          MATCH
  2692.           KEYSTROKE      STRING    DESCRIPTION
  2693.           ═════════      ══════    ════════════════════════════════════════
  2694.  
  2695.           <F8>           ---       Refresh directory display.
  2696.  
  2697.           <ALT F8>       ---       Move to display directory.
  2698.  
  2699.           <CTRL F8>      ---       Display current directory.
  2700.  
  2701.           <F9>           ---       Toggle DOS/ToolBOX screen split.
  2702.  
  2703.           <ALT F9>       ---       Select next sort criteria.
  2704.  
  2705.           <CTRL F9>      ---       Select next file display format.
  2706.  
  2707.           <F10>          ---       Toggle between ToolBOX and DOS window.
  2708.  
  2709.           <ALT F10>      ---       Toggle between DIRECTORY/SELECT modes.
  2710.  
  2711.           <ALT 2>        ---       Switch to 25 line mode.
  2712.  
  2713.           <ALT 4>        ---       Switch to 43 line mode.
  2714.  
  2715.           <ALT 5>        ---       Switch to 50 line mode.
  2716.  
  2717.           <ALT 0>        ---       Switch to current number of DOS lines.
  2718.  
  2719.           <ALT c>        *.*       Template for DOS COPY command.
  2720.  
  2721.           <ALT d>        *.*       Delete selected files.
  2722.  
  2723.           <ALT f>        ---       Template for DOS FORMAT command.
  2724.  
  2725.           <ALT k>        *.* (dir) Kill selected directories.
  2726.  
  2727.           <ALT p>        *.*       Print selected file.
  2728.  
  2729.           <ALT r>        *.*       Template for DOS RENAME command.
  2730.  
  2731.           <ALT s>        ---       Escape to DOS.
  2732.  
  2733.           <ALT v>        *.*       Display selected files with the VIEW
  2734.                                    program.
  2735.  
  2736. ToolBOX User Manual                                                  Page 51
  2737. ____________________________________________________________________________
  2738.  
  2739.  
  2740.                          MATCH
  2741.           KEYSTROKE      STRING    DESCRIPTION
  2742.           ═════════      ══════    ════════════════════════════════════════
  2743.  
  2744.  
  2745.           <RETURN>       *.* (dir) Change directory.
  2746.  
  2747.           <RETURN>       *.BAT     Execute batch file.
  2748.  
  2749.           <RETURN>       *.COM     Execute .COM file.
  2750.  
  2751.           <RETURN>       *.EXE     Execute .EXE file.
  2752.  
  2753.           <RETURN>       *.xxx     Execute TBX--xxx.BAT if accessible,
  2754.                                    otherwise use VIEW.
  2755.  
  2756.           <CTRL RETURN>  *.xxx     Execute TBXC-xxx.BAT if accessible,
  2757.                                    otherwise use VIEW.
  2758.  
  2759.           <ALT RETURN>   *.xxx     Execute TBXA-xxx.BAT if accessible,
  2760.                                    otherwise use VIEW.
  2761.  
  2762.           <ALT key-x>    ---       Execute TBX-ALTx.BAT if accessible.
  2763.  
  2764.           <CTRL key-x>   ---       Execute TBXA-CTLx.BAT if accessible.
  2765.  
  2766.           <RETURN>       *.*       Use VIEW to display the unknown file.
  2767.  
  2768.  
  2769.  
  2770.     ALTERNATE KEYS AVAILABLE (See GENERAL.DOC)
  2771.     ──────────────────────────────────────────
  2772.  
  2773.           STANDARD KEY   REPLACEMENT    NOTES
  2774.           ════════════   ════════════   ══════════════════════════════════
  2775.           <SHIFT LEFT>   <CTRL LEFT>
  2776.           <SHIFT RIGHT>  <CTRL RIGHT>
  2777.           <SHIFT UP>     <CTRL HOME>
  2778.           <SHIFT DOWN>   <CTRL END>
  2779.           <ALT SPACE>    <ALT = >       reserved by windows
  2780.           <ALT RETURN>   <ALT - >       reserved by windows
  2781.           <CTRL RETURN>  <ALT _ >
  2782.  
  2783.  
  2784.  
  2785. ToolBOX User Manual                                                  Page 52
  2786. ____________________________________________________________________________
  2787.  
  2788.  
  2789. APPENDIX D : INTRINSIC COMMAND SUMMARY
  2790.  
  2791.  
  2792.     COMMAND LINE VARIABLES
  2793.     ──────────────────────
  2794.  
  2795.  
  2796.           (where x is created by <CTRL x>)
  2797.  
  2798.           [ + - ! ]d    display drive
  2799.           p             display path
  2800.           n             8 character file name
  2801.           x             3 character extension
  2802.           D             current drive letter
  2803.           P             current path
  2804.           f             minimized pathname
  2805.           c             last character from keyboard
  2806.                        single literal  character
  2807.  
  2808.  
  2809.     INTRINSIC COMMANDS
  2810.     ──────────────────
  2811.  
  2812.           Change directory:
  2813.  
  2814.                [cd] [d:][path]
  2815.  
  2816.           Update directory display:
  2817.  
  2818.                dir [d:][path][matchlist]  [/m] [/hH]
  2819.                              [/s[ + - ! ]#] [/f[ + - ! ]#]
  2820.  
  2821.           Delete selected files:
  2822.  
  2823.                del [d:][path]matchlist
  2824.  
  2825.           Delete selected directories and contents:
  2826.  
  2827.                killdir [d:]path
  2828.  
  2829.           Select files:
  2830.  
  2831.                sel [ @ + - ] matchlist
  2832.  
  2833.           Swap out ToolBOX
  2834.  
  2835.                @command-line
  2836.  
  2837. ToolBOX User Manual                                                  Page 53
  2838. ____________________________________________________________________________
  2839.  
  2840.  
  2841.  
  2842.     INTRINSIC COMMANDS (INTERNAL)
  2843.     ─────────────────────────────
  2844.  
  2845.     The following commands are intended for use within configured command
  2846.     sets rather than through the keyboard command line.  They are included
  2847.     here for reference purposes only.  For further information refer to the
  2848.     TBOXCFG User Manual documentation.
  2849.  
  2850.  
  2851.           Switch to the DOS window:
  2852.  
  2853.                tbx d
  2854.  
  2855.           Initiate Help  (1=basic help, 2 = extended/internal command set):
  2856.  
  2857.                tbx h #
  2858.  
  2859.           Toggle current PAUSE status:
  2860.  
  2861.                tbx p
  2862.  
  2863.           Set number of screen lines (25, 43, or 50, otherwise DOS setting):
  2864.  
  2865.                tbx r ##
  2866.  
  2867.           Toggle current DIRECTION status:
  2868.  
  2869.                tbx t
  2870.  
  2871.           Toggle between ToolBOX SELECT and DIRECTORY state:
  2872.  
  2873.                tbx w
  2874.  
  2875.           Change directories to the next entry in the directory stack:
  2876.  
  2877.                tbx N
  2878.  
  2879.           Change directories to the previous entry in the directory stack:
  2880.  
  2881.                tbx P
  2882.  
  2883.           Conditional exit (Use verification window):
  2884.  
  2885.                tbx x
  2886.  
  2887.           UnConditional exit:
  2888.  
  2889.                tbx X
  2890.  
  2891. ToolBOX User Manual                                                  Page 54
  2892. ____________________________________________________________________________
  2893.  
  2894.  
  2895.           Invoke program if locatable, else use default command line:
  2896.  
  2897.                t*x f progname.ext [param1] [param2] . . .
  2898.  
  2899.           Start the keyboard command with newest command stack entry:
  2900.  
  2901.                t*x l
  2902.  
  2903.           Start keyboard command with text provided:
  2904.  
  2905.                t*x p [command-line-text]
  2906.  
  2907.           Equivalent to t*x p except execution cycle is limited to one
  2908.           operation:
  2909.  
  2910.                t*x P [command-line-text]
  2911.  
  2912.           Toggle DOS split screen:
  2913.  
  2914.                t*x s
  2915.  
  2916.           Initiate the popup menu window:
  2917.  
  2918.                t*x w
  2919.  
  2920.           Invoke program if locatable, else sound(error):
  2921.  
  2922.                t*x x progname.ext [param1] [param2] . . .
  2923.  
  2924.           Assign current directory to quick command, get x from keyboard:
  2925.  
  2926.                t*x C
  2927.  
  2928.           Delete quick command, get x from keyboard:
  2929.  
  2930.                t*x D
  2931.  
  2932.           Add the current keyboard command line as quick command, get x from
  2933.           keyboard:
  2934.  
  2935.                t*x K
  2936.  
  2937.           Execute quick command, get x from keyboard:
  2938.  
  2939.                t*x X
  2940.  
  2941.  
  2942.