[user-guide] Expand section on KNetworkManager as it is now significantly different from NetworkManager in GNOME.
Nathan Thomas
nathant at fedoraproject.org
Sat Aug 13 18:15:42 UTC 2011
commit bf19b492336d7bda7459a0cf6ade4db719177394
Author: Nathan Thomas <nathan at afternoondust.co.uk>
Date: Sat Aug 13 20:07:50 2011 +0200
Expand section on KNetworkManager as it is now significantly different from NetworkManager in GNOME.
en-US/Connecting_to_the_Internet.xml | 71 ++++++++++++++++++++++++++++++---
1 files changed, 64 insertions(+), 7 deletions(-)
---
diff --git a/en-US/Connecting_to_the_Internet.xml b/en-US/Connecting_to_the_Internet.xml
index e915317..e23b152 100644
--- a/en-US/Connecting_to_the_Internet.xml
+++ b/en-US/Connecting_to_the_Internet.xml
@@ -9,7 +9,7 @@
<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).
+ 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 interfaces and connections that allow you to access the Internet, a Local Area Network (LAN), or a Virtual Private Network (VPN).
</para>
<para>
For most networks, NetworkManager is able to do most of the configuration automatically:
@@ -34,7 +34,7 @@
<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:
+ <application>NetworkManager</application> starts automatically when you log in, and is visible in GNOME as the <application>NetworkManager applet</application> icon in the top bar, on the top right of the desktop. The icon can display three kinds of information:
<itemizedlist>
<listitem>
<para>
@@ -54,16 +54,16 @@
</itemizedlist>
</para>
<para>
- 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:
+ Clicking on the NetworkManager icon provides a context sensitive menu. Each section of the menu corresponds to a type of networking interface available on your computer. Depending on the interfaces you have available, you may see:
<itemizedlist>
<listitem>
<para>
- A section showing the status of available wired network devices.
+ A section showing the status of available wired network interfaces.
</para>
</listitem>
<listitem>
<para>
- 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.
+ A section showing the status of available wireless network interfaces, which can be switched on or off using the toggle switch. Available wireless networks are listed below. If you are currently connected to wireless network, this network will be indicated by a white dot next to its name. If no wireless interfaces are available, this section will not be shown.
</para>
</listitem>
<listitem>
@@ -78,7 +78,7 @@
</listitem>
<listitem>
<para>
- The final section allows you to access more advanced configuration options by clicking on <menulabel></guilabel>Network Settings</guilabel></menulabel>.
+ The final section allows you to access more advanced configuration options by clicking on <menulabel><guilabel>Network Settings</guilabel></menulabel>.
</para>
</listitem>
</itemizedlist>
@@ -119,7 +119,7 @@
<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.
+ The wireless section of the NetworkManager menu is only shown if Fedora detects that there is at least one wireless interface (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 interfaces 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 some interfaces 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>.
@@ -160,10 +160,67 @@
</section>
</section>
+ <section id="sect-User_Guide-Connecting_to_the_Internet_-_Using_NetworkManager_In_KDE_">
<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>
+ <para>
+ The <application>KNetworkManager</application> applet icon normally resides on the right hand side of the panel. Clicking on the icon brings up a menu showing a list of available network interfaces on the left, and the currently connected network and/or a list of available networks on the right.
+ </para>
+ <para>
+ Click on <guibutton>Manage Connections...</guibutton> to bring up the Network Connections Control Module. Here you can add or edit wired, wireless, mobile broadband, VPN, and DSL networks by clicking on the appropriate tab. If a particular type of network interface is not available, its tab will be greyed out.
+ </para>
+
+ <section id="sect-User_Guide-Connecting_to_the_Internet_-_Using_NetworkManager_In_KDE_-_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>KNetworkManager</application> applet icon to bring up the menu.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Ensure that the <guilabel>Enable networking</guilabel> and <guilabel>Enable wireless</guilabel> boxes in the bottom left hand corner of the menu are both ticked.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Select <menuchoice><guilabel>WLAN interface</guilabel></menuchoice> from the <menuchoice><guilabel>Interfaces</guilabel></menuchoice> list on the left.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Select the name of the network you wish to connect to in the <menuchoice><guilabel>Connections</guilabel></menuchoice> list on the right.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Enter the network's password if prompted. You may also need to unlock <application>KWalletManager</application> so the network password can be stored. You can then choose whether you want the password to be filled in automatically each time you connect to the network. If this is the first time you have used <application>KWalletManager</application>, you will be asked to create a new password to unlock the <application>KWalletManager</application> keychain.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ If the password is accepted and the connection successful, the KNetworkManager applet icon will change from an empty ethernet socket to a wireless icon with curved bands indicating the strength of the wireless signal.
+ </para>
+ </listitem>
+ </itemizedlist>
+ </para>
+ <important>
+ <title>Why isn't the wireless section shown?</title>
+ <para>
+ Wireless (WLAN) interfaces only appear in the <menuchoice><guilabel>Interfaces</guilabel></menuchoice> list if Fedora detects that there is at least one wireless interface (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 interfaces 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 some interfaces 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>
+ </important>
+ </section>
+ </section>
+
<para>
For more information on <application>NetworkManager</application> , you can refer to:
</para>
More information about the docs-commits
mailing list