[gnome-user-docs] Comment and minor edits to keyboard-layouts, final

[Shaun McCance <shaunm src gnome org>]

commit 3ae6d7ebf86e92499d43cfaa9c0a551cb8ee1a2e
Author: Shaun McCance <shaunm gnome org>
Date:   Sat Sep 24 14:08:40 2011 -0400

    Comment and minor edits to keyboard-layouts, final
    
    We're missing some stuff we really really need. I've described
    that in a comment.

 gnome-help/C/keyboard-layouts.page |   15 ++++++++++++++-
 gnome-help/C/keyboard.page         |    2 ++
 2 files changed, 16 insertions(+), 1 deletions(-)
---
diff --git a/gnome-help/C/keyboard-layouts.page b/gnome-help/C/keyboard-layouts.page
index b61a898..c0f30db 100644
--- a/gnome-help/C/keyboard-layouts.page
+++ b/gnome-help/C/keyboard-layouts.page
@@ -5,6 +5,8 @@
     <link type="guide" xref="prefs-language"/>
     <link type="guide" xref="keyboard" group="i18n"/>
 
+    <revision pkgversion="3.2" date="2011-09-24" status="final"/>
+
     <credit type="author">
       <name>Shaun McCance</name>
       <email>shaunm gnome org</email>
@@ -38,7 +40,7 @@
 
   <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
+  identifier for 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>
 
@@ -54,6 +56,17 @@
   <gui>â</gui> and <gui>â</gui> buttons to move layouts up and down in
   the list.</p>
 
+  <comment>
+    <cite date="2011-09-24">shaunm</cite>
+    <p>We're totally copping out on the custom options. That dialog is a
+    monster, and needs a reference. Note that the options in there are
+    dynamic from the X server. We might not get a definitive reference
+    of everything ever, but let's do our best. Make a separate page.
+    Don't clutter this page with that crap.</p>
+    <p>Also, we should identify common uses of those options and create
+    task pages for them.</p>
+  </comment>
+
   <note>
    <title>Custom options</title>
    <p>
diff --git a/gnome-help/C/keyboard.page b/gnome-help/C/keyboard.page
index 5f089b2..44b998e 100644
--- a/gnome-help/C/keyboard.page
+++ b/gnome-help/C/keyboard.page
@@ -6,6 +6,8 @@
     <link type="guide" xref="prefs"/>
     <link type="guide" xref="hardware"/>
 
+    <revision pkgversion="3.2" date="2011-09-24" status="final"/>
+
     <desc>
       <link xref="keyboard-layouts">Keyboard layouts</link>,
       <link xref="keyboard-cursor-blink">cursor blinking</link>,