summaryrefslogtreecommitdiff
path: root/man/bundle-outdated.1.txt
blob: 131e778c4892e28cbaf725b9316f9cdaf4c29803 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
BUNDLE-OUTDATED(1)					    BUNDLE-OUTDATED(1)



NAME
       bundle-outdated - List installed gems with newer versions available

SYNOPSIS
       bundle	outdated   [GEM]   [--local]   [--pre]	[--source]  [--strict]
       [--parseable	|     --porcelain]     [--group=GROUP]	    [--groups]
       [--update-strict]  [--patch|--minor|--major]  [--filter-major]  [--fil-
       ter-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.

       --parseable, --porcelain
	      Use minimal formatting for more parseable output.

       --group
	      List gems from a specific group.

       --groups
	      List gems organized by groups.

       --update-strict
	      Strict  conservative  resolution,  do  not  allow  any gem to be
	      updated past latest --patch | --minor| --major.

       --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  dependen-
	      cies.

PATCH LEVEL OPTIONS
       See bundle update(1) bundle-update.1.html for details.

       One  difference	between  the  patch level options in bundle update and
       here is the --strict option. --strict was already an option on outdated
       before the patch level options were added. --strict wasn't altered, and
       the --update-strict option on outdated reflects what --strict  does  on
       bundle update.

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 provid-
       ing none of them.



				  March 2020		    BUNDLE-OUTDATED(1)