Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux

media: exynos4-is: fix kernel-doc warnings

Fixes these kernel-doc warnings:

drivers/media/platform/exynos4-is/fimc-isp.h:139: warning: Function parameter or member 've' not described in 'fimc_is_video'
drivers/media/platform/exynos4-is/fimc-isp.h:139: warning: Function parameter or member 'buf_count' not described in 'fimc_is_video'
drivers/media/platform/exynos4-is/fimc-isp.h:139: warning: Function parameter or member 'buf_mask' not described in 'fimc_is_video'
drivers/media/platform/exynos4-is/fimc-isp.h:139: warning: Function parameter or member 'streaming' not described in 'fimc_is_video'
drivers/media/platform/exynos4-is/fimc-isp.h:139: warning: Function parameter or member 'buffers' not described in 'fimc_is_video'
drivers/media/platform/exynos4-is/fimc-isp.h:139: warning: Function parameter or member 'pixfmt' not described in 'fimc_is_video'
drivers/media/platform/exynos4-is/fimc-isp.h:176: warning: Function parameter or member 'src_fmt' not described in 'fimc_isp'
drivers/media/platform/exynos4-is/fimc-isp.h:176: warning: Function parameter or member 'sink_fmt' not described in 'fimc_isp'
drivers/media/platform/exynos4-is/fimc-isp.h:176: warning: Function parameter or member 'subdev_lock' not described in 'fimc_isp'
drivers/media/platform/exynos4-is/fimc-lite.h:178: warning: Function parameter or member 'events' not described in 'fimc_lite'
drivers/media/platform/exynos4-is/fimc-lite.h:178: warning: Function parameter or member 'streaming' not described in 'fimc_lite'
drivers/media/platform/exynos4-is/media-dev.h:143: warning: Function parameter or member 'wbclk' not described in 'fimc_md'
drivers/media/platform/exynos4-is/media-dev.h:143: warning: Function parameter or member 'fimc_lite' not described in 'fimc_md'
drivers/media/platform/exynos4-is/media-dev.h:143: warning: Function parameter or member 'clk_provider' not described in 'fimc_md'
drivers/media/platform/exynos4-is/media-dev.h:143: warning: Function parameter or member 'subdev_notifier' not described in 'fimc_md'
drivers/media/platform/exynos4-is/media-dev.h:143: warning: Function parameter or member 'pipelines' not described in 'fimc_md'
drivers/media/platform/exynos4-is/media-dev.h:143: warning: Function parameter or member 'link_setup_graph' not described in 'fimc_md'
drivers/media/platform/exynos4-is/fimc-core.h:261: warning: Function parameter or member 'alpha' not described in 'fimc_frame'
drivers/media/platform/exynos4-is/fimc-core.h:321: warning: Function parameter or member 'streaming' not described in 'fimc_vid_cap'
drivers/media/platform/exynos4-is/fimc-core.h:429: warning: Function parameter or member 'drv_data' not described in 'fimc_dev'
drivers/media/platform/exynos4-is/fimc-core.h:495: warning: Function parameter or member 'in_order_1p' not described in 'fimc_ctx'
drivers/media/platform/exynos4-is/fimc-core.h:673: warning: Function parameter or member 'vid_cap' not described in 'fimc_active_queue_add'
drivers/media/platform/exynos4-is/fimc-core.h:685: warning: Function parameter or member 'vid_cap' not described in 'fimc_active_queue_pop'
drivers/media/platform/exynos4-is/fimc-core.h:700: warning: Function parameter or member 'vid_cap' not described in 'fimc_pending_queue_add'
drivers/media/platform/exynos4-is/fimc-core.h:711: warning: Function parameter or member 'vid_cap' not described in 'fimc_pending_queue_pop'
drivers/media/platform/exynos4-is/fimc-reg.h:333: warning: Function parameter or member 'dev' not described in 'fimc_hw_set_dma_seq'

