Commit 9745ef7d authored by Lee Jones's avatar Lee Jones

mfd: si476x-cmd: Add missing colon(s) for all documented kerneldoc arguments

Kerneldoc validation gets confused if syntax isn't "@.*: ".

Adding the missing colons squashes the following W=1 warnings:

 drivers/mfd/si476x-cmd.c:525: warning: Function parameter or member 'dout' not described in 'si476x_core_cmd_dig_audio_pin_c
 drivers/mfd/si476x-cmd.c:525: warning: Function parameter or member 'xout' not described in 'si476x_core_cmd_dig_audio_pin_c
 drivers/mfd/si476x-cmd.c:574: warning: Function parameter or member 'core' not described in 'si476x_core_cmd_zif_pin_cfg'
 drivers/mfd/si476x-cmd.c:574: warning: Function parameter or member 'iqclk' not described in 'si476x_core_cmd_zif_pin_cfg'
 drivers/mfd/si476x-cmd.c:574: warning: Function parameter or member 'iqfs' not described in 'si476x_core_cmd_zif_pin_cfg'
 drivers/mfd/si476x-cmd.c:574: warning: Function parameter or member 'iout' not described in 'si476x_core_cmd_zif_pin_cfg'
 drivers/mfd/si476x-cmd.c:574: warning: Function parameter or member 'qout' not described in 'si476x_core_cmd_zif_pin_cfg'
 drivers/mfd/si476x-i2c.c:550: warning: Function parameter or member 'func' not described in 'si476x_core_fwver_to_revision'
 drivers/mfd/si476x-cmd.c:631: warning: Function parameter or member 'core' not described in 'si476x_core_cmd_ic_link_gpo_ctl
 drivers/mfd/si476x-cmd.c:631: warning: Function parameter or member 'icin' not described in 'si476x_core_cmd_ic_link_gpo_ctl
 drivers/mfd/si476x-cmd.c:631: warning: Function parameter or member 'icip' not described in 'si476x_core_cmd_ic_link_gpo_ctl
 drivers/mfd/si476x-cmd.c:631: warning: Function parameter or member 'icon' not described in 'si476x_core_cmd_ic_link_gpo_ctl
 drivers/mfd/si476x-cmd.c:631: warning: Function parameter or member 'icop' not described in 'si476x_core_cmd_ic_link_gpo_ctl
 drivers/mfd/si476x-cmd.c:662: warning: Function parameter or member 'core' not described in 'si476x_core_cmd_ana_audio_pin_c
 drivers/mfd/si476x-cmd.c:662: warning: Function parameter or member 'lrout' not described in 'si476x_core_cmd_ana_audio_pin_
 drivers/mfd/si476x-cmd.c:697: warning: Function parameter or member 'core' not described in 'si476x_core_cmd_intb_pin_cfg_a1
 drivers/mfd/si476x-cmd.c:697: warning: Function parameter or member 'intb' not described in 'si476x_core_cmd_intb_pin_cfg_a1
 drivers/mfd/si476x-cmd.c:697: warning: Function parameter or member 'a1' not described in 'si476x_core_cmd_intb_pin_cfg_a10'
 drivers/mfd/si476x-cmd.c:746: warning: Function parameter or member 'core' not described in 'si476x_core_cmd_am_rsq_status'
 drivers/mfd/si476x-cmd.c:746: warning: Function parameter or member 'rsqargs' not described in 'si476x_core_cmd_am_rsq_statu
 drivers/mfd/si476x-cmd.c:746: warning: Function parameter or member 'report' not described in 'si476x_core_cmd_am_rsq_status
 drivers/mfd/si476x-cmd.c:878: warning: Function parameter or member 'core' not described in 'si476x_core_cmd_fm_seek_start'
 drivers/mfd/si476x-cmd.c:878: warning: Function parameter or member 'seekup' not described in 'si476x_core_cmd_fm_seek_start
 drivers/mfd/si476x-cmd.c:878: warning: Function parameter or member 'wrap' not described in 'si476x_core_cmd_fm_seek_start'
 drivers/mfd/si476x-cmd.c:907: warning: Function parameter or member 'core' not described in 'si476x_core_cmd_fm_rds_status'
 drivers/mfd/si476x-cmd.c:907: warning: Function parameter or member 'status_only' not described in 'si476x_core_cmd_fm_rds_s
 drivers/mfd/si476x-cmd.c:907: warning: Function parameter or member 'mtfifo' not described in 'si476x_core_cmd_fm_rds_status
 drivers/mfd/si476x-cmd.c:907: warning: Function parameter or member 'intack' not described in 'si476x_core_cmd_fm_rds_status
 drivers/mfd/si476x-cmd.c:907: warning: Function parameter or member 'report' not described in 'si476x_core_cmd_fm_rds_status
 drivers/mfd/si476x-cmd.c:1052: warning: Function parameter or member 'core' not described in 'si476x_core_cmd_am_seek_start'
 drivers/mfd/si476x-cmd.c:1052: warning: Function parameter or member 'seekup' not described in 'si476x_core_cmd_am_seek_star
 drivers/mfd/si476x-cmd.c:1052: warning: Function parameter or member 'wrap' not described in 'si476x_core_cmd_am_seek_start'

