home *** CD-ROM | disk | FTP | other *** search
/ AmigActive 11 / AACD11.ISO / AACD / System / xfd / Docs / xfdDecrunch.doc < prev    next >
Text File  |  2000-06-27  |  6KB  |  157 lines
  1. NAME
  2.     xfdDecrunch 1.9
  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,NX=NOXPKPWD/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.     When NOXPKPWD is used, then the program does not try
  76.     to use XPK password requester, but always uses shell
  77.     request.
  78.  
  79. HISTORY
  80.     xfdDecrunch 1.9
  81.     - Added support for XPK password requests.
  82.  
  83.     xfdDecrunch 1.8
  84.     - Added NOEXTERN option.
  85.  
  86.     xfdDecrunch 1.7
  87.     - Fixed xfdFreeObject() call. Some bytes have not been
  88.       released correctly. Thanks to WEPL for the hint.
  89.     - Fixed problem with single '*' wildcard. This was not
  90.       interpreted as '#?', but as the current Shell window.
  91.       This actually is a DOS problem, but replacing a '*'
  92.       internally with '#?' fixes the problems. Thanks to
  93.       Holger Wessling for the hint.
  94.     - Fixed problems with empty files. They caused the
  95.       stupid 'Not enough memory' error. Now they are
  96.       reported as 'Empty file'.
  97.  
  98.     xfdDecrunch 1.6
  99.     - Fixed 'Continue after error?' request. If there
  100.       aren't any more files after the error occured,
  101.       you won't get that request any longer.
  102.     - Fixed problem with empty files and COPYALL option.
  103.       Now empty files are created in the destination
  104.       drawer too. Thanks to Axel Folley for that hint.
  105.  
  106.     xfdDecrunch 1.5
  107.     - Added option STRIPHUNKS.
  108.     - xfdmaster.library v36+ is required now.
  109.  
  110.     xfdDecrunch 1.4a
  111.     - Debugged some arp.library stuff.
  112.  
  113.     xfdDecrunch 1.4
  114.     - Added decrunch support for files that are locked
  115.       with 16/32 bit keys.
  116.     - Special hello to all Kickstart 1.2/1.3 users.
  117.       Yes, it works again. Re-added full arp.library
  118.       support for the old Kickstart versions.
  119.     - Modified the professional header for address
  120.       files a bit for Kickstart 1.2/1.3 support.
  121.  
  122.     xfdDecrunch 1.3
  123.     - CLONE doesn't clone the creation dates anymore.
  124.     - CLONE now also clones the comments and protection
  125.       bits of any drawers that are created.
  126.     - Added COPYALL option.
  127.     - Added abbrevations for NODIRS and NOASK options.
  128.  
  129.     xfdDecrunch 1.2
  130.     - Totally removed arp.library and Kick 1.3 support.
  131.       It was impossible to implement all OS 2 features.
  132.     - xfdDecrunch now creates the same drawer hierarchy
  133.       in the destination drawer as given in the source
  134.       drawer (with ALL option).
  135.     - Source and destination lengths are printed now.
  136.     - Added NODIRS and NOASK options.
  137.     - Added LINKSIMPLE and LINKPRO options.
  138.  
  139.     xfdDecrunch 1.1
  140.     - Fixed bug in CLONE routine. SetFileDate() has been
  141.       called on Kick 1.3, but it's not available there!
  142.     - Changed some internal stuff for the documented
  143.       release of xfdmaster.library 33.2.
  144.  
  145.     xfdDecrunch 1.0
  146.     - First public release.
  147.  
  148. COPYRIGHT
  149.     xfdDecrunch is freely distributable and for
  150.     noncommercial use only.
  151.  
  152. AUTHOR
  153.     Georg Hörmann
  154.     Martinswinkelstraße 16c
  155.     82467 Garmisch-Partenkirchen
  156.     Germany
  157.