home *** CD-ROM | disk | FTP | other *** search
/ Dream 52 / Amiga_Dream_52.iso / RiscOS / APP / DEVS / BASIC / BASCRU.ZIP / !BasCrunch / !Help next >
Text File  |  1993-03-03  |  4KB  |  116 lines
  1. !Help for !BasCrunch v 1.02
  2. ---------------------------
  3.  
  4. BASIC cruncher by gnari (Email: gnari@grun.is  RealWorld: Ragnar Hafsta≡).
  5. Desktop front-end by Dick Alstein.
  6.  
  7. As its name suggests, this application crunches BASIC programs, resulting
  8. in smaller and faster code, in addition to it being incomprehensible and
  9. hard to debug.
  10.  
  11.  
  12. The desktop application
  13. -----------------------
  14.  
  15. The program installs itself on the icon bar. To crunch a BASIC file, drag
  16. its icon from a Filer window to the icon bar icon. A "Save as:" box opens,
  17. allowing you to enter the leaf name of the crunched file. Then drag the
  18. icon from the box to a Filer window, or to an application (like !Edit).
  19.  
  20. (Note: the original file will be replaced by the crunched one if you use
  21. the same leaf name and drag it to the same directory.)
  22.  
  23. The menu has, apart from the usual "Info" and "Quit", one entry: "Options"
  24. opens a window in which you can set the various crunching options. Some
  25. options may need a bit of explanation:
  26.  
  27. Output suitable for editor
  28.     The most compact crunching results in files that may not be editable
  29.     anymore. You can still load the files into an editor (!Edit, !StrongEd,
  30.     whatever) to view them. But if you make a few changes and save the
  31.     file, the program may not work anymore. (The editors have difficulty in
  32.     re-tokenising the compacted BASIC code). Setting this option leaves a
  33.     few extra spaces in the crunched file, so it is still editable.
  34.  
  35. Create line '0REM <filename>'
  36.     Adds a REM line with the filename of the original to the crunched code.
  37.     (Note: You should not have a line with number 0 in the original; that
  38.     line will be lost if this option is set.)
  39.  
  40. Exceptions
  41.     Use this option if you want to crunch most, but not all variable names.
  42.     Put the names of these variables in a Text file, and drop the file on
  43.     the icon. You can also type the filename in into the icon.
  44.     The variable names must be separated by Newline. Note that for example,
  45.     'count' will also refer to 'count%', 'count$', 'PROCcount', 'FNcount'.
  46.  
  47.  
  48. The Options window is also opened when you click on the icon bar icon with
  49. Select.
  50.  
  51.  
  52. The command-line program
  53. ------------------------
  54.  
  55. !BasCrunch is a front-end to the command line program 'ccrunch' residing
  56. inside this application. Command-line freaks can use it directly.
  57.  
  58. Syntax:
  59.  
  60. *ccrunch [switches]
  61.   switches are:
  62.       -h      gives minimal help and sytax reminder
  63.       -v      reports on progress
  64.       -m      disables multiple statement line building
  65.       -f      disables crunching of FN/PROC names
  66.       -e      disables discarding of empty lines
  67.       -s      disables crunching of variables.(implies -f)
  68.       -n      disables changing SYS names to numbers
  69.       -t      implements text friendly crunching. this is to make
  70.               crunched output convertable to text and back in a non
  71.               destructive way. mainly, this means that spaces are left
  72.               between tokens and variables.
  73.       -r      does not remove REM's and assembler comments
  74.       -rn     does not remove REM's and comments in the first n lines
  75.       -0      adds a line: 0REM crunched "<filename>"
  76.               this does not renumber, so you should not have
  77.               a line number 0.
  78.       -xfile  file contains a list of variables not to be crunched
  79.       -ifile  source file. the -i may be omitted.
  80.       -ofile  destination file. the -o may be omitted.
  81.               if this parameter is omitted then source filename is used
  82.  
  83.       All switches are case sensitive.
  84.  
  85. Examples:
  86.  
  87. *ccrunch file                        will crunch file with all options
  88.                                      enabled and overwrite original program.
  89.  
  90. *ccrunch -v -m -e -s -n file file2   Will crunch file, only removing
  91.                                      spaces and REMs and such, and save
  92.                                      result as file2. It will report on
  93.                                      progress.
  94.  
  95. Bugs and sane suggestions should be addressed to the authors
  96.  
  97. ccrunch:
  98.            gnari (Ragnar Hafsta≡)
  99.            Grun Ltd
  100.            Box 852, Brautarholt 2
  101.            121 Reykjavφk
  102.            Iceland
  103.  
  104.            Tel:   (354)(1)624672
  105.            Email: gnari@grun.is
  106.  
  107.  
  108. front-end:
  109.            Dick Alstein
  110.            Lijnslagerstraat 204
  111.            NL-5625 BP Eindhoven
  112.            The Netherlands
  113.  
  114.            Tel:   +31 40 428318
  115.            Email: wsinda@info.win.tue.nl
  116.