From 65e5c9fa58653b58b4937fabee82f51bfc6c4fb5 Mon Sep 17 00:00:00 2001 From: Johnathan Raymond Date: Wed, 17 Sep 2025 16:54:13 -0700 Subject: [PATCH 1/2] Update documentation on version requirements Clarify handling of multiple version requirements of disjoint regions --- src/doc/src/reference/specifying-dependencies.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/src/doc/src/reference/specifying-dependencies.md b/src/doc/src/reference/specifying-dependencies.md index c53f15f4007..73ee5b45f4e 100644 --- a/src/doc/src/reference/specifying-dependencies.md +++ b/src/doc/src/reference/specifying-dependencies.md @@ -110,7 +110,9 @@ Here are some examples of comparison requirements: ### Multiple version requirements As shown in the examples above, multiple version requirements can be -separated with a comma, e.g., `>= 1.2, < 1.5`. +separated with a comma, e.g., `>= 1.2, < 1.5`. Comma separated requirements +are treated as an intersection, so you cannot _exclude_ a version with +non-overlapping requirements like `<1.2,^1.2.2`. ### Pre-releases From 43fcd7399f5bde575e1b40461d56febb8094d4a8 Mon Sep 17 00:00:00 2001 From: Johnathan Raymond Date: Thu, 18 Sep 2025 09:36:43 -0700 Subject: [PATCH 2/2] Accept review comments Co-authored-by: Weihang Lo --- src/doc/src/reference/specifying-dependencies.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/src/doc/src/reference/specifying-dependencies.md b/src/doc/src/reference/specifying-dependencies.md index 73ee5b45f4e..310c504825b 100644 --- a/src/doc/src/reference/specifying-dependencies.md +++ b/src/doc/src/reference/specifying-dependencies.md @@ -110,9 +110,9 @@ Here are some examples of comparison requirements: ### Multiple version requirements As shown in the examples above, multiple version requirements can be -separated with a comma, e.g., `>= 1.2, < 1.5`. Comma separated requirements -are treated as an intersection, so you cannot _exclude_ a version with -non-overlapping requirements like `<1.2,^1.2.2`. +separated with a comma, e.g., `>= 1.2, < 1.5`. +All requirements must be satisfied, +so non-overlapping requirements like `<1.2, ^1.2.2` result in no matching versions. ### Pre-releases