[gnome-user-docs/gnome-3-0] Major (partial) review of the net-wireless-troubleshooting topics



commit 70b17b6c43b35392e0fafcd3b56b52babbe1cf41
Author: Phil Bull <philbull gmail com>
Date:   Wed Jun 8 19:05:36 2011 +0100

    Major (partial) review of the net-wireless-troubleshooting topics

 ...et-wireless-troubleshooting-device-drivers.page |   54 +--------
 ...et-wireless-troubleshooting-hardware-check.page |  134 ++++++++++----------
 ...net-wireless-troubleshooting-hardware-info.page |   52 ++++----
 ...net-wireless-troubleshooting-initial-check.page |   51 +++++----
 gnome-help/C/net-wireless-troubleshooting.page     |   23 ++--
 5 files changed, 137 insertions(+), 177 deletions(-)
---
diff --git a/gnome-help/C/net-wireless-troubleshooting-device-drivers.page b/gnome-help/C/net-wireless-troubleshooting-device-drivers.page
index 9793364..7666076 100644
--- a/gnome-help/C/net-wireless-troubleshooting-device-drivers.page
+++ b/gnome-help/C/net-wireless-troubleshooting-device-drivers.page
@@ -4,8 +4,7 @@
   <info>
     
     <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="outdated"/>
 
     <credit type="author">
       <name>Contributors to the Ubuntu documentation wiki</name>
@@ -16,57 +15,10 @@
       <email>jwcampbell gmail com</email>
     </credit>
 
-    <desc>Troubleshoot your connection to a wireless network.</desc>
+    <desc>XXX</desc>
     <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
   </info>
 
-<title>Checking for wireless device drivers</title>
-
-  <p>This guide is designed to help you troubleshoot and resolve problems with accessing a wireless network.</p>
+<title>Wireless network troubleshooter</title>
 
-  <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>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 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, you need to take further steps to make sure your computer recognizes your adapter.</p>
-  <p>The next steps will depend on the type of device that you use. 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>
diff --git a/gnome-help/C/net-wireless-troubleshooting-hardware-check.page b/gnome-help/C/net-wireless-troubleshooting-hardware-check.page
index 2bbe7a4..6a1e8e0 100644
--- a/gnome-help/C/net-wireless-troubleshooting-hardware-check.page
+++ b/gnome-help/C/net-wireless-troubleshooting-hardware-check.page
@@ -5,8 +5,7 @@
     <link type="next" xref="net-wireless-troubleshooting-device-drivers"/>
     
     <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>
@@ -17,83 +16,78 @@
       <email>gnome-doc-list gnome org</email>
     </credit>
 
-    <desc>Troubleshoot your connection to a wireless network.</desc>
+    <desc>Even though your wireless adapter is connected, it may not have been recognized properly by the computer.</desc>
     <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
   </info>
 
-<title>Resolve problems with wireless connections</title>
+<title>Wireless connection troubleshooter</title>
+<subtitle>Check that the wireless adapter was recognized</subtitle>
 
-  <p>This guide is designed to help you troubleshoot and resolve problems with accessing a wireless network.</p>
+<p>Even though the wireless adapter is connected to the computer, it may not have been recognized as a network device by the computer. In this step, you will check whether the device was recognized properly.</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>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> 
+<steps>
+ <item>
+  <p>Open a Terminal window, type <cmd>lshw -C network</cmd> and press <key>Enter</key>. If this gives an error message, you may need to install the <app>lshw</app> program on your computer.</p>
+ </item>
+ <item>
+  <p>Look through the information that appeared and find the <em>Wireless interface</em> section. If your wireless adapter was detected properly, you should see something similar (but not identical) to this:</p>
    <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 a wireless device is listed, then continue to the <link xref="net-wireless-troubleshooting-device-drivers">Device Drivers page</link>.</p>
