soc: ti: k3-ringacc: Fixup documentation errors
Nishanth Menon
maintainerPATCH v2 1/1 soc: ti: k3-ringacc: Fixup documentation errors
Fixup couple of misses in documentation. This squashes the following
warnings:drivers/soc/ti/k3-ringacc.c:135: warning: Function parameter or member 'tdown_complete' not described in 'k3_ring_state' drivers/soc/ti/k3-ringacc.c:238: warning: expecting prototype for struct k3_ringacc. Prototype was for struct k3_ringacc_soc_data instead
While at this, replace "w/a" to indicate workaround to help clarify.
---
Changes since V1:
* Fixedup a couple of places where "w/a" is used - replaced with "workaround" to indicate quirk workaround
* Picked up Randy's Reviewed-by.
V1: https://lore.kernel.org/all/[email protected]/
drivers/soc/ti/k3-ringacc.c | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-)
drivers/soc/ti/k3-ringacc.c +4 -3
@@ -125,6 +125,7 @@ struct k3_ring_ops {* @occ: Occupancy * @windex: Write index * @rindex: Read index +* @tdown_complete: Tear down complete state */ struct k3_ring_state {u32 free;
@@ -192,7 +193,7 @@ struct k3_ringacc_ops {* @num_rings: number of ring in RA * @rings_inuse: bitfield for ring usage tracking * @rm_gp_range: general purpose rings range from tisci -* @dma_ring_reset_quirk: DMA reset w/a enable +* @dma_ring_reset_quirk: DMA reset workaround enable * @num_proxies: number of RA proxies * @proxy_inuse: bitfield for proxy usage tracking * @rings: array of rings descriptors (struct @k3_ring)
@@ -229,9 +230,9 @@ struct k3_ringacc { };/** -* struct k3_ringacc - Rings accelerator SoC data +* struct k3_ringacc_soc_data - Rings accelerator SoC data * -* @dma_ring_reset_quirk: DMA reset w/a enable +* @dma_ring_reset_quirk: DMA reset workaround enable */ struct k3_ringacc_soc_data {unsigned dma_ring_reset_quirk:1 ;
Signature · 1 line
2.40.0
Quoted 7 lines · Nishanth Menon
Fixup couple of misses in documentation. This squashes the following
warnings:drivers/soc/ti/k3-ringacc.c:135: warning: Function parameter or member 'tdown_complete' not described in 'k3_ring_state'drivers/soc/ti/k3-ringacc.c:238: warning: expecting prototype for structk3_ringacc. Prototype was for structk3_ringacc_soc_datainsteadWhile at this, replace "w/a" to indicate workaround to help clarify.
Quoted 7 lines
Cc Peter Ujfalusi <[email protected]>Reviewed-by Randy Dunlap <[email protected]>Signed-off-by Nishanth Menon <[email protected]>---
Changes since V1:
* Fixedup a couple of places where "w/a" is used - replaced with "workaround" to indicate quirk workaround
Thanks for that. Good change.
Quoted 40 lines
* Picked up Randy's Reviewed-by.
V1: https://lore.kernel.org/all/[email protected]/
drivers/soc/ti/k3-ringacc.c | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-)drivers/soc/ti/k3-ringacc.c +4
-3@@ -125,6 +125,7 @@ struct k3_ring_ops {* @occ: Occupancy * @windex: Write index * @rindex: Read index +* @tdown_complete: Tear down complete state */ struct k3_ring_state {u32 free;@@ -192,7 +193,7 @@ struct k3_ringacc_ops {* @num_rings: number of ring in RA * @rings_inuse: bitfield for ring usage tracking * @rm_gp_range: general purpose rings range from tisci -* @dma_ring_reset_quirk: DMA reset w/a enable +* @dma_ring_reset_quirk: DMA reset workaround enable * @num_proxies: number of RA proxies * @proxy_inuse: bitfield for proxy usage tracking * @rings: array of rings descriptors (struct @k3_ring) @@ -229,9 +230,9 @@ struct k3_ringacc { };/** -* struct k3_ringacc - Rings accelerator SoC data +* struct k3_ringacc_soc_data - Rings accelerator SoC data * -* @dma_ring_reset_quirk: DMA reset w/a enable +* @dma_ring_reset_quirk: DMA reset workaround enable */ struct k3_ringacc_soc_data {unsigned dma_ring_reset_quirk:1 ;
Signature · 1 line
~Randy
Hi Nishanth Menon,
Quoted 8 lines · Nishanth Menon
Fixup couple of misses in documentation. This squashes the following
warnings:drivers/soc/ti/k3-ringacc.c:135: warning: Function parameter or member 'tdown_complete' not described in 'k3_ring_state'drivers/soc/ti/k3-ringacc.c:238: warning: expecting prototype for structk3_ringacc. Prototype was for structk3_ringacc_soc_datainsteadWhile at this, replace "w/a" to indicate workaround to help clarify.
[...]
I have applied the following to branch ti-drivers-soc-next on [1]. Thank you!
[1/1] soc: ti: k3-ringacc: Fixup documentation errors
commit: bffd3a805d8eb7a61e31eebb99bf089cf2229079
All being well this means that it will be integrated into the linux-next tree (usually sometime in the next 24 hours) and sent up the chain during the next merge window (or sooner if it is a relevant bug fix), however if problems are discovered then the patch may be dropped or reverted.
You may get further e-mails resulting from automated or manual testing and review of the tree, please engage with people reporting problems and send followup patches addressing any issues that are reported if needed.
If any updates are required or you are submitting further changes they should be sent as incremental updates against current git, existing patches will not be replaced.
Please add any relevant lists and maintainers to the CCs when replying to this mail.
[1] git://git.kernel.org/pub/scm/linux/kernel/git/ti/linux.git
Signature · 3 lines
Regards, Nishanth Menon Key (0xDDB5849D1736249D) / Fingerprint: F8A2 8693 54EB 8232 17A3 1A34 DDB5 849D 1736 249D