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/platform.rs | 5 ----- 1 file changed, 5 deletions(-) (limited to 'crates/shirabe/src/util/platform.rs') diff --git a/crates/shirabe/src/util/platform.rs b/crates/shirabe/src/util/platform.rs index 259d5c95..7b1c8f61 100644 --- a/crates/shirabe/src/util/platform.rs +++ b/crates/shirabe/src/util/platform.rs @@ -58,10 +58,6 @@ impl Platform { } /// getenv() equivalent but reads from the runtime global variables first - /// - /// @param non-empty-string $name - /// - /// @return string|false pub fn get_env(name: &str) -> Option { if let Some(value) = PHP_SERVER.lock().unwrap().get(name) { return Some(value.to_string_lossy().into_owned()); @@ -388,7 +384,6 @@ impl Platform { cached.unwrap_or(false) } - /// @return 'NUL'|'/dev/null' pub fn get_dev_null() -> String { if Self::is_windows() { return "NUL".to_string(); -- cgit v1.3.1