Signed-off-by: Hans Verkuil <hverkuil-cisco@xs4all.nl>
Acked-by: Krzysztof Kozlowski <krzysztof.kozlowski@canonical.com>
Signed-off-by: Mauro Carvalho Chehab <mchehab+huawei@kernel.org>

authored by

Hans Verkuil and committed by
Mauro Carvalho Chehab
37157ffb 40839521

+29 -8
+8 -2
drivers/media/platform/exynos4-is/fimc-core.h
··· 242 242 * @addr: image frame buffer DMA addresses 243 243 * @dma_offset: DMA offset in bytes 244 244 * @fmt: fimc color format pointer 245 + * @alpha: alpha value 245 246 */ 246 247 struct fimc_frame { 247 248 u32 f_width; ··· 297 296 * @buf_index: index for managing the output DMA buffers 298 297 * @frame_count: the frame counter for statistics 299 298 * @reqbufs_count: the number of buffers requested in REQBUFS ioctl 299 + * @streaming: is streaming in progress? 300 300 * @input: capture input type, grp_id of the attached subdev 301 301 * @user_subdev_api: true if subdevs are not configured by the host driver 302 302 */ ··· 402 400 * @pdata: pointer to the device platform data 403 401 * @sysreg: pointer to the SYSREG regmap 404 402 * @variant: the IP variant information 403 + * @drv_data: driver data 405 404 * @id: FIMC device index (0..FIMC_MAX_DEVS) 406 405 * @clock: clocks required for FIMC operation 407 406 * @regs: the mapped hardware registers ··· 411 408 * @m2m: memory-to-memory V4L2 device information 412 409 * @vid_cap: camera capture device information 413 410 * @state: flags used to synchronize m2m and capture mode operation 414 - * @pipeline: fimc video capture pipeline data structure 415 411 */ 416 412 struct fimc_dev { 417 413 spinlock_t slock; ··· 460 458 * @d_frame: destination frame properties 461 459 * @out_order_1p: output 1-plane YCBCR order 462 460 * @out_order_2p: output 2-plane YCBCR order 463 - * @in_order_1p input 1-plane YCBCR order 461 + * @in_order_1p: input 1-plane YCBCR order 464 462 * @in_order_2p: input 2-plane YCBCR order 465 463 * @in_path: input mode (DMA or camera) 466 464 * @out_path: output mode (DMA or FIFO) ··· 668 666 669 667 /** 670 668 * fimc_active_queue_add - add buffer to the capture active buffers queue 669 + * @vid_cap: camera capture device information 671 670 * @buf: buffer to add to the active buffers list 672 671 */ 673 672 static inline void fimc_active_queue_add(struct fimc_vid_cap *vid_cap, ··· 680 677 681 678 /** 682 679 * fimc_active_queue_pop - pop buffer from the capture active buffers queue 680 + * @vid_cap: camera capture device information 683 681 * 684 682 * The caller must assure the active_buf_q list is not empty. 685 683 */ ··· 697 693 698 694 /** 699 695 * fimc_pending_queue_add - add buffer to the capture pending buffers queue 696 + * @vid_cap: camera capture device information 700 697 * @buf: buffer to add to the pending buffers list 701 698 */ 702 699 static inline void fimc_pending_queue_add(struct fimc_vid_cap *vid_cap, ··· 708 703 709 704 /** 710 705 * fimc_pending_queue_pop - pop buffer from the capture pending buffers queue 706 + * @vid_cap: camera capture device information 711 707 * 712 708 * The caller must assure the pending_buf_q list is not empty. 713 709 */
+12 -5
drivers/media/platform/exynos4-is/fimc-isp.h
··· 110 110 111 111 /** 112 112 * struct fimc_is_video - fimc-is video device structure 113 - * @vdev: video_device structure 113 + * @ve: video_device structure and media pipeline 114 114 * @type: video device type (CAPTURE/OUTPUT) 115 115 * @pad: video device media (sink) pad 116 116 * @pending_buf_q: pending buffers queue head 117 117 * @active_buf_q: a queue head of buffers scheduled in hardware 118 118 * @vb_queue: vb2 buffer queue 119 - * @active_buf_count: number of video buffers scheduled in hardware 119 + * @reqbufs_count: the number of buffers requested in REQBUFS ioctl 120 + * @buf_count: number of video buffers scheduled in hardware 121 + * @buf_mask: bitmask of the queued video buffer indices 120 122 * @frame_count: counter of frames dequeued to user space 121 - * @reqbufs_count: number of buffers requested with REQBUFS ioctl 122 - * @format: current pixel format 123 + * @streaming: is streaming in progress? 124 + * @buffers: buffer info 125 + * @format: current fimc pixel format 126 + * @pixfmt: current pixel format 123 127 */ 124 128 struct fimc_is_video { 125 129 struct exynos_video_entity ve; ··· 151 147 * @pdev: pointer to FIMC-IS platform device 152 148 * @subdev: ISP v4l2_subdev 153 149 * @subdev_pads: the ISP subdev media pads 150 + * @src_fmt: source mediabus format 151 + * @sink_fmt: sink mediabus format 154 152 * @test_pattern: test pattern controls 155 153 * @ctrls: v4l2 controls structure 156 - * @video_lock: mutex serializing video device and the subdev operations 154 + * @video_lock: mutex serializing video device operations 155 + * @subdev_lock: mutex serializing subdev operations 157 156 * @cac_margin_x: horizontal CAC margin in pixels 158 157 * @cac_margin_y: vertical CAC margin in pixels 159 158 * @state: driver state flags
+2
drivers/media/platform/exynos4-is/fimc-lite.h
··· 137 137 * @active_buf_count: number of video buffers scheduled in hardware 138 138 * @frame_count: the captured frames counter 139 139 * @reqbufs_count: the number of buffers requested with REQBUFS ioctl 140 + * @events: event info 141 + * @streaming: is streaming in progress? 140 142 */ 141 143 struct fimc_lite { 142 144 struct platform_device *pdev;
+1
drivers/media/platform/exynos4-is/fimc-reg.h
··· 324 324 325 325 /** 326 326 * fimc_hw_set_dma_seq - configure output DMA buffer sequence 327 + * @dev: fimc device 327 328 * @mask: bitmask for the DMA output buffer registers, set to 0 to skip buffer 328 329 * This function masks output DMA ring buffers, it allows to select which of 329 330 * the 32 available output buffer address registers will be used by the DMA
+6 -1
drivers/media/platform/exynos4-is/media-dev.h
··· 100 100 * @sensor: array of registered sensor subdevs 101 101 * @num_sensors: actual number of registered sensors 102 102 * @camclk: external sensor clock information 103 + * @wbclk: external writeback clock information 104 + * @fimc_lite: array of registered fimc-lite devices 103 105 * @fimc: array of registered fimc devices 104 106 * @fimc_is: fimc-is data structure 105 107 * @use_isp: set to true when FIMC-IS subsystem is used ··· 109 107 * @media_dev: top level media device 110 108 * @v4l2_dev: top level v4l2_device holding up the subdevs 111 109 * @pdev: platform device this media device is hooked up into 112 - * @cam_clk_provider: CAMCLK clock provider structure 110 + * @clk_provider: CAMCLK clock provider structure 111 + * @subdev_notifier: notifier for the subdevs 113 112 * @user_subdev_api: true if subdevs are not configured by the host driver 114 113 * @slock: spinlock protecting @sensor array 114 + * @pipelines: list of pipelines 115 + * @link_setup_graph: graph iterator 115 116 */ 116 117 struct fimc_md { 117 118 struct fimc_csis_info csis[CSIS_MAX_ENTITIES];