Commit abee5491 authored by Benjamin Gaignard's avatar Benjamin Gaignard

drm: bufs: Clean up documentation

Fix kernel doc comments to avoid warnings when compiling with W=1.
Signed-off-by: default avatarBenjamin Gaignard <benjamin.gaignard@st.com>
Acked-by: default avatarDaniel Vetter <daniel.vetter@ffwll.ch>
Link: https://patchwork.freedesktop.org/patch/msgid/20200306102937.4932-3-benjamin.gaignard@st.com
parent 40e5f353
...@@ -134,7 +134,7 @@ static int drm_map_handle(struct drm_device *dev, struct drm_hash_item *hash, ...@@ -134,7 +134,7 @@ static int drm_map_handle(struct drm_device *dev, struct drm_hash_item *hash,
shift, add); shift, add);
} }
/** /*
* Core function to create a range of memory available for mapping by a * Core function to create a range of memory available for mapping by a
* non-root process. * non-root process.
* *
...@@ -398,7 +398,7 @@ struct drm_local_map *drm_legacy_findmap(struct drm_device *dev, ...@@ -398,7 +398,7 @@ struct drm_local_map *drm_legacy_findmap(struct drm_device *dev,
} }
EXPORT_SYMBOL(drm_legacy_findmap); EXPORT_SYMBOL(drm_legacy_findmap);
/** /*
* Ioctl to specify a range of memory that is available for mapping by a * Ioctl to specify a range of memory that is available for mapping by a
* non-root process. * non-root process.
* *
...@@ -499,7 +499,7 @@ int drm_legacy_getmap_ioctl(struct drm_device *dev, void *data, ...@@ -499,7 +499,7 @@ int drm_legacy_getmap_ioctl(struct drm_device *dev, void *data,
return 0; return 0;
} }
/** /*
* Remove a map private from list and deallocate resources if the mapping * Remove a map private from list and deallocate resources if the mapping
* isn't in use. * isn't in use.
* *
...@@ -659,7 +659,7 @@ int drm_legacy_rmmap_ioctl(struct drm_device *dev, void *data, ...@@ -659,7 +659,7 @@ int drm_legacy_rmmap_ioctl(struct drm_device *dev, void *data,
return ret; return ret;
} }
/** /*
* Cleanup after an error on one of the addbufs() functions. * Cleanup after an error on one of the addbufs() functions.
* *
* \param dev DRM device. * \param dev DRM device.
...@@ -694,7 +694,7 @@ static void drm_cleanup_buf_error(struct drm_device *dev, ...@@ -694,7 +694,7 @@ static void drm_cleanup_buf_error(struct drm_device *dev,
} }
#if IS_ENABLED(CONFIG_AGP) #if IS_ENABLED(CONFIG_AGP)
/** /*
* Add AGP buffers for DMA transfers. * Add AGP buffers for DMA transfers.
* *
* \param dev struct drm_device to which the buffers are to be added. * \param dev struct drm_device to which the buffers are to be added.
...@@ -1230,7 +1230,7 @@ static int drm_legacy_addbufs_sg(struct drm_device *dev, ...@@ -1230,7 +1230,7 @@ static int drm_legacy_addbufs_sg(struct drm_device *dev,
return 0; return 0;
} }
/** /*
* Add buffers for DMA transfers (ioctl). * Add buffers for DMA transfers (ioctl).
* *
* \param inode device inode. * \param inode device inode.
...@@ -1271,7 +1271,7 @@ int drm_legacy_addbufs(struct drm_device *dev, void *data, ...@@ -1271,7 +1271,7 @@ int drm_legacy_addbufs(struct drm_device *dev, void *data,
return ret; return ret;
} }
/** /*
* Get information about the buffer mappings. * Get information about the buffer mappings.
* *
* This was originally mean for debugging purposes, or by a sophisticated * This was originally mean for debugging purposes, or by a sophisticated
...@@ -1362,7 +1362,7 @@ int drm_legacy_infobufs(struct drm_device *dev, void *data, ...@@ -1362,7 +1362,7 @@ int drm_legacy_infobufs(struct drm_device *dev, void *data,
return __drm_legacy_infobufs(dev, data, &request->count, copy_one_buf); return __drm_legacy_infobufs(dev, data, &request->count, copy_one_buf);
} }
/** /*
* Specifies a low and high water mark for buffer allocation * Specifies a low and high water mark for buffer allocation
* *
* \param inode device inode. * \param inode device inode.
...@@ -1411,7 +1411,7 @@ int drm_legacy_markbufs(struct drm_device *dev, void *data, ...@@ -1411,7 +1411,7 @@ int drm_legacy_markbufs(struct drm_device *dev, void *data,
return 0; return 0;
} }
/** /*
* Unreserve the buffers in list, previously reserved using drmDMA. * Unreserve the buffers in list, previously reserved using drmDMA.
* *
* \param inode device inode. * \param inode device inode.
...@@ -1463,7 +1463,7 @@ int drm_legacy_freebufs(struct drm_device *dev, void *data, ...@@ -1463,7 +1463,7 @@ int drm_legacy_freebufs(struct drm_device *dev, void *data,
return 0; return 0;
} }
/** /*
* Maps all of the DMA buffers into client-virtual space (ioctl). * Maps all of the DMA buffers into client-virtual space (ioctl).
* *
* \param inode device inode. * \param inode device inode.
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment