[PATCH v3] soc: fsl: fix kernel-doc warnings and typos

[PATCH v3] soc: fsl: fix kernel-doc warnings and typos

[Randy Dunlap]

Correct spelling of "list".

Fix a kernel-doc warning by describing the nested structure completely:

include/soc/fsl/dpaa2-fd.h:52: warning: Function parameter or member 'simple' not described in 'dpaa2_fd'

Signed-off-by: Randy Dunlap <rdunlap@infradead.org>
Cc: Li Yang <leoyang.li@nxp.com>
Cc: linuxppc-dev@lists.ozlabs.org
Cc: linux-arm-kernel@lists.infradead.org
Cc: Frank Li <Frank.Li@nxp.com>
Cc: Guanhua Gao <guanhua.gao@nxp.com>
Cc: Roy Pledge <Roy.Pledge@nxp.com>
---
v2:  update Cc: list, rebase
v3:  rebase & resend

 include/soc/fsl/dpaa2-fd.h |   19 ++++++++++---------
 1 file changed, 10 insertions(+), 9 deletions(-)

--- linux-next-20260727.orig/include/soc/fsl/dpaa2-fd.h
+++ linux-next-20260727/include/soc/fsl/dpaa2-fd.h
@@ -25,14 +25,15 @@
 
 /**
  * struct dpaa2_fd - Struct describing FDs
- * @words:         for easier/faster copying the whole FD structure
- * @addr:          address in the FD
- * @len:           length in the FD
- * @bpid:          buffer pool ID
- * @format_offset: format, offset, and short-length fields
- * @frc:           frame context
- * @ctrl:          control bits...including dd, sc, va, err, etc
- * @flc:           flow context address
+ * @words:                for easier/faster copying the whole FD structure
+ * @simple:               struct for the FD fields
+ * @simple.addr:          address in the FD
+ * @simple.len:           length in the FD
+ * @simple.bpid:          buffer pool ID
+ * @simple.format_offset: format, offset, and short-length fields
+ * @simple.frc:           frame context
+ * @simple.ctrl:          control bits...including dd, sc, va, err, etc
+ * @simple.flc:           flow context address
  *
  * This structure represents the basic Frame Descriptor used in the system.
  */
@@ -497,7 +498,7 @@ static inline void dpaa2_fl_set_addr(str
  * dpaa2_fl_get_frc() - Get the frame context in the FLE
  * @fle: the given frame list entry
  *
- * Return the frame context field in the frame lsit entry.
+ * Return the frame context field in the frame list entry.
  */
 static inline u32 dpaa2_fl_get_frc(const struct dpaa2_fl_entry *fle)
 {

Re: [PATCH v3] soc: fsl: fix kernel-doc warnings and typos

[Ioana Ciornei]

On Mon, Jul 27, 2026 at 05:49:24PM -0700, Randy Dunlap wrote:
> Correct spelling of "list".
> 
> Fix a kernel-doc warning by describing the nested structure completely:
> 
> include/soc/fsl/dpaa2-fd.h:52: warning: Function parameter or member 'simple' not described in 'dpaa2_fd'
> 
> Signed-off-by: Randy Dunlap <rdunlap@infradead.org>

Reviewed-by: Ioana Ciornei <ioana.ciornei@nxp.com>

Re: [PATCH v3] soc: fsl: fix kernel-doc warnings and typos

[Christophe Leroy (CS GROUP)]

On Mon, 27 Jul 2026 17:49:24 -0700, Randy Dunlap wrote:
> Correct spelling of "list".
> 
> Fix a kernel-doc warning by describing the nested structure completely:
> 
> include/soc/fsl/dpaa2-fd.h:52: warning: Function parameter or member 'simple' not described in 'dpaa2_fd'
> 
> 
> [...]

Applied, thanks!

[1/1] soc: fsl: fix kernel-doc warnings and typos
      commit: 2c1e7396f54c39ff0591b15fede6813cc85f5f9f

Best regards,
-- 
Christophe Leroy (CS GROUP) <chleroy@kernel.org>