From 74b492306b6767e3343b6ed978b93b83ada89a38 Mon Sep 17 00:00:00 2001
From: Jason McIntyre <jmc@cvs.openbsd.org>
Date: Tue, 29 Jul 2008 16:44:20 +0000
Subject: - beef up the text on wep/wpa - simplify wpa example

help/ok damien
---
 share/man/man4/iwn.4 | 17 ++++++++++++-----
 1 file changed, 12 insertions(+), 5 deletions(-)

(limited to 'share/man/man4/iwn.4')

diff --git a/share/man/man4/iwn.4 b/share/man/man4/iwn.4
index cdbe8eebcae..80135842f37 100644
--- a/share/man/man4/iwn.4
+++ b/share/man/man4/iwn.4
@@ -1,4 +1,4 @@
-.\" $OpenBSD: iwn.4,v 1.7 2008/07/28 20:10:28 damien Exp $
+.\" $OpenBSD: iwn.4,v 1.8 2008/07/29 16:44:19 jmc Exp $
 .\"
 .\" Copyright (c) 2007
 .\"	Damien Bergamini <damien.bergamini@free.fr>. All rights reserved.
@@ -15,7 +15,7 @@
 .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
 .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 .\"
-.Dd $Mdocdate: July 28 2008 $
+.Dd $Mdocdate: July 29 2008 $
 .Os
 .Dt IWN 4
 .Sh NAME
@@ -50,7 +50,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
@@ -104,8 +111,8 @@ Configure iwn0 to join network
 using WPA-PSK with passphrase
 .Dq my_passphrase :
 .Bd -literal -offset indent
-# _psk=$(wpa-psk my_net my_passphrase)
-# ifconfig iwn0 nwid my_net wpa wpapsk ${_psk}
+# ifconfig iwn0 nwid my_net wpa wpapsk \e
+	$(wpa-psk my_net my_passphrase)
 .Ed
 .Pp
 Return iwn0 to its default settings:
-- 
cgit v1.2.3