home *** CD-ROM | disk | FTP | other *** search
/ Really Useful CD 1 / ReallyUsefulCD1.iso / extras / apps / _slash / _readme < prev    next >
Encoding:
Text File  |  1989-07-17  |  3.0 KB  |  56 lines
  1. ---------------------------------------------------------------------
  2.                  Brian Carroll, December 1988.
  3.  
  4. ---------------------------------------------------------------------
  5. This program allows you to remove any or all of: redundant leading
  6. spaces and colons, REMs, and empty lines, in that order. The
  7. stripped program has a line added: '0REM>new-path/file-name' so
  8. the system can refer to it properly (this is not done if you choose
  9. not to change anything). If the old program already had a line 0 you
  10. may find another in the new program, but you can easily re-number it.
  11.  
  12. You have the option to enter a range of line numbers which will not
  13. be processed at all, whatever the other options set. This is useful
  14. if you want to preserve a group of explanatory lines like these.
  15. You will see these lines flagged '[Skip]' during processing.
  16.  
  17. The program deals with assembler remarks (introduced by ';' or '\')
  18. but unfortunately detection of entry to and exit from the assembler is
  19. made difficult by the use of '[' and ']' within the assembler syntax;
  20. this slows processing. Lines are flagged '[Assembler]'. The algorithm
  21. will NOT deal correctly with EMBEDDED remarks; it assumes that they
  22. are always at the ends of lines, or on separate ones, like REMs.
  23.  
  24. The program will not allow you to attempt to compress a directory or
  25. a file whose 'type' is not BASIC, or to save to an existing locked
  26. file. It will warn you of overwriting an existing UNLOCKED file or
  27. if there is no disc in the nominated drive. In each case you can
  28. correct the error.
  29.  
  30. Note that BASIC lines BEGIN with &D, but here the &D's are used as
  31. line TERMINATORS. The new file is overlayed on top of the original
  32. in the byte array 'filespace', line by line. The original file is
  33. loaded into 'filespace' offset by sufficient space for the title
  34. line (up to one screen line long) to be inserted into the new file.
  35. The % compression and time taken are reported at the end.
  36.  
  37. -----------------------------------------------------------------------
  38.           RISC-OS Version 1.01 by Paul Hobbs 17-Jul-89
  39. -----------------------------------------------------------------------
  40.  
  41. This version multitasks under RISC-OS and provides all of the features
  42. (I think!) of the original Slash program. The use of the program should
  43. be fairly obvious, just drag a BASIC file into the Slash window or onto 
  44. the icon on the icon bar and set the required options. A future version
  45. may be forthcoming in which more compression (by joining lines and 
  46. changing variable names) may appear when I get round to it.
  47.  
  48. The !Run file is set to give a minimum of 100k and a maximum of 4meg to
  49. the WimpSlot - this is because trying to compact a large file may cause
  50. !Slash to run out of space and hang. Not very elegant I am afraid! To 
  51. avoid this possiblity it attempts to grab all the memory it can find so
  52. install !Slash last if you want to run alarms etc at the same time.
  53.  
  54. The !RunImage file is a compacted version of BasSource produced by !Slash
  55. itself, so if you want to make any changes edit BasSource and use !Slash
  56. to crunch it down again.