bundler 1.16.0 → 1.16.1

Sign up to get free protection for your applications and to get access to all the features.

Potentially problematic release.


This version of bundler might be problematic. Click here for more details.

Files changed (60) hide show
  1. checksums.yaml +5 -5
  2. data/CHANGELOG.md +13 -0
  3. data/bundler.gemspec +57 -0
  4. data/lib/bundler/build_metadata.rb +2 -2
  5. data/lib/bundler/cli/gem.rb +1 -1
  6. data/lib/bundler/cli/init.rb +1 -5
  7. data/lib/bundler/cli/update.rb +3 -1
  8. data/lib/bundler/definition.rb +1 -1
  9. data/lib/bundler/resolver.rb +4 -1
  10. data/lib/bundler/source/rubygems.rb +2 -4
  11. data/lib/bundler/templates/.document +1 -0
  12. data/lib/bundler/templates/Executable +11 -3
  13. data/lib/bundler/templates/newgem/{.travis.yml.tt → travis.yml.tt} +0 -0
  14. data/lib/bundler/version.rb +1 -1
  15. data/man/bundle-add.1 +1 -1
  16. data/man/bundle-add.1.txt +11 -11
  17. data/man/bundle-binstubs.1.txt +19 -19
  18. data/man/bundle-check.1 +1 -1
  19. data/man/bundle-check.1.txt +15 -15
  20. data/man/bundle-clean.1 +1 -1
  21. data/man/bundle-clean.1.txt +10 -10
  22. data/man/bundle-config.1 +1 -1
  23. data/man/bundle-config.1.txt +194 -194
  24. data/man/bundle-exec.1 +1 -1
  25. data/man/bundle-exec.1.txt +62 -62
  26. data/man/bundle-gem.1 +1 -1
  27. data/man/bundle-gem.1.txt +38 -38
  28. data/man/bundle-info.1 +1 -1
  29. data/man/bundle-info.1.txt +8 -8
  30. data/man/bundle-init.1 +1 -1
  31. data/man/bundle-init.1.txt +12 -12
  32. data/man/bundle-inject.1 +1 -1
  33. data/man/bundle-inject.1.txt +9 -9
  34. data/man/bundle-install.1 +1 -1
  35. data/man/bundle-install.1.txt +165 -165
  36. data/man/bundle-list.1 +1 -1
  37. data/man/bundle-list.1.txt +8 -8
  38. data/man/bundle-lock.1 +1 -1
  39. data/man/bundle-lock.1.txt +46 -46
  40. data/man/bundle-open.1 +1 -1
  41. data/man/bundle-open.1.txt +7 -7
  42. data/man/bundle-outdated.1 +1 -1
  43. data/man/bundle-outdated.1.txt +33 -33
  44. data/man/bundle-package.1 +1 -1
  45. data/man/bundle-package.1.txt +35 -35
  46. data/man/bundle-platform.1 +1 -1
  47. data/man/bundle-platform.1.txt +13 -13
  48. data/man/bundle-pristine.1 +1 -1
  49. data/man/bundle-pristine.1.txt +19 -19
  50. data/man/bundle-show.1 +1 -1
  51. data/man/bundle-show.1.txt +11 -11
  52. data/man/bundle-update.1 +1 -1
  53. data/man/bundle-update.1.txt +98 -98
  54. data/man/bundle-viz.1 +1 -1
  55. data/man/bundle-viz.1.txt +16 -16
  56. data/man/bundle.1 +1 -1
  57. data/man/bundle.1.txt +50 -50
  58. data/man/gemfile.5 +1 -1
  59. data/man/gemfile.5.txt +200 -200
  60. metadata +5 -3
@@ -1,7 +1,7 @@
1
1
  .\" generated with Ronn/v0.7.3
2
2
  .\" http://github.com/rtomayko/ronn/tree/0.7.3
3
3
  .
4
- .TH "BUNDLE\-CONFIG" "1" "October 2017" "" ""
4
+ .TH "BUNDLE\-CONFIG" "1" "December 2017" "" ""
5
5
  .
6
6
  .SH "NAME"
7
7
  \fBbundle\-config\fR \- Set bundler configuration options
@@ -2,91 +2,91 @@ BUNDLE-CONFIG(1) BUNDLE-CONFIG(1)
2
2
 
3
3
 
4
4
 
5
- 1mNAME0m
6
- 1mbundle-config 22m- Set bundler configuration options
5
+ NAME
6
+ bundle-config - Set bundler configuration options
7
7
 
8
- 1mSYNOPSIS0m
9
- 1mbundle config 22m[4mname24m [4mvalue24m]]
8
+ SYNOPSIS
9
+ bundle config [name [value]]
10
10
 
11
- 1mDESCRIPTION0m
11
+ DESCRIPTION
12
12
  This command allows you to interact with bundler's configuration sys-
13
13
  tem. Bundler retrieves its configuration from the local application
14
- (1mapp/.bundle/config22m), environment variables, and the user's home direc-
15
- tory (1m~/.bundle/config22m), in that order of priority.
14
+ (app/.bundle/config), environment variables, and the user's home direc-
15
+ tory (~/.bundle/config), in that order of priority.
16
16
 
17
- Executing 1mbundle config 22mwith no parameters will print a list of all
17
+ Executing bundle config with no parameters will print a list of all
18
18
  bundler configuration for the current bundle, and where that configura-
