Page MenuHomePhorge
Files F2893475

No OneTemporary
Actions

View Options

diff --git a/src/docs/svn_hooks.diviner b/src/docs/svn_hooks.diviner
index c01fe283..3605299f 100644
--- a/src/docs/svn_hooks.diviner
+++ b/src/docs/svn_hooks.diviner
@@ -1,19 +1,35 @@
@title Installing Arcanist SVN Hooks
@group config
= Installing Arcanist SVN Hooks =
You can install Arcanist as an SVN pre-commit hook, to reject commits which
contain lint errors. The immediate value of this is that syntax errors won't
be committable, but you can block other kinds of badness with appropriate lint
engines.
To install Arcanist as a pre-commit hook, add this to your svn/hooks/pre-commit:
#!/bin/sh
- /path/to/arcanist/bin/arc svn-hook-pre-commit $@ 1>&2
+ /usr/local/bin/php -f /path/to/arcanist/bin/arc svn-hook-pre-commit $@ 1>&2
Make sure you make this file executable, or you'll get an error for every commit
-with an unhelpful error message. You also need to specify the full path since
-SVN nukes ENV before executing scripts.
+with an unhelpful error message. You also need to specify the full path to PHP
+since SVN nukes ENV before executing scripts. Alternatively you can specify
+PATH explicitly.
+If your project is configured to run linters or lint engines which aren't part
+of Arcanist, specify where to load them from with ##--load-phutil-library##:
+
+ --load-phutil-library=/path/to/library/root
+
+Since SVN commit hooks run without access to a working copy, you'll need to keep
+one checked out somewhere and reference it with ##--load-phutil-library## if you
+build new linters or customize lint engines. For example, your hook might
+look like this:
+
+ #!/bin/sh
+ /usr/local/bin/php -f /path/to/arcanist/bin/arc svn-hook-pre-commit \
+ --load-phutil-library=/path/to/custom/lint/engine \
+ --load-phutil-library=/path/to/custom/unittest/engine \
+ $@ 1>&2

File Metadata

Mime Type
text/x-diff
Expires
Sun, Jan 19, 18:29 (1 w, 4 d ago)
Storage Engine
blob
Storage Format
Raw Data
Storage Handle
1127433
Default Alt Text
(1 KB)

Event Timeline

Content licensed under Creative Commons Attribution-ShareAlike 4.0 (CC-BY-SA) unless otherwise noted; code licensed under Apache 2.0 or other open source licenses. · CC BY-SA 4.0 · Apache 2.0