[haiku-doc] FAQ: Build System

Hi,

I think the following question should be listed in a FAQ about our
building system.

Q: How do I add a file to the haiku-image?
A: In order to add a file to the haiku image, place the file you want
to include in the root
directory of your haiku tree, or in any subdirectory of it, and add
the following line to your
UserBuildConfig file:
AddFilesToHaikuImage home : $(HAIKU_TOP)/path/to/yourfile/filename ;
Your file will be placed in the home directory of your user.

Q: How do I add a directory along with its content to the haiku-image?
A: In order to add a directory to the haiku image, place the directory
you want to include
in the root directory of your haiku tree, or any subdirectory of it,
and add the following line
to your UserBuildConfig file:
CopyDirectoryToHaikuImage home Desktop :
$(HAIKU_TOP)/path/to/yourdirectory : : -x .svn ;
Your file will be placed in the Desktop directory of your user.
< I have not idea what " : : -x .svn " means, please explain >

Q: What's the UserBuildConfig and where do I find it?
A: The UserBuildConfig is under the directory $(HAIKU_TOP)/build/jam
and it is used
to customize your haiku-image. See UserBuildConfig.sample, which is
placed in same
directory, for an example.

Q: What's the value of the HAIKU_TOP directory?
A: The HAIKU_TOP variable contains the full path to the root directory
of your haiku svn tree.

Q: How do I change the default Keymap of my haiku-image?
A: In order to change the default Keymap of your haiku-image add the
following line to your
UserBuildConfig:
AddFilesToHaikuImage home config settings : <keymap>Italian
    : Key_map ;
Replace Italian with the name of your keymap. All available keymap are
listed in
<I have not idea>

Q: How do I change the default Timezone of my haiku-image?
A: In order to change the default timezone of your haiku-image add the
following line
to your UserBuildConfig:
AddSymlinkToHaikuImage home config settings
    : /boot/beos/etc/timezones/Europe/Rome : timezone ;
Replace Europe/Rome with your timezone. All available timezone are listed in
<I have not idea>

Q: How do I add an optional package to my haiku-image?
A: In order to add an optional package to your haiku-image add the following
line to your UserBuildConfig
AddOptionalHaikuImagePackages WonderBrush Firefox
Replace WonderBrush and Firefox with the optional package you want in your
haiku-image

Q: Where do I find a list of all the available optional package?
A: See $(HAIKU_TOP)/build/jam/OptionPackages

I think this should be a start. Please feel free to replace what I
wrote with something
more appropriate.

Regards,
-- 
Salvatore Benedetto (a.k.a. emitrax)
Student of Computer Engineer
University of Pisa
www.haiku-os.it

Other related posts: