linux.git/include/media/v4l2-subdev.h, branch v5.11

media: fix kernel-doc markups

2020-11-16T09:31:16+00:00

Some identifiers have different names between their prototypes
and the kernel-doc markup. Seome seems to be due to cut-and-paste
related issues.

Others need to be fixed, as kernel-doc markups should use this format:
        identifier - description

Acked-by: Sakari Ailus  # IPU3 and V4L2
Signed-off-by: Mauro Carvalho Chehab

media: v4l2-subdev.h: fix a kernel-doc markup

2020-09-30T16:50:20+00:00

As reported by Sphinx:

	./Documentation/driver-api/media/v4l2-subdev:490: ./include/media/v4l2-subdev.h:384: WARNING: Unparseable C cross-reference: 'struct'
	Invalid C declaration: Expected identifier in nested name, got keyword: struct [error at 6]
	  struct
	  ------^

The markup there is wrong:
	&struct &v4l2_input -> &struct v4l2_input

Signed-off-by: Mauro Carvalho Chehab

media: v4l2-subdev: Remove [s|g]_mbus_config video ops

2020-08-18T13:45:23+00:00

With all sensor and platform drivers now converted to use the new
get_mbus_config and set_mbus_config pad operations, remove the
deprecated video operations g_mbus_config and s_mbus_config.

Signed-off-by: Jacopo Mondi 
Signed-off-by: Hans Verkuil 
Signed-off-by: Mauro Carvalho Chehab

media: v4l2-subdev: Introduce [get|set]_mbus_config pad ops

2020-08-18T13:34:22+00:00

Introduce two new pad operations to allow retrieving and configuring the
media bus parameters on a subdevice pad.

The newly introduced operations aims to replace the s/g_mbus_config video
operations, which have been on their way for deprecation since a long
time.

Signed-off-by: Jacopo Mondi 
Signed-off-by: Hans Verkuil 
Signed-off-by: Mauro Carvalho Chehab

media: v4l2: Correct kernel-doc inconsistency

2020-08-06T09:25:26+00:00

Silence documentation build warnings by correcting kernel-doc comment
v4l2_subdev_get_fwnode_pad_1_to_1 function

./include/media/v4l2-subdev.h:1045: warning: Function parameter or member 'entity' not described in 'v4l2_subdev_get_fwnode_pad_1_to_1'
./include/media/v4l2-subdev.h:1045: warning: Function parameter or member 'endpoint' not described in 'v4l2_subdev_get_fwnode_pad_1_to_1'

Signed-off-by: Colton Lewis 
Signed-off-by: Hans Verkuil 
Signed-off-by: Mauro Carvalho Chehab

media: v4l2-subdev.h: keep * together with the type

2020-07-19T12:26:10+00:00

Having the '*' in the next line separated from the type makes it
hard to see that these functions return a pointer to that type.

Instead, keep it next to the type name so it is clear that it is
a pointer to that type.

Signed-off-by: Hans Verkuil 
Signed-off-by: Mauro Carvalho Chehab

media: v4l2-subdev.h: drop duplicated word in comment

2020-07-19T12:00:26+00:00

Delete the doubled words "the" in comments.

Signed-off-by: Randy Dunlap 
Signed-off-by: Hans Verkuil 
Signed-off-by: Mauro Carvalho Chehab

include/media/v4l2-subdev.h: fix typo

2020-07-19T05:43:33+00:00

Typo in comment block:

v4l2_subdev_get_try_crop -> v4l2_subdev_get_try_compose

Signed-off-by: Hans Verkuil 
Signed-off-by: Mauro Carvalho Chehab

media: v4l2-subdev: add v4l2_subdev_get_fwnode_pad_1_to_1

2020-05-18T09:12:52+00:00

Add a convenience function that can be used as the .get_fwnode_pad
operation for subdevices that map port numbers and pad indexes 1:1.
The function verifies the endpoint is owned by the subdevice, and if
so returns the endpoint port number.

Signed-off-by: Steve Longerbeam 
Signed-off-by: Sakari Ailus 
Signed-off-by: Mauro Carvalho Chehab

media: v4l2: Switch to new kerneldoc syntax for named variable macro arguments

2020-03-05T21:46:45+00:00

The new syntax is available since commit 43756e347f21
("scripts/kernel-doc: Add support for named variable macro arguments").

The same HTML output is produced with and without this patch.

Signed-off-by: Jonathan Neuschäfer 
Signed-off-by: Hans Verkuil 
Signed-off-by: Mauro Carvalho Chehab