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

dmaengine: sun4i-dma: Demote obvious misuse of kerneldoc to standard comment blocks

No attempt has been made to document any of the demoted functions here.

Fixes the following W=1 kernel build warning(s):

drivers/dma/sun4i-dma.c:321: warning: Function parameter or member 'priv' not described in '__execute_vchan_pending'
drivers/dma/sun4i-dma.c:321: warning: Function parameter or member 'vchan' not described in '__execute_vchan_pending'
drivers/dma/sun4i-dma.c:435: warning: Function parameter or member 'chan' not described in 'generate_ndma_promise'
drivers/dma/sun4i-dma.c:435: warning: Function parameter or member 'src' not described in 'generate_ndma_promise'
drivers/dma/sun4i-dma.c:435: warning: Function parameter or member 'dest' not described in 'generate_ndma_promise'
drivers/dma/sun4i-dma.c:435: warning: Function parameter or member 'len' not described in 'generate_ndma_promise'
drivers/dma/sun4i-dma.c:435: warning: Function parameter or member 'sconfig' not described in 'generate_ndma_promise'
drivers/dma/sun4i-dma.c:435: warning: Function parameter or member 'direction' not described in 'generate_ndma_promise'
drivers/dma/sun4i-dma.c:501: warning: Function parameter or member 'chan' not described in 'generate_ddma_promise'
drivers/dma/sun4i-dma.c:501: warning: Function parameter or member 'src' not described in 'generate_ddma_promise'
drivers/dma/sun4i-dma.c:501: warning: Function parameter or member 'dest' not described in 'generate_ddma_promise'
drivers/dma/sun4i-dma.c:501: warning: Function parameter or member 'len' not described in 'generate_ddma_promise'
drivers/dma/sun4i-dma.c:501: warning: Function parameter or member 'sconfig' not described in 'generate_ddma_promise'
drivers/dma/sun4i-dma.c:577: warning: Function parameter or member 'contract' not described in 'get_next_cyclic_promise'
drivers/dma/sun4i-dma.c:596: warning: Function parameter or member 'vd' not described in 'sun4i_dma_free_contract'

Signed-off-by: Lee Jones <lee.jones@linaro.org>
Acked-by: Chen-Yu Tsai <wens@csie.org>
Cc: Maxime Ripard <mripard@kernel.org>
Cc: Chen-Yu Tsai <wens@csie.org>
Cc: "Emilio López" <emilio@elopez.com.ar>
Link: https://lore.kernel.org/r/20200714111546.1755231-10-lee.jones@linaro.org
Signed-off-by: Vinod Koul <vkoul@kernel.org>

authored by

Lee Jones and committed by
Vinod Koul
023069ba 21e3cdb0

+6 -6
+6 -6
drivers/dma/sun4i-dma.c
··· 307 307 spin_unlock_irqrestore(&priv->lock, flags); 308 308 } 309 309 310 - /** 310 + /* 311 311 * Execute pending operations on a vchan 312 312 * 313 313 * When given a vchan, this function will try to acquire a suitable ··· 419 419 return 0; 420 420 } 421 421 422 - /** 422 + /* 423 423 * Generate a promise, to be used in a normal DMA contract. 424 424 * 425 425 * A NDMA promise contains all the information required to program the ··· 486 486 return NULL; 487 487 } 488 488 489 - /** 489 + /* 490 490 * Generate a promise, to be used in a dedicated DMA contract. 491 491 * 492 492 * A DDMA promise contains all the information required to program the ··· 543 543 return NULL; 544 544 } 545 545 546 - /** 546 + /* 547 547 * Generate a contract 548 548 * 549 549 * Contracts function as DMA descriptors. As our hardware does not support ··· 565 565 return contract; 566 566 } 567 567 568 - /** 568 + /* 569 569 * Get next promise on a cyclic transfer 570 570 * 571 571 * Cyclic contracts contain a series of promises which are executed on a ··· 589 589 return promise; 590 590 } 591 591 592 - /** 592 + /* 593 593 * Free a contract and all its associated promises 594 594 */ 595 595 static void sun4i_dma_free_contract(struct virt_dma_desc *vd)