[deployment-guide/comm-rel: 31/74] Wrote the Changing the Keyboard Layout section.

[dsilas]

commit bc572e716fe5c2c20c84a187e880702ed05102a6
Author: Jaromir Hradilek <jhradile at redhat.com>
Date:   Thu Jun 24 17:55:28 2010 +0200

    Wrote the Changing the Keyboard Layout section.

 en-US/Keyboard_Configuration.xml                   |   46 +++++++++++++++----
 .../keyboard-configuration-layouts-default.png     |  Bin 0 -> 3446 bytes
 2 files changed, 36 insertions(+), 10 deletions(-)
---
diff --git a/en-US/Keyboard_Configuration.xml b/en-US/Keyboard_Configuration.xml
index 826f0d7..24a4916 100644
--- a/en-US/Keyboard_Configuration.xml
+++ b/en-US/Keyboard_Configuration.xml
@@ -5,6 +5,9 @@
   <title>Keyboard Configuration</title>
   <section id="s1-keyboard-layout">
     <title>Changing the Keyboard Layout</title>
+    <para>
+      To open <application>Keyboard Layout Preferences</application>, select <menuchoice><guimenu>System</guimenu><guisubmenu>Preferences</guisubmenu><guimenuitem>Keyboard</guimenuitem></menuchoice> from the panel, and click the <guilabel>Layouts</guilabel> tab.
+    </para>
     <figure id="fig-keyboard-layouts-layout">
       <title>Keybord Layout Preferences</title>
       <mediaobject>
@@ -16,6 +19,9 @@
         </textobject>
       </mediaobject>
     </figure>
+    <para>
+      You will be presented with a list of available layouts. To add a new one, click the <guibutton>Add...</guibutton> button below the list, and you will be prompted to chose which layout you want to add.
+    </para>
     <figure id="fig-keyboard-layouts-layout-new">
       <title>Choosing a layout</title>
       <mediaobject>
@@ -27,6 +33,23 @@
         </textobject>
       </mediaobject>
     </figure>
+    <para>
+      Currently, there are two ways how to chose the keyboard layout: you can either find it by the country it is associated with (the <guilabel>By country</guilabel> tab), or you can select it by the language (the <guilabel>By language</guilabel> tab). In either case, first select the desired country or language from the <guilabel>Country</guilabel> or <guilabel>Language</guilabel> pulldown menu, then specify the variant from the <guilabel>Variants</guilabel> menu. The preview of the layout changes imediately. To confirm the selection, click <guibutton>Add</guibutton>.
+    </para>
+    <figure id="fig-keyboard-layouts-default">
+      <title>Selecting the default layout</title>
+      <mediaobject>
+        <imageobject>
+          <imagedata fileref="images/keyboard-configuration-layouts-default.png" format="PNG" scalefit="1" />
+        </imageobject>
+        <textobject>
+          <para>Selecting the default layout</para>
+        </textobject>
+      </mediaobject>
+    </figure>
+    <para>
+      Finally, to make the new layout the default, select the radio button next to its name. The changes take effect immediately. Note that there is a text-entry field at the bottom of the window where you can safely test your settings. Once you are satisfied, click <guibutton>Close</guibutton> to close the window.
+    </para>
     <figure id="fig-keyboard-layouts-layout-test">
       <title>Testing the layout</title>
       <mediaobject>
@@ -38,28 +61,31 @@
         </textobject>
       </mediaobject>
     </figure>
-    <figure id="fig-keyboard-layouts-layout-separate">
-      <title>Disabling separate layout for each window</title>
+    <note>
+      <title>Suggestion: Disable Separate Layout for Each Window</title>
+      <para>
+        By default, changing the keyboard layout affects the active window only. This means that if you change the layout and switch to another window, this window will use the old one, which might be confusing. To turn this unfortunate behavior off, unselect the <guilabel>Separate layout for each window</guilabel> checkbox.
+      </para>
       <mediaobject>
         <imageobject>
