[haiku-doc] Re: FAQ: Build System

On 2008-06-15 at 17:39:39 [+0200], Salvatore Benedetto <emitrax@xxxxxxxxx> 
wrote:
> 
> 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.

This applies only for files in the Haiku source tree. I suspect in most cases 
people won't be interested in adding those.

> 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.

Same here.

> < I have not idea what " : : -x .svn " means, please explain >

It's an exclude pattern. Any ".svn" entry will be ignored. Have you ever had 
a look at UserBuildConfig.ReadMe?

> 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.

Also have a look at UserBuildConfig.ReadMe, which gives more in-depth 
information.

> 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>

Each available keymap has *.keymap file in src/data/etc/keymaps/.

> 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>

The timezone descriptions live in src/data/etc/timezones/. One has to look 
into the files for the names of the timezones, though.

[...]

CU, Ingo

Other related posts: