Commit 3b060ba0 authored by Mauro Carvalho Chehab's avatar Mauro Carvalho Chehab

media: exynos4-is: fix kernel-doc warnings

Fix those kernel-doc warnings:

    drivers/media/platform/exynos4-is/mipi-csis.c:229: warning: No description found for parameter 'clk_frequency'
    drivers/media/platform/exynos4-is/mipi-csis.c:229: warning: Excess struct member 'clock_frequency' description in 'csis_state'
    drivers/media/platform/exynos4-is/media-dev.c:69: warning: No description found for parameter 'p'
    drivers/media/platform/exynos4-is/media-dev.c:160: warning: No description found for parameter 'p'
    drivers/media/platform/exynos4-is/media-dev.c:160: warning: No description found for parameter 'on'
    drivers/media/platform/exynos4-is/media-dev.c:160: warning: Excess function parameter 'fimc' description in 'fimc_pipeline_s_power'
    drivers/media/platform/exynos4-is/media-dev.c:160: warning: Excess function parameter 'state' description in 'fimc_pipeline_s_power'
    drivers/media/platform/exynos4-is/media-dev.c:229: warning: No description found for parameter 'ep'
    drivers/media/platform/exynos4-is/media-dev.c:260: warning: No description found for parameter 'ep'
    drivers/media/platform/exynos4-is/media-dev.c:260: warning: Excess function parameter 'fimc' description in '__fimc_pipeline_close'
    drivers/media/platform/exynos4-is/media-dev.c:288: warning: No description found for parameter 'ep'
    drivers/media/platform/exynos4-is/media-dev.c:288: warning: Excess function parameter 'pipeline' description in '__fimc_pipeline_s_stream'
    drivers/media/platform/exynos4-is/media-dev.c:916: warning: No description found for parameter 'fmd'
    drivers/media/platform/exynos4-is/fimc-capture.c:155: warning: No description found for parameter 'ctx'
    drivers/media/platform/exynos4-is/fimc-capture.c:868: warning: No description found for parameter 'num_planes'
    drivers/media/platform/exynos4-is/fimc-capture.c:1108: warning: No description found for parameter 'fimc'
