media: v4l: fwnode: v4l2_async_notifier_parse_fwnode_endpoints is deprecated

Document that v4l2_async_notifier_parse_fwnode_endpoints() is deprecated.
Its functionality has been replaced by other, better functions. Also add a
reference to an example if someone ends up wandering here.

Signed-off-by: Sakari Ailus <sakari.ailus@linux.intel.com>
Signed-off-by: Mauro Carvalho Chehab <mchehab+huawei@kernel.org>
This commit is contained in:
Sakari Ailus 2020-12-14 22:31:21 +01:00 committed by Mauro Carvalho Chehab
parent 44c1febd7e
commit d8401ed01f
1 changed files with 4 additions and 0 deletions

View File

@ -453,6 +453,10 @@ typedef int (*parse_endpoint_func)(struct device *dev,
* @parse_endpoint: Driver's callback function called on each V4L2 fwnode
* endpoint. Optional.
*
* DEPRECATED! This function is deprecated. Don't use it in new drivers.
* Instead see an example in cio2_parse_firmware() function in
* drivers/media/pci/intel/ipu3/ipu3-cio2.c .
*
* Parse the fwnode endpoints of the @dev device and populate the async sub-
* devices list in the notifier. The @parse_endpoint callback function is
* called for each endpoint with the corresponding async sub-device pointer to