Improve, and slightly soften, the deprecated flags. Call them deprecated

and not obsolete, but add a warning about their disappearance.

Add additional notes that explain the lameness of WEP.

1 files changed, 17 insertions, 10 deletions

diff --git a/usr.sbin/wicontrol/wicontrol.8 b/usr.sbin/wicontrol/wicontrol.8
index f2a22ff..14dffe5 100644
--- a/usr.sbin/wicontrol/wicontrol.8
+++ b/usr.sbin/wicontrol/wicontrol.8
@@ -150,7 +150,7 @@ Encryption keys are only displayed if
 .Nm
 is run as root.
 .It Oo Fl i Oc Ar iface Fl t Ar tx_rate
-This flag is obsolete.
+This flag is deprecated.
 Use
 .Xr ifconfig 8
 .Dq mediaopt
@@ -181,7 +181,7 @@ The default driver setting is
 (auto rate select).
 The numbers vary from card to card.
 .It Oo Fl i Oc Ar iface Fl n Ar network_name
-This flag is obsolete.
+This flag is deprecated.
 Use
 .Xr ifconfig 8
 .Dq ssid
@@ -210,7 +210,7 @@ in another driver which indicates that the
 .Dq Li ANY
 string works as well.
 .It Oo Fl i Oc Ar iface Fl s Ar station_name
-This flag is obsolete.
+This flag is deprecated.
 Use
 .Xr ifconfig 8
 .Dq stationname
@@ -229,7 +229,7 @@ The
 software can
 poll the names of remote hosts.
 .It Oo Fl i Oc Ar iface Fl c Cm 0 | 1
-This flag is obsolete.
+This flag is deprecated.
 IBSS networks are automatically created on those cards whose firmware
 supports it while in IBSS mode.
 .Pp
@@ -244,7 +244,7 @@ The default is
 .Pp
 Only newer versions of the Lucent firmware support this.
 .It Oo Fl i Oc Ar iface Fl q Ar SSID
-This flag is obsolete.
+This flag is deprecated.
 The ssid setting from
 .Xr ifconfig 8
 is the current preferred way of setting this parameter.
@@ -257,7 +257,7 @@ can be any text string up to 30 characters long.
 Note: this option is provided for experimental purposes only: enabling
 the creation of an IBSS on a host system doesn't appear to actually work.
 .It Oo Fl i Oc Ar iface Fl p Ar port_type
-This flag is obsolete.
+This flag is deprecated.
 It should never be used.
 Do not use this flag.
 Its meaning depends on the type of card you are using, as well as the
@@ -323,7 +323,7 @@ The
 can be any number from 350 to 2304.
 The default is 2304.
 .It Oo Fl i Oc Ar iface Fl e Cm 0 | 1
-This flag is obsolete.
+This flag is deprecated.
 It has been replaced by the
 .Xr ifconfig 8
 .Dq wepmode
@@ -405,7 +405,7 @@ The
 can be any value between 0 and 2347.
 The default is 2347.
 .It Oo Fl i Oc Ar iface Fl f Ar frequency
-This flag is obsolete.
+This flag is deprecated.
 Use
 .Xr ifconfig 8
 .Dq channel
@@ -513,8 +513,11 @@ better signal quality).
 .Xr wi 4 ,
 .Xr ifconfig 8
 .Sh BUGS
-There are obsolete flags here that should be removed.
-These flags will be removed without further notice.
+There are deprecated flags here that duplicate functionality of
+ifconfig.
+These flags will be deprecated in
+.Fx 5.1
+and removed in a future release.
 .Pp
 The WEP encryption method has been broken so that third parties
 can recover the keys in use relatively quickly at distances that are
@@ -543,9 +546,13 @@ discontinue it and use a new key.
 See
 .Pa http://www.cs.rice.edu/~astubble/wep/wep_attack.html
 for details of the attack.
+Many programs to assist in cracking WEP keys are widely available.
 .Pp
 If you must use WEP, you are strongly encouraged to pick keys whose
 bytes are random and not confined to ASCII characters.
+Brute force attacks on WEP keys are also possible.
+Experience has showns that ASCII keys can be cracked in less than a day.
+Even random bytes can be cracked in less than two weeks.
 .Pp
 Signal cache is broken right now.
 .Sh HISTORY