Your time wasn't wasted. It was your bug report that prompted me to re-write the man page. In fact, I tried to use your version as a starting point. Unfortunately, the wifi-radar.conf format changed so much in v2.0, I abandoned that version and restarted with something else I had prepared for the user manual.
On Tue, Aug 11, 2009 at 11:34 AM, era <[email protected]> wrote: > Looks like this was finally independently fixed by upstream, and can be > closed once 2.0x lands (LP bug #409932). > > I must say I am somewhat peeved that the hours I put into producing a > manual page were wasted. > > -- > wifi-radar.conf manual page mostly useless > https://bugs.launchpad.net/bugs/97390 > You received this bug notification because you are subscribed to wifi- > radar in ubuntu. > > Status in “wifi-radar” package in Ubuntu: Confirmed > > Bug description: > Binary package hint: wifi-radar > > The manual page for wifi-radar.conf looks like basically a copy/paste of > the wifi-radar manual page. The NAME, SYNOPSIS, FILES, BUGS, and AUTHOR > sections look like duplicates; they are mostly redundant here, to the extent > that they are not erroneous. > > The EXAMPLES section is not completely useless (sorry for the > attention-grabbing title for this bug report). Getting an example of the > general syntax and the available directives is useful, but the manual page > fails to document even briefly what those examples actually mean. > > Most of the directives are fairly self-explanatory, but e.g. "speak_up" is > definitely not. > > /usr/bin/wifi-radar contains the following comments, which could be copied > to the manual page (modulo typo fixes): > > # The interface you use > INTERFACE = "eth1" > > # How long should the scan last? > SCAN_TIMEOUT = "5" > > # Should I speak up when connecting to a network? (If you have a speach > command) > SPEAK_UP = False > > # You may set this to true for cards that require a "commit" command with > iwconfig > COMMIT_REQUIRED = False > > # You may set this to true for cards that require the interface to be > brought up first > IFUP_REQUIRED = False > > # ... > > IWLIST_COMMAND = "LC_MESSAGES=C iwlist" > IWCONFIG_COMMAND = "LC_MESSAGES=C iwconfig" > IFCONFIG_COMMAND = "LC_MESSAGES=C ifconfig" > ROUTE_COMMAND = "LC_MESSAGES=C route" > > # X1000 Linux has a say command (text to speach) to accounce connecting to > networks. > # Set the SPEAK_UP to false if you do not have or want this. > SAY_COMMAND = "say" > > The scan_timeout could benefit from some elaboration, and the interface > option is apparently optional, in which case all interfaces will be scanned. > The speak_up option looks like it may be better off remaining undocumented > (in which case it should perhaps not be in the EXAMPLES either). > -- Sean Robinson WiFi Radar - http://wifi-radar.berlios.de Python WiFi - http://pythonwifi.wikispot.org -- wifi-radar.conf manual page mostly useless https://bugs.launchpad.net/bugs/97390 You received this bug notification because you are a member of Ubuntu Bugs, which is subscribed to Ubuntu. -- ubuntu-bugs mailing list [email protected] https://lists.ubuntu.com/mailman/listinfo/ubuntu-bugs
