From ad987eb4fea810fb85448d7606b8f4c773059366 Mon Sep 17 00:00:00 2001 From: SirHegel Date: Thu, 27 Aug 2026 22:07:49 -0500 Subject: [PATCH] docs: clarify update group lock scope --- docs/cli.md | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/docs/cli.md b/docs/cli.md index 13843322bb7..b91b637ebab 100644 --- a/docs/cli.md +++ b/docs/cli.md @@ -1390,6 +1390,13 @@ You can do this using the `add` command. * `--lock` : Do not perform install (only update the lockfile). * `--sync`: Synchronize the environment with the locked packages and the specified groups. +{{% note %}} +The group options determine which dependency groups are installed or synchronized in the +environment. They do not limit resolution of the lock file: `poetry.lock` keeps one consistent +solution for all declared groups, so packages that belong to an excluded group can still change. +To restrict which packages Poetry updates, pass their names to the command. +{{% /note %}} + {{% note %}} When `--only` is specified, `--with` and `--without` options are ignored. {{% /note %}}