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