home *** CD-ROM | disk | FTP | other *** search
/ Amiga MA Magazine 1998 #6 / amigamamagazinepolishissue1998.iso / coders / jËzyki_programowania / ace_basic / ace / docs / includes.readme < prev    next >
Text File  |  1977-12-31  |  2KB  |  79 lines
  1.  
  2.  
  3.           - V3.1 includes FOR ACE basic -
  4.  
  5.  
  6.        Here they are, the 3.1 includes for ACE Basic. They may be used
  7.        on all Amigas with any OS version (although some functions/values
  8.        do not pertain to pre-3.1 Amigas - DB).
  9.  
  10.        To be able to use these includes with ACE you must use
  11.        another preprocesor than APP (for now, this may change later).
  12.  
  13.        What you can use is acpp a hacked version of the old cpp. This
  14.        is in the bin directory. See also docs/bin.readme and docs/acpp.man. 
  15.        You can also, which I prefer, use dcpp from the free DiceArcive. This 
  16.        one is on Aminet.
  17.  
  18.        You also need a small utility, RemoveLine which shaves off the
  19.        lines that the preprocesor puts in the preprocesed source.
  20.        RemoveLine can be found in the bin directory as can two scripts to
  21.        help you compile sources: bas2 and bas3. The former is for use with 
  22.        acpp, while the latter is for use with dcpp. Copy whichever one you 
  23.        want to use to ACE:bin/bas and make sure the "s" bit is set with
  24.        the command:
  25.  
  26.         protect ACE:bin/bas +s add
  27.  
  28.        Now to the includes.
  29.  
  30.        I have tried my best to make them as error-free as possible but
  31.        there must be errors somewhere. Please report them to David or me.
  32.  
  33.        There are some changes to structures and structure members, _ALL_
  34.        ACE keywords are now prefixed with an underscore like this: 
  35.  
  36.         _Window, _Screen and so on. 
  37.  
  38.        To get the screen font you have to specify:
  39.        
  40.         _Screen->_Font.
  41.  
  42.        You can't just use _ONE_ header cause they are now, like C: nested.
  43.        I have made a header in <ace/default.h>, if you use this include
  44.        you get all headers in the right order.
  45.  
  46.        One other thing about structures.
  47.        If you look in the headers you will see something like this.
  48.  
  49.        #define WindowPtr ADDRESS
  50.  
  51.        This is just that I prefer to write (and read) structures like this.
  52.  
  53.        STRUCT _Window
  54.            WindowPtr   NextWindow
  55.            WindowPtr   PrevWindow
  56.        .
  57.        .
  58.  
  59.        It's just instead of an ADDRESS, But when I read that structure I can
  60.        see that it's a pointer to a structure and not just an Address.
  61.  
  62.        Have fun and don't find too many bugs.:)
  63.  
  64.  
  65.        Nils Sjoholm
  66.  
  67.  
  68.        
  69.  
  70.        Bugs to: >NIL:
  71.  
  72.        or
  73.  
  74.        D.Benn@appcomp.utas.edu.au
  75.        
  76.        ninne@oden.se
  77.  
  78.        Note: see also docs/bmaps.readme
  79.