get rid of "== PROC" comments

1 files changed, 50 insertions, 42 deletions

diff --git a/at76_usb.c b/at76_usb.c
index 01cf5a0..12a3036 100644
--- a/at76_usb.c
+++ b/at76_usb.c
@@ -346,8 +346,7 @@ struct dfu_ctx *dfu_alloc_ctx(struct usb_device *udev)
 	return ctx;
 }
 
-/* == PROC usbdfu_download ==
-   if manifest_sync_timeout > 0 use this timeout (in msec) instead of the
+/* if manifest_sync_timeout > 0 use this timeout (in msec) instead of the
    one reported by the device in state MANIFEST_SYNC */
 static int usbdfu_download(struct usb_device *udev, u8 *dfu_buffer,
 			   u32 dfu_len, int manifest_sync_timeout)
@@ -550,12 +549,7 @@ static char *hex2str(char *obuf, u8 *buf, int len, char delim)
   return ret;
 }
 
-/* == PROC is_cloaked_ssid ==
-   returns != 0, if the given SSID is a cloaked one:
-   - length 0
-   - length > 0, all bytes are \0
-   - length == 1, SSID ' '
-*/
+/* check if the given sisd is cloaked */
 static inline int is_cloaked_ssid(u8 *ssid, int length)
 {
 	static const u8 zeros[32];
@@ -744,7 +738,7 @@ static int get_hw_config(struct at76c503 *dev)
 	return ret;
 }
 
-/* == PROC getRegDomain == */
+
 static struct reg_domain const *getRegDomain(u16 code)
 {
 	static struct reg_domain const fd_tab[] = {
@@ -964,8 +958,10 @@ static int set_radio(struct at76c503 *dev, int on_off)
 }
 
 
-/* == PROC set_pm_mode ==
-   sets power save modi (PM_ACTIVE/PM_SAVE/PM_SMART_SAVE) */
+/** 
+ * set_pm_mode - sets power save mode
+ * (PM_ACTIVE/PM_SAVE/PM_SMART_SAVE)
+ */
 static int set_pm_mode(struct at76c503 *dev, u8 mode)
 {
 	int ret = 0;
@@ -984,8 +980,7 @@ static int set_pm_mode(struct at76c503 *dev, u8 mode)
 	return ret;
 }
 
-/* == PROC set_associd ==
-   sets the assoc id for power save mode */
+/* sets the assoc id for power save mode */
 static int set_associd(struct at76c503 *dev, u16 id)
 {
 	int ret = 0;
@@ -1005,8 +1000,7 @@ static int set_associd(struct at76c503 *dev, u16 id)
 	return ret;
 }
 
-/* == PROC set_listen_interval ==
-   sets the listen interval for power save mode.
+/* sets the listen interval for power save mode.
    really needed, as we have a similar parameter in the assocreq ??? */
 static int set_listen_interval(struct at76c503 *dev, u16 interval)
 {
@@ -1507,10 +1501,12 @@ static int get_current_channel(struct at76c503 *dev)
 	return ret;
 }
 
-/* == PROC start_scan ==
-  start a scan. use_essid is != 0 if any probe_delay (if scan mode is not 
-  passive) should contain the ESSID configured. ir_step describes the
-  international roaming step (0, 1) */
+/** 
+ * start_scan - start a scan
+ *
+ * @use_essid - use the configured ESSID in non passive mode
+ * @ir_step - international roaming step (0, 1)
+ */
 static int start_scan(struct at76c503 *dev, int use_essid, int ir_step)
 {
 	struct at76c503_start_scan scan;
@@ -1659,9 +1655,9 @@ static void mgmt_timeout(unsigned long par)
 	defer_kevent(dev, KEVENT_MGMT_TIMEOUT);
 }
 
-/* == PROC handle_mgmt_timeout_scan == */
-/* called in istate SCANNING on expiry of the mgmt_timer, when a scan was run before
-   (dev->scan_runs > 0) */
+/** 
+ * handle_mgmt_timeout_scan - expiry of management timer in istate SCANNING
+ */
 static void handle_mgmt_timeout_scan(struct at76c503 *dev)
 {
 
@@ -2743,13 +2739,15 @@ static void dump_bss_table(struct at76c503 *dev, int force_output)
 	}
 }
 
