home *** CD-ROM | disk | FTP | other *** search
/ Acorn User 4 / AUCD4.iso / utils / programing / app_squash / !AppSquash / !Help next >
Text File  |  1998-08-08  |  3KB  |  95 lines
  1.    _           ___                    _
  2.   / \  ___ ___/ __| ___ _  _ ___  ___| |_
  3.  / = \| _ \ _ \__ \/ _ | || / _ |(_-<| ' \
  4. /_/ \_|  _/  _/___/\_  |\_,_\_,_|/__/|_||_| 1.27, 8 August 1998
  5.       |_| |_|        |_|
  6.  
  7. Written by Darren Salt
  8. LZW code based on Michael Rozdoba's Squash-compatible code
  9. Squeeze and UnSqueeze © Acorn Computers Ltd
  10. Squeeze patch written by Nick "call me Nicholas Clark" Clark
  11.  
  12. LZW decompression now StrongARM compliant - hopefully...
  13.  
  14.  
  15. How to use
  16. ----------
  17.  
  18. AppSquash will squash application image files, modules, and BASIC programs,
  19. producing files that, when run, will unsquash themselves and then run as if
  20. they hadn't been squashed. It can also handle modules squeezed using modsqz.
  21.  
  22.  
  23. All you need to do is to drag the file(s) you want to compress to the
  24. AppSquash icon, and for each file in turn, a save box will appear. You may
  25. overwrite the original (but be careful).
  26.  
  27. The available options are:
  28.  
  29.      Squash    Squeeze
  30. Absolute   €       €
  31. Module           €
  32. BASIC       €       €
  33.  
  34. The 'Force' option forces the application (if Squeeze is selected) or module
  35. to be squeezed anyway, even if the resulting file would be larger.
  36.  
  37. Once you have decided where to save the file (in the normal way - it's just a
  38. standard save box), AppSquash will compress the file, and, if successful,
  39. will save it for you. If it fails for any reason, you will be told why and no
  40. file will be created. Note that if the file is not compressible, an exact
  41. copy will be made.
  42.  
  43. The option "Patch sqz" on the iconbar menu determines whether the 'data
  44. abort' patch is applied to squeezed programs. If applied, then when the
  45. program is run and there isn't enough memory for it to unsqueeze itself,
  46. it'll complain "Not enough memory" instead of causing a data abort. (This
  47. patch will work whether the program was squeezed using squeeze v4 or v5.)
  48.  
  49.  
  50. AppSquash will also unsquash and unsqueeze files. Just follow the same
  51. procedure; the file will be saved according to its original filetype.
  52. However, squeezed modules (ie. those created by squeeze, rather than modsqz
  53. or AppSquash) will be recognised, as will BASIC programs squeezed using
  54. AppSquash.
  55.  
  56. The datestamp is always preserved when using the LZW method; Squeeze, for
  57. some reason, doesn't preserve it - AppSquash will ensure that the original
  58. datestamp is written to the squeezed (or unsqueezed) file.
  59.  
  60. If a file is recognised as squeezed but unpatched, you have the option of
  61. unsqueezing it or patching it; select the required option and save as usual.
  62.  
  63. WARNING: files squashed by older (<1.26) versions of AppSquash may be
  64. rejected or be incorrectly unsquashed. Unfortunately, I can't find an older
  65. version to fix this...
  66.  
  67.  
  68. Squeeze and Unsqueeze
  69. ---------------------
  70.  
  71. Squeeze must be in either !AppSquash or somewhere on Run$Path; your library
  72. directory is a good place to put it. UnSqueeze must be installed in
  73. AppSquash.
  74.  
  75. (You will find copies of both in !Patch.)
  76.  
  77.  
  78. SqzPatch
  79. --------
  80.  
  81.   sqzpatch <source> [-o <destination>] 
  82.  
  83. A small stand-alone command-line utility for patching squeezed files. It does
  84. not replace AppSquash's own patching code, since that is desktop only :-)
  85. (BASIC with appended data - be careful!)
  86.  
  87. You may move it to your library directory if you wish.
  88.  
  89.  
  90.  
  91. Contact
  92. -------
  93.  
  94. ds@youmustbejoking.demon.co.uk
  95.