- beef up the text on wep/wpa

- simplify wpa example

help/ok damien

1 files changed, 12 insertions, 5 deletions

diff --git a/share/man/man4/zyd.4 b/share/man/man4/zyd.4
index eb557b69202..0b1fc88ac7d 100644
--- a/share/man/man4/zyd.4
+++ b/share/man/man4/zyd.4
@@ -1,4 +1,4 @@
-.\" $OpenBSD: zyd.4,v 1.29 2008/07/28 20:10:28 damien Exp $
+.\" $OpenBSD: zyd.4,v 1.30 2008/07/29 16:44:19 jmc Exp $
 .\"
 .\" Copyright (c) 1997, 1998, 1999
 .\" Bill Paul <wpaul@ctr.columbia.edu>. All rights reserved.
@@ -30,7 +30,7 @@
 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF
 .\" THE POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd $Mdocdate: July 28 2008 $
+.Dd $Mdocdate: July 29 2008 $
 .Dt ZYD 4
 .Os
 .Sh NAME
@@ -64,7 +64,14 @@ or to scan for access points.
 .Pp
 The
 .Nm
-driver can be configured to use the WEP, WPA-PSK and WPA2-PSK protocols.
+driver can be configured to use
+Wireless Equivalent Privacy (WEP) or
+Wi-Fi Protected Access (WPA-PSK and WPA2-PSK).
+WPA is the de facto encryption standard for wireless networks.
+It is strongly recommended that WEP
+not be used as the sole mechanism
+to secure wireless communication,
+due to serious weaknesses in it.
 The
 .Nm
 driver relies on the software 802.11 stack for both encryption and decryption
@@ -150,8 +157,8 @@ Configure zyd0 to join network
 using WPA-PSK with passphrase
 .Dq my_passphrase :
 .Bd -literal -offset indent
-# _psk=$(wpa-psk my_net my_passphrase)
-# ifconfig zyd0 nwid my_net wpa wpapsk ${_psk}
+# ifconfig zyd0 nwid my_net wpa wpapsk \e
+	$(wpa-psk my_net my_passphrase)
 .Ed
 .Pp
 Return zyd0 to its default settings: