[user-guide] Rewrite section on using NetworkManager in GNOME 3.
Nathan Thomas
nathant at fedoraproject.org
Sat Aug 13 16:04:29 UTC 2011
commit 7ca6302a5ca399ea792933775c0dd70afbadcd1a
Author: Nathan Thomas <nathan at afternoondust.co.uk>
Date: Sat Aug 13 18:03:54 2011 +0200
Rewrite section on using NetworkManager in GNOME 3.
en-US/Connecting_to_the_Internet.xml | 206 +++++++++-------------------------
1 files changed, 53 insertions(+), 153 deletions(-)
---
diff --git a/en-US/Connecting_to_the_Internet.xml b/en-US/Connecting_to_the_Internet.xml
index 1d32c0e..e915317 100644
--- a/en-US/Connecting_to_the_Internet.xml
+++ b/en-US/Connecting_to_the_Internet.xml
@@ -31,7 +31,7 @@
</para>
</section>
- <section id="sect-User_Guide-Connecting_to_the_Internet_-_Using_the_NetworkManager_Applet_In_GNOME_">
+ <section id="sect-User_Guide-Connecting_to_the_Internet_-_Using_NetworkManager_In_GNOME_">
<title>Using the NetworkManager Applet in GNOME</title>
<para>
<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:
@@ -54,26 +54,37 @@
</itemizedlist>
</para>
<para>
- Clicking on the NetworkManager icon provides a context sensitive menu divided in three sections:
+ Clicking on the NetworkManager icon provides a context sensitive menu. Each section of the menu corresponds to a type of networking device is available on your computer. Depending on the devices you have available, you may see:
<itemizedlist>
<listitem>
<para>
- The first section shows the status of available wired network devices.
+ A section showing 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.
+ A section showing 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>.
+ A section showing the status of available mobile broadband connections. This may be through an internal modem, a tethered mobile phone, or a USB dongle.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ A section showing the status of available Virtual Private Network (VPN) connections, if you have created any.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ The final 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_">
+
+ <section id="sect-User_Guide-Connecting_to_the_Internet_-_Using_NetworkManager_In_GNOME_-_Connecting_to_a_Wireless_Network_">
<title>Connecting to a Wireless Network</title>
<para>
To connect to a wireless network:
@@ -105,7 +116,7 @@
</listitem>
</itemizedlist>
</para>
- <note>
+ <important>
<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.
@@ -113,28 +124,43 @@
<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>
+ </important>
</section>
-
- <para>
- The <menuchoice><guimenu>VPN Connections</guimenu></menuchoice>
- submenu provides option to configure or disconnect to a VPN.
- </para>
- <para>
- Right clicking on the <application>nm-applet</application> show another context sensitive menu that allows you to
- <menuchoice> <guimenu>Enable Networking</guimenu> </menuchoice> and if available <menuchoice><guimenu>Enable Wireless</guimenu></menuchoice> or <menuchoice><guimenu>Enable Mobile Broadband</guimenu></menuchoice>.
-You can also <menuchoice> <guimenu>Enable Notifications</guimenu> </menuchoice> as well as view the
- <menuchoice> <guimenu>Connection Information</guimenu> </menuchoice>
- or
- <menuchoice> <guimenu>Edit Connections...</guimenu> </menuchoice>
- When editing connections, <application>NetworkManager</application> opens in a new
- window, in which you configure the network devices and connections.
- The <menuchoice> <guimenu>About</guimenu> </menuchoice> option
- provides information about the project and the people that created the application, with a link to the
- <ulink url="http://live.gnome.org/NetworkManager/">Project Web-Site</ulink>
-.
- </para>
+ <section id="sect-User_Guide-Connecting_to_the_Internet_-_Using_NetworkManager_In_GNOME_-_Advanced_Configurations_">
+ <title>Advanced Configurations</title>
+ <para>
+ You can access advanced network settings and configure new networks by clicking on the <application>NetworkManager</application> applet icon and selecting <menuchoice><guilabel>Network Settings</guilabel></menuchoice>. Here you can do several things:
+ <itemizedlist>
+ <listitem>
+ <para>
+ Click on <menuchoice><guilabel>Wired</guilabel></menuchoice> to access detailed information about your wired connection, including hardware and IP addresses. You can configure advanced options, such as IPv4 and IPv6 settings, by clicking on <menuchoice><guilabel>Options...</guilabel></menuchoice>. You can choose whether to connect to a network automatically when you log in, and whether it is available to other users set up on your machine.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Click on <menuchoice><guilabel>Wireless</guilabel></menuchoice> to see similar information regarding your wireless connection. Selecting <menuchoice><guilabel>Options...</guilabel></menuchoice> allows you to set the wireless network type, configure IPv4 and IPv6 settings, and enter security details. You can choose whether to connect to a network automatically when you log in, and whether it is available to other users set up on your machine.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Click on <menuchoice><guilabel>Network Proxy</guilabel></menuchoice> to configure a network proxy.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Click on the <guibutton>+</guibutton> button at the bottom of the left hand pane to add a new Virtual Private Network (VPN) connection. The new connection is then added to the list of available connections. Click on the name of a connection you have created to switch it on or off and to change settings. Click on the <guibutton>-<guibutton> button to remove it.
+ </para>
+ </listitem>
+ </itemizedlist>
+ </para>
+ <para>
+ You can click on the <guibutton>Aeroplane Mode</guibutton> toggle switch in the bottom right hand corner of the Network Settings window to instantly toggle all network connections on or off.
+ </para>
+ </section>
+ </section>
+
+
<para>
Just like its GNOME counterpart, KDE provides an applet interface for NetworkManager, known as <application>KNetworkManager</application>. This application development was started by <ulink url="http://www.novell.com">Novell</ulink> and provides an integrated QT-based experience with similar usage and configuration as its GNOME counterpart, <application>nm-applet</application>.
</para>
@@ -167,132 +193,6 @@ You can also <menuchoice> <guimenu>Enable Notifications</guimenu> </menuchoice>
</listitem>
</itemizedlist>
</section>
-<section id="sect-User_Guide-Connecting_to_the_Internet-NM_window">
-<title>The NetworkManager window</title>
-<para>
- To access to the <application>NetworkManager</application>
- window to setup your network devices and connections, right-click on the NetworkManager applet icon then select <menuchoice><guimenu>Edit Connections...</guimenu></menuchoice>.
-</para>
-<important>
-<title>Be root to save your configurations</title>
-<para>
- Before creating your new configuration, the application opens a window to confirm your operation. To continue enter the root password.
-</para>
-</important>
-<para>
- When editing, in the <application>NetworkManager</application> window, you will find these items:
-</para>
-<itemizedlist>
-<listitem>
-<para>
-<guilabel>Connection name</guilabel>
-: A user-readable connection identifier/name
-</para>
-</listitem>
-<listitem>
-<para>
-<guilabel>Connect automatically</guilabel>
-: If checked,
-<application>NetworkManager</application>
- will activate this connection when its network resources are available. If unchecked, the connection must be manually activated by you.
-</para>
-</listitem>
-<listitem>
-<para>
-<guilabel>Available to all users</guilabel>
-: If checked,
-<application>NetworkManager</application>
- gives all users access to this network connection.
-</para>
-</listitem>
-</itemizedlist>
-<para>
-Additional tabs vary depending on the type of Internet connection.
-</para>
-</section>
-
-<section id="sect-User_Guide-Connecting_to_the_Internet-Wireless-Setup">
-<title>Wireless connections</title>
-<para>
-The most common items you should fill in, when using a wireless connection will appear in the <guilabel>Wireless Tab</guilabel>:
-</para>
-<itemizedlist>
-<listitem>
-<para>
-<guilabel>SSID</guilabel>
-: The SSID of the WiFi network
-</para>
-</listitem>
-<listitem>
-<para>
-<guilabel>Mode</guilabel>
- The available modes are:
-<guilabel>Infrastructure</guilabel>
- (default),
-<guilabel>Ad Hoc</guilabel>
-</para>
-</listitem>
-<listitem>
-<para>
-<guilabel>BSSID</guilabel>
-: If specified, directs the device to only associate with the given access point. This capability is highly driver dependent and not supported by all devices.
-<citetitle>
-Note: this property does not control the BSSID used when creating an
-<guilabel>Ad Hoc</guilabel>
- network.
-</citetitle>
-</para>
-</listitem>
-</itemizedlist>
-<para>
-The <guilabel>Wireless Security</guilabel> tab allows you to choose no security or to specify one of the following security methods:
-</para>
-<itemizedlist>
-<listitem>
-<para>
-<guilabel>WEP 40/128-bit Key</guilabel>
-: Your WEP personal key
-</para>
-</listitem>
-<listitem>
-<para>
-<guilabel>WEP 128-bit Passphrase</guilabel>
-: The passphrase to decipher your WEP
-</para>
-</listitem>
-<listitem>
-<para>
-<guilabel>LEAP</guilabel>
-:
-</para>
-</listitem>
-<listitem>
-<para>
-<guilabel>Dynamic WEAP (802.1x)</guilabel>
-:
-</para>
-</listitem>
-<listitem>
-<para>
-<guilabel>WPA & WPA2 Personal</guilabel>
-: Your WPA personal key
-</para>
-</listitem>
-<listitem>
-<para>
-<guilabel>WPA & WPA2 Enterprise</guilabel>
-:
-</para>
-</listitem>
-</itemizedlist>
-<para>
-The <guilabel>IPv4-Settings</guilabel> tab configures DHCP or static Internet settings. View
-<xref linkend="sect-User_Guide-Connecting_to_the_Internet-Items_Editing_IPv4"/> with wired connections below for more information or see the <citetitle>Wireless Guide</citetitle> at <ulink url="http://docs.fedoraproject.org/">docs.fedoraproject.org</ulink>.
-</para>
-<para>
-The <guilabel>IPv6 Settings</guilabel> tab similarly allows the configuration of IPv6 addresses with DHCP or static settings.
-</para>
-</section>
<section id="sect-User_Guide-Connecting_to_the_Internet-Mobile_Broadband">
<title>Mobile Broadband</title>
More information about the docs-commits
mailing list