initial

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