- 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/ral.4 b/share/man/man4/ral.4
index ed4511ea202..47766b8889e 100644
--- a/share/man/man4/ral.4
+++ b/share/man/man4/ral.4
@@ -1,4 +1,4 @@
-.\" $OpenBSD: ral.4,v 1.86 2008/07/28 20:10:28 damien Exp $
+.\" $OpenBSD: ral.4,v 1.87 2008/07/29 16:44:19 jmc Exp $
 .\"
 .\" Copyright (c) 2005-2008
 .\"	Damien Bergamini <damien.bergamini@free.fr>
@@ -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 RAL 4
 .Sh NAME
@@ -94,7 +94,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.
 .Pp
 The
 .Nm
@@ -278,8 +285,8 @@ Configure ral0 to join network
 using WPA-PSK with passphrase
 .Dq my_passphrase :
 .Bd -literal -offset indent
-# _psk=$(wpa-psk my_net my_passphrase)
-# ifconfig ral0 nwid my_net wpa wpapsk ${_psk}
+# ifconfig ral0 nwid my_net wpa wpapsk \e
+	$(wpa-psk my_net my_passphrase)
 .Ed
 .Pp
 Return ral0 to its default settings: