home *** CD-ROM | disk | FTP | other *** search
/ ANews 1 / AnewsCD01.iso / Indispensables / Compression / xfd / Docs / xfdDecrunch.doc < prev    next >
Text File  |  1999-08-03  |  5KB  |  150 lines
  1. NAME
  2.     xfdDecrunch 1.08
  3.  
  4. SYNOPSIS
  5.     xfdDecrunch SOURCE/A,DEST,ALL/S,FORCE/S,CLONE/S,
  6.                 ND=NODIRS/S,NA=NOASK/S,LS=LINKSIMPLE/S,
  7.                 LP=LINKPRO/S,CA=COPYALL/S,SH=STRIPHUNKS/S,
  8.                 NE=NOEXTERN/S
  9.  
  10. DESCRIPTION
  11.     xfdDecrunch unpacks crunched files. It requires either
  12.     Kickstart V37+ or the arp.library together with older
  13.     releases of the OS.
  14.  
  15.     SOURCE specifies the file(s) that should be decrunched.
  16.     Wildcards of any kind are supported.
  17.  
  18.     DEST is the file/drawer to save the result to.
  19.     If SOURCE contains wildcards/is a drawer, DEST must be
  20.     a directory. If it doesn't exist, it will be created.
  21.     If SOURCE is a single file, DEST can be an existing
  22.     directory or a (new) filename. In the first case, the
  23.     old filename will be used in the new directory.
  24.     Without DEST, the old files will be overwritten.
  25.  
  26.     Files that cannot be decrunched will usually not appear
  27.     in the DEST drawer. COPYALL tells xfdDecrunch to simply
  28.     copy all these files to the DEST drawer too. Certainly
  29.     this option only works if DEST is given.
  30.  
  31.     ALL makes xfdDecrunch go through all subdirectories
  32.     that exist in SOURCE. Note that these drawers are
  33.     created in the same order in the DEST directory.
  34.     If there exists a file with the name of a drawer to be
  35.     created, files will be written to the parent drawer.
  36.     If NODIRS is given, no subdirectories will be created
  37.     and files from all drawers will be written to DEST.
  38.  
  39.     If DEST already exists, you will be asked if you want
  40.     to overwrite the file. With FORCE, this request will
  41.     be skipped.
  42.  
  43.     With CLONE, the decrunched files (and drawers) receive
  44.     the same comments and protection bits as the source
  45.     files.
  46.  
  47.     Usually, when an error occurs while decrunching a file,
  48.     xfdDecrunch asks if you want to continue with the next
  49.     files or quit. With NOASK specified, this request will
  50.     be skipped and decrunching continues automatically.
  51.  
  52.     With files that are crunched with an absolute address
  53.     cruncher, you have two additional options: LINKSIMPLE
  54.     and LINKPRO. The first one links a quite simple header
  55.     to the decrunched data that simply copies the file to
  56.     the required location and executes it. The second
  57.     header is more complex. It tries to allocate the wanted
  58.     memory area and works with overlays thus not needing
  59.     any memory at all before allocating the desired area.
  60.     This is absolutely system-friendly and should work
  61.     even on machines with less RAM.
  62.  
  63.     Sometimes it may happen that you get a crunched file
  64.     that is decrunch-protected with an additional hunk
  65.     linked somewhere in front of or after the decrunch
  66.     header of the file. With STRIPHUNKS, you can remove
  67.     name, symbol and debug hunks from the file, giving
  68.     you a better chance to finally decrunch that file.
  69.  
  70.     NOEXTERN prohibits the use of external slaves for
  71.     recognition and decrunching. This is very useful for
  72.     files that crash your machine everytime they are tried
  73.     to be decrunched, for example SFX files.
  74.  
  75. HISTORY
  76.     xfdDecrunch 1.08
  77.     - Added NOEXTERN option.
  78.  
  79.     xfdDecrunch 1.07
  80.     - Fixed xfdFreeObject() call. Some bytes have not been
  81.       released correctly. Thanks to WEPL for the hint.
  82.     - Fixed problem with single '*' wildcard. This was not
  83.       interpreted as '#?', but as the current Shell window.
  84.       This actually is a DOS problem, but replacing a '*'
  85.       internally with '#?' fixes the problems. Thanks to
  86.       Holger Wessling for the hint.
  87.     - Fixed problems with empty files. They caused the
  88.       stupid 'Not enough memory' error. Now they are
  89.       reported as 'Empty file'.
  90.  
  91.     xfdDecrunch 1.06
  92.     - Fixed 'Continue after error?' request. If there
  93.       aren't any more files after the error occured,
  94.       you won't get that request any longer.
  95.     - Fixed problem with empty files and COPYALL option.
  96.       Now empty files are created in the destination
  97.       drawer too. Thanks to Axel Folley for that hint.
  98.  
  99.     xfdDecrunch 1.05
  100.     - Added option STRIPHUNKS.
  101.     - xfdmaster.library v36+ is required now.
  102.  
  103.     xfdDecrunch 1.04a
  104.     - Debugged some arp.library stuff.
  105.  
  106.     xfdDecrunch 1.04
  107.     - Added decrunch support for files that are locked
  108.       with 16/32 bit keys.
  109.     - Special hello to all Kickstart 1.2/1.3 users.
  110.       Yes, it works again. Re-added full arp.library
  111.       support for the old Kickstart versions.
  112.     - Modified the professional header for address
  113.       files a bit for Kickstart 1.2/1.3 support.
  114.  
  115.     xfdDecrunch 1.03
  116.     - CLONE doesn't clone the creation dates anymore.
  117.     - CLONE now also clones the comments and protection
  118.       bits of any drawers that are created.
  119.     - Added COPYALL option.
  120.     - Added abbrevations for NODIRS and NOASK options.
  121.  
  122.     xfdDecrunch 1.02
  123.     - Totally removed arp.library and Kick 1.3 support.
  124.       It was impossible to implement all OS 2 features.
  125.     - xfdDecrunch now creates the same drawer hierarchy
  126.       in the destination drawer as given in the source
  127.       drawer (with ALL option).
  128.     - Source and destination lengths are printed now.
  129.     - Added NODIRS and NOASK options.
  130.     - Added LINKSIMPLE and LINKPRO options.
  131.  
  132.     xfdDecrunch 1.01
  133.     - Fixed bug in CLONE routine. SetFileDate() has been
  134.       called on Kick 1.3, but it's not available there!
  135.     - Changed some internal stuff for the documented
  136.       release of xfdmaster.library 33.2.
  137.  
  138.     xfdDecrunch 1.00
  139.     - First public release.
  140.  
  141. COPYRIGHT
  142.     xfdDecrunch is freely distributable and for
  143.     noncommercial use only.
  144.  
  145. AUTHOR
  146.     Georg Hörmann
  147.     Martinswinkelstraße 16c
  148.     82467 Garmisch-Partenkirchen
  149.     Germany
  150.