home *** CD-ROM | disk | FTP | other *** search
/ Hall of Fame / HallofFameCDROM.cdr / util1 / parc2.lzh / PARC.DOC next >
Text File  |  1991-03-01  |  17KB  |  359 lines
  1.       PARC.EXE (tm) v2.0r COPYR. 1991 DataWare  All Rights Reserved 03/91
  2.  
  3.                            Purge ARChive file utility
  4.  
  5.                          (tm)  ┌─────────┐
  6.                          ┌─────┴───┐     │ MEMBER
  7.                       ───┤         │     ├────────────────
  8.                          │  ┌──────┴──┐  │ Association of
  9.                          │  │         ├──┘   Shareware
  10.                          └──┤    ■    │    Professionals
  11.                       ──────┤    ║    ├───────────────────
  12.                             └────╨────┘
  13.  
  14.  
  15.                           THIS IS NOT FREE SOFTWARE!
  16.  
  17.    Shareware distribution gives users a chance to try software before buying
  18. it.  If you try a Shareware program and continue using it, you are expected
  19. to register.  Individual programs differ on details -- some request registra-
  20. tion while others require it, some specify a maximum trial period. With regis-
  21. tration, you get anything from the simple right to continue using the software
  22. to an updated program with printed manual.
  23.  
  24.    Copyright laws apply to both Shareware and commercial software, and the
  25. copyright holder retains all rights, with a few specific exceptions as stated
  26. below.  Shareware authors are accomplished programmers, just like commercial
  27. authors, and the programs are of comparable quality.  (In both cases, there are
  28. good programs and bad ones!)  The main difference is in the method of distribu-
  29. tion.  The author specifically grants the right to copy and distribute the
  30. software, either to all and sundry or to a specific group.  For example, some
  31. authors require written permission before a commercial disk vendor may copy
  32. their Shareware.
  33.  
  34.    Shareware is a distribution method, not a type of software. You should find
  35. software that suits your needs and pocketbook, whether it's commercial or
  36. Shareware.  The Shareware system makes fitting your needs easier, because you
  37. can TRY BEFORE YOU BUY.  And because the overhead is low, prices are low also.
  38. Shareware has the ultimate money-back guarantee - if you don't use the product,
  39. you don't pay for it!
  40.  
  41.    The essence of "user-supported" software is to provide personal computer
  42. users with quality software without high prices, and yet to provide incentive
  43. for programmers to continue to develop new products.
  44.  
  45.                                    DISCLAIMER
  46.                                    ----------
  47.              USERS OF PARC MUST ACCEPT THIS DISCLAIMER OF WARRANTY!
  48.  
  49.    "PARC is supplied as is.  The author disclaims all warranties, expressed or
  50. implied, including, without limitation, the warranties of merchantability and
  51. of fitness for any purpose.  The author assumes no liability for damages,
  52. direct or consequential, which may result from the use of PARC."  PARC is a
  53. "shareware program" and is provided at no charge to the user for evaluation.
  54.  
  55.                                    AGREEMENT                             Page 2
  56.                                    ---------
  57.  
  58.        PARC MAY BE DISTRIBUTED FREELY WITHOUT CHARGE AS LONG AS IT
  59.        REMAINS UNALTERED WITH ALL ORIGINAL FILES INCLUDED IN A SINGLE
  60.        UNIT. PARC MUST NOT BE INCLUDED AS PART OF ANOTHER SYSTEM/PROGRAM.
  61.  
  62.        USER GROUPS MAY CHARGE A SERVICE FEE NOT TO EXCEED $5.00 TO COVER
  63.        THE COST OF COPYING OR DISSEMINATION.  IT MUST BE MADE CLEAR THAT
  64.        THIS CHARGE IS IN NO WAY A REGISTRATION OR LICENSE FEE.
  65.  
  66.        GRANTING THE RIGHT TO DISTRIBUTE THE EVALUATION COPY OF PARC
  67.        DOES NOT IN ANY WAY INDICATE OWNERSHIP IN ANY FORM.
  68.  
  69.        ANY OTHER USE, DISTRIBUTION OR REPRESENTATION OF PARC IS
  70.        EXPRESSLY FORBIDDEN WITHOUT THE WRITTEN CONSENT OF DATAWARE.
  71.  
  72.  
  73.    Anyone distributing PARC for any kind of remuneration must first contact
  74. DataWare at the address below for authorization.  This authorization will be
  75. automatically granted to distributors recognized by the (ASP) as adhering to
  76. its guidelines for shareware distributors, and such distributors may begin
  77. offering PARC immediately (However DataWare must still be advised so that the
  78. distributor can be kept up-to-date with the latest version of PARC).  Please
  79. see file VENDOR.DOC.
  80.  
  81.                                   Registration
  82.                                   ------------
  83.  
  84.    If you find this program useful and find that you are using PARC and
  85. continue to use PARC after a reasonable trial period, you *MUST* make a
  86. registration payment of $15.00 US for a non-commercial single-user license.
  87. The $15.00 registration fee will license one copy for use on any one computer
  88. at any one time.  A one-time "site license" registration fee for commercial
  89. or multi-system use is $95.00 US.  Users outside of the US and Canada should
  90. include $5.00 for international postage.  Ohio residents must include 5.75%
  91. sales tax.  Please see file PARC.REG.
  92.  
  93.           Send check or money order to:  DataWare
  94.                                          P.O. Box 13183
  95.                                          Columbus, OH 43213-9998
  96.  
  97.    Registered users will be shipped a current copy of parc excluding all
  98. references to registration.  Registered users will also receive the next
  99. version of PARC at no cost (when available) before general distribution
  100. of the evaluation copy is released.
  101.  
  102.    Commercial users of PARC must register and pay for their copies of PARC
  103. within 30 days of first use or their license is withdrawn.
  104.  
  105.    You are encouraged to pass a copy of the unregistered shareware version
  106. of PARC along to your friends for evaluation.  Please encourage them to
  107. register their copy if they find that they can use it.
  108.  
  109.                                 Archive Contents                         Page 3
  110.                                 ----------------
  111.  
  112. The complete PARC archive should contain the following files under the archive
  113. names of PARC2.SDN or PARC2.ZIP as they are distributed in both forms.
  114.  
  115. Filename     Size     Description
  116. ---------------------------------------------------
  117. PARC  .EXE   39330    executable file
  118. PARC  .DOC   17461    documentation for PARC
  119. PARC  .REG    6180    registration info & form
  120. PARC  .OMB     610    ASP Ombudsman info
  121. VENDOR.DOC    5619    Vendor info & form
  122.  
  123.                                  What Is PARC?
  124.                                  -------------
  125.  
  126. PARC is a handy archive file clean-up utility that searches archives automatic-
  127. ally removing files that have been extracted from archives without the use of
  128. other extraneous file deletion utilities.
  129.  
  130.                                   Limitations
  131.                                   -----------
  132.  
  133.    PARC handles most popular archive formats; ZIP/ARC/PAK-SDN/LZH-ICE/ZOO/ARJ
  134. and their respective COM & EXE archive formats .  This version does not handle
  135. LHA v2.xx archives (new) or SDN self-extracting archives (uncommon). PARC *MAY*
  136. NOT HANDLE ARCHIVES THAT USE CERTAIN SPECIALIZED OPTIONS.  These options are
  137. few, and seldom used.  PARC will handle a maximum of 512 files.
  138.  
  139. EGA/VGA 43/50 line mode: When initiated the current number of screen lines and
  140. video mode are stored.  The video mode and lines are then changed to 43 or 50
  141. lines depending on whether you have an EGA or VGA adapter.  Upon exit of the
  142. verify window, the previous lines and video mode are restored.  Certain adapt-
  143. ers don't respond well to this restoration process and may confuse the adapter
  144. causing the display to become irregular.
  145.  
  146.                                   Requirements
  147.                                   ------------
  148.  
  149.    PARC requires a minimum of 75k of memory to operate. It will run fully on
  150. any IBM PC compatible with a graphics adapter and DOS 2.x or higher with 256K.
  151.  
  152.    NOTE: If you are using DOS 2.x you will not be able to access the default
  153.          configuration if it is not in the current directory.  See docs on
  154.          ENVIRONMENT VARIABLE below.
  155.  
  156.                                   Installation
  157.                                   ------------
  158.  
  159.    Copy PARC.EXE to a directory which is in the PATH.  It may then be called
  160. from anywhere on your drive.  If you are using a command-line editor such as
  161. CED you can place it anywhere and assign a synonym to call it directly from
  162. that location.
  163.  
  164.                               Environment Variable
  165.                               --------------------
  166.  
  167.    If, when trying to configure PARC.EXE (/c option), PARC says it can't find
  168. itself, set the PARC environment variable.  Include the full path to the exec-
  169. utable.  You may put this in the autoexec.bat file or type it at the DOS
  170. prompt.   Example: set PARC=C:\UTILS\PARC.EXE
  171.  
  172.                                  How PARC Works                          Page 4
  173.                                  --------------
  174.  
  175.    PARC locates the archive(s) which you have designated on the command-line
  176. (may include paths and/or wildcards), reads the filenames contained within and
  177. searches the *CURRENT* directory to see if any of its files exist.  If files
  178. from the archive(s) exist in the current directory the filenames will be dir-
  179. ected to a window where you decide which (if any) to delete.
  180.  
  181.                                   Quick Start
  182.                                   -----------
  183.  
  184.    If you would like to give PARC a try so that you can see what it does before
  185. reading on, try the following:
  186.  
  187.    Create a one or more archives in an empty directory.
  188.    Extract all the files from the archive(s).
  189.    Run PARC *.*
  190.    Remember...PARC *SAVES* the tagged files in the archive window!
  191.    Try setting the default configuration with PARC /c and running it again.
  192.    Other options can be seen by just running PARC without any parameters.
  193.  
  194.                              ARCHIVE Verify Window
  195.                              ---------------------
  196.  
  197.    Files in the window are pre-sorted and appear alphabetically left to right.
  198. The "lightbar" will be highlighting the first item.  In the upper left corner
  199. of the files window is a status line that indicates which archive the file
  200. belongs to.
  201.  
  202.    We are all used to deleting files by tagging the items we want to delete
  203. and executing.  After using PARC for a while I found that I was almost always
  204. deleting all of the extracted files or just keeping the .EXE and/or .DOC files
  205. and deleting the rest.  For this reason PARC *SAVES* the files tagged and del-
  206. etes the rest. This is especially awkward at first but it does make more sense.
  207. In time you will get used to it.  If not, use the REVERSE TAG feature.
  208.  
  209.    To move around in the Archive Verify Window environment use the cursor keys
  210. and HOME/END keys.  Pressing the first letter of the filename will also move
  211. the lightbar to that file.  To TAG/UNTAG a file, highlight that file and press
  212. RETURN (ENTER).  If you move the "lightbar" over a tagged file the "lightbar"
  213. will flash indicating it is already tagged.  Once you have tagged the files you
  214. wish to save, press F10 and confirm (optional) to execute the removal of files.
  215.  
  216.    Additional verify window options follow.
  217.  
  218.    ESC: You may press the ESCAPE key at any time to abort the window and
  219.         program.
  220.  
  221.    NOTE: CTRL-BREAK will also abort safely at anytime during program operation
  222.          except when being prompted for confirmation.
  223.  
  224.    F10: EXECUTE.  Once pressed you will be asked at the bottom of the screen to
  225.         "Confirm the deletion of items *NOT* tagged (y/n/ESC)?".  This prompt
  226.         is designed to give you one last chance to change your mind.  It is
  227.         defaulted to "Y" so you need only hit the RETURN to continue.  Pressing
  228.         ESC or "N" will place you back into the files window exactly as is was
  229.         prior to pressing F10.  Pressing any other key at this prompt will
  230.         result in a short beep indicating an incorrect choice. Confirmation is
  231.         optional and may be turned off in the configuration.
  232.  
  233.                     ADDITIONAL VERIFY WINDOW OPTIONS (cont.)             Page 5
  234.  
  235.    F1 : TAG ALL.  Useful if you wish to keep all but one or two files.  Simply
  236.         untag the files you wish to delete.
  237.  
  238.    F2 : UNTAG ALL.  Useful if you have changed your mind and wish to start
  239.         over.
  240.  
  241.    F3 : REVERSE TAG.  As I stated previously, it is difficult to get used to
  242.         tagging the items you want to save rather than delete.  If you realize
  243.         you have tagged the files in a backward fashion, simply use the REVERSE
  244.         TAG to correct.
  245.  
  246.    F4 : TAG ASSOCIATED FILES.  This can be very useful!  If you have files from
  247.         several archives in the current directory and wish to keep the files
  248.         associated with a particular archive you need only highlight a file
  249.         from that archive and press F4.  All files from that archive will then
  250.         be tagged.  You can also use the REVERSE TAG feature in addition, to
  251.         dispose of just those files.  Maybe you just want to know which files
  252.         are associated with a particular archive.
  253.  
  254.                                PARC Command-Line
  255.                                -----------------
  256.  
  257.    Syntax:  PARC [archive-filename.ext] [{-/}option]
  258.  
  259.    The command-line is very flexible.  Wildcards are encouraged.
  260.  
  261.    Some Examples:
  262.  
  263.    PARC on the command-line by itself will show the copyright, point of
  264.    contact, command-line help and a disclaimer.
  265.  
  266.    PARC test.zip
  267.  
  268.       removes files from the current directory belonging to test.zip.
  269.  
  270.    PARC b:stuff.arc
  271.  
  272.       reads stuff.arc on drive b: and removes its files from the current
  273.       directory.
  274.  
  275.    PARC test.zip b:stuff.*
  276.  
  277.       reads test.zip from current directory and any archives named stuff from
  278.       drive b: and removes files associated with those archives from the cur-
  279.       rent directory.
  280.  
  281.    PARC *.*
  282.  
  283.       the most common usage; reads all EXE/COM/ARCHIVE files located in the
  284.       current directory and removes any files associated with them from the
  285.       current directory.
  286.  
  287.    NOTE: If the filename within an archive includes a path, the path is parsed
  288.          and only the filename is searched for in the current directory.  In
  289.          other words, PARC will not look for or delete files extracted from
  290.          archives outside of the current directory.
  291.  
  292.                            PARC Command-Line Options                     Page 6
  293.                            -------------------------
  294.  
  295.    Options may be placed anywhere on the command-line as long as they are
  296. spaced and are preceded by a "/" or "-" indicator.  Illegal options are
  297. ignored.
  298.  
  299.    Examples: PARC *.* /v /d    PARC -f     PARC /c    PARC -vo *.*
  300.  
  301.    /V : Turns off the verify window.  Handy if deleting all files.
  302.  
  303.    /D : Turns off the duplicate file filter.  This allows the user to determine
  304.         which archives contain the same filename(s).
  305.  
  306.    NOTE: When using the /D option the archive file count in the verify window
  307.          reflects duplicate files within archives, therefore the file count is
  308.          inaccurate.
  309.  
  310.    /F : Standard file deletion utility. Allows deletion of files with attribute
  311.         of archive or hidden.  The /V option will automatically be over-ridden
  312.         so that the verify window will *ALWAYS* be active.
  313.  
  314.    NOTE: This parameter ignores filespecs on the command-line.  It will read
  315.          all files in the current directory with the above attributes.  It was
  316.          designed to delete archive files or extraneous files created while
  317.          testing programs without calling a separate utility.
  318.  
  319.    WARNING: This window operates in a normal fashion and *DELETES* tagged items
  320.             unlike the archive window which *SAVES* tagged items.
  321.  
  322.    /C : Runs internal configuration.  Allows various default options to be set.
  323.  
  324.    NOTE: The configuration is internal to the PARC.EXE file.  PARC should find
  325.          itself even if renamed or called via a synonym from CED or other type
  326.          command-line editors. DOS 2.x users will need to set the PARC environ-
  327.          ment variable to find the executable file if PARC is not in the cur-
  328.          rent directory.
  329.  
  330.    /VO: Command-line over-ride; enables the use of the verify window if /V is
  331.         the default in the configuration file.
  332.  
  333.    /DO: Command-line over-ride; enables the use of the duplicate filter if /D
  334.         is the default in the configuration file.
  335.  
  336.                                   PARC History                           Page 7
  337.                                   ------------
  338.  
  339.    PARC was originally called MARCH (MopARCHive) and was released to the public
  340. domain.  The name has been changed to PARC for this Shareware release.
  341.  
  342.                                     Contact
  343.                                     -------
  344.  
  345.    All suggestions for improvement or of criticism will be graciously accepted
  346. via the following points of contact.
  347.  
  348.                   DataWare  P.O. Box 13183  Columbus, OH 43213-9998
  349.                   CIS : 71470,1007
  350.                   BBS : Utilities Exchange (U.S.A.) (614) 442-6695
  351.                   UUCP: ohio-state.edu!osu-cis!bluemoon!dgaulden
  352.  
  353.    The PARC Shareware evaluation program will be distributed via the Shareware
  354. Distribution Network (SDN), CIS, and various user groups.
  355.  
  356. IBM is a registered trademark of International Business Machines Corp
  357. CED is Copyrighted (c) 1985 by Christopher J. Dunford
  358.  
  359.