Linux-Watchdog Archive on lore.kernel.org
 help / color / Atom feed
* [PATCH] watchdog: fix syntactic kernel-doc issues
@ 2021-03-22  6:53 Lukas Bulwahn
  2021-03-22 14:04 ` Guenter Roeck
  0 siblings, 1 reply; 3+ messages in thread
From: Lukas Bulwahn @ 2021-03-22  6:53 UTC (permalink / raw)
  To: Wim Van Sebroeck, Guenter Roeck, linux-watchdog
  Cc: Tomas Winkler, linux-doc, kernel-janitors, linux-kernel, Lukas Bulwahn

The command 'find drivers/watchdog | xargs ./scripts/kernel-doc -none'
reports a number of kernel-doc warnings in the watchdog subsystem.

Address the kernel-doc warnings that were purely syntactic issues with
kernel-doc comments.

The remaining kernel-doc warnings are of type "Excess function parameter"
and "Function parameter or member not described". These warnings would
need to be addressed in a second pass with a bit more insight into the
APIs and purpose of the functions in the watchdog subsystem.

Signed-off-by: Lukas Bulwahn <lukas.bulwahn@gmail.com>
---
Guenter, Wim, please pick this minor clean-up patch.

 drivers/watchdog/booke_wdt.c       |  2 +-
 drivers/watchdog/eurotechwdt.c     |  2 +-
 drivers/watchdog/mei_wdt.c         |  8 ++++----
 drivers/watchdog/octeon-wdt-main.c | 12 +++++++-----
 drivers/watchdog/pc87413_wdt.c     |  2 +-
 drivers/watchdog/wdt.c             |  4 ++--
 drivers/watchdog/wdt_pci.c         |  2 +-
 7 files changed, 17 insertions(+), 15 deletions(-)

diff --git a/drivers/watchdog/booke_wdt.c b/drivers/watchdog/booke_wdt.c
index 7817fb976f9c..5e4dc1a0f2c6 100644
--- a/drivers/watchdog/booke_wdt.c
+++ b/drivers/watchdog/booke_wdt.c
@@ -148,7 +148,7 @@ static void __booke_wdt_enable(void *data)
 }
 
 /**
- * booke_wdt_disable - disable the watchdog on the given CPU
+ * __booke_wdt_disable - disable the watchdog on the given CPU
  *
  * This function is called on each CPU.  It disables the watchdog on that CPU.
  *
diff --git a/drivers/watchdog/eurotechwdt.c b/drivers/watchdog/eurotechwdt.c
index 2418ebb707bd..ce682942662c 100644
--- a/drivers/watchdog/eurotechwdt.c
+++ b/drivers/watchdog/eurotechwdt.c
@@ -392,7 +392,7 @@ static struct notifier_block eurwdt_notifier = {
 };
 
 /**
- * cleanup_module:
+ * eurwdt_exit:
  *
  * Unload the watchdog. You cannot do this with any file handles open.
  * If your watchdog is set to continue ticking on close and you unload
diff --git a/drivers/watchdog/mei_wdt.c b/drivers/watchdog/mei_wdt.c
index e023d7d90d66..c7a7235e6224 100644
--- a/drivers/watchdog/mei_wdt.c
+++ b/drivers/watchdog/mei_wdt.c
@@ -105,7 +105,7 @@ struct mei_wdt {
 #endif /* CONFIG_DEBUG_FS */
 };
 
-/*
+/**
  * struct mei_mc_hdr - Management Control Command Header
  *
  * @command: Management Control (0x2)
@@ -121,7 +121,7 @@ struct mei_mc_hdr {
 };
 
 /**
- * struct mei_wdt_start_request watchdog start/ping
+ * struct mei_wdt_start_request - watchdog start/ping
  *
  * @hdr: Management Control Command Header
  * @timeout: timeout value
@@ -134,7 +134,7 @@ struct mei_wdt_start_request {
 } __packed;
 
 /**
- * struct mei_wdt_start_response watchdog start/ping response
+ * struct mei_wdt_start_response - watchdog start/ping response
  *
  * @hdr: Management Control Command Header
  * @status: operation status
@@ -474,7 +474,7 @@ static void mei_wdt_rx(struct mei_cl_device *cldev)
 		complete(&wdt->response);
 }
 
-/*
+/**
  * mei_wdt_notif - callback for event notification
  *
  * @cldev: bus device
diff --git a/drivers/watchdog/octeon-wdt-main.c b/drivers/watchdog/octeon-wdt-main.c
index fde9e739b436..298c070884c4 100644
--- a/drivers/watchdog/octeon-wdt-main.c
+++ b/drivers/watchdog/octeon-wdt-main.c
@@ -119,7 +119,7 @@ static int cpu2core(int cpu)
 }
 
 /**
- * Poke the watchdog when an interrupt is received
+ * octeon_wdt_poke_irq - Poke the watchdog when an interrupt is received
  *
  * @cpl:
  * @dev_id:
@@ -153,7 +153,7 @@ static irqreturn_t octeon_wdt_poke_irq(int cpl, void *dev_id)
 extern int prom_putchar(char c);
 
 /**
- * Write a string to the uart
+ * octeon_wdt_write_string - Write a string to the uart
  *
  * @str:        String to write
  */
@@ -165,7 +165,7 @@ static void octeon_wdt_write_string(const char *str)
 }
 
 /**
- * Write a hex number out of the uart
+ * octeon_wdt_write_hex() - Write a hex number out of the uart
  *
  * @value:      Number to display
  * @digits:     Number of digits to print (1 to 16)
@@ -192,6 +192,8 @@ static const char reg_name[][3] = {
 };
 
 /**
+ * octeon_wdt_nmi_stage3:
+ *
  * NMI stage 3 handler. NMIs are handled in the following manner:
  * 1) The first NMI handler enables CVMSEG and transfers from
  * the bootbus region into normal memory. It is careful to not
@@ -513,7 +515,7 @@ static struct watchdog_device octeon_wdt = {
 
 static enum cpuhp_state octeon_wdt_online;
 /**
- * Module/ driver initialization.
+ * octeon_wdt_init - Module/ driver initialization.
  *
  * Returns Zero on success
  */
@@ -585,7 +587,7 @@ static int __init octeon_wdt_init(void)
 }
 
 /**
- * Module / driver shutdown
+ * octeon_wdt_cleanup - Module / driver shutdown
  */
 static void __exit octeon_wdt_cleanup(void)
 {
diff --git a/drivers/watchdog/pc87413_wdt.c b/drivers/watchdog/pc87413_wdt.c
index 2d4504302c9e..9f9a340427fc 100644
--- a/drivers/watchdog/pc87413_wdt.c
+++ b/drivers/watchdog/pc87413_wdt.c
@@ -445,7 +445,7 @@ static long pc87413_ioctl(struct file *file, unsigned int cmd,
 /* -- Notifier funtions -----------------------------------------*/
 
 /**
- *	notify_sys:
+ *	pc87413_notify_sys:
  *	@this: our notifier block
  *	@code: the event being reported
  *	@unused: unused
diff --git a/drivers/watchdog/wdt.c b/drivers/watchdog/wdt.c
index a9e40b5c633e..183876156243 100644
--- a/drivers/watchdog/wdt.c
+++ b/drivers/watchdog/wdt.c
@@ -494,7 +494,7 @@ static int wdt_temp_release(struct inode *inode, struct file *file)
 }
 
 /**
- *	notify_sys:
+ *	wdt_notify_sys:
  *	@this: our notifier block
  *	@code: the event being reported
  *	@unused: unused
@@ -558,7 +558,7 @@ static struct notifier_block wdt_notifier = {
 };
 
 /**
- *	cleanup_module:
+ *	wdt_exit:
  *
  *	Unload the watchdog. You cannot do this with any file handles open.
  *	If your watchdog is set to continue ticking on close and you unload
diff --git a/drivers/watchdog/wdt_pci.c b/drivers/watchdog/wdt_pci.c
index c3254ba5ace6..d5e56b601351 100644
--- a/drivers/watchdog/wdt_pci.c
+++ b/drivers/watchdog/wdt_pci.c
@@ -537,7 +537,7 @@ static int wdtpci_temp_release(struct inode *inode, struct file *file)
 }
 
 /**
- *	notify_sys:
+ *	wdtpci_notify_sys:
  *	@this: our notifier block
  *	@code: the event being reported
  *	@unused: unused
-- 
2.17.1


^ permalink raw reply	[flat|nested] 3+ messages in thread

* Re: [PATCH] watchdog: fix syntactic kernel-doc issues
  2021-03-22  6:53 [PATCH] watchdog: fix syntactic kernel-doc issues Lukas Bulwahn
@ 2021-03-22 14:04 ` Guenter Roeck
  2021-03-22 18:53   ` Winkler, Tomas
  0 siblings, 1 reply; 3+ messages in thread
From: Guenter Roeck @ 2021-03-22 14:04 UTC (permalink / raw)
  To: Lukas Bulwahn, Wim Van Sebroeck, linux-watchdog
  Cc: Tomas Winkler, linux-doc, kernel-janitors, linux-kernel

On 3/21/21 11:53 PM, Lukas Bulwahn wrote:
> The command 'find drivers/watchdog | xargs ./scripts/kernel-doc -none'
> reports a number of kernel-doc warnings in the watchdog subsystem.
> 
> Address the kernel-doc warnings that were purely syntactic issues with
> kernel-doc comments.
> 
> The remaining kernel-doc warnings are of type "Excess function parameter"
> and "Function parameter or member not described". These warnings would
> need to be addressed in a second pass with a bit more insight into the
> APIs and purpose of the functions in the watchdog subsystem.
> 
> Signed-off-by: Lukas Bulwahn <lukas.bulwahn@gmail.com>

Reviewed-by: Guenter Roeck <linux@roeck-us.net>

> ---
> Guenter, Wim, please pick this minor clean-up patch.
> 
>  drivers/watchdog/booke_wdt.c       |  2 +-
>  drivers/watchdog/eurotechwdt.c     |  2 +-
>  drivers/watchdog/mei_wdt.c         |  8 ++++----
>  drivers/watchdog/octeon-wdt-main.c | 12 +++++++-----
>  drivers/watchdog/pc87413_wdt.c     |  2 +-
>  drivers/watchdog/wdt.c             |  4 ++--
>  drivers/watchdog/wdt_pci.c         |  2 +-
>  7 files changed, 17 insertions(+), 15 deletions(-)
> 
> diff --git a/drivers/watchdog/booke_wdt.c b/drivers/watchdog/booke_wdt.c
> index 7817fb976f9c..5e4dc1a0f2c6 100644
> --- a/drivers/watchdog/booke_wdt.c
> +++ b/drivers/watchdog/booke_wdt.c
> @@ -148,7 +148,7 @@ static void __booke_wdt_enable(void *data)
>  }
>  
>  /**
> - * booke_wdt_disable - disable the watchdog on the given CPU
> + * __booke_wdt_disable - disable the watchdog on the given CPU
>   *
>   * This function is called on each CPU.  It disables the watchdog on that CPU.
>   *
> diff --git a/drivers/watchdog/eurotechwdt.c b/drivers/watchdog/eurotechwdt.c
> index 2418ebb707bd..ce682942662c 100644
> --- a/drivers/watchdog/eurotechwdt.c
> +++ b/drivers/watchdog/eurotechwdt.c
> @@ -392,7 +392,7 @@ static struct notifier_block eurwdt_notifier = {
>  };
>  
>  /**
> - * cleanup_module:
> + * eurwdt_exit:
>   *
>   * Unload the watchdog. You cannot do this with any file handles open.
>   * If your watchdog is set to continue ticking on close and you unload
> diff --git a/drivers/watchdog/mei_wdt.c b/drivers/watchdog/mei_wdt.c
> index e023d7d90d66..c7a7235e6224 100644
> --- a/drivers/watchdog/mei_wdt.c
> +++ b/drivers/watchdog/mei_wdt.c
> @@ -105,7 +105,7 @@ struct mei_wdt {
>  #endif /* CONFIG_DEBUG_FS */
>  };
>  
> -/*
> +/**
>   * struct mei_mc_hdr - Management Control Command Header
>   *
>   * @command: Management Control (0x2)
> @@ -121,7 +121,7 @@ struct mei_mc_hdr {
>  };
>  
>  /**
> - * struct mei_wdt_start_request watchdog start/ping
> + * struct mei_wdt_start_request - watchdog start/ping
>   *
>   * @hdr: Management Control Command Header
>   * @timeout: timeout value
> @@ -134,7 +134,7 @@ struct mei_wdt_start_request {
>  } __packed;
>  
>  /**
> - * struct mei_wdt_start_response watchdog start/ping response
> + * struct mei_wdt_start_response - watchdog start/ping response
>   *
>   * @hdr: Management Control Command Header
>   * @status: operation status
> @@ -474,7 +474,7 @@ static void mei_wdt_rx(struct mei_cl_device *cldev)
>  		complete(&wdt->response);
>  }
>  
> -/*
> +/**
>   * mei_wdt_notif - callback for event notification
>   *
>   * @cldev: bus device
> diff --git a/drivers/watchdog/octeon-wdt-main.c b/drivers/watchdog/octeon-wdt-main.c
> index fde9e739b436..298c070884c4 100644
> --- a/drivers/watchdog/octeon-wdt-main.c
> +++ b/drivers/watchdog/octeon-wdt-main.c
> @@ -119,7 +119,7 @@ static int cpu2core(int cpu)
>  }
>  
>  /**
> - * Poke the watchdog when an interrupt is received
> + * octeon_wdt_poke_irq - Poke the watchdog when an interrupt is received
>   *
>   * @cpl:
>   * @dev_id:
> @@ -153,7 +153,7 @@ static irqreturn_t octeon_wdt_poke_irq(int cpl, void *dev_id)
>  extern int prom_putchar(char c);
>  
>  /**
> - * Write a string to the uart
> + * octeon_wdt_write_string - Write a string to the uart
>   *
>   * @str:        String to write
>   */
> @@ -165,7 +165,7 @@ static void octeon_wdt_write_string(const char *str)
>  }
>  
>  /**
> - * Write a hex number out of the uart
> + * octeon_wdt_write_hex() - Write a hex number out of the uart
>   *
>   * @value:      Number to display
>   * @digits:     Number of digits to print (1 to 16)
> @@ -192,6 +192,8 @@ static const char reg_name[][3] = {
>  };
>  
>  /**
> + * octeon_wdt_nmi_stage3:
> + *
>   * NMI stage 3 handler. NMIs are handled in the following manner:
>   * 1) The first NMI handler enables CVMSEG and transfers from
>   * the bootbus region into normal memory. It is careful to not
> @@ -513,7 +515,7 @@ static struct watchdog_device octeon_wdt = {
>  
>  static enum cpuhp_state octeon_wdt_online;
>  /**
> - * Module/ driver initialization.
> + * octeon_wdt_init - Module/ driver initialization.
>   *
>   * Returns Zero on success
>   */
> @@ -585,7 +587,7 @@ static int __init octeon_wdt_init(void)
>  }
>  
>  /**
> - * Module / driver shutdown
> + * octeon_wdt_cleanup - Module / driver shutdown
>   */
>  static void __exit octeon_wdt_cleanup(void)
>  {
> diff --git a/drivers/watchdog/pc87413_wdt.c b/drivers/watchdog/pc87413_wdt.c
> index 2d4504302c9e..9f9a340427fc 100644
> --- a/drivers/watchdog/pc87413_wdt.c
> +++ b/drivers/watchdog/pc87413_wdt.c
> @@ -445,7 +445,7 @@ static long pc87413_ioctl(struct file *file, unsigned int cmd,
>  /* -- Notifier funtions -----------------------------------------*/
>  
>  /**
> - *	notify_sys:
> + *	pc87413_notify_sys:
>   *	@this: our notifier block
>   *	@code: the event being reported
>   *	@unused: unused
> diff --git a/drivers/watchdog/wdt.c b/drivers/watchdog/wdt.c
> index a9e40b5c633e..183876156243 100644
> --- a/drivers/watchdog/wdt.c
> +++ b/drivers/watchdog/wdt.c
> @@ -494,7 +494,7 @@ static int wdt_temp_release(struct inode *inode, struct file *file)
>  }
>  
>  /**
> - *	notify_sys:
> + *	wdt_notify_sys:
>   *	@this: our notifier block
>   *	@code: the event being reported
>   *	@unused: unused
> @@ -558,7 +558,7 @@ static struct notifier_block wdt_notifier = {
>  };
>  
>  /**
> - *	cleanup_module:
> + *	wdt_exit:
>   *
>   *	Unload the watchdog. You cannot do this with any file handles open.
>   *	If your watchdog is set to continue ticking on close and you unload
> diff --git a/drivers/watchdog/wdt_pci.c b/drivers/watchdog/wdt_pci.c
> index c3254ba5ace6..d5e56b601351 100644
> --- a/drivers/watchdog/wdt_pci.c
> +++ b/drivers/watchdog/wdt_pci.c
> @@ -537,7 +537,7 @@ static int wdtpci_temp_release(struct inode *inode, struct file *file)
>  }
>  
>  /**
> - *	notify_sys:
> + *	wdtpci_notify_sys:
>   *	@this: our notifier block
>   *	@code: the event being reported
>   *	@unused: unused
> 


^ permalink raw reply	[flat|nested] 3+ messages in thread

* RE: [PATCH] watchdog: fix syntactic kernel-doc issues
  2021-03-22 14:04 ` Guenter Roeck
