From ad1702be4648343bb209ec7f8648f057deb482bd Mon Sep 17 00:00:00 2001
From: Matt Friedman <maf675@gmail.com>
Date: Wed, 12 Aug 2026 15:35:13 -0700
Subject: [PATCH] Fix inconsistent doc blocks

---
 controller/base.php                  | 14 +++++++-------
 controller/idea_controller.php       |  2 +-
 controller/index_controller.php      |  2 +-
 controller/list_controller.php       |  2 +-
 controller/livesearch_controller.php |  2 +-
 event/listener.php                   | 12 ++++++------
 factory/base.php                     |  6 +++---
 factory/linkhelper.php               |  4 ++--
 8 files changed, 22 insertions(+), 22 deletions(-)

diff --git a/controller/base.php b/controller/base.php
index 53f30077..56e6d3c9 100644
--- a/controller/base.php
+++ b/controller/base.php
@@ -25,31 +25,31 @@ abstract class base
 	/** @var auth */
 	protected $auth;
 
-	/* @var config */
+	/** @var config */
 	protected $config;
 
-	/* @var helper */
+	/** @var helper */
 	protected $helper;
 
-	/* @var \phpbb\ideas\factory\base */
+	/** @var \phpbb\ideas\factory\base */
 	protected $entity;
 
 	/** @var language  */
 	protected $language;
 
-	/* @var linkhelper */
+	/** @var linkhelper */
 	protected $link_helper;
 
 	/** @var pagination */
 	protected $pagination;
 
-	/* @var request */
+	/** @var request */
 	protected $request;
 
-	/* @var template */
+	/** @var template */
 	protected $template;
 
-	/* @var user */
+	/** @var user */
 	protected $user;
 
 	/** @var string */
diff --git a/controller/idea_controller.php b/controller/idea_controller.php
index 294a902b..dfb2dd8f 100644
--- a/controller/idea_controller.php
+++ b/controller/idea_controller.php
@@ -20,7 +20,7 @@ class idea_controller extends base
 	/** @var array of idea data */
 	protected $data;
 
-	/* @var \phpbb\ideas\factory\idea */
+	/** @var \phpbb\ideas\factory\idea */
 	protected $entity;
 
 	/**
diff --git a/controller/index_controller.php b/controller/index_controller.php
index a01f4998..bf420961 100644
--- a/controller/index_controller.php
+++ b/controller/index_controller.php
@@ -15,7 +15,7 @@
 
 class index_controller extends base
 {
-	/* @var \phpbb\ideas\factory\ideas */
+	/** @var \phpbb\ideas\factory\ideas */
 	protected $entity;
 
 	/**
diff --git a/controller/list_controller.php b/controller/list_controller.php
index 3465574d..b0839523 100644
--- a/controller/list_controller.php
+++ b/controller/list_controller.php
@@ -15,7 +15,7 @@
 
 class list_controller extends base
 {
-	/* @var \phpbb\ideas\factory\ideas */
+	/** @var \phpbb\ideas\factory\ideas */
 	protected $entity;
 
 	/**
diff --git a/controller/livesearch_controller.php b/controller/livesearch_controller.php
index 0d77dabb..198c7aba 100644
--- a/controller/livesearch_controller.php
+++ b/controller/livesearch_controller.php
@@ -15,7 +15,7 @@
  */
 class livesearch_controller extends base
 {
-	/* @var \phpbb\ideas\factory\livesearch */
+	/** @var \phpbb\ideas\factory\livesearch */
 	protected $entity;
 
 	/**
diff --git a/event/listener.php b/event/listener.php
index 36038951..7ee8c97d 100644
--- a/event/listener.php
+++ b/event/listener.php
@@ -26,25 +26,25 @@ class listener implements EventSubscriberInterface
 	/** @var auth */
 	protected $auth;
 
-	/* @var config */
+	/** @var config */
 	protected $config;
 
-	/* @var helper */
+	/** @var helper */
 	protected $helper;
 
-	/* @var idea */
+	/** @var idea */
 	protected $idea;
 
 	/** @var language */
 	protected $language;
 
-	/* @var linkhelper */
+	/** @var linkhelper */
 	protected $link_helper;
 
-	/* @var template */
+	/** @var template */
 	protected $template;
 
-	/* @var user */
+	/** @var user */
 	protected $user;
 
 	/** @var string */
diff --git a/factory/base.php b/factory/base.php
index 397b1a80..2f5b1ce3 100644
--- a/factory/base.php
+++ b/factory/base.php
@@ -25,10 +25,10 @@ class base
 	/** @var auth */
 	protected $auth;
 
-	/* @var config */
+	/** @var config */
 	protected $config;
 
-	/* @var driver_interface */
+	/** @var driver_interface */
 	protected $db;
 
 	/** @var language */
@@ -37,7 +37,7 @@ class base
 	/** @var notification_manager */
 	protected $notification_manager;
 
-	/* @var user */
+	/** @var user */
 	protected $user;
 
 	/** @var string */
diff --git a/factory/linkhelper.php b/factory/linkhelper.php
index 0d30f32d..a103681b 100644
--- a/factory/linkhelper.php
+++ b/factory/linkhelper.php
@@ -18,10 +18,10 @@
  */
 class linkhelper
 {
-	/* @var helper */
+	/** @var helper */
 	protected $helper;
 
-	/* @var user_loader */
+	/** @var user_loader */
 	protected $user_loader;
 
 	/**