rubygems-update 3.7.2 → 4.0.0.beta1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (206) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGELOG.md +1413 -1323
  3. data/CODE_OF_CONDUCT.md +7 -129
  4. data/Manifest.txt +5 -11
  5. data/README.md +2 -2
  6. data/bundler/CHANGELOG.md +990 -917
  7. data/bundler/README.md +4 -4
  8. data/bundler/bundler.gemspec +3 -3
  9. data/bundler/lib/bundler/build_metadata.rb +2 -2
  10. data/bundler/lib/bundler/capistrano.rb +1 -19
  11. data/bundler/lib/bundler/cli/cache.rb +1 -11
  12. data/bundler/lib/bundler/cli/common.rb +20 -3
  13. data/bundler/lib/bundler/cli/config.rb +1 -2
  14. data/bundler/lib/bundler/cli/console.rb +5 -0
  15. data/bundler/lib/bundler/cli/exec.rb +29 -4
  16. data/bundler/lib/bundler/cli/gem.rb +19 -33
  17. data/bundler/lib/bundler/cli/install.rb +7 -82
  18. data/bundler/lib/bundler/cli/issue.rb +2 -2
  19. data/bundler/lib/bundler/cli/list.rb +33 -2
  20. data/bundler/lib/bundler/cli/plugin.rb +5 -1
  21. data/bundler/lib/bundler/cli/show.rb +1 -1
  22. data/bundler/lib/bundler/cli/update.rb +3 -3
  23. data/bundler/lib/bundler/cli.rb +75 -83
  24. data/bundler/lib/bundler/compact_index_client.rb +0 -1
  25. data/bundler/lib/bundler/current_ruby.rb +3 -15
  26. data/bundler/lib/bundler/definition.rb +45 -35
  27. data/bundler/lib/bundler/deployment.rb +1 -64
  28. data/bundler/lib/bundler/digest.rb +1 -1
  29. data/bundler/lib/bundler/dsl.rb +13 -35
  30. data/bundler/lib/bundler/endpoint_specification.rb +0 -22
  31. data/bundler/lib/bundler/errors.rb +1 -5
  32. data/bundler/lib/bundler/feature_flag.rb +0 -33
  33. data/bundler/lib/bundler/fetcher/compact_index.rb +1 -1
  34. data/bundler/lib/bundler/friendly_errors.rb +2 -2
  35. data/bundler/lib/bundler/index.rb +0 -7
  36. data/bundler/lib/bundler/inline.rb +1 -1
  37. data/bundler/lib/bundler/installer/gem_installer.rb +0 -11
  38. data/bundler/lib/bundler/installer.rb +0 -6
  39. data/bundler/lib/bundler/lockfile_generator.rb +1 -1
  40. data/bundler/lib/bundler/lockfile_parser.rb +2 -12
  41. data/bundler/lib/bundler/man/bundle-add.1 +1 -1
  42. data/bundler/lib/bundler/man/bundle-binstubs.1 +3 -6
  43. data/bundler/lib/bundler/man/bundle-binstubs.1.ronn +4 -6
  44. data/bundler/lib/bundler/man/bundle-cache.1 +2 -14
  45. data/bundler/lib/bundler/man/bundle-cache.1.ronn +1 -14
  46. data/bundler/lib/bundler/man/bundle-check.1 +2 -5
  47. data/bundler/lib/bundler/man/bundle-check.1.ronn +0 -5
  48. data/bundler/lib/bundler/man/bundle-clean.1 +1 -1
  49. data/bundler/lib/bundler/man/bundle-config.1 +6 -33
  50. data/bundler/lib/bundler/man/bundle-config.1.ronn +20 -55
  51. data/bundler/lib/bundler/man/bundle-console.1 +1 -1
  52. data/bundler/lib/bundler/man/bundle-doctor.1 +1 -1
  53. data/bundler/lib/bundler/man/bundle-env.1 +1 -1
  54. data/bundler/lib/bundler/man/bundle-exec.1 +2 -5
  55. data/bundler/lib/bundler/man/bundle-exec.1.ronn +1 -5
  56. data/bundler/lib/bundler/man/bundle-fund.1 +1 -1
  57. data/bundler/lib/bundler/man/bundle-gem.1 +3 -6
  58. data/bundler/lib/bundler/man/bundle-gem.1.ronn +2 -5
  59. data/bundler/lib/bundler/man/bundle-help.1 +1 -1
  60. data/bundler/lib/bundler/man/bundle-info.1 +1 -1
  61. data/bundler/lib/bundler/man/bundle-init.1 +1 -1
  62. data/bundler/lib/bundler/man/bundle-install.1 +8 -59
  63. data/bundler/lib/bundler/man/bundle-install.1.ronn +12 -107
  64. data/bundler/lib/bundler/man/bundle-issue.1 +1 -1
  65. data/bundler/lib/bundler/man/bundle-licenses.1 +1 -1
  66. data/bundler/lib/bundler/man/bundle-list.1 +6 -1
  67. data/bundler/lib/bundler/man/bundle-list.1.ronn +5 -0
  68. data/bundler/lib/bundler/man/bundle-lock.1 +1 -1
  69. data/bundler/lib/bundler/man/bundle-open.1 +1 -1
  70. data/bundler/lib/bundler/man/bundle-outdated.1 +1 -1
  71. data/bundler/lib/bundler/man/bundle-platform.1 +1 -1
  72. data/bundler/lib/bundler/man/bundle-plugin.1 +2 -9
  73. data/bundler/lib/bundler/man/bundle-plugin.1.ronn +0 -8
  74. data/bundler/lib/bundler/man/bundle-pristine.1 +1 -1
  75. data/bundler/lib/bundler/man/bundle-remove.1 +2 -8
  76. data/bundler/lib/bundler/man/bundle-remove.1.ronn +1 -8
  77. data/bundler/lib/bundler/man/bundle-show.1 +2 -5
  78. data/bundler/lib/bundler/man/bundle-show.1.ronn +0 -4
  79. data/bundler/lib/bundler/man/bundle-update.1 +1 -1
  80. data/bundler/lib/bundler/man/bundle-version.1 +1 -1
  81. data/bundler/lib/bundler/man/bundle.1 +1 -10
  82. data/bundler/lib/bundler/man/bundle.1.ronn +0 -9
  83. data/bundler/lib/bundler/man/gemfile.5 +1 -1
  84. data/bundler/lib/bundler/man/index.txt +0 -2
  85. data/bundler/lib/bundler/materialization.rb +1 -1
  86. data/bundler/lib/bundler/plugin/installer.rb +0 -10
  87. data/bundler/lib/bundler/plugin/source_list.rb +1 -1
  88. data/bundler/lib/bundler/plugin.rb +1 -1
  89. data/bundler/lib/bundler/resolver.rb +1 -1
  90. data/bundler/lib/bundler/ruby_dsl.rb +2 -0
  91. data/bundler/lib/bundler/ruby_version.rb +1 -3
  92. data/bundler/lib/bundler/rubygems_ext.rb +1 -1
  93. data/bundler/lib/bundler/rubygems_gem_installer.rb +1 -1
  94. data/bundler/lib/bundler/rubygems_integration.rb +1 -5
  95. data/bundler/lib/bundler/self_manager.rb +1 -1
  96. data/bundler/lib/bundler/settings.rb +7 -26
  97. data/bundler/lib/bundler/shared_helpers.rb +8 -20
  98. data/bundler/lib/bundler/source/git/git_proxy.rb +3 -11
  99. data/bundler/lib/bundler/source/git.rb +2 -3
  100. data/bundler/lib/bundler/source/path.rb +3 -7
  101. data/bundler/lib/bundler/source/rubygems.rb +11 -17
  102. data/bundler/lib/bundler/source.rb +1 -1
  103. data/bundler/lib/bundler/source_list.rb +4 -45
  104. data/bundler/lib/bundler/source_map.rb +2 -5
  105. data/bundler/lib/bundler/spec_set.rb +6 -15
  106. data/bundler/lib/bundler/templates/newgem/CODE_OF_CONDUCT.md.tt +7 -129
  107. data/bundler/lib/bundler/templates/newgem/circleci/config.yml.tt +12 -0
  108. data/bundler/lib/bundler/templates/newgem/ext/newgem/Cargo.toml.tt +1 -1
  109. data/bundler/lib/bundler/templates/newgem/ext/newgem/extconf-go.rb.tt +11 -0
  110. data/bundler/lib/bundler/templates/newgem/ext/newgem/go.mod.tt +5 -0
  111. data/bundler/lib/bundler/templates/newgem/ext/newgem/newgem-go.c.tt +2 -0
  112. data/bundler/lib/bundler/templates/newgem/ext/newgem/newgem.go.tt +31 -0
  113. data/bundler/lib/bundler/templates/newgem/github/workflows/main.yml.tt +6 -0
  114. data/bundler/lib/bundler/templates/newgem/gitlab-ci.yml.tt +9 -0
  115. data/bundler/lib/bundler/templates/newgem/newgem.gemspec.tt +4 -1
  116. data/bundler/lib/bundler/vendor/connection_pool/lib/connection_pool/timed_stack.rb +26 -23
  117. data/bundler/lib/bundler/vendor/connection_pool/lib/connection_pool/version.rb +1 -1
  118. data/bundler/lib/bundler/vendor/connection_pool/lib/connection_pool.rb +50 -6
  119. data/bundler/lib/bundler/vendor/fileutils/lib/fileutils.rb +57 -52
  120. data/bundler/lib/bundler/vendor/net-http-persistent/lib/net/http/persistent.rb +5 -2
  121. data/bundler/lib/bundler/vendor/thor/lib/thor/runner.rb +1 -1
  122. data/bundler/lib/bundler/vendor/uri/lib/uri/common.rb +57 -15
  123. data/bundler/lib/bundler/vendor/uri/lib/uri/file.rb +1 -1
  124. data/bundler/lib/bundler/vendor/uri/lib/uri/generic.rb +34 -21
  125. data/bundler/lib/bundler/vendor/uri/lib/uri/http.rb +12 -0
  126. data/bundler/lib/bundler/vendor/uri/lib/uri/rfc2396_parser.rb +9 -8
  127. data/bundler/lib/bundler/vendor/uri/lib/uri/version.rb +2 -2
  128. data/bundler/lib/bundler/version.rb +1 -1
  129. data/bundler/lib/bundler/vlad.rb +1 -14
  130. data/bundler/lib/bundler.rb +6 -28
  131. data/doc/MAINTAINERS.txt +0 -7
  132. data/doc/bundler/UPGRADING.md +11 -5
  133. data/doc/rubygems/CONTRIBUTING.md +1 -1
  134. data/lib/rubygems/basic_specification.rb +3 -9
  135. data/lib/rubygems/bundler_version_finder.rb +1 -0
  136. data/lib/rubygems/command.rb +1 -1
  137. data/lib/rubygems/command_manager.rb +3 -4
  138. data/lib/rubygems/commands/build_command.rb +0 -7
  139. data/lib/rubygems/commands/cert_command.rb +1 -1
  140. data/lib/rubygems/commands/install_command.rb +1 -5
  141. data/lib/rubygems/commands/setup_command.rb +5 -3
  142. data/lib/rubygems/config_file.rb +1 -1
  143. data/lib/rubygems/dependency.rb +1 -1
  144. data/lib/rubygems/dependency_installer.rb +0 -77
  145. data/lib/rubygems/dependency_list.rb +1 -2
  146. data/lib/rubygems/deprecate.rb +74 -72
  147. data/lib/rubygems/doctor.rb +1 -1
  148. data/lib/rubygems/errors.rb +1 -1
  149. data/lib/rubygems/exceptions.rb +2 -3
  150. data/lib/rubygems/ext/builder.rb +6 -2
  151. data/lib/rubygems/ext/cargo_builder.rb +2 -2
  152. data/lib/rubygems/ext/cmake_builder.rb +97 -8
  153. data/lib/rubygems/ext/configure_builder.rb +2 -2
  154. data/lib/rubygems/ext/ext_conf_builder.rb +6 -2
  155. data/lib/rubygems/ext/rake_builder.rb +2 -2
  156. data/lib/rubygems/gem_runner.rb +0 -1
  157. data/lib/rubygems/install_update_options.rb +1 -2
  158. data/lib/rubygems/installer.rb +16 -54
  159. data/lib/rubygems/name_tuple.rb +7 -1
  160. data/lib/rubygems/package/tar_header.rb +4 -4
  161. data/lib/rubygems/package/tar_reader.rb +2 -0
  162. data/lib/rubygems/package/tar_writer.rb +1 -1
  163. data/lib/rubygems/package.rb +21 -12
  164. data/lib/rubygems/platform.rb +31 -11
  165. data/lib/rubygems/remote_fetcher.rb +8 -5
  166. data/lib/rubygems/resolver/conflict.rb +1 -1
  167. data/lib/rubygems/resolver.rb +1 -1
  168. data/lib/rubygems/security/signer.rb +1 -1
  169. data/lib/rubygems/source.rb +2 -2
  170. data/lib/rubygems/spec_fetcher.rb +4 -4
  171. data/lib/rubygems/specification.rb +5 -96
  172. data/lib/rubygems/specification_policy.rb +0 -36
  173. data/lib/rubygems/specification_record.rb +1 -1
  174. data/lib/rubygems/text.rb +1 -1
  175. data/lib/rubygems/uninstaller.rb +17 -6
  176. data/lib/rubygems/user_interaction.rb +6 -9
  177. data/lib/rubygems/util.rb +0 -22
  178. data/lib/rubygems/validator.rb +1 -1
  179. data/lib/rubygems/vendor/net-http/lib/net/http/generic_request.rb +25 -9
  180. data/lib/rubygems/vendor/net-http/lib/net/http/responses.rb +2 -2
  181. data/lib/rubygems/vendor/net-http/lib/net/http.rb +14 -14
  182. data/lib/rubygems/vendor/optparse/lib/optparse.rb +82 -41
  183. data/lib/rubygems/vendor/resolv/lib/resolv.rb +1 -1
  184. data/lib/rubygems/vendor/timeout/lib/timeout.rb +4 -1
  185. data/lib/rubygems/vendor/uri/lib/uri/common.rb +57 -15
  186. data/lib/rubygems/vendor/uri/lib/uri/file.rb +1 -1
  187. data/lib/rubygems/vendor/uri/lib/uri/generic.rb +34 -21
  188. data/lib/rubygems/vendor/uri/lib/uri/http.rb +12 -0
  189. data/lib/rubygems/vendor/uri/lib/uri/rfc2396_parser.rb +9 -8
  190. data/lib/rubygems/vendor/uri/lib/uri/version.rb +2 -2
  191. data/lib/rubygems/version.rb +2 -17
  192. data/lib/rubygems/win_platform.rb +31 -0
  193. data/lib/rubygems.rb +10 -38
  194. data/rubygems-update.gemspec +4 -4
  195. metadata +10 -18
  196. data/bundler/lib/bundler/cli/inject.rb +0 -60
  197. data/bundler/lib/bundler/cli/viz.rb +0 -31
  198. data/bundler/lib/bundler/graph.rb +0 -152
  199. data/bundler/lib/bundler/man/bundle-inject.1 +0 -31
  200. data/bundler/lib/bundler/man/bundle-inject.1.ronn +0 -32
  201. data/bundler/lib/bundler/man/bundle-viz.1 +0 -30
  202. data/bundler/lib/bundler/man/bundle-viz.1.ronn +0 -36
  203. data/bundler/lib/bundler/similarity_detector.rb +0 -63
  204. data/lib/rubygems/commands/query_command.rb +0 -43
  205. data/lib/rubygems/compatibility.rb +0 -41
  206. data/lib/rubygems/install_default_message.rb +0 -13
