Your message dated Tue, 16 May 2006 22:26:26 +0200
with message-id <[EMAIL PROTECTED]>
has caused the Debian Bug report #367549,
regarding iwlist: interface was optional all along
to be marked as having been forwarded to the upstream software
author(s) Jean Tourrilhes <[EMAIL PROTECTED]>.

(NB: If you are a system administrator and have no idea what I am
talking about this indicates a serious mail system misconfiguration
somewhere.  Please contact me immediately.)

Debian bug tracking system administrator
(administrator, Debian Bugs database)

--- Begin Message ---
Hello Jean,

Attached is a bugreport about inconsistencies in the manual page and
run-time usage information.

-- 
Met vriendelijke groet / with kind regards,
    Guus Sliepen <[EMAIL PROTECTED]>
--- Begin Message ---
Package: wireless-tools
Version: 28-1
Severity: minor
File: /sbin/iwlist

Usage message doesn't mention --help and version.
Man page doesn't mention --help except at top.

By the way,
# iwlist eth0
iwlist: unknown command `eth0'
BAD MESSAGE. Give Usage message instead.

P.S., you should add a command "all", so the user doesn't have to do
# iwlist 2>&1|sed 's/.* //'|xargs -n 1 --verbose iwlist
Wait, I forgot the eth0... and it still worked! Proving that the eth0
was optional all along! So say
       iwlist [interface] scanning etc.
on the man page and usage, instead of
       iwlist interface scanning etc.
Wait, it does in the Usage message, but not on the man page!
And the alias names are on the Usage message, but not in the SYNOPSIS.

OK, add a "all" command lest we need:
# man iwlist|perl -alnwe 'next unless $#F==2;print $F[2] if
  $F[0]eq"iwlist"'|xargs -n 1 --verbose iwlist eth0

P.S., I found some trailing blanks with:
echo scanning frequency rate key power txpower retry event|\
        xargs -n 1 iwlist eth0 2>&1|\
        sed 's/ $/ <--TRAILING BLANKS/'

We also note that [interface] is optional for iwspy, in contrast to
its man SYNOPSIS and Usage message, which don't match each other well
too by the way. Check the other iw* commands too.


--- End Message ---

Attachment: signature.asc
Description: Digital signature


--- End Message ---

Reply via email to