home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / World_Of_Computer_Software-02-385-Vol-1of3.iso / t / tbox13.zip / TBOX13.ZIP / GENERAL.DOC < prev    next >
Text File  |  1992-07-02  |  73KB  |  1,606 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.                               BINARY TOOLSHED
  12.  
  13.  
  14.  
  15.                           GENERAL PRODUCT OVERVIEW
  16.  
  17.  
  18.  
  19.                                    MANUAL
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.                             *
  31.                           *   *
  32.                         *       *
  33.                       *           *               The
  34.                     *               *
  35.                   *                   *           Binary
  36.                  *                     *
  37.                  *                     *          Toolshed
  38.                  *                     *
  39.                  *                     *
  40.                  *  ******             *
  41.                  *        *            *
  42.                  *        *            *          Version 1.2
  43.                  *        *            *          July 2, 1992
  44.                  *        *            *
  45.                  *        *            *
  46.                   ********             *
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.                               TABLE OF CONTENTS
  56.  
  57.  
  58.     1.0 Products From The Binary Toolshed ................................1
  59.  
  60.     2.0 Packing List......................................................3
  61.  
  62.     3.0 Installation and Setup............................................5
  63.     3.1 System Requirements...............................................5
  64.     3.2 Installation and Setup............................................5
  65.     3.3 Printing Manuals..................................................7
  66.  
  67.     4.0 Recommended Start Procedure.......................................8
  68.  
  69.     5.0 Program Conventions...............................................9
  70.     5.1 Overall Conventions...............................................9
  71.     5.2 Full Screen Program Conventions..................................12
  72.     5.3 Command Line Program Conventions.................................14
  73.  
  74.     6.0 Sample Programs Provided.........................................16
  75.     6.1 ToolBOX Inferred Batch Files.....................................16
  76.     6.2.Sample Configuration Files.......................................19
  77.     6.3 DOS Batch Files..................................................20
  78.     6.4 MS Windows Data Files............................................22
  79.  
  80.  
  81.     APPENDIX A : Questions & Answers.....................................23
  82.  
  83.     APPENDIX B : Glossary................................................26
  84.  
  85. General BTS Product Information                                       Page 1
  86. ____________________________________________________________________________
  87.  
  88.  
  89.  
  90. 1.0 Products From The Binary Toolshed
  91.  
  92.     The Binary Toolshed products include a number of programs for helping
  93.     users work with DOS.  Programs that are equally applicable to the novice
  94.     as to the power user.  They not only make using traditional DOS features
  95.     easier, but provide features and facilities that are not available
  96.     through DOS.
  97.  
  98.     This manual provides an overview of the aspects that are common to all
  99.     of the programs.  Discussions cover the suggested order for reading the
  100.     associated documentation and generally becoming familiar with the
  101.     material provided.  Installation and setup procedures are described, as
  102.     are conventions and features that are used throughout the products.  The
  103.     Appendices also provide answers to common operational questions, as well
  104.     as a glossary.
  105.  
  106.     This manual covers both the shareware and registered versions of the
  107.     product.  Where differences exist, they are specifically identified.  In
  108.     the other manuals, this distinction is neither needed, nor provided.
  109.     The registered product contains additional utilities that are not
  110.     available with the shareware version, however those programs that are
  111.     common to both products are functionally identical.  The only
  112.     differences being the cosmetic alterations required to identify one as
  113.     the unregistered shareware version and the other as the registered
  114.     version - feature wise the products are identical.
  115.  
  116.     The programs common to both the shareware and registered products are:
  117.  
  118.           TBOX      The ToolBOX.  The major program provided with the
  119.                     product.  ToolBOX provides numerous features: file
  120.                     directory displays, point and shoot operations, single
  121.                     key activation of sets of commands, pass through DOS
  122.                     command line operation, reuse of command line text,
  123.                     quick access to recently entered directories,
  124.                     simultaneous directory and DOS window views, and much
  125.                     more.  This shell program provides a platform for
  126.                     initiating other program operations, whether from the
  127.                     Binary Toolshed or other independent parties.
  128.  
  129.           TBOXCFG   ToolBOX Configuration program.  Configuration capability
  130.                     for the ToolBOX program including colors, directory
  131.                     display or sort formats, key bindings, title banner, and
  132.                     more.  Configuration files are usable by the VIEW and
  133.                     TREE utilities as well as TBOX.
  134.  
  135.           BTSPATCH  Provides the capability to set the default command line
  136.                     arguments for all Binary Toolshed programs.
  137.  
  138.           TOASCII   Converts text files that use the extended IBM PC
  139.                     character set to use the standard 95 printable ASCII
  140.                     characters.
  141.  
  142. General BTS Product Information                                       Page 2
  143. ____________________________________________________________________________
  144.  
  145.  
  146.           TREE      Graphically displays the directory structure.  The user
  147.                     can cursor through this structure to change directories
  148.                     or examine files.
  149.  
  150.           VIEW      Displays the contents of text files for viewing or
  151.                     browsing.
  152.  
  153.     The following utility programs are provided with the registered product
  154.     only:
  155.  
  156.           DIRS      Displays disk space utilization for directory branches.
  157.                     It produces the cumulative totals for a directory and
  158.                     all of its descendants.
  159.  
  160.           DRIVES    Displays disk drive parameters for all assigned drives.
  161.                     The presentation includes drive types, volume names,
  162.                     capacities, and free space available.
  163.  
  164.           MAKEBAT   Creates batch files based on a template data file and a
  165.                     file match specification for applicable files.
  166.  
  167.           ONPATH    Determines if specified files are accessible through the
  168.                     DOS PATH variable.
  169.  
  170.           WI        A 'WhereIs' program.  Finds specified files wherever
  171.                     they are located on the disk drive(s), and optionally
  172.                     carries out an operation on those files.
  173.  
  174.     The documentation for all the above programs, is included with the
  175.     shareware product.  All of the programs are independent and can be used
  176.     without the others if desired.
  177.  
  178.  
  179. General BTS Product Information                                       Page 3
  180. ____________________________________________________________________________
  181.  
  182.  
  183. 2.0 Packing List
  184.  
  185.     Files common to the shareware and the registered products:
  186.  
  187.        PROGRAMS
  188.  
  189.           TBOX    .EXE   The ToolBOX program
  190.           TBOXCFG .EXE   ToolBOX configurations program
  191.           BTSPATCH.EXE   Patch program for Binary Toolshed programs
  192.           TOASCII .EXE   Filter to convert extended PC characters to ASCII
  193.           TREE    .EXE   Point and shoot directory traversal utility
  194.           VIEW    .EXE   Text file browser
  195.  
  196.  
  197.        DOCUMENTATION
  198.  
  199.           STRTHERE.DOC   Quick introduction to program capabilities
  200.           STRTHERE.BAT   Invokes VIEW to present contents of STRTHERE.DOC.
  201.           CHANGES .DOC   Description of program changes for each version.
  202.           GENERAL .DOC   Discussion of common program aspects (this manual)
  203.           ORDRINFO.DOC   Product distribution and support issues
  204.           ORDER   .FRM   Template for placing orders
  205.           TBOX    .DOC   User Manual for the TBOX program
  206.           TBOXCFG .DOC   User Manual for the TBOXCFG program
  207.           UTILS   .DOC   User Manual for BTSPATCH, DIRS, DRIVES, MAKEBAT,
  208.                          ONPATH, TOASCII, TREE, VIEW, and WI programs
  209.  
  210.  
  211.        SAMPLE FILES (Contained in the self extracting SAMPLE.EXE file)
  212.  
  213.  
  214.           SAMPLE-A.CFG   Sample configuration file
  215.           SAMPLE-B.CFG   Sample configuration file
  216.  
  217.  
  218.           TBX--xxx.BAT   Sample deferred batch files for point and shoot
  219.                          operations ( <RETURN> ) on files with an xxx
  220.                          extension, where xxx is any of:
  221.  
  222.                               ARC  ARJ  BAS  CMF  FLI  GIF  GL   LZH
  223.                               PAK  PCX  SDN  VOC  WFW  WK1  WP   ZIP
  224.                               ZOO
  225.  
  226.           TBXA-xxx.BAT   Sample deferred batch files for point and shoot
  227.                          operations ( <ALT-RETURN> ) on files with an xxx
  228.                          extension, where xxx is any of:
  229.  
  230.                               ARC  ARJ  LZH  PAK  SDN  ZIP  ZOO
  231.  
  232. General BTS Product Information                                       Page 4
  233. ____________________________________________________________________________
  234.  
  235.  
  236.           TBXC-xxx.BAT   Sample deferred batch files for point and shoot
  237.                          operations ( <CTRL-RETURN> ) on files with an xxx
  238.                          extension, where xxx is any of:
  239.  
  240.                               ARC  ARJ  LZH  PAK  SDN  ZIP  ZOO
  241.  
  242.  
  243.           TIR     .BAT   Configures TBOX as a replacement for DOS DIR
  244.           D1      .BAT   Sample to limit DIRS display to first level
  245.           CLEAN   .BAT   Demonstrates use of WI to delete temporary files
  246.           WI-COPY .BAT   Demonstrates use of WI to copy files
  247.           WI-RUN  .BAT   Demonstrates use of WI to execute files
  248.           WI-VIEW .BAT   Demonstrates use of WI to view files
  249.           ZRUN.BAT.BAT   Simulate TBOX's unzip operation from DOS
  250.  
  251.           BTS     .GRP   MS Windows Group file BTS utilities
  252.           BTS     .ICO   MS Windows 3.0 Icon - Binary Toolshed logo
  253.           TREE    .ICO   MS Windows 3.0 Icon - Simulated TREE display
  254.           VIEW    .ICO   MS Windows 3.0 Icon - Simulated VIEW display
  255.           TBOX    .ICO   MS Windows 3.0 Icon - Simulated ToolBOX display
  256.           TREE    .PIF   MS Windows 3.0 Program Information File - TREE
  257.           VIEW    .PIF   MS Windows 3.0 Program Information File - VIEW
  258.           TBOX    .PIF   MS Windows 3.0 Program Information File - ToolBOX
  259.           BTS     .PIF   MS Windows 3.0 PIF - BTS Startup documentation
  260.           TREE-F  .PIF   MS Windows 3.0 PIF - TREE (Full screen)
  261.           VIEW-F  .PIF   MS Windows 3.0 PIF - VIEW (Full screen)
  262.           TBOX-F  .PIF   MS Windows 3.0 PIF - ToolBOX (Full screen)
  263.  
  264.  
  265.     The following files exist only with the registered product:
  266.  
  267.        PROGRAMS
  268.  
  269.           DIRS    .EXE   Directory branch space allocation display utility
  270.           DRIVES  .EXE   Drive space allocation display utility
  271.           MAKEBAT .EXE   Creates batch files from a template
  272.           ONPATH  .EXE   Determines if files(s) are accessible on the PATH
  273.           WI      .EXE   Finds file(s) anywhere on one or more drives
  274.  
  275.  
  276.  
  277. General BTS Product Information                                       Page 5
  278. ____________________________________________________________________________
  279.  
  280.  
  281. 3.0 Installation and Setup
  282.  
  283. 3.1 System Requirements
  284.  
  285.  
  286.     The BTS program family requires:
  287.  
  288.           DOS    :  3.0 or higher.  Tested with DOS 3.0 through 5.0,
  289.                     DR DOS 5.0, and 4DOS.
  290.  
  291.           Memory :  All programs will function within 100KB of free memory.
  292.                     Programs such as TBOX, TBOXCFG, and VIEW can, and will
  293.                     take advantage of additional available memory.
  294.  
  295.           VIDEO  :  MDA, CGA, EGA, or VGA.
  296.  
  297.           DISK   :  no specific requirements.
  298.  
  299.  
  300.  
  301. 3.2 Installation and Setup
  302.  
  303.     Installation for the Binary Toolshed programs is essentially
  304.     accomplished by moving the program and data files to the directories
  305.     where they can be accessed.  Place the:
  306.  
  307.           o executables and batch files (*.EXE, *.BAT) in a directory
  308.             referenced by the PATH variable.
  309.  
  310.           o configuration files (*.CFG) in any directory that can be
  311.             referenced later.
  312.  
  313.           o icon (*.ICO) and pif (*.pif) files in a directory where they can
  314.             be referenced by the MS Windows program.
  315.  
  316.           o documentation files (*.DOC and *.FRM) where they can be
  317.             referenced later.
  318.  
  319.     The following example demonstrates an installation for the self
  320.     extracting version of the registered program.  The compressed program is
  321.     initially contained in the a:\BTS12.EXE file.  The following example
  322.     demonstrates a possible installation procedure:
  323.  
  324.                c:
  325.                md \bts
  326.                cd \bts
  327.                a:\bts12
  328.                samples.exe
  329.                del  samples.exe
  330.                rename strthere.bat strthere.tmp
  331.                copy *.bat   c:\bin
  332.                copy *.exe   c:\bin
  333.                del *.bat
  334.                del *.exe
  335.                rename strthere.tmp strthere.bat
  336. General BTS Product Information                                       Page 6
  337. ____________________________________________________________________________
  338.  
  339.  
  340.  
  341.  
  342.     The example:
  343.  
  344.           o creates an empty directory (BTS) on drive C: and moves into it.
  345.             This directory will ultimately just contain reference data; the
  346.             programs will be copied elsewhere.
  347.  
  348.           o the distribution files are placed in this directory by
  349.             decompressing the single distribution file.
  350.  
  351.           o except for the SAMPLE.EXE file, all of the decompressed files
  352.             are usable immediately.  The SAMPLES.EXE file is a self-
  353.             extracting file containing the individual sample files.  If you
  354.             want these files, execute the SAMPLE.EXE program.
  355.  
  356.           o copies all of the executables to a directory on the PATH (C:\BIN
  357.             assumed).  SAMPLE.EXE is pre-deleted as it has already served
  358.             its usefulness.
  359.  
  360.           o the *.BAT and *.EXE files are deleted as a general policy for
  361.             eliminating duplicate files.  This will not only reduce space
  362.             requirements, but will ensure there are no problems later with
  363.             identifying which programs have been updated or reconfigured.
  364.             STRTHERE.BAT is temporarily renamed to prevent it from being
  365.             copied and deleted with the other .BAT files.
  366.  
  367.     The installation is essentially complete.  This leaves the *.CFG, *.DOC,
  368.     *.ICN, and *.PIF files in the C:\BTS directory.  These are all reference
  369.     files that need not be on the PATH.  Refer to Section 6 for examples on
  370.     how to utilize these files.
  371.  
  372.     The product version and distribution method may alter this process
  373.     slightly.  For the shareware version of the product, the self extracting
  374.     file referenced in the fourth line is TBOX12.EXE.  If you received the
  375.     shareware version from a bulletin board, the single distribution file is
  376.     likely compressed.  Use the appropriate decompression program in line
  377.     four.
  378.  
  379.     Ensure that COMMAND.COM exists in a directory on the path (you can use
  380.     the ONPATH utility to test).  It is not sufficient that the COMSPEC
  381.     environment variable simply be directed to it.
  382.  
  383.     No changes are required to the AUTOEXEC.BAT or CONFIG.SYS files, however
  384.     there are advantages with DOS 3 to using the ANSI.SYS driver.  These
  385.     advantages are discussed in the ToolBOX User Manual.  Refer to your DOS
  386.     User Manual for instructions on adding this driver to your CONFIG.SYS
  387.     file.
  388.  
  389.     The ToolBOX program can use the TEMP environment variable to identify a
  390.     disk swap directory.  Use the DOS SET command if this is applicable.
  391.  
  392.     If desired, use the BTSPATCH and TBOXCFG programs to change the startup
  393.     settings for the other programs.
  394.  
  395. General BTS Product Information                                       Page 7
  396. ____________________________________________________________________________
  397.  
  398.  
  399.     The TREE program is the only utility that may need help during
  400.     installation.  As explained in the UTILITIES User Manual, if the data
  401.     file created on the initial startup exists on a RAMDISK or in a
  402.     directory that is not normally on the PATH, then move it to a permanent
  403.     directory that is always on the PATH.  Also, be aware that the TREE
  404.     command name conflicts with DOS TREE command.  To prevent the conflict
  405.     either ensure that the directory with the Binary Toolshed TREE program
  406.     precedes the DOS directory on the PATH, or simply rename the DOS program
  407.     (for example to TREE-DOS.COM).  Note that if both the BTS TREE.EXE and
  408.     the DOS TREE.COM exist in the same directory, DOS will give precedence
  409.     to the .COM version.
  410.  
  411.  
  412.  
  413. 3.3 Printing Manuals
  414.  
  415.     All of the manuals provided are formatted for 60 lines per page, form
  416.     feeds, and contain characters from the IBM PC extended character set.
  417.     This is compatible with most laser printers and dot matrix printers.  To
  418.     print the ToolBOX user manual, use the DOS commands:
  419.  
  420.                COPY TBOX.DOC PRN
  421.  
  422.                     or
  423.  
  424.                PRINT TBOX.DOC
  425.  
  426.     If your printer does not support the extended characters, use the
  427.     TOASCII utility to convert the extended characters to standard ASCII
  428.     equivalents.  Refer to the Utilities User Manual for specifics.  For
  429.     example, to print the ToolBOX manual directly:
  430.  
  431.                TOASCII <TBOX.DOC >PRN
  432.  
  433.                     or to create an intermediate temporary file first
  434.  
  435.                TOASCII <TBOX.DOC >TBOXTEMP.DOC
  436.                COPY TBOXTEMP.DOC PRN
  437.  
  438.  
  439. General BTS Product Information                                       Page 8
  440. ____________________________________________________________________________
  441.  
  442.  
  443. 4.0 Recommended Start Procedure
  444.  
  445.     This manual provides an overview of aspects that are common to all of
  446.     the programs within the product.  The programs themselves, however, are
  447.     independent.  Each has its own procedures and purpose.  Each can
  448.     function without the others.  It is therefore possible to start with any
  449.     of the programs.
  450.  
  451.     The following brief steps provide a logical order for examining each
  452.     program.  Note that the command line arguments and configuration
  453.     capability available for most of the programs are optional.  The factory
  454.     defaults are adequate and suitable for most situations.
  455.  
  456.           a) start with the STRTHERE.DOC file to obtain a general
  457.              appreciation for the capabilities of each program.
  458.  
  459.           b) read the balance of this manual to understand general concepts
  460.              and procedures: how to select from menus, get Help, escape from
  461.              operations, and so on.
  462.  
  463.           c) briefly try the following programs in order - TBOX, VIEW, DIRS,
  464.              DRIVES, ONPATH, TREE, VIEW, and WI.  The basic function of
  465.              these programs is straight forward and fairly obvious without
  466.              reading the documentation.
  467.  
  468.           d) read the Utilities User Manual.  This will provide a deeper
  469.              understanding of the utility programs already examined, as well
  470.              as describe the purpose of the BTSPATCH, MAKEBAT, and TOASCII
  471.              programs.
  472.  
  473.           e) read the ToolBOX User Manual.  While ToolBOX is initially
  474.              simple to use, there are an abundance of features available
  475.              that are only apparent through reading the documentation.  Use
  476.              this information in conjunction with the sample files described
  477.              in Section 6.0 to externally configure ToolBOX's point and
  478.              shoot facility to incorporate applications that are specific to
  479.              your environment.
  480.  
  481.           f) read the TBOXCFG program.  Many users will never use the
  482.              TBOXCFG program - the default settings are adequate.  However,
  483.              until you have read the TBOXCFG manual, you will not know the
  484.              degree to which the ToolBOX program can be reconfigured, and
  485.              the potential advantages in doing so.
  486.  
  487.  
  488.  
  489. General BTS Product Information                                       Page 9
  490. ____________________________________________________________________________
  491.  
  492.  
  493. 5.0 Program Conventions
  494.  
  495. 5.1 Overall Conventions
  496.  
  497.     The programs and utilities can be categorized into two major classes:
  498.  
  499.           Full screen:        TBOX, TBOXCFG, TREE, VIEW
  500.  
  501.  
  502.           Command line:       BTSPATCH, DIRS, DRIVES, MAKEBAT, ONPATH,
  503.                               TOASCII, and WI.
  504.  
  505.     As one would expect, the full screen programs present displays and menus
  506.     through which the operator interacts to carry out a desired action or
  507.     series of activities.  The command line programs, however, receive all
  508.     of their instructions through the initial command line arguments and
  509.     proceed to completion based on this information.
  510.  
  511.     This section describes the conventions that are common to both types of
  512.     programs.  Those that apply specifically to the full screen or command
  513.     line programs are described in Sections 5.2 and 5.3 respectively.
  514.  
  515.  
  516.     COMMON CONVENTIONS
  517.     ──────────────────
  518.  
  519.  
  520.     documentation conventions
  521.  
  522.           [ | | | ]      square brackets enclose optional items, of which
  523.                          one or none may be selected.
  524.  
  525.           <KEY STROKE>   all keys to be struck simultaneously are enclosed
  526.                          in angle brackets.  For example
  527.  
  528.                               <ALT d>, <PG-DN> and <CTRL c>.
  529.  
  530.  
  531.     command line arguments
  532.  
  533.           All programs accept command line arguments.  Unless stated
  534.           otherwise the rules are:
  535.  
  536.             o  for the prefix character, either / or - may be used.
  537.                Usually, as long as it doesn't lead to an ambiguity, the
  538.                delimiting space between arguments and the leading prefix on
  539.                the following argument can be eliminated.
  540.  
  541.             o  order is not important except that if conflicting arguments
  542.                are entered, priority is given to the last one entered.
  543.                Where applicable, arguments from command lines within
  544.                configuration files are assumed to occur at the spot the
  545.                configuration file is referenced.
  546.  
  547. General BTS Product Information                                      Page 10
  548. ____________________________________________________________________________
  549.  
  550.  
  551.             o  case is not important unless specified otherwise, see [Xx]
  552.                below.
  553.  
  554.  
  555.     [Xx] command line arguments for turning features On/Off
  556.  
  557.           Many features are enabled or disabled by specifying an option in
  558.           upper or lower case respectively.  For example a number of
  559.           utilities use:
  560.  
  561.                -P   to request a pause at the end of each screen of
  562.                     information as it is presented.
  563.  
  564.                -p   to disable pausing.
  565.  
  566.           This technique enables the setting of the defaults to either state
  567.           through the BTSPATCH program.
  568.  
  569.           The settings have typically been selected so that the default is
  570.           uppercase.  That is, unless the defaults have been overridden,
  571.           only the lowercase option need be entered on the command line.
  572.  
  573.  
  574.     matchlist specification
  575.  
  576.           Virtually all programs accept a file match specification for
  577.           selecting files for some purpose.  In addition to the normal DOS
  578.           file specification which employs wildcard characters (? to match
  579.           any single character, and * to match 1 or more characters), BTS
  580.           programs utilize an enhanced variation - matchlist specifications.
  581.           These allow for multiple file inclusion and exclusion
  582.           specifications within a directory.
  583.  
  584.           The matchlist specification is of the form:
  585.  
  586.                [d:][path][!]fileSpec [filespec]...
  587.  
  588.           As for a normal DOS file specification, the matchlist can accept
  589.           an optional drive and path definition, and a file specification
  590.           (which may contain embedded wildcards).  The incremental features
  591.           are:
  592.  
  593.                1) multiple file specifications can be provided.
  594.  
  595.                2) each file-specification can be preceded by an !
  596.                   character.
  597.  
  598.           The ! identifies that files matching this specification should be
  599.           excluded from files selected by previous file-specifications.  If
  600.           the ! occurs on the first specification, a leading *.*
  601.           specification is assumed.  This results in the selection of all
  602.           files except those identified in the exclusion list.  All file
  603.           specifications pertain to the directory referenced by the initial
  604.           path.
  605.  
  606. General BTS Product Information                                      Page 11
  607. ____________________________________________________________________________
  608.  
  609.  
  610.           For example, to identify all the files in the DOS directory except
  611.           the executables:
  612.  
  613.                c:\dos\!*.com !*.exe !*.bat
  614.  
  615.           Always refer to the specific documentation for each program to
  616.           determine whether matchlist or file specifications are applicable.
  617.           The context will determine whether the specification pertains only
  618.           to files, or to files and directories.
  619.  
  620.  
  621.     patchable by the BTSPATCH program
  622.  
  623.           The startup settings for the command line arguments for all
  624.           utilities can be permanently altered by the BTSPATCH program.  The
  625.           defaults described throughout this manual assume the unpatched
  626.           factory default state.
  627.  
  628.  
  629.     filename extension defaults
  630.  
  631.           Where the matchlist specification is being used to simply select
  632.           files for presentation purposes, the unstated file extensions are
  633.           assumed to be equivalent to a .* extension.  If no extension is
  634.           desired, end the specification with a ".".
  635.  
  636.           The TBOXCFG program provides the only occurrence where a specific
  637.           extension (CFG) is assumed for unstated extensions.  Simply
  638.           terminate the filename with a "." if no extension is desired.
  639.  
  640.  
  641.     TBOX program usage
  642.  
  643.           To optimize processing, the factory default TBOX settings have
  644.           override commands established for each of the Binary Toolshed
  645.           utilities and most of the DOS commands which issue output.
  646.           Typically this is to force a PAUSE on completion of command line
  647.           utilities to retain the output data, and to establish the proper
  648.           screen controls for the full screen utilities.
  649.  
  650.  
  651.     program errorlevel return values
  652.  
  653.           All the Binary Toolshed programs return common program errorlevel
  654.           values:
  655.  
  656.                  0  no file or directory changes, or matches
  657.                  1  match found
  658.                  2  unknown changes (typically DOS command executed)
  659.                  3  change of directories
  660.                  4  file changes
  661.                255  error condition.  Problem not specified.
  662.  
  663.           These values can be used within the TBOXCFG flag settings for
  664.           keybindings and command overrides.  They can also be used within
  665. General BTS Product Information                                      Page 12
  666. ____________________________________________________________________________
  667.  
  668.  
  669.           DOS batch files.  For example, the following batch file segment
  670.           checks for at least 1 match (greater than or equal to 1) from a WI
  671.           command:
  672.  
  673.                wi search.dat
  674.                if errorlevel 1 GOTO GOTMATCH
  675.  
  676.                ...
  677.  
  678.                :GOTMATCH
  679.  
  680.  
  681.  
  682. 5.2 Full Screen Program Conventions
  683.  
  684.     FULL SCREEN PROGRAMS (TREE, VIEW, TBOX, TBOXCFG)
  685.     ──────────────────────────────────────────────
  686.  
  687.     error reporting
  688.  
  689.           For normal error conditions, the programs issue audible tones.
  690.           The four tones used are described in detail below.
  691.  
  692.           For extremely serious violations (typically: Out of Memory) popup
  693.           menus are generated which describe the problem and the available
  694.           options.  For many of these the only option is to terminate the
  695.           program.  For others such as "diskette drive not ready", simply
  696.           use the retry option when the condition has been corrected.  For
  697.           memory violations where the user is allowed to proceed, it is
  698.           still advisable to get out as quickly as possible as subsequent
  699.           functions may encounter further and more severe difficulties.
  700.  
  701.  
  702.     audible sounds
  703.  
  704.           Four different audible tones are used to reflect various error
  705.           conditions:
  706.  
  707.           click     signals attempts to cursor past the extremes
  708.                     of the window boundaries.
  709.  
  710.           chirp     issued when program is unable to understand a
  711.                     keyboard request.  Usually an unexpected
  712.                     character was entered.
  713.  
  714.           tribble   indicates a requested operation could not be
  715.                     carried out.  For example, a request to move
  716.                     to a drive that does not exist, insufficient
  717.                     memory to run program, etc.
  718.  
  719.           warble    for serious problems that shouldn't have been
  720.                     feasible to fail or for which continued
  721.                     operation is questionable: a TSR program was run
  722.                     after ToolBOX, internal errors, etc.
  723.  
  724. General BTS Product Information                                      Page 13
  725. ____________________________________________________________________________
  726.  
  727.  
  728.           These programs all have a -xa# command line argument through which
  729.           any of the first three tones can be selectively disabled.
  730.  
  731.           The tree program has one additional tone:
  732.  
  733.           sproing   occurs when the program detects that the
  734.                     actual directory structure differs from the
  735.                     recorded data file.  An update is automatic-
  736.                     ally performed.
  737.  
  738.  
  739.     standard cursor control and Help facility
  740.  
  741.           All programs use the traditional keys for entering text, or moving
  742.           through menus and windows:, or other operations which are common
  743.           across programs:
  744.  
  745.                <UP>, <DOWN>, <LEFT>, <RIGHT>, <PGUP>, <PGDN>, <END>,
  746.                <END><END>, <HOME>, <HOME><HOME>  - for cursoring through
  747.                          windows, menus and text.  Note <END> moves to the
  748.                          last entry in the current window, while <END><END>
  749.                          moves to the last physical entry.
  750.  
  751.                <DEL>, <BACKSPACE>, <INS> - during entry of textual data,
  752.                          deletes the current character, the previous
  753.                          character, or toggles the insert/overstrike mode
  754.                          respectively.
  755.  
  756.                <RETURN>  initiates an action on the selected entry, whether
  757.                          to select a menu option, change directories, etc.
  758.  
  759.                <ESC>     cancels the current operation and returns to the
  760.                          previous state.
  761.  
  762.                <F1>      produces a help screen.
  763.  
  764.           <CTRL c> and <CTRL BREAK> have no effect in these programs.
  765.  
  766.           Where possible, common functions across programs use the same
  767.           keyboard codes.  The general convention for most single key
  768.           operations is to use ALT-letter keys, while CTRL-letter keys are
  769.           reserved for customization by the user.
  770.  
  771.  
  772.     alternate keys
  773.  
  774.           For user convenience, the Binary Toolshed programs use several
  775.           keys that may not work under some circumstances - in particular
  776.           for some lap tops, alternate BIOSs, or when working under MS
  777.           Windows.  Alternate keys are always available for the standard
  778.           assignments as follows:
  779.  
  780. General BTS Product Information                                      Page 14
  781. ____________________________________________________________________________
  782.  
  783.  
  784.           STANDARD KEY   REPLACEMENT    PROGRAM        NOTES
  785.           ════════════   ════════════   ════════════   ═══════════════════
  786.           <SHIFT LEFT>   <CTRL LEFT>    TBOX, TREE
  787.           <SHIFT RIGHT>  <CTRL RIGHT>   TBOX, TREE
  788.           <SHIFT UP>     <CTRL HOME>    TBOX, TREE
  789.           <SHIFT DOWN>   <CTRL END>     TBOX, TREE
  790.           <Mid Pad/5>    <F5>           TREE
  791.           <ALT SPACE>    <ALT = >       TBOX           reserved by windows
  792.           <ALT RETURN>   <ALT - >       TBOX           reserved by windows
  793.           <CTRL RETURN>  <ALT _ >       TBOX
  794.  
  795.  
  796.     video parameters
  797.  
  798.           All full screen programs are capable of operating with all
  799.           varieties of video cards; adaptable for CGA, EGA, or VGA, for 25,
  800.           43, or 50 line modes, or with color, grayscale, or monochrome
  801.           color tables.  Each program has two command line arguments to set
  802.           these attributes; -V to set the video format, and -C to choose the
  803.           color table.  Refer to the VIEW program documentation.
  804.  
  805.  
  806.     configuration files
  807.  
  808.           The full screen programs (except TBOXCFG) can accept a config-
  809.           uration file as created through the TBOXCFG program.  The major
  810.           component for the utility programs being the customized color
  811.           tables, although the default-command-line-arguments and the banner
  812.           data are also used.  Data that is not applicable is simply
  813.           ignored.  The configuration file is specified as @cfgfile.cfg.
  814.           The extension and directory path must be explicitly stated if
  815.           applicable.
  816.  
  817.  
  818.  
  819. 5.3 Command Line Program Conventions
  820.  
  821.     COMMAND LINE PROGRAMS (BTSPATCH,DIRS,DRIVES,MAKEBAT,ONPATH,TOASCII,WI)
  822.     ──────────────────────────────────────────────────────────────────────
  823.  
  824.     command line redirection
  825.  
  826.           All programs direct their output to STDOUT.  MAKEBAT and TOASCII
  827.           receive their input from STDIN.  The output from any of the
  828.           utilities can be redirected to a file using the DOS redirection
  829.           facility, i.e. appending the command line with:
  830.  
  831.                     > filename.ext
  832.  
  833.           This is in fact the expected standard procedure for the MAKEBAT
  834.           and TOASCII utilities.  For these programs the input data can also
  835.           be redirected, with:
  836.  
  837.                     < filename.ext
  838.  
  839. General BTS Product Information                                      Page 15
  840. ____________________________________________________________________________
  841.  
  842.  
  843.  
  844.     errors and help
  845.  
  846.           All command line programs print a help screen showing their
  847.           argument usage if any argument is entered that cannot be
  848.           understood, or if the -? argument is entered.
  849.  
  850.           For errors during the execution phase, an error message (prefixed
  851.           with "utility-name:") describing the problem is issued with
  852.           the output data.
  853.  
  854.  
  855.     sound
  856.  
  857.           The command line programs never produce sound, of any form.
  858.  
  859.  
  860.     screen pauses
  861.  
  862.           By default, the WI and DIRS utilities produce paginated output and
  863.           issue the industry standard "PRESS ANY KEY TO CONTINUE" message
  864.           after each screenfull.  If the response is <ALT P>, not only will
  865.           this cause the output display to proceed, but it will also cancel
  866.           all subsequent pauses.
  867.  
  868.  
  869.     keyboard control
  870.  
  871.           Entering <CTRL c> or <CTRL BREAK> terminates the current program
  872.           immediately and returns to the DOS prompt.
  873.  
  874.  
  875. General BTS Product Information                                      Page 16
  876. ____________________________________________________________________________
  877.  
  878.  
  879. 6.0 Sample Programs Provided
  880.  
  881.     The self-extraction file SAMPLE.EXE contains a number of files that can
  882.     be used in conjunction with the BTS programs.  While each of these files
  883.     is fully operational, their purpose is primarily to serve as examples.
  884.     Each individuals requirements will determine if these files can be used
  885.     as is, should be modified slightly, replaced with alternate files, or
  886.     are simply not applicable.
  887.  
  888.     These files could have been created by any user.  They were created
  889.     using facilities that are available to everyone, and none of the BTS
  890.     programs specifically expects or references these files.  They demon-
  891.     strate how each user can extend and augment the basic facilities of the
  892.     BTS programs.
  893.  
  894.  
  895. 6.1 ToolBOX Inferred Batch Files
  896.  
  897.     Inferred batch files are DOS batch files that are invoked by ToolBOX
  898.     during normal point and shoot operations.  The referenced batch filename
  899.     is a function of the keystroke used and some portion of the selected
  900.     filename.  Refer to the ToolBOX User Manual for specifics.  As an
  901.     example, if <RETURN> is used to select a file with a .GIF extension,
  902.     then ToolBOX looks for the file TBX--GIF.BAT on the PATH.  If it is
  903.     found it is invoked, otherwise the selected file contents are displayed
  904.     with the VIEW program.
  905.  
  906.     Inferred batch files are normally passed 6 arguments (the example
  907.     assumes the selected file is C:\PICTURES\GERBILS.GIF in the current
  908.     directory):
  909.  
  910.        Argument    Description                       Example
  911.        ────────    ────────────────────────────────  ────────────────────
  912.           %1       minimized pathname                GERBILS.GIF
  913.           %2       pathname                          C:\PICTURES\GERBILS.GIF
  914.           %3       drive                             C
  915.           %4       path                              \PICTURES
  916.           %5       name                              GERBILS
  917.           %6       extension                         GIF
  918.  
  919. General BTS Product Information                                      Page 17
  920. ____________________________________________________________________________
  921.  
  922.  
  923.  
  924.     BASIC POINT AND SHOOT OPERATIONS
  925.     ════════════════════════════════
  926.  
  927.     The following inferred batch files simply invoke a particular appli-
  928.     cation program and pass it the selected filename.  They themselves are
  929.     invoked when a point and shoot operation using <RETURN> selects a file
  930.     of the appropriate extension.  For an extension of xxx, the batch file
  931.     name is TBX--xxx.BAT.
  932.  
  933.  
  934.        Extension  Application Program (Vendor)    Notes
  935.        ─────────  ────────────────────────────    ────────────────────────
  936.  
  937.           BAS     GWBASIC (Microsoft)             Basic Program, [2]
  938.           CMF     PLAYCMF (Creative Music Labs)   Sound Blaster music file
  939.           FLI     QUICKFLI (Dancing Flame)        Autodesk animation files
  940.           GIF     VPIC (Bob Montgomery)           Compuserve pictures [2]
  941.           GL      GRASPRT (Paul Mace)             GRAphicS Animation
  942.                                                      interPReTer data files
  943.           PCX     PICEM (John Bridges)            PC Paintbrush/Z-Soft
  944.                                                      pictures [2][3]
  945.           VOC     VPLAY (Creative Music Labs)     Sound Blaster voice files
  946.           WFW     WINWORD (Microsoft)             Word For Windows (invokes
  947.                                                      MS Windows) [4][5][6]
  948.           WK1     123 (Lotus Development Corp)    Spread Sheet files [6][7]
  949.           WP      WP (WordPerfect Corporation)    Word processing docs
  950.                                                      [1][4][6]
  951.  
  952.  
  953.             Notes:
  954.                [1] extension may be used by other applications.
  955.                [2] one of several possible application programs for this
  956.                    purpose.  Change to suit availability or preferences.
  957.                [3] requires customization for available hardware resources
  958.                [4] extension established by convention and may therefore
  959.                    vary between users, i.e. is not enforced.
  960.                [5] conventional extension is .DOC, .WFW is used to prevent
  961.                    ambiguity.  Note invokes MS Windows, and then WINWORD.
  962.                [6] requires customization for local directory organization
  963.                [7] as 123 does not accept a file argument, the batch
  964.                    batch file simply starts the 123 program.
  965.  
  966.     Individual users may wish to modify the inferred batch files to insert
  967.     specific paths for each application program, or add "change directory"
  968.     commands.
  969.  
  970. General BTS Product Information                                      Page 18
  971. ____________________________________________________________________________
  972.  
  973.  
  974.  
  975.     POINT AND SHOOT OPERATIONS FOR COMPRESSED DATA FILES
  976.     ════════════════════════════════════════════════════
  977.  
  978.     This is similar to the above files except that all are related to
  979.     working with one of the many forms of compressed files - whether zipped,
  980.     arced, packed, etc.  These batch files all function by extracting the
  981.     contents of the selected data file into a pre-designated empty
  982.     directory.  From there, the files can be examined and used as desired.
  983.     This technique makes it easy to store all seldom used applications,
  984.     games, documentation files, etc. in a compressed form and only
  985.     decompress when needed.  It is never necessary to explicitly delete the
  986.     individual decompressed files as they will be deleted by the next
  987.     decompression operation.  The steps performed by each of these inferred
  988.     batch files (the predefined decompression directory is C:\EMPTY):
  989.  
  990.                1) change directories to C:\EMPTY.
  991.                2) delete all of the files already there.
  992.                3) extract/decompress all the files within the selected
  993.                   compressed file into the current directory.
  994.                4) if the file START.BAT exists within the decompressed
  995.                   files, it is initiated.
  996.  
  997.     The inferred batch names are named TBX--xxx.BAT as above.
  998.  
  999.  
  1000.       Extension  Application Program (Vendor)     Notes
  1001.       ─────────  ────────────────────────────     ────────────────────────
  1002.  
  1003.         ARC      PKXARC (PKWARE, Inc)             arced
  1004.         ARJ      ARJ (Robert K Jung)              LZH derivative
  1005.         LZH      LHA (Haruyasu Yoshizaki)         Public domain
  1006.         PAK      PAK (NoGate Consulting)          packed
  1007.         SDN      PAK (NoGate Consulting)          packed, Shareware Data Net
  1008.         ZIP      PKUNZIP (PKWARE, Inc)            zipped
  1009.         ZOO      ZOO (Rahul Dhesi)
  1010.  
  1011.  
  1012.     Two alternate forms of the above inferred files are provided; both
  1013.     without the START.BAT feature.
  1014.  
  1015.     If <ALT RETURN> is used rather than <RETURN>, then the corresponding
  1016.     batch file name is TBXA-xxx.BAT.  This file functions in the same manner
  1017.     except that it does not pre-delete the files in C:\EMPTY.  The new
  1018.     decompressed files are merged with the files already in C:\EMPTY.
  1019.  
  1020.     If <CTRL RETURN> is used rather than <RETURN>, then the corresponding
  1021.     batch file name is TBXC-xxx.BAT.  This file just decompresses the
  1022.     selected file into the current directory.  There is no attempt made to
  1023.     pre-delete files or change to the C:\EMPTY directory.
  1024.  
  1025. General BTS Product Information                                      Page 19
  1026. ____________________________________________________________________________
  1027.  
  1028.  
  1029.  
  1030. 6.2.Sample Configuration Files
  1031.  
  1032.     Two example configuration files are provided: SAMPLE-A.CFG and
  1033.     SAMPLE-B.CFG.  They are identical except that SAMPLE-B.CFG uses the
  1034.     diamond () to designate selected files within the directory display
  1035.     rather than colors.  This configuration may be more appropriate for
  1036.     grayscale or LCD screens.  Since they are the same, only SAMPLE-A.CFG
  1037.     will be discussed.  While primarily for ToolBOX, this configuration file
  1038.     can be used with the TREE and VIEW utilities as well.
  1039.  
  1040.     The sample file contains all items as described in the ToolBOX User
  1041.     Manual plus the following additions.
  1042.  
  1043.           BANNER NAME
  1044.  
  1045.                Changed to "SAMPLE-A"
  1046.  
  1047.  
  1048.           COLORS
  1049.  
  1050.                Changed for the COLOR table only.  MONO and GRAYSCALE
  1051.                tables are unchanged.
  1052.  
  1053.  
  1054.           KEYBINDINGS ADDED
  1055.  
  1056.                (Note the programs referenced by these commands are not
  1057.                 provided with the BTS product.  These referenced programs
  1058.                 are however, generally available and/or are replaceable by
  1059.                 an equivalent program.)
  1060.  
  1061.  
  1062.                <CTRL D>  Dumps the currently selected file in hex to a new
  1063.                          file in the current directory with a .DMP
  1064.                          extension.  References the Borland TDUMP program.
  1065.                          Serves as an example of re-issuing the keyboard
  1066.                          command line for each selected file.
  1067.  
  1068.                <CTRL E>  Edits the currently selected file.  References the
  1069.                          PC Magazine TED (Tiny Text Editor) utility.
  1070.  
  1071.                <CTRL L>  Uses the LIST utility (from Vernon D. Berg) to
  1072.                          display the contents of the currently selected
  1073.                          file.  While similar to VIEW, LIST has advantages
  1074.                          for some requirements; the major ones being
  1075.                          unlimited file size, wraps text lines, and can
  1076.                          display files directly in hex.
  1077.  
  1078.                <CTRL M>  Similar to <ALT C> for copy, this initiates a
  1079.                          keyboard command line to move the selected files to
  1080.                          another directory.  Move operations differ from a
  1081.                          copy in that the source files are deleted after the
  1082.                          move operation is performed.  The keybinding
  1083.                          references the MV command.  Many similar programs
  1084. General BTS Product Information                                      Page 20
  1085. ____________________________________________________________________________
  1086.  
  1087.  
  1088.                          exist.  Normally the second parameter is the target
  1089.                          directory.
  1090.  
  1091.                <CTRL U>  Freshen ZIP file.  Uses the PKZIP program to update
  1092.                          (or freshen) the selected compressed .ZIP file with
  1093.                          any changes that were made in the decompressed
  1094.                          files in C:\EMPTY.  Useful for applications which
  1095.                          make minor changes to configuration or score files
  1096.                          that should be retained.  While implemented only
  1097.                          for the .ZIP, format, this could be applied to any
  1098.                          of the popular compression techniques.
  1099.  
  1100.                <CTRL V>  Alternate facility to view the contents of the
  1101.                          selected files.  Whereas <ALT V> always uses VIEW
  1102.                          to view the contents, <CTRL V> is provided to
  1103.                          examine the file based on some knowledge of the
  1104.                          format of the data contents.  Three levels of
  1105.                          viewing are provided:
  1106.  
  1107.                               - if the file has a ARC, ARJ, LZH, PAK or ZIP
  1108.                                 extension, then the FV utility (from Vernon
  1109.                                 D. Berg) is used to provide a directory
  1110.                                 display of the compressed files.
  1111.  
  1112.                               - if the above is not satisfied, the PATH is
  1113.                                 searched for the TBXV-xxx.BAT inferred batch
  1114.                                 file which will be invoked to perform the
  1115.                                 viewing that is specific to this file type.
  1116.  
  1117.                               - failing the above, the traditional VIEW
  1118.                                 program is used to display the file
  1119.                                 contents.
  1120.  
  1121.                <CTRL Z>  Compresses all the files in the display directory
  1122.                          into a .ZIP file in the same directory.  The 8
  1123.                          character name is selected from the filename at the
  1124.                          current cursor position.  Again, any compression
  1125.                          format could have been used in preference to ZIP.
  1126.  
  1127.  
  1128.  
  1129. 6.3 DOS Batch Files
  1130.  
  1131.     The batch files described here provide a shortcut to using the features
  1132.     of the BTS program utilities.  Most utilize utilities that are only
  1133.     available with the registered version of the product.  The expected
  1134.     arguments are shown in lower case.
  1135.  
  1136.           TIR  [d:path][match-list]
  1137.  
  1138.                Uses ToolBOX as a replacement for the DOS DIR command.
  1139.                Starts ToolBOX so that if all files can be displayed on one
  1140.                screen, they will be displayed and ToolBOX exits immediately
  1141.                to DOS.  If more screens are required, ToolBOX remains
  1142.                active, but in DIRECTORY mode rather than SELECT to
  1143. General BTS Product Information                                      Page 21
  1144. ____________________________________________________________________________
  1145.  
  1146.  
  1147.                facilitate use as a directory display program.
  1148.  
  1149.           D1
  1150.  
  1151.                Invokes the DIRS utility to display branch sizes for the
  1152.                first level only.  This is probably the most common choice
  1153.                for day-to-day operations.  The same effect could have been
  1154.                created by using BTSPATCH to modify DIRS so that the number
  1155.                of levels was one by default.
  1156.  
  1157.  
  1158.           CLEAN [d:]
  1159.  
  1160.                Using WI, deletes all of the files on the designated drive
  1161.                (or current if not specified) that are at least 4 days old
  1162.                and have a BAK, OLD, or TMP extension.
  1163.  
  1164.  
  1165.           WI-COPY  sourceSpecification targetPath
  1166.  
  1167.                Using WI, copies all files corresponding to the match
  1168.                specification of the first argument, to the directory
  1169.                specified by the second argument.  As the first argument is
  1170.                assumed to end after the first trailing space, it is not
  1171.                possible to use a match list specification for the
  1172.                sourceSpecification.
  1173.  
  1174.  
  1175.           WI-RUN  filename [option]...
  1176.  
  1177.                Using WI, finds the first program matching the specified
  1178.                filename (.EXE extension assumed) and executes it.  The
  1179.                optional arguments, such as -C, are passed to WI.
  1180.  
  1181.  
  1182.           WI-VIEW sourceMatchlist
  1183.  
  1184.                Using WI, finds the files matching the argument matchlist and
  1185.                displays their contents with the VIEW utility.
  1186.  
  1187.  
  1188.           ZRUN d:path\zipname
  1189.  
  1190.                Provides a mechanism for simulating from the DOS command
  1191.                line, what ToolBOX does when unzipping files: i.e. deleting
  1192.                all files in C:\EMPTY, unzipping the named file into
  1193.                C:\EMPTY, and then starting the START.BAT file if it is
  1194.                available.  The full pathname for the ZIP file must be stated
  1195.                as it is referenced from the C:\EMPTY directory.  The example
  1196.                batch file is provided for the ZIP format, but could have
  1197.                been included for any of the available compress formats.
  1198.  
  1199. General BTS Product Information                                      Page 22
  1200. ____________________________________________________________________________
  1201.  
  1202.  
  1203. 6.4 MS Windows Data Files
  1204.  
  1205.     The BTS programs are obviously not specifically designed for use with
  1206.     Microsoft Windows.  They can however be used with the MS Windows 3.0
  1207.     program.  In fact under Windows the BTS facilities are generally much
  1208.     faster and more convenient than the Windows specific programs.
  1209.  
  1210.     Icons (.ICO) and pif (.PIF) files are provided for integrating the three
  1211.     full screen programs - TBOX, TREE, and VIEW.  These files are not
  1212.     required for correct operation under Windows, they are simply a
  1213.     convenience.  To include the BTS programs as a group, create a NEW group
  1214.     through the windows program manager.  In the initial Program Group
  1215.     Properties window enter a Description name (such as Binary Toolshed),
  1216.     and for the Group File specify C:\BTS\BTS.GRP.  This creates an
  1217.     established group with PIF files for ToolBOX, VIEW and TREE.  Two
  1218.     versions of each are provided, a normal version and one that forces full
  1219.     screen operation (applicable to 386 enhanced mode only).
  1220.  
  1221.  
  1222. General BTS Product Information                                      Page 23
  1223. ____________________________________________________________________________
  1224.  
  1225.  
  1226. APPENDIX A : Questions & Answers
  1227.  
  1228.  
  1229.     Q     Can I use the executable compress programs such as LZEXE or PKLITE
  1230.           to reduce the program size.
  1231.  
  1232.     A     Yes, but.  These programs do work.  Tests on the Binary Toolshed
  1233.           programs indicate a typical disk size reduction of 35% although
  1234.           there is a marginal increase in load time due to the required
  1235.           decompression time (this percentage will vary with each systems
  1236.           ratio of disk performance to processor speed).  On the negative
  1237.           side, BTSPATCH cannot work on compressed programs.  If you need to
  1238.           use BTSPATCH, use it on the normal version of the program, and
  1239.           then compress the patched version.
  1240.  
  1241.  
  1242.     Q     In ToolBOX, what happens if I enter a program name that has the
  1243.           same name as a directory.
  1244.  
  1245.     A     DOS won't actually let you create a directory and file with the
  1246.           same name, the second is always inhibited.  However, the ambiguity
  1247.           can occur anyway since when the program name is entered, the
  1248.           extension isn't usually provided.  ToolBOX takes this name
  1249.           (without an extension) and first checks if it matches a directory
  1250.           name.  If a match occurs the directory change is made and ToolBOX
  1251.           will never attempt to see if an appropriate executable file
  1252.           exists.  To prevent this, explicitly enter the extension when a
  1253.           potential problem exists.  This is rarely a problem.  The more
  1254.           common occurrence, which is not ambiguous, is to find executables
  1255.           within directories of the same name.
  1256.  
  1257.  
  1258.     Q     With ToolBOX, when invoking an application through point and shoot
  1259.           operations, is there any real difference between using inferred
  1260.           batch files and specially configuring a keybinding.
  1261.  
  1262.     A     Not in the basic sense; they both end up invoking the appropriate
  1263.           application and can optionally pass it the name of the selected
  1264.           file.
  1265.  
  1266.           The minor advantages of the inferred batch file are that it is
  1267.           probably easier to configure and, since it is external, ToolBOX's
  1268.           size isn't increased to hold the configuration data.
  1269.  
  1270.           The advantage of the configured keybinding is that several options
  1271.           are possible that are not available to the inferred batch file.
  1272.           You can specify more than one match specification and it can be
  1273.           based on something other than just the extension, any desired
  1274.           keystroke can be specified, flags can be set to pause/swap/
  1275.           reformat/etc, and the command executes much faster since the PATH
  1276.           doesn't have to be searched.
  1277.  
  1278.  
  1279. General BTS Product Information                                      Page 24
  1280. ____________________________________________________________________________
  1281.  
  1282.  
  1283.     Q     Isn't there another ambiguity in ToolBOX if referenced filenames
  1284.           start with the "!".
  1285.  
  1286.     A     Yes, ToolBOX is not able to tell whether !FILENAM.EXT is intended
  1287.           to exclude the file "FILENAM.EXT" or to include the file
  1288.           "!FILENAM.EXT".  ToolBOX resolves this somewhat by using the
  1289.           second definition ("!FILENAM.EXT") if there are any files in the
  1290.           referenced directory with a leading "!".  Obviously this is still
  1291.           a potential source of problems.  The safest solution is to rename
  1292.           all files that start with "!".
  1293.  
  1294.  
  1295.     Q     Why does <ALT p> use the DOS COPY rather than PRINT?
  1296.  
  1297.     A     Primarily because the PRINT command establishes a small TSR the
  1298.           first time it is run.  If you want to take advantage of the
  1299.           spooling capabilities of the PRINT command, change the
  1300.           SAMPLE-x.CFG file and ensure that PRINT is run once before ToolBOX
  1301.           is initiated (e.g. from your AUTOEXEC.BAT).  Obviously any print
  1302.           utility program could be used here.
  1303.  
  1304.  
  1305.  
  1306.  
  1307.     Q     What does it mean if ToolBOX just beeps when I try to initiate a
  1308.           program.
  1309.  
  1310.     A     For some reason the program can't be run.  Usually there is no
  1311.           memory available or the swap device is full.
  1312.  
  1313.  
  1314.     Q     Are there any operational hints for ToolBOX?
  1315.  
  1316.     A     Sure:
  1317.  
  1318.             a) to move up one directory (to ..)
  1319.  
  1320.                     <HOME><HOME><RETURN>
  1321.  
  1322.             b) to change the directory display format or sort selection, the
  1323.                pop-up menu sequence corresponds exactly to the 'dir' command
  1324.                parameters.  E.G.:
  1325.  
  1326.                     /fd
  1327.                          or
  1328.                     /sx
  1329.  
  1330.             c) to refresh the display for the current directory, simply
  1331.                enter '.' - which ToolBOX interprets as a request to move to
  1332.                the current directory.
  1333.  
  1334.             d) if you have trouble remembering whether it's the ALT or CTRL
  1335.                key, remember that ToolBOX only uses the <ALT-letter>
  1336.                combinations for the factory defaults.  <CTRL-letter> keys
  1337.                are left for the SAMPLE-x.CFG files or user configured
  1338. General BTS Product Information                                      Page 25
  1339. ____________________________________________________________________________
  1340.  
  1341.  
  1342.                bindings.
  1343.  
  1344.             e) you may find that using the intrinsic DEL command to delete a
  1345.                large number of files takes a considerable period of time.
  1346.                Either be patient or enter the original command in mixed case
  1347.                to request the faster DOS version.
  1348.  
  1349.  
  1350.     Q     Are there any limits one should be aware of?
  1351.  
  1352.     A     Unfortunately there are always limits.  The following are guide-
  1353.           lines; the available memory, the video card used, and other
  1354.           factors will influence the actual values.  The programs will
  1355.           continue even if these values are exceeded.
  1356.  
  1357.               TBOX  - 1200 files or subdirectories within a single directory
  1358.  
  1359.               VIEW  - 500KB per file
  1360.  
  1361.               TREE  - for each drive, 2700 directories
  1362.                     - for each directory, file list is limited to 400 files
  1363.  
  1364.               DIRS  - 1400 directories
  1365.                     - 256 subdirectories in each directory
  1366.  
  1367.  
  1368.     Q     Are there any known incompatibilities with other programs.
  1369.  
  1370.     A     Only one currently.  If using DOS 5, ANSI.SYS, and the DOS MODE
  1371.           command is used to establish 43 or 50 screen lines, there will
  1372.           occasionally be some confusion in the positioning of the cursor
  1373.           when switching between the split screen and DOS windows.  While
  1374.           this is little more than an annoyance in that text will be
  1375.           overwritten, at this time we recommend that with DOS 5 you use any
  1376.           of the alternative mechanisms for establishing more than 25 screen
  1377.           lines.
  1378.  
  1379.  
  1380. General BTS Product Information                                      Page 26
  1381. ____________________________________________________________________________
  1382.  
  1383.  
  1384. APPENDIX B : Glossary
  1385.  
  1386.     argument             an option field on the program command line.  Note,
  1387.                          the convention used within these manuals is that
  1388.                          "arguments" refer to the initial startup command
  1389.                          line, while "parameters" (see below) refer to
  1390.                          options on command lines within the ToolBOX
  1391.                          program.
  1392.  
  1393.     BTSPATCH.EXE         a separate utility program that allows the user to
  1394.                          set their own default startup command line within
  1395.                          each of the supplied Binary Toolshed programs.
  1396.                          Refer to the Utilities User Manual for more
  1397.                          information.
  1398.  
  1399.     command line         a single processable line of text.  This may be a
  1400.                          DOS command line or if within ToolBOX - a ToolBOX
  1401.                          intrinsic.
  1402.  
  1403.     command set          a collection of command lines that are assigned to
  1404.                          a keybinding for the ToolBOX program.  This
  1405.                          grouping is created through the TBOXCFG program.
  1406.  
  1407.     compressed file      a file that has been created by one of the many
  1408.                          available compression programs (ARC, PAK, PKZIP,
  1409.                          etc.).  Compression not only reduces the size of
  1410.                          the original, but provide a means of collecting a
  1411.                          number of individual files into one single file.
  1412.                          This compression reduces storage and/or communi-
  1413.                          cation time requirements.  Each compression
  1414.                          technique requires its own specific decompression
  1415.                          program to restore the compressed files back to
  1416.                          their original form.
  1417.  
  1418.     DIRS.EXE             a BTS (registered version only) utility program
  1419.                          that displays disk space utilization for directory
  1420.                          branches.  Refer to the Utilities User Manual for
  1421.                          more information.
  1422.  
  1423.     DOS                  Disk Operating System, the control program for IBM
  1424.                          Personal Computers.  The term refers to both the
  1425.                          Microsoft (MS DOS) and the IBM (PC DOS) versions.
  1426.  
  1427.                          Refer to your DOS User Manual for further
  1428.                          explanations of DOS commands such as PATH, COPY,
  1429.                          FORMAT, RD, and RENAME, as well as descriptions of
  1430.                          wildcard characters, batch files, directories,
  1431.                          environment variables, command line redirection,
  1432.                          STDIN and STDOUT definitions, and so on.
  1433.  
  1434.     DRIVES.EXE           a BTS (registered version only) utility program
  1435.                          that displays disk drive parameters for all
  1436.                          assigned drives.    Refer to the Utilities User
  1437.                          Manual for more information.
  1438.  
  1439. General BTS Product Information                                      Page 27
  1440. ____________________________________________________________________________
  1441.  
  1442.  
  1443.     environment variables
  1444.                          also referred to as set variables, these are user
  1445.                          defined names that can be associated with any
  1446.                          desired text string.  Programs can interrogate
  1447.                          these strings and act accordingly.  Use the DOS SET
  1448.                          command to modify these variables - such as BTS, or
  1449.                          PATH.
  1450.  
  1451.     errorlevel           an exit code value (from 0 to 255) returned from
  1452.                          all DOS programs.  This can be tested by the IF
  1453.                          statement within batch files or referenced by the
  1454.                          keybinding processing within ToolBOX.  All Binary
  1455.                          Toolshed programs employ a standard convention for
  1456.                          errorlevel values.
  1457.  
  1458.     factory defaults     the initialization settings that were established
  1459.                          by the Binary Toolshed and included in the
  1460.                          distribution version of the product.  The program
  1461.                          defaults can be changed subsequently by the
  1462.                          BTSPATCH or TBOXCFG programs.
  1463.  
  1464.     intrinsics           command lines understood and processed directly by
  1465.                          ToolBOX, i.e. they are not passed on to DOS.  These
  1466.                          command lines consist of a command word (e.g. "sel"
  1467.                          or "del") and optionally one or more parameters.
  1468.  
  1469.     keybinding           the attachment of a command set to a particular
  1470.                          keyboard keystroke.  These are configured by the
  1471.                          TBOXCFG program, and used by the TBOX program.
  1472.  
  1473.     keyboard command     a command line (DOS or intrinsic) entered manually
  1474.                          through the TBOX command line as shown at the
  1475.                          bottom of the directory display.
  1476.  
  1477.     keystroke            a single identifiable entry through the keyboard.
  1478.                          This may be one key or multiple keys.  For example
  1479.                          <a> or <CTRL ALT 9>.
  1480.  
  1481.     MAKEBAT.EXE          a BTS (registered version only) utility program
  1482.                          that creates batch files based on a template data
  1483.                          file and a file match specification for applicable
  1484.                          files.  Refer to the Utilities User Manual for more
  1485.                          information.
  1486.  
  1487.     matchlist            a file selection specification list that can
  1488.                          specify a drive, path, and one or more file
  1489.                          specifications.  Each file specification can use
  1490.                          the DOS wildcard characters and be preceded by "!"
  1491.                          to indicate matching files should be removed from
  1492.                          the selected list rather than added.  For example:
  1493.  
  1494.                                   c:\dos\*.* !*.com !*.exe
  1495.  
  1496. General BTS Product Information                                      Page 28
  1497. ____________________________________________________________________________
  1498.  
  1499.  
  1500.     ONPATH.EXE           a BTS (registered version only) utility that
  1501.                          determines if specified files are accessible
  1502.                          through the DOS PATH variable.  Refer to the
  1503.                          Utilities User Manual for more information.
  1504.  
  1505.     parameter            separate option field(s) following the command word
  1506.                          on a command line within the ToolBOX program; that
  1507.                          is used for the entry of DOS or intrinsic commands
  1508.                          through the keyboard command line or through
  1509.                          command sets.  Refer above to "argument".
  1510.  
  1511.     PATH                 the DOS reserved environment variable which
  1512.                          designates alternate directories to be searched for
  1513.                          program files.
  1514.  
  1515.     path                 a DOS directory specification consisting of an
  1516.                          optional leading drive indicator and one or more
  1517.                          directory names, e.g.
  1518.  
  1519.                                    d:\dos\5.00\
  1520.  
  1521.     pathname             a DOS file specification consisting of a filename
  1522.                          with an optional leading path, e.g.
  1523.  
  1524.                                    d:\dos\5.00\command.com
  1525.  
  1526.     point-and-shoot      the ability to cursor to an object such as a file
  1527.                          (hence point) and when <ENTER> is pressed (hence
  1528.                          shoot) have a particular operation carried out
  1529.                          based on some characteristic of the selected object
  1530.                          - such as the extension.
  1531.  
  1532.     popup menu           a window of menu selections that appears in the
  1533.                          "middle" of the current screen.  The menu options
  1534.                          may initiate actions directly or bring up further
  1535.                          menus with more options.
  1536.  
  1537.     quickcommand line    single command lines within ToolBOX that may be
  1538.                          initiated separate from the command sets bound to
  1539.                          particular keystrokes.
  1540.  
  1541.     redirection          a DOS capability which allows the normal input or
  1542.                          output of a command to be altered to come from or
  1543.                          go to a specified file.  Redirection can be used
  1544.                          for the DOS command lines within ToolBOX.
  1545.  
  1546.     self-extraction file a compressed file that embeds the decompression
  1547.                          facility within itself.  These are usually .EXE
  1548.                          files.  Running the file (and program) extracts (or
  1549.                          decompresses) the contained files into the current
  1550.                          directory.
  1551.  
  1552.     TBOX.EXE             The ToolBOX - the main shell program provided with
  1553.                          the BTS product.  These documentation files refer
  1554.                          to TBOX as ToolBOX.  Provides file directory
  1555. General BTS Product Information                                      Page 29
  1556. ____________________________________________________________________________
  1557.  
  1558.  
  1559.                          displays, point and shoot operations, single key
  1560.                          activation of sets of commands, pass through DOS
  1561.                          command line operation, reuse of command line text,
  1562.                          quick access to recently entered directories,
  1563.                          simultaneous directory and DOS window views, and
  1564.                          much more.  Refer to the ToolBOX User Manual for
  1565.                          more information.
  1566.  
  1567.     TBOXCFG.EXE          a BTS configuration program that allows extensive
  1568.                          modifications to the basic ToolBOX operational
  1569.                          capabilities.  Refer to the TBOXCFG User Manual for
  1570.                          more details.
  1571.  
  1572.     TOASCII.EXE          a BTS utility program that acts as a filter for
  1573.                          converting text files that use the extended IBM PC
  1574.                          character set to use the standard 95 printable
  1575.                          ASCII characters.  Refer to the Utilities User
  1576.                          Manual for more information.
  1577.  
  1578.     toggle               to switch between alternatives: ON to OFF, from
  1579.                          INSERT to OVERWRITE mode, from the DOS display to
  1580.                          the ToolBOX display, etc.
  1581.  
  1582.     TREE.EXE             a BTS utility program that graphically depicts the
  1583.                          directory structure in the form of a tree that can
  1584.                          be traversed with the cursor keys.  Refer to the
  1585.                          Utilities User Manual for more information.
  1586.  
  1587.     TSR                  a Transient and Stay Resident program.  These
  1588.                          programs permanently retain a small portion of
  1589.                          memory while they lie dormant waiting for a
  1590.                          particular action.  These programs must be
  1591.                          initiated before ToolBOX is run.
  1592.  
  1593.     verification window  a prompt window issued by ToolBOX to ensure the
  1594.                          requested operation is really desired.
  1595.  
  1596.     VIEW.EXE             a BTS utility program that allows browsing through
  1597.                          textual data files.  Refer to the Utilities User
  1598.                          Manual for more information.
  1599.  
  1600.     WI.EXE               a BTS (registered version only) utility program
  1601.                          that locates specified files wherever they are
  1602.                          located on the disk drive(s), and optionally
  1603.                          carries out an operation on those files.  Refer to
  1604.                          the Utilities User Manual for more information.
  1605.  
  1606.