home *** CD-ROM | disk | FTP | other *** search
/ Programmer 7500 / MAX_PROGRAMMERS.iso / PROGRAMS / UTILS / COMPRESS / PK_TOOLS.ZIP / AM_READ.ME next >
Encoding:
Text File  |  1988-08-05  |  10.8 KB  |  254 lines
  1.  
  2.  
  3.          ARC-Manager Version 3.61 (Production) - AM_READ.ME
  4.          ==================================================
  5.  
  6.          PLEASE NOTE: This version of ARC-Manager expects (for the 1st
  7.          time) that BOTH PK files will have the extension .EXE (per v3.6
  8.          of PK Ware). **
  9.  
  10.          * As of version 3.6, it may be necessary to substitute (rename)
  11.            "JR" versions of PK in order to work with-in the memory
  12.            requirements of your system.
  13.  
  14.          ARC-Manager is donated to the public domain without restriction.
  15.          You may give, sell, benefit from this program as much as
  16.          possible.
  17.  
  18.          No special requirements are made by ARC-Manager, save a certain
  19.          pre-requisite hardware compatibility to the IBM standard
  20.          imposed by direct screen writes.
  21.  
  22.          The only other requirement is that the environment variable
  23.          "COMSPEC" be SET prior to loading ARC-Manager, as this
  24.          program locates and loads COMMAND.COM based on that
  25.          specification.
  26.  
  27.          ARC-Manager employs (and was inspired by) other excellent
  28.          public domain (shareware) utilities.  These include:
  29.  
  30.          Phil Katz's PKPAK and PKUNPAK, Vern Buerg's ARCF and S.H.
  31.          Smith's ARCTV and Paul Nance's ARCTOOLs.  These authors
  32.          have all made significant contributions well beyond that of
  33.          this modest front-end program.
  34.  
  35.          Unlike most menu/shell programs, ARC-Manager is not designed
  36.          simply to provide a menu structure for inexperienced users.
  37.  
  38.          ARC-Manager facilitates the use of the the programs by
  39.          allowing most all functions to be performed with just a few
  40.          keypresses.
  41.  
  42.          To use ARC-Manager, all the associated programs should be
  43.          placed in a common directory.  It is recommended that an
  44.          environment variable called "COMPATH" be SET using DOS's
  45.          SET command (SET COMPATH=X:\XXXXX) to point to this directory.
  46.          (This can most easily be accomplished by placing the command
  47.          in your AUTOEXEC.BAT)
  48.  
  49.          Also, you may optionally SET a standard working directory path
  50.          for your ARC files using the environment variable "ARCPATH".
  51.          This procedure is not required as you can specify (or over-ride)
  52.          a directory path by including the path when specifying the name
  53.          of the ARC file you are using.
  54.  
  55.          NOTE: If the ARC file you wish to specify is in the default
  56.                directory AND not in the "ARCPATH" established, you need
  57.                to inform ARC-Manager by specifying a path or drive
  58.                designation so that the "ARCPATH" setting will be ignored.
  59.                (If no "ARCPATH" is established, this step is unnecessary.)
  60.  
  61.          Menu selection is accomplished either by pressing the first
  62.          letter of each selection, or by scrolling up and down with the arrow
  63.          keys, and pressing enter when the desired option is highlighted.
  64.  
  65.          Command line syntax for ARC-Manager is simply:
  66.  
  67.          AM [path\arcfile[.ARC]] [text_color] [hilite_color] [background_color]
  68.  
  69.          Where text, hilite & background_color (integers) are optional
  70.          (ARC-Manager knows whether you are using a color or monochrome
  71.          configuration, and sets it's defaults accordingly), and
  72.          arc_file_name is also optional (although if not entered on
  73.          the command line, or when requested, it must (obviously) be
  74.          made known to ARC-Manager prior to performing any operations).
  75.          This may be accomplished by selecting "N"ame from the start-up
  76.          menu.
  77.  
  78.          Archive file names entered as a command line parameter may
  79.          not consist entirely of numbers.
  80.  
  81.          If you run a color system, ARC-Manager defaults to CYAN and WHITE
  82.          on BLACK (or whatever background setting is found in your palette).
  83.          You may however change the colors as described above using the
  84.          following color parameters:
  85.  
  86.                            0=Black
  87.                            1=Blue
  88.                            2=Green
  89.                            3=Cyan
  90.                            4=Red
  91.                            5=Magenta
  92.                            6=Brown
  93.                            7=White
  94.                            8=Yellow (text & hilite colors ONLY)
  95.  
  96.          If you decide you prefer colors other than the the default
  97.          colors, it would be best to create a .BAT file specifying your
  98.          choice of colors.  In this way ARC-Manager will display the
  99.          colors you selected each time it is run.
  100.  
  101.          The .BAT file can be created from the DOS prompt by typing
  102.          lines similar to those that follow (substitute your own
  103.          paths and color settings):
  104.  
  105.                   C>COPY CON: A.BAT      <ENTER>
  106.                   SET COMPATH=C:\ANYPATH <ENTER>
  107.                   SET ARCPATH=C:\ANYPATH <ENTER>
  108.                   %COMPATH%\AM %1 3 7 0 <ENTER>
  109.                   <F6><ENTER>
  110.  
  111.          ARC-Manager will trap errors in color parameters and default
  112.          to monochrome values should it detect identical foreground
  113.          and background color settings or invalid parameters.
  114.  
  115.          ARC-Manager monitors all other programs executed, trapping
  116.          any errors which they may encounter and returning to the
  117.          start screen on un-recoverable errors.
  118.  
  119.          Invariably, the authors of the programs ARC-Manager employs
  120.          will update their programs, often including version numbers in
  121.          the new filenames.  ARC-Manager should have little trouble using
  122.          such new versions as long as the authors do not alter existing
  123.          command syntax.  Simply rename the new versions to the default
  124.          names itemized on ARC-Manager's start-up screen.
  125.  
  126.          If you use ARC-Manager, and feel the authors of the programs
  127.          ARC-Manager employs have made a contribution to your life
  128.          at the keyboard, PLEASE consider making a contribution to
  129.          those respective authors!
  130.  
  131.          REVISION HISTORY:
  132.          -----------------
  133.  
  134.          v1.0  - Not released to public.
  135.  
  136.          v1.1A - First public release.
  137.  
  138.          v1.2A - Fixed bug that would not allow drive only (d: as
  139.                  opposed to d:\) specification to over-ride ARCPATH
  140.                  setting.
  141.  
  142.                  Fixed bug that improperly re-positioned menu screen
  143.                  after performing any function that scrolled beyond a
  144.                  single screen.
  145.  
  146.          v1.3A - Added work file name to screen and made other minor
  147.                  screen revisions.
  148.  
  149.                  Removed code for a delay after "SPECIFY FILE" message
  150.                  and wait for keypress instead.
  151.  
  152.                  Made minor revisions to error messages.
  153.  
  154.                  Added ability to list file(s) to printer.
  155.  
  156.          v2.00 - Added procedure to check for text file before allowing
  157.                  Find or Print.
  158.  
  159.                  Added procedure to abort FIND of no text string entered.
  160.  
  161.                  Eliminated use of XONE as in previous versions.
  162.                  Substituted ARCTV's ability to RE-ARC in single new archive.
  163.  
  164.                  Added procedure to test integrity of archives/files.
  165.  
  166.                  Revised help screen accordingly.
  167.  
  168.          v2.10 - Fixed oversight which disallowed a space_character to
  169.                  be input while entering parameters during EXTRACT
  170.                  procedure.  This effectively limited EXTRACTions to
  171.                  be placed in the default directory.
  172.  
  173.                  Added forth parameter for background color.
  174.  
  175.                  Fixed "Command:" and "FREE SPACE" (now BYTES FREE) to use
  176.                  user designated colors along with rest of menu.
  177.  
  178.          v2.20 - Edited help screen and window texts.
  179.  
  180.                  Fixed so CR for 'N'ew name means no change instead of 'NONE'.
  181.  
  182.                  Further optimized code for speed.
  183.  
  184.                  Added /W (ignore whitespace) to ARCF parameters. (also
  185.                  ignores case)
  186.  
  187.                  Refined algorithm employed to set/check user designated
  188.                  colors.
  189.  
  190.          v2.30 - Improved direct screen writes to reduce snow on CGA's.
  191.  
  192.                  Revised file specification handling to require a single
  193.                  asterisk to mask all files.  This allows a carriage return
  194.                  to abort the request.
  195.  
  196.          v2.40 - Added disk file directory option. (displays 150 files
  197.                  maximum to screen)
  198.  
  199.                  Edited menu & help screens to reflect change above.
  200.  
  201.          v2.41 - Fixed bug that confused monochrome monitor screen locates
  202.                  when displaying filenames with VIEW option.
  203.  
  204.                  Fixed inconsistency that required *.* to be entered in lieu
  205.                  of a '*' when specifying a drive designation for files to
  206.                  be ADDed to an archive. (i.e. 'A:*' will now ADD all files
  207.                  on drive A: to the named archive.)
  208.  
  209.          v2.50 - Fixed bugs associated with DOS 3.3 screen IO.
  210.  
  211.                  Changed key-grab to no longer misread function and
  212.                  directional keys as valid.
  213.  
  214.          v2.51 - Fixed bug that confused ARCPATH on start-up,
  215.                  and caused errors if command line parameters confused.
  216.  
  217.                  Added display path to screen.
  218.  
  219.                  ARC-Manager now uses default directory if no file is
  220.                  specified on start-up.
  221.  
  222.          v3.60 - Changed PK file extensions used to .EXE as per v3.6 of
  223.                  PK/PKUNPAK.
  224.  
  225.                  Version now agrees w/latest PKPAK version number.
  226.  
  227.                 -I parameter now used to ADD/UPDATE only changed files.
  228.  
  229.                  M & C parameters added to verbose listing using PK instead
  230.                  of PKX.  (Display More & Comment)
  231.  
  232.          v3.6A - Added <C>omment menu selection for both files and archives.
  233.  
  234.                  Updated help screen accordingly.
  235.  
  236.                  Altered user interface to employ highlighted scroll bar
  237.                  for menu.  This to allow more room on startup screen.
  238.  
  239.          v3.61 - Changed PK/PKXARC filenames to PK/PKUNPAK.
  240.  
  241.                  Padded highlighted option bar to uniform length for
  242.                  eye appeal in monochrome mode.
  243.  
  244.                  Changed Add/Update from 'I' to 'A' parameter as per
  245.                  pre v3.60 due to inconsistent error message "No file(s) found"
  246.                  when file upgrade requested has not been revised, and
  247.                  addition of 'X' parameter under this selection.
  248.  
  249.                  Fixed error where cursor was left off during shell.
  250.  
  251.                  Revised start screen to include menu selection key
  252.                  instruction bar.
  253.  
  254.