redonkable/remarkable-linux
redonkable/remarkable-linux
1
0
Fork 0
Code Releases Activity

drm/doc: Fix more kerneldoc/sphinx warnings

Browse source 
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
This commit is contained in:
Daniel Vetter 2016-08-12 22:48:37 +02:00
parent e1f96ef46c
commit 62cacc7939
9 changed files with 41 additions and 40 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

4
drivers/gpu/drm/drm_crtc.c
View file

@ -1266,7 +1266,7 @@ static unsigned int drm_num_planes(struct drm_device *dev)
* @plane: plane object to init * @plane: plane object to init
* @possible_crtcs: bitmask of possible CRTCs * @possible_crtcs: bitmask of possible CRTCs
* @funcs: callbacks for the new plane * @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 * @format_count: number of elements in @formats
* @type: type of plane (overlay, primary, cursor) * @type: type of plane (overlay, primary, cursor)
* @name: printf style format string for the plane name, or NULL for default name * @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 * @plane: plane object to init
* @possible_crtcs: bitmask of possible CRTCs * @possible_crtcs: bitmask of possible CRTCs
* @funcs: callbacks for the new plane * @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 * @format_count: number of elements in @formats
* @is_primary: plane type (primary vs overlay) * @is_primary: plane type (primary vs overlay)
* *

2
drivers/gpu/drm/drm_fb_helper.c
View file

