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