Cc: Andrey Smirnov <andrew.smirnov@gmail.com>
Signed-off-by: default avatarLee Jones <lee.jones@linaro.org>
parent 3c719388
...@@ -496,7 +496,7 @@ EXPORT_SYMBOL_GPL(si476x_core_cmd_get_property); ...@@ -496,7 +496,7 @@ EXPORT_SYMBOL_GPL(si476x_core_cmd_get_property);
* enable 1MOhm pulldown * enable 1MOhm pulldown
* SI476X_DFS_DAUDIO - set the pin to be a part of digital * SI476X_DFS_DAUDIO - set the pin to be a part of digital
* audio interface * audio interface
* @dout - DOUT pin function configuration: * @dout: - DOUT pin function configuration:
* SI476X_DOUT_NOOP - do not modify the behaviour * SI476X_DOUT_NOOP - do not modify the behaviour
* SI476X_DOUT_TRISTATE - put the pin in tristate condition, * SI476X_DOUT_TRISTATE - put the pin in tristate condition,
* enable 1MOhm pulldown * enable 1MOhm pulldown
...@@ -504,7 +504,7 @@ EXPORT_SYMBOL_GPL(si476x_core_cmd_get_property); ...@@ -504,7 +504,7 @@ EXPORT_SYMBOL_GPL(si476x_core_cmd_get_property);
* port 1 * port 1
* SI476X_DOUT_I2S_INPUT - set this pin to be digital in on I2S * SI476X_DOUT_I2S_INPUT - set this pin to be digital in on I2S
* port 1 * port 1
* @xout - XOUT pin function configuration: * @xout: - XOUT pin function configuration:
* SI476X_XOUT_NOOP - do not modify the behaviour * SI476X_XOUT_NOOP - do not modify the behaviour
* SI476X_XOUT_TRISTATE - put the pin in tristate condition, * SI476X_XOUT_TRISTATE - put the pin in tristate condition,
* enable 1MOhm pulldown * enable 1MOhm pulldown
...@@ -540,25 +540,25 @@ EXPORT_SYMBOL_GPL(si476x_core_cmd_dig_audio_pin_cfg); ...@@ -540,25 +540,25 @@ EXPORT_SYMBOL_GPL(si476x_core_cmd_dig_audio_pin_cfg);
/** /**
* si476x_cmd_zif_pin_cfg - send 'ZIF_PIN_CFG_COMMAND' * si476x_cmd_zif_pin_cfg - send 'ZIF_PIN_CFG_COMMAND'
* @core - device to send the command to * @core: - device to send the command to
* @iqclk - IQCL pin function configuration: * @iqclk: - IQCL pin function configuration:
* SI476X_IQCLK_NOOP - do not modify the behaviour * SI476X_IQCLK_NOOP - do not modify the behaviour
* SI476X_IQCLK_TRISTATE - put the pin in tristate condition, * SI476X_IQCLK_TRISTATE - put the pin in tristate condition,
* enable 1MOhm pulldown * enable 1MOhm pulldown
* SI476X_IQCLK_IQ - set pin to be a part of I/Q interace * SI476X_IQCLK_IQ - set pin to be a part of I/Q interace
* in master mode * in master mode
* @iqfs - IQFS pin function configuration: * @iqfs: - IQFS pin function configuration:
* SI476X_IQFS_NOOP - do not modify the behaviour * SI476X_IQFS_NOOP - do not modify the behaviour
* SI476X_IQFS_TRISTATE - put the pin in tristate condition, * SI476X_IQFS_TRISTATE - put the pin in tristate condition,
* enable 1MOhm pulldown * enable 1MOhm pulldown
* SI476X_IQFS_IQ - set pin to be a part of I/Q interace * SI476X_IQFS_IQ - set pin to be a part of I/Q interace
* in master mode * in master mode
* @iout - IOUT pin function configuration: * @iout: - IOUT pin function configuration:
* SI476X_IOUT_NOOP - do not modify the behaviour * SI476X_IOUT_NOOP - do not modify the behaviour
* SI476X_IOUT_TRISTATE - put the pin in tristate condition, * SI476X_IOUT_TRISTATE - put the pin in tristate condition,
* enable 1MOhm pulldown * enable 1MOhm pulldown
* SI476X_IOUT_OUTPUT - set pin to be I out * SI476X_IOUT_OUTPUT - set pin to be I out
* @qout - QOUT pin function configuration: * @qout: - QOUT pin function configuration:
* SI476X_QOUT_NOOP - do not modify the behaviour * SI476X_QOUT_NOOP - do not modify the behaviour
* SI476X_QOUT_TRISTATE - put the pin in tristate condition, * SI476X_QOUT_TRISTATE - put the pin in tristate condition,
* enable 1MOhm pulldown * enable 1MOhm pulldown
...@@ -590,29 +590,29 @@ EXPORT_SYMBOL_GPL(si476x_core_cmd_zif_pin_cfg); ...@@ -590,29 +590,29 @@ EXPORT_SYMBOL_GPL(si476x_core_cmd_zif_pin_cfg);
/** /**
* si476x_cmd_ic_link_gpo_ctl_pin_cfg - send * si476x_cmd_ic_link_gpo_ctl_pin_cfg - send
* 'IC_LINK_GPIO_CTL_PIN_CFG' comand to the device * 'IC_LINK_GPIO_CTL_PIN_CFG' comand to the device
* @core - device to send the command to * @core: - device to send the command to
* @icin - ICIN pin function configuration: * @icin: - ICIN pin function configuration:
* SI476X_ICIN_NOOP - do not modify the behaviour * SI476X_ICIN_NOOP - do not modify the behaviour
* SI476X_ICIN_TRISTATE - put the pin in tristate condition, * SI476X_ICIN_TRISTATE - put the pin in tristate condition,
* enable 1MOhm pulldown * enable 1MOhm pulldown
* SI476X_ICIN_GPO1_HIGH - set pin to be an output, drive it high * SI476X_ICIN_GPO1_HIGH - set pin to be an output, drive it high
* SI476X_ICIN_GPO1_LOW - set pin to be an output, drive it low * SI476X_ICIN_GPO1_LOW - set pin to be an output, drive it low
* SI476X_ICIN_IC_LINK - set the pin to be a part of Inter-Chip link * SI476X_ICIN_IC_LINK - set the pin to be a part of Inter-Chip link
* @icip - ICIP pin function configuration: * @icip: - ICIP pin function configuration:
* SI476X_ICIP_NOOP - do not modify the behaviour * SI476X_ICIP_NOOP - do not modify the behaviour
* SI476X_ICIP_TRISTATE - put the pin in tristate condition, * SI476X_ICIP_TRISTATE - put the pin in tristate condition,
* enable 1MOhm pulldown * enable 1MOhm pulldown
* SI476X_ICIP_GPO1_HIGH - set pin to be an output, drive it high * SI476X_ICIP_GPO1_HIGH - set pin to be an output, drive it high
* SI476X_ICIP_GPO1_LOW - set pin to be an output, drive it low * SI476X_ICIP_GPO1_LOW - set pin to be an output, drive it low
* SI476X_ICIP_IC_LINK - set the pin to be a part of Inter-Chip link * SI476X_ICIP_IC_LINK - set the pin to be a part of Inter-Chip link
* @icon - ICON pin function configuration: * @icon: - ICON pin function configuration:
* SI476X_ICON_NOOP - do not modify the behaviour * SI476X_ICON_NOOP - do not modify the behaviour
* SI476X_ICON_TRISTATE - put the pin in tristate condition, * SI476X_ICON_TRISTATE - put the pin in tristate condition,
* enable 1MOhm pulldown * enable 1MOhm pulldown
* SI476X_ICON_I2S - set the pin to be a part of audio * SI476X_ICON_I2S - set the pin to be a part of audio
* interface in slave mode (DCLK) * interface in slave mode (DCLK)
* SI476X_ICON_IC_LINK - set the pin to be a part of Inter-Chip link * SI476X_ICON_IC_LINK - set the pin to be a part of Inter-Chip link
* @icop - ICOP pin function configuration: * @icop: - ICOP pin function configuration:
* SI476X_ICOP_NOOP - do not modify the behaviour * SI476X_ICOP_NOOP - do not modify the behaviour
* SI476X_ICOP_TRISTATE - put the pin in tristate condition, * SI476X_ICOP_TRISTATE - put the pin in tristate condition,
* enable 1MOhm pulldown * enable 1MOhm pulldown
...@@ -647,8 +647,8 @@ EXPORT_SYMBOL_GPL(si476x_core_cmd_ic_link_gpo_ctl_pin_cfg); ...@@ -647,8 +647,8 @@ EXPORT_SYMBOL_GPL(si476x_core_cmd_ic_link_gpo_ctl_pin_cfg);
/** /**
* si476x_cmd_ana_audio_pin_cfg - send 'ANA_AUDIO_PIN_CFG' to the * si476x_cmd_ana_audio_pin_cfg - send 'ANA_AUDIO_PIN_CFG' to the
* device * device
* @core - device to send the command to * @core: - device to send the command to
* @lrout - LROUT pin function configuration: * @lrout: - LROUT pin function configuration:
* SI476X_LROUT_NOOP - do not modify the behaviour * SI476X_LROUT_NOOP - do not modify the behaviour
* SI476X_LROUT_TRISTATE - put the pin in tristate condition, * SI476X_LROUT_TRISTATE - put the pin in tristate condition,
* enable 1MOhm pulldown * enable 1MOhm pulldown
...@@ -675,15 +675,15 @@ EXPORT_SYMBOL_GPL(si476x_core_cmd_ana_audio_pin_cfg); ...@@ -675,15 +675,15 @@ EXPORT_SYMBOL_GPL(si476x_core_cmd_ana_audio_pin_cfg);
/** /**
* si476x_cmd_intb_pin_cfg - send 'INTB_PIN_CFG' command to the device * si476x_cmd_intb_pin_cfg - send 'INTB_PIN_CFG' command to the device
* @core - device to send the command to * @core: - device to send the command to
* @intb - INTB pin function configuration: * @intb: - INTB pin function configuration:
* SI476X_INTB_NOOP - do not modify the behaviour * SI476X_INTB_NOOP - do not modify the behaviour
* SI476X_INTB_TRISTATE - put the pin in tristate condition, * SI476X_INTB_TRISTATE - put the pin in tristate condition,
* enable 1MOhm pulldown * enable 1MOhm pulldown
* SI476X_INTB_DAUDIO - set pin to be a part of digital * SI476X_INTB_DAUDIO - set pin to be a part of digital
* audio interface in slave mode * audio interface in slave mode
* SI476X_INTB_IRQ - set pin to be an interrupt request line * SI476X_INTB_IRQ - set pin to be an interrupt request line
* @a1 - A1 pin function configuration: * @a1: - A1 pin function configuration:
* SI476X_A1_NOOP - do not modify the behaviour * SI476X_A1_NOOP - do not modify the behaviour
* SI476X_A1_TRISTATE - put the pin in tristate condition, * SI476X_A1_TRISTATE - put the pin in tristate condition,
* enable 1MOhm pulldown * enable 1MOhm pulldown
...@@ -728,14 +728,14 @@ static int si476x_core_cmd_intb_pin_cfg_a20(struct si476x_core *core, ...@@ -728,14 +728,14 @@ static int si476x_core_cmd_intb_pin_cfg_a20(struct si476x_core *core,
/** /**
* si476x_cmd_am_rsq_status - send 'AM_RSQ_STATUS' command to the * si476x_cmd_am_rsq_status - send 'AM_RSQ_STATUS' command to the
* device * device
* @core - device to send the command to * @core: - device to send the command to
* @rsqack - if set command clears RSQINT, SNRINT, SNRLINT, RSSIHINT, * @rsqack: - if set command clears RSQINT, SNRINT, SNRLINT, RSSIHINT,
* RSSSILINT, BLENDINT, MULTHINT and MULTLINT * RSSSILINT, BLENDINT, MULTHINT and MULTLINT
* @attune - when set the values in the status report are the values * @attune: - when set the values in the status report are the values
* that were calculated at tune * that were calculated at tune
* @cancel - abort ongoing seek/tune opertation * @cancel: - abort ongoing seek/tune opertation
* @stcack - clear the STCINT bin in status register * @stcack: - clear the STCINT bin in status register
* @report - all signal quality information retured by the command * @report: - all signal quality information retured by the command
* (if NULL then the output of the command is ignored) * (if NULL then the output of the command is ignored)
* *
* Function returns 0 on success and negative error code on failure * Function returns 0 on success and negative error code on failure
...@@ -862,9 +862,9 @@ EXPORT_SYMBOL_GPL(si476x_core_cmd_am_acf_status); ...@@ -862,9 +862,9 @@ EXPORT_SYMBOL_GPL(si476x_core_cmd_am_acf_status);
/** /**
* si476x_cmd_fm_seek_start - send 'FM_SEEK_START' command to the * si476x_cmd_fm_seek_start - send 'FM_SEEK_START' command to the
* device * device
* @core - device to send the command to * @core: - device to send the command to
* @seekup - if set the direction of the search is 'up' * @seekup: - if set the direction of the search is 'up'
* @wrap - if set seek wraps when hitting band limit * @wrap: - if set seek wraps when hitting band limit
* *
* This function begins search for a valid station. The station is * This function begins search for a valid station. The station is
* considered valid when 'FM_VALID_SNR_THRESHOLD' and * considered valid when 'FM_VALID_SNR_THRESHOLD' and
...@@ -890,12 +890,12 @@ EXPORT_SYMBOL_GPL(si476x_core_cmd_fm_seek_start); ...@@ -890,12 +890,12 @@ EXPORT_SYMBOL_GPL(si476x_core_cmd_fm_seek_start);
/** /**
* si476x_cmd_fm_rds_status - send 'FM_RDS_STATUS' command to the * si476x_cmd_fm_rds_status - send 'FM_RDS_STATUS' command to the
* device * device
* @core - device to send the command to * @core: - device to send the command to
* @status_only - if set the data is not removed from RDSFIFO, * @status_only: - if set the data is not removed from RDSFIFO,
* RDSFIFOUSED is not decremented and data in all the * RDSFIFOUSED is not decremented and data in all the
* rest RDS data contains the last valid info received * rest RDS data contains the last valid info received
* @mtfifo if set the command clears RDS receive FIFO * @mtfifo: if set the command clears RDS receive FIFO
* @intack if set the command clards the RDSINT bit. * @intack: if set the command clards the RDSINT bit.
* *
* Function returns 0 on success and negative error code on failure * Function returns 0 on success and negative error code on failure
*/ */
...@@ -1036,9 +1036,9 @@ EXPORT_SYMBOL_GPL(si476x_core_cmd_fm_phase_div_status); ...@@ -1036,9 +1036,9 @@ EXPORT_SYMBOL_GPL(si476x_core_cmd_fm_phase_div_status);
/** /**
* si476x_cmd_am_seek_start - send 'FM_SEEK_START' command to the * si476x_cmd_am_seek_start - send 'FM_SEEK_START' command to the
* device * device
* @core - device to send the command to * @core: - device to send the command to
* @seekup - if set the direction of the search is 'up' * @seekup: - if set the direction of the search is 'up'
* @wrap - if set seek wraps when hitting band limit * @wrap: - if set seek wraps when hitting band limit
* *
* This function begins search for a valid station. The station is * This function begins search for a valid station. The station is
* considered valid when 'FM_VALID_SNR_THRESHOLD' and * considered valid when 'FM_VALID_SNR_THRESHOLD' and
......
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