home *** CD-ROM | disk | FTP | other *** search
/ Acorn User 3 / AUCD3.iso / funland / emulators / gameboy / gbdk / !GBDK / docs / Intro < prev   
Text File  |  1997-02-18  |  2KB  |  51 lines
  1. Gameboy Development Kit
  2. =======================
  3.  
  4. The Gameboy Development Kit (GBDK) was put together by Pascal Felber
  5. (felber@di.epfl.ch). With it you can write programs in C and assembler
  6. for use on the various Gameboy emulators, or even a real Gameboy if
  7. you have the necessary hardware. It was ported to RISC OS, with only a
  8. few minor alterations, using GCC and UnixLib.
  9.  
  10. Usage
  11. -----
  12.  
  13. The C compiler, assembler and linker can all be used through the lcc
  14. front end, which automates the various stages of compilation and
  15. linking. After running !GBDK, type 'lcc -help' at the command prompt
  16. for a full list of the various switches - some of the more commonly
  17. used ones are described below:
  18.  
  19.     -c          compile only (no linking stage)
  20.     -Dname      define the preprocessor symbol 'name'
  21.     -Dname=def  define the preprocessor symbol 'name' as 'def'
  22.     -o file     leave the output in 'file'
  23.     -S          output assembler source code
  24.  
  25. Make sure you have allocated at least 1MB to the next slot before
  26. using lcc or it'll complain about a lack of memory. Source files
  27. should be specified as, for example, 'test.c' or 'gblib:stdio.o'
  28. rather than their actual RISC OS filenames (eg 'c.test' or
  29. 'gblib:o.stdio').
  30.  
  31. Examples
  32. --------
  33.  
  34. The examples directory contains a number of demonstrations. 'sound.c',
  35. 'space.s', 'sprite.c' and 'test.c' are Gameboy specific, while the
  36. rest form part of a test suite for the lcc compiler. If you have a
  37. make utility, such as amu, you can build them using the supplied
  38. MakeFile (make sure you have allocated enough space to the next slot
  39. first though). Alternatively, just run the MakeObey file.
  40.  
  41. More information
  42. ----------------
  43.  
  44. More detailed information, including documentation on the libraries
  45. can be found in the file 'docs.GBDK'.
  46.  
  47.  
  48. ----------------------------------------------------------------------
  49. Paul Clifford (paul@plasma.demon.co.uk)
  50. February 18 1997
  51.