<HTML
><HEAD
><TITLE
>GNOME KeyBoard Applet</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.54"></HEAD
><BODY
CLASS="ARTICLE"
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#840084"
ALINK="#0000FF"
><DIV
CLASS="ARTICLE"
><DIV
CLASS="TITLEPAGE"
><H1
CLASS="TITLE"
><A
NAME="AEN2"
>GNOME KeyBoard Applet</A
></H1
><P
CLASS="COPYRIGHT"
><A
HREF="ln7.html"
>Copyright</A
> &copy; 2000 by <SPAN
CLASS="HOLDER"
>Szabolcs (Shooby) BAN and Dan Mueth</SPAN
></P
><HR
WIDTH="75%"
ALIGN="CENTER"
COLOR="#000000"
SIZE="1"></DIV
><DIV
CLASS="TOC"
><DL
><DT
><B
>Table of Contents</B
></DT
><DT
><A
HREF="index.html#GKBAPPLET"
>GNOME KeyBoard Applet</A
></DT
></DL
></DIV
><DIV
CLASS="SECT1"
><H1
CLASS="SECT1"
><A
NAME="GKBAPPLET"
>GNOME KeyBoard Applet</A
></H1
><P
>   <TT
CLASS="APPLICATION"
>GNOME KeyBoard Applet</TT
>, shown with its
   default configuration in <A
HREF="index.html#GKBAPPLET-FIG"
>Figure 1</A
>, allows you to easily and quickly change
   the keyboard map to those used in various different countries. To
   add this applet to a
   <SPAN
CLASS="INTERFACE"
>Panel</SPAN
>,
   right-click on the <SPAN
CLASS="INTERFACE"
>Panel</SPAN
> and choose
   <B
CLASS="GUIMENU"
>Panel</B
>-&gt;<B
CLASS="GUISUBMENU"
>Add to panel</B
>-&gt;<B
CLASS="GUISUBMENU"
>Applet</B
>-&gt;<B
CLASS="GUISUBMENU"
>Utility</B
>-&gt;<B
CLASS="GUIMENUITEM"
>GKB International KeyBoard</B
>.
  </P
><DIV
CLASS="FIGURE"
><A
NAME="GKBAPPLET-FIG"
></A
><P
><IMG
SRC="gkb_applet.png"></P
><P
><B
>Figure 1. GNOME KeyBoard Applet</B
></P
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="GKB-USAGE"
>Usage</A
></H2
><P
>    Once configured, the <TT
CLASS="APPLICATION"
>GNOME Keyboard</TT
>
    applet allows you to switch the keyboard mapping between any two
    countries. Just left-click on the applet to switch the keyboard
    mapping.
   </P
><P
>    Right-clicking on the applet brings up a menu containing the
    following items:
    <P
></P
><UL
><LI
><P
>       <B
CLASS="GUIMENUITEM"
>Properties&#8230;</B
> &#8212;
       opens the <A
HREF="index.html#GKBAPPLET-PREFS"
>       <TT
CLASS="GUILABEL"
><B
>Properties</B
></TT
></A
> dialog.
      </P
></LI
><LI
><P
>       <B
CLASS="GUIMENUITEM"
>Help</B
> &#8212;
       displays this document.
      </P
></LI
><LI
><P
>       <B
CLASS="GUIMENUITEM"
>About&#8230;</B
> &#8212;
       shows basic information about <TT
CLASS="APPLICATION"
>GNOME KeyBoard
       Applet</TT
>, inluding the applet's version and the
       author's name.
      </P
></LI
></UL
>
   </P
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="GKBAPPLET-PREFS"
>Customization</A
></H2
><P
>      You can customize <TT
CLASS="APPLICATION"
>GNOME KeyBoard</TT
>
      applet by right-clicking on it and choosing
      <B
CLASS="GUIMENUITEM"
>Properties&#8230;</B
>. This will open the
      <SPAN
CLASS="INTERFACE"
>Properties</SPAN
> dialog(shown in <A
HREF="index.html#GKBAPPLET-SETTINGS-FIG"
>Figure 2</A
>), which allows you to
      add, configure, and remove keymaps.
    </P
><DIV
CLASS="FIGURE"
><A
NAME="GKBAPPLET-SETTINGS-FIG"
></A
><P
><IMG
SRC="gkb_applet_settings.png"></P
><P
><B
>Figure 2. Properties dialog</B
></P
></DIV
><P
>      <TT
CLASS="APPLICATION"
>GNOME KeyBoard</TT
> typically comes up
      with two keyboard maps.  Each keyboard map has its own tab, with
      a label indicating the language or country the map is for. In
      <A
HREF="index.html#GKBAPPLET-SETTINGS-FIG"
>Figure 2</A
>, these are
      <TT
CLASS="GUILABEL"
><B
>US</B
></TT
> (for a US
      keyboard) and <TT
CLASS="GUILABEL"
><B
>HU</B
></TT
> (for Hungarian). You
      can delete any keyboard map by selecting the tab and pressing
      the <B
CLASS="GUIBUTTON"
>Delete this keymap</B
> button.  To add
      another keyboard map, press the <B
CLASS="GUIBUTTON"
>New
      keymap</B
> button and a new tab will appear for you to
      customize.
    </P
><P
>     Each keymap tab has the following properties:
     <P
></P
><UL
><LI
><P
>        Keymap name &#8212; This is the name of the keymap, which will
        be displayed in the tab at the top. 
       </P
