1
0
Fork 0
mirror of https://github.com/ruby/ruby.git synced 2022-11-09 12:17:21 -05:00
ruby--ruby/man/bundle-pristine.1.txt
hsbt fc9509bdd2 Merge bundler-2.0.0.pre.2 from upstream.
git-svn-id: svn+ssh://ci.ruby-lang.org/ruby/trunk@66036 b2dd03c8-39d4-4d8f-98ff-823fe69b080e
2018-11-27 12:08:19 +00:00

44 lines
1.7 KiB
Text

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.
November 2018 BUNDLE-PRISTINE(1)