parisc: pdc_chassis: Fix kdoc warnings
authorHelge Deller <deller@gmx.de>
Fri, 30 Jun 2023 10:28:40 +0000 (12:28 +0200)
committerHelge Deller <deller@gmx.de>
Fri, 30 Jun 2023 15:14:14 +0000 (17:14 +0200)
Signed-off-by: Helge Deller <deller@gmx.de>
arch/parisc/kernel/pdc_chassis.c

index da154406d368d7d2bbd0d045a931ea9637aa92c7..0a9d7008ef2a9ae04f46bc4ed639b2208044ceb3 100644 (file)
@@ -40,7 +40,7 @@ static unsigned int pdc_chassis_enabled __read_mostly = 1;
 
 /**
  * pdc_chassis_setup() - Enable/disable pdc_chassis code at boot time.
- * @str configuration param: 0 to disable chassis log
+ * @str: configuration param: 0 to disable chassis log
  * @return 1
  */
  
@@ -55,7 +55,6 @@ __setup("pdcchassis=", pdc_chassis_setup);
 
 /** 
  * pdc_chassis_checkold() - Checks for old PDC_CHASSIS compatibility
- * @pdc_chassis_old: 1 if old pdc chassis style
  * 
  * Currently, only E class and A180 are known to work with this.
  * Inspired by Christoph Plattner
@@ -80,6 +79,9 @@ static void __init pdc_chassis_checkold(void)
 
 /**
  * pdc_chassis_panic_event() - Called by the panic handler.
+ * @this: unused
+ * @event: unused
+ * @ptr: unused
  *
  * As soon as a panic occurs, we should inform the PDC.
  */
@@ -88,7 +90,7 @@ static int pdc_chassis_panic_event(struct notifier_block *this,
                        unsigned long event, void *ptr)
 {
        pdc_chassis_send_status(PDC_CHASSIS_DIRECT_PANIC);
-               return NOTIFY_DONE;
+       return NOTIFY_DONE;
 }   
 
 
@@ -99,7 +101,10 @@ static struct notifier_block pdc_chassis_panic_block = {
 
 
 /**
- * parisc_reboot_event() - Called by the reboot handler.
+ * pdc_chassis_reboot_event() - Called by the reboot handler.
+ * @this: unused
+ * @event: unused
+ * @ptr: unused
  *
  * As soon as a reboot occurs, we should inform the PDC.
  */
@@ -108,7 +113,7 @@ static int pdc_chassis_reboot_event(struct notifier_block *this,
                        unsigned long event, void *ptr)
 {
        pdc_chassis_send_status(PDC_CHASSIS_DIRECT_SHUTDOWN);
-               return NOTIFY_DONE;
+       return NOTIFY_DONE;
 }   
 
 
@@ -148,7 +153,7 @@ void __init parisc_pdc_chassis_init(void)
 /** 
  * pdc_chassis_send_status() - Sends a predefined message to the chassis,
  * and changes the front panel LEDs according to the new system state
- * @retval: PDC call return value.
+ * @message: Type of message, one of PDC_CHASSIS_DIRECT_* values.
  *
  * Only machines with 64 bits PDC PAT and those reported in
  * pdc_chassis_checkold() are supported atm.