home *** CD-ROM | disk | FTP | other *** search
/ ARM Club 3 / TheARMClub_PDCD3.iso / hensa / programming / spirit / app / !NewBalls / ReadMe < prev    next >
Text File  |  1992-01-12  |  3KB  |  67 lines
  1. This is the Balls64 application, supplied with the Acorn C compiler, re-written
  2. to use my new Risc-OS interface library.
  3.  
  4. Before I go any further, let me make one thing clear - this library is far
  5. from complete.  I'm uploading it now because I want some feedback on its
  6. structure, philosophy and useability.  All comments (and bug reports -
  7. surely not) gratefully received.
  8.  
  9. I started writing the library because I became so frustrated with the awful
  10. quality of the standard product.  I've been asking Acorn for ages whether
  11. they intended to fix it, but they refused to say until 'C' 4.0 was released,
  12. and it now becomes obvious that they don't.  Don't get me wrong - the compiler
  13. itself is one of the best on the market, and the ANSI library is hard to fault,
  14. BUT the Risc-OS interface library is just not up to the standard I would
  15. expect of an Acorn product.
  16.  
  17. This library offers the following advantages over the Acorn product :-
  18.  
  19.     * It is hierarchically structured (the Acorn one claims to be but it
  20.       isn't).  This means that you only get the routines you need, and not
  21.       multiple kilobytes of dross.
  22.  
  23.     * The names used are closer to the standard OS names.  The names used by
  24.       the Acorn library are both different and inconsistent.
  25.  
  26.     * It doesn't use different ways of doing exactly the same thing -
  27.       e.g os.h and kernel.h, thus saving space.
  28.  
  29.     * Low-level OS access routines are written in assembler, reducing them
  30.       to just 2 or 3 instructions each!
  31.  
  32.     * It has hooks to allow arbitrary extensions to be implemented.
  33.  
  34.     * It never calls Wimp_ReportError without explicit permission from
  35.       the application.  This is useful if you are writing a background
  36.       or unattended task, e.g. a BBS.
  37.  
  38.     * Similarly it never calls OS_Exit without permission.  (Believe it or
  39.       not, the Acorn offering DOES!)
  40.  
  41. Disadvantages are :-
  42.  
  43.     * It doesn't have much documentation yet - I can't be bothered to write
  44.       much until I find out whether anyone is interested.
  45.  
  46.  
  47. Usual copyright notice.
  48. =======================
  49.  
  50. I retain copyright in all elements of the library.  You have permission to use
  51. it for experimentation and other private uses.  You may not use it in
  52. commercial software (which I doubt would be possible at this stage) without
  53. further separate permission from me.  You may pass copies to other people
  54. provided you give them the whole thing, including this information file.
  55.  
  56.  
  57. Sorry about that.
  58.  
  59.  
  60.  
  61. All comments gratefully received.
  62.  
  63. John Winters.  Archive #523.  8th January, 1992
  64.  
  65.  
  66.  
  67.