Search Linux Wireless

Re: [Rt2400-devel] rt2x00: cleanup Kconfig help

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



Le April 13, 2008 06:44:05 am Ivo van Doorn, vous avez écrit :
[...]
> 
> > @@ -38,12 +38,12 @@
> >  	select INPUT_POLLDEV
> >  
> >  config RT2400PCI
> > -	tristate "Ralink rt2400 pci/pcmcia support"
> > +	tristate "Ralink RT2400 (PCI/PCMCIA) support"
> >  	depends on RT2X00 && PCI
> >  	select RT2X00_LIB_PCI
> >  	select EEPROM_93CX6
> >  	---help---
> > -	  This is an experimental driver for the Ralink rt2400 wireless chip.
> > +	  This is an experimental driver for the Ralink RT2400 wireless chipset.
> >  
> >  	  When compiled as a module, this driver will be called "rt2400pci.ko".
> 
> I ask again, please keep the RT lowercase.
As I wrote, "rt" is capitalized in the name of the chips. I am not a Ralink expert though, so feel free to point to a reference where "rt" is lowercase if both forms are valid.
> 
> >  config RT61PCI
> > -	tristate "Ralink rt61 pci/pcmcia support"
> > +	tristate "Ralink RT2561 and RT2661 (PCI) support"
> 
> I can't see why you are overly obsessed with changing the device type here.
> There are rt61 PCMCIA cards so make it:
> 
> +	tristate "Ralink rt2561 and rt2661 (PCI/PCMCIA) support"
Ah, that's not an obsession but it's the way it was in both versions. I removed "pcmcia" because it wasn't capitalized, before we started trying to make it consistent. I made it consistent in the new patch.
> 
> >  	depends on RT2X00 && PCI
> >  	select RT2X00_LIB_PCI
> >  	select RT2X00_LIB_FIRMWARE
> >  	select EEPROM_93CX6
> >  	---help---
> > -	  This is an experimental driver for the Ralink rt61 wireless chip.
> > +	  This is an experimental driver for the Ralink RT2600 and RT2501 [Turbo] (PCI) wireless chipsets.
> 
> Again: It doesn't make any sense to claim support for chip A in the subject and chip B in the help text.
A is the MAC chip, B is the chipset. Anyway, I forgot that entry when doing the version which was supposed to be consistent. I changed it in the new patch.
> Furthermore you don't need to repeat the (PCI) here, since it is already clear from the subject and
> it isn't in the help text for the other drivers either.
Right.
> 
> >  	  When compiled as a module, this driver will be called "rt61pci.ko".
> >  
> > @@ -91,26 +91,26 @@
> >  	depends on RT61PCI
> >  	select RT2X00_LIB_RFKILL
> >  	---help---
> > -	  This adds support for integrated rt61 devices that feature a
> > +	  This adds support for integrated RT2600 and RT2501 devices that feature a
> 
> Same here, the driver is for rt2561 and rt2661
Changed.
> 
> >  	  hardware button to control the radio state.
> >  	  This feature depends on the RF switch subsystem rfkill.
> >  
> >  config RT2500USB
> > -	tristate "Ralink rt2500 usb support"
> > +	tristate "Ralink RT2500USB support"
> 
> Again:
> -	tristate "Ralink rt2500 (USB) support"
> This is consistent with the rest where (PCI) is used.
> A space between rt2500 and usb should not give people the impression we are
> suddenly talking about PCI hardware.
> 
> Another option if that makes you happy is that you could rename it to rt2570
> if you really want to differentiate between rt2500 usb and rt2500 pci.
We already discussed that in previous messages.
> 
> >  	depends on RT2X00 && USB
> >  	select RT2X00_LIB_USB
> >  	---help---
> > -	  This is an experimental driver for the Ralink rt2500 wireless chip.
> > +	  This is an experimental driver for the Ralink RT2500USB wireless chipset.
> 
> Again:
> +	  This is an experimental driver for the Ralink RT2500 wireless chipset.
As above.
> >  	  When compiled as a module, this driver will be called "rt2500usb.ko".
> >  
> >  config RT73USB
> > -	tristate "Ralink rt73 usb support"
> > +	tristate "Ralink RT2571W and RT2671 (USB) support"
> >  	depends on RT2X00 && USB
> >  	select RT2X00_LIB_USB
> >  	select RT2X00_LIB_FIRMWARE
> >  	---help---
> > -	  This is an experimental driver for the Ralink rt73 wireless chip.
> > +	  This is an experimental driver for the RT2571W and RT2671 MAC/BBP chips. It supports Ralink RT2501USB and RT5201USB wireless chipsets.
> >  	  When compiled as a module, this driver will be called "rt73usb.ko".
> 
> *sigh* you seem to be absolutely sure you want to break any form of consistency in the rt2x00 KConfig entry.
> So to show how I would like to see it I have the following patch. Unless you have objections against below changes
> I will push this forward.
No objection, but note that:
* this has both "hardware that feature*s*" and  "hardware that feature"
* The names of drivers are duplicated and not exactly the same. For example, "This is the experimental rt2500pci driver [...]" vs "[...] this driver will be called "rt2500pci.ko"".

Here is the third version of my patch.
---

