Commit fc66811c authored by Simona Vetter's avatar Simona Vetter
Browse files

drm/doc: Fix up kerneldoc in drm_edid.c 



v2: Also do s/RETURNS/Returns/, less yelling in docs is always good.

Reviewed-by: default avatarAlex Deucher <alexander.deucher@amd.com>
Signed-off-by: default avatarDaniel Vetter <daniel.vetter@ffwll.ch>
parent 065a5027

drivers/gpu/drm/drm_edid.c

+19 −7
Original line number Diff line number Diff line
@@ -1098,10 +1098,14 @@ EXPORT_SYMBOL(drm_edid_is_valid); 
/**

 * 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: 128 byte EDID block to start fetching from

 * @len: EDID data buffer length to fetch

 *

 * Returns:

 *

 * 0 on success or -1 on failure.

 *

 * Try to fetch EDID information by calling i2c driver function.

 */
@@ -1243,9 +1247,11 @@ drm_do_get_edid(struct drm_connector *connector, struct i2c_adapter *adapter) 


/**

 * Probe DDC presence.

 * @adapter: i2c adapter to probe

 *

 * Returns:

 *

 * \param adapter : i2c device adaptor

 * \return 1 on success

 * 1 on success

 */

bool

drm_probe_ddc(struct i2c_adapter *adapter)
@@ -1586,8 +1592,10 @@ bad_std_timing(u8 a, u8 b) 


/**

 * drm_mode_std - convert standard mode info (width, height, refresh) into mode

 * @connector: connector of for the EDID block

 * @edid: EDID block to scan

 * @t: standard timing params

 * @timing_level: standard timing level

 * @revision: standard timing level

 *

 * Take the standard timing params (in this case width, aspect, and refresh)

 * and convert them into a real mode using CVT/GTF/DMT.
@@ -2132,6 +2140,7 @@ do_established_modes(struct detailed_timing *timing, void *c) 


/**

 * add_established_modes - get est. modes from EDID and add them

 * @connector: connector of for the EDID block

 * @edid: EDID block to scan

 *

 * Each EDID block contains a bitmap of the supported "established modes" list
@@ -2194,6 +2203,7 @@ do_standard_modes(struct detailed_timing *timing, void *c) 


/**

 * add_standard_modes - get std. modes from EDID and add them

 * @connector: connector of for the EDID block

 * @edid: EDID block to scan

 *

 * Standard modes can be calculated using the appropriate standard (DMT,
@@ -3300,6 +3310,7 @@ EXPORT_SYMBOL(drm_detect_hdmi_monitor); 


/**

 * drm_detect_monitor_audio - check monitor audio capability

 * @edid: EDID block to scan

 *

 * Monitor should have CEA extension block.

 * If monitor has 'basic audio', but no CEA audio blocks, it's 'basic
@@ -3345,6 +3356,7 @@ EXPORT_SYMBOL(drm_detect_monitor_audio); 


/**

 * drm_rgb_quant_range_selectable - is RGB quantization range selectable?

 * @edid: EDID block to scan

 *

 * Check whether the monitor reports the RGB quantization range selection

 * as supported. The AVI infoframe can then be used to inform the monitor