Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit 62cacc79 authored Aug 12, 2016 by Daniel Vetter

drm/doc: Fix more kerneldoc/sphinx warnings

These are the leftovers I could only track down using keep_warnings =
True. For some of them we might want to update our style guide on how
to reference structures and constants, not sure ...

Cc: Markus Heiser <markus.heiser@darmarit.de>
Cc: Jonathan Corbet <corbet@lwn.net>
Cc: linux-doc@vger.kernel.org
Reviewed-by: Sean Paul <seanpaul@chromium.org>
Signed-off-by: Daniel Vetter <daniel.vetter@intel.com>
Link: http://patchwork.freedesktop.org/patch/msgid/1471034937-651-1-git-send-email-daniel.vetter@ffwll.ch

parent e1f96ef4

drivers/gpu/drm/drm_crtc.c

+2 −2

Original line number	Diff line number	Diff line
		@@ -1266,7 +1266,7 @@ static unsigned int drm_num_planes(struct drm_device *dev)
		* @plane: plane object to init
		* @possible_crtcs: bitmask of possible CRTCs
		* @funcs: callbacks for the new plane
		* @formats: array of supported formats (%DRM_FORMAT_*)
		* @formats: array of supported formats (DRM_FORMAT\_\*)
		* @format_count: number of elements in @formats
		* @type: type of plane (overlay, primary, cursor)
		* @name: printf style format string for the plane name, or NULL for default name
		@@ -1381,7 +1381,7 @@ static void drm_plane_unregister_all(struct drm_device *dev)
		* @plane: plane object to init
		* @possible_crtcs: bitmask of possible CRTCs
		* @funcs: callbacks for the new plane
		* @formats: array of supported formats (%DRM_FORMAT_*)
		* @formats: array of supported formats (DRM_FORMAT\_\*)
		* @format_count: number of elements in @formats
		* @is_primary: plane type (primary vs overlay)
		*

drivers/gpu/drm/drm_fb_helper.c

+1 −1

Original line number	Diff line number	Diff line
		@@ -2193,7 +2193,7 @@ EXPORT_SYMBOL(drm_fb_helper_initial_config);
		* @fb_helper: the drm_fb_helper
		*
		* Scan the connectors attached to the fb_helper and try to put together a
		* setup after *notification of a change in output configuration.
		* setup after notification of a change in output configuration.
		*
		* Called at runtime, takes the mode config locks to be able to check/change the
		* modeset configuration. Must be run from process context (which usually means

drivers/gpu/drm/drm_irq.c

+4 −4

Original line number	Diff line number	Diff line
		@@ -713,10 +713,10 @@ EXPORT_SYMBOL(drm_calc_timestamping_constants);
		* Negative value on error, failure or if not supported in current
		* video mode:
		*
		* -EINVAL - Invalid CRTC.
		* -EAGAIN - Temporary unavailable, e.g., called before initial modeset.
		* -ENOTSUPP - Function not supported in current display mode.
		* -EIO - Failed, e.g., due to failed scanout position query.
		* -EINVAL Invalid CRTC.
		* -EAGAIN Temporary unavailable, e.g., called before initial modeset.
		* -ENOTSUPP Function not supported in current display mode.
		* -EIO Failed, e.g., due to failed scanout position query.
		*
		* Returns or'ed positive status flags on success:
		*

drivers/gpu/drm/drm_simple_kms_helper.c

+1 −1

Original line number	Diff line number	Diff line
		@@ -137,7 +137,7 @@ static const struct drm_plane_funcs drm_simple_kms_plane_funcs = {
		* @dev: DRM device
		* @pipe: simple display pipe object to initialize
		* @funcs: callbacks for the display pipe (optional)
		* @formats: array of supported formats (%DRM_FORMAT_*)
		* @formats: array of supported formats (DRM_FORMAT\_\*)
		* @format_count: number of elements in @formats
		* @connector: connector to attach and register
		*

drivers/gpu/drm/i915/intel_audio.c

+3 −3

Original line number	Diff line number	Diff line
		@@ -51,10 +51,10 @@
		* related registers. (The notable exception is the power management, not
		* covered here.)
		*
		* The struct i915_audio_component is used to interact between the graphics
		* and audio drivers. The struct i915_audio_component_ops *ops in it is
		* The struct &i915_audio_component is used to interact between the graphics
		* and audio drivers. The struct &i915_audio_component_ops @ops in it is
		* defined in graphics driver and called in audio driver. The
		* struct i915_audio_component_audio_ops *audio_ops is called from i915 driver.
		* struct &i915_audio_component_audio_ops @audio_ops is called from i915 driver.
		*/

		static const struct {