<?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="sl">
<!-- 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
           License (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 license to the manual, as described in
           section 6 of the license.
         </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 LICENSE
           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
                     LICENSE. NO USE OF ANY DOCUMENT OR MODIFIED
                     VERSION OF THE DOCUMENT IS AUTHORIZED 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 revision="2.26" role="review"/>

  <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 popup menu functions, the <application>Keyboard Indicator</application>
  applet popup 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> 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>
