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/cache.rs | 5 ----- 1 file changed, 5 deletions(-) (limited to 'crates/shirabe/src/cache.rs') diff --git a/crates/shirabe/src/cache.rs b/crates/shirabe/src/cache.rs index 2e7ff3cb..354e559e 100644 --- a/crates/shirabe/src/cache.rs +++ b/crates/shirabe/src/cache.rs @@ -124,7 +124,6 @@ impl Cache { &self.root } - /// @return string|false pub fn read(&mut self, file: &str) -> Option { if self.is_enabled() { let file = Preg::replace(format!("{{[^{}]}}i", self.allowlist), "-", file); @@ -344,8 +343,6 @@ impl Cache { false } - /// @return int|false - /// @phpstan-return int<0, max>|false pub fn get_age(&mut self, file: &str) -> Option { if self.is_enabled() { let file = Preg::replace(format!("{{[^{}]}}i", self.allowlist), "-", file); @@ -463,7 +460,6 @@ impl Cache { false } - /// @return string|false pub fn sha1(&mut self, file: &str) -> Option { if self.is_enabled() { let file = Preg::replace(format!("{{[^{}]}}i", self.allowlist), "-", file); @@ -476,7 +472,6 @@ impl Cache { None } - /// @return string|false pub fn sha256(&mut self, file: &str) -> Option { if self.is_enabled() { let file = Preg::replace(format!("{{[^{}]}}i", self.allowlist), "-", file); -- cgit v1.3.1