home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1993 #2 / Image.iso / comm / ozpr12.zip / OZPURGE.DOC next >
Text File  |  1993-06-22  |  6KB  |  159 lines
  1.  
  2.  
  3.  
  4.                   ┌────────────────────────────────┐
  5.                   │          OzPurge 1.2           │
  6.                   │                                │
  7.                   │   An OzCIS companion program   │
  8.                   │                                │
  9.                   │     by Patrick Philippot       │
  10.                   │                                │
  11.                   │ (c) 1993 - All rights reserved │
  12.                   └────────────────────────────────┘
  13.  
  14.             - OzCIS is copyrighted (c) 1990,1992 Steve Sneed -
  15.  
  16.  
  17.            I'm a statisfied OzCIS user. I could hardly find big problems
  18.       in this software. However, I think two features are missing to make
  19.       it almost perfect.
  20.  
  21.            First, I have noticed that, for an unknown reason, duplicate
  22.       entries happen to show up when opening the "Download" window. I
  23.       couldn't find when and why the problem occurs. Since OzCIS doesn't
  24.       have any provision for removing these entries, I had to do that
  25.       manually.
  26.  
  27.            Second, there's no way to purge the catalog files by date. So,
  28.       as time goes by, my catalog files keep growing while unnecessary
  29.       entries could be removed.
  30.  
  31.            So, I finally decided to do something for my hard disk. It was
  32.       also time to modestly contribute to the OzCIS project.
  33.  
  34.            OzPurge is a simple utility processing OzCIS catalog files
  35.       (.L* files) and removing all duplicate entries in these files.
  36.       Moreover, you can ask OzPurge to remove any entry older than a
  37.       given date. After running OzPurge against your catalog files,
  38.       you'll wonder how much disk space you can recover.
  39.  
  40.  
  41.       USING OzPurge
  42.       *************
  43.  
  44.            OzPurge is fairly simple to use. Here is the command syntax:
  45.  
  46.            ozpurge  filespec  [date]  [/log]
  47.  
  48.            Parameters enclosed within square brackets are optional. Square
  49.       brackets must not be typed in.
  50.  
  51.  
  52.            filespec    This parameter indicates which files have to be
  53.                        processed. Wildcards are allowed. Be aware that the
  54.                        original file(s) will be overwritten. So, if you want
  55.                        to keep a copy, backup the file(s) before proceeding.
  56.                        The  filespec  parameter  may include a path. Purged
  57.                        files will be saved in their current directory.
  58.  
  59.            date        If you want to remove entries older than a given
  60.                        date, enter this date after the filespec. The date
  61.                        must be specified in the same format as the one
  62.                        used in the catalog files:
  63.  
  64.                              dd-Jan-yy
  65.  
  66.                        dd is the day (2 digits mandatory).
  67.  
  68.                        the month can be specified as Jan, Feb, Mar, etc...
  69.                        (3 digits mandatory).
  70.  
  71.                        yy is the year (2 digits mandatory).
  72.  
  73.  
  74.            /log        This parameter was implemented mainly for debugging
  75.                        purposes. But you may find useful to have a report
  76.                        of all entries that were deleted along with the
  77.                        reason of their deletion. It must come after the
  78.                        date if any is specified or after the filespec
  79.                        otherwise.
  80.  
  81.  
  82.  
  83.            Examples:
  84.  
  85.  
  86.            ozpurge
  87.  
  88.            will do nothing. Display a syntax summary.
  89.  
  90.            ozpurge ibmapp.l1
  91.  
  92.            remove all duplicate entries in IBMAPP.L1
  93.  
  94.            ozpurge ibmapp.l*  01-Jan-90
  95.  
  96.            remove all duplicate entries in the specified files as well
  97.            as all entries older than 01/01/90.
  98.  
  99.            ozpurge ibmapp.l*  01-Jan-90 /log
  100.  
  101.            ditto + record all actions in OZPURGE.LOG. Existing log file is
  102.            destroyed.
  103.  
  104.  
  105.            Duplicate entries are systematically removed.
  106.  
  107.            The Log file is always generated in the current directory.
  108.  
  109.            Of course, running OzPurge against files that are not OzCIS
  110.       catalog files will give unpredictable results. However, OzPurge
  111.       will detect the error in most cases and will then issue an error
  112.       message. Binaries are also detected.
  113.  
  114.            All lines between the first line of the file and the header of
  115.       the first valid entry are deleted. Otherwise, all lines between two
  116.       valid entries are stored "as is" in the resulting file.
  117.  
  118.            Since OzCIS itself cannot deal with catalog files containing
  119.       tab characters, OzPurge assumes that these files are already
  120.       expanded (that is, all tab characters are converted to spaces).
  121.  
  122.            As soon as CIS will change the format of its library entries,
  123.       OzPurge will not work any more.
  124.  
  125.            The date comparison algorithm will not work after 1999. Please
  126.       drop a message before Thansksgiving 1999 to remind me that I have
  127.       to change the code...
  128.  
  129.            Since a catalog file is merely a dump of CIS screens, I guess
  130.       OzPurge will also work with other programs interfacing CIS. Feel
  131.       free to upload OzPurge wherever you want.
  132.  
  133.            OzPurge is a freeware. It may be freely copied and distributed
  134.       as long as no charge is made for the program itself. Including
  135.       OzPurge in a commercial package without written permission of the
  136.       author is prohibited.
  137.  
  138.            Have fun!
  139.  
  140.  
  141.  
  142.       Patrick Philippot, Draveil, France
  143.       06/22/93
  144.  
  145.  
  146.       Change History
  147.       **************
  148.  
  149.       version 1.1
  150.  
  151.       - Fixed bug when using OzPurge across drives or from a directory
  152.         which is not the directory where the catalog resides.
  153.  
  154.       version 1.2
  155.  
  156.       - The catalog's filedate is now left unchanged after processing. This
  157.         avoids problems when updating the catalog if OzPurge has not been
  158.         used just after downloading/updating.
  159.