-          <imagedata fileref="images/keyboard-configuration-layouts-separate.png" format="PNG" scalefit="1" />
+          <imagedata fileref="images/keyboard-configuration-layouts-separate.png" align="center" format="PNG" scalefit="1" />
         </imageobject>
         <textobject>
           <para>Disabling separate layout for each window</para>
         </textobject>
       </mediaobject>
-    </figure>
-    <figure id="fig-keyboard-layouts-layout-prioritize">
-      <title>Changing the order of layouts</title>
+      <para>
+        Doing this has its drawbacks though, as you will no longer be able to chose the default layout by selecting the radio buton as shown in <xref linkend="fig-keyboard-layouts-default" />. To make the layout the default, simply drag it at the beginning of the list. 
+      </para>
       <mediaobject>
         <imageobject>
-          <imagedata fileref="images/keyboard-configuration-layouts-prioritize.png" format="PNG" scalefit="1" />
+          <imagedata fileref="images/keyboard-configuration-layouts-prioritize.png" align="center" format="PNG" scalefit="1" />
         </imageobject>
         <textobject>
           <para>Changing the order of layouts</para>
         </textobject>
       </mediaobject>
-    </figure>
+    </note>
   </section>
   <section id="s1-keyboard-indicator">
     <title>Adding the Keyboard Layout Indicator</title>
@@ -109,7 +135,7 @@
   <section id="s1-keyboard-break">
     <title>Setting Up a Typing Break</title>
     <para>
-      Typing for a long period of time can be not only tiresome, but it can also increase the risk of serious health problems, such as the carpal tunnel syndrome. One way of preventing this is to configure the system to enforce the typing break. Simply select <menuchoice><guimenu>System</guimenu><guisubmenu>Preferences</guisubmenu><guimenuitem>Keyboard</guimenuitem></menuchoice> from the panel, click the <guilabel>Typing Break</guilabel> tab, and check the <guilabel>Lock screen to enforce typing break</guilabel> box.
+      Typing for a long period of time can be not only tiresome, but it can also increase the risk of serious health problems, such as the carpal tunnel syndrome. One way of preventing this is to configure the system to enforce the typing break. Simply select <menuchoice><guimenu>System</guimenu><guisubmenu>Preferences</guisubmenu><guimenuitem>Keyboard</guimenuitem></menuchoice> from the panel, click the <guilabel>Typing Break</guilabel> tab, and select the <guilabel>Lock screen to enforce typing break</guilabel> check box.
     </para>
     <figure id="fig-keyboard-break">
       <title>Typing Break Properties</title>
@@ -123,7 +149,7 @@
       </mediaobject>
     </figure>
     <para>
-      To increase or decrease the amount of time you want to be allowed to type before the break is enforced, click the up or down button next to the <guilabel>Work interval lasts</guilabel> label respectively. You can do the same with the <guilabel>Break interval lasts</guilabel> setting to alter the length of the break itself. Finally, check the <guilabel>Allow postponing of breaks</guilabel> if you want to be able to delay the break in case you need to finish the work. The changes take effect immediately.
+      To increase or decrease the amount of time you want to be allowed to type before the break is enforced, click the up or down button next to the <guilabel>Work interval lasts</guilabel> label respectively. You can do the same with the <guilabel>Break interval lasts</guilabel> setting to alter the length of the break itself. Finally, select the <guilabel>Allow postponing of breaks</guilabel> checkbox if you want to be able to delay the break in case you need to finish the work. The changes take effect immediately.
    </para>
     <figure id="fig-keyboard-break-take">
       <title>Taking a break</title>
diff --git a/en-US/images/keyboard-configuration-layouts-default.png b/en-US/images/keyboard-configuration-layouts-default.png
new file mode 100644
index 0000000..87143db
Binary files /dev/null and b/en-US/images/keyboard-configuration-layouts-default.png differ