home *** CD-ROM | disk | FTP | other *** search
/ Magazyn Amiga Shareware Floppies / ma32.dms / ma32.adf / xfd-lib / docs / xfdDecrunch.doc next >
Text File  |  1994-03-27  |  3KB  |  95 lines
  1. NAME
  2.     xfdDecrunch 1.02
  3.  
  4. SYNOPSIS
  5.     xfdDecrunch SOURCE/A,DEST,ALL/S,FORCE/S,CLONE/S,NODIRS/S,
  6.                 NOASK/S,LS=LINKSIMPLE/S,LP=LINKPRO/S
  7.  
  8. DESCRIPTION
  9.     xfdDecrunch unpacks crunched files.
  10.     Kickstart V37+ is required.
  11.  
  12.     SOURCE specifies the file(s) that should be decrunched.
  13.     Wildcards of any kind are supported.
  14.  
  15.     DEST is the file/drawer to save the result to.
  16.     If SOURCE contains wildcards/is a drawer, DEST must be
  17.     a directory. If it doesn't exist, it will be created.
  18.     If SOURCE is a single file, DEST can be an existing
  19.     directory or a (new) filename. In the first case, the
  20.     old filename will be used in the new directory.
  21.     Without DEST, the old files will be overwritten.
  22.  
  23.     ALL makes xfdDecrunch go through all subdirectories
  24.     that exist in SOURCE. Note that these drawers are
  25.     created in the same order in the DEST directory.
  26.     If there exists a file with the name of a drawer to be
  27.     created, files will be written to the parent drawer.
  28.     If NODIRS is given, no subdirectories will be created
  29.     and files from all drawers will be written to DEST.
  30.  
  31.     If DEST already exists, you will be asked if you want
  32.     to overwrite the file. With FORCE, this request will
  33.     be skipped.
  34.  
  35.     With CLONE, the decrunched files receive the same
  36.     comments, creation dates and protection bits as the
  37.     source files.
  38.  
  39.     Usually, when an error occurs while decrunching a file,
  40.     xfdDecrunch asks if you want to continue with the next
  41.     files or quit. With NOASK specified, this request will
  42.     be skipped and decrunching continues automatically.
  43.  
  44.     With files that are crunched with an absolute address
  45.     cruncher, you have two additional options: LINKSIMPLE
  46.     and LINKPRO. The first one links a quite simple header
  47.     to the decrunched data that simply copies the file to
  48.     the required location and executes it. The second
  49.     header is more complex. It tries to allocate the wanted
  50.     memory area and works with overlays thus not needing
  51.     any memory at all before allocating the desired area.
  52.     This is absolutely system-friendly and should work
  53.     even on machines with less RAM.
  54.  
  55. EXAMPLES
  56.     Shell> xfdDecrunch DH0:C/#?
  57.         Decrunches all files in DH0:C.
  58.  
  59.     Shell> xfdDecrunch DF0:#? DH0:Temp ALL CLONE
  60.         Decrunches all files on DF0: and saves them
  61.         with the original attributes to DH0:Temp.
  62.  
  63.     Shell> xfdDecrunch DF2:Test DF1:Test FORCE
  64.         Decrunches DF2:Test and overwrites DF1:Test
  65.         without asking the user.
  66.  
  67. HISTORY
  68.     xfdDecrunch 1.02
  69.     - Totally removed arp.library and Kick 1.3 support.
  70.       It was impossible to implement all OS 2 features.
  71.     - xfdDecrunch now creates the same drawer hierarchy
  72.       in the destination drawer as given in the source
  73.       drawer (with ALL option).
  74.     - Source and destination lengths are printed now.
  75.     - Added NODIRS and NOASK options.
  76.     - Added LINKSIMPLE and LINKPRO options.
  77.  
  78.     xfdDecrunch 1.01
  79.     - Fixed bug in CLONE routine. SetFileDate() has been
  80.       called on Kick 1.3, but it's not available there!
  81.     - Changed some internal stuff for the documented
  82.       release of xfdmaster.library 33.2.
  83.  
  84.     xfdDecrunch 1.00
  85.     - First public release.
  86.  
  87. COPYRIGHT
  88.     xfdDecrunch is freely distributable for noncommercial use.
  89.  
  90. AUTHOR
  91.     Georg Hörmann
  92.     Am Lahnewiesgraben 19
  93.     82467 Garmisch-Partenkirchen
  94.     Germany
  95.