drm: fix parameters documentation style in drm_dma

Remove old documentation style and use new one to avoid warnings when
compiling with W=1

Signed-off-by: Benjamin Gaignard <benjamin.gaignard@st.com>
Acked-by: Randy Dunlap <rdunlap@infradead.org>
Signed-off-by: Sam Ravnborg <sam@ravnborg.org>
Link: https://patchwork.freedesktop.org/patch/msgid/20200114160135.14990-1-benjamin.gaignard@st.com
This commit is contained in:
Benjamin Gaignard 2020-01-14 17:01:35 +01:00 committed by Sam Ravnborg
parent 7a3cbf590e
commit 4e0311db2b
1 changed files with 11 additions and 10 deletions

View File

@ -42,10 +42,10 @@
#include "drm_legacy.h"
/**
* Initialize the DMA data.
* drm_legacy_dma_setup() - Initialize the DMA data.
*
* \param dev DRM device.
* \return zero on success or a negative value on failure.
* @dev: DRM device.
* Return: zero on success or a negative value on failure.
*
* Allocate and initialize a drm_device_dma structure.
*/
@ -71,9 +71,9 @@ int drm_legacy_dma_setup(struct drm_device *dev)
}
/**
* Cleanup the DMA resources.
* drm_legacy_dma_takedown() - Cleanup the DMA resources.
*
* \param dev DRM device.
* @dev: DRM device.
*
* Free all pages associated with DMA buffers, the buffers and pages lists, and
* finally the drm_device::dma structure itself.
@ -120,10 +120,10 @@ void drm_legacy_dma_takedown(struct drm_device *dev)
}
/**
* Free a buffer.
* drm_legacy_free_buffer() - Free a buffer.
*
* \param dev DRM device.
* \param buf buffer to free.
* @dev: DRM device.
* @buf: buffer to free.
*
* Resets the fields of \p buf.
*/
@ -139,9 +139,10 @@ void drm_legacy_free_buffer(struct drm_device *dev, struct drm_buf * buf)
}
/**
* Reclaim the buffers.
* drm_legacy_reclaim_buffers() - Reclaim the buffers.
*
* \param file_priv DRM file private.
* @dev: DRM device.
* @file_priv: DRM file private.
*
* Frees each buffer associated with \p file_priv not already on the hardware.
*/