Improve tools/run_dev.sh to allow custom flags It is currently impossible or very hard to run tools/run_dev.sh with a jvm debug port open. With this change, one can simply run 'tools/run_dev.sh --debug' to open the default jvm debug port. Change-Id: Ie3702affb3a7ee604cfa2dca6836135e0e8663b7
diff --git a/Documentation/developer-guide.md b/Documentation/developer-guide.md index 5b64e5e..d36a24d 100644 --- a/Documentation/developer-guide.md +++ b/Documentation/developer-guide.md
@@ -70,6 +70,16 @@ http://localhost:8080/ to view your local copy of gitiles, which will serve any repositories under `/path/to/repositories`. +Passing `--debug` option to `tools/run_dev.sh` will suspend the runtime until a +remote debugger connects to port 5005. If you don't want to suspend the +runtime, make sure to assign value `n` to environment variable +`DEFAULT_JVM_DEBUG_SUSPEND`: + +``` +cd /path/to/repositories # Don't run from the gitiles repo. +export DEFAULT_JVM_DEBUG_SUSPEND=n; /path/to/gitiles/tools/run_dev.sh --debug +``` + To run unit tests, refer to the aforementioned bazel test command. ## Pushing your changes