aboutsummaryrefslogtreecommitdiff
path: root/deps/npm/html/doc/misc/npm-config.html
diff options
context:
space:
mode:
Diffstat (limited to 'deps/npm/html/doc/misc/npm-config.html')
-rw-r--r--deps/npm/html/doc/misc/npm-config.html59
1 files changed, 50 insertions, 9 deletions
diff --git a/deps/npm/html/doc/misc/npm-config.html b/deps/npm/html/doc/misc/npm-config.html
index e1707bc0d7..78e9569e5b 100644
--- a/deps/npm/html/doc/misc/npm-config.html
+++ b/deps/npm/html/doc/misc/npm-config.html
@@ -105,6 +105,13 @@ this:</p>
you want your scoped package to be publicly viewable (and installable) set
<code>--access=public</code>. The only valid values for <code>access</code> are <code>public</code> and
<code>restricted</code>. Unscoped packages <em>always</em> have an access level of <code>public</code>.</p>
+<h3 id="allow-same-version">allow-same-version</h3>
+<ul>
+<li>Default: false</li>
+<li>Type: Boolean</li>
+</ul>
+<p>Prevents throwing an error when <code>npm version</code> is used to set the new version
+to the same value as the current version.</p>
<h3 id="always-auth">always-auth</h3>
<ul>
<li>Default: false</li>
@@ -193,19 +200,15 @@ well as for the CA information to be stored in a file on disk.</p>
<li>Default: Infinity</li>
<li>Type: Number</li>
</ul>
-<p>The maximum time (in seconds) to keep items in the registry cache before
-re-checking against the registry.</p>
-<p>Note that no purging is done unless the <code>npm cache clean</code> command is
-explicitly used, and that only GET requests use the cache.</p>
+<p><strong>DEPRECATED</strong>: This option has been deprecated in favor of <code>--prefer-online</code>.</p>
+<p><code>--cache-max=0</code> is an alias for <code>--prefer-online</code>.</p>
<h3 id="cache-min">cache-min</h3>
<ul>
<li>Default: 10</li>
<li>Type: Number</li>
</ul>
-<p>The minimum time (in seconds) to keep items in the registry cache before
-re-checking against the registry.</p>
-<p>Note that no purging is done unless the <code>npm cache clean</code> command is
-explicitly used, and that only GET requests use the cache.</p>
+<p><strong>DEPRECATED</strong>: This option has been deprecated in favor of <code>--prefer-offline</code>.</p>
+<p><code>--cache-min=9999 (or bigger)</code> is an alias for <code>--prefer-offline</code>.</p>
<h3 id="cert">cert</h3>
<ul>
<li>Default: <code>null</code></li>
@@ -386,6 +389,12 @@ a script that isn&#39;t defined in the <code>scripts</code> section of <code>pac
option can be used when it&#39;s desirable to optionally run a script when it&#39;s
present and fail if the script fails. This is useful, for example, when running
scripts that may only apply for some builds in an otherwise generic CI setup.</p>
+<h3 id="ignore-prepublish">ignore-prepublish</h3>
+<ul>
+<li>Default: false</li>
+<li>Type: Boolean</li>
+</ul>
+<p>If true, npm will not run <code>prepublish</code> scripts.</p>
<h3 id="ignore-scripts">ignore-scripts</h3>
<ul>
<li>Default: false</li>
@@ -541,6 +550,13 @@ combination). Passed to the <code>http</code> <code>Agent</code> used to make th
<li>Type: semver or false</li>
</ul>
<p>The node version to use when checking a package&#39;s <code>engines</code> map.</p>
+<h3 id="offline">offline</h3>
+<ul>
+<li>Default: false</li>
+<li>Type: Boolean</li>
+</ul>
+<p>Force offline mode: no network requests will be done during install. To allow
+the CLI to fill in missing cache data, see <code>--prefer-offline</code>.</p>
<h3 id="onload-script">onload-script</h3>
<ul>
<li>Default: false</li>
@@ -577,6 +593,21 @@ process is not aborted.</p>
</ul>
<p>Output parseable results from commands that write to
standard output. For <code>npm search</code>, this will be tab-separated table format.</p>
+<h3 id="prefer-offline">prefer-offline</h3>
+<ul>
+<li>Default: false</li>
+<li>Type: Boolean</li>
+</ul>
+<p>If true, staleness checks for cached data will be bypassed, but missing data
+will be requested from the server. To force full offline mode, use <code>--offline</code>.</p>
+<p>This option is effectively equivalent to <code>--cache-min=9999999</code>.</p>
+<h3 id="prefer-online">prefer-online</h3>
+<ul>
+<li>Default: false</li>
+<li>Type: Boolean</li>
+</ul>
+<p>If true, staleness checks for cached data will be forced, making the CLI look
+for updates immediately even for fresh package data.</p>
<h3 id="prefix">prefix</h3>
<ul>
<li>Default: see <a href="../files/npm-folders.html">npm-folders(5)</a></li>
@@ -821,6 +852,16 @@ to the empty string: <code>&quot;&quot;</code>.</p>
<p>Because other tools may rely on the convention that npm version tags look like
<code>v1.0.0</code>, <em>only use this property if it is absolutely necessary</em>. In
particular, use care when overriding this setting for public packages.</p>
+<h3 id="timing">timing</h3>
+<ul>
+<li>Default: <code>false</code></li>
+<li>Type: Boolean</li>
+</ul>
+<p>If true, writes an <code>npm-debug</code> log to <code>_logs</code> and timing information to
+<code>_timing.json</code>, both in your cache. <code>_timing.json</code> is a newline delimited
+list of JSON objects. You can quickly view it with this
+<a href="https://www.npmjs.com/package/json">json</a> command line:
+<code>json -g &lt; ~/.npm/_timing.json</code>.</p>
<h3 id="tmp">tmp</h3>
<ul>
<li>Default: TMPDIR environment variable, or &quot;/tmp&quot;</li>
@@ -920,5 +961,5 @@ exit successfully.</p>
<tr><td style="width:60px;height:10px;background:rgb(237,127,127)" colspan=6>&nbsp;</td><td colspan=10 style="width:10px;height:10px;background:rgb(237,127,127)">&nbsp;</td></tr>
<tr><td colspan=5 style="width:50px;height:10px;background:#fff">&nbsp;</td><td style="width:40px;height:10px;background:rgb(237,127,127)" colspan=4>&nbsp;</td><td style="width:90px;height:10px;background:#fff" colspan=9>&nbsp;</td></tr>
</table>
-<p id="footer">npm-config &mdash; npm@4.5.0</p>
+<p id="footer">npm-config &mdash; npm@5.0.0-beta.56</p>