-  <p>If a wireless device is not listed, the next steps will help you to locate the hardware information.</p> 
+       vendor: Intel Corporation]]></code>
+ </item>
+ <item>
+  <p>If a wireless device is listed, continue on to the <link xref="net-wireless-troubleshooting-device-drivers">Device Drivers step</link>.</p>
+  <p>If a wireless device is <em>not</em> listed, the next steps you take will depend on the type of device that you use. Refer to the section below that is relevant to the type of wireless adapter that your computer has (<link xref="#pci">internal PCI</link>, <link xref="#usb">USB</link>, or <link xref="#pcmcia">PCMCIA</link>).</p>
+ </item>
+</steps>
+
+<section id="pci">
+ <title>PCI (internal) wireless adapter</title>
+ <p>Internal PCI adapters are the most common, and are found in most laptops made within the past few years. To check if your PCI wireless adapter was recognized:</p>
+ <steps>
+  <item><p>Open a Terminal, type <cmd>lspci</cmd> and press <key>Enter</key>.</p></item>
+  <item>
+   <p>Look through the list of devices that is shown and find any that are marked <code>Network controller</code> or <code>Ethernet controller</code>. Several devices may be marked in this way; the one corresponding to your wireless adapter might include words like <code>wireless</code>, <code>WLAN</code>, <code>wifi</code> or <code>802.11</code>. Here is an example of what the entry might look like:</p>
+ <code>Network controller: Intel Corporation PRO/Wireless 3945ABG [Golan] Network Connection</code>
+ </item>
+ <item><p>If you found your wireless adapter in the list, proceed to the <link xref="net-wireless-troubleshooting-device-drivers">Device Drivers step</link>. If you didn't find anything related to your wireless adapter, see <link xref="#not-recognized">the instructions below</link>.</p></item>
+ </steps>
+</section>
+
+<section id="usb">
+ <title>USB wireless adapter</title>
+ <p>Wireless adapters that plug into a USB port on your computer are less common. They can plug directly into a USB port, or may be connected by a USB cable. 3G/mobile broadband adapters look quite similar to wireless (wifi) adapters, so if you think you have a USB wireless adapter, double-check that it is not actually a 3G adapter. To check if your USB wireless adapter was recognized:</p>
+ <steps>
+  <item><p>Open a Terminal, type <cmd>lsusb</cmd> and press <key>Enter</key>.</p></item>
+  <item>
+   <p>Look through the list of devices that is shown and find any that seem to refer to a wireless or network device. The one corresponding to your wireless adapter might include words like <code>wireless</code>, <code>WLAN</code>, <code>wifi</code> or <code>802.11</code>. Here is an example of what the entry might look like:</p>
+   <code><![CDATA[Bus 005 Device 009: ID 12d1:140b Huawei Technologies Co., Ltd. EC1260 Wireless Data Modem HSD USB Card]]></code>
+  </item>
+  <item><p>If you found your wireless adapter in the list, proceed to the <link xref="net-wireless-troubleshooting-device-drivers">Device Drivers step</link>. If you didn't find anything related to your wireless adapter, see <link xref="#not-recognized">the instructions below</link>.</p></item>
+ </steps>
 </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, you need to take further steps to make sure your computer recognizes your adapter.</p>
