[haiku-doc] Re: FAQ: Build System

  • From: "Salvatore Benedetto" <emitrax@xxxxxxxxx>
  • To: ingo_weinhold@xxxxxx
  • Date: Sun, 15 Jun 2008 17:00:04 +0000

2008/6/15  <ingo_weinhold@xxxxxx>:
>
> 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.

Actually I was :) I needed to add a tarball to the image for example,
because I can't
download it. Anyway, IMHO, I think it could be helpful for people that
wants to customize
their image.

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

Actually I haven't. If there is something I don't like is having to
read km of pages to do a simple things, like one of the above. thus this FAQ.

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

This can be added to the FAQ, in case someone wants a 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/.

Thanks.

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

Thanks.

>
> [...]
>
> CU, Ingo
>


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

Other related posts: