mirror of
https://github.com/ruby/ruby.git
synced 2022-11-09 12:17:21 -05:00
7585bc3187
Features:
- Add caller information to some deprecation messages to make them easier to fix [#7361](https://github.com/bundler/bundler/pull/7361)
- Reconcile `bundle cache` vs `bundle package` everywhere. Now in docs, CLI help and everywhere else `bundle cache` is the preferred version and `bundle package` remains as an alias [#7389](https://github.com/bundler/bundler/pull/7389)
- Display some basic `bundler` documentation together with ruby's RDoc based documentation [#7394](https://github.com/bundler/bundler/pull/7394)
Bugfixes:
- Fix typos deprecation message and upgrading docs [#7374](https://github.com/bundler/bundler/pull/7374)
- Deprecation warnings about `taint` usage on ruby 2.7 [#7385](https://github.com/bundler/bundler/pull/7385)
- Fix `--help` flag not correctly delegating to `man` when used with command aliases [#7388](https://github.com/bundler/bundler/pull/7388)
- `bundle add` should cache newly added gems if an application cache exists [#7393](https://github.com/bundler/bundler/pull/7393)
- Stop using an insecure folder as a "fallback home" when user home is not defined [#7416](https://github.com/bundler/bundler/pull/7416)
- Fix `bundler/inline` warning about `Bundler.root` redefinition [#7417](https://github.com/bundler/bundler/pull/7417)
44 lines
1.6 KiB
Text
44 lines
1.6 KiB
Text
BUNDLE-PRISTINE(1) BUNDLE-PRISTINE(1)
|
|
|
|
|
|
|
|
NAME
|
|
bundle-pristine - Restores installed gems to their pristine condition
|
|
|
|
SYNOPSIS
|
|
bundle pristine
|
|
|
|
DESCRIPTION
|
|
pristine restores 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, bundle pristine ignores unpacked files on
|
|
disk. In other words, this command utilizes the local .gem cache 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
|
|
pristine. One also cannot use bundle pristine on gems with a 'path'
|
|
option in the Gemfile, because bundler has no original copy it can
|
|
restore from.
|
|
|
|
When is it practical to use bundle pristine?
|
|
|
|
It comes in handy when a developer is debugging a gem. bundle pristine
|
|
is a great way to get rid of experimental changes to a gem that one may
|
|
not want.
|
|
|
|
Why use bundle pristine over gem pristine --all?
|
|
|
|
Both commands are very similar. For context: bundle pristine, without
|
|
arguments, cleans all gems from the lockfile. Meanwhile, gem pristine
|
|
--all cleans all installed gems for that Ruby version.
|
|
|
|
If a developer forgets which gems in their project they might have been
|
|
debugging, the Rubygems gem pristine [GEMNAME] command may be inconve-
|
|
nient. One can avoid waiting for gem pristine --all, and instead run
|
|
bundle pristine.
|
|
|
|
|
|
|
|
November 2019 BUNDLE-PRISTINE(1)
|