[haiku-doc] Re: FAQ: Build System

2008/6/15  <ingo_weinhold@xxxxxx>:
>
> On 2008-06-15 at 19:00:04 [+0200], Salvatore Benedetto <emitrax@xxxxxxxxx>
> wrote:
>> 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.
>
> Of course it is useful to add additional files, but those files usually don't
> reside in the Haiku source tree. You seem to have put the tarball you
> mentioned there, but normally people (at least me) don't want to make messes
> in the source tree.

I am messy :) Perhaps, in the FAQ one can suggest to create a
directory like 3rdparty
where to place additional files. Anyway I think the fact that you or I
don't do so, doesn't mean
that nobody else wants to do it.

>
>> >> 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.
>
> Well, it's less than 300 lines total; the "Haiku Image Related Modifications"
> section is even only 100 lines. I'm not opposed to a FAQ, but it's not like
> currently there's no or overwhelmingly much documentation.

I've never either thought or said the opposite. I just think that a FAQ can be
far more easy to reach and read for quick task like those.

>
> CU, Ingo
>

Thanks again for your help.

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

Other related posts: