Browse Source

[media] media-devnode.h: Fix documentation

Two parameters were documented with a wrong name, and a struct
device pointer description was missing.

That caused the following warnings, when building documentation:

include/media/media-devnode.h:102: warning: No description found for parameter 'media_dev'
include/media/media-devnode.h:126: warning: No description found for parameter 'mdev'
include/media/media-devnode.h:126: warning: Excess function parameter 'media_dev' description in 'media_devnode_register'

Rename the description, to match the function parameter and fix
Documentation.

No funcional changes.

Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
Mauro Carvalho Chehab 9 years ago
parent
commit
0db5c79989
1 changed files with 3 additions and 2 deletions
  1. 3 2
      include/media/media-devnode.h

+ 3 - 2
include/media/media-devnode.h

@@ -69,8 +69,9 @@ struct media_file_operations {
 
 
 /**
 /**
  * struct media_devnode - Media device node
  * struct media_devnode - Media device node
+ * @media_dev:	pointer to struct &media_device
  * @fops:	pointer to struct &media_file_operations with media device ops
  * @fops:	pointer to struct &media_file_operations with media device ops
- * @dev:	struct device pointer for the media controller device
+ * @dev:	pointer to struct &device containing the media controller device
  * @cdev:	struct cdev pointer character device
  * @cdev:	struct cdev pointer character device
  * @parent:	parent device
  * @parent:	parent device
  * @minor:	device node minor number
  * @minor:	device node minor number
@@ -107,7 +108,7 @@ struct media_devnode {
 /**
 /**
  * media_devnode_register - register a media device node
  * media_devnode_register - register a media device node
  *
  *
- * @media_dev: struct media_device we want to register a device node
+ * @mdev: struct media_device we want to register a device node
  * @devnode: media device node structure we want to register
  * @devnode: media device node structure we want to register
  * @owner: should be filled with %THIS_MODULE
  * @owner: should be filled with %THIS_MODULE
  *
  *