Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux

dmaengine: Fix dma_async_tx_descriptor->tx_submit documentation

Commit 790fb9956eea ("linux/dmaengine.h: fix a few kernel-doc
warnings") inserted new documentation for @desc_free in the middle of
@tx_submit's description.

Put @tx_submit's description back together, matching the indentation
style of the rest of the documentation for dma_async_tx_descriptor.

Fixes: 790fb9956eea ("linux/dmaengine.h: fix a few kernel-doc warnings")
Reviewed-by: Dave Jiang <dave.jiang@intel.com>
Signed-off-by: Nathan Lynch <nathan.lynch@amd.com>
Link: https://lore.kernel.org/r/20250826-dma_async_tx_desc-tx_submit-doc-fix-v1-1-18a4b51697db@amd.com
Signed-off-by: Vinod Koul <vkoul@kernel.org>

authored by

Nathan Lynch and committed by
Vinod Koul
7ea95d55 38433a6f

+1 -1
+1 -1
include/linux/dmaengine.h
··· 594 594 * @phys: physical address of the descriptor 595 595 * @chan: target channel for this operation 596 596 * @tx_submit: accept the descriptor, assign ordered cookie and mark the 597 + * descriptor pending. To be pushed on .issue_pending() call 597 598 * @desc_free: driver's callback function to free a resusable descriptor 598 599 * after completion 599 - * descriptor pending. To be pushed on .issue_pending() call 600 600 * @callback: routine to call after this operation is complete 601 601 * @callback_result: error result from a DMA transaction 602 602 * @callback_param: general parameter to pass to the callback routine