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/package/locker.rs | 6 ------
 1 file changed, 6 deletions(-)

(limited to 'crates/shirabe/src/package/locker.rs')

diff --git a/crates/shirabe/src/package/locker.rs b/crates/shirabe/src/package/locker.rs
index d2d1b109..f06f2bdc 100644
--- a/crates/shirabe/src/package/locker.rs
+++ b/crates/shirabe/src/package/locker.rs
@@ -339,7 +339,6 @@ impl Locker {
         Ok(requirements.into_iter().map(|(_, v)| v).collect())
     }
 
-    /// @return key-of<BasePackage::STABILITIES>
     pub fn get_minimum_stability(&mut self) -> anyhow::Result<String> {
         let lock_data = self.get_lock_data()?;
 
@@ -382,7 +381,6 @@ impl Locker {
         Ok(lock_data.get("prefer-lowest").and_then(|v| v.as_bool()))
     }
 
-    /// @return array<string, string>
     pub fn get_platform_overrides(&mut self) -> anyhow::Result<IndexMap<String, String>> {
         let lock_data = self.get_lock_data()?;
 
@@ -399,7 +397,6 @@ impl Locker {
             .unwrap_or_default())
     }
 
-    /// @return string[][]
     pub fn get_aliases(&mut self) -> anyhow::Result<Vec<IndexMap<String, String>>> {
         let lock_data = self.get_lock_data()?;
 
@@ -435,7 +432,6 @@ impl Locker {
             .to_string())
     }
 
-    /// @return array<string, mixed>
     pub fn get_lock_data(&mut self) -> anyhow::Result<IndexMap<String, PhpMixed>> {
         if let Some(cache) = self.lock_data_cache.borrow().clone() {
             return Ok(cache);
@@ -719,7 +715,6 @@ impl Locker {
         lock_data
     }
 
-    /// @param PackageInterface[] $packages
     fn lock_packages(&mut self, packages: &[PackageInterfaceHandle]) -> anyhow::Result<PhpMixed> {
         let mut locked: Vec<IndexMap<String, PhpMixed>> = vec![];
 
@@ -891,7 +886,6 @@ impl Locker {
         Ok(datetime.map(|d| d.format(DATE_RFC3339).to_string()))
     }
 
-    /// @return array<string>
     pub fn get_missing_requirement_info(
         &mut self,
         package: RootPackageInterfaceHandle,
-- 
cgit v1.3.1