></LI
><LI
><P
>        Icon path &#8212; This is the path to the icon which will be
        displayed for the keyboard map.  For most countries, just
        click on the image of a flag to the right to bring up a set of
        images you can use.  If you select one of these standard map
        images, you will not need to type the path by hand.
       </P
></LI
><LI
><P
>        Full command &#8212; This is the command which
        <TT
CLASS="APPLICATION"
>GNOME KeyBoard</TT
> will use to change
        the keymap.  The default is to use the
        <B
CLASS="COMMAND"
>setxkbmap</B
> command. To set the keymap to a
        US keyboard, for example, you would use <B
CLASS="COMMAND"
>setxkbmap
        us</B
>. You may also use the
        <B
CLASS="COMMAND"
>gkb_xmmap</B
> command, such as
        <B
CLASS="COMMAND"
>gkb_xmmap fr</B
> (to use a French keyboard), or
        the <B
CLASS="COMMAND"
>Xmodmap</B
> command, such as
        <B
CLASS="COMMAND"
>/usr/local/bin/Xmodmap ru</B
> (to use a Russian
        keyboard). 
       </P
></LI
></UL
>
    </P
><P
> 
      After you have made all the changes you want, click on
      <B
CLASS="GUIBUTTON"
>OK</B
> to apply the changes and close the
      <SPAN
CLASS="INTERFACE"
>Properties</SPAN
> dialog. To cancel the changes
      and return to previous values, click the
      <B
CLASS="GUIBUTTON"
>Close</B
> button.
    </P
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="BUGS"
>Known Bugs and Limitations</A
></H2
><P
>    The sequence that the keymap tabs appear is not preserved after
    you close the <SPAN
CLASS="INTERFACE"
>Preferences Dialog</SPAN
>.
   </P
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="AUTHORS"
>Authors</A
></H2
><P
>    <TT
CLASS="APPLICATION"
>GNOME KeyBoard</TT
> was written by Szabolcs Ban
    (<TT
CLASS="EMAIL"
>&#60;<A
HREF="mailto:shooby@gnome.hu"
>shooby@gnome.hu</A
>&#62;</TT
>).  Please send all comments,
    suggestions, and bug 
    reports to the <A
HREF="http://bugs.gnome.org"
TARGET="_top"
>GNOME
    bug tracking database</A
>. (Instructions for submitting bug
    reports can be found <A
HREF="http://bugs.gnome.org/Reporting.html"
TARGET="_top"
>    on-line</A
>). If you are using
    GNOME 1.1 or later, you can also use <TT
CLASS="APPLICATION"
>Bug Report
    Tool</TT
> (<B
CLASS="COMMAND"
>bug-buddy</B
>), available in the
    <B
CLASS="GUISUBMENU"
>Utilities</B
> submenu of <B
CLASS="GUIMENU"
>Main
    Menu</B
>, for submitting bug reports.
   </P
><P
>    This manual was written by Szabolcs (Shooby) Ban
    (<TT
CLASS="EMAIL"
>&#60;<A
HREF="mailto:shooby@gnome.hu"
>shooby@gnome.hu</A
>&#62;</TT
>) and Dan Mueth
    (<TT
CLASS="EMAIL"
>&#60;<A
HREF="mailto:d-mueth@uchicago.edu"
>d-mueth@uchicago.edu</A
>&#62;</TT
>). Please send all comments and
    suggestions regarding this manual to the <A
HREF="http://www.gnome.org/gdp"
TARGET="_top"
>GNOME Documentation Project</A
> 
    by sending an email to <TT
CLASS="EMAIL"
>&#60;<A
HREF="mailto:docs@gnome.org"
>docs@gnome.org</A
>&#62;</TT
>. You can also
    submit comments online by using the <A
HREF="http://www.gnome.org/gdp/doctable/"
TARGET="_top"
>GNOME Documentation Status
    Table</A
>.
   </P
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="LICENSE"
>License</A
></H2
><P
>    This program is free software; you can redistribute it and/or
    modify it under the terms of the <I
CLASS="CITETITLE"
>GNU General Public
    License</I
> as published by the Free Software Foundation;
    either version 2 of the License, or (at your option) any later
    version.
   </P
><P
>    This program is distributed in the hope that it will be useful, but
    WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    <I
CLASS="CITETITLE"
>GNU General Public License</I
> for more details.
   </P
><P
>    A copy of the <I
CLASS="CITETITLE"
>GNU General Public License</I
> is
    included as an appendix to the <I
CLASS="CITETITLE"
>GNOME Users
    Guide</I
>.  You may also obtain a copy of the
    <I
CLASS="CITETITLE"
>GNU General Public License</I
> from the Free
    Software Foundation by visiting <A
HREF="http://www.fsf.org"
TARGET="_top"
>their Web site</A
> or by writing to
    <P
CLASS="ADDRESS"
>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Free&nbsp;Software&nbsp;Foundation,&nbsp;Inc.<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<SPAN
CLASS="STREET"
>59 Temple Place</SPAN
>&nbsp;-&nbsp;Suite&nbsp;330<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<SPAN
CLASS="CITY"
>Boston</SPAN
>,&nbsp;<SPAN
CLASS="STATE"
>MA</SPAN
>&nbsp;<SPAN
CLASS="POSTCODE"
>02111-1307</SPAN
><br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<SPAN
CLASS="COUNTRY"
>USA</SPAN
><br>
&nbsp;&nbsp;&nbsp;&nbsp;</P
>
   </P
></DIV
></DIV
></DIV
></BODY
></HTML
>