Commit c214e6dd authored Mar 09, 2021 by Hans Verkuil Committed by Mauro Carvalho Chehab Mar 22, 2021

media: vpbe_osd.h/uvcvideo.h includes: fix trivial kernel-doc warnings

Fix these kernel-doc warnings:

include/media/davinci/vpbe_osd.h:77: warning: Enum value 'PIXFMT_YCBCRI' not described in enum 'osd_pix_format'
include/media/davinci/vpbe_osd.h:77: warning: Enum value 'PIXFMT_YCRCBI' not described in enum 'osd_pix_format'
include/media/davinci/vpbe_osd.h:77: warning: Excess enum value 'PIXFMT_YCrCbI' description in 'osd_pix_format'
include/media/davinci/vpbe_osd.h:77: warning: Excess enum value 'PIXFMT_YCbCrI' description in 'osd_pix_format'
include/media/davinci/vpbe_osd.h:232: warning: expecting prototype for enum davinci_cursor_v_width. Prototype was for enum
osd_cursor_v_width instead
include/uapi/linux/uvcvideo.h:98: warning: Function parameter or member 'ns' not described in 'uvc_meta_buf'
include/uapi/linux/uvcvideo.h:98: warning: Function parameter or member 'sof' not described in 'uvc_meta_buf'
include/uapi/linux/uvcvideo.h:98: warning: Function parameter or member 'length' not described in 'uvc_meta_buf'
include/uapi/linux/uvcvideo.h:98: warning: Function parameter or member 'flags' not described in 'uvc_meta_buf'
include/uapi/linux/uvcvideo.h:98: warning: Function parameter or member 'buf' not described in 'uvc_meta_buf'

Signed-off-by: Hans Verkuil <hverkuil-cisco@xs4all.nl>
Reviewed-by: Laurent Pinchart <laurent.pinchart@ideasonboard.com>
Signed-off-by: Mauro Carvalho Chehab <mchehab+huawei@kernel.org>

parent a68a90b2

include/media/davinci/vpbe_osd.h

+3 −3

Original line number	Diff line number	Diff line
		@@ -54,9 +54,9 @@ enum osd_win_layer {
		* @PIXFMT_4BPP: 4-bits-per-pixel bitmap
		* @PIXFMT_8BPP: 8-bits-per-pixel bitmap
		* @PIXFMT_RGB565: 16-bits-per-pixel RGB565
		* @PIXFMT_YCbCrI: YUV 4:2:2
		* @PIXFMT_YCBCRI: YUV 4:2:2
		* @PIXFMT_RGB888: 24-bits-per-pixel RGB888
		* @PIXFMT_YCrCbI: YUV 4:2:2 with chroma swap
		* @PIXFMT_YCRCBI: YUV 4:2:2 with chroma swap
		* @PIXFMT_NV12: YUV 4:2:0 planar
		* @PIXFMT_OSD_ATTR: OSD Attribute Window pixel format (4bpp)
		*
		@@ -210,7 +210,7 @@ enum osd_cursor_h_width {
		};

		/**
		* enum davinci_cursor_v_width
		* enum osd_cursor_v_width
		* @V_WIDTH_1: vertical line width is 1 line
		* @V_WIDTH_2: vertical line width is 2 lines
		* @V_WIDTH_4: vertical line width is 4 lines

include/uapi/linux/uvcvideo.h

+5 −5

Original line number	Diff line number	Diff line
		@@ -76,11 +76,11 @@ struct uvc_xu_control_query {

		/**
		* struct uvc_meta_buf - metadata buffer building block
		* @ns - system timestamp of the payload in nanoseconds
		* @sof - USB Frame Number
		* @length - length of the payload header
		* @flags - payload header flags
		* @buf - optional device-specific header data
		* @ns: system timestamp of the payload in nanoseconds
		* @sof: USB Frame Number
		* @length: length of the payload header
		* @flags: payload header flags
		* @buf: optional device-specific header data
		*
		* UVC metadata nodes fill buffers with possibly multiple instances of this
		* struct. The first two fields are added by the driver, they can be used for