Commit d156f293 authored by Mauro Carvalho Chehab's avatar Mauro Carvalho Chehab

media: radio-si476x: fix kernel-doc markups

get rid of the following warnings:
  drivers/media/radio/radio-si476x.c:317: warning: No description found for parameter 'v4l2dev'
  drivers/media/radio/radio-si476x.c:317: warning: No description found for parameter 'ctrl_handler'
  drivers/media/radio/radio-si476x.c:317: warning: No description found for parameter 'debugfs'
  drivers/media/radio/radio-si476x.c:317: warning: No description found for parameter 'audmode'
  drivers/media/radio/radio-si476x.c:317: warning: Excess struct member 'kref' description in 'si476x_radio'
  drivers/media/radio/radio-si476x.c:317: warning: Excess struct member 'core_lock' description in 'si476x_radio'
Signed-off-by: default avatarMauro Carvalho Chehab <mchehab@s-opensource.com>
parent 4521af78
...@@ -158,7 +158,7 @@ enum si476x_ctrl_idx { ...@@ -158,7 +158,7 @@ enum si476x_ctrl_idx {
}; };
static struct v4l2_ctrl_config si476x_ctrls[] = { static struct v4l2_ctrl_config si476x_ctrls[] = {
/** /*
* SI476X during its station seeking(or tuning) process uses several * SI476X during its station seeking(or tuning) process uses several
* parameters to detrmine if "the station" is valid: * parameters to detrmine if "the station" is valid:
* *
...@@ -197,7 +197,7 @@ static struct v4l2_ctrl_config si476x_ctrls[] = { ...@@ -197,7 +197,7 @@ static struct v4l2_ctrl_config si476x_ctrls[] = {
.step = 2, .step = 2,
}, },
/** /*
* #V4L2_CID_SI476X_HARMONICS_COUNT -- number of harmonics * #V4L2_CID_SI476X_HARMONICS_COUNT -- number of harmonics
* built-in power-line noise supression filter is to reject * built-in power-line noise supression filter is to reject
* during AM-mode operation. * during AM-mode operation.
...@@ -213,7 +213,7 @@ static struct v4l2_ctrl_config si476x_ctrls[] = { ...@@ -213,7 +213,7 @@ static struct v4l2_ctrl_config si476x_ctrls[] = {
.step = 1, .step = 1,
}, },
/** /*
* #V4L2_CID_SI476X_DIVERSITY_MODE -- configuration which * #V4L2_CID_SI476X_DIVERSITY_MODE -- configuration which
* two tuners working in diversity mode are to work in. * two tuners working in diversity mode are to work in.
* *
...@@ -237,7 +237,7 @@ static struct v4l2_ctrl_config si476x_ctrls[] = { ...@@ -237,7 +237,7 @@ static struct v4l2_ctrl_config si476x_ctrls[] = {
.max = ARRAY_SIZE(phase_diversity_modes) - 1, .max = ARRAY_SIZE(phase_diversity_modes) - 1,
}, },
/** /*
* #V4L2_CID_SI476X_INTERCHIP_LINK -- inter-chip link in * #V4L2_CID_SI476X_INTERCHIP_LINK -- inter-chip link in
* diversity mode indicator. Allows user to determine if two * diversity mode indicator. Allows user to determine if two
* chips working in diversity mode have established a link * chips working in diversity mode have established a link
...@@ -296,11 +296,15 @@ struct si476x_radio_ops { ...@@ -296,11 +296,15 @@ struct si476x_radio_ops {
/** /**
* struct si476x_radio - radio device * struct si476x_radio - radio device
* *
* @core: Pointer to underlying core device * @v4l2dev: Pointer to V4L2 device created by V4L2 subsystem
* @videodev: Pointer to video device created by V4L2 subsystem * @videodev: Pointer to video device created by V4L2 subsystem
* @ctrl_handler: V4L2 controls handler
* @core: Pointer to underlying core device
* @ops: Vtable of functions. See struct si476x_radio_ops for details * @ops: Vtable of functions. See struct si476x_radio_ops for details
* @kref: Reference counter * @debugfs: pointer to &strucd dentry for debugfs
* @core_lock: An r/w semaphore to brebvent the deletion of underlying * @audmode: audio mode, as defined for the rxsubchans field
* at videodev2.h
*
* core structure is the radio device is being used * core structure is the radio device is being used
*/ */
struct si476x_radio { struct si476x_radio {
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment