home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 4 / DATAFILE_PDCD4.iso / utilities / utilsa / bc / !BC / !Help < prev    next >
Text File  |  1995-08-08  |  20KB  |  770 lines
  1.  
  2.  
  3.  
  4.  
  5.                                                                               
  6.  Y8888bo                .d88oo                                                
  7.   88[ 88[              d8`  '8                                                
  8.   88[ ]8P             ]8P    '[                                               
  9.   88[ 88`  .ooo  .oo. d8[     `.oo,  oo.oo oo, .o,oo   oo.o  ooo  .oo. .oo.
  10.   88888o   8[]8[ 88 Y 88[     .8`'8['88"Y8P"88 Y8P 8b '88P8`d8 8b 88 Y 88 Y
  11.   88[ '88  " ]8[ 88b' 88[     88  88 88 ]8[ 88 ]8[ 88[ 88  ]8P""" 88b' 88b'
  12.   88[  88[ oP]8[ '888 Y8b    .88  88`88 ]8[ 88 ]8[ 88[ 88  ]8[    '888 '888
  13.   88[ ]88`]8[]8[]  Y8['88,   dY8  88 88 ]8[ 88 ]8[ 88` 88  ]8b   ]  Y88  Y8[
  14.  o888888" '8b/8b,bodP  'Y8boP`'YbdP`.88,d8b.88,]88o8" .88,  Y8bo' bodP bodP
  15.                                                ]8[
  16.                                                ]8[
  17.                                                ""`
  18.  
  19.  
  20.                       BasCompress v1.69, 04-Aug-1995
  21.     
  22.                   A BASIC compressor and cross-referencer
  23.  
  24.                            For RISC OS computers
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  ============================================================ BasCompress ==== 
  67.  
  68.  
  69.  
  70.  
  71.      [1]        License . . . . . . . . . . . . . . . . . . . . . .  1
  72.      [2]        Installation  . . . . . . . . . . . . . . . . . . .  1
  73.      [3]        Synopsis and features . . . . . . . . . . . . . . .  2
  74.      [4]        A quick run through of the program  . . . . . . . .  3
  75.      [4.1]      The basic options . . . . . . . . . . . . . . . . .  3
  76.      [5]        Problems and solutions (quickfire)  . . . . . . . .  4
  77.      [5.1]      ‘ENDPROC found in a function’ error . . . . . . . .  4
  78.      [5.2]      ‘unexepcted UNTIL/ENDIF/ENDWHILE’ errors  . . . . .  4
  79.      [5.3]      ‘Undefined routine: <routine> (used <location>)’  .  4
  80.      [5.4]      Run-time ‘No such function/procedure’ error . . . .  5
  81.      [5.5]      Run-time ‘Syntax error’ error . . . . . . . . . . .  5
  82.      [5.6]      Run-time logic errors . . . . . . . . . . . . . . .  5
  83.      [5.7]      Squeeze won’t work  . . . . . . . . . . . . . . . .  6
  84.      [6]        Updates . . . . . . . . . . . . . . . . . . . . . .  7
  85.      [6.1]      Frontend Updates  . . . . . . . . . . . . . . . . .  7
  86.      [6.2]      Backend Updates . . . . . . . . . . . . . . . . . .  8
  87.      [6.3]      Bugs  . . . . . . . . . . . . . . . . . . . . . . .  9
  88.      [6.4]      Credits . . . . . . . . . . . . . . . . . . . . . .  9
  89.      [7]        Registration form . . . . . . . . . . . . . . . . . 10
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  ======================================================== BasCompress ========
  131.  
  132.  
  133.  
  134.  [1] License
  135.  
  136.     This program is supplied "as is".  No warranty, express or implied, of
  137.     the  merchantability of this program or its fitness for any particular
  138.     purpose is given.  In no circumstances shall the author, or any
  139.     provider or distributor of this program, be liable for any damage,
  140.     loss of profits, or any indirect or consequential loss arising out of
  141.     the use of this program.
  142.     
  143.     Please note that this program is SHAREWARE, it is not free.  You may
  144.     use this software for a trial period.  If, after this  you decide you
  145.     would like to continue using it, then you are required to REGISTER.
  146.     Failing to register, you are obliged to destroy all copies of this
  147.     program. A trial period ends when you realise that this program could
  148.     be used on your latest program.
  149.     
  150.     Registration currently involves you sending a cheque for 15 (fifteen)
  151.     pounds sterling to the author, for which you will get a disc with the
  152.     latest version with your name in the info dialogue box (so PLEASE TYPE
  153.     CLEARLY).  There is a form at the end of this document that you can use
  154.     to register.  Registration will encourage the author to continue to
  155.     develop this program further.
  156.     
  157.     For a further 5 pounds, registration will include a printed (600
  158.     d.p.i. laser) copy of the documentation.  Note that this is not a
  159.     ‘professional’ printing, just a pamphlet printed on a LaserDirect,
  160.     folded and stapled.
  161.     
  162.     Payment in other currencies accepted so long as at the end of the day
  163.     I end out with the same amount of money.  Credit cards not accepted.
  164.     Alternatively, send a CD of any contemporary composers or foreign
  165.     Zappa pressings.
  166.  
  167.     Free updates are available from bc@cheepnis.demon.co.uk.  Or send a
  168.     stamped, self-addressed jiffy bag if you do not have an email address.
  169.  
  170.  
  171.  [2] Installation
  172.  
  173.     To get a working system, just copy the application directory (!BC) to
  174.     a writable media (so that any choices can be saved).
  175.  
  176.     If you are not getting any throwbacks, please see §4.1 in the main
  177.     manual.
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.                                   Page   1
  193.  
  194.  ======================================================== BasCompress ========
  195.  
  196.  
  197.  
  198.  [3] Synopsis and features
  199.  
  200.  
  201.     BasCompress is a BasicV (v1.05) compressor and cross-referencer, i.e.
  202.     
  203.      •    Supports throwback
  204.      •    Removes spaces and comments
  205.      •    Removes all unused routines, and the junk left between routines
  206.      •    Removes all constant variables, replacing use with definition
  207.      •    Removes NEXT variables
  208.      •    Reduces all labels (shortens them)
  209.      •    Reduces numbers
  210.      •    Converts SWI strings to numbers
  211.      •    Converts ASC("x") to a number
  212.      •    Loads in LIBRARYs, and OVERLAYs
  213.      •    Handles line numbers
  214.      •    You can tell it which labels NOT to reduce (i.e. EVALuated vars)
  215.      •    Full cross-referencing, multi-level, multi-sort
  216.      •    It is FAST
  217.  
  218.     BasCompress consists of two programs, a Wimp front end, and the actual
  219.     program itself (the back end).  You can use the back end directly in
  220.     your script files, and use the Wimp front end for casual use.  The
  221.     back end supports throwback.
  222.  
  223.     The Wimp front end supports interactive help, and it is suggested that
  224.     the first time user use this.  Interactive help can be turned on by
  225.     running the !Help application that came supplied with the computer.
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.                                   Page   2
  257.  
  258.  ======================================================== BasCompress ========
  259.  
  260.  
  261.  
  262.  [4] A quick run through of the program
  263.  
  264.  
  265.     Drag the Log file icon from the control window to a directory display.
  266.     
  267.     Now drag one of your BASIC files onto the control window.
  268.     
  269.     If any errors were found in the code then your text editor will 
  270.     display a throwback window.  This allows you to click an error line
  271.     and the editor will show that line.  StrongED, SrcEdit and Zap
  272.     support throwback.
  273.  
  274.     The log file will appear (auto-loading Edit if need be).  Don’t close
  275.     this window yet, although you may resize/move it.
  276.     
  277.     Now drag the BASIC (output) file icon from the control window onto a
  278.     directory display.
  279.     
  280.     Click ADJUST on the icon bar icon (which re-load’s last file using
  281.     the current options)
  282.  
  283.  
  284.  [4.1] The basic options
  285.  
  286.     Because Basic is a highly idiosynchratic language, BasCompress prefers
  287.     code that conforms to a certain style.  It can get confused when asked
  288.     to process some types of (valid) Basic.
  289.  
  290.     For ‘safe’ usage of BasCompress, ie where BasCompress turns off all
  291.     its’ intelligence then ensure that:
  292.  
  293.      •    menu item ‘Input->Ignore exits from a routine (‘dumb’)’ ON
  294.      •    menu item ‘Output->Parse numbers’ OFF
  295.      •    menu item ‘Output->Remove constant variables’ OFF
  296.      •    all menu items ‘Output->Reduce variable names’ OFF
  297.      •    all menu items ‘Output->Reduce routine names’ OFF
  298.  
  299.     with all the above settings then BasCompress will not abuse your code
  300.     too much.  However, the quality of compressed code is not that great.
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.                                   Page   3
  321.  
  322.  ======================================================== BasCompress ========
  323.  
  324.  
  325.  
  326.  [5] Problems and solutions (quickfire)
  327.  
  328.  
  329.  [5.1] ‘ENDPROC found in a function’ error
  330.  
  331.     If the log file has lots of these warnings:
  332.     
  333.                     warning 9: ENDPROC not at end of procedure
  334.                     wa