<?xml version="1.0" encoding="UTF-8"?><!-- -*- indent-tabs-mode: nil -*- -->
<!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.8">
  <!ENTITY manrevision "2.8">
  <!ENTITY date "August 2004">
  <!ENTITY applet "Keyboard Indicator">
  <!ENTITY ug "GNOME Desktop User Guide">
]>
<!-- 
(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 Feb 12, 2002
-->

<article id="index" lang="en">
<!-- please do not change the id; for translations, change lang to -->
<!-- appropriate code -->
<articleinfo> 
  <title>&applet; Manual</title>       
  <abstract role="description">
    <para>The &applet; shows the active keyboard group and 
      enables switching between different groups.</para>
  </abstract>

  <copyright> 
    <year>2004</year>
    <holder>Angela Boyle</holder> 
  </copyright>
  <copyright>
    <year>2004</year>
    <holder>Sergey Udaltsov</holder>
  </copyright>
  <!-- translators: uncomment this:
       <copyright>
       <year>2003</year>
       <holder>ME-THE-TRANSLATOR (Latin translation)</holder>
       </copyright>
  -->

  <publisher role="maintainer"> 
    <publishername>GNOME Documentation Project</publishername> 
  </publisher> 

  <revhistory>
    <revision> 
      <revnumber>2.8</revnumber> 
      <date>2004-08</date> 
    </revision> 
  </revhistory>

  &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>Angela</firstname>
      <surname>Boyle</surname> 
      <affiliation>
       <address><email>aboyle@aboyle.com</email></address>
      </affiliation>
    </author>
    <author>
      <firstname>Sergey</firstname>
      <surname>Udaltsov</surname>
      <affiliation>
       <address><email>svu@gnome.org</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>

  <releaseinfo>This manual describes version &appletversion; of the
  &applet; 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>
    <!-- Translators may also add here feedback address for translations -->
  </legalnotice> 
</articleinfo> 

<indexterm> 
  <primary>Keyboard Indicator</primary> 
</indexterm>

<sect1 id="gswitchit-applet-intro">
  <title>Introduction</title>

  <para><application>&applet;</application> indicates the active keyboard group.
  The applet shows you which group you are currently using.  Aside from the
  standard applet popup menu functions, the <application>&applet;</application>
  applet popup menu allows you to launch the applet Preferences tool and to
  switch between language groups.</para>

  <para>To add <application>&applet;</application> to a panel,
  right-click on the panel, then choose <guimenuitem>Add to
  Panel</guimenuitem>.  Select <application>&applet;</application>
  in the <application>Add to the panel</application> dialog, then
  click <guibutton>OK</guibutton>. For more on this, see <ulink type="help" url="ghelp:user-guide?panels-addobject">Adding an Object to a Panel</ulink>.</para>

  <para>To open the <application>Keyboard</application> preference tool, choose
  <guimenuitem>Open Keyboard Preferences</guimenuitem> in the applet popup
  menu. You may need to go to this dialog to be able to configure the keyboard
  (choose model, layouts, options, etc.). For help with setting
  Keyboard preferences, see
  <ulink url="ghelp:user-guide?prefs-keyboard">Configuring Keyboard
  Preferences</ulink>.</para>
</sect1>

<sect1 id="gswitchit-applet-switching">
  <title>Switching Language</title>

  <para>First, you must know that a group is a set of characters, whether it be
  for a language or non-language-related set of characters, like a dvorak. Each
  language may have more than one subset, and each subset is called a group.
  There are many ways you can switch the group that you are using on your
  keyboard.</para>

  <variablelist>
    <varlistentry>
      <term>Mouse Click</term>
      <listitem><para>You can switch between groups with a single click on the
      applet's panel icon.  The groups switch in a cycle determined by the
      current configuration.</para></listitem>
    </varlistentry>
    <varlistentry>
      <term>Popup Menu</term>
      <listitem><para>To pick a specific group, select
      <guisubmenu>Groups</guisubmenu> from the popup menu. From there,
      choose the group you want to switch to.</para></listitem>
    </varlistentry>
    <varlistentry>
      <term>Keyboard</term>
      <listitem><para>In the <application>Keyboard</application> 
      preference tool, you can set
      which key that you would like to use to switch groups on your keyboard. Choose
      <guimenuitem>Open Keyboard Preferences</guimenuitem> in the applet popup
      menu, and choose the key you want to use in the <ulink url="ghelp:user-guide#prefs-keyboard-layoutoptions"><guilabel>Layout Options</guilabel></ulink> tab, under <guilabel>Group Shift/Lock behavior</guilabel>.</para></listitem>
    </varlistentry>
  </variablelist>
  <para>To add other layouts to the list, open the <application>Keyboard</application> preference tool. Choose other layouts in the <ulink url="ghelp:user-guide#prefs-keyboard-layouts"><guilabel>Layouts</guilabel> tab</ulink>.</para>
</sect1>

<sect1 id="layout-view">
  <title>Layout View</title>
  <para>Choose <guimenuitem>Layout View</guimenuitem> from the applet popup menu to see a diagram of your current keyboard layout.</para>
  <para>In the <guilabel>Layout View</guilabel> window, press a key on your keyboard to highlight its representation in the diagram.</para>
  <para>Each key in the diagram has up to four characters. These can be produced with different keyboard modifiers, as follows:</para>
  <itemizedlist>
	  <listitem><para>For the character shown in the bottom left, press the key alone.</para></listitem>
	  <listitem><para>For the character shown in the top left, press the key with <keycap>Shift</keycap>.</para></listitem>		  
	  <listitem><para>For the character shown in the bottom right, press the key with the third level modifier.</para></listitem>
	  <listitem><para>For the character shown in the top right, press the key with <keycap>Shift</keycap> and the third level modifier.</para></listitem>	  	  	  
  </itemizedlist>
  <note><para>By default, no key is assigned to act as a third-level modifier. You can assign a key to act as a third level modifier in the <ulink type="help" url="ghelp:user-guide?prefs-keyboard-layoutoptions">Keyboard Layout Options Preferences</ulink>.</para></note>
  

</sect1>

<sect1 id="gswitchit-applet-plugins">
  <title>Plugins</title>        
  <para>To open the <guilabel>Keyboard Indicator Plugins</guilabel> dialog,
  select <guimenuitem>Plugins</guimenuitem> from the popup menu. Your current
  plugins are shown in the <guilabel>Active plugins</guilabel> area.</para> 
  <variablelist>
    <varlistentry>
      <term>Adding a New Plugin</term>
      <listitem><para>Click <guibutton>Add</guibutton>. In the <guilabel>Add
      Plugin</guilabel> window, select one of the plugins in the
      <guilabel>Available plugins</guilabel> area and click the
      <guibutton>OK</guibutton> button.</para></listitem>
    </varlistentry>
    <varlistentry>
      <term>Removing a Plugin</term>
      <listitem><para>Select the plugin in the <guilabel>Active
      plugins</guilabel> area that you do not want anymore and
      click <guibutton>Remove</guibutton>.</para></listitem>
    </varlistentry>
    <varlistentry>
      <term>Moving Items in the Plugin List</term>
      <listitem><para>To move items up and down the plugin list in the
      <guilabel>Active plugins</guilabel> area, select the plugin you
      want to move, and click <guibutton>Up</guibutton> or
      <guibutton>Down</guibutton>.  You can use the arrows on the keyboard
      to move the selection point up and down.</para></listitem>
    </varlistentry>
    <varlistentry>
      <term>Changing the Properties of a Plugin</term>
      <listitem><para>To change the properties of the plugins,  select
      the plugin you want and click <guibutton>Properties</guibutton>.
      The properties vary for each plugin.</para></listitem>
    </varlistentry>
  </variablelist>
</sect1>
</article>