@@ -1,6 +1,6 @@
1
1
  .\" generated with Ronn-NG/v0.10.1
2
2
  .\" http://github.com/apjanke/ronn-ng/tree/0.10.1
3
- .TH "BUNDLE\-CONFIG" "1" "August 2025" ""
3
+ .TH "BUNDLE\-CONFIG" "1" "September 2025" ""
4
4
  .SH "NAME"
5
5
  \fBbundle\-config\fR \- Set bundler configuration options
6
6
  .SH "SYNOPSIS"
@@ -70,14 +70,11 @@ Any periods in the configuration keys must be replaced with two underscores when
70
70
  .SH "LIST OF AVAILABLE KEYS"
71
71
  The following is a list of all configuration keys and their purpose\. You can learn more about their operation in bundle install(1) \fIbundle\-install\.1\.html\fR\.
72
72
  .TP
73
- \fBallow_offline_install\fR (\fBBUNDLE_ALLOW_OFFLINE_INSTALL\fR)
74
- Allow Bundler to use cached data when installing without network access\.
75
- .TP
76
73
  \fBauto_install\fR (\fBBUNDLE_AUTO_INSTALL\fR)
77
74
  Automatically run \fBbundle install\fR when gems are missing\.
78
75
  .TP
79
76
  \fBbin\fR (\fBBUNDLE_BIN\fR)
