[kde-doc-english] branches/KDE/3.5/kdenetwork/doc/kwifimanager

[Stefan Winter]

SVN commit 440432 by swinter:

updated documentation for KDE 3.5, proof-reading
might be necessary
CCMAIL:kde-doc-english at kde.org
CCMAIL:kde-i18n-doc at kde.org


 M  +18 -14    index.docbook  


--- branches/KDE/3.5/kdenetwork/doc/kwifimanager/index.docbook #440431:440432
@@ -47,11 +47,12 @@
     <title>Introduction</title>
     <para> The &kwifimanager; suite is a set of tools which allows you to manage your wireless
       &LAN; Network Interface card (PC-Card, PCI or miniPCI) under the K Desktop Environment. It
-      provides information about your current connection and lets you set up up to four independent
-      configurations. If you are in a place where none of your preconfigured networks is available,
+      provides information about your current connection and lets you set up up to ten independent
+      configurations and use up to four configrations that are pre-configured by distribution-specific
+      scripts. If you are in a place where none of your preconfigured networks is available,
       you can also dynamically switch to an available network with almost no configuration effort.
       &kwifimanager; supports every wireless &LAN; card that uses the wireless extensions
-      interface. This includes virtually all wireless &LAN; card that is operational at all
+      interface. This includes virtually all wireless &LAN; cards that are operational at all
       under the &Linux; operating system.</para>
   </chapter>
   <chapter id="using">
@@ -64,7 +65,10 @@
         the command prompt of a console window or via the K Menu, where it is located by default in
           the<guisubmenu>Applications</guisubmenu> group. If &kwifimanager; is already running
         but minimised to the system tray then it can be restored by clicking once on the <link
-          linkend="systrayicon">system tray icon</link>. The &GUI; elements of the application
+          linkend="systrayicon">system tray icon</link>. If there is more than one wireless &LAN;
+          card in your system, just open more than one instance of &kwifimanager;: every instance
+          will show information about a different card automatically.
+          The &GUI; elements of the application
         are explained in the following subsections.</para>
       <sect2 id="kwifimanager-main">
         <title>Main window</title>
@@ -83,7 +87,7 @@
                   out of range and can not communicate to the infrastructure network.</para>
               </listitem>
               <listitem>
-                <para> a laptop that is connected to a white box means that a connection to an
+                <para> a laptop that is connected to an access point means that a connection to an
                   access point is established.</para>
               </listitem>
               <listitem>
@@ -143,8 +147,8 @@
                 done on purpose to show that the cell you are connected to is not an actual physical
                 device, but rather an imaginary access point without a real physical address.</para>
               <informalexample>
-                <para> Your card is the first card that enters Ad-Hoc mode. Then all other cards
-                  entering Ad-Hoc mode will see your MAC-address, slightly modified: instead
+                <para> Your card is the first card that enters Ad-Hoc mode with a given SSID. Then all other cards
+                  entering Ad-Hoc mode with the same SSID will see your MAC-address, slightly modified: instead
                     of<computeroutput>00:xx:yy:zz:aa:bb</computeroutput> it will
                     show<computeroutput>02:xx:yy:zz:aa:bb</computeroutput>. This behavior is
                   intentional.</para>
@@ -242,7 +246,7 @@
           level in the statistics window by unselecting <menuchoice>
             <guimenu> Config </guimenu>
             <guimenuitem> Show noise level in statistics </guimenuitem>
-          </menuchoice> in KWiFiManagers main window.</para>
+          </menuchoice> in the &kwifimanager; main window.</para>
       </sect2>
       <sect2 id="config-edit">
         <title>Configuration Editor</title>
@@ -298,7 +302,7 @@
       <guimenuitem>Show Strength Number in System Tray</guimenuitem>.</para>
       <para>If you have configured &kwifimanager; to stay in the system tray when clicking on the 
         <guibutton>X</guibutton> button, the icon will stay in the tray persistently unless you really exit
-      the application by clicking on <guimenu>File</guimenu>, <guimenuitem>Close</guimenuitem>.</para>
+      the application by clicking on <guimenu>File</guimenu>, <guimenuitem>Quit</guimenuitem>.</para>
       <para>You can always hide the main application to the system tray by clicking on the tray icon. Similarly,
       to restore the main application from the tray, just click on it once.</para>
     </sect1>
@@ -311,7 +315,7 @@
         shown at any time by changing the <guilabel>Number of Configurations</guilabel> entry.
         If you have configured your wireless settings with a distribution-specific tool, chances are good
         that the &kcontrolcenter; module will automatically detect this and also read in and show that
-        configuration. In any case these configurations will be read-only, because it is the distributions
+        configuration. In any case these configurations will be read-only, because it is the distribution's
         job to handle updating these settings and the module should not interfere with their internal magic.
         Up to five additional preset configurations can be shown in addition to the ten
         that are self-definable. These configurations will have the name <guilabel>Vendor x</guilabel>
@@ -395,7 +399,7 @@
               receive packets that are encrypted with <emphasis>any</emphasis> of the keys.</para>
               <tip><para>You can achieve asymetrical encryption (different keys for sending and receiving)
                 if you configure your access point to send packets with a different key than the card. Just make
-              sure that the partner stations has the required key in any one of its key slots.</para></tip>
+              sure that the partner station has the required key in any one of its key slots.</para></tip>
             </listitem>
           </varlistentry>
           <varlistentry>
@@ -412,7 +416,7 @@
           </varlistentry>
           <varlistentry>
             <term>
-              <guilabel>Crytpo keys:</guilabel>
+              <guilabel>Crypto keys:</guilabel>
             </term>
             <listitem>
               <para>This box lets you specify the secret keys to use for cryptography. To protect 
@@ -424,7 +428,7 @@
             </listitem>
           </varlistentry>
         </variablelist>
-        <para>Be aware that the built-in cryptography support (named WEP for Wireless Equivalent
+        <para>Be aware that the built-in cryptography support (named WEP for Wired Equivalent
           Privacy) is not very safe at all. See <xref linkend="wep"/> for details.</para>
         </sect3>
         <sect3 id="config_power">
@@ -504,7 +508,7 @@
         standards for MAC addresses have a place reserved for such (rare) occasions: MAC addresses that are
         not globally valid have a bit set to one that shows that these addresses are 
         <quote>locally administered</quote>. This bit is the second bit in transmit order, and the seventh
-      bit in logical order and will hence raise the number from 00 to 02.</para>
+      bit in logical order and will hence raise the number of the MAC's first digit block from 00 to 02.</para>
       <para>You can compare this sort of address to the non-global IP addresses like<quote>192.168.*.*.</quote>
       </para>
       <para>So, the implementors of wireless networking agreed to give these<quote>virtual</quote>