-  <p>The steps you take will depend on the type of device that you use. 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>Internal PCI adapters are most common, and are found on laptops made within the past few years. PCMCIA adapters are external, card-style adapters, and are more common on older laptops.</p></note>
-      <section id="net-wireless-hardware-pcicheck">
-        <title>Checking for a PCI (internal) device</title>
-      <p>To check if your computer can recognizes your PCI wireless adapter, enter <cmd>sudo lspci</cmd> into a terminal window. The terminal will display a list of PCI devices that it has found on your computer.</p>
-      <p>Although this may be a bit difficult to read-through, look for the name and model number of your wireless adapter. Here is an example of what a PCI device listing may look like:</p>
-      <example>
-        <p><code><![CDATA[Network controller: Intel Corporation PRO/Wireless 3945ABG [Golan] Network Connection]]></code></p>
-      </example>
-      <p>If your device is recognized by the previous command, great! Proceed to the <link xref="net-wireless-troubleshooting-device-drivers">Device Drivers</link> page. If the above command does not show any output related to your wireless adapter, see the instructions at the bottom of this page.</p> 
-      </section>
-      <section id="net-wireless-hard-ware-usbcheck">
-        <title>Checking for a USB device</title>
-      <p>To check if your computer recognizes your USB wireless adapter, enter <cmd>sudo lsusb</cmd> into a terminal window. The terminal will display a list of USB devices that it has found on your computer.</p>
-     <p>Although it may be difficult to read-through, look for the name and model number of your USB wireless adapter. Here is some sample output from the <cmd>lsusb</cmd> command:</p>
-     <example>
-        <p><code><![CDATA[Bus 005 Device 009: ID 12d1:140b Huawei Technologies Co., Ltd. EC1260 Wireless Data Modem HSD USB Card]]></code></p>
-     </example>
-     <p>If your device is recognized by the previous command, great! Proceed to the <link xref="net-wireless-troubleshooting-device-drivers">Device Drivers</link> page. If the above command does not show any output related to your wireless adapter, see the instructions at the bottom of this page.</p>
-      </section>
-      <section id="net-wireless-hard-ware-pcmciacheck">
-        <title>Checking for a PCMCIA device</title>
-      <p>To check if your computer recognizes your PCMCIA adapter, complete the following steps:</p>
-        <steps>
-          <item><p>Start your computer <em>without</em> the wireless adapter plugged in.</p></item>
-          <item><p>Log in when/if prompted.</p></item>
-          <item><p>When the desktop loads, open a terminal window and type the following command:</p>
-                   <p><cmd>sudo tail -f /var/log/messages</cmd></p></item>
-          <item><p>Insert your wireless adapter into an available slot.</p></item>
-          <item><p>Repeat the command above, and note the difference between the two.</p></item>
-	</steps>
 
-      <p>If your device is recognized by the previous command, great! Proceed to the <link xref="net-wireless-troubleshooting-device-drivers">Device Drivers</link> page.</p>
+<section id="pcmcia">
+ <title>Checking for a PCMCIA device</title>
+ <p>PCMCIA wireless adapters are typically rectangular cards which slot into the side of your laptop. They are more commonly found in older computers. To check if your PCMCIA adapter was recognized:</p>
+ <steps>
+  <item><p>Start your computer <em>without</em> the wireless adapter plugged in.</p></item>
+  <item>
+   <p>Open a Terminal and type the following, then press <key>Enter</key>:</p>
+   <code>tail -f /var/log/messages</code>
+   <p>This will display a list of messages related to your computer's hardware, and will automatically update if anything to do with your hardware changes.</p>
+  </item>
+  <item><p>Insert your wireless adapter into the PCMCIA slot and see what changes in the Terminal window. The changes should include some information about your wireless adapter. Look through them and see if you can identify it.</p></item>
+  <item><p>To stop the command from running in the Terminal, press <keyseq><key>Ctrl</key><key>C</key></keyseq>. After you have done that, you can close the Terminal if you like.</p></item>
+  <item><p>If you found any information about your wireless adapter, proceed to the <link xref="net-wireless-troubleshooting-device-drivers">Device Drivers step</link>. If you didn't find anything related to your wireless adapter, see <link xref="#not-recognized">the instructions below</link>.</p></item>
+ </steps>
+</section>
+
+<section id="not-recognized">
+ <title>Wireless adapter was not recognized</title>
+<p>If your wireless adapter was not recognized, it might not be working properly or the correct drivers may not be installed for it. How you check to see if there are any drivers you can install will depend on which Linux distribution you are using (like Ubuntu, Fedora or openSuSE).</p>
+<p>To get specific help, look at the support options on your distribution's website. These might include mailing lists and web chats where you can ask about your wireless adapter, for example.</p>
+</section>
 
-   <note><p>If your device is not recognized by any of the above commands, it may mean that your device is not working, or that your device is not supported by your operating system.</p>
-   <p>To get additional help, post a message to a user forum appropriate to your operating system (e.g., Fedora, OpenSUSE, or Ubuntu forums, etc.), or post a message to an appropriate mailing list.</p></note>
-   </section>
-   </section>
 </page>
diff --git a/gnome-help/C/net-wireless-troubleshooting-hardware-info.page b/gnome-help/C/net-wireless-troubleshooting-hardware-info.page
index 879ca79..843469b 100644
--- a/gnome-help/C/net-wireless-troubleshooting-hardware-info.page
+++ b/gnome-help/C/net-wireless-troubleshooting-hardware-info.page
@@ -5,8 +5,7 @@
     <link type="next" xref="net-wireless-troubleshooting-hardware-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>
