home *** CD-ROM | disk | FTP | other *** search
/ Archive Magazine 1996 / ARCHIVE_96.iso / discs / shareware / share_46 / bc / !BC / !Help < prev    next >
Text File  |  1994-02-24  |  7KB  |  200 lines
  1. Help for BasCompress v1.37 23-Feb-1994
  2.  
  3. To use this program you will need to be a Basic programmer
  4.  
  5. If you ain't then don't bother, because it'd be a waste of your time
  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. BC 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 all the junk left inbetween 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 what labels NOT to reduce (i.e. EVALuated variables)
  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.  
  118. Backend Updates
  119. 1.23  23-Sep-1992 In assembler "SWI &7" was getting compressed to "SWI&7"
  120.                   In assembler ".zappa FN(foo_bar)" wasn't recognising that
  121.                     the FN() substitutes for a mnemonic, and so 'foo' was
  122.                     the mnemonic!!!
  123.                   Start of file consists of:
  124.                     REM >fs::media.dir.file
  125.                     REM produced by BasCompress vx.yy
  126.                   this is so that BASIC V v1.05 library error messages are OK
  127. 1.24  01-Oct-1992 If an error occured during file output, this is now reported
  128.                   (eg file not having write access)
  129. 1.30  11-Oct-1992 Corrupted basic error message now "correct" --- was saying
  130.                     something different
  131.                   Start of file consists of, as acorn guidelines suggest
  132.                     (ta Jonathan) leaf name only
  133.                   -EVariable option suppresses `E' variables being
  134.                     produced (see example file)
  135. 1.31  18-Jan-1993  assembler handles array labels (eg [OPT4:.x%(y%):]
  136.                    regular expressions used on variable names not to squash
  137.                    (but reference says from main program, not special)
  138.                    (no support for regex routine names or libraries)
  139.  
  140.  
  141. Bugs
  142.  
  143. There appears to be a bug if the same routine is defined many (> 2) times
  144. in separate libraries - for now just delete the extra copies and then it
  145. works.
  146.  
  147.  
  148.  
  149.  
  150.  
  151. Registration Form:
  152.  
  153.  
  154.  
  155.         I would like to register as a Single User of BasCompress v1.37
  156.         
  157.         and have enclosed __________.
  158.         
  159.         This DOES / NOT (delete as applicable) include a manual.
  160.         
  161.         
  162.         Title:          ___________
  163.  
  164.         Name:           ____________________________
  165.         
  166.         Address:        ________________________________
  167.         
  168.                         ________________________________
  169.         
  170.                         ________________________________
  171.         
  172.                         ________________________________
  173.         
  174.                         ________________________________
  175.         
  176.         Postcode:       _______________
  177.         
  178.         Country:        _______________
  179.         
  180.         Where obtained
  181.         BasCompress:    ____________________________
  182.         
  183.         Machine:        ___________________________________
  184.  
  185.         Possible
  186.         improvements:   ___________________________________
  187.         
  188.                         ___________________________________
  189.         
  190.         Make cheques / postal orders payable to: Mr CY J. BOOKER
  191.         
  192.  
  193.                         86 Church View,  Main Road,
  194.                         Crockenhill,
  195.                         Swanley,
  196.                         Kent.
  197.                         BR8 8JW.
  198.                         U.K.
  199.  
  200.