• Randy Dunlap's avatar
    rapidio/tsi721: fix kernel-doc warnings · 4600c4bc
    Randy Dunlap authored
    Correct kernel-doc comments in tsi721.c and tsi721_dma.c to prevent
    warnings from scripts/kernel-doc.
    
    tsi721_dma.c:293: warning: expecting prototype for tsi721_omsg_msix(). Prototype was for tsi721_bdma_msix() instead
    
    tsi721.c:215: warning: Function parameter or member 'data' not described in 'tsi721_cread_dma'
    tsi721.c:215: warning: Excess function parameter 'val' description in 'tsi721_cread_dma'
    tsi721.c:238: warning: Function parameter or member 'data' not described in 'tsi721_cwrite_dma'
    tsi721.c:238: warning: Excess function parameter 'val' description in 'tsi721_cwrite_dma'
    tsi721.c:2548: warning: Function parameter or member 'attr' not described in 'tsi721_query_mport'
    tsi721.c:2548: warning: Excess function parameter 'mbox' description in 'tsi721_query_mport'
    and 27 warnings like this one:
    tsi721.c:59: warning: No description found for return value of 'tsi721_lcread'
    
    Link: https://lkml.kernel.org/r/20231206175528.16386-1-rdunlap@infradead.org
    
    Signed-off-by: default avatarRandy Dunlap <rdunlap@infradead.org>
    Cc: Matt Porter <mporter@kernel.crashing.org>
    Cc: Alexandre Bounine <alex.bou9@gmail.com>
    Signed-off-by: default avatarAndrew Morton <akpm@linux-foundation.org>
    4600c4bc
tsi721.c 81.7 KB