@@ -17,30 +16,35 @@
       <email>gnome-doc-list gnome org</email>
     </credit>
 
-    <desc>Troubleshoot your connection to a wireless network.</desc>
+    <desc>You may need details such as the model number of your wireless adapter in subsequent troubleshooting steps.</desc>
     <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
   </info>
 
-<title>Resolve problems with wireless connections</title>
-
-<section id="net-hardware-check">  
-  <title>Gather information about your computer and network hardware:</title>
-  <p>To best troubleshoot your wireless connection you will need some items and some information. Although you might not have all of these items, collect what you can:</p>
-    <list>
-      <item><p>Your laptop and wireless router (of course!)</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>If possible, have access to an alternate working internet connection for downloading software and drivers</p></item>
-    </list>
-
-  <p>It is also helpful to have the following information available. Again, just collect what you can:</p>
-    <list>
-      <item><p>The name of the manufacturer for your computer, wireless adapter and router</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 your devices or their packaging. These can be especially helpful, 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>Once you have these items and this information, click <gui>Next</gui> in the upper-right portion of this page to continue.</p>
-</section>
+<title>Wireless network troubleshooter</title>
+<subtitle>Gather information about your network hardware</subtitle>
+
+<p>In this step, you will collect information about your wireless network device. The way you fix many wireless problems depends on the make and model number of the wireless adapter, so you will need to make a note of these details. It can also be helpful to have some of the items that came with your computer too, like device driver installation discs. Look for the following items, if you still have them:</p>
+
+<list>
+ <item>
+  <p>The packaging and instructions for your wireless devices (especially the user guide for your router)</p>
+ </item>
+ <item>
+  <p>The disc containing drivers for your wireless adapter (even if it only contains Windows drivers)</p>
+ </item>
+ <item>
+  <p>The manufacturers and model numbers of your computer, wireless adapter and router. This information can usually be found on the underside/reverse of the device.</p>
+ </item>
+ <item>
+  <p>Any version/revision numbers that may be printed on your wireless network devices or their packaging. These can be especially helpful, so look carefully.</p>
+ </item>
+ <item>
+  <p>Anything on the driver disc that identifies either the device itself, its "firmware" version, or the components (chipset) it uses.</p>
+ </item>
+</list>
+
+<p>If possible, try to get access to an alternative working internet connection so that you can download software and drivers if necessary. (Plugging your computer directly into the router with an Ethernet network cable is one way of providing this, but only plug it in when you need to.)</p>
+
+<p>Once you have as many of these items as possible, click <gui>Next</gui>.</p>
 
 </page>
diff --git a/gnome-help/C/net-wireless-troubleshooting-initial-check.page b/gnome-help/C/net-wireless-troubleshooting-initial-check.page
index 5c6475d..526c923 100644
--- a/gnome-help/C/net-wireless-troubleshooting-initial-check.page
+++ b/gnome-help/C/net-wireless-troubleshooting-initial-check.page
@@ -5,8 +5,7 @@
     <link type="next" xref="net-wireless-troubleshooting-hardware-info"/>
     
     <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>
@@ -17,28 +16,36 @@
       <email>gnome-doc-list gnome org</email>
     </credit>
 
-    <desc>Troubleshoot your connection to a wireless network.</desc>
+    <desc>Make sure that simple network settings are correct and prepare for the next few troubleshooting steps.</desc>
     <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
   </info>
 
