@@ -142,14 +142,14 @@ <h1 id="npm-bugs">npm-bugs</h1>
142
142
143
143
< section id ="table_of_contents ">
144
144
< 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 >
146
146
</ section >
147
147
148
148
< div id ="_content "> < h3 id ="synopsis "> Synopsis</ h3 >
149
149
<!-- raw HTML omitted -->
150
150
<!-- raw HTML omitted -->
151
151
<!-- raw HTML omitted -->
152
- < pre lang ="bash "> < code > npm bugs [<pkgname>]
152
+ < pre lang ="bash "> < code > npm bugs [<pkgname> [<pkgname> ...] ]
153
153
154
154
alias: issues
155
155
</ code > </ pre >
@@ -184,6 +184,57 @@ <h4 id="registry"><code>registry</code></h4>
184
184
< p > The base URL of the npm registry.</ p >
185
185
<!-- raw HTML omitted -->
186
186
<!-- 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 -->
187
238
<!-- raw HTML omitted -->
188
239
< h3 id ="see-also "> See Also</ h3 >
189
240
< ul >
0 commit comments