bgui/COMPILING.amiga

   1 @(#) $Id$
   2
   3 1. About this document
   4
   5 This is just an overview on how to build BGUI on Amiga and what you need
   6 to have to do that.
   7
   8
   9 2. Requirements
  10
  11 To compile BGUI on Amiga, you will need the following:
  12
  13 * Version 6.58 of the SAS/C compiler. Other compilers could theoretically
  14   compile the source-code, but it hasn't been tested. You would need to adapt
  15   the makefile anyway, so just use SAS/C. OK? :-)
  16
  17 * The lastest includes from the OS 3.5 NDK (ie. the Developer CD v2.1).
  18   You need the assembler includes too, since parts of BGUI are written in
  19   assembler. And copy the FD files over too, you'll need them later.
  20
  21   Using older includes /will/ break the build.
  22
  23 * Some extra assembler includes not readaly available in the NDK:
  24
  25   - exec/exec_lib.i
  26   - utility/utility_lib.i
  27   - intuition/intuition_lib.i
  28   - graphics_lib.i
  29   - libraries/amigaguide_lib.i
  30
  31   These can be generated with the 'lvo' tool which can be found on the
  32   Developer CD in NDK/NDK_3.1/SWToolkit3. Assign FD: to the place you
  33   copied the FD files (typically include:fd) and type the following
  34   to create exec/exec_lib.i:
  35
  36   lvo exec EQUATES >include:exec/exec_lib.i
  37
  38   Repeat for the other files...
  39
  40
  41 3. Building
  42
  43 This is easy. :-) Just type 'smake' in the root of the BGUI sources. This will
  44 build the debug-version of bgui.library, the examples, test-programs and tools
  45 (ie. CAD and BGUIPrefs). The library will then be copied to libs:.
  46
  47 Typing 'smake standard_build' will build the standard non-debug version,
  48 and typing 'smake enhanced_build' will build the enhanced version which uses
  49 OS 3.x functions and is optimized for 020+. You have to copy the library to
  50 libs: youself in this case though. Also make sure to run bin/KillBGUI to
  51 purge the old library from memory (this is done automagically for the debug
  52 version).
  53
  54 To build the stand-alone gadgets (ie. bgui_bar.gadget, bgui_layoutgroup.gadget,
  55 bgui_palette.gadget, bgui_popbutton.gadget and bgui_treeview.gadget) just type
  56 'smake extra_gadgets'.
  57
  58 It might also be nice to type 'smake all_docs' which will generate the BGUI docs
  59 in AutoDoc, HTML and AmigaGuide format. You can write 'smake doc' if you just want
  60 the AutoDoc versions, 'smake guide' for the AmigaGuide versions and 'smake html'
  61 to just get the HTML versions.