<?xml version="1.0"?>
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" 
"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
  <!ENTITY legal SYSTEM "legal.xml">
  <!ENTITY appletversion "2.3.6">
  <!ENTITY manrevision "2.4">
  <!ENTITY date "September 2003">
  <!ENTITY applet "Keyboard Layout Switcher">
]>

<!-- 
      (Do not remove this comment block.)
  Maintained by the GNOME Documentation Project
  http://developer.gnome.org/projects/gdp
  Template version: 2.0 beta
  Template last modified Apr 11, 2002
  
-->
<!-- =============Document Header ============================= -->
<article id="index" lang="en">
<!-- please do not change the id; for translations, change lang to -->
<!-- appropriate code -->
  <articleinfo> 
	 <title>&applet; Applet Manual V&manrevision;</title> 
	 <copyright> 
		<year>2002</year>
		<year>2003</year>  
		<holder>Sun Microsystems</holder> 
	 </copyright> 
	 <copyright> 
		<year>2000</year>
		<year>2002</year>  
		<holder>Emese Kovacs</holder> 
	 </copyright>
	 <copyright> 
		<year>2000</year>  
		<holder>Szabolcs (Shooby) BAN</holder> 
	 </copyright> 
	 <copyright> 
		<year>2000</year>  
		<holder>Dan Mueth</holder> 
	 </copyright> 
<!-- translators: uncomment this:

  <copyright>
   <year>2002</year>
   <holder>ME-THE-TRANSLATOR (Latin translation)</holder>
  </copyright>

   -->

	 <publisher> 
		<publishername>GNOME Documentation Project</publishername> 
	 </publisher> 

&legal;
<!-- This file  contains link to license for the documentation (GNU FDL), and 
     other legal stuff such as "NO WARRANTY" statement. Please do not change 
     any of this. -->

	 <authorgroup> 
		<author> 
		  <firstname>Sun</firstname> 
		  <surname>GNOME Documentation Team</surname> 
		  <affiliation> 
			 <orgname>Sun Microsystems</orgname> 
			 <address></address> 
		  </affiliation> 
		</author>
		<author> 
		  <firstname>Emese</firstname> 
		  <surname>Kovacs</surname> 
		  <affiliation> 
			 <orgname>GNOME Documentation Project</orgname> 
			 <address> <email>emese@gnome.hu</email> </address> 
		  </affiliation> 
		</author>  
		<author> 
		  <firstname>Szabolcs (Shooby)</firstname> 
		  <surname>BAN</surname> 
		  <affiliation> 
			 <orgname>GNOME Documentation Project</orgname> 
			 <address> <email>shooby@gnome.hu</email> </address> 
		  </affiliation> 
		</author>
		<author> 
		  <firstname>Dan</firstname> 
		  <surname>Mueth</surname> 
		  <affiliation> 
			 <orgname>GNOME Documentation Project</orgname> 
			 <address> <email>d-mueth@uchicago.edu</email> </address> 
		  </affiliation> 
		</author>  
      <!-- This is appropriate place for other contributors: translators,
           maintainers,  etc. Commented out by default.
        <othercredit role="translator">
	      <firstname>Latin</firstname> 
	      <surname>Translator 1</surname> 
	      <affiliation> 
	      	<orgname>Latin Translation Team</orgname> 
	       	<address> <email>translator@gnome.org</email> </address> 
	      </affiliation>
	      <contrib>Latin translation</contrib>
        </othercredit>
-->
	 </authorgroup>
	  
	 <revhistory>
		<revision> 
		  <revnumber>&applet; Applet Manual V&manrevision;</revnumber> 
		  <date>&date;</date> 
		<revdescription> 
			 <para role="author">Sun GNOME Documentation Team</para> 
			 <para role="publisher">GNOME Documentation Project</para> 
		  </revdescription>   
		</revision> 
		<revision> 
		  <revnumber>Keyboard Layout Switcher Applet Manual V2.2</revnumber> 
		  <date>January 2003</date> 
		<revdescription> 
			 <para role="author">Sun GNOME Documentation Team</para> 
			 <para role="publisher">GNOME Documentation Project</para> 
		  </revdescription>   
		</revision>
		<revision> 
		  <revnumber>Keyboard Layout Switcher Applet Manual V2.1</revnumber> 
		  <date>August 2002</date> 
		<revdescription> 
			 <para role="author">Sun GNOME Documentation Team</para> 
			 <para role="publisher">GNOME Documentation Project</para> 
		  </revdescription>   
		</revision> 
		<revision> 
		  <revnumber>Keyboard Layout Switcher Applet Manual V2.0</revnumber> 
		  <date>May 2002</date> 
		<revdescription> 
			 <para role="author">Sun GNOME Documentation Team</para> 
			 <para role="publisher">GNOME Documentation Project</para> 
		  </revdescription>   
		</revision> 
		<revision> 
		  <revnumber>GNOME Keyboard Applet</revnumber> 
		  <date>January 2002</date>
		  <revdescription> 
			 <para role="author">Emese Kovacs
				<email>emese@gnome.hu</email></para>	
			 <para role="publisher">GNOME Documentation Project</para> 
		  </revdescription>  		  
		</revision>
		<revision> 
		  <revnumber>GNOME Keyboard Applet</revnumber> 
		  <date>2000</date>
		  <revdescription> 
			 <para role="author">Szabolcs (Shooby) BAN
				<email>shooby@gnome.hu</email></para> 
			 <para role="author">Dan Mueth
				<email>d-mueth@uchicago.edu</email></para>
			 <para role="author">Emese Kovacs
				<email>emese@gnome.hu</email></para>	
			 <para role="publisher">GNOME Documentation Project</para> 
		  </revdescription>  		  
		</revision>
	 </revhistory> 
	 <releaseinfo> This manual describes version &appletversion; of &applet;.
		</releaseinfo> 
	 <legalnotice> 
		<title>Feedback</title> 
		<para> To report a bug or make a suggestion regarding the &applet; applet or this
		  manual, follow the directions in the 
		  <ulink url="ghelp:gnome-feedback" type="help">GNOME Feedback Page</ulink>. </para>
		
	 </legalnotice> 
  </articleinfo> 
  <indexterm> 
	 <primary>Keyboard Layout Switcher</primary> 
  </indexterm> 