19
19
  tion was set.
20
20
 
21
- Executing 1mbundle config <name> 22mwill print the value of that configura-
21
+ Executing bundle config <name> will print the value of that configura-
22
22
  tion setting, and where it was set.
23
23
 
24
- Executing 1mbundle config <name> <value> 22mwill set that configuration to
24
+ Executing bundle config <name> <value> will set that configuration to
25
25
  the value specified for all bundles executed as the current user. The
26
- configuration will be stored in 1m~/.bundle/config22m. If 4mname24m already is
27
- set, 4mname24m will be overridden and user will be warned.
26
+ configuration will be stored in ~/.bundle/config. If name already is
27
+ set, name will be overridden and user will be warned.
28
28
 
29
- Executing 1mbundle config --global <name> <value> 22mworks the same as
29
+ Executing bundle config --global <name> <value> works the same as
30
30
  above.
31
31
 
32
- Executing 1mbundle config --local <name> <value> 22mwill set that configura-
32
+ Executing bundle config --local <name> <value> will set that configura-
33
33
  tion to the local application. The configuration will be stored in
34
- 1mapp/.bundle/config22m.
34
+ app/.bundle/config.
35
35
 
36
- Executing 1mbundle config --delete <name> 22mwill delete the configuration
36
+ Executing bundle config --delete <name> will delete the configuration
37
37
  in both local and global sources. Not compatible with --global or
38
38
  --local flag.
39
39
 
40
- Executing bundle with the 1mBUNDLE_IGNORE_CONFIG 22menvironment variable set
40
+ Executing bundle with the BUNDLE_IGNORE_CONFIG environment variable set
41
41
  will cause it to ignore all configuration.
42
42
 
43
- Executing 1mbundle config disable_multisource true 22mupgrades the warning
43
+ Executing bundle config disable_multisource true upgrades the warning
44
44
  about the Gemfile containing multiple primary sources to an error. Exe-
45
- cuting 1mbundle config --delete disable_multisource 22mdowngrades this error
45
+ cuting bundle config --delete disable_multisource downgrades this error
46
46
  to a warning.
47
47
 
48
- 1mREMEMBERING OPTIONS0m
49
- Flags passed to 1mbundle install 22mor the Bundler runtime, such as 1m--path0m
50
- 1mfoo 22mor 1m--without production22m, are not remembered between commands. If
51
- these options must be remembered,they must be set using 1mbundle config0m
52
- (e.g., 1mbundle config path foo22m).
48
+ REMEMBERING OPTIONS
49
+ Flags passed to bundle install or the Bundler runtime, such as --path
50
+ foo or --without production, are not remembered between commands. If
51
+ these options must be remembered,they must be set using bundle config
52
+ (e.g., bundle config path foo).
53
53
 
54
54
  The options that can be configured are:
55
55
 
56
- 1mbin 22mCreates a directory (defaults to 1m~/bin22m) and place any executa-
56
+ bin Creates a directory (defaults to ~/bin) and place any executa-
57
57
  bles from the gem there. These executables run in Bundler's con-
58
58
  text. If used, you might add this directory to your environ-
59
- ment's 1mPATH 22mvariable. For instance, if the 1mrails 22mgem comes with
60
- a 1mrails 22mexecutable, this flag will create a 1mbin/rails 22mexecutable
59
+ ment's PATH variable. For instance, if the rails gem comes with
60
+ a rails executable, this flag will create a bin/rails executable
61
61
  that ensures that all referred dependencies will be resolved
62
62
  using the bundled gems.
63
63
 
64
- 1mdeployment0m
65
- In deployment mode, Bundler will 'roll-out' the bundle for 1mpro-0m
66
- 1mduction 22muse. Please check carefully if you want to have this
67
- option enabled in 1mdevelopment 22mor 1mtest 22menvironments.
64
+ deployment
65
+ In deployment mode, Bundler will 'roll-out' the bundle for pro-
66
+ duction use. Please check carefully if you want to have this
67
+ option enabled in development or test environments.
68
68
 
69
- 1mpath 22mThe location to install the specified gems to. This defaults to
69
+ path The location to install the specified gems to. This defaults to
70
70
  Rubygems' setting. Bundler shares this location with Rubygems,
71
- 1mgem install ... 22mwill have gem installed there, too. Therefore,
72
- gems installed without a 1m--path ... 22msetting will show up by
73
- calling 1mgem list22m. Accordingly, gems installed to other locations
71
+ gem install ... will have gem installed there, too. Therefore,
72
+ gems installed without a --path ... setting will show up by
73
+ calling gem list. Accordingly, gems installed to other locations
74
74
  will not get listed.
75
75
 
76
- 1mwithout0m
76
+ without
77
77
  A space-separated list of groups referencing gems to skip during
78
78
  installation.
79
79
 
80
- 1mwith 22mA space-separated list of groups referencing gems to include
80
+ with A space-separated list of groups referencing gems to include
81
81
  during installation.
82
82
 
83
- 1mBUILD OPTIONS0m
84
- You can use 1mbundle config 22mto give bundler the flags to pass to the gem
83
+ BUILD OPTIONS
84
+ You can use bundle config to give bundler the flags to pass to the gem
85
85
  installer every time bundler tries to install a particular gem.
86
86
 
