summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorHomu <homu@barosl.com>2016-09-20 14:42:08 +0900
committerHomu <homu@barosl.com>2016-09-20 14:42:08 +0900
commit4496a97ccc795561437b3136d5310999e5f8d734 (patch)
tree5e9ef3938d52d63209c05f7908360041f2c95c78
parentff83db9250caf0727605ee47dd6c9ee8e96f610b (diff)
parentc2235433a04f1ddc78322255505259f85c34508d (diff)
downloadbundler-4496a97ccc795561437b3136d5310999e5f8d734.tar.gz
Auto merge of #4968 - bundler:seg-exec-load-docs, r=indirect
Update bundle-exec docs for exec loading See https://github.com/bundler/bundler/issues/4852 @indirect
-rw-r--r--man/bundle-exec.ronn9
1 files changed, 9 insertions, 0 deletions
diff --git a/man/bundle-exec.ronn b/man/bundle-exec.ronn
index ba6844c5c2..c9ab2309e4 100644
--- a/man/bundle-exec.ronn
+++ b/man/bundle-exec.ronn
@@ -63,6 +63,15 @@ It also modifies Rubygems:
making system executables work
* Add all gems in the bundle into Gem.loaded_specs
+### Loading
+
+By default, when attempting to `bundle exec` to a file with a ruby shebang,
+Bundler will `Kernel.load` that file instead of using `Kernel.exec`. For the
+vast majority of cases, this is a performance improvement. In a rare few cases,
+this could cause some subtle side-effects (such as dependence on the exact
+contents of `$0` or `__FILE__`) and the optimization can be disabled by enabling
+the `disable_exec_load` setting.
+
### Shelling out
Any Ruby code that opens a subshell (like `system`, backticks, or `%x{}`) will