= Source code organization = 

== The tools/ directory ==

Into `tools/`, we have put some tools that we don't want to rely on on the host platform, mostly because some versions of these tools are known to be buggy and we want to make sure that a specific version is used. 

The tools are sorted into subdirectories for the various platforms:

 * `x86.linux` contains:
   * `bin/as86` and `bin/bcc` are some old compilers that we require for some real-mode code in !VirtualBox.
   * `bin/iasl` is the Intel ACPI DSL compiler, available with source from [http://www.intel.com/technology/iapc/acpi/downloads.htm here].
   * `bin/xd` is a tiny tool to convert a binary file into a C array. This is from [http://www.fourmilab.ch/xd/ here] and public domain.
   * `makeself` contains some shell scripts to create our self-extracting Linux installer.
   * `yasm/` contains [http://www.tortall.net/projects/yasm/ YASM], a rewrite of the venerable NASM assembler, a project released under the BSD license. 

 * `x86.win32` contains:
   ''(fill this in when it's up-to-date)''