87
- A very common example, the 1mmysql 22mgem, requires Snow Leopard users to
88
- pass configuration flags to 1mgem install 22mto specify where to find the
89
- 1mmysql_config 22mexecutable.
87
+ A very common example, the mysql gem, requires Snow Leopard users to
88
+ pass configuration flags to gem install to specify where to find the
89
+ mysql_config executable.
90
90
 
91
91
 
92
92
 
@@ -104,253 +104,253 @@ BUNDLE-CONFIG(1) BUNDLE-CONFIG(1)
104
104
 
105
105
 
106
106
  After running this command, every time bundler needs to install the
107
- 1mmysql 22mgem, it will pass along the flags you specified.
107
+ mysql gem, it will pass along the flags you specified.
108
108
 
109
- 1mCONFIGURATION KEYS0m
109
+ CONFIGURATION KEYS
110
110
  Configuration keys in bundler have two forms: the canonical form and
111
111
  the environment variable form.
112
112
 
113
- For instance, passing the 1m--without 22mflag to [bundle install(1)][bun-
113
+ For instance, passing the --without flag to [bundle install(1)][bun-
114
114
  dle-install] prevents Bundler from installing certain groups specified
115
- in the Gemfile(5). Bundler persists this value in 1mapp/.bundle/config 22mso
116
- that calls to 1mBundler.setup 22mdo not try to find gems from the 1mGemfile0m
115
+ in the Gemfile(5). Bundler persists this value in app/.bundle/config so
116
+ that calls to Bundler.setup do not try to find gems from the Gemfile
117
117
  that you didn't install. Additionally, subsequent calls to [bundle
118
118
  install(1)][bundle-install] remember this setting and skip those
119
119
  groups.
120
120
 
121
- The canonical form of this configuration is 1m"without"22m. To convert the
121
+ The canonical form of this configuration is "without". To convert the
122
122
  canonical form to the environment variable form, capitalize it, and
123
- prepend 1mBUNDLE_22m. The environment variable form of 1m"without" 22mis 1mBUN-0m
124
- 1mDLE_WITHOUT22m.
123
+ prepend BUNDLE_. The environment variable form of "without" is BUN-
124
+ DLE_WITHOUT.
125
125
 
126
126
  Any periods in the configuration keys must be replaced with two under-
127
127
  scores when setting it via environment variables. The configuration key
128
- 1mlocal.rack 22mbecomes the environment variable 1mBUNDLE_LOCAL__RACK22m.
128
+ local.rack becomes the environment variable BUNDLE_LOCAL__RACK.
129
129
 
130
- 1mLIST OF AVAILABLE KEYS0m
130
+ LIST OF AVAILABLE KEYS
131
131
  The following is a list of all configuration keys and their purpose.
132
132
  You can learn more about their operation in [bundle install(1)][bun-
133
133
  dle-install].
134
134
 
135
- o 1mallow_bundler_dependency_conflicts 22m(1mBUNDLE_ALLOW_BUNDLER_DEPEN-0m
136
- 1mDENCY_CONFLICTS22m): Allow resolving to specifications that have
137
- dependencies on 1mbundler 22mthat are incompatible with the running
135
+ o allow_bundler_dependency_conflicts (BUNDLE_ALLOW_BUNDLER_DEPEN-
136
+ DENCY_CONFLICTS): Allow resolving to specifications that have
137
+ dependencies on bundler that are incompatible with the running
138
138
  Bundler version.
139
139
 
140
- o 1mallow_deployment_source_credential_changes 22m(1mBUNDLE_ALLOW_DEPLOY-0m
141
- 1mMENT_SOURCE_CREDENTIAL_CHANGES22m): When in deployment mode, allow
140
+ o allow_deployment_source_credential_changes (BUNDLE_ALLOW_DEPLOY-
141
+ MENT_SOURCE_CREDENTIAL_CHANGES): When in deployment mode, allow
142
142
  changing the credentials to a gem's source. Ex:
143
- 1mhttps://some.host.com/gems/path/ 22m-> 1mhttps://user_name:pass-0m
144
- 1mword@some.host.com/gems/path0m
143
+ https://some.host.com/gems/path/ -> https://user_name:pass-
144
+ word@some.host.com/gems/path
145
145
 
146
- o 1mallow_offline_install 22m(1mBUNDLE_ALLOW_OFFLINE_INSTALL22m): Allow Bundler
146
+ o allow_offline_install (BUNDLE_ALLOW_OFFLINE_INSTALL): Allow Bundler
147
147
  to use cached data when installing without network access.
148
148
 
149
- o 1mauto_clean_without_path 22m(1mBUNDLE_AUTO_CLEAN_WITHOUT_PATH22m): Automati-
150
- cally run 1mbundle clean 22mafter installing when an explicit 1mpath 22mhas
149
+ o auto_clean_without_path (BUNDLE_AUTO_CLEAN_WITHOUT_PATH): Automati-
150
+ cally run bundle clean after installing when an explicit path has
151
151
  not been set and Bundler is not installing into the system gems.
152
152
 
153
- o 1mauto_install 22m(1mBUNDLE_AUTO_INSTALL22m): Automatically run 1mbundle0m
154
- 1minstall 22mwhen gems are missing.
153
+ o auto_install (BUNDLE_AUTO_INSTALL): Automatically run bundle
154
+ install when gems are missing.
155
155
 
