Commit ce8df3f4 authored Dec 05, 2023 by Randy Dunlap Committed by Greg Kroah-Hartman Dec 15, 2023

mcb: core: fix kernel-doc warnings

Correct function comments to prevent warnings from
scripts/kernel-doc.

mcb-core.c:270: warning: Function parameter or member 'carrier' not described in 'mcb_alloc_bus'
mcb-core.c:336: warning: expecting prototype for mcb_bus_put(). Prototype was for mcb_bus_get() instead
mcb-core.c:463: warning: Function parameter or member 'mem' not described in 'mcb_release_mem'
mcb-core.c:463: warning: Excess function parameter 'dev' description in 'mcb_release_mem'

Signed-off-by: Randy Dunlap <rdunlap@infradead.org>
Cc: Johannes Thumshirn <morbidrsa@gmail.com>
Cc: Greg Kroah-Hartman <gregkh@linuxfoundation.org>
Link: https://lore.kernel.org/r/20231206055821.17284-1-rdunlap@infradead.org

Signed-off-by: Greg Kroah-Hartman <gregkh@linuxfoundation.org>

parent 3634783b

drivers/mcb/mcb-core.c

+3 −2

Original line number	Diff line number	Diff line
		@@ -263,6 +263,7 @@ static void mcb_free_bus(struct device *dev)

		/**
		* mcb_alloc_bus() - Allocate a new @mcb_bus
		* @carrier: generic &struct device for the carrier device
		*
		* Allocate a new @mcb_bus.
		*/
		@@ -327,7 +328,7 @@ void mcb_release_bus(struct mcb_bus *bus)
		EXPORT_SYMBOL_NS_GPL(mcb_release_bus, MCB);

		/**
		* mcb_bus_put() - Increment refcnt
		* mcb_bus_get() - Increment refcnt
		* @bus: The @mcb_bus
		*
		* Get a @mcb_bus' ref
		@@ -455,7 +456,7 @@ EXPORT_SYMBOL_NS_GPL(mcb_request_mem, MCB);

		/**
		* mcb_release_mem() - Release memory requested by device
		* @dev: The @mcb_device that requested the memory
		* @mem: The memory resource to be released
		*
		* Release memory that was prior requested via @mcb_request_mem().
		*/