| 1 | ===============================================================================
|
|---|
| 2 | BUILD.NFO -- Information on building AiR-BOOT v1.1.0
|
|---|
| 3 | ===============================================================================
|
|---|
| 4 |
|
|---|
| 5 | Building AiR-BOOT and the support tools has been completely revamped
|
|---|
| 6 | in this version. The code has been "de-tasmized" so it can now also
|
|---|
| 7 | be assembled with JWasm, which is the preferred assembler as of this version.
|
|---|
| 8 |
|
|---|
| 9 | The DOS batch-files have been replaced by Open Watcom Makefiles that
|
|---|
| 10 | can be used on: DOS, Windows, OS/2 and Linux.
|
|---|
| 11 | This greatly enhances the build-environment, which was previously DOS-only.
|
|---|
| 12 |
|
|---|
| 13 | The Open Watcom Linker is now used, which obsoletes the use of the (DOS-only)
|
|---|
| 14 | exe2bin and TLink programs. WLink replaces the functionality of both while
|
|---|
| 15 | also adding extensive cross-platform support.
|
|---|
| 16 |
|
|---|
| 17 | Several cross-reference files are generated, like object disassemblies
|
|---|
| 18 | and executable header dumps. This aids development in checking for assembler
|
|---|
| 19 | generation and the correctness of that code.
|
|---|
| 20 |
|
|---|
| 21 | The (DOS-only) FIXCODE.COM program that is used to embed the MBR-protection
|
|---|
| 22 | in the AiR-BOOT image has been replaced by platform specific versions.
|
|---|
| 23 | This does away with the need to run a DOS-only program in the tool-chain,
|
|---|
| 24 | and thus enables building AiR-BOOT on Linux.
|
|---|
| 25 |
|
|---|
| 26 | The preferred assembler is now JWasm.
|
|---|
| 27 | While Tasm4/Masm6 and Wasm are also supported, their use should be of an
|
|---|
| 28 | experimental nature only. Limitations for checking section overlaps
|
|---|
| 29 | and other assembler specific directives inhibit the use of JWasm to
|
|---|
| 30 | it's fullest capability.
|
|---|
| 31 | Since JWasm is open-source and mature, there is no need to support other
|
|---|
| 32 | assemblers in future releases of AiR-BOOT.
|
|---|
| 33 |
|
|---|
| 34 | The JWasmD extended DOS version needs DPMI 'enabled' and XMS set to 0
|
|---|
| 35 | to be able to run in an eCS DOS session.
|
|---|
| 36 | The DOS build-environment will probably be discontinued in
|
|---|
| 37 | the future due to it's many restrictions. DOS specific targets can
|
|---|
| 38 | be built on the other platforms.
|
|---|
| 39 |
|
|---|
| 40 | The Open Watcom tool-chain in combination with JWasm is now the
|
|---|
| 41 | default tool-chain.
|
|---|
| 42 |
|
|---|
| 43 | Building AiR-BOOT v1.1.0 requires the following tools:
|
|---|
| 44 | - Open Watcom Make Utility v1.9 or higher
|
|---|
| 45 | - Open Watcom 16-bits C-Compiler v1.9 or higher
|
|---|
| 46 | - Open Watcom 32-bits C-Compiler v1.9 or higher
|
|---|
| 47 | - Open Watcom Linker v1.9 or higher
|
|---|
| 48 | - JWasm Assembler v2.06d or higher
|
|---|
| 49 |
|
|---|
| 50 | As a convenience a simple GNUmakefile also exists where a Makefile exists.
|
|---|
| 51 | The GNUmakefile forwards to the normal Makefile enabing Linux users to run the
|
|---|
| 52 | familiar "make" command. Target passing is supported.
|
|---|
| 53 |
|
|---|
| 54 | Note that only the loader, installer and setaboot targets are built.
|
|---|
| 55 | No floppy, cd-rom, etc. images.
|
|---|
| 56 |
|
|---|
| 57 |
|
|---|
| 58 | Rousseau.
|
|---|
