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

Configure Feed

Select the types of activity you want to include in your feed.

drm/bridge: fix kdoc syntax

Use the correct kdoc syntax for bullet list.

Fixes kdoc error and warning:

Documentation/gpu/drm-kms-helpers:197: ./drivers/gpu/drm/drm_bridge.c:1519: ERROR: Unexpected indentation. [docutils]
Documentation/gpu/drm-kms-helpers:197: ./drivers/gpu/drm/drm_bridge.c:1521: WARNING: Block quote ends without a blank line; unexpected unindent. [docutils]

Reported-by: kernel test robot <lkp@intel.com>
Closes: https://lore.kernel.org/oe-kbuild-all/202512302319.1PGGt3CN-lkp@intel.com/
Fixes: 9da0e06abda8 ("drm/bridge: deprecate of_drm_find_bridge()")
Reviewed-by: Nicolas Frattaroli <nicolas.frattaroli@collabora.com>
Link: https://patch.msgid.link/20251231-drm-bridge-alloc-getput-drm_of_find_bridge-kdoc-fix-v1-1-193a03f0609c@bootlin.com
Signed-off-by: Luca Ceresoli <luca.ceresoli@bootlin.com>

Luca Ceresoli 68b271a3 95d628c9

+3
+3
drivers/gpu/drm/drm_bridge.c
··· 1518 1518 * The bridge returned by this function is not refcounted. This is 1519 1519 * dangerous because the bridge might be deallocated even before the caller 1520 1520 * has a chance to use it. To use this function you have to do one of: 1521 + * 1521 1522 * - get a reference with drm_bridge_get() as soon as possible to 1522 1523 * minimize the race window, and then drm_bridge_put() when no longer 1523 1524 * using the pointer 1525 + * 1524 1526 * - not call drm_bridge_get() or drm_bridge_put() at all, which used to 1525 1527 * be the correct practice before dynamic bridge lifetime was introduced 1528 + * 1526 1529 * - again, convert to of_drm_find_and_get_bridge(), which is the only safe 1527 1530 * thing to do 1528 1531 *