@@ -141,7 +141,7 @@ <h1 id="npm-ls">npm-ls</h1>
141141
142142<section id="table_of_contents">
143143<h2 id="table-of-contents">Table of contents</h2>
144- <div id="_table_of_contents"><ul><li><a href="#synopsis">Synopsis</a></li><li><a href="#description">Description</a></li><li><a href="#note-design-changes-pending">Note: Design Changes Pending</a></li><li><a href="#configuration">Configuration</a></li><ul><li><a href="#all"><code>all</code></a></li><li><a href="#json"><code>json</code></a></li><li><a href="#long"><code>long</code></a></li><li><a href="#parseable"><code>parseable</code></a></li><li><a href="#global"><code>global</code></a></li><li><a href="#depth"><code>depth</code></a></li><li><a href="#omit"><code>omit</code></a></li><li><a href="#link"><code>link</code></a></li><li><a href="#unicode"><code>unicode</code></a></li><li><a href="#workspace"><code>workspace</code></a></li><li><a href="#workspaces"><code>workspaces</code></a></li></ul><li><a href="#see-also">See Also</a></li></ul></div>
144+ <div id="_table_of_contents"><ul><li><a href="#synopsis">Synopsis</a></li><li><a href="#description">Description</a></li><li><a href="#note-design-changes-pending">Note: Design Changes Pending</a></li><li><a href="#configuration">Configuration</a></li><ul><li><a href="#all"><code>all</code></a></li><li><a href="#json"><code>json</code></a></li><li><a href="#long"><code>long</code></a></li><li><a href="#parseable"><code>parseable</code></a></li><li><a href="#global"><code>global</code></a></li><li><a href="#depth"><code>depth</code></a></li><li><a href="#omit"><code>omit</code></a></li><li><a href="#link"><code>link</code></a></li><li><a href="#package-lock-only"><code>package-lock-only</code></a></li><li><a href="# unicode"><code>unicode</code></a></li><li><a href="#workspace"><code>workspace</code></a></li><li><a href="#workspaces"><code>workspaces</code></a></li></ul><li><a href="#see-also">See Also</a></li></ul></div>
145145</section>
146146
147147<div id="_content"><h3 id="synopsis">Synopsis</h3>
@@ -159,7 +159,7 @@ <h3 id="description">Description</h3>
159159the results to only the paths to the packages named. Note that nested
160160packages will <em>also</em> show the paths to the specified packages. For
161161example, running <code>npm ls promzard</code> in npm’s source tree will show:</p>
162- <pre lang="bash"><code>npm@7.17.0 /path/to/npm
162+ <pre lang="bash"><code>npm@7.18.1 /path/to/npm
163163164164165165</code></pre>
@@ -263,17 +263,18 @@ <h4 id="link"><code>link</code></h4>
263263<li>Default: false</li>
264264<li>Type: Boolean</li>
265265</ul>
266- <p>If true, then local installs will link if there is a suitable globally
267- installed package.</p>
268- <p>Note that this means that local installs can cause things to be installed
269- into the global space at the same time. The link is only done if one of the
270- two conditions are met:</p>
266+ <p>Used with <code>npm ls</code>, limiting output to only those packages that are linked.</p>
267+ <h4 id="package-lock-only"><code>package-lock-only</code></h4>
271268<ul>
272- <li>The package is not already installed globally, or</li>
273- <li>the globally installed version is identical to the version that is being
274- installed locally.</li>
269+ <li>Default: false</li>
270+ <li>Type: Boolean</li>
275271</ul>
276- <p>When used with <code>npm ls</code>, only show packages that are linked.</p>
272+ <p>If set to true, the current operation will only use the <code>package-lock.json</code>,
273+ ignoring <code>node_modules</code>.</p>
274+ <p>For <code>update</code> this means only the <code>package-lock.json</code> will be updated,
275+ instead of checking <code>node_modules</code> and downloading dependencies.</p>
276+ <p>For <code>list</code> this means the output will be based on the tree described by the
277+ <code>package-lock.json</code>, rather than the contents of <code>node_modules</code>.</p>
277278<h4 id="unicode"><code>unicode</code></h4>
278279<ul>
279280<li>Default: false on windows, true on mac/unix systems with a unicode locale,
0 commit comments