disable the unrecognized nls and x flags
[AROS-Contrib.git] / bgui / COMPILING.amiga
blobc6dcd2b0ee0c9d42e5ba1fdedef72d651f7df3e3
1 @(#) $Id$
3 1. About this document
5 This is just an overview on how to build BGUI on Amiga and what you need
6 to have to do that.
9 2. Requirements
11 To compile BGUI on Amiga, you will need the following:
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? :-)
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.
21   Using older includes /will/ break the build.
23 * Some extra assembler includes not readaly available in the NDK:
25   - exec/exec_lib.i
26   - utility/utility_lib.i
27   - intuition/intuition_lib.i
28   - graphics_lib.i
29   - libraries/amigaguide_lib.i
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:
36   lvo exec EQUATES >include:exec/exec_lib.i
38   Repeat for the other files...
41 3. Building
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:.
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).
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'.
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.