Commit 6806fc7f authored Sep 10, 2020 by Lee Jones Committed by Kalle Valo Oct 08, 2020

iwlwifi: dvm: devices: Fix function documentation formatting issues

Kerneldoc expects attributes/parameters to be in '@*.: ' format and
gets confused if the variable does not follow the type/attribute
definitions.

Fixes the following W=1 kernel build warning(s):

drivers/net/wireless/intel/iwlwifi/dvm/devices.c:66: warning: Function parameter or member 'priv' not described in 'iwl_beacon_time_mask_low'
drivers/net/wireless/intel/iwlwifi/dvm/devices.c:66: warning: Function parameter or member 'tsf_bits' not described in 'iwl_beacon_time_mask_low'
drivers/net/wireless/intel/iwlwifi/dvm/devices.c:77: warning: Function parameter or member 'priv' not described in 'iwl_beacon_time_mask_high'
drivers/net/wireless/intel/iwlwifi/dvm/devices.c:77: warning: Function parameter or member 'tsf_bits' not described in 'iwl_beacon_time_mask_high'

Cc: Johannes Berg <johannes.berg@intel.com>
Cc: Emmanuel Grumbach <emmanuel.grumbach@intel.com>
Cc: Luca Coelho <luciano.coelho@intel.com>
Cc: Intel Linux Wireless <linuxwifi@intel.com>
Cc: Kalle Valo <kvalo@codeaurora.org>
Cc: "David S. Miller" <davem@davemloft.net>
Cc: Jakub Kicinski <kuba@kernel.org>
Cc: linux-wireless@vger.kernel.org
Cc: netdev@vger.kernel.org
Signed-off-by: Lee Jones <lee.jones@linaro.org>
Signed-off-by: Kalle Valo <kvalo@codeaurora.org>
Link: https://lore.kernel.org/r/20200910065431.657636-15-lee.jones@linaro.org

parent 91b4780f

drivers/net/wireless/intel/iwlwifi/dvm/devices.c

+4 −4

Original line number	Diff line number	Diff line
		@@ -58,8 +58,8 @@ static void iwl1000_nic_config(struct iwl_priv *priv)

		/**
		* iwl_beacon_time_mask_low - mask of lower 32 bit of beacon time
		* @priv -- pointer to iwl_priv data structure
		* @tsf_bits -- number of bits need to shift for masking)
		* @priv: pointer to iwl_priv data structure
		* @tsf_bits: number of bits need to shift for masking)
		*/
		static inline u32 iwl_beacon_time_mask_low(struct iwl_priv *priv,
		u16 tsf_bits)
		@@ -69,8 +69,8 @@ static inline u32 iwl_beacon_time_mask_low(struct iwl_priv *priv,

		/**
		* iwl_beacon_time_mask_high - mask of higher 32 bit of beacon time
		* @priv -- pointer to iwl_priv data structure
		* @tsf_bits -- number of bits need to shift for masking)
		* @priv: pointer to iwl_priv data structure
		* @tsf_bits: number of bits need to shift for masking)
		*/
		static inline u32 iwl_beacon_time_mask_high(struct iwl_priv *priv,
		u16 tsf_bits)