Commit dd13d6dc authored Aug 26, 2020 by Lee Jones Committed by Kalle Valo Sep 01, 2020

iwlegacy: 3945-mac: Remove all non-conformant kernel-doc headers

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

drivers/net/wireless/intel/iwlegacy/3945-mac.c:821: warning: Function parameter or member 'il' not described in 'il3945_setup_handlers'
drivers/net/wireless/intel/iwlegacy/3945-mac.c:915: warning: Function parameter or member 'il' not described in 'il3945_dma_addr2rbd_ptr'
drivers/net/wireless/intel/iwlegacy/3945-mac.c:915: warning: Function parameter or member 'dma_addr' not described in 'il3945_dma_addr2rbd_ptr'
drivers/net/wireless/intel/iwlegacy/3945-mac.c:932: warning: Function parameter or member 'il' not described in 'il3945_rx_queue_restock'
drivers/net/wireless/intel/iwlegacy/3945-mac.c:979: warning: Function parameter or member 'il' not described in 'il3945_rx_allocate'
drivers/net/wireless/intel/iwlegacy/3945-mac.c:979: warning: Function parameter or member 'priority' not described in 'il3945_rx_allocate'
drivers/net/wireless/intel/iwlegacy/3945-mac.c:1179: warning: Function parameter or member 'il' not described in 'il3945_rx_handle'
drivers/net/wireless/intel/iwlegacy/3945-mac.c:1663: warning: Function parameter or member 'il' not described in 'il3945_verify_inst_full'
drivers/net/wireless/intel/iwlegacy/3945-mac.c:1663: warning: Function parameter or member 'image' not described in 'il3945_verify_inst_full'
drivers/net/wireless/intel/iwlegacy/3945-mac.c:1663: warning: Function parameter or member 'len' not described in 'il3945_verify_inst_full'
drivers/net/wireless/intel/iwlegacy/3945-mac.c:1703: warning: Function parameter or member 'il' not described in 'il3945_verify_inst_sparse'
drivers/net/wireless/intel/iwlegacy/3945-mac.c:1703: warning: Function parameter or member 'image' not described in 'il3945_verify_inst_sparse'
drivers/net/wireless/intel/iwlegacy/3945-mac.c:1703: warning: Function parameter or member 'len' not described in 'il3945_verify_inst_sparse'
drivers/net/wireless/intel/iwlegacy/3945-mac.c:1739: warning: Function parameter or member 'il' not described in 'il3945_verify_ucode'
drivers/net/wireless/intel/iwlegacy/3945-mac.c:1821: warning: Function parameter or member 'il' not described in 'il3945_read_ucode'
drivers/net/wireless/intel/iwlegacy/3945-mac.c:2061: warning: Function parameter or member 'il' not described in 'il3945_set_ucode_ptrs'
drivers/net/wireless/intel/iwlegacy/3945-mac.c:2093: warning: Function parameter or member 'il' not described in 'il3945_init_alive_start'
drivers/net/wireless/intel/iwlegacy/3945-mac.c:2135: warning: Function parameter or member 'il' not described in 'il3945_alive_start'

Cc: Stanislaw Gruszka <stf_xl@wp.pl>
Cc: Kalle Valo <kvalo@codeaurora.org>
Cc: "David S. Miller" <davem@davemloft.net>
Cc: Jakub Kicinski <kuba@kernel.org>
Cc: Linux Wireless <ilw@linux.intel.com>
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/20200826093401.1458456-4-lee.jones@linaro.org

parent f5c3bf15

drivers/net/wireless/intel/iwlegacy/3945-mac.c

+12 −12

Original line number	Diff line number	Diff line
		@@ -807,7 +807,7 @@ il3945_hdl_card_state(struct il_priv il, struct il_rx_buf rxb)
		wake_up(&il->wait_command_queue);
		}

		/**
		/*
		* il3945_setup_handlers - Initialize Rx handler callbacks
		*
		* Setup the RX handlers for each of the reply types sent from the uCode
		@@ -907,7 +907,7 @@ il3945_setup_handlers(struct il_priv *il)
		*
		*/

		/**
		/*
		* il3945_dma_addr2rbd_ptr - convert a DMA address to a uCode read buffer ptr
		*/
		static inline __le32
		@@ -916,7 +916,7 @@ il3945_dma_addr2rbd_ptr(struct il_priv *il, dma_addr_t dma_addr)
		return cpu_to_le32((u32) dma_addr);
		}

		/**
		/*
		* il3945_rx_queue_restock - refill RX queue from pre-allocated pool
		*
		* If there are slots in the RX queue that need to be restocked,
		@@ -966,7 +966,7 @@ il3945_rx_queue_restock(struct il_priv *il)
		}
		}

		/**
		/*
		* il3945_rx_replenish - Move all used packet from rx_used to rx_free
		*
		* When moving to rx_free an SKB is allocated for the slot.
		@@ -1167,7 +1167,7 @@ il3945_calc_db_from_ratio(int sig_ratio)
		return (int)ratio2dB[sig_ratio];
		}

		/**
		/*
		* il3945_rx_handle - Main entry function for receiving responses from uCode
		*
		* Uses the il->handlers callback function array to invoke
		@@ -1654,7 +1654,7 @@ il3945_dealloc_ucode_pci(struct il_priv *il)
		il_free_fw_desc(il->pci_dev, &il->ucode_boot);
		}

		/**
		/*
		* il3945_verify_inst_full - verify runtime uCode image in card vs. host,
		* looking at all data.
		*/
		@@ -1693,7 +1693,7 @@ il3945_verify_inst_full(struct il_priv il, __le32 image, u32 len)
		return rc;
		}

		/**
		/*
		* il3945_verify_inst_sparse - verify runtime uCode image in card vs. host,
		* using sample data 100 bytes apart. If these sample points are good,
		* it's a pretty good bet that everything between them is good, too.
		@@ -1730,7 +1730,7 @@ il3945_verify_inst_sparse(struct il_priv il, __le32 image, u32 len)
		return rc;
		}

		/**
		/*
		* il3945_verify_ucode - determine which instruction image is in SRAM,
		* and verify its contents
		*/
		@@ -1811,7 +1811,7 @@ IL3945_UCODE_GET(init_size);
		IL3945_UCODE_GET(init_data_size);
		IL3945_UCODE_GET(boot_size);

		/**
		/*
		* il3945_read_ucode - Read uCode images from disk file.
		*
		* Copy into buffers for card to fetch via bus-mastering
		@@ -2047,7 +2047,7 @@ il3945_read_ucode(struct il_priv *il)
		return ret;
		}

		/**
		/*
		* il3945_set_ucode_ptrs - Set uCode address location
		*
		* Tell initialization uCode where to find runtime uCode.
		@@ -2081,7 +2081,7 @@ il3945_set_ucode_ptrs(struct il_priv *il)
		return 0;
		}

		/**
		/*
		* il3945_init_alive_start - Called after N_ALIVE notification received
		*
		* Called after N_ALIVE notification received from "initialize" uCode.
		@@ -2125,7 +2125,7 @@ il3945_init_alive_start(struct il_priv *il)
		queue_work(il->workqueue, &il->restart);
		}

		/**
		/*
		* il3945_alive_start - called after N_ALIVE notification received
		* from protocol/runtime uCode (initialization uCode's
		* Alive gets handled by il3945_init_alive_start()).