[gnome-user-docs/gnome-3-0] Further review and editing of wireless troubleshooting guide (not completely finished yet, though)

[Phil Bull <philbull src gnome org>]

commit 6fe9c3b508c056bd9c65fe9eb6c5e34e43526a5f
Author: Phil Bull <philbull gmail com>
Date:   Thu Jun 9 05:03:35 2011 +0100

    Further review and editing of wireless troubleshooting guide (not completely finished yet, though)

 ...et-wireless-troubleshooting-device-drivers.page |   33 +++++++++++++++++--
 gnome-help/C/net-wireless-troubleshooting.page     |    2 +-
 2 files changed, 30 insertions(+), 5 deletions(-)
---
diff --git a/gnome-help/C/net-wireless-troubleshooting-device-drivers.page b/gnome-help/C/net-wireless-troubleshooting-device-drivers.page
index 7666076..db256e1 100644
--- a/gnome-help/C/net-wireless-troubleshooting-device-drivers.page
+++ b/gnome-help/C/net-wireless-troubleshooting-device-drivers.page
@@ -4,21 +4,46 @@
   <info>
     
     <revision pkgversion="3.0" date="2011-04-05" status="final"/>
-    <revision pkgversion="3.0" version="3.0.1" date="2011-06-08" status="outdated"/>
+    <revision pkgversion="3.0" version="3.0.1" date="2011-06-08" status="incomplete"/>
 
     <credit type="author">
       <name>Contributors to the Ubuntu documentation wiki</name>
     </credit>
 
     <credit type="author">
-      <name>Jim Campbell</name>
-      <email>jwcampbell gmail com</email>
+      <name>Phil Bull</name>
+      <email>philbull gmail com</email>
     </credit>
 
-    <desc>XXX</desc>
+    <desc>Some device drivers don't work very well with certain wireless adapters, so you may need to find a better one.</desc>
     <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
   </info>
 
 <title>Wireless network troubleshooter</title>
+<subtitle>Make sure that working device drivers are installed</subtitle>
+
+<!-- Needs links (see below) -->
+
+<p>In this step you can check to see if you can get working device drivers for your wireless adapter. A <em>device driver</em> is a piece of software which tells the computer how to make a hardware device work properly. Even though the wireless adapter has been recognized by the computer, it may not have drivers which work very well. You may be able to find different drivers for the wireless adapter which do work. Try some of the options below:</p>
+
+<list>
+ <item>
+  <p>Check to see if your wireless adapter is on a list of supported devices</p>
+  <p>Most Linux distributions keep a list of wireless devices that they have support for. Sometimes, these lists provide extra information on how to get the drivers for certain adapters working properly. Go to the list for your distribution (for example, <link href="XXXX">Ubuntu</link>, <link href="XXXX">Fedora</link> or <link href="XXXX">openSuSE</link>) and see if your make and model of wireless adapter is listed. You may be able to use some of the information there to get your wireless drivers working.</p>
+ </item>
+ 
+ <item>
+  <p>Look for restricted (binary) drivers</p>
+  <p>Many Linux distributions only come with device drivers which are <em>free</em> and <em>open source</em>. This is because they cannot distribute drivers which are proprietary, or closed-source. If the correct driver for your wireless adapter is only available in a non-free, or "binary-only" version, it may not be installed by default. If this is the case, look on the wireless adapter manufacturer's website to see if they have any Linux drivers.</p>
+  <p>Some Linux distributions have a tool that can download restricted drivers for you. If your distribution has one of these, use it to see if it can find any wireless drivers for you.</p>
+ </item>
+ 
+ <item>
+  <p>Use the Windows drivers for your adapter</p>
+  <p>In general, you cannot use a device driver designed for one operating system (like Windows) on another operating system (like Linux). This is because they have different ways of handling devices. For wireless adapters, however, you can install a compatibility layer called <em>NDISwrapper</em> which lets you use some Windows wireless drivers on Linux. This is useful because wireless adapters almost always have Windows drivers available for them, whereas Linux drivers are sometimes not available. You can learn more about how to use NDISwrapper <link href="XXXX">here</link>. Note that not all wireless drivers can be used through NDISwrapper.</p>
+ </item>
+</list>
+
+<p>If none of these options work, you may want to try a different wireless adapter to see if you can get that working. USB wireless adapters are often quite cheap, and will plug into any computer. You should check that the adapter is compatible with your Linux distribution before buying it, though.</p>
 
 </page>
diff --git a/gnome-help/C/net-wireless-troubleshooting.page b/gnome-help/C/net-wireless-troubleshooting.page
index 2d306c7..9445e39 100644
--- a/gnome-help/C/net-wireless-troubleshooting.page
+++ b/gnome-help/C/net-wireless-troubleshooting.page
@@ -7,7 +7,7 @@
     <link type="next" xref="net-wireless-troubleshooting-initial-check"/>
     
     <revision pkgversion="3.0" date="2011-04-05" status="final"/>
-    <revision pkgversion="3.0" version="3.0.1" date="2011-04-06" status="outdated"/>
+    <revision pkgversion="3.0" version="3.0.1" date="2011-06-08" status="review"/>
 
     <credit type="author">
       <name>Contributors to the Ubuntu documentation wiki</name>