Building on BeOS================For building on BeOS you need the development tools from: http://haiku-os.org/downloadsPlease always use the most recent versions. They are required to build Haiku.Building on a non-BeOS platform===============================Please read the file 'ReadMe.cross-compile' before continuing. It describeshow to build the cross-compilation tools and configure the build system forbuilding Haiku. After following the instructions you can directly continuewith the section Building.Configuring on BeOS===================Open a Terminal and change to your Haiku trunk folder. To configure the buildyou can run configure like this: ./configure --target=TARGETWhere "TARGET" is the target platform that the compiled code should run on: * haiku (default) * r5 * bone * dano (also for Zeta)The configure script generates a file named "BuildConfig" in the"generated/build" directory. As long as configure is not modified (!), thereis no need to call it again. That is for re-building you only need to invokejam (see below). If you don't update the source tree very frequently, you maywant to execute 'configure' after each update just to be on the safe side.Building========Haiku can be built in either of two ways, as disk image file (e.g. for usewith emulators) or as installation in a directory.Image File---------- jam -q haiku-imageThis generates an image file named 'haiku.image' in your output directoryunder 'generated/'.VMware Image File----------------- jam -q haiku-vmware-imageThis generates an image file named 'haiku.vmdk' in your outputdirectory under 'generated/'.Directory Installation---------------------- HAIKU_INSTALL_DIR=/Haiku jam -q install-haikuInstalls all Haiku components into the volume mounted at "/Haiku" andautomatically marks it as bootable. To create a partition in the first placeuse DriveSetup and initialize it to BFS.Note that installing Haiku in a directory only works as expected under BeOS,but it is not yet supported under Linux and other non-BeOS platforms.Bootable CD-ROM Image---------------------This _requires_ having the mkisofs tool installed.On Debian GNU/Linux for example you can install it with: apt-get install mkisofsOn BeOS you can get it from http://bebits.com/app/3964 along with cdrecord.This creates a bootable 'haiku-cd.iso' in your 'generated/' folder: jam -q haiku-cdUnder Unix/Linux, and BeOS you can use cdrecord to create a CD with: cdrecord dev=x,y,z -v -eject -dao -data generated/haiku-cd.isoHere x,y,z is the device number as found with cdrecord -scanbus, it can alsobe a device path on Linux.Building Components-------------------If you don't want to build the complete Haiku, but only a certainapp/driver/etc. you can specify it as argument to jam, e.g.: jam PulseAlternatively, you can 'cd' to the directory of the component you want tobuild and run 'jam' from there.You can also force rebuilding of a component by using the "-a" parameter: jam -a PulseRunning=======Generally there are two ways of running Haiku. On real hardware using apartition and on emulated hardware using an emulator like Bochs or QEmu.On Real Hardware----------------If you have installed Haiku to its own partition you can include thispartition in your bootmanager and try to boot Haiku like any other OS youhave installed. To include a new partition in the BeOS bootmanager run thisin a Terminal: bootmanOn Emulated Hardware--------------------For emulated hardware you should build disk image (see above). How to setupthis image depends on your emulater. A tutorial for Bochs on BeOS is below.If you use QEmu, you can usually just provide the path to the image ascommand line argument to the "qemu" executable.Bochs-----Version 2.2 of Bochs for BeOS (BeBochs) can be downloaded from BeBits: http://www.bebits.com/app/3324The package installs to: /boot/apps/BeBochs2.2You have to set up a configuration for Bochs. You should edit the ".bochsrc" toinclude the following:ata0-master: type=disk, path="/path/to/haiku.image", cylinders=122, heads=16, spt=63boot: diskNow you can start Bochs: $ cd /boot/apps/BeBochs2.2 $ ./bochsAnswer with RETURN and with some patience you will see Haiku booting.If booting into the graphical evironment fails you can try to hit "space" at thevery beginning of the boot process. The Haiku bootloader should then come up andyou can select some safe mode options.Docbook documentation=====================Our documentation can be found in 'src/documentation/'. You can build it byrunning 'jam' in that folder. The results will be stored in the 'generated/'folder.