home *** CD-ROM | disk | FTP | other *** search
/ Programmer 7500 / MAX_PROGRAMMERS.iso / PROGRAMS / UTILS / COMPRESS / AM553.ZIP / AM.DOC next >
Encoding:
Text File  |  1991-01-29  |  35.7 KB  |  922 lines
  1.  
  2.  
  3.  
  4.  
  5.                                  ArcMaster 5.53
  6.  
  7.                      Copyright 1987/88/89/90/91 by New-Ware
  8.  
  9.                               All Rights Reserved
  10.  
  11.  
  12.  
  13.     1  - PROLOG
  14.  
  15.  
  16.                                    DISCLAIMER
  17.  
  18.          New-Ware hereby disclaims all warranties relating to this product,
  19.     whether express or implied, including without limitation any implied
  20.     warranties of merchantability or fitness for a particular purpose. New-
  21.     Ware cannot and will not be liable for any special, incidental,
  22.     consequential, indirect or similar damages due to loss of data or any
  23.     other reason, even if New-Ware or an authorized New-Ware agent has been
  24.     advised of the possibility of such damages.  In no event shall the
  25.     liability for any damages ever exceed the price paid for the license to
  26.     use software, regardless of the form and/or extent of the claim.  The
  27.     user of this program bears all risk as to the quality and performance of
  28.     the software.
  29.  
  30.                                      LICENSE
  31.  
  32.          ArcMaster is a Shareware product.  As such, it is made available to
  33.     the general computing public for evaluation.  Users are licensed to
  34.     operate ArcMaster on their personal computers for the purpose of test
  35.     and evaluation on a trial basis for a limited trial period.  It is not
  36.     possible to reasonably define any definitive limits of a fair and
  37.     equitable time period for evaluation, therefore it is left to the user's
  38.     judgment and sense of fair play as to the time required to make a
  39.     decision as to its usefulness.  If the user decides the program is not
  40.     of sufficient merit to warrant purchase through registration with New-
  41.     Ware, the program should be removed from their personal computer.
  42.     Otherwise, if the program is deemed useful and is in regular use on the
  43.     user's personal computer system, registration with New-Ware is required.
  44.  
  45.          Registered users are those users that elect to pay for ArcMaster
  46.     and register that payment with New-Ware.  By virtue of registration and
  47.     payment for the program, registered users are granted a license to
  48.     continue to utilize the program on their personal computer for as long
  49.     as they choose.  This license authorizes the user to use the program on
  50.     any personal computer system he or she may own so long as the program is
  51.     operated on only one computer system at a time.
  52.  
  53.          Site licenses for use of ArcMaster on multiple computers are
  54.     available upon request at a reduced fee that is based upon the number of
  55.     single machines licensed for use.
  56.  
  57.  
  58.     2  - REGISTRATION
  59.  
  60.  
  61.         ArcMaster is sole property of New-Ware Shareware products. The
  62.     Shareware version, and ONLY that version, may be freely copied and
  63.  
  64.  
  65.  
  66.                                      - 2 -
  67.  
  68.  
  69.  
  70.     transferred to individual parties for evaluation purposes.  The
  71.     Shareware version, and ONLY that version, may be posted on Bulletin
  72.     Board systems (BBS) for electronic access as long as NO FEE is charged
  73.     for its distribution except for private BBS operations that charge a
  74.     regular user subscription fee.  Computer information services such as
  75.     Compuserve (CIS), Genie, etc., are authorized to post this product for
  76.     subscriber access.  The Shareware version of ArcMaster may NOT be
  77.     distributed on diskette by any disk distributor/vendor that charges more
  78.     than $12.00 for the diskette upon which the program and attendant files
  79.     are recorded without written consent from New-Ware.
  80.  
  81.          ArcMaster is a fully functional Shareware product.  Shareware is a
  82.     computer program distribution/marketing method that permits potential
  83.     buyers to thoroughly try the program prior to purchase. It is NOT free
  84.     and it is not in the Public Domain.  If, after evaluating the program,
  85.     you find it to be useful enough to use it on a regular basis, you are
  86.     expected to pay for it by registering with New-Ware. The registration
  87.     fee is $35.00 and the registered version, which is NOT distributed as
  88.     Shareware, will not contain the opening Shareware screen nor the closing
  89.     messages.
  90.  
  91.          Those who have registered a previous version (prior to version 4.0)
  92.     of ArcMaster may purchase ArcMaster version 4.xx as an upgrade for
  93.     $5.00.  Please be advised that I cannot accept credit card orders for
  94.     the upgrade.  Checks/cash only, please!
  95.  
  96.     You may register ArcMaster in one of three ways:
  97.  
  98.     1) By mail with check or money order to:
  99.  
  100.                              New-Ware
  101.                              8050 Camino Kiosco
  102.                              San Diego, CA 92122-1820
  103.  
  104.     2) By telephone with Visa/Mastercard to:
  105.  
  106.                              New-Ware
  107.                              (619) 455-6225
  108.  
  109.     3) Electronically through the New-Ware BBS:
  110.  
  111.                    New-Ware Shareware Products BBS
  112.                    Running Wildcat! version 2.10p
  113.  
  114.                    (619) 450-3257 - Node #1 1200/2400/9600 (HST)
  115.                          455-5226 - Node #2 1200/2400
  116.  
  117.     The New-Ware Shareware Products BBS operates 24 hours per day, 7 days
  118.     per week.  Node #1 is dedicated to registered users only.  Nodes #2 is
  119.     open to all callers.  Users registering via the BBS receive access to
  120.  
  121.  
  122.  
  123.                                      - 3 -
  124.  
  125.  
  126.  
  127.     the latest registered version within 1 day after leaving their credit
  128.     card data.  Users who register by mail or phone may also access the
  129.     registered version by BBS, but you  MUST log on and leave a comment to
  130.     the sysop to the effect that you are a registered user and desire
  131.     access.  The author can also on CIS via PPN 71535,665 (please use
  132.     EASYPLEX).
  133.  
  134.     This Shareware version of ArcMaster may be freely copied and passed on
  135.     to other individual users for their evaluation.  Disk vendors and/or
  136.     distributors that desire to distribute ArcMaster must adhere to the
  137.     guidelines presented in VENDOR.DOC.
  138.  
  139.     Press Alt-R from the main ArcMaster Display or from the closing
  140.     Shareware screen to display the registration window.  Prompts will be
  141.     issued for the pertinent information and you will have the option of
  142.     printing the registration form when the form is completed.
  143.  
  144.     CALIFORNIA RESIDENTS MUST INCLUDE 7% STATE SALES TAX!
  145.  
  146.          I support my software.  One of the great strengths of the Shareware
  147.     concept is the interaction between the program author and the users.
  148.     Many of the features contained in ArcMaster are the result of user
  149.     input.  If you have a problem evaluating this program or desire to make
  150.     a suggestion or comment (or even a complaint), please do not hesitate to
  151.     contact me.  Even if you register ArcMaster, if you later determine that
  152.     it is unsuitable for your use, you may contact me for a refund.  It is
  153.     not necessary that you be a registered user to contact me for technical
  154.     support.  Technical support will be available through the U.S mail,
  155.     telephone, or the New-Ware BBS.
  156.  
  157.  
  158.     3  - VERSION HISTORY
  159.  
  160.  
  161.     5.0   - Redesigned the directory tree display function.
  162.           - Incorporated new directory catalog storage and
  163.             maintenance function.
  164.           - Added the -P (store paths) option to the ZIP menu.
  165.           - Added the capability to handle and view ZIP files
  166.             with stored path information.
  167.  
  168.     5.1   - Added capability to view contents of a ZIP file that
  169.             is stored inside a ZIP file.
  170.           - Added capability to set date/time stamp for tagged
  171.             files.
  172.           - Added the -$ (restore volume label) switch to the
  173.             unZIP submenu.
  174.  
  175.     5.2   - Added sort by file name for viewing of all compressed
  176.             file directories.
  177.  
  178.  
  179.  
  180.                                      - 4 -
  181.  
  182.  
  183.  
  184.           - Fixed problem reading PAK 2.51 SFX files.
  185.           - Fixed problem calling help from the file date/time
  186.             stamp change window.
  187.  
  188.     5.3   - Added user-defined executable program menu system.
  189.             See PROGMENU.DOC for details.
  190.           - Various minor bug fixes and enhancements.
  191.  
  192.     5.4   - Various bug fixes.
  193.           - Rewrite of the main engine, resulting in faster
  194.             operation and smaller RAM image.
  195.  
  196.     5.5   - Fixed problems with viewing ZIP file inside ZIP file.
  197.           - Some command keys were not working.  Fixed.
  198.  
  199.     5.51  - Fixed problem with help screen that occurred after
  200.             viewing contents of compressed file.
  201.           - The F-1 (help) key was not working in the view compressed
  202.             file window.  Fixed.
  203.           - Other minor bug fixes.
  204.  
  205.     5.52  - Fixed severe bug that could cause program crash in some
  206.             systems not equipped with a mouse.
  207.  
  208.     5.53  - Fixed bug that occurred when changing ZIP comments.
  209.  
  210.           - Fixed bug that prevented display of files and bytes
  211.             tagged following the Auto Update (Ctrl+A) and the Backup
  212.             Tag (Ctrl+F6) commands.
  213.  
  214.     New versions are created and released for two main reasons.  First, and
  215.     foremost, is to correct bugs and design flaws discovered by users. The
  216.     second is to incorporate new and better ideas received from users.
  217.  
  218.  
  219.     4  - GENERAL & TECHNICAL INFORMATION
  220.  
  221.  
  222.     CAUTION!!! - ArcMaster uses a temporary subdirectory (child of the
  223.     current active directory) named "$!$" for conversion from
  224.     one archive system files to another.  Do NOT use a subdirectory of this
  225.     name anywhere in your system or the files contained therein might be
  226.     lost!!
  227.  
  228.          The term ARC is widely used throughout this documentation as well
  229.     as in various textual messages in the executable program.  ARC, as it is
  230.     used here and in the program, is an abbreviation for the generic word
  231.     "archive".  Archive is defined as a "place where records or documents
  232.     are kept."  In the case of personal computers, the term has come to
  233.     connote files that contain other files that have been reduced in size
  234.  
  235.  
  236.  
  237.                                      - 5 -
  238.  
  239.  
  240.  
  241.     through the employment of various compression techniques.  Thus an
  242.     archive file is a library of files compressed for archival or storage
  243.     efficiency purposes.  Some compression/decompression systems
  244.     automatically append a DOS file extension of .ARC, some use .PAK, some
  245.     use .LZH, and some use .ZIP.  When the term archive appears here or in
  246.     the main program, it refers to the process of creating, modifying, or
  247.     unpacking compressed archive files or it refers to a file in which
  248.     compressed files have been stored in library fashion.  There will be
  249.     references in this document to various operating system file extensions
  250.     such as .ARC, .PAK, and .ZIP.  These file extensions are given (usually
  251.     by default) in the creation of archives of compressed files by archive
  252.     systems to distinguish these from other files.  References to these
  253.     extensions are necessary for technical and explanatory reasons.
  254.  
  255.          ArcMaster supports 6 popular and widely used archive systems. An
  256.     archive system is a program or group of programs that employ file
  257.     compression techniques to create a compressed archive file and
  258.     decompression techniques to access and extract files stored in an
  259.     archive file.  The following systems are currently supported by
  260.     ArcMaster:
  261.  
  262.          ARC             by  Systems Enhancement Associates (SEA)
  263.          ARCA/ARCE       by  Vernon Buerg
  264.          PKPAK/PKUNPAK   by  PKWare (no longer distributed)
  265.          PAK             by  NoGate Consulting
  266.          PKZIP/PKUNZIP   by  PKWare (Phil Katz)
  267.          LHARC           by  Haruyasu Yoshizaki
  268.          LIST            by  Vernon Buerg
  269.     All of these are outstanding systems and each have their own specific
  270.     merits.  New-Ware has no vested interest in the commercial success of
  271.     any of these systems and does not recommend one over the other.  It is
  272.     recommended that archive file users evaluate each of these systems,
  273.     select the one(s) closest to meeting archival needs, and registering
  274.     that product(s).  All, except ARCA and LHARC, are Shareware products and
  275.     available from various sources, including Bulletin Board Systems around
  276.     the country.  LHARC (.LZH files) and ARCA are freely distributed
  277.     programs.  ArcMaster supports all of these systems in an effort to
  278.     provide an effective archive control system interface for the broadest
  279.     range of users.
  280.  
  281.          It is the responsibility of the user to thoroughly read and
  282.     understand the documentation included with whichever archive systems are
  283.     in use.  For example, the ZIP system provides a means for specifying a
  284.     drive as the default for creating temporary files.  This feature is
  285.     important when archiving/unarchiving from/to floppy disks.
  286.  
  287.          ArcMaster is written in Borland International's Turbo Pascal,
  288.     version 5.5 and makes heavy use of the TurboPower Software Turbo Pro
  289.     5.09 library.  ArcMaster was developed and compiled on an AST
  290.  
  291.  
  292.  
  293.  
  294.                                      - 6 -
  295.  
  296.  
  297.  
  298.     Premium/386C (20 Mhz) equipped with an ATI VGA Wonder 512K and NEC
  299.     Multisync II monitor.  It has been tested on the following machines:
  300.  
  301.          AST Premium/386C (as described above) - MSDOS 3.3/MSDOS 4.01
  302.          386 Clone - MSDOS 3.3 - Hercules Clone - Mono
  303.          AST Premium/286 - MSDOS 3.3 - Hercules Plus - Mono
  304.          AST BRAVO 286 - MSDOS 3.3 - Hercules Clone - Mono
  305.          16mhz 386 SX Clone - MSDOS 3.3 - Hercules Clone - Mono
  306.          Zenith 386 with VGA and VGA monitor - MSDOS 3.3
  307.          Compaq 386/20 with VGA monitor - MSDOS 3.3
  308.  
  309.     Other Shareware products offered by New-Ware are:
  310.  
  311.          SCOUT             -      TSR disk/file manager
  312.          SCOUT-EM          -      TSR that runs in EMS
  313.          CopyMaster        -      File/disk copy utility
  314.          BrowseMaster      -      Virtual file browser
  315.          BatMaster         -      Text Editor
  316.          FormatMaster      -      Floppy disk formatter
  317.          ZipMaster         -      ZIP archive control
  318.  
  319.     SECTION V. GENERAL PROGRAM DESCRIPTION AND REQUIREMENTS
  320.  
  321.  
  322.     5  - PROGRAM DESCRIPTION AND REQUIREMENTS
  323.  
  324.  
  325.          ArcMaster is a full-featured visual interface program designed
  326.     facilitate the operation of archive systems in the PCDOS/MSDOS
  327.     environment.  By itself, ArcMaster WILL NOT perform any file compression
  328.     or decompression.  At least one of the support systems must be present
  329.     before ArcMaster becomes useful.  With one or more of the five supported
  330.     archive systems present, ArcMaster will make the creation, modification,
  331.     and unarchiving of archive files much easier and faster.  It is menu-
  332.     driven and employs a "point and shoot" style method of controlling major
  333.     archiving operations.
  334.  
  335.          At least one of the six supported archive systems must be available
  336.     before ArcMaster can be successfully operated.  ArcMaster also includes
  337.     the capability to convert archive files from/to the popular .ARC format
  338.     (developed by SEA) and the newer .PAK format (developed by NoGate
  339.     Consulting).  A system that operates with each format must be present in
  340.     order to successfully convert from one format to another.  Here are the
  341.     file names of the executable files for each system:
  342.  
  343.          ARC (ver. 6.02)      -        *ARC.EXE
  344.          PAK (ver. 2.51)      -        *PAK.EXE
  345.          PKPAK (ver. 3.6)     -         PKPAK.EXE
  346.                                         PKUNPAK.EXE
  347.          ARCA (ver. 1.28)     -        *ARCA.COM
  348.  
  349.  
  350.  
  351.                                      - 7 -
  352.  
  353.  
  354.  
  355.          ARCE (ver. 3.1C)              *ARCE.COM
  356.          ZIP (ver. 1.10)      -         PKZIP.EXE
  357.                                         PKUNZIP.EXE
  358.          LHARC (ver 1.13C)    -        *LHARC.EXE
  359.          LIST (ver 7.5E)      -        *LIST.COM
  360.  
  361.     The files marked with an asterisk (*) are files that may distributed
  362.     with the version number as part of the file name.  For example, the
  363.     current version of Vern Buerg's ARCA is distributed as ARCA129.COM. Be
  364.     sure that the archive system files that you use are named exactly as
  365.     above.
  366.  
  367.          ArcMaster may be operated on any IBM PC/XT/AT/PS2 or compatible
  368.     running under DOS 2.0 and above.  With the distributed default settings
  369.     of 350 files per directory (RIGHT & LEFT) and 80 files per archive.  It
  370.     uses approximately 181K of RAM.  ArcMaster supports the DESKQView
  371.     environment and the Hercules InColor Card.  Approximately 370K total
  372.     available RAM is required to run ArcMaster and although not absolutely
  373.     necessary, a hard disk is strongly recommended.  All monitor and
  374.     graphics cards are supported, including "composite" (2 color) monitors
  375.     and backlit laptop screens.  Mouse support is automatically provided if
  376.     a mouse driver is present in the system.  Any dot matrix or laser
  377.     printer may be used for printing file directory listings.  The printer
  378.     must be capable of printing IBM line draw characters if the directory
  379.     tree is to be legibly printed.
  380.  
  381.          The type of monitor, color or monochrome, will be detected at
  382.     runtime and the display colors will be adjusted accordingly.  Users with
  383.     older composite (2 color) monitors and laptops with backlit screens
  384.     should place an "M" on the command line when starting Arcmaster.  If the
  385.     configuration settings are then saved to the disk file, the "M" will no
  386.     longer be required when executing Arcmaster.
  387.  
  388.          Although not absolutely required to operate ArcMaster, it is
  389.     strongly recommended that a current version of Vern Buerg's outstanding
  390.     LIST.COM be present also.  LIST is a very sophisticated and powerful
  391.     file viewing program that permits a user to browse just about any kind
  392.     of file imaginable.  The importance of LIST to ArcMaster is that LIST is
  393.     employed to browse compressed files that reside within an archive file.
  394.     LIST version 6.2 and above is supported but if you use a Mouse with
  395.     ArcMaster, you MUST use version 7.1 or later of LIST.
  396.  
  397.          Note:  The current version of LIST is distributed with three LIST
  398.     variants.  Mouse users should not use LISTR.COM or LISTS.COM.
  399.  
  400.          It is IMPORTANT that the archive system files, LIST.COM, and AM.HLP
  401.     reside in a directory that is identified in the DOS PATH string. The DOS
  402.     PATH string is a string containing valid DOS directory path names that
  403.     DOS will use to search for an executable file.  It is user defined and
  404.     is normally initialized at boot-up with the PATH command.  Here is an
  405.  
  406.  
  407.  
  408.                                      - 8 -
  409.  
  410.  
  411.  
  412.     example of a DOS PATH command as it might appear in an AUTOEXEC.BAT
  413.     file:
  414.  
  415.         path=c:\util;d:\arc\dat;c:\turbo;e:\dbms\pc-file
  416.  
  417.     It is IMPORTANT that the drive designator and colon precede each
  418.     individual path identified in the string.  In this example, suppose that
  419.     the current directory is C:\GAMES and it is desired to execute Norton's
  420.     famous utilities, which is located in C:\UTIL.  Simply enter the command
  421.     NU and DOS will find NU.EXE in C:\UTIL and execute it.  If the requested
  422.     program is not in the current active directory, DOS will then search
  423.     each directory listed in the PATH string for the executable file.  If
  424.     the path name C:\UTIL were omitted from the path string in this example,
  425.     DOS would respond to an attempt to load NU.EXE with a "Bad command or
  426.     filename" message, unless NU.EXE were in the current directory.  The
  427.     PATH string can be checked at any time by entering either PATH or SET
  428.     from the DOS level.  Also, do NOT place more than one PATH command in
  429.     the AUTOEXEC.BAT file.  Only the last PATH command that is executed is
  430.     valid.
  431.  
  432.          Placing the directory path names in the PATH string is required
  433.     EVEN IF ALL ARCMASTER FILES ARE LOCATED IN THE SAME DIRECTORY!.  This is
  434.     true due to the nature of the way that ArcMaster issues a call for
  435.     executable files to DOS.
  436.  
  437.          If a path related problem is encountered, press Ctrl-F2 while in
  438.     the main ArcMaster display to bring up a window that shows an explicit
  439.     summary of the current DOS path and the status of the various archive
  440.     system files used by ArcMaster.
  441.  
  442.          ArcMaster effects display and control of the active drive directory
  443.     structure through the use of a graphic "tree".  The directory tree is
  444.     constructed from the DOS directory structure on the active disk and is
  445.     read into memory by ArcMaster when the F5 key is pressed from the main
  446.     menu.  In order to speed things up, ArcMaster maintains a directory
  447.     catalog file for each drive in directory specified in by the user from
  448.     the configuration submenu.  These files are relatively small (14 bytes
  449.     per directory) and are dynamically updated as the user adds, deletes, or
  450.     renames a directory on the tree.  They are named NEW-WARE with an
  451.     extension equal to the accessed drive letter.  Directories added,
  452.     deleted, or renamed outside ArcMaster WILL NOT show up on the tree
  453.     unless and until ArcMaster is forced to rescan the disk.  This may be
  454.     accomplished by pressing Ctrl-R from the main ArcMaster window.
  455.  
  456.          Note:  Previous versions of ArcMaster used a directory log file
  457.     named NEW-WARE.LOG or NEW-WARE.DIR in the root directory of each
  458.     accessed drive.  These files are no longer used or needed by ArcMaster
  459.     and may be deleted.  The change in file names was necessitated due to
  460.     the change in the basic structure of the file and the change to the
  461.     general catalog file strategy.  AM now maintains catalog files named
  462.  
  463.  
  464.  
  465.                                      - 9 -
  466.  
  467.  
  468.  
  469.     NEW-WARE.X in the specified drive:\directory path, where X is the drive
  470.     letter.
  471.  
  472.          The directory tree is alphabetically sorted by directory name
  473.     within each subdirectory level of the tree.  The sort is accomplished
  474.     when updating NEW-WARE.DIR, which occurs whenever a disk rescan (Ctrl-R)
  475.     or a change in the tree (adding, deleting, renaming) is effected.
  476.  
  477.          The tree display now supports up to 350 directories and a directory
  478.     level depth up to 8.  If a tree problem occurs, it most likely will be
  479.     due to one of these limits being exceeded.
  480.  
  481.  
  482.     6  - EXECUTING ARCMASTER
  483.  
  484.  
  485.          ArcMaster's executable file is named AM.EXE.  It MUST reside in a
  486.     directory that is identified in the DOS PATH string. The supporting
  487.     overlay file, AM.OVR, should be placed in the same directory as AM.EXE.
  488.     ArcMaster may be executed by entering the file name at the DOS command
  489.     level or called from a .BAT file or DOS shell.  Up to three command line
  490.     parameters are supported.  A command line parameter is a string of
  491.     characters that follows the program name.  Here is an example:
  492.  
  493.                                 AM G:\DATA\UNARC
  494.  
  495.     The command string is not case sensitive.  In this example, DOS will
  496.     load and execute ArcMaster and ArcMaster will make the directory path
  497.     G:\DATA\UNARC it's destination directory (more about source and
  498.     destination directories later).  Another example is:
  499.  
  500.                              AM c:\pascal d:\archive
  501.  
  502.     In this case ArcMaster will assign c:\pascal as the source directory and
  503.     d:\archive as the destination directory.  Of course, it is not necessary
  504.     to enter any parameters at all on the command line, in which case
  505.     ArcMaster will use the default source and directory path names that have
  506.     been saved to the .EXE file.  If either path name is invalid, ArcMaster
  507.     will use the default setting.  If the drive designator is omitted (i.e.,
  508.     \pascal vice c:\pascal), then the current active drive designator will
  509.     be appended.
  510.  
  511.          A valid file name may also be entered on the command line.  If the
  512.     file name is a file that exists in the current directory, ArcMaster will
  513.     automatically position the LEFT window cursor bar over that file on
  514.     start-up.  For example, the command
  515.  
  516.                                  AM STORAGE.ARC
  517.  
  518.  
  519.  
  520.  
  521.  
  522.                                      - 10 -
  523.  
  524.  
  525.  
  526.     will result in the cursor bar highlighting the file STORAGE.ARC if
  527.     STORAGE.ARC exists in the start-up directory.
  528.  
  529.          When ArcMaster loads and executes, it first checks the DOS path for
  530.     the presence of a file named AMCONFIG.BIN.  If this file exists on the
  531.     DOS PATH, it will be loaded.  If not, AM will utilize its default
  532.     configuration settings.  AMCONFIG.BIN may be created using the
  533.     Configuration Menu and then placed in a directory in the DOS PATH for
  534.     future auto-configuration.
  535.  
  536.          European and Australian users should note that ArcMaster will
  537.     display dates in the European convention of 'DD-MM-YY' if the command
  538.     COUNTRY=XXX is placed in the CONFIG.SYS file, where XXX is in the range
  539.     031..049,061.  German and Swiss users should note that if XXX is 041 or
  540.     049, ArcMaster will properly handle the '(Y/N)?' query responses.
  541.  
  542.          Even though ArcMaster is a complex program, it is fairly simple to
  543.     operate.  Files are tagged by pressing the space bar and the main
  544.     command bar menu may be activated by pressing the "/" key.  An
  545.     auxilliary command menu is displayed when the the backslash ("\") key is
  546.     pressed or the left and right mouse buttons are simultaneously
  547.     depressed.  Many of the menu commands are available directly through
  548.     function keys.  For example, use the F-9 key for file compression
  549.     operations and the F-10 key for file decompression operations.  Use the
  550.     comprehensive on-line help system for detailed information on the
  551.     ArcMaster command system.
  552.  
  553.  
  554.     7  - ON-LINE HELP DISPLAY
  555.  
  556.  
  557.          ArcMaster now includes a very extensive on-line HELP system.  HELP
  558.     can be invoked from just about anywhere within ArcMaster by pressing the
  559.     F1 key or the LEFT and RIGHT mouse buttons.  The help system
  560.     incorporates nearly 85 percent of the information contained in the
  561.     original AM.DOC file and for that reason AM.DOC is now truncated.  When
  562.     F1 is pressed from the main display, the HELP window will contain an
  563.     indexed list of available help topics.  Information on a specific topic
  564.     may be viewed by moving the cursor bar to the desired top and pressing
  565.     ENTER.  Pressing the Esc key from the specific topic information window
  566.     will return to the main HELP topic list with the cursor bar highlighting
  567.     the last topic selected.
  568.  
  569.          The HELP system is context sensitive.  That means that when called
  570.     by pressing F1, the pop-up HELP screen will contain textual information
  571.     that is directly related to which menu or submenu the user is in when
  572.     HELP is called.  For example, pressing F1 when viewing the main screen
  573.     will display a general HELP screen that describes the HELP system and
  574.     its associated commands.  The general introductory HELP screen also
  575.     contains a list of major ArcMaster commands.  Pressing F1 while in a
  576.  
  577.  
  578.  
  579.                                      - 11 -
  580.  
  581.  
  582.  
  583.     menu or submenu will provide HELP for the specific menu item that is
  584.     currently selected by the movable cursor bar.
  585.  
  586.          Mouse support is also available with the HELP system.  The mouse
  587.     may be used to move the HELP index cursor.  Pressing the LEFT mouse
  588.     button will select the item under the mouse cursor.  Pressing the LEFT
  589.     button with the mouse cursor over a selected item is the same as
  590.     pressing ENTER.  Pressing the RIGHT mouse button is the same as pressing
  591.     the ESC key, which is used to exit from the HELP system.
  592.  
  593.          Support for the HELP system is contained in the file AM.HLP.  This
  594.     file MUST reside either in the same directory from which AM.EXE is
  595.     executed or in a directory that appears in the DOS PATH string.  It is
  596.     strongly recommended that you place both AM.EXE and AM.HLP in the same
  597.     directory and ensure that the selected directory is identified in the
  598.     DOS PATH string.
  599.  
  600.          The help file, AM.HLP, is a compressed file containing  textual
  601.     HELP information that is divided and indexed by topics.  Since AM.DOC
  602.     used to be about 91K in size and AM.HLP is now about 45K in size, the
  603.     entire AM package is smaller.
  604.  
  605.  
  606.     8  - TROUBLE SHOOTING
  607.  
  608.  
  609.          A common problem is running out of disk space when archiving
  610.     to/from a floppy disk.  The supported archive systems all provide a DOS
  611.     environment variable as a method to force placement of temporary files
  612.     on a specific drive.  Consult the appropriate archive system
  613.     documentation for more specific information.
  614.  
  615.         In the event that problems are encountered during the use of
  616.     ArcMaster, it would be appreciated if the user would take the time to
  617.     check the items mentioned in this paragraph prior to calling for
  618.     support.  The most common problem that will be encountered is the
  619.     failure to place the archive (and LIST) executable files in a directory
  620.     that is identified in the PATH command.  The current DOS PATH string may
  621.     be examined by entering the DOS command PATH or SET from the DOS level.
  622.     A more definitive method is to execute ArcMaster and then press Ctrl-F2
  623.     for a complete listing of the support files used by ArcMaster and their
  624.     respective DOS paths (if any) in the user's system.
  625.  
  626.         Another common problem will undoubtedly be in neglecting to
  627.     configure ArcMaster for the archive system in use.  If ArcMaster is set
  628.     for PKZIP (the distribution default) and the user attempts to operate
  629.     the program in the absence of PKZIP.EXE and PKUNZIP.EXE in the DOS PATH,
  630.     failure will result.  It should be noted that although any type of
  631.     archive file directory may be viewed in either the LEFT or RIGHT window,
  632.     tagging is only allowed in the LEFT window and the archive system
  633.  
  634.  
  635.  
  636.                                      - 12 -
  637.  
  638.  
  639.  
  640.     present must match the ArcMaster configuration setting in order to
  641.     extract or browse (LIST) files inside an archive.  It is especially
  642.     important to insure that the necessary archive system files are present
  643.     and in the DOS PATH for the conversion functions to operate properly.
  644.  
  645.         One possible source of problems could be the failure to properly
  646.     configure the archive system(s) being used.  Be sure to read the
  647.     documentation that accompanies each system that is being used and ensure
  648.     that the programs are configured properly.
  649.  
  650.         It is not possible to produce a non-trivial computer program that is
  651.     completely fault-free and ArcMaster is no exception.  There are
  652.     undoubtedly bugs lurking that I and my beta testers failed to identify
  653.     and correct.  One of the great strengths of the Shareware concept is the
  654.     interaction available between the program author and the users.  I
  655.     welcome contact with users and I try very hard to be responsive to bug
  656.     reports and constructive criticism.  Much of the design of this version
  657.     is directly attributable to the input I have received from ArcMaster
  658.     users.  If a design flaw or bug is detected, please contact me and I'll
  659.     fix it.  I can't solve the problems that I don't know about.
  660.  
  661.  
  662.     9  - CREDITS
  663.  
  664.  
  665.         New-Ware would like to acknowledge the important efforts of Tom
  666.     Kellen (Atlanta, GA), Sallie Austin (Rockford, IL), and Dave Hardy (San
  667.     Francisco) for their outstanding support during the development and
  668.     testing of ArcMaster. It is also important to acknowledge the
  669.     outstanding compiler and pascal library technology from Borland
  670.     International and TurboPower Software, respectively.  Thanks to Kim
  671.     Kokkonen of TurboPower Software for the Turbo Professional library code
  672.     used in this program. Credit is also due to System Enhancement
  673.     Associates, PKWare, Vernon Buerg, and H. Yoshizaki for their splendid
  674.     efforts in developing fast and efficient archive programs.  Users of
  675.     these programs are strongly urged support the authors through
  676.     registration where appropriate.  Last, but never least, dealing with the
  677.     large and complex source files from which this program is compiled would
  678.     be frustratingly difficult without the use of Sammy Mitchell's (SemWare)
  679.     outstanding text editor, QEDIT.
  680.  
  681.     Copyright 1987/88/89/91, all rights reserved.
  682.     February 1991
  683.     San Diego, California
  684.  
  685.  
  686.  
  687.  
  688.  
  689.  
  690.  
  691.  
  692.  
  693.                                      - 13 -
  694.  
  695.  
  696.  
  697.  
  698.  
  699.  
  700.  
  701.  
  702.  
  703.  
  704.  
  705.  
  706.  
  707.  
  708.  
  709.  
  710.  
  711.  
  712.  
  713.  
  714.  
  715.  
  716.  
  717.  
  718.  
  719.  
  720.  
  721.  
  722.  
  723.  
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730.  
  731.  
  732.  
  733.  
  734.  
  735.  
  736.  
  737.  
  738.  
  739.  
  740.  
  741.  
  742.  
  743.  
  744.  
  745.  
  746.  
  747.  
  748.  
  749.  
  750.                                      - 14 -
  751.  
  752.  
  753.  
  754.  
  755.  
  756.  
  757.  
  758.  
  759.  
  760.                                      Index
  761.  
  762.  
  763.            .ARC 6                         L
  764.            .LZH 6                         LHARC 6
  765.            .PAK 6                         LIST 8
  766.            .ZIP 6                         LIST.COM 8
  767.  
  768.            A                              M
  769.            Alt-R 4                        monitor 8
  770.            archive systems 6              monochrome 8
  771.  
  772.            B                              N
  773.            Borland 6                      New-Ware 3
  774.                                           NEW-WARE.LOG 9
  775.            C                              NoGate Consulting 6
  776.            color 8
  777.            Compuserve 3                   O
  778.            convert 7                      ON-LINE HELP DISPLAY 11
  779.            CREDITS 13
  780.            Ctrl-F2 9                      P
  781.                                           PATH 9
  782.            D                              PKWare 6
  783.            Dave Hardy 13                  PKWare (Phil Katz) 6
  784.            destination directory 10       PROLOG 2
  785.            directory level 10
  786.            directory tree 9               R
  787.            DOS PATH 8                     RAM 8
  788.                                           register 2
  789.            E                              REGISTRATION 2
  790.            EXECUTING ARCMASTER 10         registration window 4
  791.  
  792.            F                              S
  793.            F1 key 11                      Sallie Austin 13
  794.            F5 key 9                       Sammy Mitchell 13
  795.                                           SET 9
  796.            G                              Shareware 2
  797.            GENERAL & TECHNICAL            Shareware Products BBS 3
  798.               INFORMATION 5               source directory 10
  799.            GENERAL DESCRIPTION 7          Systems Enhancement
  800.            Genie 3                           Associates 6
  801.  
  802.            H                              T
  803.            Haruyasu Yoshizaki 6           temporary subdirectory 5
  804.  
  805.  
  806.  
  807.                                      - 15 -
  808.  
  809.  
  810.  
  811.            Tom Kellen 13                  V
  812.            TROUBLE SHOOTING 12            Vernon Buerg 6
  813.            Turbo Pascal 6                 VERSION HISTORY 4
  814.            TurboPower 6
  815.  
  816.  
  817.  
  818.  
  819.  
  820.  
  821.  
  822.  
  823.  
  824.  
  825.  
  826.  
  827.  
  828.  
  829.  
  830.  
  831.  
  832.  
  833.  
  834.  
  835.  
  836.  
  837.  
  838.  
  839.  
  840.  
  841.  
  842.  
  843.  
  844.  
  845.  
  846.  
  847.  
  848.  
  849.  
  850.  
  851.  
  852.  
  853.  
  854.  
  855.  
  856.  
  857.  
  858.  
  859.  
  860.  
  861.  
  862.  
  863.  
  864.                                      - 16 -
  865.  
  866.  
  867.  
  868.  
  869.  
  870.  
  871.  
  872.  
  873.  
  874.                                  Contents
  875.  
  876.  
  877.             1  - PROLOG  . . . . . . . . . . . . . . . . . . . . . .  2
  878.             2  - REGISTRATION  . . . . . . . . . . . . . . . . . . .  2
  879.             3  - VERSION HISTORY . . . . . . . . . . . . . . . . . .  4
  880.             4  - GENERAL & TECHNICAL INFORMATION . . . . . . . . . .  5
  881.             5  - PROGRAM DESCRIPTION AND REQUIREMENTS  . . . . . . .  7
  882.             6  - EXECUTING ARCMASTER . . . . . . . . . . . . . . . . 10
  883.             7  - ON-LINE HELP DISPLAY  . . . . . . . . . . . . . . . 11
  884.             8  - TROUBLE SHOOTING  . . . . . . . . . . . . . . . . . 12
  885.             9  - CREDITS . . . . . . . . . . . . . . . . . . . . . . 13
  886.  
  887.          Index                                                       15
  888.  
  889.  
  890.  
  891.  
  892.  
  893.  
  894.  
  895.  
  896.  
  897.  
  898.  
  899.  
  900.  
  901.  
  902.  
  903.  
  904.  
  905.  
  906.  
  907.  
  908.  
  909.  
  910.  
  911.  
  912.  
  913.  
  914.  
  915.  
  916.  
  917.  
  918.  
  919.  
  920.  
  921.                                        i
  922.