summaryrefslogtreecommitdiff
path: root/gswitchit/help/C
diff options
context:
space:
mode:
Diffstat (limited to 'gswitchit/help/C')
-rw-r--r--gswitchit/help/C/gswitchit.xml217
-rw-r--r--gswitchit/help/C/legal.xml76
2 files changed, 293 insertions, 0 deletions
diff --git a/gswitchit/help/C/gswitchit.xml b/gswitchit/help/C/gswitchit.xml
new file mode 100644
index 00000000..17c2edab
--- /dev/null
+++ b/gswitchit/help/C/gswitchit.xml
@@ -0,0 +1,217 @@
+<?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 "MATE Desktop User Guide">
+]>
+<!--
+(Do not remove this comment block.)
+Maintained by the MATE Documentation Project
+http://developer.mate.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>MATE 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>[email protected]</email></address>
+ </affiliation>
+ </author>
+ <author>
+ <firstname>Sergey</firstname>
+ <surname>Udaltsov</surname>
+ <affiliation>
+ <address><email>[email protected]</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>[email protected]</email> </address>
+ </affiliation>
+ <contrib>Latin translation</contrib>
+ </othercredit>
+ -->
+ </authorgroup>
+
+ <releaseinfo revision="2.26" role="review"/>
+
+ <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:mate-feedback" type="help">MATE 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>
diff --git a/gswitchit/help/C/legal.xml b/gswitchit/help/C/legal.xml
new file mode 100644
index 00000000..29f07269
--- /dev/null
+++ b/gswitchit/help/C/legal.xml
@@ -0,0 +1,76 @@
+ <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 MATE 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 MATE documentation, and the members of
+ the MATE 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>
+ \ No newline at end of file