[PATCH v2] mtd: docg3: fix kernel-doc warnings

Randy Dunlap posted 1 patch 2 weeks ago
drivers/mtd/devices/docg3.h |    2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
[PATCH v2] mtd: docg3: fix kernel-doc warnings
Posted by Randy Dunlap 2 weeks ago
Fix kernel-doc warnings in docg3.h to avoid build warnings:

Warning: ../drivers/mtd/devices/docg3.h:276 bad line:
Warning: drivers/mtd/devices/docg3.h:299 struct member 'max_block' not
 described in 'docg3'

Signed-off-by: Randy Dunlap <rdunlap@infradead.org>
---
v2: remove extraneous "and" in patch description;
    drop the blank kernel-doc line (Miquel)

Cc: Robert Jarzmik <robert.jarzmik@free.fr>
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
---
 drivers/mtd/devices/docg3.h |    2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

--- linux-next-20251114.orig/drivers/mtd/devices/docg3.h
+++ linux-next-20251114/drivers/mtd/devices/docg3.h
@@ -274,11 +274,11 @@ struct docg3_cascade {
  * @cascade: the cascade this device belongs to
  * @device_id: number of the cascaded DoCG3 device (0, 1, 2 or 3)
  * @if_cfg: if true, reads are on 16bits, else reads are on 8bits
-
  * @reliable: if 0, docg3 in normal mode, if 1 docg3 in fast mode, if 2 in
  *            reliable mode
  *            Fast mode implies more errors than normal mode.
  *            Reliable mode implies that page 2*n and 2*n+1 are clones.
+ * @max_block: maximum block number for this device
  * @bbt: bad block table cache
  * @oob_write_ofs: offset of the MTD where this OOB should belong (ie. in next
  *                 page_write)
Re: [PATCH v2] mtd: docg3: fix kernel-doc warnings
Posted by Miquel Raynal 2 days, 13 hours ago
On Mon, 17 Nov 2025 11:30:45 -0800, Randy Dunlap wrote:
> Fix kernel-doc warnings in docg3.h to avoid build warnings:
> 
> Warning: ../drivers/mtd/devices/docg3.h:276 bad line:
> Warning: drivers/mtd/devices/docg3.h:299 struct member 'max_block' not
>  described in 'docg3'
> 
> 
> [...]

Applied to mtd/next, thanks!

[1/1] mtd: docg3: fix kernel-doc warnings
      commit: 1cce5a5ecafeb8a79aa9165cf134c97da7bbc7db

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