drm: fix new kernel-doc warnings
Subsystems (2)
PATCH 1/1 drm: fix new kernel-doc warnings
From: Randy Dunlap <[email protected]>
Fix new kernel-doc warnings in drm_edid.c: convert doxygen(?) to kernel-doc to match the rest of the file's documentation.
Warning(drivers/gpu/drm/drm_edid.c:997): No description found for parameter 'adapter' Warning(drivers/gpu/drm/drm_edid.c:997): No description found for parameter 'buf' Warning(drivers/gpu/drm/drm_edid.c:997): No description found for parameter 'block' Warning(drivers/gpu/drm/drm_edid.c:997): No description found for parameter 'len' Warning(drivers/gpu/drm/drm_edid.c:1138): No description found for parameter 'adapter' Warning(drivers/gpu/drm/drm_edid.c:1467): No description found for parameter 'connector' Warning(drivers/gpu/drm/drm_edid.c:1467): No description found for parameter 'edid' Warning(drivers/gpu/drm/drm_edid.c:1467): No description found for parameter 'revision' Warning(drivers/gpu/drm/drm_edid.c:1467): Excess function parameter 'timing_level' description in 'drm_mode_std' Warning(drivers/gpu/drm/drm_edid.c:2010): No description found for parameter 'connector' Warning(drivers/gpu/drm/drm_edid.c:2072): No description found for parameter 'connector' Warning(drivers/gpu/drm/drm_edid.c:2237): No description found for parameter 'edid' Warning(drivers/gpu/drm/drm_edid.c:2616): No description found for parameter 'edid' Warning(drivers/gpu/drm/drm_edid.c:2658): No description found for parameter 'edid'
--- drivers/gpu/drm/drm_edid.c | 30 +++++++++++++++++++----------- 1 file changed, 19 insertions(+), 11 deletions(-)
drivers/gpu/drm/drm_edid.c +19 -11
@@ -982,12 +982,13 @@ EXPORT_SYMBOL(drm_edid_is_valid);#define DDC_SEGMENT_ADDR 0x30/** -* Get EDID information via I2C. +* drm_do_probe_ddc_edid - Get EDID information via I2C. * -* \param adapter : i2c device adaptor -* \param buf : EDID data buffer to be filled -* \param len : EDID data buffer length -* \return 0 on success or -1 on failure. +* @adapter : i2c device adaptor +* @buf : EDID data buffer to be filled +* @block : block number +* @len : EDID data buffer length +* return : 0 on success or -1 on failure. * * Try to fetch EDID information by calling i2c driver function. */
@@ -1128,10 +1129,10 @@ out: }/** -* Probe DDC presence. +* drm_probe_ddc - Probe DDC presence. * -* \param adapter : i2c device adaptor -* \return 1 on success +* @adapter : i2c device adaptor +* return : 1 on success */ bool drm_probe_ddc (struct i2c_adapter *adapter)
@@ -1455,8 +1456,10 @@ bad_std_timing(u8 a, u8 b)/** * drm_mode_std - convert standard mode info (width, height, refresh) into mode +* @connector: attached connector +* @edid: EDID block * @t: standard timing params -* @timing_level: standard timing level +* @revision: EDID revision * * Take the standard timing params (in this case width, aspect, and refresh) * and convert them into a real mode using CVT/GTF/DMT.
@@ -1999,7 +2002,8 @@ do_established_modes(struct detailed_tim }/** -* add_established_modes - get est. modes from EDID and add them +* add_established_modes - get established modes from EDID and add them +* @connector: attached connector * @edid: EDID block to scan * * Each EDID block contains a bitmap of the supported "established modes" list
@@ -2062,6 +2066,7 @@ do_standard_modes(struct detailed_timing/** * add_standard_modes - get std. modes from EDID and add them +* @connector: attached connector * @edid: EDID block to scan * * Standard modes can be calculated using the appropriate standard (DMT,
@@ -2231,7 +2236,8 @@ add_detailed_modes(struct drm_connector#define EDID_CEA_VCDB_QS (1 << 6)/** -* Search EDID for CEA extension block. +* drm_find_cea_extension - Search EDID for CEA extension block. +* @edid: EDID block to search */ u8 *drm_find_cea_extension (struct edid *edid) {
@@ -2604,6 +2610,7 @@ EXPORT_SYMBOL(drm_detect_hdmi_monitor);/** * drm_detect_monitor_audio - check monitor audio capability +* @edid: EDID block * * Monitor should have CEA extension block. * If monitor has 'basic audio', but no CEA audio blocks, it's 'basic
@@ -2649,6 +2656,7 @@ EXPORT_SYMBOL(drm_detect_monitor_audio);/** * drm_rgb_quant_range_selectable - is RGB quantization range selectable? +* @edid: EDID block * * Check whether the monitor reports the RGB quantization range selection * as supported. The AVI infoframe can then be used to inform the monitor
Quoted 4 lines · Randy Dunlap
From: Randy Dunlap <[email protected]>
Fix new kernel-doc warnings in
drm_edid.c: convert doxygen(?) to kernel-doc to match the rest of the file's documentation.
I've been feeding this stuff through [email protected]. (I just got my kernel.org account re-enabled yesterday, and hope to set up a tree to feed into linux-next this weekend, but this is probably still trivial@ material anyway since it's scattered around the tree outside of the documentation directory.)
Rob