Ticket #3433: SharedUserBuildConfig_ReadMe.diff

.ReadMe

@@ -1 @@
-# UserBuildConfig ReadMe
+# SharedUserBuildConfig ReadMe
 # ----------------------
 
-# UserBuildConfig can be used to customize the build according to your needs.
+# SharedUserBuildConfig 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.
+# In addition to SharedUserBuildConfig, the build system supports LocalUserBuildConfig.
+# LocalUserBuildConfig resides in your HAIKU_OUTPU_DIR, typically generated/.
+# Values in LocalUserBuildConfig will over-write those in SharedUserBuildConfig.
 # This file documents a few examples, what can be done. Don't just rename it
-# to UserBuildConfig -- you don't want all the things to happen, that are
-# specified here. Rather create an empty UserBuildConfig and copy the lines
-# you really want, or start out with UserBuildConfig.sample.
+# to SharedUserBuildConfig -- you don't want all the things to happen, that are
+# specified here. Rather create an empty SharedUserBuildConfig and copy the lines
+# you really want, or start out with SharedUserBuildConfig.sample.
 # Of course, noone reads ReadMe files, so they will just get an error here
 # when copying it and jamming:
-Exit You must NOT copy UserBuildConfig.ReadMe directly but use parts of it! ;
+Exit You must NOT copy SharedUserBuildConfig.ReadMe directly but use parts of it! ;
 
 
 # Adjusting Build Variables
 
 # The following variables can be configured per subdirectory (or subtree) or
 # even per object file:
 #
 #   CCFLAGS C++FLAGS DEBUG DEFINES HDRS LINKFLAGS OPTIM OPTIMIZE SYSHDRS
@@ -224 +227 @@
 # jam -q @vmware update kernel
 #   -> Equivalent to running "jam -q update-vmware-image kernel" with the
 #      settings for the "vmware" profile.
 # jam -q @crash mount
 #   -> Enters the bfs_shell mounting the image specified by the "crash" profile.
 #
 # Note, that the build system will automatically define the build profiles
 # "image", "vmware-image", and "install", unless they are already defined in
-# the UserBuildConfig. They correspond to the respective build profile types
+# the SharedUserBuildConfig. They correspond to the respective build profile types
 # and use the values of the variables HAIKU[_VMWARE]_IMAGE_NAME,
 # HAIKU_IMAGE_DIR, HAIKU_INSTALL_DIR, respectively their default values.
 # "jam -q @image" will therefore be equivalent to "jam -q haiku-image".
 
 
 # Creating Sourceable Shell Scripts
 
 # If you use shell scripts (e.g. for testing) that need to access targets or