home *** CD-ROM | disk | FTP | other *** search
/ APDL Public Domain 1 / APDL_PD1A.iso / compress / cruncher / !Cruncher / !Help next >
Encoding:
Text File  |  1992-07-15  |  6.0 KB  |  125 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.13 =====
  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 one 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 may 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 also get the error 'Abort on data transfer', but the
  58. main difference is, that the Filer is a task and will be shutdown by the
  59. WindowManager whereas the Obey module (in case the !Boot file is an Obey
  60. file) is not so cannot be shutdown. The result is that if the Filer is
  61. shutdown, you won't be able to view any directory anymore until you quit
  62. from the desktop.
  63.  
  64. When you double-click on a crunched file, !Cruncher will decompress the file
  65. to <Wimp$Scrap> and a message will be send to all tasks 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. ===== 1.09 (19-Feb-1991) =====
  103. When crunching an empty file (ie length is 0 bytes) the Cruncher would
  104. report the following FileSwitch error: 'No writeable memory at this
  105. address'. Now it ignores empty files (they cannot be crunched anyway).
  106.  
  107. ===== 1.12 (20-Feb-1991) =====
  108. Now it's possible to double-click on a crunched file. !Cruncher will
  109. decrunch it and will broadcast a Message_DataOpen call, so the specific
  110. application can load the decrunched file.
  111.  
  112. ===== 1.13 (24-Feb-1991) =====
  113. Fixed a bug which caused non date-stamped files to be crunched. This occured
  114. when a directory/application is dragged to the iconbar, and a non
  115. date-stamped file resides inside that directory/application.
  116.  
  117. ----------------------------------------------------------------------------
  118.  
  119. For comments/bugs/the latest version or whatever you can contact me at:
  120.  
  121. Michel Fasen
  122. Hertoglaan 47
  123. 5262 JM  VUGHT
  124. Holland
  125.