156
- o 1mbin 22m(1mBUNDLE_BIN22m): Install executables from gems in the bundle to
157
- the specified directory. Defaults to 1mfalse22m.
156
+ o bin (BUNDLE_BIN): Install executables from gems in the bundle to
157
+ the specified directory. Defaults to false.
158
158
 
159
- o 1mcache_all 22m(1mBUNDLE_CACHE_ALL22m): Cache all gems, including path and
159
+ o cache_all (BUNDLE_CACHE_ALL): Cache all gems, including path and
160
160
  git gems.
161
161
 
162
- o 1mcache_all_platforms 22m(1mBUNDLE_CACHE_ALL_PLATFORMS22m): Cache gems for
162
+ o cache_all_platforms (BUNDLE_CACHE_ALL_PLATFORMS): Cache gems for
163
163
  all platforms.
164
164
 
165
- o 1mcache_path 22m(1mBUNDLE_CACHE_PATH22m): The directory that bundler will
166
- place cached gems in when running 1mbundle package22m, and that bundler
167
- will look in when installing gems. Defaults to 1mvendor/bundle22m.
165
+ o cache_path (BUNDLE_CACHE_PATH): The directory that bundler will
166
+ place cached gems in when running bundle package, and that bundler
167
+ will look in when installing gems. Defaults to vendor/bundle.
168
168
 
169
- o 1mclean 22m(1mBUNDLE_CLEAN22m): Whether Bundler should run 1mbundle clean 22mauto-
170
- matically after 1mbundle install22m.
169
+ o clean (BUNDLE_CLEAN): Whether Bundler should run bundle clean auto-
170
+ matically after bundle install.
171
171
 
172
- o 1mconsole 22m(1mBUNDLE_CONSOLE22m): The console that 1mbundle console 22mstarts.
173
- Defaults to 1mirb22m.
172
+ o console (BUNDLE_CONSOLE): The console that bundle console starts.
173
+ Defaults to irb.
174
174
 
175
- o 1mdefault_install_uses_path 22m(1mBUNDLE_DEFAULT_INSTALL_USES_PATH22m):
176
- Whether a 1mbundle install 22mwithout an explicit 1m--path 22margument
177
- defaults to installing gems in 1m.bundle22m.
175
+ o default_install_uses_path (BUNDLE_DEFAULT_INSTALL_USES_PATH):
176
+ Whether a bundle install without an explicit --path argument
177
+ defaults to installing gems in .bundle.
178
178
 
179
- o 1mdeployment 22m(1mBUNDLE_DEPLOYMENT22m): Disallow changes to the 1mGemfile22m.
180
- When the 1mGemfile 22mis changed and the lockfile has not been updated,
179
+ o deployment (BUNDLE_DEPLOYMENT): Disallow changes to the Gemfile.
180
+ When the Gemfile is changed and the lockfile has not been updated,
181
181
  running Bundler commands will be blocked.
182
182
 
183
- o 1mdisable_checksum_validation 22m(1mBUNDLE_DISABLE_CHECKSUM_VALIDATION22m):
183
+ o disable_checksum_validation (BUNDLE_DISABLE_CHECKSUM_VALIDATION):
184
184
  Allow installing gems even if they do not match the checksum pro-
185
185
  vided by RubyGems.
186
186
 
187
- o 1mdisable_exec_load 22m(1mBUNDLE_DISABLE_EXEC_LOAD22m): Stop Bundler from
188
- using 1mload 22mto launch an executable in-process in 1mbundle exec22m.
187
+ o disable_exec_load (BUNDLE_DISABLE_EXEC_LOAD): Stop Bundler from
188
+ using load to launch an executable in-process in bundle exec.
189
189
 
190
- o 1mdisable_local_branch_check 22m(1mBUNDLE_DISABLE_LOCAL_BRANCH_CHECK22m):
190
+ o disable_local_branch_check (BUNDLE_DISABLE_LOCAL_BRANCH_CHECK):
191
191
  Allow Bundler to use a local git override without a branch speci-
192
192
  fied in the Gemfile.
193
193
 
194
- o 1mdisable_multisource 22m(1mBUNDLE_DISABLE_MULTISOURCE22m): When set, Gem-
194
+ o disable_multisource (BUNDLE_DISABLE_MULTISOURCE): When set, Gem-
195
195
  files containing multiple sources will produce errors instead of
196
- warnings. Use 1mbundle config --delete disable_multisource 22mto unset.
196
+ warnings. Use bundle config --delete disable_multisource to unset.
197
197
 
198
- o 1mdisable_shared_gems 22m(1mBUNDLE_DISABLE_SHARED_GEMS22m): Stop Bundler from
198
+ o disable_shared_gems (BUNDLE_DISABLE_SHARED_GEMS): Stop Bundler from
199
199
  accessing gems installed to RubyGems' normal location.
200
200
 
201
- o 1mdisable_version_check 22m(1mBUNDLE_DISABLE_VERSION_CHECK22m): Stop Bundler
202
- from checking if a newer Bundler version is available on
201
+ o disable_version_check (BUNDLE_DISABLE_VERSION_CHECK): Stop Bundler
202
+ from checking if a newer Bundler version is available on
203
203
  rubygems.org.
204
204
 