@ -2193,7 +2193,7 @@ EXPORT_SYMBOL(drm_fb_helper_initial_config);
* @fb_helper: the drm_fb_helper * @fb_helper: the drm_fb_helper
* *
* Scan the connectors attached to the fb_helper and try to put together a * 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 * 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 * modeset configuration. Must be run from process context (which usually means

8
drivers/gpu/drm/drm_irq.c
View file

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

2
drivers/gpu/drm/drm_simple_kms_helper.c
View file

@ -137,7 +137,7 @@ static const struct drm_plane_funcs drm_simple_kms_plane_funcs = {
* @dev: DRM device * @dev: DRM device
* @pipe: simple display pipe object to initialize * @pipe: simple display pipe object to initialize
* @funcs: callbacks for the display pipe (optional) * @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 * @format_count: number of elements in @formats
* @connector: connector to attach and register * @connector: connector to attach and register
* *

42
drivers/gpu/drm/i915/i915_vgpu.c
View file

@ -156,27 +156,27 @@ static int vgt_balloon_space(struct drm_mm *mm,
* host point of view, the graphic address space is partitioned by multiple * host point of view, the graphic address space is partitioned by multiple
* vGPUs in different VMs. :: * vGPUs in different VMs. ::
* *
* vGPU1 view Host view * vGPU1 view Host view
* 0 ------> +-----------+ +-----------+ * 0 ------> +-----------+ +-----------+
* ^ |###########| | vGPU3 | * ^ |###########| | vGPU3 |
* | |###########| +-----------+ * | |###########| +-----------+
* | |###########| | vGPU2 | * | |###########| | vGPU2 |
* | +-----------+ +-----------+ * | +-----------+ +-----------+
* mappable GM | available | ==> | vGPU1 | * mappable GM | available | ==> | vGPU1 |
* | +-----------+ +-----------+ * | +-----------+ +-----------+
* | |###########| | | * | |###########| | |
* v |###########| | Host | * v |###########| | Host |
* +=======+===========+ +===========+ * +=======+===========+ +===========+
* ^ |###########| | vGPU3 | * ^ |###########| | vGPU3 |
* | |###########| +-----------+ * | |###########| +-----------+
* | |###########| | vGPU2 | * | |###########| | vGPU2 |
* | +-----------+ +-----------+ * | +-----------+ +-----------+
* unmappable GM | available | ==> | vGPU1 | * unmappable GM | available | ==> | vGPU1 |
* | +-----------+ +-----------+ * | +-----------+ +-----------+
* | |###########| | | * | |###########| | |
* | |###########| | Host | * | |###########| | Host |
* v |###########| | | * v |###########| | |
* total GM size ------> +-----------+ +-----------+ * total GM size ------> +-----------+ +-----------+
* *
* Returns: * Returns:
* zero on success, non-zero if configuration invalid or ballooning failed * zero on success, non-zero if configuration invalid or ballooning failed

6
drivers/gpu/drm/i915/intel_audio.c
View file

@ -51,10 +51,10 @@
* related registers. (The notable exception is the power management, not * related registers. (The notable exception is the power management, not
* covered here.) * covered here.)
* *
* The struct i915_audio_component is used to interact between the graphics * 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 * and audio drivers. The struct &i915_audio_component_ops @ops in it is
* defined in graphics driver and called in audio driver. The * 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 { static const struct {

5
drivers/gpu/drm/i915/intel_guc_fwif.h
View file

@ -155,6 +155,7 @@
* *
* +-------------------------------+ * +-------------------------------+
* | guc_css_header | * | guc_css_header |
* | |
* | contains major/minor version | * | contains major/minor version |
* +-------------------------------+ * +-------------------------------+
* | uCode | * | uCode |
@ -176,10 +177,10 @@
* *
* 1. Header, uCode and RSA are must-have components. * 1. Header, uCode and RSA are must-have components.
* 2. All firmware components, if they present, are in the sequence illustrated * 2. All firmware components, if they present, are in the sequence illustrated
* in the layout table above. * in the layout table above.
* 3. Length info of each component can be found in header, in dwords. * 3. Length info of each component can be found in header, in dwords.
* 4. Modulus and exponent key are not required by driver. They may not appear * 4. Modulus and exponent key are not required by driver. They may not appear
* in fw. So driver will load a truncated firmware in this case. * in fw. So driver will load a truncated firmware in this case.
*/ */
struct guc_css_header { struct guc_css_header {

8
include/drm/drm_crtc.h
View file

@ -1197,7 +1197,7 @@ struct drm_encoder_funcs {
* @head: list management * @head: list management
* @base: base KMS object * @base: base KMS object
* @name: human readable name, can be overwritten by the driver * @name: human readable name, can be overwritten by the driver
* @encoder_type: one of the %DRM_MODE_ENCODER_<foo> types in drm_mode.h * @encoder_type: one of the DRM_MODE_ENCODER_<foo> types in drm_mode.h
* @possible_crtcs: bitmask of potential CRTC bindings * @possible_crtcs: bitmask of potential CRTC bindings
* @possible_clones: bitmask of potential sibling encoders for cloning * @possible_clones: bitmask of potential sibling encoders for cloning
* @crtc: currently bound CRTC * @crtc: currently bound CRTC
@ -1250,7 +1250,7 @@ struct drm_encoder {
* @head: list management * @head: list management
* @base: base KMS object * @base: base KMS object
* @name: human readable name, can be overwritten by the driver * @name: human readable name, can be overwritten by the driver
* @connector_type: one of the %DRM_MODE_CONNECTOR_<foo> types from drm_mode.h * @connector_type: one of the DRM_MODE_CONNECTOR_<foo> types from drm_mode.h
* @connector_type_id: index into connector type enum * @connector_type_id: index into connector type enum
* @interlace_allowed: can this connector handle interlaced modes? * @interlace_allowed: can this connector handle interlaced modes?
* @doublescan_allowed: can this connector handle doublescan? * @doublescan_allowed: can this connector handle doublescan?
@ -1263,11 +1263,11 @@ struct drm_encoder {
* @funcs: connector control functions * @funcs: connector control functions
* @edid_blob_ptr: DRM property containing EDID if present * @edid_blob_ptr: DRM property containing EDID if present
* @properties: property tracking for this connector * @properties: property tracking for this connector
* @polled: a %DRM_CONNECTOR_POLL_<foo> value for core driven polling * @polled: a DRM_CONNECTOR_POLL_<foo> value for core driven polling
* @dpms: current dpms state * @dpms: current dpms state
* @helper_private: mid-layer private data * @helper_private: mid-layer private data
* @cmdline_mode: mode line parsed from the kernel cmdline for this connector * @cmdline_mode: mode line parsed from the kernel cmdline for this connector
* @force: a %DRM_FORCE_<foo> state for forced mode sets * @force: a DRM_FORCE_<foo> state for forced mode sets
* @override_edid: has the EDID been overwritten through debugfs for testing? * @override_edid: has the EDID been overwritten through debugfs for testing?
* @encoder_ids: valid encoders for this connector * @encoder_ids: valid encoders for this connector
* @encoder: encoder driving this connector, if any * @encoder: encoder driving this connector, if any

4
include/drm/drm_gem.h
View file

@ -210,8 +210,8 @@ drm_gem_object_reference(struct drm_gem_object *obj)
* drm_gem_object_unreference_unlocked(). * drm_gem_object_unreference_unlocked().
* *
* Drivers should never call this directly in their code. Instead they should * Drivers should never call this directly in their code. Instead they should
* wrap it up into a driver_gem_object_unreference(struct driver_gem_object * wrap it up into a ``driver_gem_object_unreference(struct driver_gem_object
* *obj) wrapper function, and use that. Shared code should never call this, to * *obj)`` wrapper function, and use that. Shared code should never call this, to
* avoid breaking drivers by accident which still depend upon dev->struct_mutex * avoid breaking drivers by accident which still depend upon dev->struct_mutex
* locking. * locking.
*/ */