Signed-off-by: default avatarMauro Carvalho Chehab <mchehab@s-opensource.com>
parent 440568f8
...@@ -146,6 +146,7 @@ static int fimc_stop_capture(struct fimc_dev *fimc, bool suspend) ...@@ -146,6 +146,7 @@ static int fimc_stop_capture(struct fimc_dev *fimc, bool suspend)
/** /**
* fimc_capture_config_update - apply the camera interface configuration * fimc_capture_config_update - apply the camera interface configuration
* @ctx: FIMC capture context
* *
* To be called from within the interrupt handler with fimc.slock * To be called from within the interrupt handler with fimc.slock
* spinlock held. It updates the camera pixel crop, rotation and * spinlock held. It updates the camera pixel crop, rotation and
...@@ -858,6 +859,7 @@ static int fimc_pipeline_try_format(struct fimc_ctx *ctx, ...@@ -858,6 +859,7 @@ static int fimc_pipeline_try_format(struct fimc_ctx *ctx,
* fimc_get_sensor_frame_desc - query the sensor for media bus frame parameters * fimc_get_sensor_frame_desc - query the sensor for media bus frame parameters
* @sensor: pointer to the sensor subdev * @sensor: pointer to the sensor subdev
* @plane_fmt: provides plane sizes corresponding to the frame layout entries * @plane_fmt: provides plane sizes corresponding to the frame layout entries
* @num_planes: number of planes
* @try: true to set the frame parameters, false to query only * @try: true to set the frame parameters, false to query only
* *
* This function is used by this driver only for compressed/blob data formats. * This function is used by this driver only for compressed/blob data formats.
...@@ -1101,6 +1103,7 @@ static int fimc_cap_g_input(struct file *file, void *priv, unsigned int *i) ...@@ -1101,6 +1103,7 @@ static int fimc_cap_g_input(struct file *file, void *priv, unsigned int *i)
/** /**
* fimc_pipeline_validate - check for formats inconsistencies * fimc_pipeline_validate - check for formats inconsistencies
* between source and sink pad of each link * between source and sink pad of each link
* @fimc: the FIMC device this context applies to
* *
* Return 0 if all formats match or -EPIPE otherwise. * Return 0 if all formats match or -EPIPE otherwise.
*/ */
......
...@@ -60,6 +60,7 @@ static void __setup_sensor_notification(struct fimc_md *fmd, ...@@ -60,6 +60,7 @@ static void __setup_sensor_notification(struct fimc_md *fmd,
/** /**
* fimc_pipeline_prepare - update pipeline information with subdevice pointers * fimc_pipeline_prepare - update pipeline information with subdevice pointers
* @p: fimc pipeline
* @me: media entity terminating the pipeline * @me: media entity terminating the pipeline
* *
* Caller holds the graph mutex. * Caller holds the graph mutex.
...@@ -151,8 +152,8 @@ static int __subdev_set_power(struct v4l2_subdev *sd, int on) ...@@ -151,8 +152,8 @@ static int __subdev_set_power(struct v4l2_subdev *sd, int on)
/** /**
* fimc_pipeline_s_power - change power state of all pipeline subdevs * fimc_pipeline_s_power - change power state of all pipeline subdevs
* @fimc: fimc device terminating the pipeline * @p: fimc device terminating the pipeline
* @state: true to power on, false to power off * @on: true to power on, false to power off
* *
* Needs to be called with the graph mutex held. * Needs to be called with the graph mutex held.
*/ */
...@@ -219,6 +220,7 @@ static int __fimc_pipeline_enable(struct exynos_media_pipeline *ep, ...@@ -219,6 +220,7 @@ static int __fimc_pipeline_enable(struct exynos_media_pipeline *ep,
/** /**
* __fimc_pipeline_open - update the pipeline information, enable power * __fimc_pipeline_open - update the pipeline information, enable power
* of all pipeline subdevs and the sensor clock * of all pipeline subdevs and the sensor clock
* @ep: fimc device terminating the pipeline
* @me: media entity to start graph walk with * @me: media entity to start graph walk with
* @prepare: true to walk the current pipeline and acquire all subdevs * @prepare: true to walk the current pipeline and acquire all subdevs
* *
...@@ -252,7 +254,7 @@ static int __fimc_pipeline_open(struct exynos_media_pipeline *ep, ...@@ -252,7 +254,7 @@ static int __fimc_pipeline_open(struct exynos_media_pipeline *ep,
/** /**
* __fimc_pipeline_close - disable the sensor clock and pipeline power * __fimc_pipeline_close - disable the sensor clock and pipeline power
* @fimc: fimc device terminating the pipeline * @ep: fimc device terminating the pipeline
* *
* Disable power of all subdevs and turn the external sensor clock off. * Disable power of all subdevs and turn the external sensor clock off.
*/ */
...@@ -281,7 +283,7 @@ static int __fimc_pipeline_close(struct exynos_media_pipeline *ep) ...@@ -281,7 +283,7 @@ static int __fimc_pipeline_close(struct exynos_media_pipeline *ep)
/** /**
* __fimc_pipeline_s_stream - call s_stream() on pipeline subdevs * __fimc_pipeline_s_stream - call s_stream() on pipeline subdevs
* @pipeline: video pipeline structure * @ep: video pipeline structure
* @on: passed as the s_stream() callback argument * @on: passed as the s_stream() callback argument
*/ */
static int __fimc_pipeline_s_stream(struct exynos_media_pipeline *ep, bool on) static int __fimc_pipeline_s_stream(struct exynos_media_pipeline *ep, bool on)
...@@ -902,6 +904,7 @@ static int __fimc_md_create_fimc_is_links(struct fimc_md *fmd) ...@@ -902,6 +904,7 @@ static int __fimc_md_create_fimc_is_links(struct fimc_md *fmd)
/** /**
* fimc_md_create_links - create default links between registered entities * fimc_md_create_links - create default links between registered entities
* @fmd: fimc media device
* *
* Parallel interface sensor entities are connected directly to FIMC capture * Parallel interface sensor entities are connected directly to FIMC capture
* entities. The sensors using MIPI CSIS bus are connected through immutable * entities. The sensors using MIPI CSIS bus are connected through immutable
......
...@@ -189,7 +189,7 @@ struct csis_drvdata { ...@@ -189,7 +189,7 @@ struct csis_drvdata {
* @irq: requested s5p-mipi-csis irq number * @irq: requested s5p-mipi-csis irq number
* @interrupt_mask: interrupt mask of the all used interrupts * @interrupt_mask: interrupt mask of the all used interrupts
* @flags: the state variable for power and streaming control * @flags: the state variable for power and streaming control
* @clock_frequency: device bus clock frequency * @clk_frequency: device bus clock frequency
* @hs_settle: HS-RX settle time * @hs_settle: HS-RX settle time
* @num_lanes: number of MIPI-CSI data lanes used * @num_lanes: number of MIPI-CSI data lanes used
* @max_num_lanes: maximum number of MIPI-CSI data lanes supported * @max_num_lanes: maximum number of MIPI-CSI data lanes supported
......
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