[pkg-wpa-devel] Bug#468235: wpasupplicant: Better wpa_cli documentation wanted

[Kai Hendry]

Package: wpasupplicant
Version: 0.6.2+git20080206.g8c0dad4-1
Severity: wishlist

I am not sure if this is possible or not with `wpa_cli`. Though I think
a user should be able to configure a new AP within this interactive
client instead of editing /etc/wpa_supplicant/wpa_supplicant.conf

I usually get as far as:

	scan
	scan_results

But from there I am unsure how to select and configure a new AP.

Are you supposed to 'add_network' and select it and configure it from
there? Does that save to the wpa_supplicant.conf? Anyway, there is room
for improvement in user friendliness front. :)

Be good if the documentation address typical use cases.

1) User scanning for network
2) Selecting network
3) Entering password credentials
4) Saving the configuration

-- System Information:
Debian Release: lenny/sid
  APT prefers unstable
  APT policy: (500, 'unstable')
Architecture: i386 (i686)

Kernel: Linux 2.6.24-1-686 (SMP w/2 CPU cores)
Locale: LANG=en_GB.UTF-8, LC_CTYPE=en_GB.UTF-8 (charmap=UTF-8)
Shell: /bin/sh linked to /bin/bash

Versions of packages wpasupplicant depends on:
ii  adduser                       3.105      add and remove users and groups
ii  libc6                         2.7-8      GNU C Library: Shared libraries
ii  libdbus-1-3                   1.1.4-1    simple interprocess messaging syst
ii  libpcsclite1                  1.4.99-2   Middleware to access a smart card 
ii  libreadline5                  5.2-3      GNU readline and history libraries
ii  libssl0.9.8                   0.9.8g-7   SSL shared libraries
ii  lsb-base                      3.1-24     Linux Standard Base 3.1 init scrip

Versions of packages wpasupplicant recommends:
ii  dhcp3-client                  3.1.0-3    DHCP client

-- no debconf information