This commit is contained in:
@@ -0,0 +1,123 @@
|
||||
bundle-outdated(1) -- List installed gems with newer versions available
|
||||
=======================================================================
|
||||
|
||||
## SYNOPSIS
|
||||
|
||||
`bundle outdated` [GEM] [--local]
|
||||
[--pre]
|
||||
[--source]
|
||||
[--filter-strict | --strict]
|
||||
[--update-strict]
|
||||
[--parseable | --porcelain]
|
||||
[--group=GROUP]
|
||||
[--groups]
|
||||
[--patch|--minor|--major]
|
||||
[--filter-major]
|
||||
[--filter-minor]
|
||||
[--filter-patch]
|
||||
[--only-explicit]
|
||||
[--cooldown=NUMBER]
|
||||
|
||||
## DESCRIPTION
|
||||
|
||||
Outdated lists the names and versions of gems that have a newer version available
|
||||
in the given source. Calling outdated with [GEM [GEM]] will only check for newer
|
||||
versions of the given gems. Prerelease gems are ignored by default. If your gems
|
||||
are up to date, Bundler will exit with a status of 0. Otherwise, it will exit 1.
|
||||
|
||||
## OPTIONS
|
||||
|
||||
* `--local`:
|
||||
Do not attempt to fetch gems remotely and use the gem cache instead.
|
||||
|
||||
* `--pre`:
|
||||
Check for newer pre-release gems.
|
||||
|
||||
* `--source=<list>`:
|
||||
Check against a specific source.
|
||||
|
||||
* `--filter-strict`, `--strict`:
|
||||
Only list newer versions allowed by your Gemfile requirements, also respecting conservative update flags (--patch, --minor, --major).
|
||||
|
||||
* `--update-strict`:
|
||||
Strict conservative resolution, do not allow any gem to be updated past latest --patch | --minor | --major.
|
||||
|
||||
* `--parseable`, `--porcelain`:
|
||||
Use minimal formatting for more parseable output.
|
||||
|
||||
* `--group=GROUP`:
|
||||
List gems from a specific group.
|
||||
|
||||
* `--groups`:
|
||||
List gems organized by groups.
|
||||
|
||||
* `--minor`:
|
||||
Prefer updating only to next minor version.
|
||||
|
||||
* `--major`:
|
||||
Prefer updating to next major version (default).
|
||||
|
||||
* `--patch`:
|
||||
Prefer updating only to next patch version.
|
||||
|
||||
* `--filter-major`:
|
||||
Only list major newer versions.
|
||||
|
||||
* `--filter-minor`:
|
||||
Only list minor newer versions.
|
||||
|
||||
* `--filter-patch`:
|
||||
Only list patch newer versions.
|
||||
|
||||
* `--only-explicit`:
|
||||
Only list gems specified in your Gemfile, not their dependencies.
|
||||
|
||||
* `--cooldown=<number>`:
|
||||
Annotate (rather than hide) versions that are still inside the
|
||||
cooldown window of <number> days. The prose output appends "in
|
||||
cooldown for Nd more days" and the table form adds "(cooldown Nd)" to
|
||||
the Latest column. When a version outside the window is newer than the
|
||||
installed one, the prose output also appends "newest out of cooldown
|
||||
X" and the table form becomes "(cooldown Nd, X out of cooldown)".
|
||||
With `--filter-strict` (or `--patch`, `--minor`, `--major`, which
|
||||
imply it), "newest" is already the cooldown-filtered resolved version,
|
||||
so none of these annotations appear. See `cooldown` in
|
||||
bundle-config(1).
|
||||
|
||||
## PATCH LEVEL OPTIONS
|
||||
|
||||
See [bundle update(1)](bundle-update.1.html) for details.
|
||||
|
||||
## FILTERING OUTPUT
|
||||
|
||||
The 3 filtering options do not affect the resolution of versions, merely what versions are shown
|
||||
in the output.
|
||||
|
||||
If the regular output shows the following:
|
||||
|
||||
* Gem Current Latest Requested Groups Release Date
|
||||
* faker 1.6.5 1.6.6 ~> 1.4 development, test 2024-02-05
|
||||
* hashie 1.2.0 3.4.6 = 1.2.0 default 2023-11-10
|
||||
* headless 2.2.3 2.3.1 = 2.2.3 test 2022-08-19
|
||||
|
||||
`--filter-major` would only show:
|
||||
|
||||
* Gem Current Latest Requested Groups Release Date
|
||||
* hashie 1.2.0 3.4.6 = 1.2.0 default 2023-11-10
|
||||
|
||||
`--filter-minor` would only show:
|
||||
|
||||
* Gem Current Latest Requested Groups Release Date
|
||||
* headless 2.2.3 2.3.1 = 2.2.3 test 2022-08-19
|
||||
|
||||
`--filter-patch` would only show:
|
||||
|
||||
* Gem Current Latest Requested Groups Release Date
|
||||
* faker 1.6.5 1.6.6 ~> 1.4 development, test 2024-02-05
|
||||
|
||||
Filter options can be combined. `--filter-minor` and `--filter-patch` would show:
|
||||
|
||||
* Gem Current Latest Requested Groups Release Date
|
||||
* faker 1.6.5 1.6.6 ~> 1.4 development, test 2024-02-05
|
||||
|
||||
Combining all three `filter` options would be the same result as providing none of them.
|
||||
Reference in New Issue
Block a user