Document how to overwrite Buck's settings

Change-Id: I90bece92bf7a1ed72a24d014e42f9be581361856
This commit is contained in:
David Ostrovsky
2013-09-20 22:36:14 +02:00
committed by Shawn Pearce
parent a7a3ee1e3a
commit efaff30bcb

View File

@@ -332,6 +332,31 @@ Using buckd.
[-] BUILDING...FINISHED 0.2s
----
Overwrite Buck's settings
~~~~~~~~~~~~~~~~~~~~~~~~~
In the latest version of Buck the wrapper script `buck_common` will source
one of these files (if they exist): /etc/buck.conf, $HOME/.buck/buck.conf or
$HOME/.buckrc. The trivial case to overwrite the Buck's default 1GB heap size:
----
cat > $HOME/.buckrc <<EOF
export BUCK_EXTRA_JAVA_ARGS="\
-XX:MaxPermSize=512m \
-Xms8000m \
-Xmx16000m"
EOF
----
Or to debug BUCK, set BUCK_DEBUG_MODE to anything non-empty, then connect to
port 8888:
----
cat > $HOME/.buckrc <<EOF
export BUCK_DEBUG_MODE="yes"
EOF
----
GERRIT
------
Part of link:index.html[Gerrit Code Review]