diff --git a/crates/uv-cli/src/lib.rs b/crates/uv-cli/src/lib.rs index 677e143a426b..90be37866101 100644 --- a/crates/uv-cli/src/lib.rs +++ b/crates/uv-cli/src/lib.rs @@ -4805,10 +4805,10 @@ pub struct PublishArgs { /// /// Before uploading, the index is checked. If the exact same file already exists in the index, /// the file will not be uploaded. If an error occurred during the upload, the index is checked - /// again, if the file may have been added in the meantime. + /// again, to handle cases where the identical file was uploaded twice in parallel. /// - /// The exact behavior varies from index to index. On PyPI, uploading the same file succeeds - /// even without `--skip-existing`, while most other indexes error. + /// The exact behavior will vary based on the index. When uploading to PyPI, uploading the same + /// file succeeds even without `--skip-existing`, while most other indexes error. /// /// The index must provide one of the supported hashes (SHA-256, SHA-384, or SHA-512). #[arg(long,env = EnvVars::UV_PUBLISH_SKIP_EXISTING)] diff --git a/docs/reference/cli.md b/docs/reference/cli.md index 07a0c9985f5a..3882f5c70062 100644 --- a/docs/reference/cli.md +++ b/docs/reference/cli.md @@ -7689,9 +7689,9 @@ uv publish [OPTIONS] [FILES]...

This option allows retrying publishing that failed after only some, but not all files have been uploaded, and handles error due to parallel uploads of the same file.

-

Before uploading, the index is checked. If the exact same file already exists in the index, the file will not be uploaded. If an error occurred during the upload, the index is checked again, if the file may have been added in the meantime.

+

Before uploading, the index is checked. If the exact same file already exists in the index, the file will not be uploaded. If an error occurred during the upload, the index is checked again, to handle cases where the identical file was uploaded twice in parallel.

-

The exact behavior varies from index to index. On PyPI, uploading the same file succeeds even without --skip-existing, while most other indexes error.

+

The exact behavior will vary based on the index. When uploading to PyPI, uploading the same file succeeds even without --skip-existing, while most other indexes error.

The index must provide one of the supported hashes (SHA-256, SHA-384, or SHA-512).