-<title>Resolve problems with wireless connections</title>
-
-  <section id="net-wireless-initial-check">
-    <title>Performing an initial check</title>
-  <p>Our first step will be to verify some basic network connectivity information.</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 (such as a wireless-USB adapter, or a PCMCIA card), make sure that it is inserted into the proper slot on your computer.</p></item>
-   <item><p>If your wireless card is <em>inside</em> of your computer, 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 (such as <app>gnome-terminal</app>), and enter the following command:</p>
-  <p><cmd>nm-tool</cmd></p></item>
-  </steps>
-
-   <p>The <app>nm-tool</app> program will display information about your network hardware and connection status. If output from the wireless connection section contains the text, <code>State: Connected</code>, it means that your wireless adapter is working and it is connected to your wireless router.</p>
-
-  <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>
+<title>Wireless network troubleshooter</title>
+<subtitle>Perform an initial connection check</subtitle>
+
+<p>In this step you will check some basic information about your wireless network connection. This is to make sure that your networking problem isn't caused by a relatively simple issue, like the wireless connection being turned off, and to prepare for the next few troubleshooting steps.</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 (such as a USB adapter, or a PCMCIA card that plugs into your laptop), make sure that it is firmly inserted into the proper slot on your computer.</p>
+ </item>
+ <item>
+  <p>If your wireless card is <em>inside</em> your computer, make sure that the wireless switch is turned on (if it has one). Laptops often have wireless switches that you can toggle by pressing a combination of keyboard keys.</p>
+ </item>
+ <item>
+  <p>Click the network icon and make sure that <gui>Wireless</gui> is set to ON. You should also check that <link xref="net-wireless-airplane">Airplane Mode is not switched on</link>.</p>
+ </item>
+ <item>
+  <p>Open the Terminal, type <cmd>nm-tool</cmd> and press <key>Enter</key>.</p>
+  <p>This will display information about your network hardware and connection status. Look down the list of information and see if there is a section related to the wireless network adapter. The information for each network device is separated by a row of dashes. If you find the line <code>State: Connected</code> in the section for your wireless adapter, it means that it is working and connected to your wireless router.</p>
+ </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 to make sure the settings are correct, or contact your ISP for support.</p>
+
+<p>If the information from <cmd>nm-tool</cmd> 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>
    
 </page>
diff --git a/gnome-help/C/net-wireless-troubleshooting.page b/gnome-help/C/net-wireless-troubleshooting.page
index afda574..2d306c7 100644
--- a/gnome-help/C/net-wireless-troubleshooting.page
+++ b/gnome-help/C/net-wireless-troubleshooting.page
@@ -9,7 +9,6 @@
     <revision pkgversion="3.0" date="2011-04-05" status="final"/>
     <revision pkgversion="3.0" version="3.0.1" date="2011-04-06" status="outdated"/>
 
-
     <credit type="author">
       <name>Contributors to the Ubuntu documentation wiki</name>
     </credit>
@@ -19,24 +18,28 @@
       <email>gnome-doc-list gnome org</email>
     </credit>
 
-    <desc>Troubleshoot your connection to a wireless network.</desc>
+    <desc>Identify and fix problems with wireless connections</desc>
     <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
   </info>
 
-<title>Resolve problems with wireless connections</title>
-
-  <p>This guide is designed to help you troubleshoot and resolve problems with accessing a wireless network.</p>
+<title>Wireless network troubleshooter</title>
 
-  <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, do not be afraid! The guide will direct you at each step.</p></note>
+<p>This is a step-by step troubleshooting guide to help you identify and fix wireless problems. If you cannot connect to a wireless network for some reason, try following the instructions here.</p>
 
-  <p>We will proceed through the following tasks to connect your computer to the internet:</p>
-  <list style="numbered">
+<p>We will proceed through the following steps to get your computer connected to the internet:</p>
+  <list style="numbered compact">
     <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>To get started, click on the <em>Next</em> link in the upper-right portion of the page. This link, and others like it on following pages, will take you through each step in the guide.</p>
-   
+  <p>To get started, click on the <em>Next</em> link at the top right of the page. This link, and others like it on following pages, will take you through each step in the guide.</p>
+
+<note>
+ <title>Using the command line</title>
+ <p>Some of the instructions in this guide ask you to type commands into the <em>command line</em> (Terminal). You can find the Terminal application in the <gui>Activities</gui> overview.</p>
+ <p>If you are not familiar with using a command line, don't worry - this guide will direct you at each step. All you need to remember is that commands are case-sensitive (so you must type them <em>exactly</em> as they appear here), and to press <key>Enter</key> after typing each command to run it.</p>
+</note>
+
 </page>



[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]