Correct most kernel-doc warnings in include/linux/mtd/spear_smi.h
by adding a leading '@' to the description of struct members.
Add a new description for the missing @np member.

Warning: spear_smi.h:48 struct member 'name' not described
 in 'spear_smi_flash_info'
Warning: spear_smi.h:48 struct member 'mem_base' not described
 in 'spear_smi_flash_info'
Warning: spear_smi.h:48 struct member 'size' not described
 in 'spear_smi_flash_info'
Warning: spear_smi.h:48 struct member 'partitions' not described
 in 'spear_smi_flash_info'
Warning: spear_smi.h:48 struct member 'nr_partitions' not described
 in 'spear_smi_flash_info'
Warning: spear_smi.h:48 struct member 'fast_mode' not described
 in 'spear_smi_flash_info'
Warning: spear_smi.h:62 struct member 'clk_rate' not described
 in 'spear_smi_plat_data'
Warning: spear_smi.h:62 struct member 'num_flashes' not described
 in 'spear_smi_plat_data'
Warning: spear_smi.h:62 struct member 'board_flash_info' not described
 in 'spear_smi_plat_data'
Warning: spear_smi.h:62 struct member 'np' not described
 in 'spear_smi_plat_data'

Signed-off-by: Randy Dunlap <rdunlap@infradead.org>
---
Cc: Miquel Raynal <miquel.raynal@bootlin.com>
Cc: Richard Weinberger <richard@nod.at>
Cc: Vignesh Raghavendra <vigneshr@ti.com>
Cc: linux-mtd@lists.infradead.org
---
 include/linux/mtd/spear_smi.h |   19 ++++++++++---------
 1 file changed, 10 insertions(+), 9 deletions(-)

--- linux-next-20251029.orig/include/linux/mtd/spear_smi.h
+++ linux-next-20251029/include/linux/mtd/spear_smi.h
@@ -31,12 +31,12 @@
  * struct spear_smi_flash_info - platform structure for passing flash
  * information
  *
- * name: name of the serial nor flash for identification
- * mem_base: the memory base on which the flash is mapped
- * size: size of the flash in bytes
- * partitions: parition details
- * nr_partitions: number of partitions
- * fast_mode: whether flash supports fast mode
+ * @name: name of the serial nor flash for identification
+ * @mem_base: the memory base on which the flash is mapped
+ * @size: size of the flash in bytes
+ * @partitions: parition details
+ * @nr_partitions: number of partitions
+ * @fast_mode: whether flash supports fast mode
  */
 
 struct spear_smi_flash_info {
@@ -51,9 +51,10 @@ struct spear_smi_flash_info {
 /**
  * struct spear_smi_plat_data - platform structure for configuring smi
  *
- * clk_rate: clk rate at which SMI must operate
- * num_flashes: number of flashes present on board
- * board_flash_info: specific details of each flash present on board
+ * @clk_rate: clk rate at which SMI must operate
+ * @num_flashes: number of flashes present on board
+ * @board_flash_info: specific details of each flash present on board
+ * @np: array of DT node pointers for all possible flash chip devices
  */
 struct spear_smi_plat_data {
 	unsigned long clk_rate;

On Thu, 30 Oct 2025 22:41:18 -0700, Randy Dunlap wrote:
> Correct most kernel-doc warnings in include/linux/mtd/spear_smi.h
> by adding a leading '@' to the description of struct members.
> Add a new description for the missing @np member.
> 
> Warning: spear_smi.h:48 struct member 'name' not described
>  in 'spear_smi_flash_info'
> Warning: spear_smi.h:48 struct member 'mem_base' not described
>  in 'spear_smi_flash_info'
> Warning: spear_smi.h:48 struct member 'size' not described
>  in 'spear_smi_flash_info'
> Warning: spear_smi.h:48 struct member 'partitions' not described
>  in 'spear_smi_flash_info'
> Warning: spear_smi.h:48 struct member 'nr_partitions' not described
>  in 'spear_smi_flash_info'
> Warning: spear_smi.h:48 struct member 'fast_mode' not described
>  in 'spear_smi_flash_info'
> Warning: spear_smi.h:62 struct member 'clk_rate' not described
>  in 'spear_smi_plat_data'
> Warning: spear_smi.h:62 struct member 'num_flashes' not described
>  in 'spear_smi_plat_data'
> Warning: spear_smi.h:62 struct member 'board_flash_info' not described
>  in 'spear_smi_plat_data'
> Warning: spear_smi.h:62 struct member 'np' not described
>  in 'spear_smi_plat_data'
> 
> [...]

Applied to mtd/next, thanks!

[1/1] mtd: spear_smi: fix kernel-doc warnings <linux/mtd/spear_smi.h>
      commit: c95de73da12bf4586b7bcd6b23a6968c21991cc7

Patche(s) should be available on mtd/linux.git and will be
part of the next PR (provided that no robot complains by then).

Kind regards,
Miquèl