home *** CD-ROM | disk | FTP | other *** search
/ HomeWare 14 / HOMEWARE14.bin / os2 / afe231.arj / AFE.DOC < prev    next >
Text File  |  1994-03-31  |  55KB  |  1,162 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.                      AAAAAAAA       FFFFFFFFFFFFF  EEEEEEEEEEEEE
  23.                     AAAAAAAAAA      FFFFFFFFFFFFF  EEEEEEEEEEEEE
  24.                    AAAA    AAAA     FFFF           EEEE
  25.                   AAAA      AAAA    FFFF           EEEE
  26.                  AAAAAAAAAAAAAAAA   FFFFFFFFF      EEEEEEEEE
  27.                  AAAAAAAAAAAAAAAA   FFFFFFFFF      EEEEEEEEE
  28.                  AAAAA       AAAA   FFFF           EEEE
  29.                  AAAAA       AAAA   FFFF           EEEE
  30.                  AAAAA       AAAA   FFFF           EEEEEEEEEEEEE
  31.                  AAAAA       AAAA   FFFF           EEEEEEEEEEEEE
  32.  
  33.  
  34.  
  35.                 ARCHIVE FRONT END    Version 2.3    31 March 1994
  36.  
  37.                       Copyright 1993, 1994 by H. M. Weiner
  38.     
  39.    31 March 1994                  Contents                   AFE Version 2.3
  40.    -------------------------------------------------------------------------
  41.     
  42.     Contents                                      Page
  43.     --------------------------------------------------
  44.       i. Background  . . . . . . . . . . . . . . . 1
  45.     
  46.       ii. Registration Plea  . . . . . . . . . . . 1
  47.     
  48.       iii. Included Files in the AFE Package . . . 2
  49.     
  50.       A. Program Features  . . . . . . . . . . . . 2
  51.     
  52.       B. Assumptions . . . . . . . . . . . . . . . 3
  53.     
  54.       C. Installation  . . . . . . . . . . . . . . 4
  55.     
  56.       D. Notes on Running the Program  . . . . . . 5
  57.     
  58.             1. Main Menu . . . . . . . . . . . . . 5
  59.     
  60.             2. File Selection Window . . . . . . . 5
  61.     
  62.             3. Creating a New Archive  . . . . . . 6
  63.     
  64.             4. Updating an Existing Archive  . . . 7
  65.     
  66.             5. Extract . . . . . . . . . . . . . . 8
  67.     
  68.             6. V-Scan  . . . . . . . . . . . . . . 8
  69.     
  70.             7. M/V-Scan  . . . . . . . . . . . . . 9
  71.     
  72.             8. View, Print or Delete . . . . . . . 10
  73.     
  74.             9. Exiting AFE . . . . . . . . . . . . 10
  75.     
  76.             10. Configure  . . . . . . . . . . . . 11
  77.     
  78.             11. Internal Archive Detection . . . . 11
  79.     
  80.             12. Archive Errors . . . . . . . . . . 12
  81.     
  82.             13. TryAll Subroutine  . . . . . . . . 12
  83.     
  84.             14. Variable Errors  . . . . . . . . . 12
  85.     
  86.             15. Miscellaneous Tips . . . . . . . . 13
  87.     
  88.       E. Cautions and Limitations  . . . . . . . . 14
  89.     
  90.       F. Contacting the Author . . . . . . . . . . 15
  91.     
  92.       G. Copyright Notices and Disclaimer  . . . . 15
  93.     
  94.       H. What's New (AFE History)  . . . . . . . . 16
  95.     
  96.    31 March 1994                    Page 1                   AFE Version 2.3
  97.    -------------------------------------------------------------------------
  98.     
  99.    i. Background
  100.     
  101.    AFE started out as a personal project to fill my need for a native OS/2
  102.    front-end for archive manipulation, and at the same time, give me some
  103.    particular goal while learning to use REXX.
  104.     
  105.    After many hours of effort, I came up with AFE 1.1, which utilized
  106.    IBM's in-house developed VREXX for the PM graphics.  I realized that
  107.    other OS/2ers might be interested in this type of front-end, since what
  108.    was available at the time in this catagory was very limited, so
  109.    I posted my work as Freeware on two local BBSes that I frequented.
  110.     
  111.    Unfortunately, VREXX imposes some severe limitions in many respects,
  112.    so I decided to give it a shot using Watcom's VX-REXX.  After
  113.    building some less complex projects with VX-REXX to understand its
  114.    capabilities, it was time to tackle a new and improved version of the
  115.    "Archive Front End".  This package is the result.
  116.     
  117.    Please pass AFE on to other BBSes, including all files in this archive.
  118.     
  119.     
  120.     
  121.    ii. Registration
  122.     
  123.    I have many, many hours of work invested in developing and testing AFE.
  124.    What you have here is the complete package, whether you register or
  125.    not.  But you will be reminded whenever you boot up AFE that this is
  126.    shareware.  The registered version will not have this shareware 
  127.    delay/notice.
  128.     
  129.    The registration is $22.50 for the individual user.  I'm not trying to
  130.    retire on shareware income, but it would be nice to be able to pay for my
  131.    development environment and the phone bill for posting it here and there.
  132.     
  133.    When your registration form and check are received, you will be mailed
  134.    a diskette with the latest version of AFE.  You will also be established
  135.    as a registered user on the support BBS, which will allow you to download
  136.    future registered versions (at no charge).
  137.     
  138.    AFE is a copyrighted program.  It is not public domain or free
  139.    software.  A limited license is granted for the purpose of determining
  140.    suitability of the program.  Registration is required for any use
  141.    beyond a 15 day evaluation period.  Registered users have the right to
  142.    use this program for their personal use on one or more computers
  143.    provided that only 1 copy is in use at the same time.
  144.     
  145.    After a couple of weeks of using AFE, you ought to know if it's the
  146.    archive tool for you.  Fill out and print REG-FORM.AFE and make out a
  147.    check.
  148.     
  149.    31 March 1994                    Page 2                   AFE Version 2.3
  150.    -------------------------------------------------------------------------
  151.     
  152.    iii. Included Files in the AFE Package
  153.     
  154.       AFE.EXE - The executable program
  155.     
  156.       AFE.ICO - The icon used to represent AFE on the desktop
  157.     
  158.       AFE.DOC - This documentation file
  159.     
  160.       AFE-INST.EXE - The AFE installation/configuration program
  161.     
  162.       AFE-CFG.EXE - The AFE re-configuration program to change variable
  163.                     settings (must be called from AFE)
  164.     
  165.       README.1ST - An extraction of the installation and
  166.                    cautions/limitations sections from this document
  167.     
  168.       VROBJ.DLL - The VX-REXX library for the PM graphics
  169.     
  170.       REG-FORM.AFE - The registration form/mailer
  171.     
  172.       FILE_ID.DIZ - A BBS description of AFE
  173.     
  174.       OPEN.CMD - A little bonus to make life easier
  175.                  (documentation within the file)
  176.     
  177.       VRLOAD.EXE - another bonus to help speed your use of AFE or any other
  178.                    VX-REXX program
  179.  
  180.       VRLOAD.DOC - explains the purpose, use and installation of VRLOAD.EXE
  181.    
  182.  
  183.  
  184.    A. Program Features
  185.     
  186.       - create or selectively update archives
  187.     
  188.       - view or print selected files in an archive
  189.    
  190.       - selectively delete files from an archive
  191.     
  192.       - virus scan an archive
  193.     
  194.       - mark a list of archives in a directory for virus scanning
  195.     
  196.       - unarchive member files selectively or in entirety
  197.     
  198.       - supports Drag 'n Drop or double-click of archive files to start
  199.     
  200.       - detects archives within archives infinite levels deep and
  201.         allows you to selectively unarchive them
  202.     
  203.       - capability to open a folder view of the archive contents to execute
  204.         a contained program
  205.  
  206.    31 March 1994                    Page 3                   AFE Version 2.3
  207.    -------------------------------------------------------------------------
  208.     
  209.    B. Assumptions
  210.     
  211.       - REXX support is installed.  See the OS/2 documentation on how
  212.         to use "Selective Install" if you need to add it.
  213.     
  214.       - ZIP.EXE for OS/2 is installed.  This is a Public Domain program,
  215.         currently version 2.0.1, and is available on most BBSes that support
  216.         OS/2.
  217.     
  218.       - UNZIP.EXE for OS/2 is installed.  This is a Public Domain program,
  219.         currently version 5.1, and is available on most BBSes that support
  220.         OS/2.
  221.     
  222.       - LH16.EXE or LH32.EXE for OS/2 is installed.  This is a Public Domain
  223.         program, currently version 2.22, and is available on most BBSes that
  224.         support OS/2.
  225.     
  226.       - ZOO.EXE for OS/2, version 2.1 is installed.  This is a Public Domain
  227.         program and is available on most BBSes that support
  228.         OS/2.  Note that you should be using either the 16 bit version
  229.         an .EXE dated 7/14/91 or the 32 bit version dated 10/6/93.
  230.     
  231.         The 32 bit version dated 9/20/92 WILL NOT WORK properly at all
  232.         when called from AFE.
  233.     
  234.       - ARJ.EXE 2.41a (DOS) is installed.  This is a Shareware program by
  235.         Robert K. Jung.  Note that when a OS/2 native mode ARJ creation/
  236.         extraction program becomes available, AFE's support will be
  237.         recoded for that program.
  238.     
  239.       - OS2SCAN.EXE is installed.  This is a Shareware program from McAfee
  240.         Associates, currently at version 113, and is available on most BBSes
  241.         that support OS/2, or contact McAfee directly.
  242.     
  243.       - An OS/2 native file viewer is installed.  By default, E.EXE is used.
  244.         While E is not the worlds greatest editor, it works just great as a
  245.         viewer with AFE, and it's free!  Whatever you decide, a PM program
  246.         will work best with AFE.
  247.     
  248.       - VIEW.EXE is installed.  This is OS/2's viewer for INF files.
  249.     
  250.    Note: any of the external executables may be omitted if you do not intend
  251.    to use the associated capability.  That capability will be disabled in
  252.    AFE.  For example, if you omit support for ZOO type archives, then the
  253.    ZOO button will be disabled on the Create Archive submenu.  In addition,
  254.    if you were to drag 'n drop a .ZOO file on the program object, AFE would
  255.    greet you with an error message.
  256.     
  257.    Caution: If you attempt to open a file which doesn't have an extension
  258.    of ZIP, ZOO, LZH or ARJ, AFE would normally attempt to open that file
  259.    with all four methods.  If one of the archive types is not supported,
  260.    then AFE can only attempt to open it with the others.  Also, if you elect
  261.    to not support a file viewer, you also are are
  262.     
  263.    31 March 1994                    Page 4                   AFE Version 2.3
  264.    -------------------------------------------------------------------------
  265.    disabling the capability to view the report output by the virus scanner
  266.    from within AFE if a virus is detected.  You will still be notified
  267.    that a virus was detected, and a file named VSCANRPT.### will be left
  268.    in the directory you designate in the .CFG file as "ARC DIRECTORY".
  269.     
  270.     
  271.     
  272.    C. Installation
  273.     
  274.    Upgraders from AFE 2.0 or 2.01 should proceed as with a new
  275.    installation since AFE.CFG's layout has changed and VROBJ.DLL must
  276.    be upgraded to the 1/26/94 version.  It should not be necessary to pre-
  277.    erase the old files.  If you are upgrading from  AFE 2.2 you may simply
  278.    overwrite your existing AFE.EXE and VROBJ.DLL with those included in this
  279.    package.
  280.     
  281.       1. UnZIP AFE23.ZIP.  If you're reading this, you've probably
  282.          already done that.
  283.     
  284.       2. Type AFE-INST from the directory where all the unzipped files are
  285.          located.  This program will guide you through setting the variables
  286.          for your system, where to install AFE, where to install the .DLL
  287.          file and create a desktop object for AFE that has the proper
  288.          settings and associations.
  289.     
  290.    * Note: OS/2 puts a "." as the first path in your LIBPATH statement  *
  291.    * in your CONFIG.SYS file by default.  This tells OS/2 to search the *
  292.    * current path for the appropriate .DLL when you try to execute a    *
  293.    * program.  The AFE-INST program requires this to work unless you    *
  294.    * are running it directly from a directory in your LIBPATH.          *
  295.     
  296.          The entry fields in the installation program support all the normal
  297.          editing functions supported in the WPS such as destructive
  298.          backspace, overwriting highlighted text, etc.  When you are
  299.          satisfied with your entry, press the "Okay" button (or Enter),
  300.          and you will be stepped to the next variable defining dialog.
  301.     
  302.          If the meanings of the directory variables are not clear to you
  303.          with the explanations in the install program, read the next section
  304.          on running AFE to understand how the the directories are used. Note
  305.          that you will get better performance from AFE if you do not make
  306.          the root directory of any drive your "ARC DIRECTORY" or "PICK 
  307.          DIRECTORY".
  308.     
  309.       3. If everything goes properly, AFE should start when you exit the
  310.          installation program.
  311.     
  312.       4. (Optional) Set the font in "E" to SYSTEM VIO.  This makes
  313.          viewing plain text files easier because of its even spacing.
  314.     
  315.    I have the program object along the bottom of my Desktop since I use it
  316.    everyday.  I use a Shareware File/directory manager that supports drag
  317.    'n drop from its file list which makes it super easy to start AFE by
  318.    highlighting the file name and dragging it to my program icon.  Plus, if
  319.     
  320.    31 March 1994                    Page 5                   AFE Version 2.3
  321.    -------------------------------------------------------------------------
  322.    I want to run AFE from the main menu, I don't have to dig into a folder
  323.    to start it.
  324.  
  325.  
  326.     
  327.    D. Notes on Running the Program
  328.     
  329.    AFE progresses in logical steps (I hope), and has no online help, as I
  330.    think this would add unnecessary bulk to the program.  Once you start
  331.    using the program, its operation should become apparent.  If not, below
  332.    are some details about using the program.
  333.     
  334.     
  335.       1. Main Menu
  336.     
  337.       When you start the program by double-clicking its desktop object,
  338.       the main menu is displayed.  There are eight major choices on the main
  339.       menu represented by the following pushbuttons.
  340.     
  341.          New: Create a a new archive
  342.     
  343.          Update: Add files to an existing archive
  344.     
  345.          Extract: Unarchive all or selected files
  346.     
  347.          V-Scan: open and virus scan an archive.
  348.     
  349.          M/V-Scan: open and virus scan a list of archives in a given
  350.          directory.
  351.     
  352.          View: start the process to view an internal text or INF file in
  353.          an archive.
  354.     
  355.          Print: start the process to Print an internal text file in an
  356.          archive.
  357.     
  358.          Delete: start the process to delete an internal file in an archive.
  359.     
  360.       In addition, there are two selections on the menu bar.  Choose
  361.       "Configure" to change the variable settings that were initially set
  362.       during installation.  This will start the AFE-CFG program which should
  363.       have been installed in the same directory as AFE.  The interface for
  364.       making the changes is similar to that of the installation program.
  365.       When you are all done, or if you abort the process, you will be
  366.       returned to AFE.  More about the Config program, later.
  367.     
  368.       "About" will display a window with product information and how to
  369.       contact the author.
  370.     
  371.     
  372.       2. File Selection Window
  373.     
  374.       This same file selection window is used for many different file
  375.       selection operations.  THE KEY TO UNDERSTANDING WHAT YOU ARE BEING
  376.    
  377.    31 March 1994                    Page 6                   AFE Version 2.3
  378.    -------------------------------------------------------------------------
  379.       SHOWN IS THE CAPTION DISPLAYED ON THE TITLEBAR AND THE PUSHBAR 
  380.       BENEATH THE DIRECTORY WINDOW.  More about this at the appropriate
  381.       times.
  382.  
  383.       File selection is done by clicking the left mouse button on the file
  384.       of choice to highlight it.  If this is a single file choice, then
  385.       double clicking has the same effect as pressing the "OK" button.  When
  386.       a single file choice is appropriate, clicking on another filename will
  387.       unselect a previously selected file.  When a multifile choice is
  388.       apropriate, unselecting a file previously selected is accomplished by
  389.       clicking the highlighted filename.
  390.     
  391.       To change directories, double-click (or highlight and enter) on the
  392.       directory name desired in the directories list.  To go a level higher
  393.       in the directory tree double-click the ".." on top of the list.
  394.     
  395.       Changing to a different drive is accomplished by single-clicking the
  396.       down arrow alongside the displayed drive letter.  This reveals a
  397.       list of available drives on the system (or LAN).  Single click the
  398.       drive letter of choice.
  399.     
  400.       Note: the first time a particular drive is scanned, its directory list
  401.       is saved in a queue for the purpose of speedier list displays.  These
  402.       directory lists are maintained until the system is rebooted.  The
  403.       "Directory Reset on this Disk" pushbar is provided so that you can
  404.       update the directory list for the particular drive being displayed
  405.       should you add or delete a directory during the current OS/2 session.
  406.     
  407.       While an archive is opened to the temporary directory, the pushbar's
  408.       label reads "Open Folder".  At this point, pushing the bar will result
  409.       in a folder being opened containing all the file objects from the
  410.       archive.  From this folder, an executable program may be run by
  411.       double-clicking on it's object.  A text file may be dragged and
  412.       dropped on a viewer object.  If an archive file is contained within
  413.       the archive, its object may be dragged and dropped on the AFE
  414.       program object to start another session of AFE on this file.
  415.     
  416.       If you change directory while in the course of choosing an archive
  417.       to open for processing, that directory then becomes the default ARC
  418.       DIRECTORY for that AFE session, unless you change directory again
  419.       while in this mode.  It reverts back to the pre-configured ARC
  420.       DIRECTORY when you create a new archive or start a new AFE session.
  421.     
  422.       If you change directory while in the course of choosing files to
  423.       include in a new or updated archive, that directory then becomes the
  424.       default PICK DIRECTORY for that AFE session, unless you change
  425.       directory again while in this mode.  It reverts back to the pre-
  426.       configured PICK DIRECTORY when you start a new AFE session.
  427.     
  428.       3. Creating a New Archive
  429.     
  430.       Pressing "New" from the main menu brings you to the Create Archive
  431.       submenu.  After choosing the type of archive you want to create, the
  432.       filename window will become enabled for you to type in the name of
  433.     
  434.    31 March 1994                    Page 7                   AFE Version 2.3
  435.    -------------------------------------------------------------------------
  436.       your new creation.  Note that the archive type may be changed until
  437.       you press "OK".  Also note that if you want the new archive to be
  438.       created in some other path besides the ARC DIRECTORY, you may type a
  439.       full path spec before the archive name.  Either way, DO NOT include
  440.       the archive extension when you type the name.
  441.     
  442.       After pressing "OK" you will be shown the file selection window.
  443.       The default directory displayed is that which you set as your
  444.       "PICK DIRECTORY" during installation/configuration.
  445.     
  446.       The titlebar caption reads "HIGHLIGHT FILE(S) TO ADD THEN OK, CANCEL
  447.       TO ABORT".
  448.     
  449.       If files are present in this directory, one of the pushbuttons below
  450.       filelist is labeled "All".  If the archive to be created will be
  451.       made up of all the files in just this directory, simply press "All"
  452.       to start the archive process.
  453.     
  454.       If you wish to select individual files, highlight them (the "All"
  455.       button will change to "OK"), then press "OK".  This action creates a
  456.       special subdirectory where the chosen files are stored.  As each
  457.       file is copied, the highlight will be removed.  The "Cancel" button
  458.       then changes to "Go".  If no other files are to be added, press "Go"
  459.       (or ESC) to create the archive.  If you wish to add other files
  460.       (perhaps from a different drive or directory), before pressing "Go",
  461.       highlight and "OK" those other files and press "Go" when all
  462.       selections are completed.
  463.     
  464.       The new archive is created in the directory you've designated as the
  465.       "ARC DIRECTORY" during installation/configuration.
  466.     
  467.       After the archive is created you are returned to the main menu.
  468.     
  469.     
  470.       4. Updating an Existing Archive
  471.     
  472.       The process is similar to creating a new archive as outlined above.
  473.       From the main menu, select "Update".  You will then be presented
  474.       with a file selection window.  The default directory that is
  475.       displayed is the "ARC DIRECTORY".
  476.     
  477.       The caption on the titlebar reads "HIGHLIGHT ARCHIVE TO UPDATE THEN
  478.       OK".  You choose the archive to be updated by highlighting the
  479.       filename and pressing "OK" or by double-clicking the filename.  You
  480.       can change drive/directory if the archive to be updated is
  481.       elsewhere.
  482.     
  483.       After the selection is made the display will be updated to show
  484.       your "PICK DIRECTORY".  From here, the process is identical to that
  485.       outlined above for creating a new archive.
  486.     
  487.       After you have completed a virus scan, view, print or delete action,
  488.       the file selection window is still displayed with the selected archive
  489.       still open.  At this point you may push the "Update" button at the top
  490.    
  491.    31 March 1994                    Page 8                   AFE Version 2.3
  492.    -------------------------------------------------------------------------
  493.       of window to update the current archive.  This will take you to the
  494.       point of selecting files to include in the update as stated above.    
  495.  
  496.  
  497.       5. Extract
  498.     
  499.       To extract files from an archive, "Extract" should be chosen from
  500.       the main menu.  This selection takes you to the file selection
  501.       window which lists the files found in the "ARC DIRECTORY".  The
  502.       caption on the titlebar reads "HIGHLIGHT ARCHIVE TO OPEN THEN OK".
  503.     
  504.       Select an archive from here, or you can change drive/directory and
  505.       select a file from somewhere else on the system.  Once the archive
  506.       is selected it will be opened and you will be taken to a file
  507.       selection window that displays a list of files within your archive.
  508.       The "current directory" window displays the name of the archive
  509.       file.  The caption on the titlebar reads "HIGHLIGHT FILES(S) TO
  510.       EXTRACT THEN OK".
  511.     
  512.       At this point, the "All" button is enabled to allow you to easilly
  513.       extract all the files in the archive.  Simply press "All" (or Enter)
  514.       to start the extraction process. If you choose to select specific
  515.       files, just highlight those.  When you do this, the "All" button
  516.       becomes the "OK" button.
  517.     
  518.       When all files are selected, push "OK" (or Enter).  If a single file
  519.       is what is desired, you can simply double-click that filename.
  520.     
  521.       However you have chosen to start the extraction, the selected files
  522.       are saved to your designated "UNARC DIRECTORY".  You are then 
  523.       returned to the main menu.
  524.     
  525.       "Extract" may also be chosen from the File Selection window after the
  526.       completion of View, Print, Scan or Delete operation.
  527.     
  528.     
  529.       6. V-Scan
  530.     
  531.       Choose V-Scan when you want to virus scan a single archive file,
  532.       then do other operations on the chosen archive.
  533.     
  534.       The choice takes you to the now familiar file selection window which
  535.       displays all the files in the "ARC DIRECTORY".  You may choose a
  536.       file from here or change drive/directory to scan a different
  537.       archive.  The caption on the titlebar reads "HIGHLIGHT ARCHIVE TO SCAN
  538.       THEN OK".  Select an archive by double-clicking the filename or
  539.       highlighting it and pressing "OK" (or Enter).
  540.     
  541.       The archive is opened, then scanned.  Progress is displayed on the
  542.       pushbar under the directory list box.  If OS2SCAN finds no problems
  543.       with the files in the archive, then you are notified with "No
  544.       Viruses Found" on the pushbar.  You may dismiss this dialog by
  545.       pressing "OK" (or Enter), then you may choose another action to
  546.       perform on this archive from the buttons across the top of the window.
  547.     
  548.    31 March 1994                    Page 9                   AFE Version 2.3
  549.    -------------------------------------------------------------------------
  550.       By pressing "Cancel" instead, you are returned to the main menu.
  551.  
  552.       If a problem is detected, then you are notified with an alarm sound
  553.       and a generated report is displayed by the file viewer that you've
  554.       designated in the "VIEWER EXECUTABLE" variable.  This report gives you
  555.       the details of what OS2SCAN found.
  556.     
  557.       If you have not defined a "VIEWER EXECUTABLE" then you are notified by
  558.       the alarm, plus a notification on the pushbar.
  559.     
  560.       In either case, when a problem is detected, a report file named
  561.       VSCANRPT.### (where ### is a random number) will be left behind in the
  562.       "ARC DIRECTORY"
  563.     
  564.       When you choose "V-Scan" from the choices on the file selection
  565.       window, virus scanning is immediately started on the currently
  566.       opened archive.  Operations from that point on are the same as
  567.       outlined in the previous section.
  568.     
  569.     
  570.    7. M/V-Scan
  571.     
  572.       Choose this option if there are several archives in a given
  573.       subdirectory which you wish to scan, or even if there is only one
  574.       archive to be scanned, but you wish to return directly to the main
  575.       menu after completing the scan (if you will have no other operations
  576.       to perform on the given archive).
  577.     
  578.       When you make this choice, a file selection dialog will be
  579.       displayed, listing the files in your "ARC DIRECTORY".  The caption
  580.       on the titlebar reads "HIGHLIGHT ARCHIVE(S) TO SCAN THEN OK".
  581.       Again, you may change drive/directory if desired.
  582.     
  583.       Select the archive(s) by highlighting each then pressing "OK" (or
  584.       Enter).
  585.     
  586.       Each archive is opened and scanned one at a time.  If no problem is
  587.       detected, you are notfied in the same way as for a single scan.  After
  588.       pressing "OK", the next previously selected archive is opened and
  589.       scanned.
  590.     
  591.       If a problem is detected by OS2SCAN, you are notified of the problem
  592.       the same way as with a single scan.  When you dismiss the virus report
  593.       from the viewer, or when you dismiss the dialog (in the absence of a
  594.       designated viewer), the next previously selected archive is scanned.
  595.       Note that whether a virus is detected or not, the temporary directory
  596.       where the archive file is opened is removed as soon as you dismiss the
  597.       report or dialog, and a new temporary directory is established for the
  598.       next archive.  If more than one archive is found to have a problem,
  599.       each will have its own unique VSCANRPT.###.
  600.     
  601.       After the completion of all scans you are returned to the main menu.
  602.     
  603.    31 March 1994                    Page 10                  AFE Version 2.3
  604.    -------------------------------------------------------------------------
  605.     
  606.       8. View, Print or Delete
  607.     
  608.       The file selection process for viewing, printing or deleting an
  609.       archive's internal file is the same, so all threes will be discussed
  610.       together.
  611.     
  612.       When one is chosen from the main menu, you are taken to a file
  613.       selection window which displays a list of files in your "ARC
  614.       DIRECTORY".  The caption on the titlebar reads "HIGHLIGHT ARCHIVE TO
  615.       VIEW (or "PRINT" or "DELETE") THEN OK".  You may select the desired
  616.       archive from here, or change drive or directory to choose an archive
  617.       from somewhere else.
  618.     
  619.       Select the archive file that contains the file that you wish to
  620.       view, print or delete by either double-clicking the filename or
  621.       selecting it and pressing "OK" (or Enter).
  622.     
  623.       This takes you to another file selection window which lists the
  624.       files within the archive.  The caption on the titlebar reads
  625.       "HIGHLIGHT FILE TO VIEW (or whatever) THEN OK".  The name of the
  626.       archive file is shown in the current directory window.  Select the
  627.       desired file.
  628.     
  629.       After any of these operations are completed you then may perform
  630.       another operation on this archive by selecting the next action from
  631.       the buttons across the top if the file selection window. Had you 
  632.       chosen the "View" mode, the selected file is loaded into the program
  633.       you've designated as "VIEWER EXECUTABLE".  If this file is a tagged
  634.       .INF type file and you've opted to enable an "INF EXECUTABE" in
  635.       installation/configuration, then the file will be loaded into that.
  636.  
  637.       From this point you can perform other operations in AFE from the
  638.       file selection window, or view and dismiss the file in the viewer. 
  639.       If in "Print" mode, the selected file is sent to the OS/2 print
  640.       spooler, and you may continue other operations in AFE.
  641.     
  642.     
  643.       9. Exiting AFE
  644.     
  645.       There are a few different ways to exit AFE.  From the main menu you
  646.       may simply press "EXIT" (or ESC).  You may also double-click the AFE
  647.       icon on the titlebar.
  648.     
  649.       AFE may be exited from the the OS/2 window list as with any other
  650.       program.  Note that if you currently have an archive file opened when
  651.       you do this, the "cleanup" routine will not be performed and AFE's
  652.       temporary work directory will not be cleaned out and removed.
  653.    
  654.    31 March 1994                    Page 11                  AFE Version 2.3
  655.    -------------------------------------------------------------------------
  656.     
  657.       10. Configure
  658.     
  659.       If you wish to change any of the variables that AFE uses, you should
  660.       select "Configure" from the menu bar on the main menu (mouse click
  661.       or Alt-C).  This starts AFE-CFG.EXE.  Note that AFE-CFG will only
  662.       run if started from AFE.
  663.     
  664.       The interface is similar to that of the installation program for the
  665.       variable selections, except that the default settings shown in the
  666.       entry fields are the current settings found in AFE.CFG.  For the
  667.       settings that you don't want to change, simply press "Okay" (or
  668.       Enter).
  669.     
  670.       Note that if you "Abort" at any time during the configuration process,
  671.       NO CHANGES THAT YOU MAY HAVE MADE WILL BE SAVED!!!
  672.     
  673.       When configure is completed  AFE restarts with the new settings
  674.       (provided you haven't modified the desktop object that AFE-INST
  675.       created in such a way that changed its WPS handle).
  676.     
  677.       While AFE.CFG is an ASCII file and may be modified with an editor,
  678.       this is NOT RECOMMENDED for two main reasons.  One, only the variables
  679.       themselves are in the file with no definitions.  It is critical to
  680.       AFE's successful performance that these variables are in the correct
  681.       order and the correct format, and that no extraneous information is
  682.       within the file.
  683.     
  684.       Secondly, the first time AFE is run, the AFE.CFG file settings are
  685.       stored in a queue so that subsequent startups of AFE do not require
  686.       reading AFE.CFG from disk.  When you run "Configure", this queue is
  687.       flushed and the new settings are read from disk when AFE is restarted.
  688.       If you modify AFE.CFG another way, the settings do not take effect
  689.       until the system is rebooted.
  690.     
  691.     
  692.       11. Internal Archive Detection
  693.     
  694.       In the process of opening an archive (for unarchiving, viewing,
  695.       printing or virus scanning), AFE checks for other archives within it
  696.       (by examining the file extensions, looking for ZIP, LZH, ZOO or ARJ).
  697.     
  698.       If one or more is detected, the file selection dialog is displayed
  699.       listing only the archive files within the archive.  The caption on the
  700.       titlebar reads something like "ZIPFILES IN ARCHIVE, HIGHLIGHT FILE(S)
  701.       TO EXTRACT THEN OK", the first word depending on the type of archive
  702.       file found.
  703.     
  704.       You may, at this time, select any, all or none of these files to
  705.       unarchive along with the other files in the original archive.
  706.       After the selection is made, you will proceed as normal.
  707.     
  708.    31 March 1994                    Page 12                  AFE Version 2.3
  709.    -------------------------------------------------------------------------
  710.     
  711.       12. Archive Errors
  712.     
  713.       AFE examines the exit codes of the various archive programs it
  714.       calls.  If an exit code is returned other than success, AFE reports
  715.       that the archive it tried to manipulate is errored or not an archive
  716.       file (of the ZIP, LZH, ZOO or ARJ type).  The return code from the
  717.       archive program is displayed so that you may check the documentation
  718.       from that program for an explanation.  The exception to this is when
  719.       the file in question does not have one of the regular archive file
  720.       extensions and all the archivers are tried.
  721.     
  722.       Note that if you have defined the appropriate archiver executable with
  723.       the wrong program, it is possible that you will get this error dialog.
  724.     
  725.     
  726.       13. TryAll Subroutine
  727.     
  728.       If the archive you have chosen to open or update does not have an
  729.       extension of ZIP, LZH, ZOO or ARJ, AFE will still attempt to work with
  730.       it.
  731.     
  732.       The TryAll subrountine is called automatically and runs the "test"
  733.       mode of all (and only) the archivers you have defined in
  734.       configuration.  If it detects success from one of the archivers it
  735.       then calls the appropriate subroutine to open or update the archive.
  736.     
  737.       If it doesn't detect success from any of the defined archive
  738.       programs defined, it reports an error as outlined in the previous
  739.       section.
  740.     
  741.     
  742.       14. Variable Errors
  743.     
  744.       In many cases, where possible AFE disables the appropriate
  745.       capability if you do not define the corresponding executable.  For
  746.       example, if you do not define a program for the "ZIPPER EXECUTABLE"
  747.       the "ZIP" pushbutton on the create archive submenu is disabled.
  748.     
  749.       If AFE detects that a program it wants to call doesn't exist, then
  750.       you are notified with an error message, which names the appropriate
  751.       variable in question.  A similar approach is taken with the paths
  752.       you've defined for your default directories.
  753.     
  754.       For example, if you have not defined a "ZIPPER EXECUTABLE" and then
  755.       try to update and existing ZIP file, you will be notified via the
  756.       above mentioned error message.
  757.     
  758.    31 March 1994                    Page 13                  AFE Version 2.3
  759.    -------------------------------------------------------------------------
  760.     
  761.       15. Miscellaneous Tips
  762.     
  763.       If you want to work with an existing archive, then start AFE by
  764.       dragging and dropping the archive file on the AFE desktop object.  You
  765.       may also double-click the archive file (assuming that you haven't
  766.       removed the file associations in the AFE desktop object).
  767.     
  768.       Hitting ESC from any menu is equivalent to pushing the EXIT, CANCEL,
  769.       or equivalent, button.
  770.     
  771.       Hitting ENTER from any menu will "push" the button that the
  772.       "focus" is on.  The "focus" can be moved from button to button
  773.       or window to window with the tab key.
  774.     
  775.       When selecting files to include in an archive, make sure that you
  776.       highlight AND "OK" every file you want!  As mentioned above,
  777.       "Go" from this dialog will not add any more files to the list even
  778.       if files are highlighted.  Actually, there is a reminder of this on
  779.       the titlebar of the file selection dialog. If you have not yet
  780.       chosen any files, you'll be returned to the main menu.
  781.     
  782.       After completion of many operations, you are returned to file
  783.       selection window with the archive still open, ready for further
  784.       activity.  The two exceptions to this are completion of an
  785.       extraction operation, or completion of a create/update operation.
  786.       This design just made logical sense to me.
  787.     
  788.       You may change the relative location of all dialogs of AFE by dragging
  789.       the main menu to a different location.  For example, if you want all
  790.       dialogs to appear in the upper right corner of the screen, drag the
  791.       main menu there.  All subsequent dialogs will appear in the upper
  792.       right.  Note that the location is maintained only for that particular
  793.       session of AFE.  The default is to center all dialogs.
  794.     
  795.       If you have started AFE with multiple archive file "drops", the file
  796.       selection window for each will be stacked upon each other.  "Peel" the
  797.       layers to address each archive.  The name of the archive will be
  798.       different in each "Current Directory" window.
  799.     
  800.       Note that while AFE supports multiple sessions, it is not
  801.       recommended that the program be started as outlined above, since the
  802.       various sessions will be competing with each other for the disk
  803.       drive and the net result will be that it takes longer to open all
  804.       the files "at the same time" than it would to drop individual archives
  805.       one at a time after the previous archive is already opened.
  806.     
  807.       Once AFE is running, you may still open additional sessions by
  808.       dragging another archive to the AFE desktop object.  If you started
  809.       AFE via an archive file drop, you can also start another AFE session
  810.       by double-clicking the desktop object.
  811.     
  812.       AFE should handle long filenames, filenames and archive file names
  813.     
  814.    31 March 1994                    Page 14                  AFE Version 2.3
  815.    -------------------------------------------------------------------------
  816.       with spaces without fail.  This is assuming that you are running
  817.       OS/2's HPFS.
  818.     
  819.     
  820.     
  821.    E. Cautions and Limitations
  822.     
  823.    The graphics for AFE were developed on an 800x600 desktop, and are
  824.    visually pleasing on 640x480, as well.  I've noticed that in 1024x768
  825.    mode that the buttons on the various menus are slightly offset.  
  826.    Registered users will be sent both the 800x600/640x480 and the 1024x768
  827.    versions.
  828.     
  829.    When (DOS) ARJ is executed, it forces full screen mode. While I believe
  830.    there may be a workaround for this, it would cause extra work for the
  831.    user to configure AFE.  Since the OS/2 version of ARJ is in the works,
  832.    and the DOS version doesn't support HPFS style file names, I plan to to
  833.    wait for the OS/2 version.  Again, if registered users request a nearer
  834.    term fix for this, I will work on it.
  835.     
  836.    When extracting files, if a file in your designated "UNARC DIRECTORY"
  837.    exists with the same name as a file being extracted, it will be
  838.    overwritten.
  839.     
  840.    If an archive file is detected within your archive (identified by
  841.    extension), you will be notified.  If you are going to virus scan, choose
  842.    the option to process this file so all of the internal files are scanned.
  843.     
  844.    If you use a program like PSPM/2 or another "brute-force" type program to
  845.    close AFE, cleanup will not be performed. In addition, you run the risk
  846.    of "hanging-up" resources and not being able to use AFE again without a
  847.    system reboot.
  848.     
  849.    If you use the OS/2 window list to close AFE, the cleanup rountine will
  850.    not be run.  If you have an archive open at the time, AFE's temporary
  851.    directory will be left behind perhaps containing files from the
  852.    archive.
  853.     
  854.    AFE doesn't allow existing archives to create directories during
  855.    extraction, nor does it save path information in newly created
  856.    archives.
  857.     
  858.    You will have problems with filenames with multiple periods in them
  859.    with ARJ.
  860.     
  861.    AFE was developed and tested under OS/2 2.1 GA and 2.11.  For all I
  862.    know it may work with 2.0 or any of the 2.1 betas, but it has not been
  863.    tested with them.  Why would anyone want to run anything before 2.1 GA?
  864.     
  865.    4OS2 Users: If the VX-REXX "Console" window appears momentarily when
  866.    AFE calls one of the archivers or OS2SCAN, make sure you put @echo off at
  867.    the top of your 4START.CMD (or .BTM).  If the console still opens
  868.     
  869.    31 March 1994                    Page 15                  AFE Version 2.3
  870.    -------------------------------------------------------------------------
  871.    and displays an output message from a program you call in 4START.CMD, try
  872.    a redirect to null ( >null) on the line that runs that program. If the
  873.    console displays a message like "INVALID VIO CALL", I believe this is
  874.    related to a combination of 4OS2 and certain drivers.  While any of these
  875.    displays are annoying, they should NOT effect the functioning of AFE, or
  876.    the program that is being run.
  877.     
  878.    Another way around this is change back the the COMSPEC statement in
  879.    CONFIG.SYS to use OS/2's CMD.EXE while leaving the SHELL statement
  880.    pointing to 4OS2.EXE.  While this will retain the command line benefits
  881.    of 4OS2, CMD.EXE will be used by AFE.
  882.     
  883.     
  884.     
  885.    F. Contacting the Author
  886.     
  887.    Please contact me with bug reports or other comments via email. I have
  888.    spent many hours building and reworking this program, and would
  889.    appreciate any feedback, positive/negative.  There are several ways
  890.    to email me.  If you have internet access, send mail to:
  891.     
  892.       hmweine@pb1.pacbell.com
  893.     
  894.    If you have access to ILINK, send a message (in the OS/2 conference)
  895.    to "Howie Weiner".
  896.     
  897.    I log onto a few BBSes on an everyday basis.  You can leave mail to
  898.    "Howie Weiner" on ATT-PAC Auntie BBS in Dublin, Ca., (510)829-6062,
  899.    H-D-M Auntie BBS in Concord, Ca., (510)682-1371, or Sempervirens PC Board
  900.    BBS in Pittsburg, Ca., (510)432-7579.
  901.     
  902.    Note: ATT-PAC allows leaving messages on first logon.  Also, any new
  903.    releases of AFE will be posted there first!
  904.     
  905.    Both ATT-PAC and Sempervirens allow download of the AFE package on
  906.    first logon.  Thanks to SYSOPs Randy Young and Nancy Miller.
  907.     
  908.     
  909.     
  910.    G.  Copyright Notices and Disclaimer
  911.     
  912.    AFE or Archive Front End is Copyright 1993, 1994 by H.M. Weiner
  913.     
  914.    OS/2 is a registered trademark of International Business Machine
  915.    (IBM) Corp.
  916.     
  917.    ZIP is copyright by Mark Adler, Richard B. Wales, Jean-loup Gailly,
  918.    Kai Uwe Rommel
  919.     
  920.    UNZIP is copyright by Info-ZIP, portions by S. H. Smith
  921.     
  922.    LHA is copyright by Haruyasu Yoshizaki
  923.     
  924.    LH2 is copyright by Peter Fitzsimmons
  925.     
  926.    31 March 1994                    Page 16                  AFE Version 2.3
  927.    -------------------------------------------------------------------------
  928.     
  929.    ZOO is copyright by Rahul Dhesi
  930.     
  931.    ARJ is copyright by Robert Jung
  932.     
  933.    OS2SCAN is copyright by McAfee Associates
  934.     
  935.    VX-REXX is copyright by WATCOM
  936.     
  937.     
  938.    AFE IS PROVIDED AS IS AND COMES WITH NO WARRANTY OF ANY KIND, EITHER
  939.    EXPRESSED OR IMPLIED.  IN NO EVENT WILL THE AUTHOR BE LIABLE FOR ANY
  940.    DAMAGES RESULTING FROM THE USE OF THIS SOFTWARE.
  941.     
  942.     
  943.     
  944.    H. What's New (AFE History)
  945.     
  946.    1.1 - 9/6/93 - First release of AFE, Freeware.  Written in REXX and
  947.    VREXX.
  948.     
  949.    2.0 - 10/15/93 - First Shareware release written in VX-REXX to get around
  950.    the limitations of VREXX.
  951.     
  952.    2.01 - 10/31/93 - If you tried to overwrite an archive that you started
  953.    AFE with by drag and drop, AFE would terminate soon after the program
  954.    deleted the original.  Still not quite sure why it did this
  955.    as this would not occur if you started AFE from the command line with the
  956.    file name as an argument, but probably something in the WPS.  Got around
  957.    this by changing the "Overwrite" button to "Update".  The
  958.    orginal archive is no longer deleted, but updated with the new files.
  959.     
  960.    When creating or updating an archive and the "PICKDIR" is empty, the
  961.    PICKDIR\* button is now disabled.
  962.     
  963.    When updating an existing archive and at the PICKDIR\* vs Select submenu,
  964.    somtimes a fully qualified filename would run off the title-bar.  Added
  965.    code to just display the filename, itself.
  966.     
  967.    When 4OS2 was used and the mode command was utilized in the
  968.    4START.CMD to set lines to something other than 25, the VX-REXX Console
  969.    opened with an error message when an external executable was called.
  970.    There was no problem with program function, just
  971.    cosmetically annoying.  Now fixed.
  972.     
  973.    I decided to spell "Copyright" correctly! (how embarrassing)
  974.     
  975.    2.2 - 1/15/94 - The file selection dialog is all new to accomodate
  976.    multifile selection, where appropriate.
  977.     
  978.    Mutliple archive V-Scan added by user request.
  979.     
  980.    AFE's temporary workdirectory is now named "\~AFETEMP.###" (###=random
  981.    number)
  982.     
  983.    31 March 1994                    Page 17                  AFE Version 2.3
  984.    -------------------------------------------------------------------------
  985.    When a virus is detected on a single scan, the main menu does not
  986.    appear until after the virus report is dismissed.  After the report
  987.    is dismissed on multiscans, the next selected archive (if any) is
  988.    scanned.
  989.     
  990.    Fixed a small problem that looks like it goes back to 2.01. When archives
  991.    are found within archives, a list is displayed by archive
  992.    type.  You were supposed to be able to select several or all (if there
  993.    was more than one) to unarchive.  What I found was that it only
  994.    unarchived the first selected. FIXED IT!
  995.     
  996.    Added support to view an internal .INF file with VIEW.EXE.
  997.     
  998.    Added support for (DOS version) ARJ.EXE per several user requests.
  999.     
  1000.    Changed the layout of AFE.CFG to simplify it and provide a AFE-CFG
  1001.    program to modify it that is called from AFE.
  1002.     
  1003.    Wrote a PM installation program.
  1004.     
  1005.     
  1006.    After the first time AFE.CFG is read from disk, it is stored in a QUEUE
  1007.    so that it doesn't have to be read from disk the next time.  This QUEUE
  1008.    stays active until the host system is rebooted or the user runs AFE-CFG
  1009.    from AFE.
  1010.     
  1011.    QUEUE the directory list for each disk the first time a particular disk
  1012.    is scanned for the file dialog.  This QUEUE stays active until the host
  1013.    system is rebooted or the user presses the "Directory Reset" for the
  1014.    particular disk being viewed.
  1015.     
  1016.    During the "cleanup" routine user is notified of progress via a banner
  1017.    that says "PERFORMING HOUSEKEEPING ...".
  1018.     
  1019.    Corrected some display bugs with certain combinations of 4OS2 and video
  1020.    drivers and UNZIP run under AFE.
  1021.     
  1022.    When more archive files are found within an archive, and the user is
  1023.    presented with a list of those archive(s), the cancel button is now
  1024.    changed to "None".
  1025.     
  1026.    Eliminated the printer window after the user chooses a file to print.
  1027.    This was present only to remind the user to make sure the printer was
  1028.    on and online before sending the file to the printer.  Since OS/2 manages
  1029.    the printer, this was probably unnecessary, so I eliminated it to reduce
  1030.    program size.
  1031.     
  1032.    Combined the New vs. Existing window and the New Archive Name window.
  1033.    Put the choice of archive type on this window.
  1034.     
  1035.    Now, to create a new archive or update and existing one you press
  1036.    "Archive" from the main menu.  A secondary menu will be displayed, and
  1037.    you want to update an existing file simply press "Existing" which will
  1038.    take you to the file menu.  If you press "New" then the archive type
  1039.     
  1040.    31 March 1994                    Page 18                  AFE Version 2.3
  1041.    -------------------------------------------------------------------------
  1042.    buttons will be enabled.  Select a type and then the name entry field
  1043.    will be enabled.  Until you hit OK, you can still change the archive
  1044.    type.
  1045.     
  1046.    Reworked the code that is accessed when an archive is opened for any
  1047.    reason and the archive doesn't have a proper extension.  Originally
  1048.    this routine was built for unarchiving only, and directly tried to
  1049.    unarchive.  Now that I'm also using this code to test for the type of
  1050.    archive when updating or creating, I've changed this to use the various
  1051.    archivers' "test" mode.  Once an errorlevel 0 is received the program
  1052.    jumps back to the appropriate routine for unarchiving or archiving
  1053.    depending on which test was passed.
  1054.     
  1055.    Added an "About" window to AFE.
  1056.     
  1057.    Removed closing copyright notice since there is now an "About" panel.
  1058.     
  1059.    Upgraded VX-REXX to 101b and c level.  New VROBJ.DLL (dated 11/19/93)
  1060.    required.
  1061.     
  1062.    2.3 - 3/26/94 - For this version, I've concentrated a lot on cleaning
  1063.    up the user interface.  You'll find that a lot of the miscellaneous
  1064.    notifications such as "scanning", "housekeeping", and "opening" have been
  1065.    integrated into the File Selection Window.  This seems to speed up the
  1066.    overall execution (or at least creates the illusion of speed) since time
  1067.    is not wasted destroying entire windows and creating new ones.
  1068.    One of the negative results is that is requires more code to change the
  1069.    stati of the various objects in the existing window.  This probably
  1070.    accounts for about half the growth of the resulting AFE.EXE with the
  1071.    new features accounting for the rest.
  1072.     
  1073.    I've offset some of the growth by eliminating the custom notification
  1074.    windows I had created for variable errors and archive error messages.  In
  1075.    their place, I've used one of the VX-REXX built in notification windows
  1076.    to notify the user of these errors.
  1077.     
  1078.    You'll find that the main menu has changed.  Their are separate buttons
  1079.    for creating a new archive ("New") and updating an existing one
  1080.    ("Update").  The "UnArchive" button has been changed to "Extract").
  1081.    And a new button has been added ("Delete") for deleting files from an
  1082.    existing archive.
  1083.     
  1084.    A tip: Pay attention to the text on the titlebar and the directory
  1085.    refresh button on the File Selection window.  These two things will
  1086.    keep you informed of status and directions to proceed.
  1087.     
  1088.    A file delete option can be selected from the main menu, or from the File
  1089.    Selection window when an open archive is displayed.
  1090.     
  1091.    Ability to open a folder of the workdirectory while you have an archive
  1092.    open, so you can execute a program from there, or drag 'n drop a text
  1093.    file on a LIST object, or even drag 'n drop an internal archive on the
  1094.    AFE object to initiate another session on that one.  Caution: If you open
  1095.    a file from the displayed folder, then dismiss the File Selection
  1096.     
  1097.    31 March 1994                    Page 19                  AFE Version 2.3
  1098.    -------------------------------------------------------------------------
  1099.    window, cleanup of the temporary working directory cannot be completed.
  1100.     
  1101.    You don't have to close the folder, itself.  After, cleanup has
  1102.    been completed, the folder will eventually go away.
  1103.     
  1104.    Detection (by file extension) of archives within archives infinite levels
  1105.    deep.   2.2 only checked one level deep.  I've tested this every which
  1106.    way I can think of and it seems to work well.
  1107.     
  1108.    Archive submenu eliminated.  Now, when you start AFE from a drag and
  1109.    drop, you go directly to the File display dialog where the buttons from
  1110.    the Archive Submenu now reside.  Also, after completing a View, Print, V-
  1111.    Scan, or Delete, you come back to the File Selection window, where
  1112.    you can initiate another action on the same archive.
  1113.     
  1114.    If an archiver exits with an error, the return code is now displayed on
  1115.    AFE's error message panel, and the filespec of the archiver that reported
  1116.    the error.  The one exception to this is when the file did not have an
  1117.    extension and all supported archivers have tried and failed.
  1118.     
  1119.    AFE now "remembers" the last directory from where you selected an archive
  1120.    for viewing, deleting, scanning, updating, extracting, or the directory
  1121.    where the archive was if AFE was started from an association or drag 'n
  1122.    drop.
  1123.     
  1124.    Similarly to the above, he now "remembers" the last directory where you
  1125.    picked files from to build or update an archive.  The next time you do
  1126.    one of these actions within the same AFE session, the File Selection
  1127.    window will display that directory first for you to select files to
  1128.    add.
  1129.     
  1130.    If you are creating a new archive, and you don't want it to end up in the
  1131.    ARC DIRECTORY, you can type a path in front of the archive name (omit the
  1132.    extension), and that's where it will end up.
  1133.     
  1134.    Found a few places where large blocks of code could be reused for
  1135.    different process by setting flags, elimiating many lines of fat. This
  1136.    reduced the overall program size by about 7K.
  1137.     
  1138.    Well folks, I was all ready to release AFE 2.3 and Watcom released
  1139.    VX-REXX 2.0.  So, I upgraded my version.  There are several new objects
  1140.    available in the new version, at least one I'll take advantage of in
  1141.    AFE 2.4.  What this did was to make a large VROBJ.DLL even larger!
  1142.     
  1143.    They also fixed a bug from previous versions which caused me to have to
  1144.    modify the code in AFE to avoid the program throwing up when run with the
  1145.    new DLL.
  1146.     
  1147.    Also, because I changed the code, it won't work right with the older DLL,
  1148.    so you'll have to upgrade both.
  1149.  
  1150.    I found a the way to list only the immediate subdirectories in the
  1151.    directory list window.   To see directories below those displayed, you
  1152.  
  1153.    31 March 1994                    Page 20                  AFE Version 2.3
  1154.    -------------------------------------------------------------------------
  1155.    double-click (or highlight selection, then enter) on the directory
  1156.    name.  To come up a level you double-click the "..".
  1157.  
  1158.    This results in SPEEDIER creation of the directory list, and alleviates
  1159.    the need to store the list in a QUEUE.  For best performance DO NOT
  1160.    designate a root directory for your "ARC DIRECTORY" or "PICK DIRECTORY".
  1161.  
  1162.