80
- Install executables from gems in the bundle to the specified directory\. Defaults to \fBfalse\fR\.
77
+ If configured, \fBbundle binstubs\fR will install executables from gems in the bundle to the specified directory\. Otherwise it will create them in a \fBbin\fR directory relative to the Gemfile directory\. These executables run in Bundler's context\. If used, you might add this directory to your environment's \fBPATH\fR variable\. For instance, if the \fBrails\fR gem comes with a \fBrails\fR executable, \fBbundle binstubs\fR will create a \fBbin/rails\fR executable that ensures that all referred dependencies will be resolved using the bundled gems\.
81
78
  .TP
82
79
  \fBcache_all\fR (\fBBUNDLE_CACHE_ALL\fR)
83
80
  Cache all gems, including path and git gems\. This needs to be explicitly before bundler 4, but will be the default on bundler 4\.
@@ -149,7 +146,7 @@ Generate a \fBgems\.rb\fR instead of a \fBGemfile\fR when running \fBbundle init
149
146
  The number of gems Bundler can install in parallel\. Defaults to the number of available processors\.
150
147
  .TP
151
148
  \fBlockfile_checksums\fR (\fBBUNDLE_LOCKFILE_CHECKSUMS\fR)
152
- Whether Bundler should include a checksums section in new lockfiles, to protect from compromised gem sources\.
149
+ Whether Bundler should include a checksums section in new lockfiles, to protect from compromised gem sources\. Defaults to true\.
153
150
  .TP
154
151
  \fBno_install\fR (\fBBUNDLE_NO_INSTALL\fR)
155
152
  Whether \fBbundle package\fR should skip installing gems\.
@@ -158,10 +155,10 @@ Whether \fBbundle package\fR should skip installing gems\.
158
155
  Whether Bundler should leave outdated gems unpruned when caching\.
159
156
  .TP
160
157
  \fBonly\fR (\fBBUNDLE_ONLY\fR)
161
- A space\-separated list of groups to install only gems of the specified groups\.
158
+ A space\-separated list of groups to install only gems of the specified groups\. Please check carefully if you want to install also gems without a group, because they get put inside \fBdefault\fR group\. For example \fBonly test:default\fR will install all gems specified in test group and without one\.
162
159
  .TP
163
160
  \fBpath\fR (\fBBUNDLE_PATH\fR)
164
- The location on disk where all gems in your bundle will be located regardless of \fB$GEM_HOME\fR or \fB$GEM_PATH\fR values\. Bundle gems not found in this location will be installed by \fBbundle install\fR\. Defaults to \fB\.bundle\fR relative to repository root in Bundler 4, and to the default system path (\fBGem\.dir\fR) before Bundler 4\.
161
+ The location on disk where all gems in your bundle will be located regardless of \fB$GEM_HOME\fR or \fB$GEM_PATH\fR values\. Bundle gems not found in this location will be installed by \fBbundle install\fR\. When not set, Bundler install by default to a \fB\.bundle\fR directory relative to repository root in Bundler 4, and to the default system path (\fBGem\.dir\fR) before Bundler 4\. That means that before Bundler 4, Bundler shares this location with Rubygems, and \fBgem install \|\.\|\.\|\.\fR will have gems installed in the same location and therefore, gems installed without \fBpath\fR set will show up by calling \fBgem list\fR\. This will not be the case in Bundler 4\.
165
162
  .TP