@ 2021-03-22 18:53   ` Winkler, Tomas
  0 siblings, 0 replies; 3+ messages in thread
From: Winkler, Tomas @ 2021-03-22 18:53 UTC (permalink / raw)
  To: Guenter Roeck, Lukas Bulwahn, Wim Van Sebroeck, linux-watchdog
  Cc: linux-doc, kernel-janitors, linux-kernel

> On 3/21/21 11:53 PM, Lukas Bulwahn wrote:
> > The command 'find drivers/watchdog | xargs ./scripts/kernel-doc -none'
> > reports a number of kernel-doc warnings in the watchdog subsystem.
> >
> > Address the kernel-doc warnings that were purely syntactic issues with
> > kernel-doc comments.
> >
> > The remaining kernel-doc warnings are of type "Excess function
> parameter"
> > and "Function parameter or member not described". These warnings
> would
> > need to be addressed in a second pass with a bit more insight into the
> > APIs and purpose of the functions in the watchdog subsystem.
> >
> > Signed-off-by: Lukas Bulwahn <lukas.bulwahn@gmail.com>
> 
> Reviewed-by: Guenter Roeck <linux@roeck-us.net>
Ack for mei_wdt 
Tomas

> 
> > ---
> > Guenter, Wim, please pick this minor clean-up patch.
> >
> >  drivers/watchdog/booke_wdt.c       |  2 +-
> >  drivers/watchdog/eurotechwdt.c     |  2 +-
> >  drivers/watchdog/mei_wdt.c         |  8 ++++----
> >  drivers/watchdog/octeon-wdt-main.c | 12 +++++++-----
> >  drivers/watchdog/pc87413_wdt.c     |  2 +-
> >  drivers/watchdog/wdt.c             |  4 ++--
> >  drivers/watchdog/wdt_pci.c         |  2 +-
> >  7 files changed, 17 insertions(+), 15 deletions(-)
> >
> > diff --git a/drivers/watchdog/booke_wdt.c
> > b/drivers/watchdog/booke_wdt.c index 7817fb976f9c..5e4dc1a0f2c6
> 100644
> > --- a/drivers/watchdog/booke_wdt.c
> > +++ b/drivers/watchdog/booke_wdt.c
> > @@ -148,7 +148,7 @@ static void __booke_wdt_enable(void *data)  }
> >
> >  /**
> > - * booke_wdt_disable - disable the watchdog on the given CPU
> > + * __booke_wdt_disable - disable the watchdog on the given CPU
> >   *
> >   * This function is called on each CPU.  It disables the watchdog on that
> CPU.
> >   *
> > diff --git a/drivers/watchdog/eurotechwdt.c
> > b/drivers/watchdog/eurotechwdt.c index 2418ebb707bd..ce682942662c
> > 100644
> > --- a/drivers/watchdog/eurotechwdt.c
> > +++ b/drivers/watchdog/eurotechwdt.c
> > @@ -392,7 +392,7 @@ static struct notifier_block eurwdt_notifier = {
> > };
> >
> >  /**
> > - * cleanup_module:
> > + * eurwdt_exit:
> >   *
> >   * Unload the watchdog. You cannot do this with any file handles open.
> >   * If your watchdog is set to continue ticking on close and you
> > unload diff --git a/drivers/watchdog/mei_wdt.c
> > b/drivers/watchdog/mei_wdt.c index e023d7d90d66..c7a7235e6224 100644
> > --- a/drivers/watchdog/mei_wdt.c
> > +++ b/drivers/watchdog/mei_wdt.c
> > @@ -105,7 +105,7 @@ struct mei_wdt {
> >  #endif /* CONFIG_DEBUG_FS */
> >  };
> >
> > -/*
> > +/**
> >   * struct mei_mc_hdr - Management Control Command Header
> >   *
> >   * @command: Management Control (0x2) @@ -121,7 +121,7 @@ struct
> > mei_mc_hdr {  };
> >
> >  /**
> > - * struct mei_wdt_start_request watchdog start/ping
> > + * struct mei_wdt_start_request - watchdog start/ping
> >   *
> >   * @hdr: Management Control Command Header
> >   * @timeout: timeout value
> > @@ -134,7 +134,7 @@ struct mei_wdt_start_request {  } __packed;
> >
> >  /**
> > - * struct mei_wdt_start_response watchdog start/ping response
> > + * struct mei_wdt_start_response - watchdog start/ping response
> >   *
> >   * @hdr: Management Control Command Header
> >   * @status: operation status
> > @@ -474,7 +474,7 @@ static void mei_wdt_rx(struct mei_cl_device *cldev)
> >  		complete(&wdt->response);
> >  }
> >
> > -/*
> > +/**
> >   * mei_wdt_notif - callback for event notification
> >   *
> >   * @cldev: bus device
> > diff --git a/drivers/watchdog/octeon-wdt-main.c
> > b/drivers/watchdog/octeon-wdt-main.c
> > index fde9e739b436..298c070884c4 100644
> > --- a/drivers/watchdog/octeon-wdt-main.c
> > +++ b/drivers/watchdog/octeon-wdt-main.c
> > @@ -119,7 +119,7 @@ static int cpu2core(int cpu)  }
> >
> >  /**
> > - * Poke the watchdog when an interrupt is received
> > + * octeon_wdt_poke_irq - Poke the watchdog when an interrupt is
> > + received
> >   *
> >   * @cpl:
> >   * @dev_id:
> > @@ -153,7 +153,7 @@ static irqreturn_t octeon_wdt_poke_irq(int cpl,
> > void *dev_id)  extern int prom_putchar(char c);
> >
> >  /**
> > - * Write a string to the uart
> > + * octeon_wdt_write_string - Write a string to the uart
> >   *
> >   * @str:        String to write
> >   */
> > @@ -165,7 +165,7 @@ static void octeon_wdt_write_string(const char
> > *str)  }
> >
> >  /**
> > - * Write a hex number out of the uart
> > + * octeon_wdt_write_hex() - Write a hex number out of the uart
> >   *
> >   * @value:      Number to display
> >   * @digits:     Number of digits to print (1 to 16)
> > @@ -192,6 +192,8 @@ static const char reg_name[][3] = {  };
> >
> >  /**
> > + * octeon_wdt_nmi_stage3:
> > + *
> >   * NMI stage 3 handler. NMIs are handled in the following manner:
> >   * 1) The first NMI handler enables CVMSEG and transfers from
> >   * the bootbus region into normal memory. It is careful to not @@
> > -513,7 +515,7 @@ static struct watchdog_device octeon_wdt = {
> >
> >  static enum cpuhp_state octeon_wdt_online;
> >  /**
> > - * Module/ driver initialization.
> > + * octeon_wdt_init - Module/ driver initialization.
> >   *
> >   * Returns Zero on success
> >   */
> > @@ -585,7 +587,7 @@ static int __init octeon_wdt_init(void)  }
> >
> >  /**
> > - * Module / driver shutdown
> > + * octeon_wdt_cleanup - Module / driver shutdown
> >   */
> >  static void __exit octeon_wdt_cleanup(void)  { diff --git
> > a/drivers/watchdog/pc87413_wdt.c b/drivers/watchdog/pc87413_wdt.c
> > index 2d4504302c9e..9f9a340427fc 100644
> > --- a/drivers/watchdog/pc87413_wdt.c
> > +++ b/drivers/watchdog/pc87413_wdt.c
> > @@ -445,7 +445,7 @@ static long pc87413_ioctl(struct file *file,
> > unsigned int cmd,
> >  /* -- Notifier funtions -----------------------------------------*/
> >
> >  /**
> > - *	notify_sys:
> > + *	pc87413_notify_sys:
> >   *	@this: our notifier block
> >   *	@code: the event being reported
> >   *	@unused: unused
> > diff --git a/drivers/watchdog/wdt.c b/drivers/watchdog/wdt.c index
> > a9e40b5c633e..183876156243 100644
> > --- a/drivers/watchdog/wdt.c
> > +++ b/drivers/watchdog/wdt.c
> > @@ -494,7 +494,7 @@ static int wdt_temp_release(struct inode *inode,
> > struct file *file)  }
> >
> >  /**
> > - *	notify_sys:
> > + *	wdt_notify_sys:
> >   *	@this: our notifier block
> >   *	@code: the event being reported
> >   *	@unused: unused
> > @@ -558,7 +558,7 @@ static struct notifier_block wdt_notifier = {  };
> >
> >  /**
> > - *	cleanup_module:
> > + *	wdt_exit:
> >   *
> >   *	Unload the watchdog. You cannot do this with any file handles open.
> >   *	If your watchdog is set to continue ticking on close and you unload
> > diff --git a/drivers/watchdog/wdt_pci.c b/drivers/watchdog/wdt_pci.c
> > index c3254ba5ace6..d5e56b601351 100644
> > --- a/drivers/watchdog/wdt_pci.c
> > +++ b/drivers/watchdog/wdt_pci.c
> > @@ -537,7 +537,7 @@ static int wdtpci_temp_release(struct inode
> > *inode, struct file *file)  }
> >
> >  /**
> > - *	notify_sys:
> > + *	wdtpci_notify_sys:
> >   *	@this: our notifier block
> >   *	@code: the event being reported
> >   *	@unused: unused
> >


^ permalink raw reply	[flat|nested] 3+ messages in thread

end of thread, back to index

Thread overview: 3+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2021-03-22  6:53 [PATCH] watchdog: fix syntactic kernel-doc issues Lukas Bulwahn
2021-03-22 14:04 ` Guenter Roeck
2021-03-22 18:53   ` Winkler, Tomas

Linux-Watchdog Archive on lore.kernel.org

Archives are clonable:
	git clone --mirror https://lore.kernel.org/linux-watchdog/0 linux-watchdog/git/0.git

	# If you have public-inbox 1.1+ installed, you may
	# initialize and index your mirror using the following commands:
	public-inbox-init -V2 linux-watchdog linux-watchdog/ https://lore.kernel.org/linux-watchdog \
		linux-watchdog@vger.kernel.org
	public-inbox-index linux-watchdog

Example config snippet for mirrors

Newsgroup available over NNTP:
	nntp://nntp.lore.kernel.org/org.kernel.vger.linux-watchdog


AGPL code for this site: git clone https://public-inbox.org/public-inbox.git