[user-guide] Rewrote section on using the NetworkManager applet in GNOME 3.

Sat Aug 13 14:11:34 UTC 2011

commit 79434a455fff4ff3dcaf3335406085972fdffa00
Author: Nathan Thomas <nathan at afternoondust.co.uk>
Date:   Sat Aug 13 16:10:58 2011 +0200

    Rewrote section on using the NetworkManager applet in GNOME 3.

 en-US/Connecting_to_the_Internet.xml |   99 ++++++++++++++++++++++++++++++---
 1 files changed, 90 insertions(+), 9 deletions(-)
---

diff --git a/en-US/Connecting_to_the_Internet.xml b/en-US/Connecting_to_the_Internet.xml
index af7ed22..1d32c0e 100644
--- a/en-US/Connecting_to_the_Internet.xml
+++ b/en-US/Connecting_to_the_Internet.xml
@@ -4,8 +4,10 @@
 
 <chapter id="chap-User_Guide-Connecting_to_the_Internet">
 	<title>Connecting to the Internet</title>
-	<section id="sect-User_Guide-Connecting_to_the_Internet-NM_Applet">
-		<title>The NetworkManager Applet</title>
+	
+	<section id="sect-User_Guide-Connecting_to_the_Internet_-_Introducing_NetworkManager_">
+		<title>Introducing NetworkManager</title>	
+	
 		<para>
 			In Fedora, connecting to the Internet and other kinds of networks is handled by <application>NetworkManager</application>. This application can be used to configure a wide variety of network devices and connections that allow you to access the Internet, a Local Area Network (LAN), or a Virtual Private Network (VPN). 
 		</para>
@@ -27,16 +29,95 @@
 		<para>
 			In both instances, you can check your network status, access various configuration options, and set up other types of network connection using the <application>NetworkManager</application> applet.
 		</para>  	
+	</section>
+	
+	<section id="sect-User_Guide-Connecting_to_the_Internet_-_Using_the_NetworkManager_Applet_In_GNOME_">
+		<title>Using the NetworkManager Applet in GNOME</title>
 	<para>
-	<application>NetworkManager</application>
-	 executes automatically when you start your session and it is visible in GNOME as the <application>nm-applet</application> icon on the top right of the desktop. 
-If you move the mouse over it, it shows the active connection. 
+	<application>NetworkManager</application> starts automatically when you log in, and is visible in GNOME as the <application>NetworkManager applet</application> icon on the top right of the desktop. The icon can display three kinds of information:
+		<itemizedlist>
+			<listitem>
+				<para>
+					If the computer is connected to a wired network, a picture of a cable is shown.
+				</para>
+			</listitem>
+			<listitem>
+				<para>
+					If the computer is connected to a wireless network, a picture of curved bands is shown. The color of the bands indicates the strength of the wireless signal - if the signal is at full strength, all of the bands will be white.
+				</para>
+			</listitem>
+			<listitem>
+				<para>
+					If the computer is not connected to any networks, a picture of two computers with a white cross between them is shown.
+				</para>
+			</listitem>
+		</itemizedlist>
 	</para>
 	<para>
-Left-clicking on the icon provides a context sensitive menu divided in three sections.	
-	The first section shows the active connection or connections along with an option to 
-	<guilabel>Disconnect</guilabel>
-	The second section views the other available connections. Switch to one of them with a simple click and the previous one closes automatically.
+		Clicking on the NetworkManager icon provides a context sensitive menu divided in three sections:
+			<itemizedlist>
+				<listitem>
+					<para>	
+						The first section shows the status of available wired network devices.
+					</para>
+				</listitem>
+				<listitem>
+					<para>
+						The second section shows the status of available wireless network devices, which can be switched on or off using the toggle switch. Available wireless networks are listed. If you are currently connected to wireless network, this network will be indicated by a white dot next to its name. If no wireless devices are available, this section will not be shown.
+					</para>
+				</listitem>
+				<listitem>
+					<para>
+						The third section allows you to access more advanced configuration options by clicking on <menulabel></guilabel>Network Settings</guilabel></menulabel>.
+					</para>
+				</listitem>
+			</itemizedlist>
+		</para>
+			<section id="sect-User_Guide-Connecting_to_the_Internet_-_Using_the_NetworkManager_Applet_In_GNOME_-_Connecting_to_a_Wireless_Network_">
+			<title>Connecting to a Wireless Network</title>
+		<para>
+			To connect to a wireless network:
+			<itemizedlist>
+				<listitem>
+					<para>
+						Click on the <application>NetworkManager</application> applet icon to bring up the menu.
+					</para>
+				</listitem>
+				<listitem>
+					<para>
+						Ensure that the <guibutton>Wireless</guibutton> toggle switch is set to <guibutton>ON</guibutton>.
+					</para>
+				</listitem>
+				<listitem>
+					<para>
+						Select the name of the wireless network you want to connect to from the list of available wireless networks.
+					</para>
+				</listitem>
+				<listitem>
+					<para>
+						If prompted for a password, enter the password for the wireless network you want to connect to. The password will be remembered automatically, so you should only have to do this once for each network.
+					</para>
+				</listitem>
+				<listitem>
+					<para>
+						If the password is accepted and the connection is successful, the <application>NetworkManager</application> applet will display the curved bands icon, with the strength of the connection indicated by the number of bands that are white instead of grey.
+					</para>
+				</listitem>
+			</itemizedlist>
+			</para>
+			<note>
+				<title>Why isn't the wireless section shown?</title>
+					<para>
+						The wireless section of the NetworkManager menu is only shown if Fedora detects that there is at least one wireless device (such as an internal wireless card or external USB wireless adaptor) present with the correct driver installed. The drivers for a wide variety of wireless devices are included in the Linux kernel, and do not require installation. Other drivers are not included in the Linux kernel and must be obtained and installed; for other devices there is no available Linux driver. Please refer to <ulink url="http://linuxwireless.org/en/users/Drivers">http://linuxwireless.org/en/users/Drivers</ulink> for an updated list of available Linux drivers. 
+					</para>
+					<para>
+						If you are experiencing difficulties with wireless drivers, you can search the community-run Fedora Forums for help: <ulink url="http://www.fedoraforum.org/">http://www.fedoraforum.org/</ulink>.
+					</para>
+			</note>
+		</section>
+		
+									
+	<para>	
 	The <menuchoice><guimenu>VPN Connections</guimenu></menuchoice>
 	submenu provides option to configure or disconnect to a VPN. 
 	</para>
