Package: ifupdown Version: 0.6.10 Severity: normal File: interfaces.5 The current discussion on debian-devel reminded me on the fact that interfaces file documentation really sucks for regular users. It was written seven years ago, and even at that time Wireless LAN was becoming popular as a way to connect workstation systems.
But in the manpage, there is not a single occurence of WPA. That is what people look for! There is not a single example for wireless LAN or even WPA in ifupdown examples documentation, AFAICS. It only refers to iwconfig in the SEE ALSO section. With some luck you can spot the hint about wireless(7) manpage which is hidden in the last paragraph of some chapter in the middle of the text. There is more stuff to read, references to DEBIAN 3.0 and SUSE 8.0 and pcmcia package. Yeah. Seriosly, WHO CARES? And following the references in wireless(7), we find more interesting stuff... oh look, they even explain "encryption", looks like that's it. But... NO, after our newbie user spent hours on that topic, she learns that the key information it's still somewhere else. So, IMHO there should be an example like the one in http://lists.debian.org/debian-devel/2011/04/msg00184.html placed on a prominent place in interfaces(5). And in any case, wireless(7) shall be dropped or updated, and in the former case it should be mentioned more visibly. Regards, Eduard. -- System Information: Debian Release: wheezy/sid APT prefers unstable APT policy: (500, 'unstable'), (500, 'testing'), (1, 'experimental') Architecture: amd64 (x86_64) Kernel: Linux 2.6.38.2+ (SMP w/4 CPU cores; PREEMPT) Locale: LANG=de_DE.UTF-8, LC_CTYPE=de_DE.UTF-8 (charmap=UTF-8) Shell: /bin/sh linked to /bin/bash Versions of packages ifupdown depends on: ii libc6 2.11.2-13 Embedded GNU C Library: Shared lib ii lsb-base 3.2-27 Linux Standard Base 3.2 init scrip ii net-tools 1.60-23 The NET-3 networking toolkit ifupdown recommends no packages. Versions of packages ifupdown suggests: ii dhcp-client 3.1.3-2 DHCP client transitional package ii dhcp3-client 4.1.1-P1-16 ISC DHCP server (transitional pack ii iproute 20110107-2 networking and traffic control too ii isc-dhcp-client [dhcp3-clien 4.1.1-P1-16 ISC DHCP client ii ppp 2.4.5-5 Point-to-Point Protocol (PPP) - da -- debconf information: ifupdown/convert-interfaces: true -- * weasel hatte letztens eine nette idee fuer ein namensschema <weasel> hab's aber leider wieder vergessen :( -- To UNSUBSCRIBE, email to [email protected] with a subject of "unsubscribe". Trouble? Contact [email protected]
