[gnome-user-docs] added more content to wireless-troubleshooting-hardware-check

[Jim Campbell <jcampbell src gnome org>]

commit 6033964ede202668922303e10e525fc310f3b37f
Author: Jim Campbell <jwcampbell gmail com>
Date:   Tue Apr 5 08:13:45 2011 -0500

    added more content to wireless-troubleshooting-hardware-check

 ...et-wireless-troubleshooting-hardware-check.page |   97 ++++++++-----------
 1 files changed, 41 insertions(+), 56 deletions(-)
---
diff --git a/gnome-help/C/net-wireless-troubleshooting-hardware-check.page b/gnome-help/C/net-wireless-troubleshooting-hardware-check.page
index 9b89954..cddf2aa 100644
--- a/gnome-help/C/net-wireless-troubleshooting-hardware-check.page
+++ b/gnome-help/C/net-wireless-troubleshooting-hardware-check.page
@@ -23,63 +23,48 @@
 
   <p>This guide is designed to help you troubleshoot and resolve problems with accessing a wireless network.</p>
 
-  <note><p>Due to the technical nature of trouble-shooting network problems, this guide contains some commands that will need to be entered into a <app>terminal</app> window. While this may seem intimidating at first, these commands present the easiest way of getting the information that you need to restore your network access.</p></note>
-
-  <p>Trouble-shooting problems with wireless networks involves several steps. Throughout this portion of the guide, we will proceed through the following tasks to connect your computer to the internet:</p>
-  <list style="numbered">
-    <item><p>Performing an initial check</p></item>
-    <item><p>Gathering information about your hardware</p></item>
-    <item><p>Checking your hardware</p></item>
-    <item><p>Attempting to create a connection to your wireless router</p></item>
-    <item><p>Performing a check of your modem and router</p></item>
-  </list>
-  <p>After we complete each step, click on the <em>Next</em> link in the upper-right portion of the page. This will take you to the next step in the guide.</p>
-
-  <section id="net-wireless-initial-check">
-    <title>Performing an initial check</title>
-  <p>Our first step will be to see if your computer is already connected to a wireless network.</p>
+  <section id="net-wireless-hardware-check">
+    <title>Checking your system hardware</title>
+  <p>Our first step will be to see if your computer recognizes your wireless adapter.</p>
   <steps>
-   <item><p>Make sure that your laptop is not connected to a <em>wired</em> internet connection.</p></item>
-   <item><p>If you have an external wireless adapter, make sure that it is plugged-in.</p></item>
-   <item><p>Make sure that your wireless adapter switch is turned on</p></item>
-   <item><p>In the <gui>Top Bar</gui>, make sure that you have not set the <gui>Wireless</gui> setting to <gui>Off</gui>.</p></item>
-   <item><p>Open a <app>terminal</app> window, and enter the following command:</p>
-  <p><cmd>nm-tool</cmd></p>
-   <p>The nm-tool program will display information about your network hardware and connection status. If the wireless connection output section contains the text:</p>
-  <p><code>State: Connected</code></p>
-  <p>then your wireless adapter is working and is connected to your wireless router.</p></item>
+   <item><p>Open a <app>terminal</app> window, and enter <cmd>sudo lshw -C network</cmd></p>
+    <p>If you get no response, you may need to install the <app>lshw</app> program on your computer.</p></item>
+   <item><p>Read the output from the command, and check for the <em>Wireless interface</em> section. If your wireless adapter is detected, the output should look similar to this:</p>
+   <example> 
+   <code><![CDATA[*-network
+       description: Wireless interface
+       product: PRO/Wireless 3945ABG [Golan] Network Connection
+       vendor: Intel Corporation
+       physical id: 0
+       bus info: pci 0000:03:00.0
+       logical name: wlan0
+       version: 02
+       serial: 00:1b:77:11:5a:a7
+       width: 32 bits
+       clock: 33MHz
+       capabilities: pm msi pciexpress bus_master cap_list ethernet physical wireless
+       configuration: broadcast=yes driver=iwl3945 driverversion=2.6.38.2-9.fc15.i686 
+       firmware=15.32.2.9 ip=192.168.1.42 latency=0 link=yes multicast=yes 
+       wireless=IEEE 802.11abg
+       resources: irq:46 memory:edf00000-edf00fff]]></code>
+   </example>
+</item>
   </steps>
-  <p>If you are connected to your wireless router, but you still cannot access the internet, your router may not be set up correctly, or your Internet Service Provider (ISP) maybe experiencing some technical problems. Review your router and ISP setup guides, or contact your ISP for support.</p>
-  <p>If the output from the <cmd>nm-tool</cmd> command did not indicate that you were connected to the network, click <gui>Next</gui> to proceed to the next portion of the troubleshooting guide.</p>
-  </section>
-<section id="net-hardware-check">  
-  <title>Gather information about your computer and network hardware:</title>
-  <p>For this section, it will be useful to have the follwing items available:</p>
-    <list>
-      <item><p>Your laptop and wireless router</p></item>
-      <item><p>The packaging and contents for your device (particularly the user guide for your router)</p></item>
-      <item><p>A driver disc - even if it only contains Windows drivers</p></item>
-      <item><p>An alternate working internet connection for downloading software and drivers</p></item>
-    </list>
-
-  <p>Additionally, it is helpful to have the following information:</p>
-    <list>
-      <item><p>The name of the device manufacturer</p></item>
-      <item><p>The complete model number of your computer and router</p></item>
-      <item><p>Any version numbers that may be printed on the device or its packaging. These can be crucial, so look carefully.</p></item>
-      <item><p>Anything on the driver disc that identifies either the device itself or the components it uses. Wireless implementation chips are often operated by firmware, a type of software written specifically for that chip.</p></item>
-    </list>
-
-<p>With this information available, we will proceed with the following steps</p>
-  <list>
-    <item><p>Checking your modem and router</p></item>
-    <item><p>Check if your wireless card is enabled and recognized by your computer.</p></item>
-    <item><p>Second step...</p></item>
-    <item><p>Third step...</p></item>
-  </list>
-
-  <p>make sure can identify your networking device</p>
-  <p>PCI device, USB device, internal device</p>
+  <p>If a wireless device is listed, then continue to the Device Drivers page</p>
+  <p>If a wireless device is not listed, the next steps will help you to locate the hardware information.</p> 
 </section>
-   
+   <section id="net-wireless-hardware-check2">
+    <title>Further wireless hardware checks</title>
+  <p>Because your wireless adapter was not found with the previous command, the next steps will depend on the type of interface your device uses. Refer to the section that is relevant to the type of wireless adapter that you use with your computer: PCI (internal), USB, or PCMCIA.</p>
+  <note><p>PCMCIA is an external, card-style adapter, and is more common on older hardware.</p></note>
+      <section id="net-wireless-hardware-pcicheck">
+        <title>Checking for a PCI (internal) device</title>
+      </section>
+      <section id="net-wireless-hard-ware-usbcheck">
+        <title>Checking for a USB device</title>
+      </section>
+      <section id="net-wireless-hard-ware-pcmciacheck">
+        <title>Checking for a PCMCIA device</title>
+      </section>
+   </section>
 </page>