From f2126e2d2315630c5bef3e4c9ee6cb3cf4fd0ddb Mon Sep 17 00:00:00 2001
From: Zanie Blue <contact@zanie.dev>
Date: Wed, 18 Dec 2024 14:32:42 -0600
Subject: [PATCH] Fix `uv python install --default` note about multiple
 requests

---
 crates/uv-cli/src/lib.rs   | 3 +--
 crates/uv/tests/it/help.rs | 3 +--
 docs/reference/cli.md      | 2 +-
 3 files changed, 3 insertions(+), 5 deletions(-)

diff --git a/crates/uv-cli/src/lib.rs b/crates/uv-cli/src/lib.rs
index 7609f11549ba..ee5328f01392 100644
--- a/crates/uv-cli/src/lib.rs
+++ b/crates/uv-cli/src/lib.rs
@@ -4354,8 +4354,7 @@ pub struct PythonInstallArgs {
     /// 3.13+freethreaded with `--default` will include in `python3t` and `pythont`, not `python3`
     /// and `python`.
     ///
-    /// If multiple Python versions are requested during the installation, the first request will be
-    /// the default.
+    /// If multiple Python versions are requested, uv will exit with an error.
     #[arg(long)]
     pub default: bool,
 }
diff --git a/crates/uv/tests/it/help.rs b/crates/uv/tests/it/help.rs
index 912e8abd99b2..31e3e02d40cc 100644
--- a/crates/uv/tests/it/help.rs
+++ b/crates/uv/tests/it/help.rs
@@ -540,8 +540,7 @@ fn help_subsubcommand() {
               3.13+freethreaded with `--default` will include in `python3t` and `pythont`, not `python3`
               and `python`.
               
-              If multiple Python versions are requested during the installation, the first request will
-              be the default.
+              If multiple Python versions are requested, uv will exit with an error.
 
     Cache options:
       -n, --no-cache
diff --git a/docs/reference/cli.md b/docs/reference/cli.md
index 9acee6e935d1..12a46675580d 100644
--- a/docs/reference/cli.md
+++ b/docs/reference/cli.md
@@ -4709,7 +4709,7 @@ uv python install [OPTIONS] [TARGETS]...
 
 <p>Alternative Python variants will still include their tag. For example, installing 3.13+freethreaded with <code>--default</code> will include in <code>python3t</code> and <code>pythont</code>, not <code>python3</code> and <code>python</code>.</p>
 
-<p>If multiple Python versions are requested during the installation, the first request will be the default.</p>
+<p>If multiple Python versions are requested, uv will exit with an error.</p>
 
 </dd><dt><code>--directory</code> <i>directory</i></dt><dd><p>Change to the given directory prior to running the command.</p>