[gnome-user-docs] g-h/keyboard-layouts: Added content, some extra nav, candidate

[Shaun McCance <shaunm src gnome org>]

commit 126c83de91da6cd6c5f0d43a0a253626396adb0b
Author: Shaun McCance <shaunm gnome org>
Date:   Sun Mar 27 20:14:35 2011 -0400

    g-h/keyboard-layouts: Added content, some extra nav, candidate

 gnome-help/C/figures/system-run.png |  Bin 0 -> 676 bytes
 gnome-help/C/hardware.page          |    4 +++
 gnome-help/C/keyboard-layouts.page  |   50 +++++++++++++++++++++++++++++-----
 gnome-help/C/tips-specialchars.page |    6 +++-
 gnome-help/Makefile.am              |    1 +
 5 files changed, 52 insertions(+), 9 deletions(-)
---
diff --git a/gnome-help/C/figures/system-run.png b/gnome-help/C/figures/system-run.png
new file mode 100644
index 0000000..2b2f609
Binary files /dev/null and b/gnome-help/C/figures/system-run.png differ
diff --git a/gnome-help/C/hardware.page b/gnome-help/C/hardware.page
index fd83e60..b33c2a0 100644
--- a/gnome-help/C/hardware.page
+++ b/gnome-help/C/hardware.page
@@ -50,6 +50,10 @@
  <title>Bluetooth</title>
 </section>
 
+<section id="keyboard" style="2column">
+ <title>Keyboard</title>
+</section>
+
 <section id="mouse" style="2column">
  <title>Mouse</title>
 </section>
diff --git a/gnome-help/C/keyboard-layouts.page b/gnome-help/C/keyboard-layouts.page
index 003ba76..7221e16 100644
--- a/gnome-help/C/keyboard-layouts.page
+++ b/gnome-help/C/keyboard-layouts.page
@@ -2,21 +2,55 @@
       type="topic" style="task"
       id="keyboard-layouts">
   <info>
-    <revision pkgversion="3.0" date="2011-03-20" status="stub"/>
+    <link type="guide" xref="hardware#keyboard"/>
+    <link type="guide" xref="prefs#languages"/>
+    <revision pkgversion="3.0" date="2011-03-20" status="candidate"/>
 
     <credit type="author">
       <name>Shaun McCance</name>
       <email>shaunm gnome org</email>
     </credit>
 
-    <desc></desc>
+    <desc>Make your keyboard behave like a keyboard for another language.</desc>
   </info>
 
-  <title>XXXXX: Keyboard layouts....</title>
+  <title>Use alternate keyboard layouts</title>
 
-  <comment>
-    <cite date="2011-03-20" href="mailto:shaunm gnome org">Shaun McCance</cite>
-    <p>Describe keyboard layouts. Might need to be split into
-    multiple tasks/explanations.</p>
-  </comment>
+  <p>Keyboards come in hundreds of different layouts for different languages.
+  Even for a single language, there are often multiple keyboard layouts, such
+  as the Dvorak layout for English. You can make your keyboard behave like a
+  keyboard with a different layout, regardless of the letters and symbols
+  printed on the keys. This is useful if you often switch between multiple
+  languages.</p>
+
+  <steps>
+    <item><p>Click your name in the top bar and select <gui>System Settings</gui>.</p></item>
+    <item><p>Click <gui>Region and Language</gui>.</p></item>
+    <item><p>Select the <gui>Layouts</gui> tab.</p></item>
+    <item><p>Click the <gui>+</gui> button, select a layout, and click <gui>Add</gui>.</p></item>
+  </steps>
+
+  <note style="sidebar">
+    <p>You can preview an image of any layout by selecting it in the list and clicking
+    <gui><media type="image" src="figures/system-run.png" width="16" height="16">preview</media></gui>,
+    or by clicking <gui>Preview</gui> in the popup window when adding a layout.</p>
+  </note>
+
+  <p>When you add multiple layouts, you can quickly switch between them using
+  the keyboard layout icon in the top bar. The top bar will display a short
+  string identifying the current layout, such as <gui>en</gui> for the standard
+  English layout. Click the layout indicator and select the layout you want to
+  use from the menu.</p>
+
+  <p>When you use multiple layouts, you can choose to have all windows use the
+  same layout or to set a different layout for each window. Using a different
+  layout for each window is useful, for example, if you're writing an article
+  in another language in a word processor window. Your keyboard selection will
+  be remembered for each window as you switch between windows.</p>
+
+  <p>By default, new windows will use the default keyboard layout. You can
+  instead choose to have them use the layout of the window you were last
+  using. The default layout is the layout at the top of the list. Use the
+  <gui>â??</gui> and <gui>â??</gui> buttons to move layouts up and down in
+  the list.</p>
 </page>
diff --git a/gnome-help/C/tips-specialchars.page b/gnome-help/C/tips-specialchars.page
index dff7d2c..c38668f 100644
--- a/gnome-help/C/tips-specialchars.page
+++ b/gnome-help/C/tips-specialchars.page
@@ -3,6 +3,7 @@
       id="tips-specialchars">
   <info>
     <link type="guide" xref="tips"/>
+    <link type="seealso" xref="keyboard-layouts"/>
 
     <revision pkgversion="3.0" date="2011-03-19" status="incomplete"/>
 
@@ -94,7 +95,10 @@
 
   <section id="layout">
     <title>Keyboard layouts</title>
-    <p>XXXXX: write keyboard layouts page, link</p>
+    <p>You can make your keyboard behave like the keyboard for another language,
+    regardless of the letters printed on the keys. You can even easily switch
+    between different keyboard layouts using an icon in the top bar. To learn
+    how, see <link xref="keyboard-layouts"/>.</p>
   </section>
 
   <section id="im">
diff --git a/gnome-help/Makefile.am b/gnome-help/Makefile.am
index 5c154e3..aec14ac 100644
--- a/gnome-help/Makefile.am
+++ b/gnome-help/Makefile.am
@@ -20,6 +20,7 @@ DOC_FIGURES = \
 	figures/shell.png \
 	figures/shell-terminology.png \
 	figures/shell-windows.png \
+	figures/system-run.png \
 	figures/universal-access-menu.png \
 	figures/yelp-icon-big.png