From 93ff92f5da7d2bb5c09a4d1b20aa55eaa0bf997c Mon Sep 17 00:00:00 2001
From: konstin <konstin@mailbox.org>
Date: Wed, 3 Sep 2025 15:50:31 +0200
Subject: [PATCH 1/2] Clarify that `uv auth token` takes a URL

From the previous description I tried `uv auth token pyx`, which didn't work.
---
 crates/uv-cli/src/lib.rs | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/crates/uv-cli/src/lib.rs b/crates/uv-cli/src/lib.rs
index 5e878405d09cf..8115c921e7d01 100644
--- a/crates/uv-cli/src/lib.rs
+++ b/crates/uv-cli/src/lib.rs
@@ -5594,7 +5594,7 @@ pub struct AuthLoginArgs {
 
 #[derive(Args)]
 pub struct AuthTokenArgs {
-    /// The service to lookup.
+    /// The URL of the service to lookup.
     pub service: Service,
 
     /// The username to lookup.
@@ -5612,7 +5612,7 @@ pub struct AuthTokenArgs {
 
 #[derive(Args)]
 pub struct AuthDirArgs {
-    /// The service to lookup.
+    /// The URL of the service to lookup.
     pub service: Option<Service>,
 }
 

From 1af1134ca1d6f0462a508f92ca8c20c53a368ae8 Mon Sep 17 00:00:00 2001
From: Zanie Blue <contact@zanie.dev>
Date: Wed, 3 Sep 2025 09:03:15 -0500
Subject: [PATCH 2/2] Use "domain or URL"

---
 crates/uv-cli/src/lib.rs | 8 ++++----
 docs/reference/cli.md    | 8 ++++----
 2 files changed, 8 insertions(+), 8 deletions(-)

diff --git a/crates/uv-cli/src/lib.rs b/crates/uv-cli/src/lib.rs
index 8115c921e7d01..d0727d3d93c77 100644
--- a/crates/uv-cli/src/lib.rs
+++ b/crates/uv-cli/src/lib.rs
@@ -5538,7 +5538,7 @@ pub struct PythonPinArgs {
 
 #[derive(Args)]
 pub struct AuthLogoutArgs {
-    /// The service to logout of.
+    /// The domain or URL of the service to logout from.
     pub service: Service,
 
     /// The username to logout.
@@ -5559,7 +5559,7 @@ pub struct AuthLogoutArgs {
 
 #[derive(Args)]
 pub struct AuthLoginArgs {
-    /// The service to log into.
+    /// The domain or URL of the service to log into.
     pub service: Service,
 
     /// The username to use for the service.
@@ -5594,7 +5594,7 @@ pub struct AuthLoginArgs {
 
 #[derive(Args)]
 pub struct AuthTokenArgs {
-    /// The URL of the service to lookup.
+    /// The domain or URL of the service to lookup.
     pub service: Service,
 
     /// The username to lookup.
@@ -5612,7 +5612,7 @@ pub struct AuthTokenArgs {
 
 #[derive(Args)]
 pub struct AuthDirArgs {
-    /// The URL of the service to lookup.
+    /// The domain or URL of the service to lookup.
     pub service: Option<Service>,
 }
 
diff --git a/docs/reference/cli.md b/docs/reference/cli.md
index ec49a9ae0aefe..27aa00f8c54b9 100644
--- a/docs/reference/cli.md
+++ b/docs/reference/cli.md
@@ -64,7 +64,7 @@ uv auth login [OPTIONS] <SERVICE>
 
 <h3 class="cli-reference">Arguments</h3>
 
-<dl class="cli-reference"><dt id="uv-auth-login--service"><a href="#uv-auth-login--service"<code>SERVICE</code></a></dt><dd><p>The service to log into</p>
+<dl class="cli-reference"><dt id="uv-auth-login--service"><a href="#uv-auth-login--service"<code>SERVICE</code></a></dt><dd><p>The domain or URL of the service to log into</p>
 </dd></dl>
 
 <h3 class="cli-reference">Options</h3>
@@ -139,7 +139,7 @@ uv auth logout [OPTIONS] <SERVICE>
 
 <h3 class="cli-reference">Arguments</h3>
 
-<dl class="cli-reference"><dt id="uv-auth-logout--service"><a href="#uv-auth-logout--service"<code>SERVICE</code></a></dt><dd><p>The service to logout of</p>
+<dl class="cli-reference"><dt id="uv-auth-logout--service"><a href="#uv-auth-logout--service"<code>SERVICE</code></a></dt><dd><p>The domain or URL of the service to logout from</p>
 </dd></dl>
 
 <h3 class="cli-reference">Options</h3>
@@ -209,7 +209,7 @@ uv auth token [OPTIONS] <SERVICE>
 
 <h3 class="cli-reference">Arguments</h3>
 
-<dl class="cli-reference"><dt id="uv-auth-token--service"><a href="#uv-auth-token--service"<code>SERVICE</code></a></dt><dd><p>The service to lookup</p>
+<dl class="cli-reference"><dt id="uv-auth-token--service"><a href="#uv-auth-token--service"<code>SERVICE</code></a></dt><dd><p>The domain or URL of the service to lookup</p>
 </dd></dl>
 
 <h3 class="cli-reference">Options</h3>
@@ -284,7 +284,7 @@ uv auth dir [OPTIONS] [SERVICE]
 
 <h3 class="cli-reference">Arguments</h3>
 
-<dl class="cli-reference"><dt id="uv-auth-dir--service"><a href="#uv-auth-dir--service"<code>SERVICE</code></a></dt><dd><p>The service to lookup</p>
+<dl class="cli-reference"><dt id="uv-auth-dir--service"><a href="#uv-auth-dir--service"<code>SERVICE</code></a></dt><dd><p>The domain or URL of the service to lookup</p>
 </dd></dl>
 
 <h3 class="cli-reference">Options</h3>