home *** CD-ROM | disk | FTP | other *** search
/ Amiga ISO Collection / AmigaUtilCD1.iso / Cruncher / XFD109.LHA / xfd / Docs / xfdDecrunch.doc < prev    next >
Encoding:
Text File  |  1995-09-25  |  4.1 KB  |  121 lines
  1. NAME
  2.     xfdDecrunch 1.05
  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.  
  9. DESCRIPTION
  10.     xfdDecrunch unpacks crunched files. It requires either
  11.     Kickstart V37+ or the arp.library together with older
  12.     releases of the OS.
  13.  
  14.     SOURCE specifies the file(s) that should be decrunched.
  15.     Wildcards of any kind are supported.
  16.  
  17.     DEST is the file/drawer to save the result to.
  18.     If SOURCE contains wildcards/is a drawer, DEST must be
  19.     a directory. If it doesn't exist, it will be created.
  20.     If SOURCE is a single file, DEST can be an existing
  21.     directory or a (new) filename. In the first case, the
  22.     old filename will be used in the new directory.
  23.     Without DEST, the old files will be overwritten.
  24.  
  25.     Files that cannot be decrunched will usually not appear
  26.     in the DEST drawer. COPYALL tells xfdDecrunch to simply
  27.     copy all these files to the DEST drawer too. Certainly
  28.     this option only works if DEST is given.
  29.  
  30.     ALL makes xfdDecrunch go through all subdirectories
  31.     that exist in SOURCE. Note that these drawers are
  32.     created in the same order in the DEST directory.
  33.     If there exists a file with the name of a drawer to be
  34.     created, files will be written to the parent drawer.
  35.     If NODIRS is given, no subdirectories will be created
  36.     and files from all drawers will be written to DEST.
  37.  
  38.     If DEST already exists, you will be asked if you want
  39.     to overwrite the file. With FORCE, this request will
  40.     be skipped.
  41.  
  42.     With CLONE, the decrunched files (and drawers) receive
  43.     the same comments and protection bits as the source
  44.     files.
  45.  
  46.     Usually, when an error occurs while decrunching a file,
  47.     xfdDecrunch asks if you want to continue with the next
  48.     files or quit. With NOASK specified, this request will
  49.     be skipped and decrunching continues automatically.
  50.  
  51.     With files that are crunched with an absolute address
  52.     cruncher, you have two additional options: LINKSIMPLE
  53.     and LINKPRO. The first one links a quite simple header
  54.     to the decrunched data that simply copies the file to
  55.     the required location and executes it. The second
  56.     header is more complex. It tries to allocate the wanted
  57.     memory area and works with overlays thus not needing
  58.     any memory at all before allocating the desired area.
  59.     This is absolutely system-friendly and should work
  60.     even on machines with less RAM.
  61.  
  62.     Sometimes it may happen that you get a crunched file
  63.     that is decrunch-protected with an additional hunk
  64.     linked somewhere in front of or after the decrunch
  65.     header of the file. With STRIPHUNKS, you can remove
  66.     name, symbol and debug hunks from the file, giving
  67.     you a better chance to finally decrunch that file.
  68.  
  69. HISTORY
  70.     xfdDecrunch 1.05
  71.     - Added option STRIPHUNKS.
  72.     - xfdmaster.library v36+ is required now.
  73.  
  74.     xfdDecrunch 1.04a
  75.     - Debugged some arp.library stuff.
  76.  
  77.     xfdDecrunch 1.04
  78.     - Added decrunch support for files that are locked
  79.       with 16/32 bit keys.
  80.     - Special hello to all Kickstart 1.2/1.3 users.
  81.       Yes, it works again. Re-added full arp.library
  82.       support for the old Kickstart versions.
  83.     - Modified the professional header for address
  84.       files a bit for Kickstart 1.2/1.3 support.
  85.  
  86.     xfdDecrunch 1.03
  87.     - CLONE doesn't clone the creation dates anymore.
  88.     - CLONE now also clones the comments and protection
  89.       bits of any drawers that are created.
  90.     - Added COPYALL option.
  91.     - Added abbrevations for NODIRS and NOASK options.
  92.  
  93.     xfdDecrunch 1.02
  94.     - Totally removed arp.library and Kick 1.3 support.
  95.       It was impossible to implement all OS 2 features.
  96.     - xfdDecrunch now creates the same drawer hierarchy
  97.       in the destination drawer as given in the source
  98.       drawer (with ALL option).
  99.     - Source and destination lengths are printed now.
  100.     - Added NODIRS and NOASK options.
  101.     - Added LINKSIMPLE and LINKPRO options.
  102.  
  103.     xfdDecrunch 1.01
  104.     - Fixed bug in CLONE routine. SetFileDate() has been
  105.       called on Kick 1.3, but it's not available there!
  106.     - Changed some internal stuff for the documented
  107.       release of xfdmaster.library 33.2.
  108.  
  109.     xfdDecrunch 1.00
  110.     - First public release.
  111.  
  112. COPYRIGHT
  113.     xfdDecrunch is freely distributable and for
  114.     noncommercial use only.
  115.  
  116. AUTHOR
  117.     Georg Hörmann
  118.     Martinswinkelstraße 16c
  119.     82467 Garmisch-Partenkirchen
  120.     Germany
  121.