home *** CD-ROM | disk | FTP | other *** search
/ Lion Share / lionsharecd.iso / utils_mz / sts_400.zip / STS.DOC < prev    next >
Text File  |  1992-05-12  |  150KB  |  2,590 lines

  1. U
  2.                             S T E R E O   S H E L L
  3.  
  4.                                  version 4.00
  5.  
  6.                             * User documentation *
  7.  
  8.                                 M.R.E. Software
  9.  
  10.                           (c) copyright 1989,90,91,92
  11.  
  12.  
  13.     ==========================================================================
  14.  
  15.  
  16.        ,--------------------,      ,----------,      ,---------------------,
  17.        |                    |      |  VIEWER  |      |                     |
  18.        |      ........      |      |----------|      |      ........       |
  19.        |   ..............   |      |  EDITOR  |      |   ..............    |
  20.        |  ................  |      |----------|      |  ................   |
  21.        |  ................  |      | 10 LNCH. |      |  ................   |
  22.        |   ..............   |      |----------|      |   ..............    |
  23.        |      ........      |      | 10 USER  |      |      ........       |
  24.        |                    |      |----------|      |                     |
  25.        |                    |      | 8 COMPRS.|      |                     |
  26.        |   .....       ..   |      |----------|      |   ..        .....   |
  27.        |  .......     `..'  |      |  8 SPEC. |      |  `..'      .......  |
  28.        |   .....            |  ,---`----------'---,  |             .....   |
  29.        |          Stereo    |--| MS-DOS  ........ |--|   Shell             |
  30.        `--------------------'  `------------------'   `---------------------'
  31.  
  32.                            *  The components of power *
  33.  
  34.     ==========================================================================
  35.                                         ==
  36.                                         ==
  37.                                         ==
  38.                       ========================================
  39.                          DOS never sounded this good before!
  40.                       ========================================
  41.                                         ==
  42.                                         ==
  43.                                         ==
  44.     ==========================================================================
  45.                                                  .---------.              (tm)
  46.         Published by:                      ,-----'---,     |
  47.       --------------------------         --|         |o    |------------------
  48.         M.R.E. Software                    |   .-----'---. |  Association of
  49.         206 E. Jones St.                   |   |         |-'  Shareware
  50.         West Point, Ms.  39773             `---|    o    |    Professionals
  51.       --------------------------         ------|    |    |--------------------
  52.         Emery D. Wooten Jr.                    `---------'    MEMBER
  53.  
  54.  
  55.         (C.) Copyright 1989,90,91,92  Microsystems Research and Engineering
  56.         (C.) Copyright 1989,90,91,92  Emery D. Wooten Jr.
  57.     Stereo Shell, M.R.E. Software, Microsystems Research and Engineering (TM)s
  58.                     * All rights reserved worldwide *
  59. U
  60.  
  61.  
  62.                                   C O N T E N T S
  63.         _____________________________________________________________________
  64.  
  65.         PREFACE ......................................................... I
  66.  
  67.         HARDWARE REQUIREMENTS ........................................... II
  68.  
  69.  
  70.         PART 1 ** INITIAL SETUP
  71.              Sec. 1.1  INTRODUCTION .................................... 1-1
  72.              Sec. 1.2  THE STS DEFAULT SETUP ........................... 1-1
  73.              Sec. 1.3  RUNNING STS THE FIRST TIME ...................... 1-2
  74.              Sec. 1.4  HOW TO FULLY TUNE STEREO SHELL .................. 1-3
  75.                   Sub-Sec. 1.4.1  SCREEN AND MOUSE OPTIONS ............. 1-3
  76.                   Sub-Sec. 1.4.2  COLOR SETUP .......................... 1-4
  77.                   Sub-Sec. 1.4.3  FILES/EXTERNAL SETUP ................. 1-5
  78.                   Sub-Sec. 1.4.4  SAVE SETTINGS AND EXIT ............... 1-9
  79.                   Sub-Sec. 1.4.5  EXIT NO SAVE ......................... 1-9
  80.  
  81.         PART 2 ** USING STEREO SHELL
  82.              Sec. 2.1  INTRODUCTION .................................... 2-1
  83.              Sec. 2.2  THE StS DISPLAY ................................. 2-2
  84.                   Sub-Sec. 2.2.1  THE FILE WINDOWS ..................... 2-3
  85.                   Sub-Sec. 2.2.2  THE CHG.DIR. WINDOW .................. 2-4
  86.                   Sub-Sec. 2.2.3  THE TITLE AND FUNCTION KEY AREA ...... 2-5
  87.              Sec. 2.3  StS DIRECT KEYS AND COMMANDS .................... 2-5
  88.                   Sub-Sec. 2.3.1  THE CURSOR AND SCREEN KEYS ........... 2-5
  89.                   Sub-Sec. 2.3.2  THE LETTER, NUMBER, AND MARKING KEYS . 2-6
  90.                   Sub-Sec. 2.3.3  THE COMMAND KEYS ..................... 2-9
  91.                   Sub-Sec. 2.3.4  MOUSE CONTROL ........................ 2-11
  92.                   Sub-Sec. 2.3.5  FILENAME CONVENTIONS ................. 2-12
  93.              Sec. 2.4  THE DOS MENU .................................... 2-12
  94.              Sec. 2.5  THE GENERAL FILES MENU .......................... 2-13
  95.              Sec. 2.6  MARKED FILES MENUS .............................. 2-16
  96.                   Sub-Sec. 2.6.1  THE MARKING CRITERIA MENU ............ 2-16
  97.                   Sub-Sec. 2.6.2  THE MARKED FILES MENU ................ 2-18
  98.              Sec. 2.7  THE EXE COM BAT MENU ............................ 2-19
  99.              Sec. 2.8  THE FILE COMPRESSOR MENU ........................ 2-20
  100.                   Sub-Sec. 2.8.1  THE I/O REDIRECTION MENU ............. 2-23
  101.                   Sub-Sec. 2.8.2  THE EXTENDED ZIP MENU ................ 2-23
  102.              Sec. 2.9  THE INTERNAL VIEW UTILITY ....................... 2-25
  103.              Sec. 2.10 USEFUL NOTES AND HINTS .......................... 2-26
  104.  
  105.         APPENDIX A ** COMPRESSION UTILITY INTERFACING .................. A-1
  106.  
  107.         APPENDIX B ** LICENSE/WARRANTY ................................. A-1
  108.              Sec. B.1  LICENSE ......................................... B-1
  109.              Sec. B.2  WARRANTY ........................................ B-2
  110.              Sec. B.3  TRADEMARKS ...................................... B-2
  111.  
  112.         APPENDIX C ** StS REGISTRATION ................................. C-1
  113.              Sec. C.1  WHY SHOULD I REGISTER ? ......................... C-1
  114.              Sec. C.2  REGISTRATION FEES ............................... C-2
  115.              Sec. C.3  SITE LICENSE/QUANTITY DISCOUNT .................. C-2
  116.              Sec. C.4  THE MRE SOFTWARE BBS ............................ C-3
  117.              Sec. C.5  REGISTRATION FORM ............................... C-4
  118.                                                                           I
  119.  
  120.                                       PREFACE
  121.         _____________________________________________________________________
  122.  
  123.              Stereo Shell is a unique DOS shell utility program.  This
  124.         program provides two fully independent file/directory displays which
  125.         enable it to provide extremely powerful, yet simple, file handling
  126.         functions.  The twin, or if you will, stereo display allows the user
  127.         to perform file operations such as move and copy between any two
  128.         drives, or directories, or combinations of drive/directories on the
  129.         machine without ever typing a file or path name.
  130.  
  131.              Stereo Shell also offers many more exciting features.  A full
  132.         complement of standard DOS functions is provided.  These include
  133.         the well known move, copy, erase, etc. and all in stereo!  A built in
  134.         view as well as a user defined editor, 10 user defined file utility
  135.         programs, and 10 user defined launchable programs serve to enhance the
  136.         power and usefulness of the program to the maximum.  Complicated pro-
  137.         cedures are simplified by intelligent menus that appear when a file is
  138.         selected.  These menus are selected by the program based on the file
  139.         type and offer the most frequently needed functions for that type of
  140.         file in top-down order allowing quick, effortless operation.  All ten
  141.         function keys are also "hot" providing more experienced users with
  142.         instant action.  And we haven't forgotten the mouse, full rodent
  143.         support is built in.
  144.  
  145.              Eight possible file compression programs are also supported by
  146.         Stereo Shell!  Stereo Shell has built-in menus and a file handling
  147.         system to support ARC, ZIP, LZH, PAK, ARJ, and 3 spare compression
  148.         programs.  This system provides a virtually complete, programmable,
  149.         and effortless interface to these excellent compression utilities.
  150.         Our system uses the actual utility programs, not some kind of built
  151.         in approximation of the real thing.  This ensures that the 
  152.         compressed files are truly compatible and it also allows simple
  153.         updates to revised versions of the various file compression programs
  154.         without the need to update StS itself.
  155.  
  156.              Stereo Shell provides a great shell environment for your
  157.         everyday activities.  Its ease of use and ability to execute files
  158.         while taking only a meager 45Kb of RAM makes it a refreshing change
  159.         from the hum-drum character based MS-DOS or some of those plain old
  160.         mono directory utilities.  StS is also absolutely perfect as an
  161.         executable utility program for Procomm (tm) or other communications
  162.         packages since it provides the means to view directories, edit files,
  163.         and even extract and execute files from compressed library files, all
  164.         while still on-line!
  165.  
  166.              There is much more!  Please give this program a full test on your
  167.         system.  We know you'll agree, DOS never sounded this good before.
  168.         Stereo Shell......The hi-fidelity DOS shell.
  169.                                                                          II
  170.  
  171.                               HARDWARE REQUIREMENTS
  172.         _____________________________________________________________________
  173.  
  174.  
  175.         StS will run on the IBM PC-XT-AT-PCjr-PS/2 and all true compatibles.
  176.  
  177.         The general system requirements are outlined below.
  178.  
  179.         Memory .......... 128 Kb. minimum.  Shrinks its own memory usage to
  180.              about 45Kb while executing external programs.
  181.  
  182.         Operating sys. .. MS/PC DOS version 2.11 or later.
  183.  
  184.         Video ........... The MDA, CGA, MCGA, EGA, and VGA video adapters
  185.              or any adapters that can emulate these are supported.  StS offers
  186.              the 25/28/43/50 line modes on supported video adapters and
  187.              systems.  Full 16 color text mode is provided on all but the MDA.
  188.              Screen writing is user selectable between BIOS and direct
  189.              modes.
  190.  
  191.         Disk ............ All disk I/O is controlled through standard DOS
  192.              function calls.   Stereo Shell was designed primarily for hard
  193.              disk based systems and at least one hard disk is recommended.
  194.  
  195.         Network systems.. StS version 4.00 has been tested on the Novell (tm)
  196.              network software with excellent results.
  197.                                                                         1-1
  198.  
  199.         _____________________________________________________________________
  200.  
  201.         >> PART 1                     INITIAL SETUP
  202.         _____________________________________________________________________
  203.  
  204.  
  205.         >> Sec. 1.1                    INTRODUCTION
  206.         _____________________________________________________________________
  207.  
  208.              StS has an integrated external setup program to allow the user to
  209.         configure it to his system and requirements.  "Integrated external"
  210.         means that the setup program is actually a separate program that is
  211.         automatically executed by StS and appears to be an integral part of
  212.         STS.EXE.  The advantage of an integrated external program over a
  213.         built-in setup routine is a significant savings in runtime memory
  214.         usage.  Since the program is integrated, it works just like a part of
  215.         StS and thus does not require any additional work by the user.
  216.  
  217.              The external setup program is named STSETxxx.EXE where the 'xxx'
  218.         refers to the version number of StS with which the external setup
  219.         program was designed to work.  For example in StS version 4.00 the
  220.         setup program is named STSET400.EXE.  IN ORDER FOR STEREO SHELL TO
  221.         FIND AND EXECUTE THE SETUP PROGRAM, IT MUST EXIST SOMEWHERE IN THE
  222.         USER DEFINED DOS PATH.
  223.  
  224.              The following section will guide you through the initial
  225.         execution of the StS program and the setup program features.
  226.  
  227.  
  228.         >> Sec. 1.2              THE STS DEFAULT SETUP
  229.         _____________________________________________________________________
  230.  
  231.              StS comes pre-configured to run on what is considered the most
  232.         likely system configuration.  It assumes you have an IBM compatible
  233.         video card and that your primary hard disk drive is C:.  Although the
  234.         program is totally re-settable with respect to these parameters, this
  235.         will be your starting point.
  236.  
  237.              StS uses several external utility programs to accomplish the
  238.         tasks of library file handling, editing, and listing.  The default
  239.         pathnames defined for these functions is C:\STEREO.  It is highly
  240.         recommended but not required that you create a sub-directory called
  241.         STEREO on the root directory of your primary (C:) hard disk and place
  242.         these files in it;
  243.  
  244.         PKZIP.EXE   ........ ZIP file packer
  245.         PKUNZIP.EXE ........ ZIP file un-packer
  246.         PKPAK.EXE   ........ ARC file packer
  247.         PKUNPAK.EXE ........ ARC file un-packer
  248.         LHARC.EXE   ........ LZH file utility
  249.         PAK.EXE     ........ PAK file utility
  250.         ARJ.EXE     ........ ARJ file utility
  251.         LIST???.COM ........ ASCII file list program
  252.         E88.EXE     ........ ASCII text editor  (available from M.R.E.)
  253.                                                                         1-2
  254.  
  255.              If you do not have all of these programs or do not want to move
  256.         them, no problem.  The creation of this sub-directory and the
  257.         availability of all these programs should only be considered as a
  258.         helpful suggestion.  StS's initial paths are all set to C:\STEREO\
  259.         and setting up such a sub-directory will save time but StS can be
  260.         easily configured to work otherwise.
  261.  
  262.  
  263.         >> Sec. 1.3            RUNNING StS THE FIRST TIME
  264.         _____________________________________________________________________
  265.  
  266.              It is strongly suggested that the user create a sub-directory
  267.         named STEREO and copy all of the files associated with StS into
  268.         that sub-directory.  If there is space on the C: drive for this
  269.         sub-directory that is the recommended place for it.  StS uses an
  270.         integrated external setup program (see above) that must reside in
  271.         the DOS path so it is also suggested that the user edit the path
  272.         statement in the AUTOEXEC.BAT file to include the STEREO sub-
  273.         directory.  If you have no path statement, then add the following
  274.         line to your AUTOEXEC.BAT file.   PATH=C:\STEREO\
  275.  
  276.              To execute StS, just type in STS at the DOS prompt like you
  277.         would any other program.  StS is not resident or special with respect
  278.         to general operation with one exception.  StS expects to find the
  279.         COMSPEC environment string defined.  In 99% of all cases MS-DOS has
  280.         already done this job for you so no action is required by the user.
  281.         In the event that StS does not find this string, it will report the
  282.         error.  If this happens, then simply add this statement to your
  283.         AUTOEXEC.BAT file.   SET COMSPEC = C:\COMMAND.COM   If you are not
  284.         running a hard disk, you should adjust the drive letter as required.
  285.  
  286.              When executed, the StS screen will appear on your display, in
  287.         living black and white.  The system defaults are set to direct
  288.         screen writes which allow the program to operate on any type of
  289.         IBM display compatible system.  If your machine is not IBM display
  290.         compatible, you will need to specify the /B switch on the DOS command
  291.         line to force StS to use BIOS screen writes.   ie. STS /B
  292.  
  293.              Users of very old IBM CGA cards may experience display "fetches"
  294.         or "snow" on the display when StS is running.  StS has a snow
  295.         suppression option which may be used to correct this problem.
  296.  
  297.         ---------------------------------------------------------------------
  298.         To turn snow suppression on:
  299.  
  300.         (1.) Press the <Alt> <S> key pair to go into setup mode.
  301.         (2.) Press the <F1> function key to set Screen and Mouse settings.
  302.         (3.) Press the <F1> function key to toggle Snow suppression < ON>
  303.         (4.) Press the <Esc> key when you are finished playing with the other
  304.              options.
  305.         (5.) Press the <F4> key to save the change and exit setup mode.
  306.         ---------------------------------------------------------------------
  307.                                                                         1-3
  308.  
  309.         >> Sec. 1.4          HOW TO FULLY TUNE STEREO SHELL
  310.         _____________________________________________________________________
  311.  
  312.              This section will outline the operation of Stereo Shell's tuning
  313.         control center.  To fully exploit the power of StS, it is important
  314.         that you understand the setup procedure.
  315.  
  316.              To enter the setup area, press the <Alt> <S> key pair.  You
  317.         should see a screen with five windows.  In the upper left hand corner
  318.         is a main menu area that provides access to the various other menus
  319.         in the setup routine.  We will examine each option in detail.
  320.  
  321.             * IF THE SETUP PROGRAM FAILS TO EXECUTE *
  322.         Make sure the setup program STSETxxx.EXE is present either in the left
  323.         window of the StS display or anywhere in the DOS path. (see above)
  324.         Make sure the setup program matches the version of StS that you have.
  325.         For example StS version 4.00 will have a setup program named
  326.         STSET400.EXE.  If you have edited the DOS path command in the
  327.         AUTOEXEC.BAT file, it may be necessary to re-boot the machine to make
  328.         the change effective.
  329.  
  330.  
  331.         >> Sub Sec. 1.4.1        SCREEN AND MOUSE OPTIONS
  332.         _____________________________________________________________________
  333.  
  334.         (F1) Screen and Mouse settings allow you to set various operational
  335.              parameters.  The sub-menu options are listed below.
  336.  
  337.              (F1) Snow suppression.
  338.                       This option is provided for users of older IBM display
  339.                   adapters.  It prevents flicker when the screen is updated
  340.                   while in direct video mode.  If you have an older display
  341.                   adapter you will want to toggle this option ON.  To toggle
  342.                   the option simply press the <F1> key.  If you do not have
  343.                   a snow problem, leave this option off for fastest operation.
  344.  
  345.              (F2) Exploding windows.
  346.                       Looks sharp and makes noise.  Toggle it by pressing <F2>
  347.  
  348.              (F3) Date/Time display.
  349.                       For users who find the ticking clock irritating or for
  350.                   those who don't know or care what time or day it is.
  351.                   Toggle by pressing <F3>.
  352.  
  353.              (F4) Sound effects.
  354.                       Enables or disables all sound effects in StS.
  355.  
  356.              (F5) Hidden files displayed.
  357.                       When < ON> StS will "see" and display hidden files that
  358.                   reside on your disks.  Hidden files will carry a small "h"
  359.                   hi-lighted by the date field in the list.
  360.                                                                         1-4
  361.  
  362.              (F6) Screen saver. (3 modes)
  363.                       The StS screen saver will clear the video display to
  364.                   black after ten minutes of keyboard inactivity.  Unlike the
  365.                   other options in this section, the screen saver is a 3 mode
  366.                   option.  The (OFF) mode will disable the feature entirely.
  367.                   The ( ON) mode will simply clear the screen to black.  The
  368.                   (MSG) mode will randomly "bounce" a message around on the
  369.                   screen prompting the user to press a key.  The screen saver
  370.                   is only in effect when the StS screen is active.  It will
  371.                   NOT blank the screen while the user is executing another
  372.                   application from Stereo.  The screen saver is also a simple
  373.                   "clear the screen to black" type, it does no fancy or dan-
  374.                   gerous tricks with the video display adapter.
  375.  
  376.              (F7) Wrap around file windows.
  377.                       If on, the file and directory windows will allow the
  378.                   cursor to wrap around from top to bottom, bottom to top
  379.                   when the cursor moves past the first/last file.  When the
  380.                   wrap around occurs, the speaker will beep to indicate it.
  381.  
  382.              (F8) Mouse sensitivity.
  383.                       Does not refer to the emotional state of the rodent.
  384.                   This option is provided to allow the user to adjust the
  385.                   speed of the mouse.  To set this value, press <F7> which
  386.                   will print instructions and the current value.  Use the
  387.                   <+> and <-> keys to change the value, press <CR> when
  388.                   you are satisfied.
  389.  
  390.              <Esc.>  Press the <Esc> key to return to the main menu.
  391.  
  392.  
  393.  
  394.         >> Sub Sec. 1.4.2           COLOR SETUP
  395.         _____________________________________________________________________
  396.  
  397.         (F2) Color Setup (main screen)
  398.              This option allows the user to set the screen window colors.
  399.         Use the number keys listed in the menu to set your desired screen
  400.         colors and press <CR> when satisfied.  We have provided a "magic key"
  401.         (key #9) that will give you a default color setup to examine.
  402.              The setting of the colors abides by the following sequence.
  403.         [ black, blue, green, cyan, red, magenta, brown, white ]
  404.              Foreground colors will cycle through 16 shades of these colors
  405.         while background colors use only the low intensity 8.
  406.  
  407.          (F3) Color Set (borders)
  408.              This option allows the user to adjust the border colors and
  409.          hi-lite bar color.  Its operation is identical to (F2) above.
  410.                                                                         1-5
  411.  
  412.         >> Sub Sec. 1.4.3           FILES/EXTERNAL SETUP
  413.         _____________________________________________________________________
  414.  
  415.         (F4) Files/external setup
  416.              StS interfaces to various external programs to allow the user to
  417.         process compressed files, edit files, and more.  This option will
  418.         allow you to define the programs and location of these programs on
  419.         your system.
  420.              First we need to define some general rules for the program
  421.         descriptions.  These rules apply to all programs defined under the
  422.         option.
  423.  
  424.                     GENERAL RULES FOR EXTERNAL FILE SPECIFICATION
  425.  
  426.         (1.)  Include the drive letter.  Unless you absolutely plan to use
  427.               StS only on one drive you will need to include a drive letter
  428.               on all program descriptions.
  429.  
  430.         (2.)  Include the full and complete path from the root.  StS uses the
  431.               MS-DOS EXEC function to run these programs.  The EXEC function
  432.               does not search for the user defined PATH= string in the
  433.               environment so you must explicitly tell StS where the file is
  434.               located.
  435.  
  436.         (3.)  Include the complete filename with the extension.  The EXEC
  437.               function does not assume a .COM or .EXE extension as does DOS
  438.               itself.  If the extension is not provided StS will be unable to
  439.               execute the program.
  440.  
  441.         Example:
  442.                    Assume that my editor (E88.EXE) was located in a sub-
  443.               directory I call GREAT which is itself a sub-directory of
  444.               EDITORS located on my hard disk drive c.
  445.                    My string to define the Editor utl would be:
  446.               C:\EDITORS\GREAT\E88.EXE
  447.  
  448.         (4.)  In StS version 4.00+, the Editor, Viewer, User programs, and
  449.               Launch programs are all defined with a virtually identical
  450.               screen layout.  There is an on-screen help box which gives
  451.               a brief description of each item needed in the setup.  A less
  452.               brief description will now be provided.
  453.  
  454.               Path\name.ext: This is the path and name of the program to
  455.                              run as an external.  Be sure to abide by
  456.                              notes 1,2, and 3, above when defining this
  457.                              item.  An example of the proper use of this
  458.                              item would be when defining the editor pro-
  459.                              gram as shown in note 3 above.
  460.                                                                         1-6
  461.  
  462.               Parameters...: Parameters are also known as command line
  463.                              switches.  Many programs accept command
  464.                              line switches when they are executed from
  465.                              the DOS prompt.  An example would be the /h
  466.                              switch in E88 which causes the program to
  467.                              run in 43 line EGA mode.  Building on the
  468.                              example under note 3 above, to run E88 from
  469.                              the DOS command line in 43 line EGA mode we
  470.                              would type: C:\EDITORS\GREAT\E88.EXE /h  To
  471.                              run E88 from StS in 43 line mode, the /h
  472.                              would be placed in the Parameter field.  In
  473.                              some cases, the user may desire to run a
  474.                              program with different switches and choose
  475.                              those switches at runtime.  StS provides a
  476.                              special technique to allow this.  Placing a
  477.                              question mark in the parameter field will
  478.                              cause StS to prompt for the parameters each
  479.                              time the program is executed.
  480.  
  481.               Pass filename: Many programs can accept a filename on the
  482.                              DOS command line.  Editors such as E88 are
  483.                              a great example of this fact.  If a filename
  484.                              is passed to E88 it will automatically load
  485.                              that file for editing.  Continuing with our
  486.                              example above, a DOS command line for E88 could
  487.                              be: C:\EDITORS\GREAT\E88.EXE /h STS.DOC  where
  488.                              STS.DOC would be the file to be edited.  Stereo
  489.                              Shell will automatically pick up the filename
  490.                              from the highlight bar on the screen and pass it
  491.                              to the external program if 'Y' is selected for
  492.                              the Pass filename option.
  493.  
  494.               Pass name 1st: The "standard" method for passing parameters and
  495.                              filenames to a program on the DOS command line
  496.                              is to pass the parameters before the filename as
  497.                              is shown in our E88 example.  Notice the /h
  498.                              comes before the filename.  Some programs do not
  499.                              abide by this protocol and StS provides an
  500.                              option to reverse the order in which the
  501.                              parameters and filename are passed.  A program
  502.                              such as the popular LIST.COM from Buerg is an
  503.                              example of a program which wants the filename
  504.                              before any command line switches.  Normally the
  505.                              Pass name 1st option should be set to 'N' but
  506.                              if the options do not work, try reversing the
  507.                              order by answering 'Y' to this option.
  508.  
  509.               Pause........: The pause option will cause StS to display a
  510.                              "Press any key" prompt before it destroys the
  511.                              screen and continues normal operations.  This
  512.                              option is provided to allow users to read the
  513.                              screen output from programs that print infor-
  514.                              mation and terminate.  The DOS utility CHKDSK
  515.                              is an example.  Without the pause, it would be
  516.                              impossible to read the results from CHKDSK.
  517.                                                                         1-7
  518.  
  519.               Menu wording.: This option applies only to USER programs.  The
  520.                              text string defined here is the string that will
  521.                              appear on the USER menu when StS is running.
  522.                              Use this option to describe the USER program.
  523.                              For example if I decide to set up a file finder
  524.                              program as a USER program, I would write some-
  525.                              thing like "File finder program." in for the
  526.                              Menu wording.
  527.  
  528.               Extension key: This item applies only to the LAUNCH programs.
  529.                              A LAUNCH program is an application which StS
  530.                              can execute for the user when he selects a file
  531.                              with an extension that matches a data file
  532.                              extension for that program.  For example, most
  533.                              BASIC programs carry the filename extension of
  534.                              .BAS.  StS can be set up to optionally run BASIC
  535.                              and load the highlighted .BAS file.  In other
  536.                              words BASIC can be "launched" because the user
  537.                              selected a .BAS file.  The extension key defines
  538.                              the filename extension that will activate the
  539.                              LAUNCH option on the General Files Menu.
  540.  
  541.  
  542.              Now that we have the general rules down, lets examine the
  543.              specific options and types of external programs StS supports.
  544.  
  545.  
  546.              (F1) Editor program.
  547.                   The editor may be ANY user defined text editor or word
  548.                   processor.  StS provides an option to edit files on its
  549.                   file menus.  When the edit option is selected,  StS will
  550.                   execute the editor program defined here.  The editor should
  551.                   be capable of accepting a filename on the command line.
  552.  
  553.              (F2) Viewer program.
  554.                   The viewer definition is optional.  The user may define any
  555.                   external view program in a manner similar to the editor
  556.                   definition above.  If the viewer is not defined by the user,
  557.                   StS will use its internal viewer routine.
  558.  
  559.              (F3) COMPRESSION programs.
  560.                   Selecting this option will open another menu window which
  561.                   allows one to select the particular compression program to
  562.                   set up.   Once a type such as .ZIP is selected, a setup
  563.                   screen for that program appears.  In general, the user
  564.                   should abide by the general rules for defining external
  565.                   programs as outlined above and also follow the on-screen
  566.                   help box.  The intricacies of defining each compression
  567.                   program command will not be discussed at this time.  Please
  568.                   see Appendix A in this .DOC file for details of the
  569.                   compression program setup.
  570.         * * NOTICE * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
  571.         *
  572.         * Please see Appendix A in this .DOC file for information about
  573.         * changing the actual file compression program commands.  Do not
  574.         * attempt to change these strings before reading Appendix A.
  575.         *
  576.         * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
  577.                                                                         1-8
  578.  
  579.              (F4) USER programs.
  580.                   The user defined utility(s) can be ANY .EXE, .COM  or .BAT
  581.                   file.  These programs can be used for a secondary editors,
  582.                   list programs, file finders, file conversion routines,
  583.                   frequently used applications, special compression commands,
  584.                   batch files for formatting floppies, custom viewers, the
  585.                   possibilities are endless.  StS version 4.00 now supports up
  586.                   to 10 user defined utilities which each have a setup screen
  587.                   accessed from the sub-menu for this option.
  588.  
  589.              (F5) LAUNCH programs.
  590.                   Although the name LAUNCH may invoke mental images of a big
  591.                   Saturn rocket sitting poised to roar off into the wild blue
  592.                   yonder, the StS launch program is much quieter and easier
  593.                   to operate.  Launchable programs allow the user to execute
  594.                   an application by selecting one of its data files.  For
  595.                   example if a LAUNCH program is defined for the .BAS filename
  596.                   extension, an extra option will appear on the General Files
  597.                   Menu that will allow the user to run BASIC and load the data
  598.                   file automatically.  Thus BASIC was launched. StS version
  599.                   4.00+ supports up to 10 LAUNCH programs which each have a
  600.                   setup screen accessed from the sub-menu for this option.
  601.  
  602.              (F6) HELP File path/name.
  603.                   This option allows the user to define the name and location
  604.                   of the StS help file.  The help file may be any ASCII text
  605.                   file.  Follow the on-screen instructions to modify this
  606.                   option.
  607.  
  608.              (F7) WORKing directory setting.
  609.                   This is the default setting for the right side of the StS
  610.                   display.  Stereo Shell uses this working directory as
  611.                   the default source and destination of files that will be
  612.                   included in, or extracted from, compressed files.  This
  613.                   setting defaults to C:\ZDIR\ and it is recommended that the
  614.                   novice user not adjust this unless it is necessary.  Unless
  615.                   your system for some reason does not have a C: drive with
  616.                   sufficient space on it, or you just can't stand the name
  617.                   ZDIR, it should not be necessary to change this path.  If
  618.                   you do decide to adjust this, please follow the instructions
  619.                   provided on the screen carefully.  Include the drive letter
  620.                   and the complete path from the root.  This directory may
  621.                   at times contain large numbers of files and should not be
  622.                   setup on a floppy disk drive.
  623.                                                                         1-9
  624.  
  625.         >> Sub Sec. 1.4.4          SAVE SETTINGS AND EXIT
  626.         _____________________________________________________________________
  627.  
  628.         (F5) Save settings and exit.
  629.              This main menu option will save the settings you have defined
  630.         and exit back to the StS main screen.  The settings are saved in the
  631.         root directory of the current disk drive in a file named
  632.         STSCFG.CFG.  In the event that you ever want to start over from the
  633.         internal program default settings, simply erase this .CFG file before
  634.         running StS.
  635.  
  636.         SETUP NOTE:  You may set each window of the StS display to sort files
  637.                      in various manners by using the <F3> function key while
  638.                      running the main program.  When you select option (F5)
  639.                      in setup mode your currently defined sort settings will
  640.                      be saved.  The windows will then "come up" sorted as you
  641.                      have them defined each time you execute StS.
  642.  
  643.  
  644.         NOTE: An environment variable setting is provided to allow the user to
  645.               "hard code" the configuration file name and location.  This
  646.               feature will allow you purists out there to put the config-
  647.               uration file in some place other than the root directory.
  648.               This also allows users who desire to run STS from various
  649.               disk drives to ensure that STS will always be able to find the
  650.               setup file
  651.  
  652.               The string is:  SET STS_CFG=[d:][path](filename.ext)
  653.  
  654.           Note: Use all CAPITAL LETTERS.  It is the user's responsibility to
  655.               provide a valid drive and path specification.  If you wish
  656.               to place your config file in a different place but do not
  657.               want to go through the setup procedure again, first copy your
  658.               present config file to the place where you want it and then
  659.               set the string to point at it.  If you rename it, make sure
  660.               the string contains the proper name.  STS will use the
  661.               SET= data if found, otherwise it will default to the current
  662.               root and the default name.
  663.  
  664.           Example:  If I wanted my config file to be located in a
  665.               sub-directory I have named STEREO, I would add this string to
  666.               my AUTOEXEC.BAT file.   SET STS_CFG=C:\STEREO\STSCFG.CFG
  667.               >> Note that I have included the complete drive, path, and
  668.               filename.  This is necessary!
  669.  
  670.  
  671.         >> Sub Sec. 1.4.5                EXIT NO SAVE
  672.         _____________________________________________________________________
  673.  
  674.         (F6) or <Esc.>  Exit NO save.
  675.              This option will take you back to the StS main screen without
  676.         saving the changes in the STSCFG.CFG file.  This is useful for
  677.         experimenting with colors or for temporary setup changes.
  678.                                                                         2-1
  679.         _____________________________________________________________________
  680.  
  681.         >> PART 2                   USING STEREO SHELL
  682.         _____________________________________________________________________
  683.  
  684.  
  685.  
  686.         >> Sec. 2.1                   INTRODUCTION
  687.         _____________________________________________________________________
  688.  
  689.              Stereo Shell is a unique DOS shell utility program.  This
  690.         program provides two fully independent file/directory displays which
  691.         enable it to provide extremely powerful, yet simple, file handling
  692.         functions.  The twin, or if you will, stereo display allows the user
  693.         to perform file operations such as move and copy between any two
  694.         drives, or directories, or combinations of drive/directories on the
  695.         machine without ever typing a file or path name.
  696.  
  697.              Stereo Shell was also intended to be a fast, simple, and
  698.         user friendly program to handle the otherwise tedious task of working
  699.         with compressed files.  StS takes a fresh approach to this task in
  700.         that it uses a separate directory and split screen display to isolate
  701.         and monitor the files associated with a compressed file.
  702.  
  703.              StS provides intelligent, easy to use menus for handling file
  704.         and compressing functions.  These menus are intelligent in that the
  705.         menu that appears on the screen for the user is based on the filename
  706.         extension of the file selected.  For example, selecting a .ZIP file
  707.         from the directory display will automatically open the file compressor
  708.         operation window.  The menu functions are of the "point-n-shoot"
  709.         variety but also allow quick execution via the function keys.
  710.  
  711.              StS supports most of the standard file and compression commands
  712.         through its menus and function keys.  The following list is provided
  713.         to give the user an idea of what StS will do.
  714.  
  715.         StS Functions                            Description
  716.  
  717.         Move file ........................ (from anywhere to anywhere)
  718.         Copy file ........................ (from anywhere to anywhere)
  719.         Rename file ...................... (standard DOS function)
  720.         Erase file ....................... (standard DOS function)
  721.         Erase read-only files ............ (asks to be sure, then zap)
  722.         Tag files ........................ (tag/untag any or all files)
  723.         Selectively tag files ............ (by name, date, archive bit etc.)
  724.         Move tagged files  ............... (very fast and smooth)
  725.         Copy tagged files  ............... (from anywhere to anywhere)
  726.         Erase tagged files ............... (prompted super zap)
  727.         Add tagged to library file ....... (build a compressed file)
  728.         Convert tagged to another format . (block convert your library files)
  729.         Execute user program on tagged ... (run any program repeatedly on tag)
  730.         View file ........................ (built in dual mode viewer)
  731.         View file ........................ (user defined optional ext. viewer)
  732.         Edit file ........................ (user defined editor/Wp)
  733.                                                                         2-2
  734.  
  735.         File attribute modify ............ (change dates times and attributes)
  736.         User file function ............... (10 user defined utility programs)
  737.         Launch applications .............. (10 launchable applications)
  738.         Execute program .................. (.EXE, .COM, .BAT, .BTM files)
  739.         Instant executable filter ........ (see only .EXE,.COM,.BAT, and .BTM)
  740.         Quick find filename .............. (intelligent search within dir.)
  741.         Change drive ..................... (with a single keystroke)
  742.         Change drive ..................... (from DOS menu. Allows A-Z drives)
  743.         Change alternate drive ........... (changes un-hooked side)
  744.         Change alternate drive ........... (from DOS menu. Allows A-Z drives)
  745.         Change directory ................. (fast, easy, sidebar technique)
  746.         Directory tree ................... (display tree to change dirs.)
  747.         Make directory ................... (from DOS command menu)
  748.         Sort options ..................... (sort each window independently)
  749.         Remove directory ................. (use <F10> or <Alt><F10>)
  750.         File comment system .............. (4DOS(tm) compatible comment sys.)
  751.         DOS command ...................... (run any DOS command from StS)
  752.         DOS gateway ...................... (type EXIT to return)
  753.  
  754.         Supports .ZIP .ARC .LZH .PAK .ARJ formats -----|
  755.         Create compression                             |
  756.         Extract files                                  |- Compression utility
  757.         Test compression                               |- command support.
  758.         View files in compression                      |- Works with up to 8
  759.         Verbose list compression contents.             |- compression progs.
  760.         Freshen files.                                 |
  761.         Update files.                                  |- Tagged file support
  762.         Delete files from compression.                 |- as well, see above.
  763.         Convert from format to format            ------|
  764.  
  765.  
  766.         >> Sec. 2.2                  THE StS DISPLAY
  767.         _____________________________________________________________________
  768.  
  769.              When StS is executed, the user is presented with a screen split
  770.         into 3 main sections.  There is a left file window that includes
  771.         a sidebar labeled Chg. Dir., and a right file window that shows
  772.         the contents of the working directory.  Near the bottom of the screen
  773.         is a title line with date/time display and also a function key guide.
  774.  
  775.              This section, explaining what the screen windows mean and do, is
  776.         probably the most important section of the .DOC file.  A complete
  777.         understanding of the StS display and the stereo directory concept will
  778.         make the remainder of the information presented here almost redundant.
  779.         The split screen/dual directory display is the key to StS's simplicity
  780.         and also what sets it apart from other DOS shell utility programs.
  781.         We will start at the top of the display and examine each main area in
  782.         detail.
  783.                                                                         2-3
  784.  
  785.              >> Sub-Sec. 2.2.1          THE FILE WINDOWS
  786.              ________________________________________________________________
  787.  
  788.                   Both file windows are dynamic.  They are capable of display-
  789.              ing the contents of any drive or directory on your machine.  The
  790.              ability to work with two fully functional displays at a time
  791.              makes for an extremely powerful file manipulation and
  792.              maintenance utility.  The user can work "between" the displays
  793.              when moving or copying files.  This unique ability eliminates
  794.              the necessity of ever typing in a path or filename.  Please
  795.              note; StS does allow you to type in paths and such for
  796.              convenience, but unless a file is being renamed or created, it
  797.              is possible to do all move and copy operations with only your
  798.              mouse or cursor keypad.
  799.  
  800.                   Information pertaining to the current file window display
  801.              is presented at various points within the window.  At the top
  802.              center of each file window, actually on the border, StS displays
  803.              a VOLUME = message.  This will always show the disk drive to
  804.              which the window is currently assigned.  The drive:path at which
  805.              the window is currently pointed is displayed in the top title
  806.              area of the window.  In the center or main section is the
  807.              familiar filename-size-date display.  An occasional hi-lighted
  808.              block containing a lower-case s, r, or h may also appear just to
  809.              the left of the date on some files.  This indicates that the file
  810.              has special attribute(s) assigned to it on the disk. r,s, and h
  811.              refer to read-only, hidden, and system files respectively.  In
  812.              cases where the file has more than one of these attributes set
  813.              only the most important will appear with the hierarchy being h,
  814.              r, s.  Also note that several filenames may also show a small
  815.              dot to the immediate right of the file size.  This dot indicates
  816.              that the file archive bit is set.  File attributes and their
  817.              meanings are discussed later in this manual under the General
  818.              File option command menu.
  819.  
  820.                   The filename display will list the files present on disk
  821.              in sorted order depending on the sort option chosen by the user.
  822.              Sort types of file/ext, ext/file, date, size, and unsorted are
  823.              supported and selected by pressing <F3> which opens a menu from
  824.              which the sort type/criteria may be selected.  The sort that has
  825.              been defined for each window is saved when the setup is saved
  826.              in setup mode.  In the bottom title area the free disk space
  827.              for the selected drive is shown.  The sort type, file size, date,
  828.              and attributes are shown on the bottom border areas.
  829.                                                                         2-4
  830.  
  831.              >> Sub-Sec. 2.2.2         THE CHG. DIR. WINDOW
  832.              ________________________________________________________________
  833.  
  834.                   In the center of the display is a narrow vertical window
  835.             titled Chg.Dir.  This window area is used to display
  836.             sub-directory information and allow you to easily move around
  837.             on the disk(s).
  838.  
  839.                   A brief definition is in order here to explain a bit of
  840.             Stereo Shell jargon:.... "Hooked" refers to the appearance of
  841.             the directory window as it is graphically displayed on the
  842.             screen.  When the Chg.Dir. window is hooked to a file window, it
  843.             appears to be connected to the file window and will form a
  844.             continuous outer boundary.  If the left and right file windows
  845.             are in different colors, the Chg.Dir. window will assume the
  846.             color of the file window to which it is hooked.
  847.  
  848.                   The Chg.Dir. window always displays the sub-directories
  849.             of the file window currently hooked.  Pressing the left and right
  850.             arrow keys or moving the mouse will allow the user to hook the
  851.             Chg.Dir. window to either file window so long as there is file or
  852.             directory information available to be read from that drive.  StS
  853.             logic prevents the user from placing the cursor in a completely
  854.             blank window and thus will not allow a hook when a disk is
  855.             completely blank and contains no sub-directories.
  856.  
  857.                   The Chg.Dir. window, or directory sidebar window is a unique
  858.             feature of StS and provides the user with the means to zip
  859.             around on the disk.  The change directory sidebar window
  860.             displays, in sorted order, the sub-directories associated with
  861.             the currently hooked file window.  Separating the directories
  862.             from the filename list and providing the user with a scrollable
  863.             sorted listing, gives StS one of the fastest, easiest, and
  864.             most convenient methods of changing directories available.  By
  865.             simply placing the "light bar" on the directory you want and
  866.             pressing [ENTER], you can move anywhere on the disk.
  867.  
  868.             One feature of the directory display may not be familiar to some
  869.             users and requires some explanation here.  If you are displaying a
  870.             sub-directory listing, you will notice that the first directory
  871.             in the Chg. Dir. sidebar window appears as two dots (..).  These
  872.             two dots are the link to the parent of that sub-directory.
  873.             Selecting the double dot directory will take you "up a notch"
  874.             thus, this is the means to go backwards on the tree.  This is the
  875.             standard DOS method to do this job, not something that was
  876.             created by the author.  In fact many users will be delighted to
  877.             know that this works from the DOS prompt.  Anytime you are in a
  878.             sub-directory, entering CD..  at the DOS prompt will cause you
  879.             move up to the parent directory.
  880.                                                                         2-5
  881.  
  882.                   Stereo Shell also has the ability to display the tree
  883.             style directory structure of a drive.  This display is summoned
  884.             by pressing the space bar, the insert key, or both mouse buttons
  885.             while the light bar cursor is in the center window.  The "classic"
  886.             tree structure display, although not as fast and efficient as
  887.             StS's native sidebar technique for changing directories, is
  888.             useful for providing an overview of a drive layout.  This feature
  889.             is particularly nice when running the shell on a machine which is
  890.             unfamiliar to the user.
  891.  
  892.                   In the bottom title area of the Chg.Dir. window the total
  893.             of all marked (tagged) files for the currently hooked directory
  894.             is displayed.  One quick trick worth mention here is the fact
  895.             that the user can mark all files in the window and quickly find
  896.             the total disk space occupied by the files.  See the INS and DEL
  897.             keys for the mark/un-mark all feature.
  898.  
  899.  
  900.  
  901.             >> Sub-Sec. 2.2.3      THE TITLE AND FUNCTION KEY AREA
  902.             ________________________________________________________________
  903.  
  904.                   Across the bottom of the StS display the user finds a
  905.             program title/version/copyright and date/time line.  Below that
  906.             is a function key guide.  This is a standard function key help
  907.             line and shows an abbreviated command for each F-key.
  908.             Keys F8 and F10 may be used to rename and erase directories as
  909.             well as files.  DOS 3.xx+ is required to rename a directory.
  910.  
  911.  
  912.         >> Sec. 2.3            StS DIRECT KEYS AND COMMANDS
  913.         _____________________________________________________________________
  914.  
  915.                   This section will describe the direct key functions
  916.             available to the StS user when file selection is in effect.
  917.  
  918.  
  919.              >> Sub-Sec. 2.3.1       THE CURSOR AND SCREEN KEYS
  920.              ________________________________________________________________
  921.  
  922.                   The cursor and screen keys provide the user with the means
  923.             to select files and directories.  Here we will list all the
  924.             active keys in this group and detail what they do.
  925.  
  926.  
  927.              > Left and Right arrow keys <
  928.  
  929.                   The left and right arrow keys select the screen window.
  930.             The selected window will contain a "light bar" cursor.  The
  931.             arrow keys wrap around between windows and all empty windows are
  932.             skipped.
  933.  
  934.             > Up and Dn arrow keys <
  935.  
  936.                   The up and down arrow keys allow the user to select a file
  937.             or directory within a window.  These keys move the cursor and
  938.             also scroll the display when on the edge.  The speaker will beep
  939.             when the first and last entry in the window is reached.
  940.                                                                         2-6
  941.  
  942.             > Home and End keys <
  943.  
  944.                   The home and end keys will instantly scroll the selected
  945.             window to the first and last entry in the window and place the
  946.             light bar on it.
  947.  
  948.  
  949.             > PgUp and PgDn <
  950.  
  951.                   The page up and page down keys will instantly scroll the
  952.             selected window display one page up or down.
  953.  
  954.             > The tab key. <
  955.  
  956.                   The tab key will move the cursor between windows.
  957.  
  958.  
  959.             >> Sub-Sec. 2.3.2     THE LETTER, NUMBER, AND MARKING KEYS
  960.             ________________________________________________________________
  961.  
  962.                   The letter and number keys serve a very important role in
  963.             the StS user interface.  This section explains their use.
  964.  
  965.  
  966.             > The letter keys; A,B,C,D, etc <
  967.  
  968.                   The letter keys are used for a "QUICK FIND" scroll.
  969.             Pressing a letter key will find a filename, extension, or
  970.             directory beginning with the letter that is nearest to, without
  971.             exceeding the letter that was pressed.  This QUICK FIND is based
  972.             on either the filename or extension depending on what the user
  973.             has selected as the primary sort, ie. filename/ext or ext/file-
  974.             name.  QUICK FIND also has some built in intelligence.  If all
  975.             the files in a directory have extensions that begin with the same
  976.             same letter, and you are sorting by extension, then the QUICK
  977.             FIND automatically switches to a filename find.  This switching
  978.             allows users to set up directories containing files which are
  979.             all of the same type and still be able to use QUICK FIND to
  980.             advantage.  QUICK FIND is disabled if you have selected any sort
  981.             other than file/ext or ext/file.
  982.  
  983.                   Pressing a letter key more than once will cause the cursor
  984.             to go to the next file starting with that letter and so on until
  985.             the last file is found.  Pressing the same letter key twice on
  986.             the last file will cause the cursor to again go to the first
  987.             file and start back down the list.
  988.  
  989.                   Valid keys for the QUICK FIND are A-Z.
  990.  
  991.             > The number keys; 1,2,3 etc. <
  992.  
  993.                   The number keys allow the StS user to select the disk
  994.             drive for display in the hooked window.  Upon execution, StS
  995.             requests drive information from DOS and assigns the number keys 1-
  996.             9 to access the correct drive letters.  The keys are assigned as
  997.             1=A: 2=B: etc.  If you press an unassigned number key StS will
  998.             respond with a beep.
  999.                                                                         2-7
  1000.  
  1001.                   Pressing a number key will change the hooked window to the
  1002.             drive specified.  The user can change the other side ( the
  1003.             un-hooked side ) by using <Alt> <1,2,3,etc.>. Users with more
  1004.             drives than are accessible with the number keys may select these
  1005.             drives from the DOS menu.
  1006.  
  1007.              > The <Alt> number keys; <Alt>1,2,3 etc. <
  1008.  
  1009.                   The combination of <Alt> and the number keys 1,2,3, etc.
  1010.             will allow the user to change the un_hooked file window to
  1011.             another drive.  This is a very important feature due to one of
  1012.             the idiosyncrasies of stereo windows.  If you have a window
  1013.             pointed at say, a blank, formatted floppy disk, there is no way
  1014.             to hook to that window because it is totally blank.  Pressing
  1015.             <Alt> 1,2,3 will allow the user to change the drive of that
  1016.             window without ever hooking to it.  A good way to remember this
  1017.             command is to always think of the un-hooked window as the
  1018.             alternate window and hence <Alt> key controlled.
  1019.  
  1020.                   Users with more drives than are accessible with the number
  1021.             keys may select these drives from the DOS menu.
  1022.  
  1023.             > The space bar. <
  1024.  
  1025.                   The space bar will mark or unmark (tag) a file for
  1026.             subsequent copy or erase activity.  The marked file is indicated
  1027.             by a small diamond displayed at the end of the filename
  1028.             extension.
  1029.                   The space bar also serves a function in the Chg. dir.
  1030.             window.  If pressed while the cursor is in the Chg. dir. window
  1031.             StS will display a tree structure of the drive.
  1032.  
  1033.             > The Ins. and Del. keys. <
  1034.  
  1035.                   The insert and delete keys will instantly mark or un-mark
  1036.             all files in a directory window.
  1037.                   The Ins. & Del. keys also serve a function in the Chg. dir.
  1038.             window.  If pressed while the cursor is in the Chg. dir. window
  1039.             StS will display a tree structure of the drive.
  1040.  
  1041.             > The backspace and asterisk keys <  (executable file filter)
  1042.  
  1043.                   The backspace or asterisk key will instantly filter out all
  1044.             the "trash" files in a sub-directory and leave the display showing
  1045.             only the executable files with extensions of .EXE, .COM, .BAT, and
  1046.             .BTM.   This is useful for quickly locating programs to run and
  1047.             eliminating the data files.  This is a toggle function, push the
  1048.             key to again show all files.
  1049.                                                                         2-8
  1050.  
  1051.             > The [Alt] [C] key. <   (4DOS(tm) file comment system)
  1052.  
  1053.                   This key pair will display any existing file comment which
  1054.                   may then be edited by the user.  If no file comment exists,
  1055.                   a comment may be created and saved via this entry system.
  1056.                   Stereo Shell maintains the file comments in a normally
  1057.                   hidden file named DESCRIPT.ION in the same sub-dir. as the
  1058.                   files being commented.  File descriptions are moved, copied,
  1059.                   renamed, deleted, etc. as the operations are carried out on
  1060.                   the files themselves.  The Stereo Shell file comment system
  1061.                   is 100% 4DOS (tm) compatible and has been implemented with
  1062.                   the permission of JP Software the creators of 4DOS.  4DOS
  1063.                   is not required to use the StS file comment system.
  1064.  
  1065.             > The [Alt] [D] key. <   (DOS command/gateway)
  1066.  
  1067.                   This key pair will open a dialogue window which will allow
  1068.                   the user to either execute a DOS command directly or to
  1069.                   "gateway" to DOS.  Entering nothing on the command line
  1070.                   will open the gateway.  The drive/directory that will be
  1071.                   considered "current" by DOS when the command is issued is
  1072.                   displayed in the window.
  1073.  
  1074.             > The [Alt] [E] key. <   (enhanced display)
  1075.  
  1076.                   This key pair will switch the StS display resolution on
  1077.                   MCGA, EGA, or VGA equipped systems.  Three modes are sup-
  1078.                   ported on the MCGA and VGA, two are available on the EGA.
  1079.  
  1080.             > The [Alt] [H] key. <   (help)
  1081.  
  1082.                   This key pair will load the user defined StS help file and
  1083.                   display it with the viewer.  The location and name of the
  1084.                   help file may be defined in the StS setup.
  1085.  
  1086.             > The [Alt] [Q] key. <   (quit)
  1087.  
  1088.                   This key pair is the fastest way to exit from StS.  When
  1089.                   pressed, this key combination will return the user to DOS
  1090.                   and restore the drive/directory that was current when StS
  1091.                   was executed.
  1092.  
  1093.             > The [Alt] [R] key. <   (reset)
  1094.  
  1095.                   This key pair will reset the right side to the work dir.
  1096.  
  1097.             > The [Alt] [S] key. <   (setup)
  1098.  
  1099.                   This key pair will run StS's integrated external setup
  1100.                   program.  The setup program must reside somewhere in the
  1101.                   DOS path and its name must match the version of StS.  For
  1102.                   example the setup program for StS version 4.00 would be
  1103.                   STSET400.EXE
  1104.                                                                         2-9
  1105.  
  1106.             > The [Alt] [T] key. <   (time check)
  1107.  
  1108.                   This key combination will toggle the hooked window display
  1109.                   mode between size/date and date/time mode.  The window mode
  1110.                   for each window can be saved by saving the setup with
  1111.                   the windows set as desired.
  1112.  
  1113.  
  1114.             >> Sub-Sec. 2.3.3            THE COMMAND KEYS
  1115.             ________________________________________________________________
  1116.  
  1117.                   The command keys open an StS menu.  This section outlines
  1118.             the use of the command keys.
  1119.  
  1120.  
  1121.             > The Enter key <
  1122.  
  1123.                   The carriage return or enter key is used to select a file
  1124.             or directory.  In the case of a directory selection, StS will
  1125.             immediately change and display the new directory in the hooked
  1126.             window, and any associated sub-directories in the Chg. Dir.
  1127.             sidebar area.  In the case of a file selection, StS will open
  1128.             the appropriate menu to work with that file based on the filename
  1129.             extension.  A .ZIP or .ARC file opens the compression menu.  A
  1130.             .EXE .COM or .BAT file opens the EXE COM BAT window.  And the
  1131.             selection of any other file extension opens the GENERAL file menu.
  1132.  
  1133.  
  1134.             > [F1], [+], or [Esc] keys <
  1135.  
  1136.                   Pressing the F1, +, or Esc. keys opens the DOS menu.  The
  1137.             DOS window is described in detail in the following sections, but
  1138.             for now, this is how it is accessed.
  1139.  
  1140.                    It was decided to use so many keys to do this job for
  1141.             several reasons.  F1 and Esc. are the keys most users
  1142.             instinctively think of as the method to escape from, or get help
  1143.             in using, a program.  So, they were both used here.  F1 has the
  1144.             added nicety of being the first command in the DOS window,
  1145.             namely, EXIT to DOS.  By pressing F1 repeatedly the user can
  1146.             quickly exit from StS.  The plus key was chosen for its location.
  1147.             Since most keyboards have a large plus key located near the
  1148.             numeric keypad (cursor control) area, using the plus key as a
  1149.             substitute for Esc. allows one handed operation of StS.
  1150.             The plus key works as a replacement for Esc. everywhere in StS
  1151.             except when the program is prompting for a filename.  Since the
  1152.             user has full cursor control, an ENTER key, and a plus key, all
  1153.             located in one bundle on the standard keyboard, the user can
  1154.             almost operate StS with just one hand.
  1155.                                                                         2-10
  1156.  
  1157.             > The other active function keys <
  1158.  
  1159.                   Several other function keys are active when StS is in
  1160.             file selection mode.  Here is a description of their functions.
  1161.  
  1162.             [F2]   Function key F2 calls either the marked file option menu or
  1163.                    a marking criteria menu depending on whether there were
  1164.                    files marked when F2 was pressed.  The marking criteria
  1165.                    menu will allow the user to define how files in the window
  1166.                    are to be marked.  This menu is discussed in more detail
  1167.                    later in this document.  The marked file option menu will
  1168.                    allow the user to to move, copy, erase, etc. files that
  1169.                    have been tagged.
  1170.  
  1171.             [F3]   Function key F3 will open a menu of possible sort types
  1172.                    from which the user may select.  Upon selection of a sort
  1173.                    type the file window is re-sorted and displayed.
  1174.  
  1175.             [F4]   Function key F4 will immediately open the user defined
  1176.                    file utility menu which will allow you to select a
  1177.                    pre-defined utility program to run.  Please see part 1 for
  1178.                    information on defining these utilities.
  1179.  
  1180.             [F5]   Function key F5 will immediately execute the user defined
  1181.                    edit utility program, passing to it, the filename beneath
  1182.                    the cursor.  Please see part 1 for information on defining
  1183.                    this utility.
  1184.  
  1185.             [F6]   Function key F6 will immediately execute the internal
  1186.                    view utility program.  The Stereo Shell view utility will
  1187.                    analyze the filename extension and appear either in HEX
  1188.                    mode or ASCII mode.  Pressing the space bar will switch
  1189.                    modes.  Please see the later section on StS view.
  1190.  
  1191.             [F7]   Function key F7 will allow the user to move a file to any
  1192.                    other directory.  When F7 is pressed, the lower screen
  1193.                    will be overlaid with a dialogue box requesting that the
  1194.                    user enter a new path filename to move to.  The currently
  1195.                    selected file will be displayed in the top left corner
  1196.                    of the box window.  If only a path is specified, the file
  1197.                    will be moved to the new location using the same name.
  1198.                    If a new name is specified, the file will be moved and
  1199.                    renamed in one operation.
  1200.                    * * * As a special feature of StS, if nothing is
  1201.                    specified, and the user simply presses ENTER, the file
  1202.                    is moved between the currently displayed windows.  If
  1203.                    the user is in the left window the file will be moved to
  1204.                    the right window and vice-versa.  Pressing Esc. while
  1205.                    being prompted for input will cancel the operation.
  1206.                                                                         2-11
  1207.  
  1208.             [F8]   Function key F8 will allow the user to rename a file.
  1209.                    When F8 is pressed, the lower screen will be overlaid with
  1210.                    a dialogue box requesting the new filename.  The currently
  1211.                    selected file will be displayed in the top left corner
  1212.                    of the box window. * * * F8 also serves as a move file
  1213.                    command.  If a valid path is entered without a filename
  1214.                    then the file is simply moved to the new location.  If a
  1215.                    path and filename are entered, the file is both moved and
  1216.                    renamed in one operation!  If only the filename is given,
  1217.                    the file is simply renamed.   Pressing Esc. while being
  1218.                    prompted for input will cancel the operation.  F8 can also
  1219.                    be used to rename directories if using DOS 3.00+.
  1220.  
  1221.             [F9]   Function key F9 will allow the user to copy a file to any
  1222.                    drive or directory.  When F9 is pressed, the lower screen
  1223.                    will be overlaid with a dialogue box requesting that the
  1224.                    user enter a new [d:] [path] [filename.ext].  The current-
  1225.                    ly selected file will be displayed in the top left
  1226.                    corner of the box window.  If only a drive or path is
  1227.                    specified the file will be copied to the new location
  1228.                    under the same name.  If a new name is specified, the
  1229.                    copy of the file will use the specified name.
  1230.                    * * * As a special feature of StS, if nothing is
  1231.                    specified, and the user simply presses ENTER, the file
  1232.                    is copied between the currently displayed windows.  If
  1233.                    the user is in the left window the file will be copied to
  1234.                    the right window and vice-versa.  Pressing Esc. while
  1235.                    being prompted for input will cancel the operation.
  1236.  
  1237.  
  1238.             [F10]  Function key F10 is the erase file command.  This key
  1239.                    prompts for confirmation of the erase.  Please see the
  1240.                    next function for a more efficient way to erase files.
  1241.  
  1242.  
  1243.             [Alt] [F10]   The key combination of Alt. F10 will erase the
  1244.                    file or directory under the cursor!  In the case of a
  1245.                    file the operation simply "zaps" the file.  If  this
  1246.                    key is used to delete a directory entry, the directory
  1247.                    must be empty or StS will report the error and the
  1248.                    directory will not be removed.  Please note that a two
  1249.                    key combination was used for this function to prevent
  1250.                    accidental erasure of files.
  1251.  
  1252.             >> Sub-Sec. 2.3.4          MOUSE CONTROL
  1253.             ________________________________________________________________
  1254.  
  1255.                   Stereo Shell includes a built in mouse interface.  To use
  1256.             your mouse, a Microsoft compatible mouse driver is all that is
  1257.             required.  See your mouse documentation for information on how to
  1258.             load the mouse driver.
  1259.                                                                         2-12
  1260.  
  1261.                   The StS mouse interface emulates various keyboard keys to
  1262.             provide user control.  The key emulations are outlined below.
  1263.  
  1264.                    Left button:...... Same as <CR> key.
  1265.                    Right button:..... Same as <Esc> key.
  1266.                    Both buttons:..... Same as <Space bar>.  Hold to repeat.
  1267.                    Roll away:........ Same as <Up arrow> key.
  1268.                    Roll toward:...... Same as <Dn arrow> key.
  1269.                    Roll left:........ Same as <Lt arrow> key.
  1270.                    Roll right:....... Same as <Rt arrow> key.
  1271.  
  1272.  
  1273.             >> Sub-Sec. 2.3.5          FILENAME CONVENTIONS
  1274.             ________________________________________________________________
  1275.  
  1276.                  StS uses standard DOS filename conventions when prompting
  1277.             for input.  Items displayed in square brackets are optional
  1278.             while those displayed in parenthesis are required.  All drive
  1279.             letters must be followed by a colon and all path names must end
  1280.             in either a slash or backslash.   For more information on
  1281.             standard DOS conventions, see the DOS manual.
  1282.  
  1283.  
  1284.  
  1285.         >> Sec. 2.4                  THE DOS MENU
  1286.         _____________________________________________________________________
  1287.  
  1288.              The DOS window provides the StS user with the ability to
  1289.         perform some basic program functions such as opening the DOS gateway
  1290.         and exiting StS.  This window is opened by pressing either <Esc> or
  1291.         <+> or <F1>.
  1292.  
  1293.               This section will take the functions available in the DOS
  1294.         window and explain them in the order they appear.
  1295.  
  1296.  
  1297.         [F1]   QUIT and return to DOS.
  1298.                     This option will end StS.  Through this method, the user
  1299.                may exit back to the original load drive\directory or exit
  1300.                into either displayed window.  See also <Alt><Q> for a faster
  1301.                exit method.
  1302.  
  1303.         [F2]   ERASE working dir. files.
  1304.                     This option provides a fast and neat method to erase the
  1305.                contents of the working directory.  When selected, the files in
  1306.                the working directory will be erased.
  1307.  
  1308.         [F3]   DOS gateway/command.
  1309.                     This option opens a dialogue window which will allow
  1310.                the user to either execute a DOS command directly or to
  1311.                "gateway" to DOS.  Entering nothing on the command line
  1312.                will open the gateway.  The drive/directory that will be
  1313.                considered "current" by DOS when the command is issued is
  1314.                displayed in the window.
  1315.                                                                         2-13
  1316.  
  1317.         [F4]   CREATE a compressed file.
  1318.                      This option will allow the user to create a totally new
  1319.                compressed file.  The user will first be asked to select a type
  1320.                and then the program will prompt for the filename.  StS will
  1321.                then execute the utility and pass the create command to it.
  1322.                All files that are currently in the work dir. will be included
  1323.                in the new compression or added to any existing compression
  1324.                that has the name specified by the user.  The new file will be
  1325.                created in the currently hooked window.  Pressing Esc. while
  1326.                being prompted for the file type or filename will cancel the
  1327.                operation.  * This command invokes a sub-menu that allows I/O
  1328.                re-direction.  Please see section 2.8.1 for information
  1329.                concerning this menu.
  1330.  
  1331.         [F5]   MAKE a new sub-directory
  1332.                     This option will allow the user to make a new
  1333.                sub-directory on the disk.  The user will be prompted for the
  1334.                path and directory name.  Pressing Esc. while being prompted
  1335.                for the name will cancel the operation.
  1336.  
  1337.         [F6]   MARKED file operations.
  1338.                      This command will open the marked file operations  window
  1339.                allowing the user to do marked operations.  Please see the
  1340.                marked file menu section later in this manual.
  1341.  
  1342.         [F7]   DRIVE chg.  (hooked side)
  1343.                      This option allows the user to change the disk drive to
  1344.                which the hooked window is assigned.  Users with more logical
  1345.                disk drives than are addressable via the number key method may
  1346.                use options F7 and F8 to reach them.  StS internally bit-maps
  1347.                all valid disk drives and will only display valid letters.
  1348.                Mouse users can select drives by moving the mouse vertically
  1349.                and clicking the left button on the drive letter.
  1350.  
  1351.         [F8]   DRIVE chg.   (un-hooked).
  1352.                      This option is identical to option F7 above except that
  1353.                it allows selection of the un-hooked window.
  1354.  
  1355.         [F9]   SETUP (tune Stereo Shell)
  1356.                      Will run the internal setup program.  The use of the
  1357.                setup program is explained in part 1.
  1358.  
  1359.  
  1360.  
  1361.         >> Sec. 2.5              THE GENERAL FILE MENU
  1362.         _____________________________________________________________________
  1363.  
  1364.              The general file menu is opened when the user selects a file
  1365.         that does not have an extension of EXE, COM, BAT, ARC, ZIP, etc.  This
  1366.         section describes the options available via this window.
  1367.                                                                         2-14
  1368.  
  1369.         [F1]   VIEW the selected file.
  1370.                     This option will run the internal dual mode view utility.
  1371.                The View utility will begin in either ASCII or Hex mode
  1372.                depending on the file type selected.  Pressing the space bar
  1373.                will switch modes.  The full cursor pad or the mouse may be
  1374.                used to control the viewer.
  1375.  
  1376.         [F2]   EDIT the selected file.
  1377.                     This option will execute the user defined external editor
  1378.                or word processor program and pass the filename to it.  Please
  1379.                see part 1 for setup information.
  1380.  
  1381.         [F3]   USER defined file utility.
  1382.                     This function will immediately open the user defined
  1383.                file utility menu which will allow you to select a
  1384.                pre-defined utility program to run.  Please see part 1 for
  1385.                information on defining these utilities.
  1386.  
  1387.         [F4]   COPY the selected file.
  1388.                     This function will allow the user to copy a file to any
  1389.                drive or directory.  When this function is used, the lower
  1390.                screen will be overlaid with a dialogue box requesting that the
  1391.                user enter a new [d:] [path] [filename.ext].  The currently
  1392.                selected file will be displayed in the top left corner of
  1393.                the window.  If only a drive or path is specified the file
  1394.                will be copied to the new location under the same name.  If a
  1395.                new name is specified, the copy of the file will use the
  1396.                specified name.  * * * As a special feature of StS, if
  1397.                nothing is specified, and the user simply presses ENTER, the
  1398.                file is copied between the currently displayed windows.  If
  1399.                the user is in the left window the file will be copied to
  1400.                the right window and vice-versa.  Pressing Esc. while being
  1401.                prompted for the filename will cancel the operation.
  1402.  
  1403.         [F5]   RENAME the selected file.
  1404.                     This function will allow the user to rename a file.  When
  1405.                this function is selected, the lower screen will be overlaid
  1406.                with a dialogue box requesting the new filename.  The currently
  1407.                selected file will be displayed in the top left corner of
  1408.                the window. * * * This function also serves as a move file
  1409.                command.  If a valid path is entered without a filename then
  1410.                the file is simply moved to the new location.  If a path and
  1411.                filename are entered, the file is both moved and renamed in
  1412.                one operation!  If only the filename is given, the file is
  1413.                simply renamed.   Pressing Esc. while being prompted for input
  1414.                will cancel the operation.
  1415.  
  1416.  
  1417.         [F6]   MOVE the selected file.
  1418.                     This function will allow the user to move a file.  When
  1419.                this function is selected, the lower screen will be overlaid
  1420.                with a dialogue box requesting the new pathname.  The currently
  1421.                selected file will be displayed in the top left corner of
  1422.                the window. * This function is a variation of the rename
  1423.                command tailored specifically for moving files.  If the source
  1424.                and destination paths are on different drives, the program will
  1425.                automatically switch to a copy/delete sequence to accomplish
  1426.                the move operation.  The move command takes advantage of the
  1427.                stereo aspects of StS by allowing the user to move files
  1428.                between windows.
  1429.                                                                         2-15
  1430.  
  1431.         [F7]   ERASE the selected file.
  1432.                     The currently selected filename appears in the top left
  1433.                corner of the window.  Selecting this option will erase the
  1434.                file.  Warning: The user is not queried for a confirmation on
  1435.                the erase single file commands.  Pressing this key WILL erase
  1436.                the file.  It was felt that since this was a menu driven
  1437.                function and the key was well defined, that a confirmation
  1438.                request on the single file function would be a burden to the
  1439.                user.  In keeping with recognized DOS methods, the multiple
  1440.                file erase commands do prompt for a Y/N confirmation but the
  1441.                single file erase commands do not.
  1442.  
  1443.         [F8]   ATTRIBUTE/date editor.
  1444.                     Selecting this option will open another menu which
  1445.                displays the current file attributes, date and time and allows
  1446.                the user to change them.  To change any of the file attributes,
  1447.                simply press the appropriate function key. <F1-F4> The attrib-
  1448.                ute will be toggled off/on.  Selecting <F5> will allow the user
  1449.                to change the file's date and time.  When <F5> is pressed the
  1450.                cursor will appear on the displayed date.  At this point, three
  1451.                things can be done; (1.) Press <Esc> to exit with no change.
  1452.                (2.) Press <Enter> to automatically insert the current date/
  1453.                time. (3.) Type in the complete date/time values.  All fields
  1454.                must be entered by the user.
  1455.  
  1456.                     Four file attributes (bits) are defined by DOS to classify
  1457.                files on your disk.  The archive, system, hidden, and read only
  1458.                bits may be controlled with this option.  What follows is a
  1459.                brief description of normal bit settings.
  1460.  
  1461.                Archive: This bit is set ON by most programs that are capable
  1462.                        of changing a file. (text editors for example)  It
  1463.                        is turned off by most backup programs whenever the
  1464.                        file is backed up. (hence changed/archived)
  1465.  
  1466.                System: This bit is normally set ON only on files that relate
  1467.                        to the operating system proper.  Files such as
  1468.                        MSDOS.SYS will have this bit set.
  1469.  
  1470.                Hidden: If this bit is set ON the filename will be excluded
  1471.                        from normal directory searches by MS-DOS.  StS can
  1472.                        still "see" the file if the hidden option is < ON> in
  1473.                        the setup program.
  1474.  
  1475.                Read only: This is probably the most useful attribute from the
  1476.                        standpoint of the user.  If this bit is set ON the file
  1477.                        cannot be modified or erased by any normal means.  StS
  1478.                        has the ability to erase read-only files but will
  1479.                        prompt the user for confirmation before doing so.
  1480.  
  1481.                Examples:
  1482.                         Standard file entry:  A s h r
  1483.                         Standard r/only file: A s h R
  1484.                         Hidden file entry:    A s H R
  1485.                         Hidden system file:   A S H R
  1486.                                                                         2-16
  1487.  
  1488.         [F9]   LAUNCH .xxx application.
  1489.                     This option only appears when a file with an extension
  1490.                that matches an extension defined for a launchable application
  1491.                has been selected by the user.  Selecting this option will
  1492.                launch the application and pass it the filename on the
  1493.                command line.  Please see the setup program (Part 1) for more
  1494.                information on setting up launchable applications.
  1495.  
  1496.  
  1497.         >> Sec. 2.6              MARKED FILES MENUS
  1498.         _____________________________________________________________________
  1499.  
  1500.              There are two menus associated with file marking and marked files
  1501.         operations.  These menus will be discussed in each of the following
  1502.         subsections.
  1503.  
  1504.  
  1505.             >> Sub Sec. 2.6.1           THE MARKING CRITERIA MENU
  1506.             __________________________________________________________________
  1507.  
  1508.                  The marking criteria menu allows the user to define a "mask"
  1509.             or "filter" to direct StS as to which files to mark.  This menu
  1510.             appears only if and when the F2 function key is pressed and there
  1511.             are no files marked in the hooked window.  If there are existing
  1512.             file marks when F2 is pressed, the marked files menu (discussed
  1513.             later) will appear instead.  In this section, the operation of
  1514.             the marking criteria menu will be explained.
  1515.  
  1516.             [F1] Mark files as defined.
  1517.                       This option instructs StS to mark the files according
  1518.                  to the defined criteria and transfers control to the marked
  1519.                  files menu.
  1520.  
  1521.             [F2] Filespec = ????????.???
  1522.                       This option allows the user to define a filespec to be
  1523.                  used in the filter.  For example, if only files with the name
  1524.                  HELP are desired to be marked, then HELP.* or HELP.??? would
  1525.                  be the mask defined.  The filespec defined here may use DOS
  1526.                  wildcard characters and follows DOS rules for definitions.
  1527.  
  1528.             [F3] Before.  ≤  xx-xx-xx   xx:xx
  1529.                       This option allows the user to define the ending file
  1530.                  date/time to mark files.  All files that have a d/t less than
  1531.                  or equal to this d/t AND greater than or equal to the d/t
  1532.                  defined in the F4 option below will be eligible for marking
  1533.                  pending whatever other criteria are set.  The default d/t
  1534.                  for this option is the current date/time as read from the
  1535.                  system which would normally be greater than or equal to the
  1536.                  date/time of all files.
  1537.                                                                         2-17
  1538.  
  1539.             [F4] After..  ≥  xx-xx-xx  xx:xx
  1540.                       This option allows the user to define the starting file
  1541.                  date/time to mark files.  All files that have a d/t greater
  1542.                  than or equal to this d/t AND less than or equal to the d/t
  1543.                  defined in the F3 option above will be eligible for marking
  1544.                  pending whatever other criteria are set.  The default d/t
  1545.                  for this option is 01-01-80  00:00 which precedes the IBM-PC
  1546.                  and would normally be less than or equal to the date/time of
  1547.                  all files.
  1548.  
  1549.             [F5] Smaller  ≤  99999999 bytes
  1550.                       This option allows the user to define the largest size
  1551.                  of files to mark.  Files that are smaller than or equal to
  1552.                  the size defined here AND are larger than or equal to the
  1553.                  size defined in F6 below will be eligible for marking pending
  1554.                  whatever other criteria are set.  The default is 99999999
  1555.                  bytes which should normally include all files.
  1556.  
  1557.             [F6] Larger.  ≥        00 bytes
  1558.                       This option allows the user to define the smallest size
  1559.                  of files to mark.  Files that are larger than or equal to
  1560.                  the size defined here AND are smaller than or equal to the
  1561.                  size defined in F5 above will be eligible for marking pending
  1562.                  whatever other criteria are set.  The default is 00 bytes
  1563.                  which should normally include all files.
  1564.  
  1565.             [F7] Modified:  * (archive bit)
  1566.                       This option allows files to be selected for marking
  1567.                  based on the status of the archive bit of the file attribute.
  1568.                  The archive bit is set whenever a file is edited or changed
  1569.                  by an application program.  The archive bit is cleared
  1570.                  when a file is backed-up by a backup program or manually
  1571.                  cleared by a capable program like Stereo Shell.  This option
  1572.                  is useful for selecting only files that have changed since
  1573.                  a backup was made.  The default setting for this option is *
  1574.                  which means "don't care" and makes all files eligible for
  1575.                  marking.
  1576.  
  1577.             [F8] Inverted:  N
  1578.                       This option reverses the marking criteria.  Normally the
  1579.                  StS marking criteria can be considered "inclusive".  Setting
  1580.                  the F8 option to Y makes it "exclusive".  This is best
  1581.                  demonstrated by example;  Assume the F5 and F6 size options
  1582.                  above are set to mark files between 1200 and 14000 bytes.  If
  1583.                  the inverted option is set, all files EXCEPT those that are
  1584.                  between 1200 and 14000 bytes will be marked.  In other words
  1585.                  files that fall within the defined criteria are excluded.
  1586.  
  1587.             [F9] Restore default criteria.
  1588.                       Once a file marking criteria is set by the user, it
  1589.                  remains set.  This feature allows one to change drives and or
  1590.                  sub-directories and mark files in each area with the same
  1591.                  defined criteria.  This eliminates the need to re-define the
  1592.                  criteria with each use of the menu.  The F9 "restore" option
  1593.                  provides a quick and easy means to restore the defaults with
  1594.                  one keystroke.
  1595.                                                                         2-18
  1596.  
  1597.             >> Sub Sec. 2.6.2           THE MARKED FILES MENU
  1598.             __________________________________________________________________
  1599.  
  1600.                  The marked files menu allows the user to copy, move, erase,
  1601.             view edit, perform user defined file functions, change the
  1602.             attributes and dates and also perform compressed file operations
  1603.             on "marked" or "tagged" files.  Since these first six functions
  1604.             are virtually identical to their individual file counterparts, the
  1605.             reader is referred to the previous section for details.  Option
  1606.             (F7), (F8), and (F9) however deserve some explanation.
  1607.  
  1608.  
  1609.            [F7]   ATTRIBUTE/date editor.
  1610.                    The attribute date editor's application for marked files
  1611.                differs slightly from its single file equivalent.  When this
  1612.                option is selected, the attributes displayed do not reflect
  1613.                the attributes of any of the marked files.  The initial con-
  1614.                dition for the attributes is all OFF.  You may toggle any of
  1615.                the attributes any way you like, and saving the settings will
  1616.                set ALL the marked files to your defined attributes.  Likewise
  1617.                the initial date/time fields are filled with asterisks.  If
  1618.                you do not enter a new date/time, the dates and times of the
  1619.                marked files will not be changed.  If you do enter a date and
  1620.                time, then ALL the marked files will be set to this date and
  1621.                time.
  1622.  
  1623.            [F8]   CONVERT library types.
  1624.                    This option provides the means to block convert library
  1625.                files from one type to another.  Library files of any type
  1626.                may be marked and converted to the same format.  For example
  1627.                you could mark .LZH, .ARC, and .PAK files and convert them
  1628.                all to .ZIP format in one pass.  Files marked that are not
  1629.                of a defined extension type are simply ignored by the command.
  1630.                    When selected, you will be asked to define the type of file
  1631.                to convert to.  Once the type is selected the program will
  1632.                automatically load the proper programs to extract and re-com-
  1633.                ress each of the marked files.  As with any other marked file
  1634.                operation, pressing the <Esc> key will terminate the automatic
  1635.                process.
  1636.                    Please see the FILE COMPRESSOR MENU section for more in-
  1637.                formation about file conversion and error handling.
  1638.  
  1639.            [F9]   ADD/CREATE to a library.
  1640.                    This option will allow the user to pick out files from a
  1641.                directory and either add them to a library or create a new
  1642.                library file with them included.
  1643.                    When this option is selected it may scare you a little.  It
  1644.                first performs an automatic copy of the selected files to a
  1645.                temporary sub-directory.  This is done so that the files may
  1646.                be isolated from the others and the wildcard *.* can be used
  1647.                to control the compression program.  Once the auto-copy is
  1648.                completed the user will be prompted to select a library type
  1649.                and a library file name.  This option will either add or create
  1650.                the library file depending on whether it previously existed.
  1651.                                                                         2-19
  1652.  
  1653.                     Marked file operation with stereo windows is an extremely
  1654.                powerful feature.  It provides the user with the means to move
  1655.                large numbers of files around quickly, without the drudgery of
  1656.                typing in pathnames.  By simply pointing the two windows at
  1657.                the source and destination of your operation and accepting the
  1658.                default "across display", you can get the job done quickly and
  1659.                see what is going on during the process.
  1660.  
  1661.  
  1662.         >> Sec. 2.7              THE EXE COM BAT MENU
  1663.         _____________________________________________________________________
  1664.  
  1665.              The EXE COM BAT  file menu is opened when the user selects a file
  1666.         that has an extension of EXE, COM, or BAT.  This section describes the
  1667.         options available via this window.
  1668.  
  1669.  
  1670.         [F1]   EXECUTE the selected file.
  1671.                     This option will execute the selected file which is
  1672.                displayed in the lower left corner of the window.  When
  1673.                selected this option prompts for additional parameters to pass
  1674.                to the program.  These parameters are what the user would
  1675.                normally enter on the DOS command line after the filename.
  1676.                For example: If the user wanted to run DEBUG and pass the
  1677.                filename TEST.EXE to it,  he would place the cursor on
  1678.                DEBUG and press <CR>, StS would open the EXE COM BAT window
  1679.                and from there the user selects [F1].  The response to the
  1680.                parameter entry window would be; TEST.EXE.
  1681.  
  1682.                     StS is capable of executing .EXE .COM and .BAT files
  1683.                via the [F1] function, but note the process for .EXE and .COM
  1684.                files differs from .BAT files because a duplicate copy of
  1685.                COMMAND.COM is needed for .BAT files.  Although this process
  1686.                is transparent to the user,  the author of this program likes
  1687.                to know what is going on behind the scenes and thinks most
  1688.                users do too.  When a file is executed, StS shrinks its
  1689.                total memory usage to 50Kb to allow the maximum memory for the
  1690.                application's use.  In the case of .BAT files, the command
  1691.                processor is loaded and takes a block of RAM depending on the
  1692.                MS-DOS version used.  What this means in reality is that you
  1693.                can run larger programs directly from StS than you can if
  1694.                the program is run via a batch file executed from StS.
  1695.  
  1696.         *-------->  NEVER run a terminate and stay resident (TSR) program
  1697.                from StS or any other DOS shell.  When this type of program
  1698.                is executed it makes a permanent place for itself at the
  1699.                memory address it was loaded.  Since the program is loaded
  1700.                above the DOS shell, it will permanently cut out a large chunk
  1701.                of usable memory.
  1702.  
  1703.         [F2] - [F9]  VIEW, EDIT, USER, COPY, RENAME, MOVE, ERASE, CHG. ATTR.
  1704.                     The F2-F8 options are identical in operation to the
  1705.                general files menu options described above.
  1706.                                                                         2-20
  1707.  
  1708.  
  1709.         >> Sec. 2.8             THE FILE COMPRESSOR MENU
  1710.         _____________________________________________________________________
  1711.  
  1712.              Selecting a file with a ZIP, ARC, LZH, PAK, or ARJ, (defaults)
  1713.         extension will open the file compressor menu.  This section will
  1714.         describe the options available from this menu and give the
  1715.         equivalent PK commands.
  1716.  
  1717.   NOTE: In this section the default name ZDIR, is used for the working dir.
  1718.  
  1719.              StS handles library (compressed) file procedures by using the
  1720.         sub-directory ZDIR as an isolated work area.  All files are extracted
  1721.         into ZDIR and all freshen/update/create activity uses ZDIR as the
  1722.         source of files.  This concept makes StS extremely useful for working
  1723.         with compressed files.  It is possible to keep large programs
  1724.         compressed, extract to ZDIR, execute from ZDIR, freshen or update and
  1725.         then erase the individual files without disturbing anything else on
  1726.         the disk.  This approach, when combined with with the powerful copy
  1727.         and move features of Stereo, makes file compression a logical
  1728.         alternative to bigger disk drives.  ZDIR should never be used as a
  1729.         "storage" place for miscellaneous files.
  1730.  
  1731.         Note: References to actual commands in the descriptions that follow
  1732.               are based on PKZIP.  These are provided only for illustrative
  1733.               purposes and may vary with different compression utilities.
  1734.  
  1735.  
  1736.         [F1]  EXTRACT files.
  1737.                     This option uses the -x command to extract files
  1738.                from the selected library.  The user is prompted for
  1739.                filenames so that a partial or "wildcard" extract can be
  1740.                performed.  If nothing is entered in response to the filename
  1741.                prompt, all files will be extracted.  The extracted files are
  1742.                placed in the ZDIR directory unless the user redirects the
  1743.                output.  Pressing Esc. while being prompted for the filename(s)
  1744.                will cancel the operation.
  1745.                                     (I/O redirection. see next section)
  1746.  
  1747.         [F2]  LIST filenames to screen.
  1748.                     This option uses the -v command to provide the
  1749.                user with a listing of the library's contents.  Filenames,
  1750.                file sizes, and other related technical information is provided
  1751.                to the user.  This option is useful to determine the contents
  1752.                of a library before selective extracting or deletion is
  1753.                performed.
  1754.  
  1755.         [F3]  TYPE text files on screen.
  1756.                     This option uses the -cm command to extract files
  1757.                directly to the video display.  On the later versions of
  1758.                PKUNZIP the more command is added and prompts the user after
  1759.                each screen full of information is given.  This option
  1760.                provides the user with the means to quickly view text files
  1761.                without the need to extract them.
  1762.                                                                         2-21
  1763.  
  1764.         [F4]  TEST compress integrity.
  1765.                     This option uses the -t command to test the
  1766.                validity of the library and the files within it.  This
  1767.                command should be particularly useful to BBS sysops and program
  1768.                librarians who need to perform a quick test of their library
  1769.                files.
  1770.  
  1771.         [F5]  DELETE files from library.
  1772.                     This uses the -d command to delete files from the
  1773.                selected library.  The user will be prompted for the file-
  1774.                name(s) to delete.  The user must enter a filename or press Esc
  1775.                to cancel the operation.  To determine the filenames present in
  1776.                any given library use the [F2] (verbose list) command from
  1777.                this menu first.
  1778.  
  1779.         [F6]  FRESHEN library file.
  1780.                     This option uses the -f command to freshen the files in
  1781.               the library.  In the case of PKZIP, the actual command string
  1782.               is -f -ex  which provides extra compression on binary files.
  1783.               Freshen differs from update in that new files are not added
  1784.               to the library file.  Freshen only updates files that already
  1785.               exist in the library and have been changes since the library
  1786.               originally created.
  1787.                                     (I/O redirection. see next section)
  1788.  
  1789.         [F7]  UPDATE + add to library.
  1790.                     This option uses the -u command to update the files in
  1791.               the library.  In the case of PKZIP, the actual command string
  1792.               is -u -ex  which provides extra compression on binary files.
  1793.               Update differs from freshen in that new files ARE added to
  1794.               the library file.  Update not only updates files that already
  1795.               exist in the library and have been changes since the library
  1796.               originally created, it also ADDS any new files that are present
  1797.               in ZDIR or in the user specified override directory.
  1798.                                     (I/O redirection. see next section)
  1799.  
  1800.             * * * * * NOTES AND HINTS ABOUT FRESHEN/UPDATE. ... Freshening
  1801.             * means that only files that have filenames matching those files
  1802.             * already in the library will be considered in the update
  1803.             * process.  This option should be used if the extracted files
  1804.             * are changed by some activity performed on them.  For example:
  1805.             * If you un-arc a spreadsheet file and make a few changes, then
  1806.             * the original library should be freshened so that the changes
  1807.             * will be reflected the next time the file is used.  As
  1808.             * another example:  If a new spreadsheet file is created in the
  1809.             * ZDIR then you should update and add to insure that the new
  1810.             * file is stored within the library.
  1811.             * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
  1812.                                                                         2-22
  1813.  
  1814.         [F8]  CONVERT compress format.
  1815.                     This option will automatically convert compressed files
  1816.               from format to format.  The user will be asked to select the
  1817.               type of format that the file will be converted into.  A sub
  1818.               directory named Z_STS_TD is created on the working drive and
  1819.               is used as a temporary holding area for the extracted files.
  1820.               The filename extension is changed as well as the file format.
  1821.               Example:  TEST.ARC converted to LZH format becomes TEST.LZH.
  1822.  
  1823.             * * * * *  CONVERSION UTILITY NOTES ... The process of library
  1824.             * file conversion merits some deeper explanation into the actual
  1825.             * procedure that is going on behind the scenes.  This is necessary
  1826.             * due to the possibility of the program failures that can occur
  1827.             * during the process.  A good understanding of the StS file con-
  1828.             * version method will allow you to easily locate and recover your
  1829.             * data in the event of a failure.
  1830.             *
  1831.             * The conversion process:
  1832.             *
  1833.             * (1.) Files are extracted to a temporary sub-directory that StS
  1834.             *      creates on the working drive. (see the setup program for
  1835.             *      information about the working drive)  The sub-directory is
  1836.             *      named \Z_STS_TD.  If a failure occurs in this step the
  1837.             *      conversion process will be terminated and the original
  1838.             *      library file will still be intact.  In some cases there
  1839.             *      may be files in \Z_STS_TD that will need to be erased
  1840.             *      before any other files may be converted.
  1841.             *
  1842.             * (2.) If step 1 is successful, the original library file is
  1843.             *      erased at this point.  This is done to allow the conversion
  1844.             *      of files to be performed on floppy disk drives.  Quite
  1845.             *      often disk space will not permit both the old and new
  1846.             *      library files to exist simultaneously.  It is worth noting
  1847.             *      here that the user can prevent step 2 from occurring by
  1848.             *      giving the library file a read only attribute mark before
  1849.             *      doing the conversion.  Please see the change attribute
  1850.             *      options for information on how to do this.
  1851.             *
  1852.             * (3.) The files that were extracted to \Z_STS_TD are now added
  1853.             *      to a new library file that assumes the same filename as
  1854.             *      the original.  If a failure occurs in this step the
  1855.             *      conversion process is terminated and the user may recover
  1856.             *      his original files from the \Z_STS_TD sub-directory.
  1857.             *
  1858.             * (4.) If step 3 is successful the extracted files are erased and
  1859.             *      temporary sub-directory \Z_STS_TD is removed.  The
  1860.             *      original date/time and file attributes are passed on to the
  1861.             *      new library file.
  1862.             *       ---------------------------------------------------
  1863.             *      We have designed the file conversion process to be as safe
  1864.             * as possible in order to prevent the loss of data during a
  1865.             * conversion.  It is hoped that the descriptions above will help
  1866.             * you recover your files in the event that something like an ill
  1867.             * defined utility path causes a runtime crash.  It is wise to test
  1868.             * your utility programs on single files to be sure that they are
  1869.             * working properly before using the convert.
  1870.             * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
  1871.                                                                         2-23
  1872.  
  1873.         [F9]  GENERAL FILES MENU.
  1874.                     This command will open the General files menu allowing
  1875.               you to move/copy/erase etc. a library file.  See General files
  1876.               menu section for more details.
  1877.  
  1878.  
  1879.             >> Sub Sec. 2.8.1           THE I/O RE-DIRECTION SUB MENU
  1880.             __________________________________________________________________
  1881.  
  1882.                   Several of the file compression commands invoke a sub-menu
  1883.             which allows the user to specify where to send files that are
  1884.             extracted from library files or where to look for files that are
  1885.             intended to add, freshen, or update a library file.  Hence
  1886.             the file input or output of the compressed file operation may
  1887.             be controlled by the user.  The following is a brief description
  1888.             of the options available on this sub-menu.
  1889.  
  1890.  
  1891.             [F1]  WORKing directory.
  1892.                        This option will send\receive files to/from the working
  1893.                   directory. (ZDIR)
  1894.  
  1895.             [F2]  ACROSS display.
  1896.                        This option will send\receive files to/from the
  1897.                   un-hooked window.  This is similar to the copy across dis-
  1898.                   play feature of Stereo.
  1899.  
  1900.             [F3]  HERE no re-direction.
  1901.                        This option will send\receive files to/from the
  1902.                   hooked window.
  1903.  
  1904.             [F4]  USER defined path.
  1905.                        This option will prompt the user for the I/O path to
  1906.                   use.
  1907.  
  1908.  
  1909.             >> Sub Sec. 2.8.2           THE EXTENDED ZIP MENU
  1910.             __________________________________________________________________
  1911.  
  1912.                   The "EZ" interface is offered to users whenever a .ZIP file
  1913.             is selected and either an extract, view text files, or delete,
  1914.             command is issued.  If the EZ interface is opted for, the menu
  1915.             window will expand and a directory of the .ZIP file will be
  1916.             displayed.  In the interest of memory preservation and speed, only
  1917.             the filename and extension data is provided.  The files are sorted
  1918.             by StS and the sort is either name/ext or ext/name.  The sort of
  1919.             the ZIP directory listing takes on the same sort as the hooked
  1920.             window if the hooked window was one of these two types else it
  1921.             uses whatever sort it used the last time it was opened.
  1922.  
  1923.                   The ZIP directory menu filename list is controlled in a
  1924.             manner identical to to the main screen file windows.  Full cursor
  1925.             pad and mouse support as well as the quick find letter keys are
  1926.             supported.  Files may be marked with the space bar or both mouse
  1927.             buttons.  All files may be marked or unmarked with the insert and
  1928.             delete keys.
  1929.                                                                         2-24
  1930.  
  1931.             IF NO FILES ARE MARKED: Pressing the ENTER key will cause only the
  1932.                                     file the cursor is on to be processed.
  1933.  
  1934.  
  1935.             IF FILES ARE MARKED:... Pressing the ENTER key will cause the
  1936.                                     marked files to be processed.  The
  1937.                                     filename that the cursor bar is on will be
  1938.                                     ignored unless it is marked.
  1939.  
  1940.             Pressing ESCAPE will exit with no action.
  1941.  
  1942.                   The "EZ" interface attempts to read the contents of the
  1943.             central directory of the selected .ZIP file directly.  It opens
  1944.             the file and reads the filename information directly from the file
  1945.             PKZIP is not involved in this process.  The program is compatible
  1946.             with PKZIP version 1.00 and later, some older versions such as .91
  1947.             are not supported.  If a file zipped with an older version of
  1948.             PKZIP is encountered, it may easily be converted to the newer
  1949.             version with StS.
  1950.  
  1951.                  If Stereo Shell cannot read the .ZIP directory directly, it
  1952.             automatically switches to the standard interface.  An error is
  1953.             reported in the menu window when this occurs but the program
  1954.             continues on as if the user had selected the default standard
  1955.             interface.  If an unrecoverable error occurs while the actual zip
  1956.             directory menu is displayed, StS will abort the whole process just
  1957.             as if the Escape key had been pressed.  An error of this type
  1958.             might occur when a re-sort is attempted if say the file is on a
  1959.             floppy and the disk has been changed.  In a rare case like this,
  1960.             there is nothing more StS (or PKZIP) can do, so the abort is
  1961.             appropriate.
  1962.  
  1963.                  The EZ interface does not support the extremely rare case of
  1964.             ZIP files whose central directory structure spans multiple disk
  1965.             media.  It will switch to the standard interface and let PKZIP
  1966.             handle it.
  1967.  
  1968.                  The EZ interface has limited support for .ZIP files with
  1969.             relative path names stored inside.  These are .ZIP files created
  1970.             with the the -r option that are generally used for system backup
  1971.             purposes.  The EZ interface will show the filenames, however
  1972.             PKUNZIP will be unable to extract the files unless the -d option
  1973.             is specified under the extract command.  If -d is specified, then
  1974.             the relative paths will be created on extraction...  It is better
  1975.             to use the standard interface which will override the path
  1976.             information entirely and extract all the files to wherever they
  1977.             have been I/O re-directed.  This type of .ZIP file is rarely
  1978.             encountered in normal operations.  We DO NOT recommend the -d
  1979.             option be used for extractions in StS.  This situation is better
  1980.             handled with dedicated batch files for backing up and restoring
  1981.             hard disk information.
  1982.  
  1983.                  The EZ interface has a maximum capacity of 1050 files within
  1984.             the .ZIP file.  If a .ZIP file contains more than 1050 files, only
  1985.             the first 1050 filenames encountered will be displayed.
  1986.                                                                         2-25
  1987.  
  1988.                  The EZ interface creates and destroys a file named
  1989.             STS_PKZP.LST on the working drive as the list file to pass the
  1990.             filename list information to PKZIP.  This filename should be
  1991.             considered reserved.
  1992.  
  1993.  
  1994.         >> Sec. 2.9             THE INTERNAL VIEW UTILITY
  1995.         _____________________________________________________________________
  1996.  
  1997.              Stereo Shell includes an internal dual mode view utility that
  1998.         will allow viewing of ASCII or binary files.  The view utility
  1999.         determines from the filename extension what type of file is selected
  2000.         and automatically comes up in the correct mode.  ie. either ASCII or
  2001.         HEX.
  2002.  
  2003.              The StS view utility was designed to be used as a "quick look"
  2004.         tool and not a full blown do everything viewer.  Although simple, the
  2005.         viewer is quite fast and provides full screen viewing with mouse
  2006.         support.  It includes a non-case-sensitive string search routine that
  2007.         is based on the ultra efficient Boyer-Moore algorithm as well as
  2008.         printing capabilities in both hex and ASCII modes.  Many users of StS
  2009.         choose to retain the StS internal viewer as the primary viewer and
  2010.         attach a more sophisticated viewer program like Buerg's LIST.COM to
  2011.         one of the user keys to do the heavy work.
  2012.  
  2013.              This section notes the key commands used in view and also makes
  2014.         note of the special mouse control.
  2015.  
  2016.         >> KEYBOARD CONTROL
  2017.         > Up/Dn arrows ............ Scroll 1 line up and down
  2018.         > Lt/Rt arrows ............ Scroll 1 page up and down
  2019.         > PgUp and PgDn ........... Scroll 1 page up and down
  2020.         > Home and End  ........... Top or End of file
  2021.         > Enter key ............... Scroll one page down
  2022.         > Space bar ............... Search for string
  2023.         > [F1] key ................ Switch HEX/ASCII mode
  2024.         > Esc. or + key ........... Exit view mode
  2025.  
  2026.         >> MOUSE CONTROL
  2027.         > roll up and down ........ Scroll 1 line up and down
  2028.         > roll rt. and lt. ........ Scroll 1 page up and down
  2029.         > left button ............. Scroll one page down
  2030.         > right button ............ Exit view mode
  2031.         > both buttons ............ Switch HEX/ASCII mode
  2032.  
  2033.         >> PRINTER CONTROL KEYS
  2034.         > F2 key:.........=> Print from top of screen until a key is pressed.
  2035.         > F3 key:.........=> Send a form feed (ASCII 12) to the printer.
  2036.                                                                         2-26
  2037.  
  2038.         >> Sec. 2.10            USEFUL NOTES AND HINTS
  2039.         _____________________________________________________________________
  2040.  
  2041.              This section contains some notes and hints for using Stereo
  2042.         Shell.
  2043.  
  2044.         Using the menus: StS includes what we call quadraphonic menus.  This
  2045.                          means that the user may enter a command in any of
  2046.                          four ways.  (1.) Point and shoot with the cursor
  2047.                          keys. (2.) Point and shoot with the mouse. (3.) Type
  2048.                          the corresponding function key. (4.) Type the letter
  2049.                          that appears the the left of the command.  The
  2050.                          letters are generated automatically on user defined
  2051.                          functions and generally are the first letter of the
  2052.                          user defined text string.  If the first letter has
  2053.                          already been used, the second letter is used and so
  2054.                          on.
  2055.  
  2056.         Printing files:  A text file may be sent to the standard printer by
  2057.                          copying it to PRN.  To do this, place the cursor on
  2058.                          the file and issue a copy command.  When StS prompts
  2059.                          for the destination, enter PRN.  Do not include a
  2060.                          colon after the device name.  StS may report a "file
  2061.                          exists  overwrite" message on some systems, if it
  2062.                          does, tell it yes.  Upon completion of the print,
  2063.                          StS may report that the file was not copied, but of
  2064.                          course if the printer printed it, it was.  The error
  2065.                          messages are a result of the checking StS does when
  2066.                          copying files between disk drives.  Since the PRN
  2067.                          device does not behave like a disk drive, it causes
  2068.                          StS to report the errors.  Stereo Shell's internal
  2069.                          viewer may also be used to print files and of course
  2070.                          the user can load a file into an editor or external
  2071.                          viewer and print it from there.
  2072.  
  2073.         Floppy disks:    Although both of Stereo's windows will allow the
  2074.                          user to perform all the same functions, use of the
  2075.                          right window for floppy disk access will provide
  2076.                          slightly better performance.  The reasons for this
  2077.                          are complicated but have to do with the fact that
  2078.                          DOS only has one true default directory active at
  2079.                          any time.  When Stereo is running, the left window
  2080.                          always displays the true default directory.  If the
  2081.                          left window remains pointed at a hard disk, whose
  2082.                          directory information is buffered in RAM by DOS, the
  2083.                          need to read the physical disk when changing
  2084.                          directories is minimized.  If the left window points
  2085.                          at a floppy, StS will re-read it more often when the
  2086.                          user changes directories on either side.
  2087.  
  2088.                                                                         A-1
  2089.  
  2090.         APPENDIX A           COMPRESSION UTILITIES INTERFACING
  2091.         _____________________________________________________________________
  2092.  
  2093.              The compressor interface of StS is built upon the speed and power
  2094.         of up to 8 different compression utility programs.  This appendix is
  2095.         provided as a guide for modifying the commands StS passes to
  2096.         these utilities in order to perform the various file compression
  2097.         functions.
  2098.  
  2099.              If you plan to modify your file compression interface be
  2100.         warned that StS allows very powerful control and you can change
  2101.         the entire personality of the program.  You will need a copy of
  2102.         the user manual that comes with your file compression utility
  2103.         before proceeding.
  2104.  
  2105.              To set the various file compression commands you must go into
  2106.         setup mode (ALT-S) and then select (F4) Files/external setup.  Next
  2107.         you may select any one of up to eight file compression utilities to
  2108.         re-program.  Selecting these options will open a screen that shows the
  2109.         current settings for each supported command.  Simply select a command
  2110.         and use the built in line editor to change the string.  The string may
  2111.         be up to 16 bytes in length.
  2112.  
  2113.              The Extension key may be somewhat un-familiar and will be
  2114.         discussed here.  The other options and the program that executes
  2115.         their respective commands is outlined in table 1 below.   The
  2116.         Extension key defines the filename extension that will trigger
  2117.         Stereo Shell into opening the file compressor window.  Some examples
  2118.         are ARC, PAK, ZIP, etc.  If you decide to change this option, just
  2119.         enter the three letters, no need to place a period before them.
  2120.         The entire program menu system will be updated to reflect your
  2121.         change.  For example, if you set the EXTENSION trigger to ZAP, the
  2122.         COMPRESSION TYPE WINDOW will then have an option that says "(F )
  2123.         ZAP - File compression options.
  2124.                                  ---------
  2125.                                                                         A-2
  2126.  
  2127.         >> Table 1 <<   Compression command chart.
  2128.         ____________________________________________________________________
  2129.                        EXECUTED BY THE
  2130.                       PACKER| Un-PACKER
  2131.         Command       -----------------           Description
  2132.         EXTRACT files   |     |  X  | Extracts files from the library file.
  2133.        ---------------------------------------------------------------------
  2134.         TYPE text files |     |  X  | Allows reading text files on screen.
  2135.        ---------------------------------------------------------------------
  2136.         DELETE files    |  X  |     | Removes files from within the library.
  2137.        ---------------------------------------------------------------------
  2138.         LIST all files  |  X  |     | Provides a directory of files in lib.
  2139.        ---------------------------------------------------------------------
  2140.         TEST integrity  |     |  X  | Checks the library file for errors.
  2141.        ---------------------------------------------------------------------
  2142.         FRESHEN no add  |  X  |     | Freshens files that have been changed.
  2143.        ---------------------------------------------------------------------
  2144.         UPDATE and add  |  X  |     | Freshens old files and adds new files.
  2145.        ---------------------------------------------------------------------
  2146.         CREATE new file |  X  |     | Creates a totally new library file.
  2147.  
  2148.              In this table, PACKER and Un-PACKER refer to the programs you
  2149.         have defined earlier.  For example the default ZIP packer is PKZIP.
  2150.  
  2151.              For information about programming these SUFFIX types please
  2152.         refer to the example below.
  2153.  
  2154.        _______________________________________________________________________
  2155.  
  2156.              As the author, I think the best method to describe the
  2157.         programming of the file compression interface is by example.  What
  2158.         follows is intended to do just that.  The text is narrated as if I
  2159.         were performing the process myself.
  2160.  
  2161.  
  2162.        E X A M P L E
  2163.              Suppose my objective is to switch my ARC utilities from the
  2164.         default programs (PKWARE) to the System Enhancement Associates (SEA)
  2165.         (tm) ARC (tm) compression utility programs version 6.00.  Here is
  2166.         how it would be done;
  2167.  
  2168.              I would read the .DOC file for the SEA programs to get the
  2169.         commands needed and note the general format that they are placed on
  2170.         the command line.  After some reading, I notice that the SEA program
  2171.         ARC.EXE will execute all of the needed commands and that it uses the
  2172.         same general format as the PKWARE command line.  I also note that
  2173.         the SEA extract program ARCE.COM is completely incompatible as far
  2174.         as the command format goes.  Well obviously I  must use the SEA
  2175.         ARC.EXE program for both my packer and unpacker.  I then go into
  2176.         SET-UP mode and set both my ARC compression AND my ARC extraction
  2177.         program to the drive:path and filename of ARC.EXE.
  2178.                                                                         A-3
  2179.  
  2180.              The next thing I notice is the ARC External field.  What this
  2181.         allows me to do is setup any program I want with any set of commands
  2182.         I want to work with ARC files.  This program is defined just like the
  2183.         USER programs but works with compressed files.  It is executed upon
  2184.         request from the COMPRESSED FILE MENU in the main StS program.  I
  2185.         could set up a command to run a special compressed file viewer or
  2186.         maybe a batch file to create self-extracting files.  Who knows what
  2187.         great things I can do with a 100% programmable command that runs from
  2188.         the compressed file menu.  I'll wait till I find out what others are
  2189.         doing with this command and set it up later.
  2190.  
  2191.              Now that I have the program names setup, I must change to the
  2192.         SEA command set.  I cursor down to the next line on the screen and
  2193.         look at the EXTENSION key.  It is already set to ARC and since I am
  2194.         still going to be working with ARC files, I'll leave it alone and
  2195.         get on to the heavy stuff.  I cursor down to the extract
  2196.         files command and type in the new command needed to extract files
  2197.         with.  I recall that an upper-case X will do the job...  That was
  2198.         easy, I do all the remaining commands the same way until I reach
  2199.         the SUFFIX types.  What the H*** is this about I ask?  Well it seems
  2200.         that the people who write these file compression systems all have
  2201.         their own ideas about how to send path names.  Noting the help
  2202.         window on the screen I can see that StS supports three types of
  2203.         path passing strings.  There are also four commands that the
  2204.         file utility programs use that need one of these suffix strings
  2205.         added to it in order to work properly.  The EXTRACT, FRESHEN, UPDATE
  2206.         and CREATE commands all need the strings.  The FRESHEN and UPDATE
  2207.         commands have exactly the same form in use so I have combined them
  2208.         into a single category.  What I need to do here is enter three
  2209.         numbers which will tell StS what suffix to attach to each command.
  2210.         The first number represents what the EXTRACT command uses, the
  2211.         second number represents what the FRESHEN/UPDATE command uses and
  2212.         the third number represents what the CREATE command uses.  From the
  2213.         ARC.EXE documentation I know that ARC.EXE requires the type 1 suffix
  2214.         string for all three commands, so my three number sequence will be
  2215.         111.
  2216.  
  2217.         ____________________________________________________________________
  2218.         SETUP for SEA(tm)  ARC utility program:
  2219.  
  2220.         ARC Packer ......... ARC.EXE
  2221.         ARC un-packer ...... ARC.EXE
  2222.         EXTENSION trigger .. ARC
  2223.         EXTRACT files ...... X
  2224.         TYPE text files .... P
  2225.         DELETE files ....... D
  2226.         LIST files ......... L
  2227.         TEST integrity ..... T
  2228.         FRESHEN no add ..... F
  2229.         UPDATE and add ..... U
  2230.         CREATE new file .... A
  2231.         SUFFIX types ....... 111
  2232.         ____________________________________________________________________
  2233.         NOTES:
  2234.                                  -------------
  2235.         This program has been tested with the above setup using the SEA
  2236.         ARC.EXE program and functions satisfactorily.  The ability to "port"
  2237.         any other file compression utility other than the PKWARE series and
  2238.         ARC.EXE (version 6.00) is not guaranteed.
  2239.                                                                         A-4
  2240.                                  -------------
  2241.         The ability to edit the command strings used by the file compression
  2242.         programs also allows the user to "tune" the new ZIP program
  2243.         compression options.  Although the defaults are quite good, I will
  2244.         leave the tinkering to you and your PK DOC file.  We at M.R.E
  2245.         welcome your comments and suggestions about such "tuning" in our
  2246.         registered user conference on the BBS.  Enjoy!
  2247.                                  --------------
  2248.         Register your file compression utilities with their authors!  Without
  2249.         them, where would we all be?
  2250.  
  2251.                                                                          B-1
  2252.  
  2253.         APPENDIX B                  LICENSE / WARRANTY
  2254.         _____________________________________________________________________
  2255.  
  2256.  
  2257.         >> Sec. B.1                     LICENSE
  2258.         _____________________________________________________________________
  2259.  
  2260.              StS ver. 4.00 is being distributed under the "shareware" or
  2261.         user supported concept.  This software is NOT free software.  The
  2262.         use or reproduction of this software outside of the limits specified
  2263.         in this license agreement is prohibited.
  2264.  
  2265.              Non-registered users are granted a limited license to use this
  2266.         software for a period not to exceed thirty days.  During this period
  2267.         they should test and evaluate the software to determine if it will
  2268.         meet their needs. The use of this program beyond this limited time
  2269.         period requires registration.  Non-registered users are not allowed
  2270.         to distribute this software without the express written permission
  2271.         of Microsystems Research & Engineering.  The only exceptions to this
  2272.         distribution restriction are SYSOPS of electronic bulletin boards and
  2273.         distributors of public domain and user supported software.  SYSOPS
  2274.         and software distributors must abide by the copying restrictions
  2275.         specified below.
  2276.  
  2277.              Registered users are granted the right to use StS on only one
  2278.         computer at any time.  Site licensing agreements are available for
  2279.         businesses, corporations, and government agencies.  Registered users
  2280.         are also granted the right to copy and distribute StS subject to the
  2281.         following conditions.
  2282.  
  2283.              StS must be copied in its original unmodified form.
  2284.  
  2285.              All of the files must be included in the copy.
  2286.  
  2287.              No fee or charge may be requested or paid to any licensee by the
  2288.              recipient of the copy.
  2289.  
  2290.              StS may not be distributed in conjunction with any other
  2291.              product without the express written consent of MRE Software.
  2292.  
  2293.                                                                         B-2
  2294.  
  2295.  
  2296.         >> Sec. B.2                     WARRANTY
  2297.         _____________________________________________________________________
  2298.  
  2299.              Microsystems Research and Engineering makes no warranty of any
  2300.         kind, express or implied, including without limitation, any
  2301.         warranties of merchantability and or fitness for a particular purpose.
  2302.         Microsystems Research and Engineering shall not be liable for any
  2303.         damages, whether direct, indirect, special or consequential arising
  2304.         from a failure of this program to operate in the manner desired by the
  2305.         user.  Microsystems Research and Engineering shall not be liable for
  2306.         any damage to data or property which may be caused directly or
  2307.         indirectly by use of the program.
  2308.  
  2309.              IN NO EVENT WILL Microsystems Research and Engineering BE
  2310.         LIABLE TO YOU FOR ANY DAMAGES, INCLUDING ANY LOST PROFITS, LOST
  2311.         SAVINGS OR OTHER INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF
  2312.         YOUR USE OR INABILITY TO USE THE PROGRAM, OR FOR ANY CLAIM BY ANY
  2313.         OTHER PARTY.
  2314.  
  2315.  
  2316.         >> Sec. B.3                   TRADEMARKS
  2317.         _____________________________________________________________________
  2318.  
  2319.              IBM, IBM PC-XT-AT-PCjr-PS/2 and PC-DOS are registered trademarks
  2320.         of International Business Machines Corporation.
  2321.  
  2322.              Microsoft, MS-DOS, MASM, and Microsoft Macro Assembler are
  2323.         registered trademarks of Microsoft Inc.
  2324.  
  2325.              LIST.COM was written by and (C.) Copyright Vern Buerg
  2326.  
  2327.              ProComm is a registered trademark of Datastorm Technologies Inc.
  2328.  
  2329.              PC-BOARD is a registered trademark of Clark Development Co.
  2330.  
  2331.              SEA, ARC, ARCE (tm) System Enhancements Associates
  2332.  
  2333.              PKZIP, PKUNZIP, PKWARE, (tm) PKWARE inc.
  2334.  
  2335.              Other tradenames are referenced where they occur.
  2336.  
  2337.         SPECIAL NOTE TO USERS WHO PURCHASED THIS PROGRAM VIA ONE OF OUR ADS.
  2338.  
  2339.         You ARE a registered user!  Section C of the .DOC file has been
  2340.         included in the interest of completeness.  It details all of the
  2341.         benefits you are entitled to as a registered user and also provides
  2342.         an order form so that you may order more copies.
  2343.  
  2344.                           - you may discard this page -
  2345.                                                                         C-1
  2346.  
  2347.  
  2348.         APPENDIX C                     REGISTRATION
  2349.         _____________________________________________________________________
  2350.  
  2351.  
  2352.         Sec. C.1                  WHY SHOULD I REGISTER ?
  2353.         _____________________________________________________________________
  2354.  
  2355.              StS is distributed under the shareware concept.  Shareware is a
  2356.         unique marketing concept born of the computer revolution.  Users are
  2357.         allowed to obtain complete working programs to freely test and
  2358.         evaluate for a limited time period.  If they find the programs useful
  2359.         then they are required to register their copy of the program.  The
  2360.         small registration fee goes to support the authors and encourage them
  2361.         to continue to improve the software.
  2362.  
  2363.              Shareware depends on honesty.  The computer programs are freely
  2364.         distributed as finished products.  The authors of this type of program
  2365.         depend completely on the honesty of end users for compensation for
  2366.         their work.  If you use a shareware program, any shareware program,
  2367.         please be honest and register your copy.  Shareware is not free
  2368.         software.  It requires just as much work and effort to produce as
  2369.         the highly advertised commercial products, but it usually sells for
  2370.         a small fraction of the price.
  2371.  
  2372.              Registering a shareware program also gives you the unique
  2373.         opportunity to do something that is virtually impossible with
  2374.         most commercial software.  When you register, your comments and ideas
  2375.         are usually communicated directly to the author of the program and the
  2376.         response you will receive is from him/her.  This fact assures you
  2377.         that your ideas are heard by someone who is paying attention.  It is
  2378.         also from this pool of suggestions and ideas that future improvements
  2379.         improvements are spawned.
  2380.  
  2381.              Shareware companies in general don't spend millions of dollars
  2382.         doing "market research" or advertising the heck out of their products
  2383.         in order to sell you something that you have only read about.  We
  2384.         lay it out there on the line....here it is....fully functional....you
  2385.         like it, please buy it, you don't .... erase it.  We also don't charge
  2386.         you $400.00 for our products.  Don't take this the wrong way however,
  2387.         commercial software is a necessity.  God knows that this program
  2388.         would not exist if it weren't for MS-DOS and MASM. (which are quality,
  2389.         reasonably priced, and supported).  Shareware that is of high quality
  2390.         at low prices does tend to keep all software prices lower and is
  2391.         therefor a necessity in its own right.  When you support shareware
  2392.         you not only receive the right to use a good program (usually with
  2393.         free updates) but you also make a statement to the entire software
  2394.         industry.  Make the free world economy work!  Register shareware.
  2395.  
  2396.  
  2397.                                                                         C-2
  2398.  
  2399.  
  2400.         >> Sec. C.2               REGISTRATION FEES
  2401.         _____________________________________________________________________
  2402.  
  2403.              The registration fee for StS version 4.00 is only $25.00.
  2404.         This small registration fee entitles the user to use any shareware
  2405.         version of StS for life.  It also entitles the user to one year's
  2406.         access to the M.R.E. Software support BBS and one year's free updates
  2407.         to the registered version of StS which is downloadable from the BBS.
  2408.  
  2409.              Registered users are also entitled to update their registered
  2410.         versions at any time after the first year for the yearly subscription
  2411.         fee that is currently set at $10.00.  The $10.00 subscription fee
  2412.         goes to cover our cost of maintaining names and passwords on the BBS
  2413.         and will always be kept at the lowest feasible rate.  This update fee
  2414.         is not based on a year to year subscription rate like a magazine, the
  2415.         user can update anytime, even skipping months or years, without any
  2416.         additional cost incurred.  The year of access to the BBS will start on
  2417.         the date we receive the update payment.
  2418.  
  2419.              All registered users, including those who just pay the initial
  2420.         registration fee, will be notified of all major updates and changes
  2421.         to StS for a minimum period of five years.
  2422.  
  2423.              M.R.E. Software will also ship disk copies of StS to users
  2424.         based on the following pricing arrangement.
  2425.         ----------------------------------------------------------------------
  2426.         StS shareware version (no registration) .................... $5.00
  2427.         StS shareware version (no registration) on 3.5 inch media .. $7.00
  2428.         StS registered version & first time registration ........... $30.00
  2429.         StS registered version & first time registration (3.5 disk)..$32.00
  2430.         StS registered version update. (for 1 year from reg) ....... $5.00
  2431.         StS registered version update. (for 1 year from reg) (3.5).. $7.00
  2432.         StS registered version and 1 year subscription update ...... $15.00
  2433.         StS registered version and 1 year subscription update (3.5). $17.00
  2434.         StS registered user BBS support & download privileges only.  $10.00/yr
  2435.             after the first year which is included with registration.
  2436.  
  2437.  
  2438.              The basic charge amounts to $5.00 for the diskette and shipping
  2439.         plus any registration or update fees.
  2440.  
  2441.              3.5 inch floppies are also available for an additional $2.00 per
  2442.         disk.  Please specify 3.5 inch diskettes when you order.
  2443.  
  2444.         ----------------------------------------------------------------------
  2445.                                                                         C-3
  2446.  
  2447.  
  2448.         Sec. C.3              SITE LICENSE/QUANTITY DISCOUNT
  2449.         _____________________________________________________________________
  2450.  
  2451.              Quantity discounts are available for $20.00 per copy to qualified
  2452.         businesses, corporations, individuals, and government agencies.  This
  2453.         represents a $5.00 per copy or 20% savings.  A minimum of five copies
  2454.         must be registered to qualify.  Site licensed organizations will
  2455.         receive a 5.25 inch diskette which contains a current registered
  2456.         version of StS.
  2457.  
  2458.              Holders of site licensed copies share all the same privileges as
  2459.         single copy holders concerning access to free updates for one year
  2460.         and the minimal fee of $10.00 per year to update.  Even if your
  2461.         organization holds 1000 copies of StS they can be updated by simply
  2462.         downloading, or requesting shipment of the latest registered version
  2463.         of the program for just $10.00 for each year's worth of updates.
  2464.  
  2465.         Businesses may of course register less than five copies at the
  2466.         individual copy price.
  2467.  
  2468.                                       (OPTIONAL)
  2469.              Upon request, M.R.E. Software will ship the 5 or more registered
  2470.         copies of StS on individual 5.25 inch floppy disk for $2.50 per copy
  2471.         provided they are all shipped to one location.  This represents a
  2472.         total cost of $27.50 per copy for five or more copies shipped on disk.
  2473.         3.5 inch diskettes are also available for 4.50 per copy.  Please
  2474.         specify when you order.
  2475.  
  2476.                    BUSINESS USERS OR GOVERNMENT AGENCIES REQUIRING
  2477.         LARGE QUANTITIES, NETWORK LICENSES, SPECIAL PURCHASING INFORMATION
  2478.         Contact Kathleen Griffin at our Alabama sales office voice number.
  2479.         (205) 658-2611  or write to: M.R.E. Software
  2480.                                      206 Jones St.
  2481.                                      West Point, Ms. 39773
  2482.  
  2483.  
  2484.         >> Sec C.4             THE M.R.E SUPPORT BBS
  2485.         _____________________________________________________________________
  2486.  
  2487.              M.R.E. Software provides a support bulletin board system for
  2488.         distributing the latest versions of StS, on-line registration, and
  2489.         processing user questions and suggestions.  We are running the latest
  2490.         version of PC-BOARD and StS author Emery Wooten is the sysop.
  2491.  
  2492.         Non-Registered users:
  2493.             Will be given limited access to the BBS.  We are currently
  2494.         running an "open" system and no delay is imposed requiring you to
  2495.         make two calls to gain access.  Non registered users will be provided
  2496.         with access to the main message base, the MRE file area, and the
  2497.         on-line registration procedure.  You will be able to download the
  2498.         latest shareware version of StS, E88, and other selected files.
  2499.         Questions and suggestions from non-registered users will be processed
  2500.         as time permits.
  2501.                                                                         C-4
  2502.  
  2503.         Registered users:
  2504.              Will be given complete access to the BBS with full time
  2505.         allocation for a period of one year.  Registration will entitle the
  2506.         user to join the StS conference area.  The StS conference
  2507.         provides a forum for discussion and presentation of comments, ideas,
  2508.         problems, and suggestions related to the StS program.  This
  2509.         conference also has a separate file area where the latest
  2510.         REGISTERED version of StS can always be found.  Registered users are
  2511.         always given priority support and consideration relating to their
  2512.  
  2513.         questions and suggestions.  Additional access to the StS conference
  2514.         can be obtained at anytime for the nominal update fee of $10.00 per
  2515.         year.  Please see section C.2 of this .DOC file for more information
  2516.         related to user registration privileges.
  2517.  
  2518.         300 to 9600-V BPS  N-8-1    Running HAYES 9600  ULTRA V.32
  2519.         Telephone: (601) 494-8078  <data>   24 hours/day   7 days/week
  2520.  
  2521.         You are invited!
  2522.  
  2523.  
  2524.         >> Sec C.5                REGISTRATION FORM
  2525.         _____________________________________________________________________
  2526.  
  2527.              This section contains the StS registration form.  It is meant
  2528.         to provide users with a convenient means to register.
  2529.  
  2530.              Please type or print clearly.    THANK YOU FOR YOUR SUPPORT!
  2531.                                                                         C-5
  2532.                             StS REGISTRATION FORM   ver. s4.00
  2533.  
  2534.         YES!  I would like to register my copy(s) of StS.
  2535.         Please type with your text editor or print clearly!
  2536.  
  2537.         Name .............:__________________________________________________
  2538.  
  2539.         Street Address ...:__________________________________________________
  2540.  
  2541.         City .............:__________________________________________________
  2542.  
  2543.         State and country.:______________________________   Zip:_____________
  2544.  
  2545.         Company/Title (optional)....: _______________________________________
  2546.  
  2547.         Where did you obtain StS? : _________________________________________
  2548.  
  2549.         ----------------- One to 4 copies registration ---------------------
  2550.         1 to 4 copy(s) registration fee = $25.00 * ___ copy(s)=    $ _____.00
  2551.         Send 5.25 inch disk copy(s) s&h =  $5.00 * ___ copy(s)    +$ _____.00
  2552.         Send 3.50 inch disk copy(s) s&h =  $7.00 * ___ copy(s)    +$ _____.00
  2553.         Mississippi residents add 6% sales tax ...............    +$ _____.__
  2554.         Overseas shipping is $3.00 (other than US and Canada)     +$ _____.00
  2555.  
  2556.                                                 Total enclosed:    $ _____.__
  2557.  
  2558.  
  2559.         ----------------- Five or more copy site license -------------------
  2560.         5 or more copy(s) registration fee = $21.00 * ___ copy(s)  $ _____.00
  2561.         --- Site license includes one master disk & shipping.---
  2562.         Additional 5.25 inch diskettes.... = $ 3.00 * ___ copy(s) +$ _____.00
  2563.         Additional 3.50 inch diskettes.... = $ 5.00 * ___ copy(s) +$ _____.00
  2564.         Mississippi residents add 6% sales tax ...............    +$ _____.__
  2565.         Overseas shipping is $3.00 (other than US and Canada)     +$ _____.00
  2566.  
  2567.                                                 Total enclosed:    $ _____.__
  2568.  
  2569.         --------------------------- Payment method ---------------------------
  2570.         check one:
  2571.         __ Check or Money Order   __ Company PO.   __ VISA   __ MasterCard
  2572.  
  2573.         Card #: ______ ______ ______ ______    Expires date:    /
  2574.  
  2575.         Card issuing bank name: ____________________________________________
  2576.  
  2577.         your signature __________________________________tel.(___)____-_____
  2578.  
  2579.         * You MUST sign this form if using a credit card.
  2580.         ---------------------------------------------------------------------
  2581.         * MAIL THIS FORM TO:         | Checklist: Credit card expiration date.
  2582.         M.R.E. Software              |            Your ZIP code.
  2583.         206 E. Jones St.             |            Overseas shipping charge.
  2584.         West Point, MS.  39773       |            Payment enclosed.
  2585.         ---------------------------------------------------------------------
  2586.         Be sure to read the appendix sections of the STS.DOC file for complete
  2587.         details on registration prividledges, updates, and BBS support!
  2588.                                 THANK YOU!!
  2589.  
  2590.