Add a multi-layout keyboard example courtesy of ak@.

1 files changed, 21 insertions, 1 deletions

diff --git a/en_US.ISO8859-1/books/handbook/x11/chapter.xml b/en_US.ISO8859-1/books/handbook/x11/chapter.xml
index ef5640de91..2535fe1546 100644
--- a/en_US.ISO8859-1/books/handbook/x11/chapter.xml
+++ b/en_US.ISO8859-1/books/handbook/x11/chapter.xml
@@ -662,7 +662,7 @@ EndSection</programlisting>
 		the <literal>oss</literal> variant.</para>
 
 	      <example>
-		<title>Setting Keyboard Layout</title>
+		<title>Setting A Keyboard Layout</title>
 
 		<para><filename>/usr/local/etc/X11/xorg.conf.d/keyboard-fr-oss.conf</filename></para>
 
@@ -674,6 +674,26 @@ EndSection</programlisting>
 	Option		"XkbVariant" "oss"
 EndSection</programlisting>
 	      </example>
+
+	      <example>
+		<title>Setting Multiple Keyboard Layouts</title>
+
+		<para>Set United States, Spanish, and Ukrainian
+		  keyboard layouts.  Cycle throught these layouts by
+		  pressing
+		  <keycombo action="simul">
+		    <keycap>Alt</keycap>
+		    <keycap>Shift</keycap>
+		  </keycombo>.</para>
+
+		<para><filename>/usr/local/etc/X11/xorg.conf.d/kbd-layout-multi.conf</filename></para>
+
+		<programlisting>Section	"InputClass"
+	Identifier	"All Keyboards"
+	MatchIsKeyboard	"yes"
+	Option		"XkbLayout" "us, es, ua"
+EndSection</programlisting>
+	      </example>
 	    </listitem>
 	  </varlistentry>