205
- o 1merror_on_stderr 22m(1mBUNDLE_ERROR_ON_STDERR22m): Print Bundler errors to
205
+ o error_on_stderr (BUNDLE_ERROR_ON_STDERR): Print Bundler errors to
206
206
  stderr.
207
207
 
208
- o 1mforce_ruby_platform 22m(1mBUNDLE_FORCE_RUBY_PLATFORM22m): Ignore the cur-
209
- rent machine's platform and install only 1mruby 22mplatform gems. As a
208
+ o force_ruby_platform (BUNDLE_FORCE_RUBY_PLATFORM): Ignore the cur-
209
+ rent machine's platform and install only ruby platform gems. As a
210
210
  result, gems with native extensions will be compiled from source.
211
211
 
212
- o 1mfrozen 22m(1mBUNDLE_FROZEN22m): Disallow changes to the 1mGemfile22m. When the
213
- 1mGemfile 22mis changed and the lockfile has not been updated, running
214
- Bundler commands will be blocked. Defaults to 1mtrue 22mwhen 1m--deploy-0m
215
- 1mment 22mis used.
212
+ o frozen (BUNDLE_FROZEN): Disallow changes to the Gemfile. When the
213
+ Gemfile is changed and the lockfile has not been updated, running
214
+ Bundler commands will be blocked. Defaults to true when --deploy-
215
+ ment is used.
216
216
 
217
- o 1mgem.push_key 22m(1mBUNDLE_GEM__PUSH_KEY22m): Sets the 1m--key 22mparameter for
218
- 1mgem push 22mwhen using the 1mrake release 22mcommand with a private gem-
217
+ o gem.push_key (BUNDLE_GEM__PUSH_KEY): Sets the --key parameter for
218
+ gem push when using the rake release command with a private gem-
219
219
  stash server.
220
220
 
221
- o 1mgemfile 22m(1mBUNDLE_GEMFILE22m): The name of the file that bundler should
222
- use as the 1mGemfile22m. This location of this file also sets the root
223
- of the project, which is used to resolve relative paths in the 1mGem-0m
224
- 1mfile22m, among other things. By default, bundler will search up from
225
- the current working directory until it finds a 1mGemfile22m.
221
+ o gemfile (BUNDLE_GEMFILE): The name of the file that bundler should
222
+ use as the Gemfile. This location of this file also sets the root
223
+ of the project, which is used to resolve relative paths in the Gem-
224
+ file, among other things. By default, bundler will search up from
225
+ the current working directory until it finds a Gemfile.
226
226
 
227
- o 1mglobal_gem_cache 22m(1mBUNDLE_GLOBAL_GEM_CACHE22m): Whether Bundler should
227
+ o global_gem_cache (BUNDLE_GLOBAL_GEM_CACHE): Whether Bundler should
228
228
  cache all gems globally, rather than locally to the installing Ruby
229
229
  installation.
230
230
 
231
- o 1mignore_messages 22m(1mBUNDLE_IGNORE_MESSAGES22m): When set, no post install
231
+ o ignore_messages (BUNDLE_IGNORE_MESSAGES): When set, no post install
232
232
  messages will be printed. To silence a single gem, use dot notation
233
- like 1mignore_messages.httparty true22m.
233
+ like ignore_messages.httparty true.
234
234
 
235
- o 1minit_gems_rb 22m(1mBUNDLE_INIT_GEMS_RB22m) Generate a 1mgems.rb 22minstead of a
236
- 1mGemfile 22mwhen running 1mbundle init22m.
235
+ o init_gems_rb (BUNDLE_INIT_GEMS_RB) Generate a gems.rb instead of a
236
+ Gemfile when running bundle init.
237
237
 
238
- o 1mjobs 22m(1mBUNDLE_JOBS22m): The number of gems Bundler can install in par-
238
+ o jobs (BUNDLE_JOBS): The number of gems Bundler can install in par-
239
239
  allel. Defaults to 1.
240
240
 
241
- o 1mlist_command 22m(1mBUNDLE_LIST_COMMAND22m) Enable new list command feature
241
+ o list_command (BUNDLE_LIST_COMMAND) Enable new list command feature
242
242
 
243
- o 1mmajor_deprecations 22m(1mBUNDLE_MAJOR_DEPRECATIONS22m): Whether Bundler
243
+ o major_deprecations (BUNDLE_MAJOR_DEPRECATIONS): Whether Bundler
244
244
  should print deprecation warnings for behavior that will be changed
245
245
  in the next major version.
246
246
 
247
- o 1mno_install 22m(1mBUNDLE_NO_INSTALL22m): Whether 1mbundle package 22mshould skip
247
+ o no_install (BUNDLE_NO_INSTALL): Whether bundle package should skip
248
248
  installing gems.
249
249
 
250
- o 1mno_prune 22m(1mBUNDLE_NO_PRUNE22m): Whether Bundler should leave outdated
250
+ o no_prune (BUNDLE_NO_PRUNE): Whether Bundler should leave outdated
251
251
  gems unpruned when caching.
252
252
 
253
- o 1monly_update_to_newer_versions 22m(1mBUNDLE_ONLY_UPDATE_TO_NEWER_VER-0m
254
- 1mSIONS22m): During 1mbundle update22m, only resolve to newer versions of the
253
+ o only_update_to_newer_versions (BUNDLE_ONLY_UPDATE_TO_NEWER_VER-
254
+ SIONS): During bundle update, only resolve to newer versions of the
255
255
  gems in the lockfile.
