home *** CD-ROM | disk | FTP | other *** search
/ Falcon 030 Power 2 / F030_POWER2.iso / ST_STE / MAGS / ICTARI01.ARJ / ictari.01 / ASSEMBLY / CRUNCH / CRUNCH40.DOC < prev   
Text File  |  1992-03-04  |  5KB  |  113 lines
  1.  
  2.  
  3.  
  4.                      THIS PROGRAM IS PUBLIC DOMAIN.
  5.  
  6. Permission is granted to copy this  program along with it's documentation
  7. as long as such copying is not for profit.
  8.  
  9.      This program  will  crunch  an   GEMDOS  executable    file    (i.e.
  10. files   with extensions .PRG, .TOS,  .TTP  &  .APP) into another  single,
  11. but shorter, executable file, thus  using  up  less  disk space, and also
  12. loading slightly quicker. Although  this   file   will  be  smaller  than
  13. the original,  it will still execute exactly as did the longer original.
  14.  
  15.      The program requires a command line of the following format:-
  16.  
  17.        [-[h][d][u][i]] <pathname>
  18.  
  19. Where:-
  20.  
  21. h   Will hold  screen  when  program   has  finished  (useful  if you are
  22. running   from the desktop).
  23.  
  24. d   Will stop the  deletion  of  the  original  file. (i.e. will give the
  25. file the extension  .CRU  if   crunching     and   .UCR   if  uncrunching
  26. instead of    using the original file  extension and    thus deleting the
  27. original file).
  28.  
  29. u    Will   cause   the    program    to     only    uncrunch,   crunched
  30. files,ignoring all others.
  31.  
  32. i   Will  cause  the  program   to   ignore   errors   (useful  when  one
  33. file  is   generating a read error)
  34.  
  35. If you use any of the   above   qualifiers  you  must  precede  them  all
  36. with a '-' character.
  37.  
  38. <pathname> is a standard GEMDOS path
  39.  
  40. e.g.
  41.  
  42. -hu a:\bits\*.*
  43.  
  44. Hold screen on exit, uncrunch all  files in folder "bits" on drive A.
  45.  
  46. d:\assembler\programs\*.prg
  47.  
  48. Crunch   all    .PRG    files    in     folder  "programs"    in   folder
  49. "assembler"  on drive D.
  50.  
  51. -h *.*
  52.  
  53. Crunch all files on  current  drive  and hold screen on exit.
  54.  
  55. Crunching files
  56. ---------------
  57.  
  58.      When    a    file    is    crunched successfully  it will be written
  59. back on to disk with the same  name  as  it  had before, thus erasing the
  60. original. There is no need to  worry  about   this  though, as  if a file
  61. doesn't work when  crunched  it  can  be   uncrunched   and  restored  to
  62. exactly as it was before. This shouldn't  happen though as from about 90+
  63. files   I  have   crunched  all  have  worked  perfectly  when   crunched
  64. (honestly!).  (You   can disable  this  deletion  of the original file by
  65. specifying the 'd' qualifier  in the  command  line).  Some files will of
  66. course not crunch at all  and  some  may only  be  reduced  by  a  couple
  67. of  K. However, I  have  seen   certain   program files crunched from 80K
  68. to 20K, so large reductions are quite possible.
  69.  
  70.      Non-executable   files    will,    of  course,  be  ignored  by  the
  71. cruncher.
  72.  
  73.      The aim  of  this  cruncher  is  to shorten  files  so that they use
  74. up less disk space, so the  cruncher   will  only write  a crunched file,
  75. back to disk, if it does in  fact   use  less  disk  space, otherwise  it
  76. will generate the message "File uncrunchable".
  77.  
  78. Uncrunching files
  79. -----------------
  80.  
  81.      When  uncrunching,  the  uncrunched file   will   be written back to
  82. disk with the same name as the  crunched  file  had. If  you  don't  wish
  83. this to happen then the 'd' qualifier will cause  it  to  be written with
  84. the extension 'UCR'.
  85.  
  86. Running out of memory
  87. ---------------------
  88.  
  89.      If  you  run  out  of  memory    try  getting  rid of all ram disks,
  90. desk ACCs. Copy the cruncher  onto  the  disk  that  has the  files to be
  91. crunched and execute it from there.  If  this fails then the  only option
  92. is  to  upgrade your memory. A 1 Meg. ST should be  able  to  crunch  any
  93. conceivably  sized  program,   although  a  520  may  have problems  with
  94. very  large program files.
  95.  
  96.      I   find   the    best    "crunching"  environment   is  to  put the
  97. cruncher into a ram disk as  small   as  possible  (i.e. one  with  about
  98. 3K free space) and  then  inserting  the  disks  with  the programs to be
  99. crunched into the  floppy  drive.   You  can  then  crunch  the files  by
  100. preceding the pathname with the drive  number  (e.g. "A:..."). I have the
  101. cruncher write over the   original   files   with  the crunched versions,
  102. because the crunched  versions always  work   and  if you wish to get the
  103. original  file  back  you   can    always  uncrunch   it.  If  you  would
  104. rather the original not be deleted  then use the 'd' qualifier,  although
  105. this  means  there must be enough  free  space on the disk to accommodate
  106. the new crunched file.
  107.  
  108. Disclaimer
  109. ----------
  110.  
  111. ICTARI can take no responsibility  for any data loss or any other form of
  112. damage  arising  from  the use of this program.
  113.