From 3d4a0cadc950d4440251efa11b55b0bfb0afdef7 Mon Sep 17 00:00:00 2001
From: nsfisis <nsfisis@gmail.com>
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) <noreply@anthropic.com>
---
 crates/shirabe/src/command/base_command.rs | 9 ---------
 1 file changed, 9 deletions(-)

(limited to 'crates/shirabe/src/command/base_command.rs')

diff --git a/crates/shirabe/src/command/base_command.rs b/crates/shirabe/src/command/base_command.rs
index f9682de9..41b8d0f8 100644
--- a/crates/shirabe/src/command/base_command.rs
+++ b/crates/shirabe/src/command/base_command.rs
@@ -211,23 +211,16 @@ pub trait BaseCommand: Command {
         input: std::rc::Rc<std::cell::RefCell<dyn InputInterface>>,
     ) -> anyhow::Result<std::rc::Rc<dyn PlatformRequirementFilterInterface>>;
 
-    /// @param array<string> $requirements
-    ///
-    /// @return array<string, string>
     fn format_requirements(
         &self,
         requirements: Vec<String>,
     ) -> anyhow::Result<IndexMap<String, String>>;
 
-    /// @param array<string> $requirements
-    ///
-    /// @return list<array{name: string, version?: string}>
     fn normalize_requirements(
         &self,
         requirements: Vec<String>,
     ) -> anyhow::Result<Vec<IndexMap<String, String>>>;
 
-    /// @param array<TableSeparator|mixed[]> $table
     fn render_table(
         &self,
         table: Vec<PhpMixed>,
@@ -237,8 +230,6 @@ pub trait BaseCommand: Command {
     fn get_terminal_width(&self) -> i64;
 
     /// @internal
-    /// @param 'format'|'audit-format' $optName
-    /// @return Auditor::FORMAT_*
     fn get_audit_format(
         &self,
         input: std::rc::Rc<std::cell::RefCell<dyn InputInterface>>,
-- 
cgit v1.3.1