From 3d4a0cadc950d4440251efa11b55b0bfb0afdef7 Mon Sep 17 00:00:00 2001 From: nsfisis Date: Thu, 6 Aug 2026 04:22:46 +0900 Subject: chore: drop @param/@return tags that only restate Rust types The ported docblocks copied @param and @return straight from the PHP source. When such a tag carries nothing but a type and an argument name, the Rust signature already states it, so the line is noise. Tags whose text adds prose beyond the type are kept. Co-Authored-By: Claude Opus 5 (1M context) --- crates/shirabe/src/util/http_downloader.rs | 6 ------ 1 file changed, 6 deletions(-) (limited to 'crates/shirabe/src/util/http_downloader.rs') diff --git a/crates/shirabe/src/util/http_downloader.rs b/crates/shirabe/src/util/http_downloader.rs index 2346c351..b60664da 100644 --- a/crates/shirabe/src/util/http_downloader.rs +++ b/crates/shirabe/src/util/http_downloader.rs @@ -191,8 +191,6 @@ impl HttpDownloader { self.execute(url, options, Some(to), false).await } - /// @phpstan-param non-empty-string $url - /// /// Shared core of `get`/`add`/`copy`/`add_copy`: mock short-circuit, empty-URL guard, the /// sync/allow_async gate, and the concurrency-limiting semaphore permit. Mirrors PHP `addJob` /// up to (but not including) the resolver, which is `dispatch`. @@ -366,8 +364,6 @@ impl HttpDownloader { } /// @internal - /// - /// @param array{warning?: string, info?: string, warning-versions?: string, info-versions?: string, warnings?: array, infos?: array} $data pub fn output_warnings( io: std::rc::Rc>, url: &str, @@ -466,8 +462,6 @@ impl HttpDownloader { } /// @internal - /// - /// @return ?string[] pub fn get_exception_hints(e: &anyhow::Error) -> Option> { let e_as_transport: Option<&TransportException> = e.downcast_ref::(); e_as_transport?; -- cgit v1.3.1