166
163
  \fBpath\.system\fR (\fBBUNDLE_PATH__SYSTEM\fR)
167
164
  Whether Bundler will install gems into the default system path (\fBGem\.dir\fR)\.
@@ -222,30 +219,6 @@ A space\-separated or \fB:\fR\-separated list of groups whose gems bundler shoul
222
219
  .TP
223
220
  \fBwithout\fR (\fBBUNDLE_WITHOUT\fR)
224
221
  A space\-separated or \fB:\fR\-separated list of groups whose gems bundler should not install\.
225
- .SH "REMEMBERING OPTIONS"
226
- Flags passed to \fBbundle install\fR or the Bundler runtime, such as \fB\-\-path foo\fR or \fB\-\-without production\fR, are remembered between commands and saved to your local application's configuration (normally, \fB\./\.bundle/config\fR)\.
227
- .P
228
- However, this will be changed in bundler 4, so it's better not to rely on this behavior\. If these options must be remembered, it's better to set them using \fBbundle config\fR (e\.g\., \fBbundle config set \-\-local path foo\fR)\.
229
- .P
230
- The flags that can be configured are:
231
- .TP
232
- \fB\-\-bin\fR
233
- Creates a directory (defaults to \fB~/bin\fR) and place any executables from the gem there\. These executables run in Bundler's context\. If used, you might add this directory to your environment's \fBPATH\fR variable\. For instance, if the \fBrails\fR gem comes with a \fBrails\fR executable, this flag will create a \fBbin/rails\fR executable that ensures that all referred dependencies will be resolved using the bundled gems\.
234
- .TP
235
- \fB\-\-deployment\fR
236
- In deployment mode, Bundler will 'roll\-out' the bundle for \fBproduction\fR use\. Please check carefully if you want to have this option enabled in \fBdevelopment\fR or \fBtest\fR environments\.
237
- .TP
238
- \fB\-\-only\fR
239
- A space\-separated list of groups to install only gems of the specified groups\. Please check carefully if you want to install also gems without a group, cause they get put inside \fBdefault\fR group\. For example \fBonly test:default\fR will install all gems specified in test group and without one\.
240
- .TP
241
- \fB\-\-path\fR
242
- The location to install the specified gems to\. This defaults to Rubygems' setting\. Bundler shares this location with Rubygems, \fBgem install \|\.\|\.\|\.\fR will have gem installed there, too\. Therefore, gems installed without a \fB\-\-path \|\.\|\.\|\.\fR setting will show up by calling \fBgem list\fR\. Accordingly, gems installed to other locations will not get listed\.
243
- .TP
244
- \fB\-\-without\fR
245
- A space\-separated or \fB:\fR\-separated list of groups referencing gems to skip during installation\.
246
- .TP
247
- \fB\-\-with\fR
248
- A space\-separated or \fB:\fR\-separated list of \fBoptional\fR groups referencing gems to include during installation\.
249
222
  .SH "BUILD OPTIONS"
250
223
  You can use \fBbundle config\fR to give Bundler the flags to pass to the gem installer every time bundler tries to install a particular gem\.
251
224
  .P
@@ -339,7 +312,7 @@ export BUNDLE_GEMS__LONGEROUS__COM="claudette:s00pers3krit"
339
312
  For gems with a git source with HTTP(S) URL you can specify credentials like so:
340
313
  .IP "" 4
341
314
  .nf
342
- bundle config set \-\-global https://github\.com/rubygems/rubygems\.git username:password
315
+ bundle config set \-\-global https://github\.com/ruby/rubygems\.git username:password
343
316
  .fi
344
317
  .IP "" 0
345
318
  .P
@@ -106,13 +106,17 @@ the environment variable `BUNDLE_LOCAL__RACK`.
106
106
  The following is a list of all configuration keys and their purpose. You can
107
107
  learn more about their operation in [bundle install(1)](bundle-install.1.html).
108
108
 
109
- * `allow_offline_install` (`BUNDLE_ALLOW_OFFLINE_INSTALL`):
110
- Allow Bundler to use cached data when installing without network access.
111
109
  * `auto_install` (`BUNDLE_AUTO_INSTALL`):
112
110
  Automatically run `bundle install` when gems are missing.
113
111
  * `bin` (`BUNDLE_BIN`):
114
- Install executables from gems in the bundle to the specified directory.
115
- Defaults to `false`.
112
+ If configured, `bundle binstubs` will install executables from gems in the
113
+ bundle to the specified directory. Otherwise it will create them in a `bin`
114
+ directory relative to the Gemfile directory. These executables run in
115
+ Bundler's context. If used, you might add this directory to your
116
+ environment's `PATH` variable. For instance, if the `rails` gem comes with a
117
+ `rails` executable, `bundle binstubs` will create a `bin/rails` executable
118
+ that ensures that all referred dependencies will be resolved using the
119
+ bundled gems.
116
120
  * `cache_all` (`BUNDLE_CACHE_ALL`):
117
121
  Cache all gems, including path and git gems. This needs to be explicitly
118
122
  before bundler 4, but will be the default on bundler 4.
@@ -186,19 +190,26 @@ learn more about their operation in [bundle install(1)](bundle-install.1.html).
186
190
  The number of gems Bundler can install in parallel. Defaults to the number of
187
191
  available processors.
188
192
  * `lockfile_checksums` (`BUNDLE_LOCKFILE_CHECKSUMS`):
189
- Whether Bundler should include a checksums section in new lockfiles, to protect from compromised gem sources.
193
+ Whether Bundler should include a checksums section in new lockfiles, to protect from compromised gem sources. Defaults to true.
190
194
  * `no_install` (`BUNDLE_NO_INSTALL`):
191
195
  Whether `bundle package` should skip installing gems.
192
196
  * `no_prune` (`BUNDLE_NO_PRUNE`):
193
197
  Whether Bundler should leave outdated gems unpruned when caching.
194
198
  * `only` (`BUNDLE_ONLY`):
195
199
  A space-separated list of groups to install only gems of the specified groups.
200
+ Please check carefully if you want to install also gems without a group, because
201
+ they get put inside `default` group. For example `only test:default` will install
202
+ all gems specified in test group and without one.
196
203
  * `path` (`BUNDLE_PATH`):
197
204
  The location on disk where all gems in your bundle will be located regardless
198
205
  of `$GEM_HOME` or `$GEM_PATH` values. Bundle gems not found in this location
