home *** CD-ROM | disk | FTP | other *** search
/ Acorn User 3 / AUCD3.iso / airport / utils / gzip / !gzip / docs / !Help / !Help~
Text File  |  1993-10-30  |  6KB  |  111 lines
  1. ================================ !Cruncher =================================
  2.  
  3. !Cruncher is written by ACE (Arc Angels).
  4. The compression modules are written by John Kortink.
  5.  
  6. ============================================================================
  7. ===== !Cruncher 1.08 =====
  8. ==========================
  9.  
  10. !Cruncher is a simple program to crunch/decrunch a file. It is different to
  11. (eg) !Spark in the way that !Cruncher only crunches a file and !Spark
  12. collects files into an archive. If it's useful to you depends on your own
  13. use of it. It proved useful to me anyway.
  14.  
  15. ===== Iconbar =====
  16. You install !Cruncher by double clicking on its icon in the filer window. It
  17. will appear on the Iconbar. When clicking with the menu button on the icon
  18. at the Iconbar you have 3 options:
  19.  - Info, for more information about !Cruncher
  20.  - Action, to tell the application what he must do with a file
  21.  - Quit, to leave the !Cruncher application
  22.  
  23. ====== The action option =====
  24. You can choose between 3 options:
  25.  - Crunch, for crunching files (only if they are not crunched yet)
  26.  - Decrunch, for decrunching files (only if they are already crunched)
  27.  - Reverse, for crunching uncrunched files and decrunching crunched files
  28.  
  29. A crunched file is recognized by its filetype, currently &000. When
  30. crunching a file all file types -except the crunched one and non-filetype
  31. files (ie with load/execution address)- are crunched. If the destination
  32. file (the crunched version) is bigger than or equal to the original file,
  33. then the original file is written back to disk (a file is crunched from
  34. memory to disk). The datestamp is retained here. When a file is crunched
  35. successful, the datestamp is altered slightly, because the original filetype
  36. has to be saved with it. This is acceptable because the difference with the
  37. original datestamp will be at most 41 seconds. When a file is decrunched
  38. its datestamp doesn't change. It will have the same datestamp as after
  39. crunching. When a directory/application is dragged to the !Cruncher
  40. application, all files inside that directory will be crunched/decrunched.
  41. All directories inside the directory/application dragged are also scanned.
  42.  
  43. =====WARNING=====
  44. The files !Boot, !Sprites and !Run files inside an application directory are
  45. not allowed to be crunched. The reason is that the command *IconSprites
  46. doesn't check if it's a sprite file or not. For example: If you crunched the
  47. file $.Help.!Test.!Sprites you get the following situation: when you click
  48. on the Help directory, the Filer searches for all applications inside the
  49. Help directory. In this case he founds the application !Test. If the file
  50. !Test.!Boot exists, the Filer will *Run that file. One of the commands in
  51. the !Boot file will be *IconSprites <Obey$Dir>.!Sprites. When that command
  52. is performed an 'Abort on data transfer' will occur (of course only when the
  53. !Sprites file isn't a sprite file, but a crunched file for example).
  54. Actually nothing happens and you will be able to view the contents of the
  55. !Test directory as usual. But if the !Boot file doesn't exist, the Filer
  56. will issue the command *IconSprites !Sprites (with full pathname of course)
  57. at its own. You will get the error 'Abort on data transfer' again, but after
  58. that you won't be able to do anything with the Filer! (all Filer windows
  59. will disappear and the drives at the left-bottom won't react on clicks).
  60.  
  61. =====Future=====
  62. An option that will be implemented in the near future is the possibility to
  63. double click on a crunched icon. With the current version (1.08) only a beep
  64. will be given. But in one of the next releases, the file will be decrunched
  65. to <Wimp$Scrap> and a message to all tasks will be given that the user has
  66. double clicked on file <Wimp$Scrap>. This will have the same effect as used
  67. in !Spark.
  68.  
  69. ============================================================================
  70. ===== Updates from !Cruncher =====
  71. ==================================
  72.  
  73. ===== 1.00 (30-Jan-1991) =====
  74. Original release.
  75.  
  76. ===== 1.02 (31-Jan-1991) =====
  77. Adapted the cruncher application to the Window Library. Also added the
  78. option of decrunching a file. Filetype of decrunched file will become &FFD.
  79. Fixed a bug which prevents from crunching large files. Also added the
  80. hourglass.
  81.  
  82. ===== 1.04 (01-Feb-1991) =====
  83. Added the option to reverse the file (a crunched file will be decrunched and
  84. a uncrunched file will be crunched). When a file is decrunched, the filetype
  85. will become the lower 12 bits of the date stamp. When a file is crunched the
  86. lower 12 bits of the datestamp will be set according to the original
  87. filetype. The result is that the datestamp isn't correct anymore, although
  88. the difference with the original datestamp will be +/- 41 seconds, which is
  89. acceptable.
  90.  
  91. ===== 1.07 (02-Feb-1991) =====
  92. It's now possible to drag directories/applications to the cruncher. All
  93. files (or other directories) inside the directory dragged, will be
  94. crunched/decrunched/reversed. If a file after crunching is bigger than the
  95. original, then the original file will be restored. Fixed a bug which caused
  96. the wrong datestamp written back to the crunched file.
  97.  
  98. ===== 1.08 (02-Feb-1991) =====
  99. You won't be able to crunch !Boot, !Sprites and !Run files inside an
  100. application directory. This is because a RISC OS bug. See notes above.
  101.  
  102. ----------------------------------------------------------------------------
  103. Please note that this application is made by ACE (Arc Angels) and that the
  104. cruncher/decruncher is made by by John Kortink.
  105.  
  106. For comments/bugs or whatever you can contact me at:
  107. Michel Fasen
  108. Hertoglaan 47
  109. 5262 JM  VUGHT
  110. Holland
  111.