--- drivers/net/wireless/rt2x00/Kconfig	2008-01-24 17:58:37.000000000 -0500
+++ drivers/net/wireless/rt2x00/Kconfig.USB	2008-04-14 02:29:37.000000000 -0400
@@ -2,10 +2,10 @@
 	tristate "Ralink driver support"
 	depends on MAC80211 && WLAN_80211 && EXPERIMENTAL
 	---help---
-	  This will enable the experimental support for the Ralink drivers,
+	  This enables the experimental support for the Ralink drivers,
 	  developed in the rt2x00 project <http://rt2x00.serialmonkey.com>.
 
-	  These drivers will make use of the Devicescape ieee80211 stack.
+	  These drivers use the mac80211 stack.
 
 	  When building one of the individual drivers, the rt2x00 library
 	  will also be created. That library (when the driver is built as
@@ -38,12 +38,12 @@
 	select INPUT_POLLDEV
 
 config RT2400PCI
-	tristate "Ralink rt2400 pci/pcmcia support"
+	tristate "Ralink RT2400 (PCI/PCMCIA) support"
 	depends on RT2X00 && PCI
 	select RT2X00_LIB_PCI
 	select EEPROM_93CX6
 	---help---
-	  This is an experimental driver for the Ralink rt2400 wireless chip.
+	  This is an experimental driver for the Ralink RT2400 wireless chipset.
 
 	  When compiled as a module, this driver will be called "rt2400pci.ko".
 
@@ -52,17 +52,17 @@
 	depends on RT2400PCI
 	select RT2X00_LIB_RFKILL
 	---help---
-	  This adds support for integrated rt2400 devices that feature a
+	  This adds support for integrated RT2400 devices that feature a
 	  hardware button to control the radio state.
 	  This feature depends on the RF switch subsystem rfkill.
 
 config RT2500PCI
-	tristate "Ralink rt2500 pci/pcmcia support"
+	tristate "Ralink RT2500 (PCI/PCMCIA) support"
 	depends on RT2X00 && PCI
 	select RT2X00_LIB_PCI
 	select EEPROM_93CX6
 	---help---
-	  This is an experimental driver for the Ralink rt2500 wireless chip.
+	  This is an experimental driver for the Ralink RT2500 wireless chipset.
 
 	  When compiled as a module, this driver will be called "rt2500pci.ko".
 
@@ -71,18 +71,18 @@
 	depends on RT2500PCI
 	select RT2X00_LIB_RFKILL
 	---help---
-	  This adds support for integrated rt2500 devices that feature a
+	  This adds support for integrated RT2500 devices that feature a
 	  hardware button to control the radio state.
 	  This feature depends on the RF switch subsystem rfkill.
 
 config RT61PCI
-	tristate "Ralink rt61 pci/pcmcia support"
+	tristate "Ralink RT2561 and RT2661 (PCI/PCMCIA) support"
 	depends on RT2X00 && PCI
 	select RT2X00_LIB_PCI
 	select RT2X00_LIB_FIRMWARE
 	select EEPROM_93CX6
 	---help---
-	  This is an experimental driver for the Ralink rt61 wireless chip.
+	  This is an experimental driver for the Ralink RT2561 and RT2661 MAC/BBP chips. It supports RT2600 and RT2501 [Turbo] wireless chipsets.
 
 	  When compiled as a module, this driver will be called "rt61pci.ko".
 
@@ -91,26 +91,26 @@
 	depends on RT61PCI
 	select RT2X00_LIB_RFKILL
 	---help---
-	  This adds support for integrated rt61 devices that feature a
+	  This adds support for integrated RT2561 and RT2661 devices that feature a
 	  hardware button to control the radio state.
 	  This feature depends on the RF switch subsystem rfkill.
 
 config RT2500USB
-	tristate "Ralink rt2500 usb support"
+	tristate "Ralink RT2500USB support"
 	depends on RT2X00 && USB
 	select RT2X00_LIB_USB
 	---help---
-	  This is an experimental driver for the Ralink rt2500 wireless chip.
+	  This is an experimental driver for the Ralink RT2500USB wireless chipset.
 
 	  When compiled as a module, this driver will be called "rt2500usb.ko".
 
 config RT73USB
-	tristate "Ralink rt73 usb support"
+	tristate "Ralink RT2571W and RT2671 (USB) support"
 	depends on RT2X00 && USB
 	select RT2X00_LIB_USB
 	select RT2X00_LIB_FIRMWARE
 	---help---
-	  This is an experimental driver for the Ralink rt73 wireless chip.
+	  This is an experimental driver for the Ralink RT2571W and RT2671 MAC/BBP chips. It supports RT2501USB and RT5201USB wireless chipsets.
 
 	  When compiled as a module, this driver will be called "rt73usb.ko".
 
--
To unsubscribe from this list: send the line "unsubscribe linux-wireless" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at  http://vger.kernel.org/majordomo-info.html

[Index of Archives]     [Linux Host AP]     [ATH6KL]     [Linux Bluetooth]     [Linux Netdev]     [Kernel Newbies]     [Linux Kernel]     [IDE]     [Security]     [Git]     [Netfilter]     [Bugtraq]     [Yosemite News]     [MIPS Linux]     [ARM Linux]     [Linux Security]     [Linux RAID]     [Linux ATA RAID]     [Samba]     [Device Mapper]
  Powered by Linux