@@ -142,14 +142,14 @@ <h1 id="npm-bugs">npm-bugs</h1>
142142
143143< section id ="table_of_contents ">
144144< h2 id ="table-of-contents "> Table of contents</ h2 >
145- < div id ="_table_of_contents "> < ul > < li > < a href ="#synopsis "> Synopsis</ a > </ li > < li > < a href ="#description "> Description</ a > </ li > < li > < a href ="#configuration "> Configuration</ a > </ li > < ul > < li > < a href ="#browser "> < code > browser</ code > </ a > </ li > < li > < a href ="#registry "> < code > registry</ code > </ a > </ li > </ ul > < li > < a href ="#see-also "> See Also</ a > </ li > </ ul > </ div >
145+ < div id ="_table_of_contents "> < ul > < li > < a href ="#synopsis "> Synopsis</ a > </ li > < li > < a href ="#description "> Description</ a > </ li > < li > < a href ="#configuration "> Configuration</ a > </ li > < ul > < li > < a href ="#browser "> < code > browser</ code > </ a > </ li > < li > < a href ="#registry "> < code > registry</ code > </ a > </ li > < li > < a href =" #workspace " > < code > workspace </ code > </ a > </ li > < li > < a href =" #workspaces " > < code > workspaces </ code > </ a > </ li > < li > < a href =" #include-workspace-root " > < code > include-workspace-root </ code > </ a > </ li > < /ul > < li > < a href ="#see-also "> See Also</ a > </ li > </ ul > </ div >
146146</ section >
147147
148148< div id ="_content "> < h3 id ="synopsis "> Synopsis</ h3 >
149149<!-- raw HTML omitted -->
150150<!-- raw HTML omitted -->
151151<!-- raw HTML omitted -->
152- < pre lang ="bash "> < code > npm bugs [<pkgname>]
152+ < pre lang ="bash "> < code > npm bugs [<pkgname> [<pkgname> ...] ]
153153
154154alias: issues
155155</ code > </ pre >
@@ -184,6 +184,57 @@ <h4 id="registry"><code>registry</code></h4>
184184< p > The base URL of the npm registry.</ p >
185185<!-- raw HTML omitted -->
186186<!-- raw HTML omitted -->
187+ < h4 id ="workspace "> < code > workspace</ code > </ h4 >
188+ < ul >
189+ < li > Default:</ li >
190+ < li > Type: String (can be set multiple times)</ li >
191+ </ ul >
192+ < p > Enable running a command in the context of the configured workspaces of the
193+ current project while filtering by running only the workspaces defined by
194+ this configuration option.</ p >
195+ < p > Valid values for the < code > workspace</ code > config are either:</ p >
196+ < ul >
197+ < li > Workspace names</ li >
198+ < li > Path to a workspace directory</ li >
199+ < li > Path to a parent workspace directory (will result in selecting all
200+ workspaces within that folder)</ li >
201+ </ ul >
202+ < p > When set for the < code > npm init</ code > command, this may be set to the folder of a
203+ workspace which does not yet exist, to create the folder and set it up as a
204+ brand new workspace within the project.</ p >
205+ < p > This value is not exported to the environment for child processes.</ p >
206+ <!-- raw HTML omitted -->
207+ <!-- raw HTML omitted -->
208+ < h4 id ="workspaces "> < code > workspaces</ code > </ h4 >
209+ < ul >
210+ < li > Default: null</ li >
211+ < li > Type: null or Boolean</ li >
212+ </ ul >
213+ < p > Set to true to run the command in the context of < strong > all</ strong > configured
214+ workspaces.</ p >
215+ < p > Explicitly setting this to false will cause commands like < code > install</ code > to
216+ ignore workspaces altogether. When not set explicitly:</ p >
217+ < ul >
218+ < li > Commands that operate on the < code > node_modules</ code > tree (install, update, etc.)
219+ will link workspaces into the < code > node_modules</ code > folder. - Commands that do
220+ other things (test, exec, publish, etc.) will operate on the root project,
221+ < em > unless</ em > one or more workspaces are specified in the < code > workspace</ code > config.</ li >
222+ </ ul >
223+ < p > This value is not exported to the environment for child processes.</ p >
224+ <!-- raw HTML omitted -->
225+ <!-- raw HTML omitted -->
226+ < h4 id ="include-workspace-root "> < code > include-workspace-root</ code > </ h4 >
227+ < ul >
228+ < li > Default: false</ li >
229+ < li > Type: Boolean</ li >
230+ </ ul >
231+ < p > Include the workspace root when workspaces are enabled for a command.</ p >
232+ < p > When false, specifying individual workspaces via the < code > workspace</ code > config, or
233+ all workspaces via the < code > workspaces</ code > flag, will cause npm to operate only on
234+ the specified workspaces, and not on the root project.</ p >
235+ < p > This value is not exported to the environment for child processes.</ p >
236+ <!-- raw HTML omitted -->
237+ <!-- raw HTML omitted -->
187238<!-- raw HTML omitted -->
188239< h3 id ="see-also "> See Also</ h3 >
189240< ul >
0 commit comments