256
256
 
257
- o 1mpath 22m(1mBUNDLE_PATH22m): The location on disk where all gems in your
258
- bundle will be located regardless of 1m$GEM_HOME 22mor 1m$GEM_PATH 22mvalues.
259
- Bundle gems not found in this location will be installed by 1mbundle0m
260
- 1minstall22m. Defaults to 1mGem.dir22m. When --deployment is used, defaults
257
+ o path (BUNDLE_PATH): The location on disk where all gems in your
258
+ bundle will be located regardless of $GEM_HOME or $GEM_PATH values.
259
+ Bundle gems not found in this location will be installed by bundle
260
+ install. Defaults to Gem.dir. When --deployment is used, defaults
261
261
  to vendor/bundle.
262
262
 
263
- o 1mpath.system 22m(1mBUNDLE_PATH__SYSTEM22m): Whether Bundler will install
264
- gems into the default system path (1mGem.dir22m).
263
+ o path.system (BUNDLE_PATH__SYSTEM): Whether Bundler will install
264
+ gems into the default system path (Gem.dir).
265
265
 
266
- o 1mplugins 22m(1mBUNDLE_PLUGINS22m): Enable Bundler's experimental plugin sys-
266
+ o plugins (BUNDLE_PLUGINS): Enable Bundler's experimental plugin sys-
267
267
  tem.
268
268
 
269
- o 1mprefer_gems_rb 22m(1mBUNDLE_PREFER_GEMS_RB22m) Prefer 1mgems.rb 22mto 1mGemfile0m
269
+ o prefer_gems_rb (BUNDLE_PREFER_GEMS_RB) Prefer gems.rb to Gemfile
270
270
  when Bundler is searching for a Gemfile.
271
271
 
272
- o 1mprint_only_version_number 22m(1mBUNDLE_PRINT_ONLY_VERSION_NUMBER22m) Print
273
- only version number from 1mbundler --version22m.
272
+ o print_only_version_number (BUNDLE_PRINT_ONLY_VERSION_NUMBER) Print
273
+ only version number from bundler --version.
274
274
 
275
- o 1mredirect 22m(1mBUNDLE_REDIRECT22m): The number of redirects allowed for
276
- network requests. Defaults to 1m522m.
275
+ o redirect (BUNDLE_REDIRECT): The number of redirects allowed for
276
+ network requests. Defaults to 5.
277
277
 
278
- o 1mretry 22m(1mBUNDLE_RETRY22m): The number of times to retry failed network
279
- requests. Defaults to 1m322m.
278
+ o retry (BUNDLE_RETRY): The number of times to retry failed network
279
+ requests. Defaults to 3.
280
280
 
281
- o 1msetup_makes_kernel_gem_public 22m(1mBUNDLE_SETUP_MAKES_KERNEL_GEM_PUB-0m
282
- 1mLIC22m): Have 1mBundler.setup 22mmake the 1mKernel#gem 22mmethod public, even
281
+ o setup_makes_kernel_gem_public (BUNDLE_SETUP_MAKES_KERNEL_GEM_PUB-
282
+ LIC): Have Bundler.setup make the Kernel#gem method public, even
283
283
  though RubyGems declares it as private.
284
284
 
285
- o 1mshebang 22m(1mBUNDLE_SHEBANG22m): The program name that should be invoked
286
- for generated binstubs. Defaults to the ruby install name used to
285
+ o shebang (BUNDLE_SHEBANG): The program name that should be invoked
286
+ for generated binstubs. Defaults to the ruby install name used to
287
287
  generate the binstub.
288
288
 
289
- o 1msilence_root_warning 22m(1mBUNDLE_SILENCE_ROOT_WARNING22m): Silence the
289
+ o silence_root_warning (BUNDLE_SILENCE_ROOT_WARNING): Silence the
290
290
  warning Bundler prints when installing gems as root.
291
291
 
292
- o 1mskip_default_git_sources 22m(1mBUNDLE_SKIP_DEFAULT_GIT_SOURCES22m): Whether
292
+ o skip_default_git_sources (BUNDLE_SKIP_DEFAULT_GIT_SOURCES): Whether
293
293
  Bundler should skip adding default git source shortcuts to the Gem-
294
294
  file DSL.
295
295
 
296
- o 1mspecific_platform 22m(1mBUNDLE_SPECIFIC_PLATFORM22m): Allow bundler to
296
+ o specific_platform (BUNDLE_SPECIFIC_PLATFORM): Allow bundler to
297
297
  resolve for the specific running platform and store it in the lock-
298
298
  file, instead of only using a generic platform. A specific platform
299
- is the exact platform triple reported by 1mGem::Platform.local22m, such
300
- as 1mx86_64-darwin-16 22mor 1muniversal-java-1.822m. On the other hand,
301
- generic platforms are those such as 1mruby22m, 1mmswin22m, or 1mjava22m. In this
302
- example, 1mx86_64-darwin-16 22mwould map to 1mruby 22mand 1muniversal-java-1.80m
303
- to 1mjava22m.
304
-
305
- o 1mssl_ca_cert 22m(1mBUNDLE_SSL_CA_CERT22m): Path to a designated CA certifi-
306
- cate file or folder containing multiple certificates for trusted
299
+ is the exact platform triple reported by Gem::Platform.local, such
300
+ as x86_64-darwin-16 or universal-java-1.8. On the other hand,
301
+ generic platforms are those such as ruby, mswin, or java. In this
302
+ example, x86_64-darwin-16 would map to ruby and universal-java-1.8
303
+ to java.
304
+
305
+ o ssl_ca_cert (BUNDLE_SSL_CA_CERT): Path to a designated CA certifi-
306
+ cate file or folder containing multiple certificates for trusted
307
307
  CAs in PEM format.