<!-- ============= Document Body ============================= -->
<!-- ============= Introduction ============================== -->

  <sect1 id="gkb-introduction"> 

	 <title>Introduction</title> 

	 <figure id="gkb-fig"> 
		<title>&applet; Applet</title> 
		<screenshot> 
		  <mediaobject> 
			 <imageobject><imagedata fileref="figures/gkb_applet.png" format="PNG"/> 
			 </imageobject>
			 <textobject> 
				<phrase>Shows &applet; applet. Contains flag and label of current keyboard layout.
				</phrase> 
			 </textobject> 
		  </mediaobject> 
		</screenshot> 
	 </figure> 

	 <para>The <application>&applet;</application> applet enables you to assign different layouts to
	 your keyboard to suit different locales. The applet displays the flag and label associated with
	 the current keyboard layout.</para> 
	 <para>To add <application>&applet;</application> to a panel, right-click on the panel, then choose 
		<menuchoice> 
		  <guimenu>Add to Panel</guimenu> 
		  <guisubmenu>Utility</guisubmenu> 
		  <guimenuitem>&applet;</guimenuitem> 
		</menuchoice>.</para> 
  </sect1>


  <sect1 id="gkb-usage">
   
	 <title>Usage</title> 

	 <para>To switch to a different keyboard layout, click repeatedly on the applet until the applet displays
	 the keyboard layout that you want. If the applet does not contain the keyboard layout that you require, 
	 see <xref linkend="gkb-keymaps"/> for information about how to add keyboard layouts to the applet.</para>

  </sect1>


  <sect1 id="gkb-prefs"> 
	 <title>Preferences</title> 
	 <para>To configure <application>&applet;</application>, right-click on the
	 applet, then choose <guimenuitem>Preferences</guimenuitem>.</para> 

	 <sect2 id="gkb-keymaps"> 
		
		<title>Keyboards</title> 
		
		<para>The <guilabel>Keyboards</guilabel> tabbed section lists the keyboard layouts that are
		currently configured for the applet. </para>
		
		<sect3 id="gkb-modify-list">
		
		<title>To Modify the List of Keyboard Layouts</title>
		
		<para>To add a keyboard layout to the <guilabel>Keyboards</guilabel> 
		list, perform the following steps:</para>
		<orderedlist>
			<listitem><para>Click <guibutton>Add</guibutton> in the <guilabel>Keyboards</guilabel> tabbed 
			section. The applet displays the <guilabel>Select Keyboard</guilabel> dialog.</para></listitem>
			<listitem><para>Click on the arrow next to the country for which you want to add a keyboard
			layout, then select the keyboard layout that you want to add. </para></listitem>
			<listitem><para>Click <guibutton>Add</guibutton> to add the keyboard layout to the 
			<guilabel>Keyboards</guilabel> list.</para></listitem>
		</orderedlist>
		
		<para>To delete a keyboard layout from the <guilabel>Keyboards</guilabel> list, select the
		keyboard layout, then click <guibutton>Delete</guibutton>.</para>
		
		<para>To move a keyboard layout up in the <guilabel>Keyboards</guilabel> list, select the
		keyboard layout, then click <guibutton>Up</guibutton>. To move a keyboard layout down in 
		the <guilabel>Keyboards</guilabel> list, select the keyboard layout, then click 
		<guibutton>Down</guibutton>.</para>
		
		</sect3>
		
		<sect3 id="gkb-edit-layout">
		
		<title>To Edit a Keyboard Layout</title>
		<para>To edit a keyboard layout, select the keyboard layout, then click 
		<guibutton>Properties</guibutton>. The <guilabel>Edit Keyboard</guilabel> dialog
		contains the following elements:</para>
		
		<table frame="topbot" id="tbl-edit-layout">
    		<title>Edit Keyboard Elements</title> 
		<tgroup cols="2" colsep="1" rowsep="1">
		<colspec colname="COLSPEC0" colwidth="33*"/>
		<colspec colname="COLSPEC1" colwidth="33*"/>
		<thead> 
		 <row valign="top"> 
		  <entry> 
		  <para>Dialog Element</para></entry> 
		  <entry> 
		  <para>Description</para></entry> 
		 </row> 
	 	</thead> 
		<tbody> 
		 <row valign="top"> 
		  <entry> 
		  <para><guilabel>Name</guilabel></para></entry> 
		  <entry> 
		  <para>The name of the keyboard layout. This name is displayed in the <guilabel>Keyboards</guilabel> tabbed
		  section of the <guilabel>Preferences</guilabel> dialog.</para></entry>  
		 </row>
		 <row valign="top"> 
		  <entry> 
		  <para><guilabel>Label</guilabel></para></entry> 
		  <entry> 
		  <para>A short label for the keyboard layout. For example, the label for a United States English keyboard 
		  layout is <guilabel>us</guilabel>. By default, the applet displays the flag and label of
		  the current keyboard layout in the applet display. </para></entry>  
		 </row>
		 
		 <!--
		 <row valign="top"> 
		  <entry> 
		  <para><guilabel>Language</guilabel></para></entry> 
		  <entry> 
		  <para>The language for which the keyboard layout is adapted.</para></entry>  
		 </row>
		 <row valign="top"> 
		  <entry> 
		  <para><guilabel>Country</guilabel></para></entry> 
		  <entry> 
		  <para>The country where the keyboard layout is used.</para></entry>  
		 </row>
		 -->

		 <!--
		 <row valign="top"> 
		  <entry> 
		  <para><guilabel>Architecture</guilabel></para></entry> 
		  <entry> 
		  <para>The type of hardware system.</para></entry>  
		 </row>
		 <row valign="top"> 
		  <entry> 
		  <para><guilabel>Type</guilabel></para></entry> 
		  <entry> 
		  <para>The type of keyboard for example, 101 keys, 105 keys, and so on.</para></entry>  
		 </row>
		 <row valign="top"> 
		  <entry> 
		  <para><guilabel>Codepage</guilabel></para></entry> 
		  <entry> 
		  <para>The codeset that the language of the keyboard uses. For example, by default United States English uses the 
		  Western European ISO-8859-1 codeset.</para></entry>  
		 </row>
		 -->
		 
		 <row valign="top"> 
		  <entry> 
		  <para><guilabel>Command</guilabel></para></entry> 
		  <entry> 
		  <para>The command that the applet uses to change to the keyboard layout. You can use any 
		  of the following commands to change the keyboard layout:</para>
		  <para><command>gkb_xmmap <replaceable>us</replaceable></command> where <replaceable>us</replaceable>
		  is the file extension of the <filename>xmodmap</filename> file for the keyboard layout.</para>
		  <para><command>xmodmap <replaceable>/path/xmodmap.us</replaceable></command> where 
		  <replaceable>/path/xmodmap.us</replaceable> is the <filename>xmodmap</filename> file for the 
		  keyboard layout.</para>
		  <para><command>setxkbmap <replaceable>us</replaceable></command> where <replaceable>us</replaceable>
		  is the file extension of the <filename>xmodmap</filename> file for the keyboard layout.</para>
		  </entry>  
		 </row> 
		 
		 <row valign="top"> 
		  <entry> 
		  <para><guilabel>Flag</guilabel></para></entry> 
		  <entry> 
		  <para>The flag that represents the country in which the keyboard layout is 
		  used. By default, the applet 
		  displays the flag and label of the current keyboard layout in the applet display. Click on the flag
		  to display a flag selector dialog. </para></entry>  
		 </row>

	 	</tbody> 
		</tgroup> 
		</table>  
		</sect3>
		
	 </sect2>
	 
	 <sect2 id="gkb-options">
	 
	 	<title>Options</title>
	 	<variablelist> 
		  <varlistentry> 
			 <term><guilabel>Appearance</guilabel></term> 
			 <listitem> 
			 <para>Select one of the following options from the drop-down list to
			 specify what the applet displays in the panel:</para> 
			 <itemizedlist>
			 	<listitem><para><guilabel>Flag</guilabel></para>
			 	<para>Display a flag only.</para></listitem>
			 	<listitem><para><guilabel>Label</guilabel></para>
			 	<para>Display a label only.</para></listitem>
			 	<listitem><para><guilabel>Flag and Label</guilabel></para>
			 	<para>Display a flag and label.</para></listitem>
			 </itemizedlist>
			 <para>You must reboot your machine to effect a change to this setting.</para>
			 </listitem> 
		  </varlistentry> 
		  <varlistentry> 
			 <term><guilabel>Switch layout</guilabel></term> 
			 <listitem> 
			 <para>You can use a shortcut key to switch between keyboard layouts. To customize the
			 shortcut key, click <guibutton>Grab keys</guibutton>, then press the keys that you
			 want to use. The applet displays the shortcut key in the text box. </para> 
			 </listitem> 
		  </varlistentry> 
		</variablelist> 
	 
	 </sect2>

  </sect1>

</article> 
