home *** CD-ROM | disk | FTP | other *** search
/ RISC DISC 1 / RISC_DISC_1.iso / pd_share / code / bascomp / !BC / !Help < prev    next >
Encoding:
Text File  |  1994-07-17  |  7.3 KB  |  201 lines
  1. Help for BasCompress v1.40  17-Jul-1994
  2.  
  3. BasCompress compresses and cross-references Basic programs.
  4.  
  5. To use this *SHAREWARE* program you will be a Basic programmer.
  6.  
  7. ======================================================================
  8. This program is supplied "as is".  No warranty, express or implied, of
  9. the  merchantability of this program or its fitness for any particular
  10. purpose is given.  In no circumstances shall the author, or any
  11. provider or distributor of this program, be liable for any damage,
  12. loss of profits, or any indirect or consequential loss arising out of
  13. the use of this program.
  14.  
  15. Please note that this program is SHAREWARE, it is not free.  You may
  16. use this software for a trial period.  If, after this  you decide you
  17. would like to continue using it, then you are required to REGISTER.
  18. Failing to register, you are obliged to destroy all copies of this
  19. program. A trial period ends when you realise that this program could
  20. be used on your latest master-piece!
  21.  
  22. Registration currently involves you sending a cheque for £10 sterling
  23. to the author.  There is a form at the end of this document that
  24. you can use to register.  Registration will encourage the author to 
  25. continue to develop this program further.
  26.  
  27. For a further £5, regsitration will include a printed (600 d.p.i.
  28. laser) copy of the documentation and the latest version.
  29.  
  30. Payment in other currencies accepted so long as at the end of the day
  31. I end out with the same amount of money.  Credit cards not accepted.
  32.  
  33. ======================================================================
  34.  
  35. For those of you without Impression, here's a very brief guide
  36.  
  37. (use the interactive Help)
  38.  
  39. BasCompress is a BasicV (v1.04) compressor and cross-referencer, i.e.
  40.  
  41. o     Removes spaces and comments
  42. o     Removes all unused routines, and the junk left between routines
  43. o     Reduces all labels (shortens them)
  44. o     Reduces numbers
  45. o     Converts SWI strings to numbers
  46. o     Loads in LIBRARYs
  47. o     Handles line numbers
  48. o     You can tell it which labels NOT to reduce (i.e. EVALuated vars)
  49. o     Full cross-referencing
  50. o     It is FAST
  51.  
  52. ======================================================================
  53.  
  54. Example usage
  55.  
  56. Drag the Log file icon from the control window to a Filer window
  57.  
  58. Now drag one of your Basic files onto the control window  (what do you
  59. mean, I haven't got any?  did you read those two lines at the top)
  60.  
  61. The log file will appear (auto-loading Edit if need be).  Don't close
  62. this window yet, though do resize/move it
  63.  
  64. Now drag the basic (output) file icon from the control window onto a
  65. Filer window
  66.  
  67. Press ADJUST on the icon bar icon (re-load's last file using new
  68. options)
  69.  
  70. And that's all there is to it, usually
  71.  
  72. Sometimes programmers end a routine like this:
  73.   DEF FNmin(a,b)
  74.   IF a<b THEN =a ELSE =b
  75. and BasCompress gets confused.  Append a dummy "= 0" after it
  76.  
  77. If there are any EVAL's or DATA's then the resulting file may not
  78. "work".  You can either disable all label reduction, or write a
  79. Special file, that tells BasCompress the names of the labels not to
  80. reduce.  See !BC.Examples for some, er..., examples.
  81.  
  82. Also, watch out for missing THEN statements.  See the
  83. !BC.Examples.EVariable file for more information.  Thanks to David for
  84. pointing this one out.
  85.  
  86.  
  87.  
  88. Don't make a fuss, just get on the bus
  89.  
  90. Ya Hozna!
  91.  
  92. =====================================================================
  93. ======================================================================
  94. Updates
  95.  
  96. v1.10 29-May-1992 ??
  97. v1.20 11-Jul-1992 Can compress "library" files separately, ie don't assume a
  98.                   "main program" exists, and dont complain of undefined
  99.                   routines/variables
  100.                   + assembler "B 0" compresses correctly
  101. 1.25  07-Oct-1992 RO3 support (menu help, Sprites22, desktop save,
  102.                   DragASprite)
  103. 1.30  11-Oct-1992 Frontend to new backend features
  104.                   Optionally saves full pathname for log/xref/output files
  105.                   Pointer changes shape over writable icons
  106. 1.31  18-Jan-1993 Anti-aliased fonts in templates
  107. 1.32  28-Jan-1993 Dynamic font handling across screen resolution changes
  108.                   removed all Interface code!!
  109. 1.33  07-Feb-1993 hi-rez sprites
  110. 1.33b 12-Feb-1993 registration form at end of this document
  111. 1.34  27-Feb-1993 hi-rez menu items
  112. 1.35  26-Mar-1993 internal update
  113. 1.35b 10-Jun-1993 hi-rez menu items definable in Messages file
  114. 1.36  18-Jul-1993 new FontWindow module to cope with new Wimps' menus
  115. 1.36b 19-Sep-1993 hi-rez mono sprites added
  116. 1.37  24-Feb-1994 newlook, loads sprites on mode change, drag proginfo
  117. 1.40  17-Jul-1994 Choices dialogue box, works on Risc PC, no/font dboxes
  118.  
  119. Backend Updates
  120. 1.23  23-Sep-1992 In assembler "SWI &7" was getting compressed to "SWI&7"
  121.                   In assembler ".zappa FN(foo_bar)" wasn't recognising that
  122.                     the FN() substitutes for a mnemonic, and so 'foo' was
  123.                     the mnemonic!!!
  124.                   Start of file consists of:
  125.                     REM >fs::media.dir.file
  126.                     REM produced by BasCompress vx.yy
  127.                   this is so that BASIC V v1.05 library error messages are OK
  128. 1.24  01-Oct-1992 If an error occured during file output, this is now reported
  129.                   (eg file not having write access)
  130. 1.30  11-Oct-1992 Corrupted basic error message now "correct" --- was saying
  131.                     something different
  132.                   Start of file consists of, as acorn guidelines suggest
  133.                     (ta Jonathan) leaf name only
  134.                   -EVariable option suppresses `E' variables being
  135.                     produced (see example file)
  136. 1.31  18-Jan-1993  assembler handles array labels (eg [OPT4:.x%(y%):]
  137.                    regular expressions used on variable names not to squash
  138.                    (but reference says from main program, not special)
  139.                    (no support for regex routine names or libraries)
  140.  
  141.  
  142. Bugs
  143.  
  144. There appears to be a bug if the same routine is defined many (> 2) times
  145. in separate libraries - for now just delete the extra copies and then it
  146. works.
  147.  
  148.  
  149.  
  150.  
  151.  
  152. Registration Form:
  153.  
  154.  
  155.  
  156.         I would like to register as a Single User of BasCompress v1.40
  157.         
  158.         and have enclosed __________.
  159.         
  160.         This DOES / NOT (delete as applicable) include a manual.
  161.         
  162.         
  163.         Title:          ___________
  164.  
  165.         Name:           ____________________________
  166.         
  167.         Address:        ________________________________
  168.         
  169.                         ________________________________
  170.         
  171.                         ________________________________
  172.         
  173.                         ________________________________
  174.         
  175.                         ________________________________
  176.         
  177.         Postcode:       _______________
  178.         
  179.         Country:        _______________
  180.         
  181.         Where obtained
  182.         BasCompress:    ____________________________
  183.         
  184.         Machine:        ___________________________________
  185.  
  186.         Possible
  187.         improvements:   ___________________________________
  188.         
  189.                         ___________________________________
  190.         
  191.         Make cheques / postal orders payable to: Mr CY J. BOOKER
  192.         
  193.  
  194.                         86 Church View,  Main Road,
  195.                         Crockenhill,
  196.                         Swanley,
  197.                         Kent.
  198.                         BR8 8JW.
  199.                         U.K.
  200.  
  201.