home *** CD-ROM | disk | FTP | other *** search
/ Programmer 7500 / MAX_PROGRAMMERS.iso / PROGRAMS / UTILS / COMPRESS / ARCMAS12.ZIP / ARCMASTR.DOC < prev    next >
Encoding:
Text File  |  1987-09-12  |  46.6 KB  |  1,014 lines

  1.                               Arcmaster
  2.                                  by
  3.                             John J. Newlin
  4.  
  5.  
  6.       -- What is Arcmaster?
  7.  
  8.          Arcmaster is a full-featured Archive file management 
  9.          system that is designed to take some of the pain out of 
  10.          remembering the usage syntax for Archive system programs.  
  11.          Specifically, Arcmaster fully supports the PKARC and 
  12.          PKXARC system (Copyright by Phil Katz) and the ARCA and 
  13.          ARC-E system (Copyright by Vern Buerg).  Both of these 
  14.          systems are supurb implementations of file compression and 
  15.          decompression techniques.  Use of either of these two 
  16.          systems results in the saving of a lot of time and money 
  17.          in transferring files over public phone lines and a lot of 
  18.          disk space on private systems.
  19.  
  20.          The problem is that both systems offer so many options and 
  21.          switches that it is difficult to remember them when you 
  22.          need to ARC or DeARC a set of files.  Arcmaster removes 
  23.          that difficulty and adds a fast, powerful search feature 
  24.          so that you can always find that file you need even though 
  25.          you may have stuffed it in an .ARC file some months ago.
  26.          Here are some of Arcmaster's features:
  27.  
  28.                - View an .ARC file directory listing at
  29.                  the touch of a key.
  30.                - DeARC multiple files.
  31.                - Selectively extract (or delete) files
  32.                  from an .ARC file.
  33.                - Search any (or all) drives in your system
  34.                  for a file that resides in an .ARC file.
  35.                - Browse ARCed files using Vern Buerg's
  36.                  outstanding LIST program.
  37.                - Quickly and easily select ARC or DeARC
  38.                  switches and options.
  39.                - Specify a target directory for file
  40.                  extraction.
  41.                - Specify a target directory as host for
  42.                  created .ARC files.
  43.                - Swiftly search entire system for any file.
  44.                - View any file through Buerg's LIST program.
  45.  
  46.  
  47.       -- Version History.
  48.  
  49.          1.0 released 08/01/87
  50.  
  51.              08/02/87
  52.  
  53.                  fixed uninitialized variable bug that 
  54.                  prevented proper screen update upon return 
  55.                  from F1 function.
  56.  
  57.                  fixed bug that reset file tag counter when
  58.                  PgUp or PgDn used while tagging files.
  59.  
  60.                  fixed bug that allowed tag counter to be
  61.                  decremented even when file was not tagged.
  62.  
  63.                  fixed bug (nasty!) that caused system crash
  64.                  on any system using FANSI or NANSI console
  65.                  drivers.  This caused "delete string error"
  66.                  crash.
  67.  
  68.          1.1 released 08/15/87
  69.  
  70.                  fixed bug in PgDn function when viewing an
  71.                  ARC directory.
  72.  
  73.                  added designation of .HLP file directory in
  74.                  the .CFG file
  75.  
  76.                  changed the display of file names to split
  77.                  the name from the extension to effect a more 
  78.                  readable display.
  79.  
  80.                  added designation of location of .CFG file
  81.                  on command line when loading ARCMASTR.EXE.
  82.  
  83.                  implemented work-around to problem of lack
  84.                  of space on floppy drive for DOS temporary
  85.                  piping files.
  86.  
  87.          1.2 released 09/15/87
  88.  
  89.                  various minor bug fixes
  90.  
  91.                  added capability to use DOS environment to set
  92.                  configuration options.
  93.  
  94.       -- License Terms.
  95.  
  96.          Arcmaster is copyrighted by John J. Newlin, all rights 
  97.          reserved (1987).  It is offered to IBM PC/XT/AT (and 
  98.          clones) personal computer users as Shareware.  This means 
  99.          that you, the consumer, get to try out the proram and 
  100.          evaluateits usefulness before risking a purchase.  User's 
  101.          who find it useful should remit a registration fee of 
  102.          $40.00 to:
  103.  
  104.                              John J. Newlin
  105.                              4060-228 Rosenda Ct.
  106.                              San Diego, CA 92122
  107.  
  108.          I am offering two incentives to promote registration of 
  109.          Arcmaster.  The first involves filling out the form that I
  110.          have included at the end of the user's manual.  If you fill
  111.          in the form completely and include it with your registration,
  112.          I will accept a registration fee of $30.00.  In addition 
  113.          to saving $10.00, you avail yourself of the opportunity to
  114.          critique the program and to make an important contribution 
  115.          to the design of future versions.  I feel very strongly 
  116.          that submitted critiques will be just as important to me 
  117.          as the registration fees.
  118.  
  119.          The second incentive is that by registering with me you 
  120.          will recieve Arcmaster Plus, a program incorporating 
  121.          additional advanced features.  Some of the features of 
  122.          Arcmaster Plus are:
  123.  
  124.                - Print an Archive directory listing.
  125.                - Batch move, copy, deletion of files.
  126.                - Renaming of files.
  127.                - Assignment of function keys to file
  128.                  masks.
  129.                - An optional date/time sort.
  130.                - Optionally use different file names
  131.                  for ARCA, ARC-E, PKARC, and PKXARC.
  132.                - Use DOS wild card masks for ARC and
  133.                  de-ARC operations.
  134.  
  135.  
  136.          Arcmaster may be executed on any personal computer system 
  137.          by that system's owner/operator for evaluation purposes.  
  138.          It may not be sold and it may not be used in any 
  139.          commercial environment without my permission.  It may be 
  140.          copied for archival purposes and for purposes of Shareware 
  141.          distribution, but no fee other than for the host media may 
  142.          be charged.
  143.  
  144.          I explicity reserve all rights to the distribution and 
  145.          sale of Arcmaster, both in and outside of the United 
  146.          States.  I also claim copyright of the various screens and 
  147.          displays embodied in Arcmaster.
  148.  
  149.       -- Warranty
  150.         
  151.          This program is provided AS IS without any warranty, 
  152.          expressed or implied, including but not limited to 
  153.          fitness for a particular purpose.
  154.  
  155.          The author is a member of the Association of Shareware 
  156.          Professionals (ASP).
  157.  
  158.       -- Support
  159.  
  160.          I support my software!  Unfortunately, I cannot support a 
  161.          toll free line but I will accept letters, phone calls, 
  162.          carrier pigeon drops, or whatever form of communication
  163.          suits you in asking for support.  You can reach me at the 
  164.          address above or at one of these two numbers:
  165.  
  166.                   Work - (619) 543-4072
  167.                   Home - (619) 455-6225
  168.  
  169.          I can also be reached via CIS EMAIL or IBMSW SIG message.  
  170.          My CIS user id is 71535,665.  And you can reach me on GENIE
  171.          through GE MAIL to JNEWLIN.
  172.  
  173.          I have yet to write any non-trivial software that did not 
  174.          contain bugs.  Maybe others can, but I know I cannot.  I'm 
  175.          sure Arcmaster is no exception.  Some of those little 
  176.          beasts will probably never be found by me because of my 
  177.          bias as the author.  Therefore it is important to all who 
  178.          use Arcmaster to let me know of any problems.  If I know 
  179.          about them, I can probably fix them.  Ideas and 
  180.          suggestions as how to improve the program are also most 
  181.          welcome.
  182.  
  183.       -- Technical Information.
  184.  
  185.          Arcmaster was developed and initially tested on an AST 
  186.          Premium/286 running MSDOS 3.1 and using monochrome monitor 
  187.          driven by a Hercules + board.  It has been beta tested on 
  188.          the following machines:
  189.  
  190.                    IBM XT stock with mono board/monitor.
  191.                    IBM AT (8mhz) EGA board simulating mono.
  192.                    Leading Edge model "M" with CGA.
  193.                    TANDY 1000 with CGA
  194.  
  195.          It is written in Marshal Language Systems' Marshal Pascal
  196.          (70%) and assembly (30%) using Eric Isaacson's marvelous
  197.          A86 assembler.
  198.  
  199.          Arcmaster will support up to 400 files per directory 
  200.          and 300 files per Archive directory.  If anyone
  201.          needs increased capability, contact me and I will 
  202.          provide you a custom version that will meet your 
  203.          needs.  I expect Arcmaster to support the Lotus, Intel,
  204.          Microsoft (LIM) Expanded Memory Specification (EMS) 
  205.          as soon as MLS provides the compiler support.  Steve
  206.          Marshal has promised to incorporate this support in
  207.          the next major release of this fine compiler.
  208.  
  209.       -- Credits.
  210.  
  211.          Arcmaster is an interface that automates most of the 
  212.          command line entry typing required to utilize the 
  213.          supported ARC programs and LIST.  Without Vern Buerg's and 
  214.          Phil Katz's brilliant efforts, there would be no use for
  215.          Arcmaster.  It does not employ any file compression or
  216.          decompression techniques and does not offer any intrinsic 
  217.          file viewing capability.  Tied together with ARCA (or 
  218.          PKARC), ARC-E (or PKXARC) and LIST, I believe it will save 
  219.          much time and effort normally required to manage .ARC 
  220.          files.  Special thanks to Steve Marshal and the 
  221.          folks at Marshal Language Systems for their support.
  222.          PKARC and PKXARC are copyrighted by Phil Katz.
  223.          ARCA, ARC-E, and LIST are copyrighted by Vern Buerg.  We
  224.          all owe Vern and Phil a large vote of thanks for their
  225.          fine utilities.  Please support both of them!
  226.  
  227.       -- Installing Arcmaster.
  228.  
  229.          -- Hardware Requirements.
  230.  
  231.             Arcmaster should operate properly on any IBM PC/XT/AT
  232.             or compatible having 256k of RAM or greater.  It
  233.             supports monochrome and color monitors and colors for
  234.             the CGA/EGA are user configurable.  While Arcmaster was
  235.             designed primarily for a fixed disk environment, there
  236.             is no reason it cannot be useful when used from a
  237.             floppy disk.  Be warned, however, that Arcmaster does
  238.             not currently trap critical DOS errors so if you attempt
  239.             to perform an operation on a drive with a bad disk or an
  240.             open door, you will get the DOS critical error message
  241.             bleeding through the Arcmaster display.
  242.  
  243.             Testing has shown that you will need approximately 110k
  244.             of free RAM above Arcmaster when it is running in order
  245.             to successfully invoke the archive system programs and/
  246.             or LIST.  Arcmaster takes about 80k of RAM, DOS 3.1
  247.             takes about 70k (varying greatly, depending upon loaded
  248.             device drivers), so you will need at least 256k.  If
  249.             you usually keep RAM resident software (like SCOUT)
  250.             loaded, then you'll need more.
  251.  
  252.             -- Floppy disk system users note:
  253.  
  254.                Arcmaster invokes the DOS piping feature to pipe the
  255.                output of the de-ARC program to LIST.  When the pipe
  256.                is used, DOS needs to create temporary files in the
  257.                root directory of the default drive.  If you are
  258.                working on a crowded floppy and are having trouble
  259.                listing a file with Arcmaster, this is most likely the
  260.                problem.  To alleviate the problem, execute Arcmaster
  261.                from a nearly empty floppy or RAM disk and then use
  262.                the F6 command to change to the floppy containing the
  263.                ARC files.  Arcmaster will use the drive from which
  264.                you orginally started Arcmaster from and if it's nearly
  265.                empty, DOS will have enough room for the temporary
  266.                piping files.
  267.  
  268.          -- Software Requirements.
  269.  
  270.             PC DOS/MSDOS 2.0 or higher.
  271.  
  272.             Arcmaster was designed specifically to interface with
  273.             three of five of the most popular Shareware programs
  274.             available.  In order that Arcmaster provide the maximum
  275.             utility in managing ARC files, the following software
  276.             is required:
  277.  
  278.                           PKARC or ARCA
  279.                           PKXARC or ARC-E
  280.                           LIST
  281.  
  282.             PKARC and PKXARC are archiving and de-archiving
  283.             utilities by Phil Katz.  ARCA and ARC-E are equally
  284.             excellent archive products of Vern Buerg.  LIST is a
  285.             superb file view/browse/list utility by Vern Buerg.  It
  286.             is absolutely mandatory that one of the two archival
  287.             systems listed above be present when Arcmaster is
  288.             operated and it is highly recommended that LIST also be
  289.             included.
  290.  
  291.             Arcmaster does not support the SEA ARC522 system.  The
  292.             command line syntax used by ARC522 differs from the
  293.             other systems in that it does not permit operations
  294.             with multiple file names on the command line.  I don't
  295.             feel the extra labor to include this excellent system
  296.             is warranted at the current time but I may implement
  297.             an interface for it in the future.
  298.  
  299.          -- Using the DOS Environment to Configure Arcmaster.
  300.  
  301.             Up to five Arcmaster configuration settings may be 
  302.             included in the DOS environment by using the DOS SET 
  303.             command.  The five items that may be configured in this 
  304.             manner are:
  305.  
  306.               1.  The directory where Arcmaster will place all
  307.                   new or updated .ARC files.
  308.  
  309.               2.  The directory where Arcmaster will place all
  310.                   extracted files.
  311.  
  312.               3.  The directory containing ARCMASTER.CFG.
  313.  
  314.               4.  The directory containing ARCMASTER.HLP.
  315.  
  316.               5.  The type of archival system in use.
  317.  
  318.             The DOS environment is a reserved area in memory that
  319.             contains various strings that DOS an applications programs 
  320.             may use to define various types of information.  You can 
  321.             view the current environment by entering SET from the DOS 
  322.             command level.  Environment strings are added to or 
  323.             deleted from the environment by using the SET command.  
  324.             For example, suppose that you desire Arcmaster to place 
  325.             all files extracted from an .ARC file in the directory on 
  326.             drive D named \DEARC.  At the DOS command prompt, type the 
  327.             following and press RETURN:
  328.  
  329.                            SET UNARC=D:\DEARC
  330.  
  331.             This will place the string "UNARC=D:\DEARC" in the DOS 
  332.             environment for Arcmaster to read.  The SET command is 
  333.             probably best employed from your AUTOEXEC.BAT file so 
  334.             that each time your computer boots up, the desired 
  335.             environment strings are added.  The following is a sample 
  336.             of how you might specify all five settings from your 
  337.             AUTOEXEC.BAT file:
  338.  
  339.                            SET ARC=C:\MYARC
  340.                            SET EXT=D:\DEARC
  341.                            SET HLP=C:\UTIL
  342.                            SET CFG=E:\CONFIGS
  343.                            SET TYPE=ARC
  344.  
  345.             The fifth item above should only be used if you are using 
  346.             Buerg's ARCA and ARC-E.  If you are using PKARC and 
  347.             PKXARC, then omit this line and Arcmaster will default to 
  348.             Phil Katz's system.
  349.  
  350.             NOTE:  If you choose to use the DOS environment to specify 
  351.                    one or more of the five items above, make sure that 
  352.                    the items are NOT specified in the .CFG file
  353.                    (see the next section).  The .CFG file takes 
  354.                    precedence and if you have an item specified in the 
  355.                    environment and have it specified differently in 
  356.                    the .CFG file, the specification in the .CFG file 
  357.                    will take precedence.
  358.  
  359.          -- The Arcmaster Configuration File.
  360.  
  361.             The Arcmaster distribution package includes two
  362.             configuration files.  One is named ARCMASTR.CFG and the
  363.             other is named COLOR.CFG.  COLOR.CFG is only a sample.
  364.             Users desiring to change the Arcmaster default colors
  365.             should place the appropriate commands in ARCMASTR.CFG.
  366.             When executed, Arcmaster will find and load ARCMASTR.CFG,
  367.             read it and make the appropriate adjustments to the
  368.             default settings.  Since this file is a straight ASCII
  369.             text file, it is easily user created or modified.  The
  370.             following paragraphs explain the various items that can
  371.             be specified in ARCMASTR.CFG.
  372.  
  373.             Normally, the .CFG file must be in the same directory as
  374.             ARCMASTR.EXE when it is executed.  If not, you must 
  375.             specifiy its location on the command line at run time as
  376.             follows:
  377.  
  378.                          arcmastr d:\myutils\cfgfiles
  379.  
  380.             This can be accomplished at the DOS prompt or from a 
  381.             batch file, as desired.  You can omit the drive specifier
  382.             (d: in the example above) if you are starting Arcmastr
  383.             from the same drive that contains the .CFG file.
  384.  
  385.             -- Configuration Item Format.
  386.  
  387.                All items in the file follow the same format.  Each
  388.                line of the file starts with a keyword.  Arcmaster
  389.                keys on the first character of the key word so the
  390.                key word may be just about anything desired as long
  391.                as it starts with the correct character.  The key
  392.                word is followed by a space and then and "=" sign,
  393.                another space and then the configurable item itself.
  394.                Here is an example:
  395.  
  396.                    beeps = off
  397.  
  398.                In this case the key word is beeps and the desired
  399.                setting is off.  This could just as correctly
  400.                specified as:
  401.  
  402.                   Bells = OFF
  403.  
  404.                or as:
  405.  
  406.                   BELGRADE = On
  407.  
  408.                Notice that case is not important.  In the case of
  409.                toggled items like this example, there are only two
  410.                choices, off and on - well, actually three, since
  411.                you can omit the item altogether.  Here's another
  412.                example:
  413.  
  414.                   arc = \somedir\myarcdir  ;host dir for arc files
  415.  
  416.                In this example the user is defining the host
  417.                directory for all newly created .ARC files.  The
  418.                keyword is arc and the target setting is a legal DOS
  419.                path specifier.  Notice that you can comment
  420.                configuration commands by preceding them with a
  421.                semicolon.  Here are the keywords and the Arcmaster
  422.                default settings:
  423.  
  424.                Keyword          Function           Default Setting
  425.                -------   ----------------------    ---------------
  426.                arc       defines host directory    load directory [*]
  427.                          for created ARC files
  428.  
  429.                unarc     defines host directory    load directory [*]
  430.                          where files extracted
  431.                          from an ARC file are
  432.                          placed
  433.  
  434.                beeps     determines if errors      off
  435.                          cause beeps
  436.  
  437.                squash    determines whether or     off
  438.                          not PKARC will use the
  439.                          new (and controversial)
  440.                          "squash" method of
  441.                          compressing files
  442.  
  443.                type      If omitted, the PKARC     omitted [*]
  444.                          system is used.  If
  445.                          set to arc, the ARCA
  446.                          system is use.
  447.  
  448.                drvlist   specifies the drives      from C to the last
  449.                          and sequence to use       logical drive reported
  450.                          during global system      by DOS
  451.                          file searches.
  452.  
  453.                help      specifies the path        directory from which
  454.                          location of the .HLP      Arcmastr is executed [*]
  455.                          file.
  456.  
  457.                The [*] denotes those items that may also specified
  458.                in the DOS environment by using the SET command (see
  459.                section above).  If included in the .CFG file, these
  460.                items will override the settings in the environment.
  461.                In addition to these four items, "SET CFG=" may be
  462.                used to inform Arcmaster where the .CFG file resides
  463.                in your system.
  464.  
  465.                Only the first character of the keyword is actually
  466.                significant.  You can use longer words as mnemonic
  467.                reminders of what the keyword means.
  468.  
  469.             -- Arc and Unarc Settings.
  470.  
  471.                If the "arc = \somedir" and/or "unarc = \somedir" lines are
  472.                omitted, Arcmaster will use the current active subdirectory
  473.                to store a newly created ARC file and/or to store extracted
  474.                de-arced files.  Also, it will look for the specified .ARC
  475.                file in the current subdirectory if you are adding files.
  476.                If you use the main menu F10 option to specify the arc or
  477.                unarc subdirectory or if you placed the "arc = \somedir"
  478.                and/or the "unarc = \somedir" lines in the .CFG file, then
  479.                Arcmaster will always use the specified subdirectory as the
  480.                target for archival operations.
  481.  
  482.             -- Color Monitor Configuration.
  483.  
  484.                Setting up a CGA to your personal tastes is easy.
  485.                The following format must be used in the
  486.                configuration file (the values shown are the default
  487.                values for Arcmastr when used with a CGA).
  488.  
  489.                    #b = 01   ;border color
  490.                    #m = 1F   ;main window color
  491.                    #t = 4F   ;top and bottom logo bars color
  492.                    #p = 4F   ;cursor bars color
  493.                    #g = 1E   ;message window color
  494.                    #e = 1E   ;entry window color
  495.                    #s = 1E   ;status window color
  496.                    #r = 1C   ;error window color
  497.                    #i = 1E   ;time display color
  498.                    #d = 1E   ;date display color
  499.  
  500.                Note that each line must begin with a pound sign
  501.                character ("#") and must start in column one of the
  502.                file.  A one character (not case sensitive) command
  503.                identifier immediately follows the pound sign which
  504.                is then followed by a space, an equals sign, a space
  505.                and then a TWO digit hex number.  The first digit of
  506.                the hex number specifies the background color and
  507.                the second digit controls the foreground color.  Use
  508.                the following table to put together the desired
  509.                background and foreground digits.
  510.  
  511.                Foreground colors              Background colors
  512.                -----------------              ------------------
  513.                0  - black                     0  - black
  514.                1  - blue                      1  - blue
  515.                2  - green                     2  - green
  516.                3  - cyan                      3  - cyan
  517.                4  - red                       4  - red
  518.                5  - magenta                   5  - magenta
  519.                6  - brown                     6  - brown
  520.                7  - light gray                7  - light gray
  521.                8  - gray
  522.                9  - light blue
  523.                A  - light green
  524.                B  - light cyan
  525.                C  - light red
  526.                D  - light magenta
  527.                E  - yellow
  528.                F  - white
  529.  
  530.                The Arcmastr distribution package contains a sample
  531.                configuration file COLOR.CFG that contains the
  532.                settings listed above.  Just rename it to
  533.                ARCMASTR.CFG to try it on a color monitor.
  534.  
  535.                The default attribute for a monochrome monitor system
  536.                is 0F, which is high intensity on black.  If you prefer
  537.                low intensity, set all the colors (except #b, #p, & #t)
  538.                to 07.  Defaults for #b and #p are 70, which is inverse
  539.                video.  The default monochrome border is 01.  If you
  540.                don't like the solid inverse video cursor bar, just set
  541.                #m to low intensity (07) and #p to high intensity (0F).
  542.                Or if you'd like the cursor to blink the target item, set
  543.                #p to 8F.  80 will give you a blinking inverse video
  544.                cursor and for real masochists, 01 will give low intensity
  545.                underline and 09 high intensity underline.
  546.  
  547.          -- The DOS Path Command
  548.  
  549.             It is vital for the operation of Arcmaster that you
  550.             correctly set the DOS environment path string.  The
  551.             directory or directories containing PKARC, PKXARC (or
  552.             ARC, ARC-E), and LIST must be included in the DOS path
  553.             string.  For example, suppose you are using ARC and
  554.             ARC-E and they reside in D:\UTIL\ARC.  And suppose that
  555.             LIST resides in C:\GOODPROG\LISTER.  You must ensure
  556.             that, as a minimum, the path command looks like this:
  557.  
  558.                PATH=C:\GOODPROG\LISTER;D:\UTIL\ARC
  559.  
  560.             This is critical and is the first thing you should
  561.             check if Arcmaster is not functioning properly.
  562.  
  563.          -- Program Names.
  564.  
  565.             For the sake of simplicity and because the programs
  566.             that Arcmaster interfaces with are distributed using
  567.             different names to indicate different versions (i.e.,
  568.             the latest version of list is distributed as LIST62A),
  569.             I have required that the programs be named as follows:
  570.  
  571.                     PKARC
  572.                     PKXARC
  573.                     ARCA
  574.                     ARC-E
  575.                     LIST
  576.  
  577.             Therefore, you must have the programs you are going to
  578.             use with Arcmaster properly named and their host
  579.             directories must be included in the DOS environment
  580.             path string.  If this is done, Arcmaster will be off
  581.             and running like the champ it is.
  582.  
  583.       -- Operating Arcmaster.
  584.  
  585.          Arcmaster is easy to operate!  It is almost entirely
  586.          driven by one-keystroke menu options, displays a one-line
  587.          explanatory message for each menu option, and offers
  588.          extensive on-line help.  Help is available almost anywhere
  589.          by just pressing the "h" key.  Normally, the .HLP file must
  590.          be in the same directory as Arcmaster when it is executed 
  591.          but you can specify its location by placing the following 
  592.          line in the .CFG file:
  593.  
  594.                      help = \util
  595.                 or   help = d:\extra\util
  596.  
  597.          Use the drive specifier if you are starting Arcmastr from a
  598.          drive other than the one containing the directory in which
  599.          the .HLP file resides.
  600.  
  601.          -- Starting Arcmaster.
  602.  
  603.             Just remember that you need to have accomplished four
  604.             small tasks prior to running Arcmaster.  Did you do
  605.             these?
  606.  
  607.                   1. Setup ARCMASTR.CFG for your settings.
  608.                   2. Ensure the archive system programs and LIST
  609.                      are properly named.
  610.                   3. Ensure that the DOS environment PATH string
  611.                      includes the directories containing the
  612.                      archive programs and LIST.
  613.                   4. Place ARCMASTR.HLP in same directory as
  614.                      ARCMASTR.EXE
  615.  
  616.             Ok, just type ARCMASTR at the DOS command line and away
  617.             we go!  If you desire to load Arcmaster from a directory 
  618.             that does not contain ARCMASTR.CFG, then type in the 
  619.             path name of the directory where it is actually located 
  620.             like so:
  621.  
  622.                     arcmastr \tree\dir1\cfgfiles
  623.                 or  arcmastr e:\cfgfiles
  624.  
  625.             Or you may use the "SET CFG=" command from the DOS prompt or
  626.             from a .BAT file to specify the directory in which the .CFG
  627.             resides, e.g., SET CFG=E:\CFGFILES.
  628.  
  629.          -- The Main Arcmaster Screen.
  630.  
  631.             The main screen is divided into windows (or boxes, if
  632.             you will).  The top window displays the label of the
  633.             current disk drive and the name of the active
  634.             directory.  The next window contains boxes which
  635.             display the system time and date and the total and
  636.             tagged file counts.  The next ten lines are divided
  637.             into to two equal size boxes.  The left box contains
  638.             the ten main menu selections.  The right box contains a
  639.             smaller box that has my Shareware notice in it.  This
  640.             notice will not be present in the version sent to
  641.             registered owners.  Below the two large boxes are four
  642.             windows where various items of information are
  643.             displayed.  All required user entries will be made
  644.             through the window labeled Entry.
  645.  
  646.          -- The Main Menu.
  647.  
  648.             There are ten menu selections to choose from.  A menu
  649.             item may be selected by its associated function key or
  650.             by moving the cursor bar to that item and pressing
  651.             return.  The up and down arrow keys move the cursor up
  652.             and down one item at a time.  The Home key homes the
  653.             cursor bar to item number 1 and the End key homes it to
  654.             item number 10.  As the cursor bar is moved, a one line
  655.             explanatory message appears in the Entry window.  Help
  656.             on any menu item is available by pressing the "h" key
  657.             with the cursor bar over that item.  The double box
  658.             area of the screen will clear and be replaced by a help
  659.             message pertaining to the selected item.  Arcmaster is
  660.             exited by pressing ESC from the main window.  The ESC
  661.             key is used throughout the program to abort an
  662.             operation and return to the previous operational level.
  663.  
  664.             -- Main Menu Selections.
  665.  
  666.                -- F1 - DeARC Archive Files.
  667.  
  668.                   This selection is used for de-arcing one or more
  669.                   archive files.  If any .ARC files are present in
  670.                   the current directory, the middle area of the
  671.                   screen will clear and a list of up to 40 .ARC
  672.                   file names will appear.  If there are more than
  673.                   40 .ARC files in the directory, you can page
  674.                   through them using the PgUp and PgDn keys.  A
  675.                   cursor bar is available to move with the arrow
  676.                   keys to select file names.  The Home key homes
  677.                   the cursor to the first file on the page and the
  678.                   End key positions it to the last file on the
  679.                   page.  Pressing the plus (+) key will tag an .ARC
  680.                   file for de-arcing and the minus (-) key is used
  681.                   to untag.  Pressing ESC will return you to the
  682.                   main window display.  If you tagged any .ARC
  683.                   files for de-arcing, the Shareware notice box
  684.                   will be replaced by the following sub_menu:
  685.  
  686.                        F1 - Extract   no option
  687.                        F2 - Extract   -r option
  688.                        F3 - Extract   -c option
  689.                        F4 - Extract   -p option
  690.                        F5 - Test      -t option
  691.  
  692.                   This example is for PKXARC - a similar menu
  693.                   appears for ARC-E.  I won't go into the specifics
  694.                   of each de-arcing function - Katz and Buerg both
  695.                   do a fine job of that in their documentation.
  696.                   When you make a selection, the screen will clear
  697.                   and either PKXARC or ARC-E will take over and de-
  698.                   arc ALL of the tagged .ARC files.  The extracted
  699.                   files will be placed in the directory that you
  700.                   designated as the unarc directory in the
  701.                   configuration file.  If none was specified,
  702.                   extracted files will be placed in the current
  703.                   directory.  Don't forget that help is available
  704.                   on these functions by pressing the "h" key.
  705.  
  706.                   Back in the ARC directory display now, pressing
  707.                   return will clear the filename display and
  708.                   replace it with a display of the selected .ARC
  709.                   file's directory listing.  The directory is
  710.                   presented in the following format, 10 file names
  711.                   at a time:
  712.  
  713.                   # name  date  time  size  <length>  method
  714.  
  715.                   # is an index number, date and time are file date
  716.                   and time, size is actual uncompressed size of the
  717.                   archived file, length is the compressed size of
  718.                   the file, and method is a two character
  719.                   abbreviation of the compression method used, as
  720.                   follows:
  721.  
  722.                          CR = crunched
  723.                          PA = packed
  724.                          SQ = squeezed
  725.                          ST = not compressed
  726.                          QU = squashed (PKXARC only)
  727.  
  728.                   The cursor bar is moved through the file with the
  729.                   up and down arrows and the PgUp and PgDn keys.
  730.                   In this case, the Home key homes to the top of
  731.                   the directory and the End key moves to the end of
  732.                   the listing.  Now here's the neat part.  If you
  733.                   have Buerg's LIST program, press return with the
  734.                   cursor bar over a file entry.  LIST will be
  735.                   invoked, take control, and you can now browse the
  736.                   arced file without having to de-arc it!
  737.  
  738.                -- F2 - Create or Add to ARC
  739.  
  740.                   This function is the logical reverse of the de-
  741.                   arc function.  In this case the middle portion of
  742.                   the screen will clear and the display will
  743.                   contain file names of all files in the current
  744.                   directory.  Simply move the cursor to the files
  745.                   you desire to archive and press the plus (+) key
  746.                   to tag them.  The minus (-) key untags.  You
  747.                   cannot tag an .ARC file but you can press return
  748.                   with cursor bar over an .ARC file name and view
  749.                   the contents of its directory and browse any file
  750.                   in the list with Buerg's LIST program.
  751.  
  752.                   When you are finished viewing or tagging, press
  753.                   ESC.  If you tagged files, you will be presented
  754.                   with the following sub-menu in the right-hand
  755.                   box:
  756.  
  757.                        F1 - Archive  no option
  758.                        F2 - Archive  f option
  759.                        F3 - Archive  u option
  760.                        F4 - Archive  d option
  761.                        F5 - Archive  m option
  762.                        F6 - Comment  x option
  763.                        F7 - Comment  c option
  764.  
  765.                   Again, this is the menu for PKARC and a similar
  766.                   menu will appear if you're using ARCA.  Consult
  767.                   the operating manual of either program for more
  768.                   specifics on these options.  The "h" key provides
  769.                   a summary explanation of each item.  When an item
  770.                   is selected, you are prompted for the .ARC file
  771.                   name.  The name you enter can be a for a new,
  772.                   non-existing .ARC file or for one that already
  773.                   exists, but if it exists, it must reside in the
  774.                   directory you specified as the host directory for
  775.                   .ARC files in the configuration file.  If you
  776.                   didn't specify one, Arcmaster will use the
  777.                   current directory.  Remember, most of the
  778.                   selections available are applicable to existing
  779.                   .ARC files.  Arcmaster can make .ARC file
  780.                   management much, much easier but it cannot think
  781.                   for you or anticipate your desires.
  782.  
  783.                   When you make a selection, the screen will clear
  784.                   and you will see PKARC or ARCA swing into action.
  785.  
  786.                -- F3 - Selectively DeArc Files.
  787.  
  788.                   This option provides you with the capability to
  789.                   enter an archive directory listing and select
  790.                   individual files in the directory to operate on.
  791.                   The screen will clear and the display will
  792.                   contain all (if any) .ARC files in the current
  793.                   directory.  Move the cursor to the desired .ARC
  794.                   file and press return.  The directory listing of
  795.                   that file will be displayed.  You can now move
  796.                   the cursor to specific files and tag (or untag)
  797.                   those files for specific de-arcing operations.
  798.  
  799.                   When you're through tagging, press ESC, and a
  800.                   sub-menu will appear in the right hand box that
  801.                   looks like this:
  802.  
  803.                        F1 - Extract  no option
  804.                        F2 - Extract  -r option
  805.                        F3 - Extract  -c option
  806.                        F4 - Extract  -p option
  807.                        F5 - Delete   -d option
  808.  
  809.                   These are PKXARC options.  Similar options are
  810.                   offered for ARC-E.  Extracted files will be
  811.                   placed in the unarc directory specified in the
  812.                   configuration file or in the current directory,
  813.                   if unspecified.  When a selection is made, the
  814.                   screen will clear and PKXARC or ARC-E will take
  815.                   over an perform the indicated operation.
  816.  
  817.                -- F4 - ARC Command Line Ops.
  818.  
  819.                   This selection permits you to invoke PKARC or
  820.                   ARCA with wild card designators if desired.  You
  821.                   will be prompted for the file names, dos file
  822.                   masks, options, switches, etc.  You DO NOT type
  823.                   in the name of PKARC or ARCA.  That will be
  824.                   inserted for you.  The help ("h" key) function
  825.                   has a summary of command line items for your
  826.                   specified Archiver program.
  827.  
  828.                -- F5 - DeARC Command Line Ops.
  829.  
  830.                   This works exactly the same as F4 above except
  831.                   that it invokes PKXARC or ARC-E.  The same
  832.                   comments apply.
  833.  
  834.                -- F6  - Change Drive/Directory.
  835.  
  836.                   Here you have the facility to move around the
  837.                   drives and/or directories in your system.  Enter
  838.                   a valid directory path name and Arcmaster will
  839.                   make that directory the current directory.  To
  840.                   change drives, enter the drive letter and a colon
  841.                   (:) alone (i.e., D:) and Arcmaster will change to
  842.                   the default directory on the specified drive.  Or
  843.                   enter both the drive and target directory name
  844.                   (i.e., C:\GOODPROGS\LEVEL2).  Pressing return
  845.                   without typing anything in will command Arcmaster
  846.                   to return to the drive and directory from which
  847.                   you loaded and executed it.  Pressing ESC aborts
  848.                   the command and returns main menu cursor control.
  849.  
  850.                -- F7 Search for ARCed File.
  851.  
  852.                   Now we are into some neat stuff!  Arcmaster can
  853.                   find any archived file anywhere in your system.
  854.                   You will be prompted for a file name.  Enter the
  855.                   full file name with extension.  Arcmaster will
  856.                   then search every .ARC file it finds on the
  857.                   current drive for the target file.  If it finds
  858.                   it, the middle area of the screen will clear and
  859.                   you will see some portion of the .ARC file's
  860.                   directory listing with the bar cursor on top of
  861.                   the file you wanted to find!!!  You can now press
  862.                   return and call Vern's super LIST program to
  863.                   browse that file.  Press ESC to leave that
  864.                   display and the search will continue until all
  865.                   .ARC files on the drive have been searched.  If
  866.                   you desire to search a specific drive, precede
  867.                   the file name with the drive character and a
  868.                   colon (i.e., D:TARGET.DAT).  Remember the drive
  869.                   sequence list item you put in the configuration
  870.                   file?  Enter the target file name with a star and
  871.                   a colon (i.e., *:TARGET.DAT) and Arcmaster will
  872.                   search the drives you placed in that list in the
  873.                   order that you placed them.  I think this feature
  874.                   alone is well worth the price of Arcmaster.
  875.  
  876.                -- F8 - Search for Any File.
  877.  
  878.                   More neat stuff!  This works just like the F7
  879.                   selection except that now you can search for any
  880.                   file anywhere in your system.  Enter a target
  881.                   file name using the same rules as given above.
  882.                   When the file is found, the middle portion of the
  883.                   screen will clear and a portion of the directory
  884.                   the file was found in will appear with the cursor
  885.                   bar sitting on top of the target file!!  Want to
  886.                   view it?  Press return and let LIST do its magic!
  887.  
  888.                -- F9 - Display Files.
  889.  
  890.                   Use this selection to bring up a display showing
  891.                   up to 40 file names from the current directory.
  892.                   You can page up and down through the directory
  893.                   and view any file by pressing return with cursor
  894.                   bar highlighting its name.
  895.  
  896.                -- F10 - Change Config Settings.
  897.  
  898.                   I think that you will find this feature very
  899.                   handy.  It allows you to dynamically change four
  900.                   of the key items that you placed in the
  901.                   configuration file.  This selection will bring up
  902.                   a sub-menu in the right hand box that looks like
  903.                   this:
  904.  
  905.                        F1 - Change ARC Directory
  906.                        F2 - Change DeARC Directory
  907.                        F3 - Change drive list
  908.                        F4 - Change ARChive System
  909.                        F5 - Change Squash Setting  (if using PK\PKX)
  910.  
  911.                   The first option permits you the flexibility to
  912.                   change the target directory for ARC operations
  913.                   and the second lets you re-set the destination
  914.                   directory for de-arc extraction operations. 
  915.                   Option 3 allows you to specify which drives and
  916.                   the sequence to use when employing the global
  917.                   system search ("*:searchname").  You probably
  918.                   won't need option 4 - it let's you switch
  919.                   between the PKARC and ARCA systems.
  920.  
  921.                   This is a good time to talk about Phil Katz's
  922.                   exclusive "squash" compression technique.  Phil
  923.                   has done a brilliant job of implementing fast,
  924.                   accurate file compression/de-compression
  925.                   techniques in his two programs.  He recently
  926.                   added a new technique that is very efficient
  927.                   called "squash".  Unfortunately, "squashed" files
  928.                   are not compatible with Vern's outstanding system
  929.                   and so BBSes and services like CIS discourage use
  930.                   of .ARC files containing entries that have been
  931.                   "squashed".  Phil's latest version provides a
  932.                   command line option (-oct) that suppresses use of
  933.                   "squash" when archiving files.  It also forces
  934.                   use of the more standard time/date stamping
  935.                   format.  If you have a version PKXARC that DOES
  936.                   NOT support the -oct switches, then place the
  937.                   command squash = on in ARCMASTR.CFG.  I know this
  938.                   seems the reverse of what it ought to be but when
  939.                   this option is set to "on", Arcmaster will NOT
  940.                   insert the -oct switch into the command line.  If
  941.                   you have Phil's latest version, you can go either
  942.                   way.  Just remember that the Arcmaster setting of
  943.                   squash = on forces Arcmastr to omit the -oct
  944.                   option and you should have no trouble.  This
  945.                   selection lets you change it while Arcmaster is
  946.                   running.
  947.  
  948.      -- Arcmaster Registration Form
  949.  
  950.         Remember, if you fill out this form in its entirety, 
  951.         you may register for $30.00.  Registrants will 
  952.         receive Arcmaster Plus on disk.
  953.  
  954.      
  955.      -------------------------------------------------------
  956.  
  957.      Name:_______________________________________
  958.  
  959.      Address:____________________________________
  960.  
  961.      City:_______________________________________
  962.  
  963.      State:______________________________________
  964.  
  965.      Zip:________________________________________
  966.  
  967.      What do you like about Arcmaster?  Please take as many 
  968.      lines as necessary to express your opinion:
  969.  
  970.  
  971.  
  972.  
  973.  
  974.  
  975.      What don't you like about Arcmaster?
  976.  
  977.  
  978.  
  979.  
  980.  
  981.  
  982.  
  983.     How could Arcmaster be improved?
  984.  
  985.  
  986.  
  987.  
  988.  
  989.  
  990.     From what source did you acquire your copy of Arcmaster?
  991.  
  992.  
  993.  
  994.  
  995.     Computer type/name_______________________________________
  996.  
  997.     Operating System____________
  998.  
  999.     Total memory on board_______________________
  1000.  
  1001.     Monitor/board type______________________________________
  1002.  
  1003.     Favorite ARC system (PKARC OR ARCA)_____________________
  1004.  
  1005.  
  1006.     Thank you very much for considering Arcmaster!
  1007.  
  1008.  
  1009.  
  1010.  
  1011.  
  1012.  
  1013.  
  1014.