opendev/gerrit
Code Issues Proposed changes

Merge "Buck: Document how to install watchman"

Browse Source
This commit is contained in:
David Pursehouse 2014-05-27 04:44:22 +00:00 committed by Gerrit Code Review
commit 310c4a16f2
1 changed files with 42 additions and 7 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

49
Documentation/dev-buck.txt
View File

@ -453,17 +453,52 @@ It is safe to run several buck daemons started from different project
directories and they will not interfere with each other. Buck's documentation directories and they will not interfere with each other. Buck's documentation
covers daemon in http://facebook.github.io/buck/command/buckd.html[buckd]. covers daemon in http://facebook.github.io/buck/command/buckd.html[buckd].
To use `buckd` the additional watchman program must be installed, see To use `buckd` the additional
link:https://github.com/facebook/watchman[watchman] for details. link:https://facebook.github.io/watchman[watchman] program must be installed.
[[watchman]]
=== Installing watchman
Watchman is used internally by Buck to monitor directory trees and is needed
for buck daemon to work properly. Because buckd is activated by default in the
latest version of Buck, it searches for the watchman executable in the
path and issues a warning when it is not found and kills buckd.
To prepare watchman installation on Linux:
---- ----
buckd git clone https://github.com/facebook/watchman.git
buck build gerrit cd watchman
Using buckd. ./autogen.sh
[-] PARSING BUILD FILES...FINISHED 0.6s
[-] BUILDING...FINISHED 0.2s
---- ----
To install it in user home directory (without root privileges):
----
./configure --prefix $HOME/watchman
make install
----
To install it system wide:
----
./configure
make
sudo make install
----
Put $HOME/watchman/bin/watchman in path or link to $HOME/bin/watchman.
To install watchman on OS X:
----
brew install --HEAD watchman
----
See the original documentation for more information:
link:https://facebook.github.io/watchman/docs/install.html[Watchman
installation].
=== Override Buck's settings === Override Buck's settings
Additional JVM args for Buck can be set in `.buckjavaargs` in the Additional JVM args for Buck can be set in `.buckjavaargs` in the