afed18de79
with image files. E.g. jam -q update-image libbe.so kernel_x86 will only build libbe.so and the kernel (if necessary) and copy them onto the already existing Haiku image. The MIME DB will not be reinstalled, and only those source directories will be copied for which the AddSourceDirectoryToHaikuImage rule is given a second argument (e.g. "1"). The image will otherwise remain unchanged. The "update-vmware-image" and "update-install" work similarly for the VMWare image and the directory installation respectively. Note that, due to the way the VMWare image is created (prepending a header to the standard image), the file itself is fully rebuilt, i.e. changes made during the emulation will be lost after updating the VMWare image. The feature requires Haiku's jam. With other jam versions a similar effect can be reached by accordingly setting the HAIKU_IMAGE_UPDATE_ONLY and HAIKU_INCLUDE_IN_IMAGE in the UserBuildConfig file. git-svn-id: file:///srv/svn/repos/haiku/haiku/trunk@20602 a95241bf-73f2-0310-859d-f6bbb57e9c96
113 lines
5.0 KiB
Plaintext
113 lines
5.0 KiB
Plaintext
# UserBuildConfig can be used to customize the build according to your needs.
|
|
# If existent it is included by the build system, but it is ignored by svn.
|
|
# This file documents a few examples, what can be done.
|
|
|
|
# Adjusting Build Variables
|
|
|
|
# Turn off warnings in directory src/system/kernel. As fourth (scope) parameter
|
|
# "local" is specified, which means, that this setting applies only to the
|
|
# given directory, but not any of its subdirectories.
|
|
SetConfigVar WARNINGS : HAIKU_TOP src system kernel : 0 : local ;
|
|
|
|
# Add "RUN_WITHOUT_REGISTRAR" to the DEFINES for the directory src/kits and
|
|
# all its subdirectories (scope is "global").
|
|
AppendToConfigVar DEFINES : HAIKU_TOP src kits : RUN_WITHOUT_REGISTRAR
|
|
: global ;
|
|
|
|
# Set the debug level for file src/bin/gdb/gdb/haiku-nat.c (note, that
|
|
# the object file must be specified) to 1. It is worth mentioning, that the
|
|
# executable the object file is linked into (gdb), will still be placed in
|
|
# generated/objects/.../release/... Only when setting DEBUG for the executable,
|
|
# too, it will be placed in .../debug_1/...
|
|
DEBUG on <src!bin!gdb!gdb!>haiku-nat.o = 1 ;
|
|
|
|
|
|
# Haiku Image Related Modifications
|
|
|
|
# Create a 100 MB image at /tmp/walter.image.
|
|
HAIKU_IMAGE_NAME = walter.image ;
|
|
HAIKU_IMAGE_DIR = /tmp ;
|
|
HAIKU_IMAGE_SIZE = 100 ;
|
|
|
|
# Name the VMWare image walter.vmdk (in directory $(HAIKU_IMAGE_DIR)).
|
|
HAIKU_VMWARE_IMAGE_NAME = walter.vmdk ;
|
|
|
|
# Install Haiku in directory /Haiku.
|
|
HAIKU_INSTALL_DIR = /Haiku ;
|
|
|
|
# Affects the haiku-image, haiku-vmware-image, and install-haiku targets. Only
|
|
# targets on which the HAIKU_INCLUDE_IN_IMAGE variable has been set will be
|
|
# updated in the image file/installation directory.
|
|
# The update-image, update-vmware-image, and update-install targets always set
|
|
# this variable, so one likely doesn't ever need to set it manually.
|
|
HAIKU_IMAGE_UPDATE_ONLY = 1 ;
|
|
|
|
# libbe.so and the kernel will be updated on image updates. Note that this
|
|
# doesn't work for pseudo targets like "kernel".
|
|
HAIKU_INCLUDE_IN_IMAGE on libbe.so kernel_x86 = 1 ;
|
|
|
|
# Add "crashing_app" to the beos/bin directory of the Haiku image/installation.
|
|
# Note, that this also makes the image depend on the target, i.e. it is
|
|
# automatically updated when the image is built.
|
|
AddFilesToHaikuImage beos bin : crashing_app ;
|
|
|
|
# Make a symlink to home/config/bin/crash.
|
|
AddSymlinkToHaikuImage home config bin : /beos/bin/crashing_app : crash ;
|
|
|
|
# Adds the source directories src/kits/storage and src/tests/servers/debug
|
|
# (recursively) to the image (as /boot/home/HaikuSources/src/kits/storage
|
|
# and /boot/home/HaikuSources/src/tests/servers/debug respectively).
|
|
# Note that the second directory will also be copied, if the image will only
|
|
# be updated; the first one won't in that case.
|
|
AddSourceDirectoryToHaikuImage src/kits/storage ;
|
|
AddSourceDirectoryToHaikuImage src/tests/servers/debug : 1 ;
|
|
|
|
# Specify scripts that shall be run when populating the image/installation
|
|
# directory. The "early" script is run before anything has been copied onto
|
|
# the image/into the installation directory. The "late" script is run after
|
|
# everything has been copied, but before the MIME database is installed.
|
|
HAIKU_IMAGE_EARLY_USER_SCRIPTS = $(HAIKU_TOP)/../early-image-script.sh ;
|
|
HAIKU_IMAGE_LATE_USER_SCRIPTS = $(HAIKU_TOP)/../late-image-script.sh ;
|
|
|
|
|
|
# Creating Sourceable Shell Scripts
|
|
|
|
# If you use shell scripts (e.g. for testing) that need to access targets or
|
|
# build system properties, you can tell the build system to generate a
|
|
# variables defining shell script you can source from your shell script.
|
|
|
|
# General setup for the shell script to generate. Name is test.inc, located
|
|
# in the output directory.
|
|
MakeLocate test.inc : $(HAIKU_OUTPUT_DIR) ;
|
|
Always test.inc ;
|
|
|
|
# Define variable "outputDir" in the shell script, with the value of
|
|
# HAIKU_OUTPUT_DIR.
|
|
AddVariableToScript test.inc : outputDir : $(HAIKU_OUTPUT_DIR) ;
|
|
|
|
# Define variables "bfsShell" and "fsShellCommand" referring to the
|
|
# generated bfs_shell and fs_shell_command respectively.
|
|
AddTargetVariableToScript test.inc : bfs_shell : bfsShell ;
|
|
AddTargetVariableToScript test.inc : fs_shell_command : fsShellCommand ;
|
|
|
|
# If no variable name is given, the name (without grist) of the target is
|
|
# used, i.e. a variable "rc" referring to the rc command built for the host
|
|
# platform is defined in the script.
|
|
AddTargetVariableToScript test.inc : <build>rc ;
|
|
|
|
|
|
# Optimizing Jamfile Parsing Times
|
|
|
|
# Setting this variable will prevent the root Jamfile to include the Jamfile
|
|
# in the src directory. Instead only the directories required for building the
|
|
# build tools are included. Only useful in combination with DeferredSubInclude.
|
|
HAIKU_DONT_INCLUDE_SRC = 1 ;
|
|
|
|
# Schedule the given subdirectory for inclusion at the end of the root
|
|
# Jamfile (directly using SubInclude here is not possible). Using this
|
|
# feature together with HAIKU_DONT_INCLUDE_SRC allows developers working
|
|
# only on a subproject to reduce Jamfile parsing times considerably.
|
|
DeferredSubInclude HAIKU_TOP src tests add-ons kernel file_systems
|
|
userlandfs ;
|
|
|