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/advisory/auditor.rs | 12 ------------
 1 file changed, 12 deletions(-)

(limited to 'crates/shirabe/src/advisory')

diff --git a/crates/shirabe/src/advisory/auditor.rs b/crates/shirabe/src/advisory/auditor.rs
index 853fa36f..d20c9453 100644
--- a/crates/shirabe/src/advisory/auditor.rs
+++ b/crates/shirabe/src/advisory/auditor.rs
@@ -242,9 +242,6 @@ impl Auditor {
         Ok(audit_bitmask)
     }
 
-    /// @param array<string, array<SecurityAdvisory|AnySecurityAdvisory>> $advisories
-    /// @param array<string, string|null> $ignoreList
-    /// @return bool
     pub fn needs_complete_advisory_load(
         &self,
         advisories: &IndexMap<String, Vec<std::rc::Rc<AnySecurityAdvisory>>>,
@@ -272,9 +269,6 @@ impl Auditor {
         array_any(&ignored_ids, |id: &String| !str_starts_with(id, "PKSA-"))
     }
 
-    /// @param array<PackageInterface> $packages
-    /// @param array<string, string|null> $ignoreAbandoned
-    /// @return array<CompletePackageInterface>
     pub fn filter_abandoned_packages(
         &self,
         packages: &[PackageInterfaceHandle],
@@ -409,7 +403,6 @@ impl Auditor {
         (advisories.len() as i64, count)
     }
 
-    /// @param array<string, array<SecurityAdvisory>> $advisories
     /// @param self::FORMAT_* $format The format that will be used to output audit results.
     fn output_advisories(
         &self,
@@ -456,7 +449,6 @@ impl Auditor {
         }
     }
 
-    /// @param array<string, array<SecurityAdvisory>> $advisories
     fn output_advisories_table(
         &self,
         io: &ConsoleIO,
@@ -517,7 +509,6 @@ impl Auditor {
         Ok(())
     }
 
-    /// @param array<string, array<SecurityAdvisory>> $advisories
     fn output_advisories_plain(
         &self,
         io: &std::rc::Rc<std::cell::RefCell<dyn IOInterface>>,
@@ -563,8 +554,6 @@ impl Auditor {
         Ok(())
     }
 
-    /// @param array<CompletePackageInterface> $packages
-    /// @param self::FORMAT_PLAIN|self::FORMAT_TABLE $format
     fn output_abandoned_packages(
         &self,
         io: &std::rc::Rc<std::cell::RefCell<dyn IOInterface>>,
@@ -710,7 +699,6 @@ impl Auditor {
         )
     }
 
-    /// @return int-mask<self::STATUS_*>
     fn calculate_bitmask(
         &self,
         has_vulnerable_packages: bool,
-- 
cgit v1.3.1