199
- will be installed by `bundle install`. Defaults to `.bundle` relative to
200
- repository root in Bundler 4, and to the default system path (`Gem.dir`)
201
- before Bundler 4.
206
+ will be installed by `bundle install`. When not set, Bundler install by
207
+ default to a `.bundle` directory relative to repository root in Bundler 4,
208
+ and to the default system path (`Gem.dir`) before Bundler 4. That means that
209
+ before Bundler 4, Bundler shares this location with Rubygems, and `gem
210
+ install ...` will have gems installed in the same location and therefore,
211
+ gems installed without `path` set will show up by calling `gem list`. This
212
+ will not be the case in Bundler 4.
202
213
  * `path.system` (`BUNDLE_PATH__SYSTEM`):
203
214
  Whether Bundler will install gems into the default system path (`Gem.dir`).
204
215
  * `plugins` (`BUNDLE_PLUGINS`):
@@ -253,52 +264,6 @@ learn more about their operation in [bundle install(1)](bundle-install.1.html).
253
264
  * `without` (`BUNDLE_WITHOUT`):
254
265
  A space-separated or `:`-separated list of groups whose gems bundler should not install.
255
266
 
256
- ## REMEMBERING OPTIONS
257
-
258
- Flags passed to `bundle install` or the Bundler runtime, such as `--path foo` or
259
- `--without production`, are remembered between commands and saved to your local
260
- application's configuration (normally, `./.bundle/config`).
261
-
262
- However, this will be changed in bundler 4, so it's better not to rely on this
263
- behavior. If these options must be remembered, it's better to set them using
264
- `bundle config` (e.g., `bundle config set --local path foo`).
265
-
266
- The flags that can be configured are:
267
-
268
- * `--bin`:
269
- Creates a directory (defaults to `~/bin`) and place any executables from the
270
- gem there. These executables run in Bundler's context. If used, you might add
271
- this directory to your environment's `PATH` variable. For instance, if the
272
- `rails` gem comes with a `rails` executable, this flag will create a
273
- `bin/rails` executable that ensures that all referred dependencies will be
274
- resolved using the bundled gems.
275
-
276
- * `--deployment`:
277
- In deployment mode, Bundler will 'roll-out' the bundle for
278
- `production` use. Please check carefully if you want to have this option
279
- enabled in `development` or `test` environments.
280
-
281
- * `--only`:
282
- A space-separated list of groups to install only gems of the specified groups.
283
- Please check carefully if you want to install also gems without a group, cause
284
- they get put inside `default` group. For example `only test:default` will install
285
- all gems specified in test group and without one.
286
-
287
- * `--path`:
288
- The location to install the specified gems to. This defaults to Rubygems'
289
- setting. Bundler shares this location with Rubygems, `gem install ...` will
290
- have gem installed there, too. Therefore, gems installed without a
291
- `--path ...` setting will show up by calling `gem list`. Accordingly, gems
292
- installed to other locations will not get listed.
293
-
294
- * `--without`:
295
- A space-separated or `:`-separated list of groups referencing gems to skip during
296
- installation.
297
-
298
- * `--with`:
299
- A space-separated or `:`-separated list of **optional** groups referencing gems to
300
- include during installation.
301
-
302
267
  ## BUILD OPTIONS
303
268
 
304
269
  You can use `bundle config` to give Bundler the flags to pass to the gem
@@ -395,7 +360,7 @@ Or you can set the credentials as an environment variable like this:
395
360
 
396
361
  For gems with a git source with HTTP(S) URL you can specify credentials like so:
397
362
 
398
- bundle config set --global https://github.com/rubygems/rubygems.git username:password
363
+ bundle config set --global https://github.com/ruby/rubygems.git username:password
399
364
 
400
365
  Or you can set the credentials as an environment variable like so:
401
366
 
@@ -1,6 +1,6 @@
1
1
  .\" generated with Ronn-NG/v0.10.1
2
2
  .\" http://github.com/apjanke/ronn-ng/tree/0.10.1
3
- .TH "BUNDLE\-CONSOLE" "1" "August 2025" ""
3
+ .TH "BUNDLE\-CONSOLE" "1" "September 2025" ""
4
4
  .SH "NAME"
5
5
  \fBbundle\-console\fR \- Open an IRB session with the bundle pre\-loaded
6
6
  .SH "SYNOPSIS"
@@ -1,6 +1,6 @@
1
1
  .\" generated with Ronn-NG/v0.10.1
2
2
  .\" http://github.com/apjanke/ronn-ng/tree/0.10.1
3
- .TH "BUNDLE\-DOCTOR" "1" "August 2025" ""
3
+ .TH "BUNDLE\-DOCTOR" "1" "September 2025" ""
4
4
  .SH "NAME"
5
5
  \fBbundle\-doctor\fR \- Checks the bundle for common problems
6
6
  .SH "SYNOPSIS"
@@ -1,6 +1,6 @@
1
1
  .\" generated with Ronn-NG/v0.10.1
2
2
  .\" http://github.com/apjanke/ronn-ng/tree/0.10.1
3
- .TH "BUNDLE\-ENV" "1" "August 2025" ""
3
+ .TH "BUNDLE\-ENV" "1" "September 2025" ""
4
4
  .SH "NAME"
5
5
  \fBbundle\-env\fR \- Print information about the environment Bundler is running under
6
6
  .SH "SYNOPSIS"
@@ -1,10 +1,10 @@
1
1
  .\" generated with Ronn-NG/v0.10.1
2
2
  .\" http://github.com/apjanke/ronn-ng/tree/0.10.1
3
- .TH "BUNDLE\-EXEC" "1" "August 2025" ""
3
+ .TH "BUNDLE\-EXEC" "1" "September 2025" ""
4
4
  .SH "NAME"
5
5
  \fBbundle\-exec\fR \- Execute a command in the context of the bundle
6
6
  .SH "SYNOPSIS"
7
- \fBbundle exec\fR [\-\-keep\-file\-descriptors] [\-\-gemfile=GEMFILE] \fIcommand\fR
7
+ \fBbundle exec\fR [\-\-gemfile=GEMFILE] \fIcommand\fR
8
8
  .SH "DESCRIPTION"
9
9
  This command executes the command, making all gems specified in the [\fBGemfile(5)\fR][Gemfile(5)] available to \fBrequire\fR in Ruby programs\.
10
10
  .P
@@ -13,9 +13,6 @@ Essentially, if you would normally have run something like \fBrspec spec/my_spec
13
13
  Note that \fBbundle exec\fR does not require that an executable is available on your shell's \fB$PATH\fR\.
14
14
  .SH "OPTIONS"
15
15
  .TP
16
- \fB\-\-keep\-file\-descriptors\fR
17
- Passes all file descriptors to the new processes\. Default is true from bundler version 2\.2\.26\. Setting it to false is now deprecated\.
18
- .TP
19
16
  \fB\-\-gemfile=GEMFILE\fR
