doc: add warning for --with and --without usage

python-poetry · Mar 23, 2022 · 399c650 · 399c650
1 parent 3964b4c
commit 399c650
Showing 1 changed file with 9 additions and 0 deletions.
diff --git a/docs/managing-dependencies.md b/docs/managing-dependencies.md
@@ -132,6 +132,15 @@ You can also opt in [optional groups]({{< relref "#optional-groups" >}}) by usin
 poetry install --with docs
 ```
 
+{{% warning %}}
+When used together, `--without` takes precedence over `--with`. For example, the following command
+will only install the dependencies specified in the `test` group.
+
+```bash
+poetry install --with docs --without test,docs
+```
+{{% /warning %}}
+
 Finally, in some case you might want to install **only specific groups** of dependencies
 without installing the default set of dependencies. For that purpose, you can use
 the `--only` option.