1
0
Fork 0
mirror of https://github.com/ruby/ruby.git synced 2022-11-09 12:17:21 -05:00
ruby--ruby/lib/bundler/man/bundle-outdated.1.ronn
David Rodríguez 156079a85d [rubygems/rubygems] Make --strict flag of update and outdated commands consistent
Previously they had slightly different behavior when combined with
conservative updating flags.

The correct behavior is the `--update-strict` option, so `--script` now
does that, The `--update-strict` option is left there for now but I will
deprecate it later.

https://github.com/rubygems/rubygems/commit/ab42046229
2022-03-06 22:17:00 +09:00

102 lines
3.1 KiB
Markdown

bundle-outdated(1) -- List installed gems with newer versions available
=======================================================================
## SYNOPSIS
`bundle outdated` [GEM] [--local]
[--pre]
[--source]
[--strict]
[--parseable | --porcelain]
[--group=GROUP]
[--groups]
[--patch|--minor|--major]
[--filter-major]
[--filter-minor]
[--filter-patch]
[--only-explicit]
## 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`:
Check against a specific source.
* `--strict`:
Only list newer versions allowed by your Gemfile requirements, also respecting conservative update flags (--patch, --minor, --major).
* `--parseable`, `--porcelain`:
Use minimal formatting for more parseable output.
* `--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.
## 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:
* faker (newest 1.6.6, installed 1.6.5, requested ~> 1.4) in groups "development, test"
* hashie (newest 3.4.6, installed 1.2.0, requested = 1.2.0) in groups "default"
* headless (newest 2.3.1, installed 2.2.3) in groups "test"
`--filter-major` would only show:
* hashie (newest 3.4.6, installed 1.2.0, requested = 1.2.0) in groups "default"
`--filter-minor` would only show:
* headless (newest 2.3.1, installed 2.2.3) in groups "test"
`--filter-patch` would only show:
* faker (newest 1.6.6, installed 1.6.5, requested ~> 1.4) in groups "development, test"
Filter options can be combined. `--filter-minor` and `--filter-patch` would show:
* faker (newest 1.6.6, installed 1.6.5, requested ~> 1.4) in groups "development, test"
* headless (newest 2.3.1, installed 2.2.3) in groups "test"
Combining all three `filter` options would be the same result as providing none of them.