20
17
  Use the specified gemfile instead of [\fBGemfile(5)\fR][Gemfile(5)]\.
21
18
  .SH "BUNDLE INSTALL \-\-BINSTUBS"
@@ -3,7 +3,7 @@ bundle-exec(1) -- Execute a command in the context of the bundle
3
3
 
4
4
  ## SYNOPSIS
5
5
 
6
- `bundle exec` [--keep-file-descriptors] [--gemfile=GEMFILE] <command>
6
+ `bundle exec` [--gemfile=GEMFILE] <command>
7
7
 
8
8
  ## DESCRIPTION
9
9
 
@@ -20,10 +20,6 @@ available on your shell's `$PATH`.
20
20
 
21
21
  ## OPTIONS
22
22
 
23
- * `--keep-file-descriptors`:
24
- Passes all file descriptors to the new processes. Default is true from
25
- bundler version 2.2.26. Setting it to false is now deprecated.
26
-
27
23
  * `--gemfile=GEMFILE`:
28
24
  Use the specified gemfile instead of [`Gemfile(5)`][Gemfile(5)].
29
25
 
@@ -1,6 +1,6 @@
1
1
  .\" generated with Ronn-NG/v0.10.1
2
2
  .\" http://github.com/apjanke/ronn-ng/tree/0.10.1
3
- .TH "BUNDLE\-FUND" "1" "August 2025" ""
3
+ .TH "BUNDLE\-FUND" "1" "September 2025" ""
4
4
  .SH "NAME"
5
5
  \fBbundle\-fund\fR \- Lists information about gems seeking funding assistance
6
6
  .SH "SYNOPSIS"
@@ -1,6 +1,6 @@
1
1
  .\" generated with Ronn-NG/v0.10.1
2
2
  .\" http://github.com/apjanke/ronn-ng/tree/0.10.1
3
- .TH "BUNDLE\-GEM" "1" "August 2025" ""
3
+ .TH "BUNDLE\-GEM" "1" "September 2025" ""
4
4
  .SH "NAME"
5
5
  \fBbundle\-gem\fR \- Generate a project skeleton for creating a rubygem
6
6
  .SH "SYNOPSIS"
@@ -38,8 +38,8 @@ Add a \fBCHANGELOG\.md\fR file to the root of the generated project\. If this op
38
38
  \fB\-\-no\-changelog\fR
39
39
  Do not create a \fBCHANGELOG\.md\fR (overrides \fB\-\-changelog\fR specified in the global config)\.
40
40
  .TP
