@@ -313,8 +313,8 @@ Valid values for the `workspace` config are either:
313
313
314
314
* Workspace names
315
315
* Path to a workspace directory
316
- * Path to a parent workspace directory (will result to selecting all of the
317
- nested workspaces)
316
+ * Path to a parent workspace directory (will result in selecting all
317
+ workspaces within that folder )
318
318
319
319
When set for the ` npm init ` command, this may be set to the folder of a
320
320
workspace which does not yet exist, to create the folder and set it up as a
@@ -327,17 +327,39 @@ This value is not exported to the environment for child processes.
327
327
328
328
#### ` workspaces `
329
329
330
- * Default: false
331
- * Type: Boolean
330
+ * Default: null
331
+ * Type: null or Boolean
332
332
333
- Enable running a command in the context of ** all** the configured
333
+ Set to true to run the command in the context of ** all** configured
334
334
workspaces.
335
335
336
+ Explicitly setting this to false will cause commands like ` install ` to
337
+ ignore workspaces altogether. When not set explicitly:
338
+
339
+ - Commands that operate on the ` node_modules ` tree (install, update, etc.)
340
+ will link workspaces into the ` node_modules ` folder. - Commands that do
341
+ other things (test, exec, publish, etc.) will operate on the root project,
342
+ _ unless_ one or more workspaces are specified in the ` workspace ` config.
343
+
336
344
This value is not exported to the environment for child processes.
337
345
338
346
<!-- automatically generated, do not edit manually -->
339
347
<!-- see lib/utils/config/definitions.js -->
340
348
349
+ #### ` include-workspace-root `
350
+
351
+ * Default: false
352
+ * Type: Boolean
353
+
354
+ Include the workspace root when workspaces are enabled for a command.
355
+
356
+ When false, specifying individual workspaces via the ` workspace ` config, or
357
+ all workspaces via the ` workspaces ` flag, will cause npm to operate only on
358
+ the specified workspaces, and not on the root project.
359
+
360
+ <!-- automatically generated, do not edit manually -->
361
+ <!-- see lib/utils/config/definitions.js -->
362
+
341
363
<!-- AUTOGENERATED CONFIG DESCRIPTIONS END -->
342
364
343
365
### See Also
0 commit comments