diff options
author | hsbt <hsbt@b2dd03c8-39d4-4d8f-98ff-823fe69b080e> | 2018-11-02 23:07:56 +0000 |
---|---|---|
committer | hsbt <hsbt@b2dd03c8-39d4-4d8f-98ff-823fe69b080e> | 2018-11-02 23:07:56 +0000 |
commit | 59c8d50653480bef3f24517296e6ddf937fdf6bc (patch) | |
tree | df10aaf4f3307837fe3d1d129d66f6c0c7586bc5 /man/bundle-pristine.1.txt | |
parent | 7deb37777a230837e865e0a11fb8d7c1dc6d03ce (diff) |
Added bundler as default gems. Revisit [Feature #12733]
* bin/*, lib/bundler/*, lib/bundler.rb, spec/bundler, man/*:
Merge from latest stable branch of bundler/bundler repository and
added workaround patches. I will backport them into upstream.
* common.mk, defs/gmake.mk: Added `test-bundler` task for test suite
of bundler.
* tool/sync_default_gems.rb: Added sync task for bundler.
git-svn-id: svn+ssh://ci.ruby-lang.org/ruby/trunk@65509 b2dd03c8-39d4-4d8f-98ff-823fe69b080e
Diffstat (limited to 'man/bundle-pristine.1.txt')
-rw-r--r-- | man/bundle-pristine.1.txt | 44 |
1 files changed, 44 insertions, 0 deletions
diff --git a/man/bundle-pristine.1.txt b/man/bundle-pristine.1.txt new file mode 100644 index 0000000000..38d6dff1c5 --- /dev/null +++ b/man/bundle-pristine.1.txt @@ -0,0 +1,44 @@ +BUNDLE-PRISTINE(1) BUNDLE-PRISTINE(1) + + + +1mNAME0m + 1mbundle-pristine 22m- Restores installed gems to their pristine condition + +1mSYNOPSIS0m + 1mbundle pristine0m + +1mDESCRIPTION0m + 1mpristine 22mrestores the installed gems in the bundle to their pristine + condition using the local gem cache from RubyGems. For git gems, a + forced checkout will be performed. + + For further explanation, 1mbundle pristine 22mignores unpacked files on + disk. In other words, this command utilizes the local 1m.gem 22mcache or the + gem's git repository as if one were installing from scratch. + + Note: the Bundler gem cannot be restored to its original state with + 1mpristine22m. One also cannot use 1mbundle pristine 22mon gems with a 'path' + option in the Gemfile, because bundler has no original copy it can + restore from. + + When is it practical to use 1mbundle pristine22m? + + It comes in handy when a developer is debugging a gem. 1mbundle pristine0m + is a great way to get rid of experimental changes to a gem that one may + not want. + + Why use 1mbundle pristine 22mover 1mgem pristine --all22m? + + Both commands are very similar. For context: 1mbundle pristine22m, without + arguments, cleans all gems from the lockfile. Meanwhile, 1mgem pristine0m + 1m--all 22mcleans all installed gems for that Ruby version. + + If a developer forgets which gems in their project they might have been + debugging, the Rubygems 1mgem pristine [GEMNAME] 22mcommand may be inconve- + nient. One can avoid waiting for 1mgem pristine --all22m, and instead run + 1mbundle pristine22m. + + + + May 2018 BUNDLE-PRISTINE(1) |