41
- \fB\-\-ext=c\fR, \fB\-\-ext=rust\fR
42
- Add boilerplate for C or Rust (currently magnus \fIhttps://docs\.rs/magnus\fR based) extension code to the generated project\. This behavior is disabled by default\.
41
+ \fB\-\-ext=c\fR, \fB\-\-ext=go\fR, \fB\-\-ext=rust\fR
42
+ Add boilerplate for C, Go (currently go\-gem\-wrapper \fIhttps://github\.com/ruby\-go\-gem/go\-gem\-wrapper\fR based) or Rust (currently magnus \fIhttps://docs\.rs/magnus\fR based) extension code to the generated project\. This behavior is disabled by default\.
43
43
  .TP
44
44
  \fB\-\-no\-ext\fR
45
45
  Do not add extension code (overrides \fB\-\-ext\fR specified in the global config)\.
@@ -92,9 +92,6 @@ When Bundler is unconfigured, an interactive prompt will be displayed and the an
92
92
  \fB\-\-no\-linter\fR
93
93
  Do not add a linter (overrides \fB\-\-linter\fR specified in the global config)\.
94
94
  .TP
95
- \fB\-\-rubocop\fR
96
- Add rubocop to the generated Rakefile and gemspec\. Set a default with \fBbundle config set \-\-global gem\.rubocop true\fR\.
97
- .TP
98
95
  \fB\-\-edit=EDIT\fR, \fB\-e=EDIT\fR
99
96
  Open the resulting GEM_NAME\.gemspec in EDIT, or the default editor if not specified\. The default is \fB$BUNDLER_EDITOR\fR, \fB$VISUAL\fR, or \fB$EDITOR\fR\.
100
97
  .TP
@@ -51,8 +51,8 @@ configuration file using the following names:
51
51
  Do not create a `CHANGELOG.md` (overrides `--changelog` specified in the
52
52
  global config).
53
53
 
54
- * `--ext=c`, `--ext=rust`:
55
- Add boilerplate for C or Rust (currently [magnus](https://docs.rs/magnus) based) extension code to the generated project. This behavior
54
+ * `--ext=c`, `--ext=go`, `--ext=rust`:
55
+ Add boilerplate for C, Go (currently [go-gem-wrapper](https://github.com/ruby-go-gem/go-gem-wrapper) based) or Rust (currently [magnus](https://docs.rs/magnus) based) extension code to the generated project. This behavior
56
56
  is disabled by default.
57
57
 
58
58
  * `--no-ext`:
@@ -135,9 +135,6 @@ configuration file using the following names:
135
135
  * `--no-linter`:
136
136
  Do not add a linter (overrides `--linter` specified in the global config).
137
137
 
138
- * `--rubocop`:
139
- Add rubocop to the generated Rakefile and gemspec. Set a default with `bundle config set --global gem.rubocop true`.
140
-
141
138
  * `--edit=EDIT`, `-e=EDIT`:
142
139
  Open the resulting GEM_NAME.gemspec in EDIT, or the default editor if not
143
140
  specified. The default is `$BUNDLER_EDITOR`, `$VISUAL`, or `$EDITOR`.
@@ -1,6 +1,6 @@
1
1
  .\" generated with Ronn-NG/v0.10.1
2
2
  .\" http://github.com/apjanke/ronn-ng/tree/0.10.1
3
- .TH "BUNDLE\-HELP" "1" "August 2025" ""
3
+ .TH "BUNDLE\-HELP" "1" "September 2025" ""
4
4
  .SH "NAME"
5
5
  \fBbundle\-help\fR \- Displays detailed help for each subcommand
6
6
  .SH "SYNOPSIS"
@@ -1,6 +1,6 @@
1
1
  .\" generated with Ronn-NG/v0.10.1
2
2
  .\" http://github.com/apjanke/ronn-ng/tree/0.10.1
3
- .TH "BUNDLE\-INFO" "1" "August 2025" ""
3
+ .TH "BUNDLE\-INFO" "1" "September 2025" ""
4
4
  .SH "NAME"
5
5
  \fBbundle\-info\fR \- Show information for the given gem in your bundle
6
6
  .SH "SYNOPSIS"
@@ -1,6 +1,6 @@
1
1
  .\" generated with Ronn-NG/v0.10.1
2
2
  .\" http://github.com/apjanke/ronn-ng/tree/0.10.1
3
- .TH "BUNDLE\-INIT" "1" "August 2025" ""
3
+ .TH "BUNDLE\-INIT" "1" "September 2025" ""
4
4
  .SH "NAME"
5
5
  \fBbundle\-init\fR \- Generates a Gemfile into the current working directory
6
6
  .SH "SYNOPSIS"
@@ -1,10 +1,10 @@
1
1
  .\" generated with Ronn-NG/v0.10.1
2
2
  .\" http://github.com/apjanke/ronn-ng/tree/0.10.1
3
- .TH "BUNDLE\-INSTALL" "1" "August 2025" ""
3
+ .TH "BUNDLE\-INSTALL" "1" "September 2025" ""
4
4
  .SH "NAME"
5
5
  \fBbundle\-install\fR \- Install the dependencies specified in your Gemfile
6
6
  .SH "SYNOPSIS"
7
- \fBbundle install\fR [\-\-binstubs[=DIRECTORY]] [\-\-clean] [\-\-deployment] [\-\-force] [\-\-frozen] [\-\-full\-index] [\-\-gemfile=GEMFILE] [\-\-jobs=NUMBER] [\-\-local] [\-\-no\-cache] [\-\-no\-prune] [\-\-path PATH] [\-\-prefer\-local] [\-\-quiet] [\-\-retry=NUMBER] [\-\-shebang=SHEBANG] [\-\-standalone[=GROUP[ GROUP\|\.\|\.\|\.]]] [\-\-system] [\-\-trust\-policy=TRUST\-POLICY] [\-\-target\-rbconfig=TARGET\-RBCONFIG] [\-\-with=GROUP[ GROUP\|\.\|\.\|\.]] [\-\-without=GROUP[ GROUP\|\.\|\.\|\.]]
7
+ \fBbundle install\fR [\-\-force] [\-\-full\-index] [\-\-gemfile=GEMFILE] [\-\-jobs=NUMBER] [\-\-local] [\-\-no\-cache] [\-\-prefer\-local] [\-\-quiet] [\-\-retry=NUMBER] [\-\-standalone[=GROUP[ GROUP\|\.\|\.\|\.]]] [\-\-trust\-policy=TRUST\-POLICY] [\-\-target\-rbconfig=TARGET\-RBCONFIG]
8
8
  .SH "DESCRIPTION"
9
9
  Install the gems specified in your Gemfile(5)\. If this is the first time you run bundle install (and a \fBGemfile\.lock\fR does not exist), Bundler will fetch all remote sources, resolve dependencies and install all needed gems\.
10
10
  .P
@@ -12,31 +12,10 @@ If a \fBGemfile\.lock\fR does exist, and you have not updated your Gemfile(5), B
12
12
  .P
13
13
  If a \fBGemfile\.lock\fR does exist, and you have updated your Gemfile(5), Bundler will use the dependencies in the \fBGemfile\.lock\fR for all gems that you did not update, but will re\-resolve the dependencies of gems that you did update\. You can find more information about this update process below under \fICONSERVATIVE UPDATING\fR\.
14
14
  .SH "OPTIONS"
15
- The \fB\-\-clean\fR, \fB\-\-deployment\fR, \fB\-\-frozen\fR, \fB\-\-no\-prune\fR, \fB\-\-path\fR, \fB\-\-shebang\fR, \fB\-\-system\fR, \fB\-\-without\fR and \fB\-\-with\fR options are deprecated because they only make sense if they are applied to every subsequent \fBbundle install\fR run automatically and that requires \fBbundler\fR to silently remember them\. Since \fBbundler\fR will no longer remember CLI flags in future versions, \fBbundle config\fR (see bundle\-config(1)) should be used to apply them permanently\.
16
- .TP
17
- \fB\-\-binstubs[=BINSTUBS]\fR
18
- Binstubs are scripts that wrap around executables\. Bundler creates a small Ruby file (a binstub) that loads Bundler, runs the command, and puts it in \fBbin/\fR\. This lets you link the binstub inside of an application to the exact gem version the application needs\.
19
- .IP
20
- Creates a directory (defaults to \fB~/bin\fR when the option is used without a value, or to the given \fB<BINSTUBS>\fR directory otherwise) and places any executables from the gem there\. These executables run in Bundler's context\. If used, you might add this directory to your environment's \fBPATH\fR variable\. For instance, if the \fBrails\fR gem comes with a \fBrails\fR executable, this flag will create a \fBbin/rails\fR executable that ensures that all referred dependencies will be resolved using the bundled gems\.
21
- .TP
22
- \fB\-\-clean\fR
23
- On finishing the installation Bundler is going to remove any gems not present in the current Gemfile(5)\. Don't worry, gems currently in use will not be removed\.
24
- .IP
25
- This option is deprecated in favor of the \fBclean\fR setting\.
26
- .TP
27
- \fB\-\-deployment\fR
28
- In \fIdeployment mode\fR, Bundler will 'roll\-out' the bundle for production or CI use\. Please check carefully if you want to have this option enabled in your development environment\.
29
- .IP
30
- This option is deprecated in favor of the \fBdeployment\fR setting\.
31
15
  .TP
32
16
  \fB\-\-force\fR, \fB\-\-redownload\fR
33
17
  Force reinstalling every gem, even if already installed\.
34
18
  .TP
35
- \fB\-\-frozen\fR
36
- Do not allow the Gemfile\.lock to be updated after this install\. Exits non\-zero if there are going to be changes to the Gemfile\.lock\.
37
- .IP
38
- This option is deprecated in favor of the \fBfrozen\fR setting\.
39
- .TP
40
19
  \fB\-\-full\-index\fR
41
20
  Bundler will not call Rubygems' API endpoint (default) but download and cache a (currently big) index file of all gems\. Performance can be improved for large bundles that seldom change by enabling this option\.
42
21
  .TP
@@ -55,52 +34,22 @@ Force using locally installed gems, or gems already present in Rubygems' cache o
55
34
  \fB\-\-no\-cache\fR
56
35
  Do not update the cache in \fBvendor/cache\fR with the newly bundled gems\. This does not remove any gems in the cache but keeps the newly bundled gems from being cached during the install\.
57
36
  .TP
58
- \fB\-\-no\-prune\fR
59
- Don't remove stale gems from the cache when the installation finishes\.
60
- .IP
61
- This option is deprecated in favor of the \fBno_prune\fR setting\.
62
- .TP
63
- \fB\-\-path=PATH\fR
64
- The location to install the specified gems to\. This defaults to Rubygems' setting\. Bundler shares this location with Rubygems, \fBgem install \|\.\|\.\|\.\fR will have gem installed there, too\. Therefore, gems installed without a \fB\-\-path \|\.\|\.\|\.\fR setting will show up by calling \fBgem list\fR\. Accordingly, gems installed to other locations will not get listed\.
65
- .IP
66
- This option is deprecated in favor of the \fBpath\fR setting\.
67
- .TP
68
37
  \fB\-\-quiet\fR
69
38
  Do not print progress information to the standard output\.
70
39
  .TP
71
40
  \fB\-\-retry=[<number>]\fR
72
41
  Retry failed network or git requests for \fInumber\fR times\.
73
42
  .TP
74
- \fB\-\-shebang=SHEBANG\fR
75
- Uses the specified ruby executable (usually \fBruby\fR) to execute the scripts created with \fB\-\-binstubs\fR\. In addition, if you use \fB\-\-binstubs\fR together with \fB\-\-shebang jruby\fR these executables will be changed to execute \fBjruby\fR instead\.
76
- .IP
77
- This option is deprecated in favor of the \fBshebang\fR setting\.
78
- .TP
79
43
  \fB\-\-standalone[=<list>]\fR
80
- Makes a bundle that can work without depending on Rubygems or Bundler at runtime\. A space separated list of groups to install can be specified\. Bundler creates a directory named \fBbundle\fR and installs the bundle there\. It also generates a \fBbundle/bundler/setup\.rb\fR file to replace Bundler's own setup in the manner required\. Using this option implicitly sets \fBpath\fR, which is a [remembered option][REMEMBERED OPTIONS]\.
81
- .TP
82
- \fB\-\-system\fR
83
- Installs the gems specified in the bundle to the system's Rubygems location\. This overrides any previous configuration of \fB\-\-path\fR\.
84
- .IP
85
- This option is deprecated in favor of the \fBsystem\fR setting\.
44
+ Makes a bundle that can work without depending on Rubygems or Bundler at runtime\. A space separated list of groups to install can be specified\. Bundler creates a directory named \fBbundle\fR and installs the bundle there\. It also generates a \fBbundle/bundler/setup\.rb\fR file to replace Bundler's own setup in the manner required\.
86
45
  .TP
87
46
  \fB\-\-trust\-policy=TRUST\-POLICY\fR
88
47
  Apply the Rubygems security policy \fIpolicy\fR, where policy is one of \fBHighSecurity\fR, \fBMediumSecurity\fR, \fBLowSecurity\fR, \fBAlmostNoSecurity\fR, or \fBNoSecurity\fR\. For more details, please see the Rubygems signing documentation linked below in \fISEE ALSO\fR\.
89
48
  .TP
90
49
  \fB\-\-target\-rbconfig=TARGET\-RBCONFIG\fR
91
50
  Path to rbconfig\.rb for the deployment target platform\.
92
- .TP
93
- \fB\-\-with=<list>\fR
94
- A space\-separated list of groups referencing gems to install\. If an optional group is given it is installed\. If a group is given that is in the remembered list of groups given to \-\-without, it is removed from that list\.
95
- .IP
96
- This option is deprecated in favor of the \fBwith\fR setting\.
97
- .TP
98
- \fB\-\-without=<list>\fR
99
- A space\-separated list of groups referencing gems to skip during installation\. If a group is given that is in the remembered list of groups given to \-\-with, it is removed from that list\.
100
- .IP
101
- This option is deprecated in favor of the \fBwithout\fR setting\.
102
51
  .SH "DEPLOYMENT MODE"
103
- Bundler's defaults are optimized for development\. To switch to defaults optimized for deployment and for CI, use the \fB\-\-deployment\fR flag\. Do not activate deployment mode on development machines, as it will cause an error when the Gemfile(5) is modified\.
52
+ Bundler's defaults are optimized for development\. To switch to defaults optimized for deployment and for CI, use the \fBdeployment\fR setting\. Do not activate deployment mode on development machines, as it will cause an error when the Gemfile(5) is modified\.
104
53
  .IP "1." 4
105
54
  A \fBGemfile\.lock\fR is required\.
106
55
  .IP
@@ -120,14 +69,14 @@ In development, it's convenient to share the gems used in your application with
120
69
  .IP
121
70
  In deployment, isolation is a more important default\. In addition, the user deploying the application may not have permission to install gems to the system, or the web server may not have permission to read them\.
122
71
  .IP
123
- As a result, \fBbundle install \-\-deployment\fR installs gems to the \fBvendor/bundle\fR directory in the application\. This may be overridden using the \fB\-\-path\fR option\.
72
+ As a result, when \fBdeployment\fR is configured, \fBbundle install\fR installs gems to the \fBvendor/bundle\fR directory in the application\. This may be overridden using the \fBpath\fR setting\.
124
73
  .IP "" 0
125
74
  .SH "INSTALLING GROUPS"
126
75
  By default, \fBbundle install\fR will install all gems in all groups in your Gemfile(5), except those declared for a different platform\.
127
76
  .P
128
- However, you can explicitly tell Bundler to skip installing certain groups with the \fB\-\-without\fR option\. This option takes a space\-separated list of groups\.
77
+ However, you can explicitly tell Bundler to skip installing certain groups with the \fBwithout\fR setting\. This setting takes a space\-separated list of groups\.
129
78
  .P
130
- While the \fB\-\-without\fR option will skip \fIinstalling\fR the gems in the specified groups, it will still \fIdownload\fR those gems and use them to resolve the dependencies of every gem in your Gemfile(5)\.
79
+ While the \fBwithout\fR setting will skip \fIinstalling\fR the gems in the specified groups, \fBbundle install\fR will still \fIdownload\fR those gems and use them to resolve the dependencies of every gem in your Gemfile(5)\.
131
80
  .P
132
81
  This is so that installing a different set of groups on another machine (such as a production server) will not change the gems and versions that you have already developed and tested against\.
133
82
  .P
@@ -148,7 +97,7 @@ end
148
97
  .P
149
98
  In this case, \fBsinatra\fR depends on any version of Rack (\fB>= 1\.0\fR), while \fBrack\-perftools\-profiler\fR depends on 1\.x (\fB~> 1\.0\fR)\.
150
99
  .P
151
- When you run \fBbundle install \-\-without production\fR in development, we look at the dependencies of \fBrack\-perftools\-profiler\fR as well\. That way, you do not spend all your time developing against Rack 2\.0, using new APIs unavailable in Rack 1\.x, only to have Bundler switch to Rack 1\.2 when the \fBproduction\fR group \fIis\fR used\.
100
+ When you configure \fBbundle config without production\fR in development, we look at the dependencies of \fBrack\-perftools\-profiler\fR as well\. That way, you do not spend all your time developing against Rack 2\.0, using new APIs unavailable in Rack 1\.x, only to have Bundler switch to Rack 1\.2 when the \fBproduction\fR group \fIis\fR used\.
152
101
  .P
153
102
  This should not cause any problems in practice, because we do not attempt to \fBinstall\fR the gems in the excluded groups, and only evaluate as part of the dependency resolution process\.
154
103
  .P