From 61dc685a766c1bf8c6bc23d219bce856b1ab1d03 Mon Sep 17 00:00:00 2001
From: Warren Block <wblock@FreeBSD.org>
Date: Fri, 16 Oct 2015 00:39:04 +0000
Subject: [PATCH] Add a multi-layout keyboard example courtesy of ak@.

---
 .../books/handbook/x11/chapter.xml            | 22 ++++++++++++++++++-
 1 file changed, 21 insertions(+), 1 deletion(-)

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>
 
@@ -672,6 +672,26 @@ EndSection</programlisting>
 	MatchIsKeyboard	"on"
 	Option		"XkbLayout" "fr"
 	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>