home *** CD-ROM | disk | FTP | other *** search
/ Shareware 1 2 the Maxx / sw_1.zip / sw_1 / UTILS / UNDO_20.ZIP / UNDO.DOC next >
Text File  |  1992-01-03  |  6KB  |  115 lines
  1.  
  2. UNDO  --  User-friendly Non-Specific Dearchiving Operation
  3.  
  4. Version 2.0
  5.  
  6. By Christopher J. McConnell
  7.  
  8. Email: cjm@naucse.cse.nau.edu
  9.  
  10.       The purpose of UNDO is to provide a shell to dearchive a file
  11. without having to remember which dearchiver to use with which options.
  12.  
  13.       The inspiration for this program came from a non-programmer friend
  14. of mine, Ross Thomas, who could not handle all of the different archive
  15. formats, but still found file compression a valuable tool.  So here it is.
  16. A shell that dearchives most of the popular formats without the hassle.
  17.  
  18. UNDO handles ZOO, ZIP, ARC, ARJ, LZH, PAK, compression routines.
  19. These routines are owned and copyrighted by their respected authors.
  20.  
  21. UNDO needs to use a configuration file that UNDO will create at the root of
  22. each drive you use UNDO on.  If the file does not exist, then UNDO will create
  23. it for you.  If you run UNDO without any options UNDO will create a 
  24. configuration file for you, destroying the old one if it exists.
  25. This program will automatically configure itself if the program discovers that 
  26. there is not a configuration file on this drive.  To edit the configurations, 
  27. just use any text editor on the UNDO.CFG file in your root directory or execute
  28. UNDO without options to create a new configuration file.  The program will ask
  29. you for the complete path_name for each of the different dearchiving programs.
  30. If you do not have the dearchiver the program asks for, enter a CONTROL-D and
  31. press ENTER for the file_name.  Each path_name should be entered in the 
  32. following manner:
  33. DRIVE:\DIRECTORY(IES)\FILE_NAME.EXE[COM]
  34.  
  35. If you continuously receive BAD COMMAND OR FILENAME error, then run UNDO without
  36. options to re-create your configuration file.  The above error usually comes
  37. about with a bad or empty configuration file.
  38.  
  39.       Usage:  UNDO [ -l ] [ archive_name.ext ] [ file_name.ext ]
  40.  
  41.       Options:    -l  --  To list some or all of the files within the archive 
  42.                           in order to obtain the name of a file to be extracted.
  43.  
  44.                   archive_name.ext  --  The name of the archive to be opened or
  45.                           searched.  The extension must be included with the
  46.                           name, otherwise the program can not determine which
  47.                           dearchiver to use.
  48.  
  49.                   file_name.ext  --  This is the name of a particular file or
  50.                           files that you want out of an archive. Only 
  51.                           through the use of wildcards, are multiple files 
  52.                           handled.  You can not list multiple file_names.
  53.  
  54.                   no options  --  This will create the configuration file for
  55.                           you, prompting for information as it needs it.  If
  56.                           you already have a configuration file then it will
  57.                           overwrite it with the new information.
  58.  
  59.  
  60. Terms and Limitations:  This is a shell, not the actual archiving
  61.                         program.  Thus any fault of the dearchiving process
  62.                         is that of the archiver/dearchiver and not of UNDO.
  63.  
  64.                         UNDO uses only the simple e or x options for 
  65.                         extractions, other options are simply not available
  66.                         at this time.  This means that file_names, not 
  67.                         path_names will be extracted from archives.
  68.  
  69.                         If you find a bug in this program that I did not find,
  70.                         tell me, I will fix it and re-post the program as
  71.                         soon as possible.
  72.  
  73.                         UNDO is shareware.  If you like the program as is,
  74.                         send at least $10 for the use of it. There is a bit
  75.                         of time and effort put into programs such as this,
  76.                         and this time should be recognized in some manner.
  77.  
  78. **** NOTE ****          This Version of UNDO does not include all of the 
  79.                         options listed above without registration.  UNDO will 
  80.                         not handle the -l option or specific file(s) without 
  81.                         your registration.  The -l option will give an error,
  82.                         and use of the specific file will process the entire
  83.                         archive.  Upon receipt of $15, and your
  84.                         name and address, I will send you the full
  85.                         program.
  86.  
  87.                         Send your registration to:
  88.  
  89.                         Christopher J. McConnell
  90.                         492 W. Philomena Dr.
  91.                         Flagstaff, Az 86001
  92.  
  93.  
  94. Revision History:
  95.      1.1 -- This program is written in C and C will let
  96.             you hang yourself so I did.  Major bug with dealing with
  97.             options fixed.
  98.  
  99.      1.2 -- Bug fix for 1.1 was not compatible for all flavors
  100.             of computers.  Re-wrote fix for 1.1 for all flavors, and
  101.             recompiled code for entire 8088 series, instead of just
  102.             80286 and above.
  103.  
  104.      1.3 -- The file name would not always be empty upon start-up, 
  105.             thus you would occasionally get erroneous file listings 
  106.             from the dearchivers.  (Full Version only)
  107.  
  108.      2.0 -- Re-wrote options handling to take into account no options,
  109.             the program now creates (or replaces) the configuration file
  110.             if no options are given.  Re-wrote the configuration file 
  111.             creation routine to have clearer directions of use.  Edited
  112.             program for faster execution and easier modification.  Added
  113.             ability to list an archive using wildcards and/or a file_name 
  114.             to see only specific files. 
  115.