home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 8 / FreshFishVol8-CD1.bin / useful / dev / lang / ace / readme_1st < prev    next >
Text File  |  1994-10-23  |  7KB  |  202 lines
  1.  
  2.                 Welcome to ACE!
  3.                 ---------------
  4.  
  5. This is version 2.3 of the FreeWare Amiga BASIC compiler, ACE. 
  6.  
  7. See the "Notes" section below for important information about specific 
  8. files in the archive and changes to the distribution material with each
  9. revision of the compiler.
  10.  
  11. To get an overall impression of ACE's capabilities, have a look at ref.doc 
  12. which is a command and function reference for the language.
  13.  
  14. Once you've set up your environment as specified in the INSTALLATION file,
  15. try compiling a program from the prgs directory (or wherever you've put
  16. the example programs), eg:
  17.  
  18.     Workbench:ACE> copy prgs/fractals/lorenz.b ""
  19.     Workbench:ACE> bas -O lorenz
  20.     Workbench:ACE> lorenz
  21.  
  22. Selecting Quit from the Project menu will get you out of this program.
  23.  
  24. You might also like to compile each of these programs: hi.b, tclock.b 
  25. welcome.b and ifs.b (the source code for each is viewable from Workbench).
  26.  
  27. At this point, it's up to you. I'd suggest having a closer look at the 
  28. docs, especially ace.doc to get a better idea of what ACE's capabilities 
  29. are.
  30.  
  31. The history file may also be of interest since it details the development
  32. of ACE since the last version.
  33.  
  34. Whatever you do, enjoy yourself!
  35.  
  36. Regards
  37. David Benn, Tasmania, October 1994
  38.  
  39.  
  40. Notes
  41. -----
  42.  
  43. *** v1.0 ***
  44.  
  45. 31/1/93        -    If you didn't unarc ace.lha with lha's -a option
  46.             then the bas script won't have its "s" flag set. 
  47.             To set it, type: PROTECT bas +s ADD.
  48.  
  49. 3/2/93        -     Please note that due to copyright restrictions,
  50.             no bmap files have been included in the distribution.
  51.             See "Shared library function calls" in ace.doc for 
  52.             more.
  53.  
  54. *** v1.01 ***
  55.  
  56. 19/2/93        -    Version 1.01 corrects a number of problems with the
  57.             first version and adds a few new minor features.
  58.             See the entries in the file docs/history for an 
  59.             update on the changes to ACE from v1.0 to v1.01. 
  60.     
  61.         -     There is a new, somewhat nicer ACE executables icon
  62.             in the icons drawer. See also the readme file in that
  63.             drawer. Thanks goes to Byron Montgomerie for his work
  64.             on the icon.
  65.  
  66. 20/2/93        -    I have received the Commodore copyright documents
  67.             and licensing agreements etc and so hope to be able 
  68.             to resolve the issue of copyright of bmap files soon. 
  69.  
  70.         -    For v1.01 I have included the source code and docs 
  71.             for a Tiny BASIC interpreter written in ACE.
  72.  
  73. *** v1.02 ***
  74.  
  75. 18/4/93        -    Commodore Australia have told me that they can't 
  76.             see any legal problems with distributing .bmap 
  77.             files with ACE, but I'll wait until I receive word 
  78.             of this in writing before I include them in the 
  79.             archive.
  80.  
  81.         -    There is a new include file called julian.h which
  82.             contains functions for converting dates into days 
  83.             elapsed since epoch 1900 and the latter back to
  84.             the former. See days.b for an example. 
  85.  
  86.         -    Another new include file called fexists.h contains
  87.             a single subprogram: fexists(X$) which returns a
  88.             value of -1 or 0 depending upon whether the file
  89.             X$ exists.
  90.  
  91.         -    See docs/history for new features and bug fixes
  92.             in v1.02.     
  93.  
  94. *** v1.1a ***
  95.  
  96. 20/6/93        -    include/sys_req.h has been modified because of
  97.             changes in the way ACE deals with string value
  98.             parameters.
  99.  
  100.         -    prgs/gadget.b has been modified to accomodate
  101.             the fact that an ACE screen's borderless window
  102.             now handles Intuiticks.
  103.              
  104. 29/6/93        -    Note that the file "exists" is no longer required
  105.             in the ACE bin directory for use by the "bas" script.
  106.         
  107.         -    See docs/history for changes, additions and bug 
  108.             fixes in v1.1a.
  109.  
  110. 10/7/93        -    Note that because I am still awaiting a formal
  111.             reply from Commodore Australia re: the copyright
  112.             of .bmap files, this archive does not yet
  113.             contain the bmaps. Hopefully by the next release
  114.             I will have permission to distribute them.
  115.  
  116.         -    I anticipate that the next version will only be a 
  117.             month or two away, but the current archive contains
  118.             a sufficiently modified and enhanced ACE to warrant
  119.             the release you now have. 
  120.  
  121.         -    There's a couple of new programs in the prgs drawer:
  122.             BST.b and Messier.b. The first lets you create and
  123.             manipulate binary search trees, viewing the results
  124.             graphically. The second lets you interrogate the 
  125.             Messier catalog of astronomical objects in various
  126.             ways. 
  127.  
  128. 1/9/93        -     In order to fit the ACE files onto a single floppy
  129.             disk, the TinyBASIC drawer has been included as a
  130.             .lha archive.
  131.  
  132. *** ACE v2.0 ***
  133.  
  134. 12/12/93    -    See utils/fd2bmap for an ACE .bmap creator. Thanks
  135.             goes to Harald Schneider for his program fd2bmap.b.
  136.             Send all bug reports/comments related to this program 
  137.             to me. 
  138.  
  139. 25/12/93    -    Note (as per ace.doc and ref.doc) that in order
  140.             to use ACE's new FileBox$ function under Wb 1.3
  141.              you must have arp.library in your LIBS: directory.
  142.  
  143. 3/1/94        -    See the AIDE drawer for an Integrated Development
  144.             Environment written in ACE. This program currently
  145.             only runs correctly under Wb 2.04 and higher. The
  146.             source code is provided for anyone wishing to get
  147.             it working under Wb 1.3. See AIDE/AIDE.doc for more.
  148.  
  149. 9/1/94        -    There's a stack of new features in version 2.0 of
  150.             ACE, so take the time to browse through the docs.
  151.  
  152. 10/1/94        -    As of this version, most of the example programs are 
  153.             in a separate archive to let you choose where to put
  154.             them (eg: onto a separate floppy or in with the other
  155.             programs in the prgs directory) depending upon your
  156.             Amiga's storage capabilities.
  157.  
  158. 16/1/94        -    See the utils directory for a program (ab2ascii) 
  159.             which converts files saved in AmigaBASIC's compressed
  160.             format into ACE-readable ASCII files. Thanks goes to
  161.             Stefan Reisner for this utility.
  162.  
  163. 17/1/94        -    See the utils directory for a simple program called
  164.             pager.b which is designed to let you easily print the
  165.             ace.doc file. See the comments at the top of the
  166.             program source, compile and run the program, then 
  167.             just follow the prompts.
  168.  
  169. *** ACE v2.29 (beta) ***
  170.  
  171. 18/9/94        -    See ACE:utils for more utilities (UppercACEr, a-a).
  172.         -    ReqTools.bmap is now included in ACEbmaps: for use 
  173.             with prgs/library/reqtools.b.
  174.         -     See ACE:docs for the new Example.guide file.
  175.         -    See ACEinclude: for some new include files.
  176.         -    This archive also contains a new version of AIDE.
  177.         -    Note that the AmigaGuide documents in ACE:docs are 
  178.             all at various stages of completion. However, the 
  179.             text docs (ref.doc, ace.doc, aide.doc, history) are 
  180.             all up to date.
  181.  
  182. *** ACE v2.3 ***
  183.  
  184. 2/10/94        -    Note the inclusion of a line continuation character 
  185.             ([~] - see "General comments" section in ace.doc).
  186.         -    Please see docs/history for the latest bug fixes and
  187.             additions since the beta release of 18/9/94.
  188.         -    See ACE:bin/1.3 if you are using Workbench 1.3.
  189.  
  190. 15/10/94    -    FD2BMAP has been modified such that it seems to work
  191.             correctly for all FD file formats (Wb 1.3 & 2.x/3.x).
  192.         -    UppercACEr now expects to find the (sorted) ACE 
  193.             reserved word file (UppercACEr.Reserved) in the s: 
  194.             directory.
  195.  
  196.             Note: both UppercACEr and FD2BMAP are found in 
  197.                   ACE:utils.
  198.  
  199. 22/10/94    -    The AmigaGuide files in ACE:docs are now all up to
  200.             date for this new release. The same is true for
  201.             AIDE.guide in ACE:AIDE.
  202.