<?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_GB">
<!-- please do not change the id; for translations, change lang to -->
<!-- appropriate code -->
<articleinfo> 
  <title>Keyboard Indicator Manual</title>       
  <abstract role="description">
    <para>The Keyboard Indicator 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>

     <legalnotice id="legalnotice">
         <para>Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation Licence (GFDL), Version 1.1 or any later version published by the Free Software Foundation with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. You can find a copy of the GFDL at this <ulink type="help" url="ghelp:fdl">link</ulink> or in the file COPYING-DOCS distributed with this manual.</para>
          <para>This manual is part of a collection of GNOME manuals distributed under the GFDL. If you want to distribute this manual separately from the collection, you can do so by adding a copy of the licence to the manual, as described in section 6 of the licence.</para>
 
         <para>Many of the names used by companies to distinguish their products and services are claimed as trademarks. Where those names appear in any GNOME documentation, and the members of the GNOME Documentation Project are made aware of those trademarks, then the names are in capital letters or initial capital letters.</para>
 
         <para>DOCUMENT AND MODIFIED VERSIONS OF THE DOCUMENT ARE PROVIDED UNDER THE TERMS OF THE GNU FREE DOCUMENTATION LICENCE WITH THE FURTHER UNDERSTANDING THAT: <orderedlist>
                 <listitem>
                   <para>DOCUMENT IS PROVIDED ON AN "AS IS" BASIS, WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, WITHOUT LIMITATION, WARRANTIES THAT THE DOCUMENT OR MODIFIED VERSION OF THE DOCUMENT IS FREE OF DEFECTS MERCHANTABLE, FIT FOR A PARTICULAR PURPOSE OR NON-INFRINGING. THE ENTIRE RISK AS TO THE QUALITY, ACCURACY AND PERFORMANCE OF THE DOCUMENT OR MODIFIED VERSION OF THE DOCUMENT IS WITH YOU. SHOULD ANY DOCUMENT OR MODIFIED VERSION PROVE DEFECTIVE IN ANY RESPECT, YOU (NOT THE INITIAL WRITER, AUTHOR OR ANY CONTRIBUTOR) ASSUME THE COST OF ANY NECESSARY SERVICING, REPAIR OR CORRECTION. THIS DISCLAIMER OF WARRANTY CONSTITUTES AN ESSENTIAL PART OF THIS LICENCE. NO USE OF ANY DOCUMENT OR MODIFIED VERSION OF THE DOCUMENT IS AUTHORISED HEREUNDER EXCEPT UNDER THIS DISCLAIMER; AND</para>
                 </listitem>
                 <listitem>
                   <para>UNDER NO CIRCUMSTANCES AND UNDER NO LEGAL THEORY, WHETHER IN TORT (INCLUDING NEGLIGENCE), CONTRACT OR OTHERWISE, SHALL THE AUTHOR, INITIAL WRITER, ANY CONTRIBUTOR OR ANY DISTRIBUTOR OF THE DOCUMENT OR MODIFIED VERSION OF THE DOCUMENT OR ANY SUPPLIER OF ANY OF SUCH PARTIES, BE LIABLE TO ANY PERSON FOR ANY DIRECT, INDIRECT, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES OF ANY CHARACTER INCLUDING, WITHOUT LIMITATION, DAMAGES FOR LOSS OF GOODWILL, WORK STOPPAGE, COMPUTER FAILURE OR MALFUNCTION, OR ANY AND ALL OTHER DAMAGES OR LOSSES ARISING OUT OF OR RELATING TO USE OF THE DOCUMENT AND MODIFIED VERSIONS OF THE DOCUMENT, EVEN IF SUCH PARTY SHALL HAVE BEEN INFORMED OF THE POSSIBILITY OF SUCH DAMAGES.</para>
                 </listitem>
           </orderedlist></para>
   </legalnotice>
 
  <!-- 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 2.8 of the Keyboard Indicator applet.</releaseinfo> 

  <legalnotice> 
    <title>Feedback</title> 
    <para>To report a bug or make a suggestion regarding the Keyboard Indicator 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>Keyboard Indicator</application> indicates the active keyboard group. The applet shows you which group you are currently using. Aside from the standard applet pop-up menu functions, the <application>Keyboard Indicator</application> applet pop-up menu allows you to launch the applet Preferences tool and to switch between language groups.</para>

  <para>To add <application>Keyboard Indicator</application> to a panel, right-click on the panel, then choose <guimenuitem>Add to Panel</guimenuitem>. Select <application>Keyboard Indicator</application> in the <application>Add to the panel</application> dialogue, 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 pop-up menu. You may need to go to this dialogue 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 pop-up 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 pop-up 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 pop-up 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>Plug-ins</title>        
  <para>To open the <guilabel>Keyboard Indicator Plug-ins</guilabel> dialogue, select <guimenuitem>Plug-ins</guimenuitem> from the pop-up menu. Your current plug-ins are shown in the <guilabel>Active plug-ins</guilabel> area.</para> 
  <variablelist>
    <varlistentry>
      <term>Adding a New Plugin</term>
      <listitem><para>Click <guibutton>Add</guibutton>. In the <guilabel>Add Plug-in</guilabel> window, select one of the plug-ins in the <guilabel>Available plug-ins</guilabel> area and click the <guibutton>OK</guibutton> button.</para></listitem>
    </varlistentry>
    <varlistentry>
      <term>Removing a Plug-in</term>
      <listitem><para>Select the plug-in in the <guilabel>Active plug-ins</guilabel> area that you do not want anymore and click <guibutton>Remove</guibutton>.</para></listitem>
    </varlistentry>
    <varlistentry>
      <term>Moving Items in the Plug-in List</term>
      <listitem><para>To move items up and down the plug-in list in the <guilabel>Active plug-ins</guilabel> area, select the plug-in 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 Plug-in</term>
      <listitem><para>To change the properties of the plug-ins, select the plug-in you want and click <guibutton>Properties</guibutton>. The properties vary for each plug-in.</para></listitem>
    </varlistentry>
  </variablelist>
</sect1>
</article>