-/* try to find a matching bss in dev->bss, starting at position start.
-   returns the ptr to a matching bss in the list or
-   NULL if none found */
-/* last is the last bss tried, last == NULL signals a new round,
-   starting with list_entry(dev->bss_list.next, ...) */
-/* this proc must be called inside an acquired dev->bss_list_spinlock
-   otherwise the timeout on bss may remove the newly chosen entry ! */
+/**
+ * find_matching_bss - try to find a matching bss in dev->bss
+ *
+ * last - last bss tried
+ * 
+ * last == NULL signals a new round starting with dev->bss_list.next
+ * this function must be called inside an acquired dev->bss_list_spinlock
+ * otherwise the timeout on bss may remove the newly chosen entry
+ */
 static struct bss_info *find_matching_bss(struct at76c503 *dev,
 					  struct bss_info *last)
 {
@@ -4605,8 +4603,9 @@ static int at76c503_set_mac_address(struct net_device *netdev, void *addr)
 	return 1;
 }
 
-/* == PROC iwspy_update == 
-  check if we spy on the sender address of buf and update statistics */
+/** 
+ * iwspy_update - check if we spy on the sender address of buf and update stats
+ */
 static void iwspy_update(struct at76c503 *dev, struct at76c503_rx_buffer *buf)
 {
 	struct ieee80211_hdr_3addr *hdr = (struct ieee80211_hdr_3addr *)buf->packet;
@@ -5880,8 +5879,9 @@ static int at76c503_iw_handler_PRIV_IOCTL_SET_INTL_ROAMING
 	return ret;
 }
 
-/* == PROC set_monitor_mode == 
-   sets dev->netdev->type */
+/** 
+ * set_monitor_mode - sets dev->netdev->type
+ */
 static void set_monitor_mode(struct at76c503 *dev, int use_prism)
 {
 	if (dev->iw_mode == IW_MODE_MONITOR) {
@@ -6255,11 +6255,14 @@ static struct at76c503 *alloc_new_device(struct usb_device *udev,
 	return dev;
 } /* alloc_new_device */
 
-/* == PROC init_new_device == 
-   firmware got downloaded, we can continue with init */
-/* We may have to move the register_netdev into alloc_new_device,
-   because hotplug may try to configure the netdev _before_
-   (or parallel to) the download of firmware */
+
+/** 
+ * init_new_device - continue device intialization after firmware download
+ *
+ * FIXME: We may have to move the register_netdev into alloc_new_device,
+ * because hotplug may try to configure the netdev _before_ (or parallel to)
+ * the download of firmware
+ */
 static int init_new_device(struct at76c503 *dev)
 {
 	struct net_device *netdev = dev->netdev;
@@ -6374,9 +6377,12 @@ static int init_new_device(struct at76c503 *dev)
 } /* init_new_device */
 
 
-/* == PROC at76c503_get_fw_info ==
-   disassembles the firmware image into version, str,
-   internal and external fw part. returns 0 on success, < 0 on error */
+/**  
+ * at76c503_get_fw_info - disassembles the firmware image
+ *
+ * get version, str, internal and external fw part.
+ * returns 0 on success, < 0 on error 
+ */
 static int at76c503_get_fw_info(u8 *fw_data, int fw_size,
 				u32 *board, u32 *version, char **str,
 				u8 **int_fw, int *int_fw_size,
@@ -6427,7 +6433,9 @@ static int at76c503_get_fw_info(u8 *fw_data, int fw_size,
 	return 0;
 }
 
-/* == PROC at76c503_do_probe == */
+/** 
+ * at76c503_do_probe - have a look at the firmware
+ */
 static int at76c503_do_probe(struct usb_device *udev, u8 *fw_data, int fw_size,
 			     u32 board_type)
 {