summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorHomu <homu@barosl.com>2016-09-20 14:42:08 +0900
committerSamuel Giddins <segiddins@segiddins.me>2016-09-30 12:27:07 -0500
commitec6355e5b0739af55c7abb617325028545fb2d33 (patch)
treecf354c0e0704d1dd234df922a6d299c4dcd831a1
parentde408924e46290a7679ef4721a9a5f7e57be2e4f (diff)
downloadbundler-ec6355e5b0739af55c7abb617325028545fb2d33.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