308
308
 
309
- o 1mssl_client_cert 22m(1mBUNDLE_SSL_CLIENT_CERT22m): Path to a designated file
309
+ o ssl_client_cert (BUNDLE_SSL_CLIENT_CERT): Path to a designated file
310
310
  containing a X.509 client certificate and key in PEM format.
311
311
 
312
- o 1mssl_verify_mode 22m(1mBUNDLE_SSL_VERIFY_MODE22m): The SSL verification mode
312
+ o ssl_verify_mode (BUNDLE_SSL_VERIFY_MODE): The SSL verification mode
313
313
  Bundler uses when making HTTPS requests. Defaults to verify peer.
314
314
 
315
- o 1msuppress_install_using_messages 22m(1mBUNDLE_SUPPRESS_INSTALL_USING_MES-0m
316
- 1mSAGES22m): Avoid printing 1mUsing ... 22mmessages during installation when
315
+ o suppress_install_using_messages (BUNDLE_SUPPRESS_INSTALL_USING_MES-
316
+ SAGES): Avoid printing Using ... messages during installation when
317
317
  the version of a gem has not changed.
318
318
 
319
- o 1msystem_bindir 22m(1mBUNDLE_SYSTEM_BINDIR22m): The location where RubyGems
320
- installs binstubs. Defaults to 1mGem.bindir22m.
319
+ o system_bindir (BUNDLE_SYSTEM_BINDIR): The location where RubyGems
320
+ installs binstubs. Defaults to Gem.bindir.
321
321
 
322
- o 1mtimeout 22m(1mBUNDLE_TIMEOUT22m): The seconds allowed before timing out for
323
- network requests. Defaults to 1m1022m.
322
+ o timeout (BUNDLE_TIMEOUT): The seconds allowed before timing out for
323
+ network requests. Defaults to 10.
324
324
 
325
- o 1munlock_source_unlocks_spec 22m(1mBUNDLE_UNLOCK_SOURCE_UNLOCKS_SPEC22m):
326
- Whether running 1mbundle update --source NAME 22munlocks a gem with the
327
- given name. Defaults to 1mtrue22m.
325
+ o unlock_source_unlocks_spec (BUNDLE_UNLOCK_SOURCE_UNLOCKS_SPEC):
326
+ Whether running bundle update --source NAME unlocks a gem with the
327
+ given name. Defaults to true.
328
328
 
329
- o 1mupdate_requires_all_flag 22m(1mBUNDLE_UPDATE_REQUIRES_ALL_FLAG22m) Require
330
- passing 1m--all 22mto 1mbundle update 22mwhen everything should be updated,
331
- and disallow passing no options to 1mbundle update22m.
329
+ o update_requires_all_flag (BUNDLE_UPDATE_REQUIRES_ALL_FLAG) Require
330
+ passing --all to bundle update when everything should be updated,
331
+ and disallow passing no options to bundle update.
332
332
 
333
- o 1muser_agent 22m(1mBUNDLE_USER_AGENT22m): The custom user agent fragment
333
+ o user_agent (BUNDLE_USER_AGENT): The custom user agent fragment
334
334
  Bundler includes in API requests.
335
335
 
336
- o 1mwith 22m(1mBUNDLE_WITH22m): A 1m:22m-separated list of groups whose gems bundler
336
+ o with (BUNDLE_WITH): A :-separated list of groups whose gems bundler
337
337
  should install.
338
338
 
339
- o 1mwithout 22m(1mBUNDLE_WITHOUT22m): A 1m:22m-separated list of groups whose gems
339
+ o without (BUNDLE_WITHOUT): A :-separated list of groups whose gems
340
340
  bundler should not install.
341
341
 
342
342
 
343
343
 
