org.simantics.maps.server/node/node-v4.8.0-win-x64/node_modules/npm/man/man1/npm-outdated.1

   1 .TH "NPM\-OUTDATED" "1" "October 2016" "" ""
   2 .SH "NAME"
   3 \fBnpm-outdated\fR \- Check for outdated packages
   4 .SH SYNOPSIS
   5 .P
   6 .RS 2
   7 .nf
   8 npm outdated [<name> [<name> \.\.\.]]
   9 .fi
  10 .RE
  11 .SH DESCRIPTION
  12 .P
  13 This command will check the registry to see if any (or, specific) installed
  14 packages are currently outdated\.
  15 .P
  16 In the output:
  17 .RS 0
  18 .IP \(bu 2
  19 \fBwanted\fP is the maximum version of the package that satisfies the semver
  20 range specified in \fBpackage\.json\fP\|\. If there's no available semver range (i\.e\.
  21 you're running \fBnpm outdated \-\-global\fP, or the package isn't included in
  22 \fBpackage\.json\fP), then \fBwanted\fP shows the currently\-installed version\.
  23 .IP \(bu 2
  24 \fBlatest\fP is the version of the package tagged as latest in the registry\.
  25 Running \fBnpm publish\fP with no special configuration will publish the package
  26 with a dist\-tag of \fBlatest\fP\|\. This may or may not be the maximum version of
  27 the package, or the most\-recently published version of the package, depending
  28 on how the package's developer manages the latest npm help dist\-tag\.
  29 .IP \(bu 2
  30 \fBlocation\fP is where in the dependency tree the package is located\. Note that
  31 \fBnpm outdated\fP defaults to a depth of 0, so unless you override that, you'll
  32 always be seeing only top\-level dependencies that are outdated\.
  33 .IP \(bu 2
  34 \fBpackage type\fP (when using \fB\-\-long\fP / \fB\-l\fP) tells you whether this package is
  35 a \fBdependency\fP or a \fBdevDependency\fP\|\. Packages not included in \fBpackage\.json\fP
  36 are always marked \fBdependencies\fP\|\.
  37
  38 .RE
  39 .SS An example
  40 .P
  41 .RS 2
  42 .nf
  43 $ npm outdated
  44 Package      Current   Wanted   Latest  Location
  45 glob          5\.0\.15   5\.0\.15    6\.0\.1  test\-outdated\-output
  46 nothingness    0\.0\.3      git      git  test\-outdated\-output
  47 npm            3\.5\.1    3\.5\.2    3\.5\.1  test\-outdated\-output
  48 local\-dev      0\.0\.3   linked   linked  test\-outdated\-output
  49 once           1\.3\.2    1\.3\.3    1\.3\.3  test\-outdated\-output
  50 .fi
  51 .RE
  52 .P
  53 With these \fBdependencies\fP:
  54 .P
  55 .RS 2
  56 .nf
  57 {
  58   "glob": "^5\.0\.15",
  59   "nothingness": "github:othiym23/nothingness#master",
  60   "npm": "^3\.5\.1",
  61   "once": "^1\.3\.1"
  62 }
  63 .fi
  64 .RE
  65 .P
  66 A few things to note:
  67 .RS 0
  68 .IP \(bu 2
  69 \fBglob\fP requires \fB^5\fP, which prevents npm from installing \fBglob@6\fP, which is
  70 outside the semver range\.
  71 .IP \(bu 2
  72 Git dependencies will always be reinstalled, because of how they're specified\.
  73 The installed committish might satisfy the dependency specifier (if it's
  74 something immutable, like a commit SHA), or it might not, so \fBnpm outdated\fP and
  75 \fBnpm update\fP have to fetch Git repos to check\. This is why currently doing a
  76 reinstall of a Git dependency always forces a new clone and install\.
  77 .IP \(bu 2
  78 \fBnpm@3\.5\.2\fP is marked as "wanted", but "latest" is \fBnpm@3\.5\.1\fP because npm
  79 uses dist\-tags to manage its \fBlatest\fP and \fBnext\fP release channels\. \fBnpm update\fP
  80 will install the \fInewest\fR version, but \fBnpm install npm\fP (with no semver range)
  81 will install whatever's tagged as \fBlatest\fP\|\.
  82 .IP \(bu 2
  83 \fBonce\fP is just plain out of date\. Reinstalling \fBnode_modules\fP from scratch or
  84 running \fBnpm update\fP will bring it up to spec\.
  85
  86 .RE
  87 .SH CONFIGURATION
  88 .SS json
  89 .RS 0
  90 .IP \(bu 2
  91 Default: false
  92 .IP \(bu 2
  93 Type: Boolean
  94
  95 .RE
  96 .P
  97 Show information in JSON format\.
  98 .SS long
  99 .RS 0
 100 .IP \(bu 2
 101 Default: false
 102 .IP \(bu 2
 103 Type: Boolean
 104
 105 .RE
 106 .P
 107 Show extended information\.
 108 .SS parseable
 109 .RS 0
 110 .IP \(bu 2
 111 Default: false
 112 .IP \(bu 2
 113 Type: Boolean
 114
 115 .RE
 116 .P
 117 Show parseable output instead of tree view\.
 118 .SS global
 119 .RS 0
 120 .IP \(bu 2
 121 Default: false
 122 .IP \(bu 2
 123 Type: Boolean
 124
 125 .RE
 126 .P
 127 Check packages in the global install prefix instead of in the current
 128 project\.
 129 .SS depth
 130 .RS 0
 131 .IP \(bu 2
 132 Default: 0
 133 .IP \(bu 2
 134 Type: Int
 135
 136 .RE
 137 .P
 138 Max depth for checking dependency tree\.
 139 .SH SEE ALSO
 140 .RS 0
 141 .IP \(bu 2
 142 npm help update
 143 .IP \(bu 2
 144 npm help dist\-tag
 145 .IP \(bu 2
 146 npm help 7 registry
 147 .IP \(bu 2
 148 npm help 5 folders
 149
 150 .RE
 151