344
- In general, you should set these settings per-application by using the
345
- applicable flag to the [bundle install(1)][bundle-install] or [bundle
344
+ In general, you should set these settings per-application by using the
345
+ applicable flag to the [bundle install(1)][bundle-install] or [bundle
346
346
  package(1)][bundle-package] command.
347
347
 
348
- You can set them globally either via environment variables or 1mbundle0m
349
- 1mconfig22m, whichever is preferable for your setup. If you use both, envi-
348
+ You can set them globally either via environment variables or bundle
349
+ config, whichever is preferable for your setup. If you use both, envi-
350
350
  ronment variables will take preference over global settings.
351
351
 
352
- 1mLOCAL GIT REPOS0m
353
- Bundler also allows you to work against a git repository locally
352
+ LOCAL GIT REPOS
353
+ Bundler also allows you to work against a git repository locally
354
354
  instead of using the remote version. This can be achieved by setting up
355
355
  a local override:
356
356
 
@@ -369,30 +369,30 @@ BUNDLE-CONFIG(1) BUNDLE-CONFIG(1)
369
369
 
370
370
 
371
371
 
372
- Now instead of checking out the remote git repository, the local over-
373
- ride will be used. Similar to a path source, every time the local git
374
- repository change, changes will be automatically picked up by Bundler.
375
- This means a commit in the local git repo will update the revision in
376
- the 1mGemfile.lock 22mto the local git repo revision. This requires the same
377
- attention as git submodules. Before pushing to the remote, you need to
372
+ Now instead of checking out the remote git repository, the local over-
373
+ ride will be used. Similar to a path source, every time the local git
374
+ repository change, changes will be automatically picked up by Bundler.
375
+ This means a commit in the local git repo will update the revision in
376
+ the Gemfile.lock to the local git repo revision. This requires the same
377
+ attention as git submodules. Before pushing to the remote, you need to
378
378
  ensure the local override was pushed, otherwise you may point to a com-
379
- mit that only exists in your local machine. You'll also need to CGI
379
+ mit that only exists in your local machine. You'll also need to CGI
380
380
  escape your usernames and passwords as well.
381
381
 
382
- Bundler does many checks to ensure a developer won't work with invalid
383
- references. Particularly, we force a developer to specify a branch in
384
- the 1mGemfile 22min order to use this feature. If the branch specified in
385
- the 1mGemfile 22mand the current branch in the local git repository do not
386
- match, Bundler will abort. This ensures that a developer is always
387
- working against the correct branches, and prevents accidental locking
382
+ Bundler does many checks to ensure a developer won't work with invalid
383
+ references. Particularly, we force a developer to specify a branch in
384
+ the Gemfile in order to use this feature. If the branch specified in
385
+ the Gemfile and the current branch in the local git repository do not
386
+ match, Bundler will abort. This ensures that a developer is always
387
+ working against the correct branches, and prevents accidental locking
388
388
  to a different branch.
389
389
 
390
- Finally, Bundler also ensures that the current revision in the 1mGem-0m
391
- 1mfile.lock 22mexists in the local git repository. By doing this, Bundler
390
+ Finally, Bundler also ensures that the current revision in the Gem-
391
+ file.lock exists in the local git repository. By doing this, Bundler
392
392
  forces you to fetch the latest changes in the remotes.
393
393
 
394
- 1mMIRRORS OF GEM SOURCES0m
395
- Bundler supports overriding gem sources with mirrors. This allows you
394
+ MIRRORS OF GEM SOURCES
395
+ Bundler supports overriding gem sources with mirrors. This allows you
396
396
  to configure rubygems.org as the gem source in your Gemfile while still
397
397
  using your mirror to fetch gems.
398
398
 
@@ -402,7 +402,7 @@ BUNDLE-CONFIG(1) BUNDLE-CONFIG(1)
402
402
 
403
403
 
404
404
 
405
- For example, to use a mirror of rubygems.org hosted at rubygems-mir-
405
+ For example, to use a mirror of rubygems.org hosted at rubygems-mir-
406
406
  ror.org:
407
407
 
408
408
 
@@ -411,8 +411,8 @@ BUNDLE-CONFIG(1) BUNDLE-CONFIG(1)
411
411
 
412
412
 
413
413
 
414
- Each mirror also provides a fallback timeout setting. If the mirror
415
- does not respond within the fallback timeout, Bundler will try to use
414
+ Each mirror also provides a fallback timeout setting. If the mirror
415
+ does not respond within the fallback timeout, Bundler will try to use
416
416
  the original server instead of the mirror.
417
417
 
418
418
 
@@ -429,11 +429,11 @@ BUNDLE-CONFIG(1) BUNDLE-CONFIG(1)
429
429
 
430
430
 
431
431
 
432
- The default fallback timeout is 0.1 seconds, but the setting can cur-
432
+ The default fallback timeout is 0.1 seconds, but the setting can cur-
433
433
  rently only accept whole seconds (for example, 1, 15, or 30).
434
434
 
435
- 1mCREDENTIALS FOR GEM SOURCES0m
436
- Bundler allows you to configure credentials for any gem source, which
435
+ CREDENTIALS FOR GEM SOURCES
436
+ Bundler allows you to configure credentials for any gem source, which
437
437
  allows you to avoid putting secrets into your Gemfile.
438
438
 
439
439
 
@@ -442,8 +442,8 @@ BUNDLE-CONFIG(1) BUNDLE-CONFIG(1)
442
442
 
443
443
 
444
444
 
445
- For example, to save the credentials of user 1mclaudette 22mfor the gem
446
- source at 1mgems.longerous.com22m, you would run:
445
+ For example, to save the credentials of user claudette for the gem
446
+ source at gems.longerous.com, you would run:
447
447
 
448
448
 
449
449
 
@@ -476,7 +476,7 @@ BUNDLE-CONFIG(1) BUNDLE-CONFIG(1)
476
476
 
477
477
 
478
478
 
479
- This is especially useful for private repositories on hosts such as
479
+ This is especially useful for private repositories on hosts such as
480
480
  Github, where you can use personal OAuth tokens:
481
481
 
482
482
 
@@ -488,4 +488,4 @@ BUNDLE-CONFIG(1) BUNDLE-CONFIG(1)
488
488
 
489
489
 
490
490
 
491
- October 2017 BUNDLE-CONFIG(1)
491
+ December 2017 BUNDLE-CONFIG(1)