<HTML
><HEAD
><TITLE
>Utility Applets</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.54"><LINK
REL="HOME"
TITLE="GNOME User's Guide"
HREF="index.html"><LINK
REL="UP"
TITLE="GNOME Applets"
HREF="gnome-applets.html"><LINK
REL="PREVIOUS"
TITLE="Network Applets"
HREF="network-applets.html"><LINK
REL="NEXT"
TITLE="Clock Applets"
HREF="clock-applets.html"></HEAD
><BODY
CLASS="SECT1"
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#840084"
ALINK="#0000FF"
><DIV
CLASS="NAVHEADER"
><TABLE
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TH
COLSPAN="3"
ALIGN="center"
>GNOME User's Guide</TH
></TR
><TR
><TD
WIDTH="10%"
ALIGN="left"
VALIGN="bottom"
><A
HREF="network-applets.html"
>&#60;&#60;&#60; Previous</A
></TD
><TD
WIDTH="80%"
ALIGN="center"
VALIGN="bottom"
>GNOME Applets</TD
><TD
WIDTH="10%"
ALIGN="right"
VALIGN="bottom"
><A
HREF="clock-applets.html"
>Next &#62;&#62;&#62;</A
></TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><DIV
CLASS="SECT1"
><H1
CLASS="SECT1"
><A
NAME="UTILITY-APPLETS"
>Utility Applets</A
></H1
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="PRINTER"
>Printer Applet</A
></H2
><P
> 

      <TT
CLASS="APPLICATION"
>Printer</TT
> applet, shown in <A
HREF="utility-applets.html#PRINTER-FIG"
>Figure 56</A
>, 
      allows you to print files by dragging them onto the
      applet from the <SPAN
CLASS="INTERFACE"
> desktop</SPAN
> or <SPAN
CLASS="INTERFACE"
>file
      manager</SPAN
>.  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"
>Printer Applet</B
>.
      
  </P
><DIV
CLASS="FIGURE"
><A
NAME="PRINTER-FIG"
></A
><P
><IMG
SRC="./figs/printer-fig.png"></P
><P
><B
>Figure 56. Printer Applet</B
></P
></DIV
><DIV
CLASS="SECT3"
><H3
CLASS="SECT3"
><A
NAME="PRINTER-USAGE"
>Usage</A
></H3
><P
>    To print a file from your <SPAN
CLASS="INTERFACE"
>desktop</SPAN
> or <SPAN
CLASS="INTERFACE"
>file
    manager</SPAN
>, drag the file onto the <TT
CLASS="APPLICATION"
>printer</TT
> applet.
    
    </P
></DIV
><DIV
CLASS="SECT3"
><H3
CLASS="SECT3"
><A
NAME="PRINTER-RIGHT-CLICK"
>Right-Click Pop-Up Menu Items</A
></H3
><P
>      Right-clicking on the applet brings up a menu containing the
      following items:
      <P
></P
><UL
><LI
><P
>	    <B
CLASS="GUIMENUITEM"
>Properties...</B
> &#8212; This menu
	    item opens the <SPAN
CLASS="INTERFACE"
>Properties</SPAN
> dialog (see
	    <A
HREF="utility-applets.html#PRINTER-PROPERTIES"
>the section called <I
>Properties</I
></A
>) which allows you to
	    customize the appearance and behavior of this applet.
	  </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 the <TT
CLASS="APPLICATION"
>Printer
	    Applet</TT
>, including the applet's version and the
	    author's name.
	  </P
></LI
></UL
>	
    </P
></DIV
><DIV
CLASS="SECT3"
><H3
CLASS="SECT3"
><A
NAME="PRINTER-PROPERTIES"
>Properties</A
></H3
><P
>     You can configure <TT
CLASS="APPLICATION"
>printer</TT
> applet by
     right-clicking on the applet and choosing the
     <B
CLASS="GUIMENUITEM"
>Properties...</B
> menu item. This will open the
     <SPAN
CLASS="INTERFACE"
>Properties</SPAN
> dialog, shown in <A
HREF="utility-applets.html#PRINTER-PROPERTIES-FIG"
>Figure 57</A
>.
    </P
><DIV
CLASS="FIGURE"
><A
NAME="PRINTER-PROPERTIES-FIG"
></A
><P
><IMG
SRC="./figs/printer-properties.png"></P
><P
><B
>Figure 57. Properties Dialog</B
></P
></DIV
><P
> 

    To change the label displayed at the bottom of the
    <TT
CLASS="APPLICATION"
>printer</TT
> applet, ("Print" in <A
HREF="utility-applets.html#PRINTER-FIG"
>Figure 56 in the section called <I
>Printer Applet</I
></A
>) type a new name in the <TT
CLASS="GUILABEL"
><B
>Printer
    name</B
></TT
> field.  This setting is useful if you have more than one
    printer available for use and wish to add a
    <TT
CLASS="APPLICATION"
>printer</TT
> applet to the
    <SPAN
CLASS="INTERFACE"
>Panel</SPAN
> for each printer. The <TT
CLASS="GUILABEL"
><B
>Printer
    name</B
></TT
> does not determine which printer your file will be printed
    to, it exists as an easy means to to distinguish between printers should you
    have more than one <TT
CLASS="APPLICATION"
>printer</TT
> applet installed on
    your <SPAN
CLASS="INTERFACE"
>Panel</SPAN
>.


    </P
><P
>    
     To change the command the <TT
CLASS="APPLICATION"
>printer</TT
> applet uses to
     print your files, you may enter a new command in the <TT
CLASS="GUILABEL"
><B
>Print
     command</B
></TT
> field.  By default, the <TT
CLASS="APPLICATION"
>printer
     </TT
> applet uses the command <B
CLASS="COMMAND"
>lpr</B
>, which is
     common to many systems.  Your system may use a different command.  If you're
     unsure, check your system's documentation.
    </P
><DIV
CLASS="NOTE"
><P
></P
><TABLE
CLASS="NOTE"
WIDTH="100%"
BORDER="0"
><TR
><TD
WIDTH="25"
ALIGN="CENTER"
VALIGN="TOP"
><IMG
SRC="./stylesheet-images/note.gif"
HSPACE="5"
ALT="Note"></TD
><TH
ALIGN="LEFT"
VALIGN="CENTER"
><B
>NOTE</B
></TH
></TR
><TR
><TD
>&nbsp;</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
><P
> 
	  If you have more than one printer, you may designate which printer to send
	  files to by changing the <TT
CLASS="GUILABEL"
><B
>Print command</B
></TT
> setting.  For
	  instance, if your system uses the command <B
CLASS="COMMAND"
>lpr</B
> to print
	  files and you need to print your file on the printer named "ljet5", you
	  would change the <TT
CLASS="GUILABEL"
><B
>Print command</B
></TT
> setting to <B
CLASS="COMMAND"
>lpr
	  -Pljet5</B
>.  
	</P
></TD
></TR
></TABLE
></DIV
><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="SECT3"
><H3
CLASS="SECT3"
><A
NAME="PRINTER-BUGS"
>Known Bugs and Limitations</A
></H3
><P
>     There are no known bugs in the
     <TT
CLASS="APPLICATION"
>printer</TT
> applet. 
    </P
></DIV
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="CHARPICKAPPLET"
>Character Picker Applet</A
></H2
><P
>   <TT
CLASS="APPLICATION"
>Character Picker</TT
> applet, shown in <A
HREF="utility-applets.html#CHARPICKAPPLET-FIG"
>Figure 58</A
>, allows you to easily write many
   characters which are not available on standard keyboards, such as
   accented characters, certain mathemathical symbols and punctuation,
   and some other special symbols.  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"
>Character Picker</B
>.
  </P
><DIV
CLASS="FIGURE"
><A
NAME="CHARPICKAPPLET-FIG"
></A
><P
><IMG
SRC="./figs/charpick_applet.png"></P
><P
><B
>Figure 58. Character Picker Applet</B
></P
></DIV
><DIV
CLASS="SECT3"
><H3
CLASS="SECT3"
><A
NAME="CHARPICKAPPLET-USAGE"
>Usage</A
></H3
><P
>    First, bring the cursor focus to the <TT
CLASS="APPLICATION"
>Character
    Picker</TT
> applet by left-clicking on one of the
    characters displayed in the applet.  Specify the character group
    by pressing the corresponding key on your keyboard. (For a
    complete list of the character groups and corresponding keys, see
    <A
HREF="utility-applets.html#CHARPICKAPPLET-CHARACTERS"
>the section called <I
>Characters</I
></A
>.) For example,
    to see the  various accented versions of the "a" letter, press
    "a".  After you have found the correct letter or symbol,
    left-click on it to copy the symbol into the buffer.  The
    character should appear as a depressed button.  This is similar to
    the common Copy command available in many programs.  To paste the
    symbol in any window, just click in the window with the center
    mouse button.  Most applications which have Copy and Paste
    features will also allow you to paste the symbol using its Paste
    command.
   </P
><DIV
CLASS="NOTE"
><P
></P
><TABLE
CLASS="NOTE"
WIDTH="100%"
BORDER="0"
><TR
><TD
WIDTH="25"
ALIGN="CENTER"
VALIGN="TOP"
><IMG
SRC="./stylesheet-images/note.gif"
HSPACE="5"
ALT="Note"></TD
><TH
ALIGN="LEFT"
VALIGN="CENTER"
><B
>NOTE</B
></TH
></TR
><TR
><TD
>&nbsp;</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
><P
>     Note that some applications do not support ISO-8859-1
     characters.  These applications will not display some characters
     in the <TT
CLASS="APPLICATION"
>Character Picker</TT
> applet.
    </P
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="NOTE"
><P
></P
><TABLE
CLASS="NOTE"
WIDTH="100%"
BORDER="0"
><TR
><TD
WIDTH="25"
ALIGN="CENTER"
VALIGN="TOP"
><IMG
SRC="./stylesheet-images/note.gif"
HSPACE="5"
ALT="Note"></TD
><TH
ALIGN="LEFT"
VALIGN="CENTER"
><B
>NOTE</B
></TH
></TR
><TR
><TD
>&nbsp;</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
><P
>     The X Windows system allows you to copy and paste text by 
     highlighting it with the first mouse button to copy the text and
     then pasting the text by pressing the middle mouse button.  
     Note that <TT
CLASS="APPLICATION"
>Character Picker</TT
> uses the
     same buffer for storing its character that X uses. Thus, when you
     select a character in the <TT
CLASS="APPLICATION"
>Character
     Picker</TT
> it replaces any previous text in the buffer
     from highlighting text.  Similarly, if you have selected a
     character in <TT
CLASS="APPLICATION"
>Character Picker</TT
> and then
     highlight text, the highlighted text will replace the character
     in the buffer and the character's button will no longer appear
     depressed.  
    </P
></TD
></TR
></TABLE
></DIV
><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="utility-applets.html#CHARPICKAPPLET-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"
>Character Picker
       Applet</TT
>, inluding the applet's version and the
       author's name.
      </P
></LI
></UL
>
   </P
></DIV
><DIV
CLASS="SECT3"
><H3
CLASS="SECT3"
><A
NAME="CHARPICKAPPLET-PREFS"
>Customization</A
></H3
><P
>      You can customize <TT
CLASS="APPLICATION"
>Character Picker</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="utility-applets.html#CHARPICKAPPLET-SETTINGS-FIG"
>Figure 59</A
>), which allows you to
      change various settings.
    </P
><DIV
CLASS="FIGURE"
><A
NAME="CHARPICKAPPLET-SETTINGS-FIG"
></A
><P
><IMG
SRC="./figs/charpick_applet_settings.png"></P
><P
><B
>Figure 59. Properties dialog</B
></P
></DIV
><P
>     The properties in the <TT
CLASS="GUILABEL"
><B
>Size</B
></TT
> tab are:
     <P
></P
><UL
><LI
><P
>        Follow panel size &#8212; If this button is checked, the
        <TT
CLASS="APPLICATION"
>Character Picker</TT
> applet will
        automatically set the appropriate number of columns and rows
        of characters to fit in the <SPAN
CLASS="INTERFACE"
>Panel</SPAN
>.
       </P
></LI
><LI
><P
>        Minimum number of cells: (for autosize) &#8212; This sets the
        minimum number of character buttons (or "cells") which will be
        shown. The actual number of character buttons may exceed this
        number, depending upon the <SPAN
CLASS="INTERFACE"
>Panel</SPAN
> size
        and number chosen.  Note that if this number is too small,
        some characters may not be visible. (This variable does not
        influence the cell layout if the <B
CLASS="GUIBUTTON"
>Follow panel
        size</B
> button is not selected.)
       </P
></LI
><LI
><P
>        Number of rows of buttons: &#8212; This determines the number
        of rows of character buttons (or "cells") that appear in the
        applet. (This variable does not influence the cell layout if
        the <B
CLASS="GUIBUTTON"
>Follow panel size</B
> button is selected.)
       </P
></LI
><LI
><P
>        Number of columns of buttons: &#8212; This determines the number
        of columns of character buttons (or "cells") that appear in the
        applet. (This variable does not influence the cell layout if
        the <B
CLASS="GUIBUTTON"
>Follow panel size</B
> button is selected.)
       </P
></LI
><LI
><P
>        Size of button: (pixels) &#8212; This is the size (in pixels)
        of each character button in the applet.
       </P
></LI
></UL
>
    </P
><P
>     The properties in the <TT
CLASS="GUILABEL"
><B
>Default List</B
></TT
> tab are:
     <P
></P
><UL
><LI
><P
>        Default character list &#8212; This is the list of characters
        which will be shown in the applet when you press the space
        bar. This is a convenient way to keep a list of your most
        frequently used characters. Just enter your most frequently
        used characters in this entry.
       </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"
>Cancel</B
> button.
    </P
></DIV
><DIV
CLASS="SECT3"
><H3
CLASS="SECT3"
><A
NAME="CHARPICKAPPLET-CHARACTERS"
>Characters</A
></H3
><P
>    <TT
CLASS="APPLICATION"
>Character Picker</TT
> applet has all
    the characters from the 
    ISO-8859-1(Latin 1) character set which are not on standard US
    keyboards. They are mapped onto the standard characters as shown in
    <A
HREF="utility-applets.html#CHARPICKAPPLET-CHARACTERS-FIG"
>Figure 60</A
>.  The bold
    characters in the first column of each half and to the left of the
    dotted lines are the characters you
    must type in the <TT
CLASS="APPLICATION"
>Character Picker</TT
>
    applet to obtain 
    the corresponding characters shown to the right.
   </P
><DIV
CLASS="FIGURE"
><A
NAME="CHARPICKAPPLET-CHARACTERS-FIG"
></A
><P
><IMG
SRC="./figs/charpick_characters.png"></P
><P
><B
>Figure 60. Character Picker's Character Key</B
></P
></DIV
></DIV
><DIV
CLASS="SECT3"
><H3
CLASS="SECT3"
><A
NAME="CHARPICKAPPLET-BUGS"
>Known Bugs and Limitations</A
></H3
><P
>    This applet has no known bugs.
   </P
></DIV
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="DESKGUIDE-APPLET"
>Desk Guide Applet</A
></H2
><P
> 
    <TT
CLASS="APPLICATION"
>Desk Guide</TT
> applet, shown in <A
HREF="utility-applets.html#DESKGUIDE-APPLET-FIG"
>Figure 61</A
>, is an applet that allows you to
    visually navigate your virtual desktops. To add this applet to a
    <SPAN
CLASS="INTERFACE"
>Panel</SPAN
>, right-click on the panel and choose
         <B
CLASS="GUIMENU"
>Applets</B
>-&gt;<B
CLASS="GUISUBMENU"
>Utility</B
>-&gt;<B
CLASS="GUIMENUITEM"
>Desk Guide</B
>. 
   </P
><DIV
CLASS="FIGURE"
><A
NAME="DESKGUIDE-APPLET-FIG"
></A
><P
><IMG
SRC="./figs/deskguide-fig.png"></P
><P
><B
>Figure 61. Desk Guide</B
></P
></DIV
><DIV
CLASS="SECT3"
><H3
CLASS="SECT3"
><A
NAME="DESKGUIDE-APPLET-USAGE"
>Usage</A
></H3
><P
><TT
CLASS="APPLICATION"
>Desk Guide</TT
> applet helps you
    navigate all of the virtual desktops available on your system. The
    <TT
CLASS="APPLICATION"
>X Window</TT
> system, working in
    hand with a piece of software called a "window manager", allows
    you to create more than one virtual desktop to organize your
    work, with different applications running on each
    desktop. Each desktop can then also be subdivided by the window
    manager into rows and columns of working space, called
    "desk areas". <TT
CLASS="APPLICATION"
>Desk
    Guide</TT
> applet is a navigational tool to get around
    the various desktops and desk areas, providing a miniature road
    map in the GNOME panel showing all your virtual desktops (also
    known as workspaces) and desk areas, and allowing you to switch
    easily between them.</P
><P
><TT
CLASS="APPLICATION"
>Desk Guide</TT
> applet works
    hand-in-hand with the window manager, the piece of software such
    as Sawfish, formerly known as Sawmill, or Enlightenment that
    handles the look and feel of your windows - laying down borders,
    resizing the windows, placing them, moving them and so on. The
    window manager is in charge of the various
    desktops. <TT
CLASS="APPLICATION"
>Desk Guide</TT
> applet handles the
    navigation.</P
><P
><TT
CLASS="APPLICATION"
>Desk Guide</TT
> applet displays
    miniature versions of all your available desktops, including
    outlined boxes representing the applications running in each
    desktop window. The desktop currently in use is
    highlighted. Mouse-click on a representation of a desktop in
    <TT
CLASS="APPLICATION"
>Desk Guide</TT
> applet to switch to display
    a different virtual desktop on your monitor.</P
><P
>Click and hold with your middle mouse button on any window
    image in <TT
CLASS="APPLICATION"
>Desk Guide</TT
> applet to drag the
    window around your virtual desktops.</P
><DIV
CLASS="NOTE"
><P
></P
><TABLE
CLASS="NOTE"
WIDTH="100%"
BORDER="0"
><TR
><TD
WIDTH="25"
ALIGN="CENTER"
VALIGN="TOP"
><IMG
SRC="./stylesheet-images/note.gif"
HSPACE="5"
ALT="Note"></TD
><TH
ALIGN="LEFT"
VALIGN="CENTER"
><B
>NOTE</B
></TH
></TR
><TR
><TD
>&nbsp;</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
><P
>Different window managers use different jargon to describe
      virtual desktops and the subdivided workspaces within
      them. <TT
CLASS="APPLICATION"
>Enlightenment</TT
> divides your
      working area into "desktops," and then subdivides those into
      "screens." <TT
CLASS="APPLICATION"
>Sawfish</TT
>, formerly known as
      <TT
CLASS="APPLICATION"
>Sawmill</TT
> divides your
      working area into "workspaces" and then subdivides those into
      columns and rows. <TT
CLASS="APPLICATION"
>Desk Guide</TT
> applet
      calls the workspaces "desktops" and the areas within them
      "viewports". See your window manager's documentation for more
      informaton on setting up and managing your virtual workspaces.</P
></TD
></TR
></TABLE
></DIV
><P
>Mouse-clicking on the arrow on the left side of
    <TT
CLASS="APPLICATION"
>Desk Guide</TT
> applet brings up the
    <SPAN
CLASS="INTERFACE"
>Task List</SPAN
> window, shown in <A
HREF="utility-applets.html#DESKGUIDE-TASKLIST-APPLET-FIG"
>Figure 62</A
>.</P
><DIV
CLASS="FIGURE"
><A
NAME="DESKGUIDE-TASKLIST-APPLET-FIG"
></A
><P
><IMG
SRC="./figs/deskguide-tasklist-fig.png"></P
><P
><B
>Figure 62. Desk Guide Task List</B
></P
></DIV
><P
>The window lists the various applications running on your
    computer. Left-clicking on any of the applications listed in the
    <SPAN
CLASS="INTERFACE"
>Task List</SPAN
> window shifts focus to that
    application, i.e. this window rises to the foreground and all your
    keyboard input will be sent to the application running in this window.</P
></DIV
><DIV
CLASS="SECT3"
><H3
CLASS="SECT3"
><A
NAME="DESKGUIDE-RIGHT-CLICK"
>Right-Click Pop-Up Menu Items</A
></H3
><P
> 
     In addition to the standard menu items (see <A
HREF="utility-applets.html#DESKGUIDE-STANDARD-RIGHT-CLICK-ITEMS"
>the section called <I
>Standard Pop-Up Items</I
></A
>), the right-click
    pop-up menu has the following item: 
     <P
></P
><UL
><LI
><P
>        <B
CLASS="GUIMENUITEM"
>Properties...</B
> &#8212; This menu
        item opens the <SPAN
CLASS="INTERFACE"
>Properties</SPAN
> dialog (see
        <A
HREF="utility-applets.html#DESKGUIDE-PROPERTIES"
>the section called <I
>Properties</I
></A
>) which allows you to
        customize the appearance and behavior of this applet.
       </P
></LI
></UL
>
    </P
></DIV
><DIV
CLASS="SECT3"
><H3
CLASS="SECT3"
><A
NAME="DESKGUIDE-PROPERTIES"
>Properties</A
></H3
><P
>     You can configure <TT
CLASS="APPLICATION"
>Desk Guide</TT
> applet by
     right-clicking on the applet and choosing the
     <B
CLASS="GUIMENUITEM"
>Properties...</B
> menu item. This will open the
     <SPAN
CLASS="INTERFACE"
>Properties</SPAN
> dialog, with four different
     tabbed pages giving you access to various configuration options -
     <A
HREF="utility-applets.html#DESKGUIDE-PROPERTIES-DISPLAY"
>display</A
>,
     <A
HREF="utility-applets.html#DESKGUIDE-PROPERTIES-TASKS"
>tasks</A
> <A
HREF="utility-applets.html#DESKGUIDE-PROPERTIES-GEOMETRY"
>geometry</A
>, <A
HREF="utility-applets.html#DESKGUIDE-PROPERTIES-ADVANCED"
>advanced</A
>.</P
><DIV
CLASS="SECT4"
><H4
CLASS="SECT4"
><A
NAME="DESKGUIDE-PROPERTIES-DISPLAY"
>Properties - Display</A
></H4
><P
>The first <SPAN
CLASS="INTERFACE"
>Properties </SPAN
> window, shown
      in <A
HREF="utility-applets.html#DESKGUIDE-PROPERTIES-FIG"
>Figure 63</A
>, allows you to
      control <TT
CLASS="APPLICATION"
>Desk Guide</TT
> applet's display.</P
><DIV
CLASS="FIGURE"
><A
NAME="DESKGUIDE-PROPERTIES-FIG"
></A
><P
><IMG
SRC="./figs/deskguide-properties.png"></P
><P
><B
>Figure 63. Properties Dialog</B
></P
></DIV
><P
>Options include:
<P
></P
><UL
><LI
><P
><TT
CLASS="GUILABEL"
><B
>Switch tasklist arrow</B
></TT
>
	  &#8212; switches the side of the applet on which the
	  arrow used to launch the tasklist window is displayed.</P
></LI
><LI
><P
><TT
CLASS="GUILABEL"
><B
>Only show current desktop in
	  pager</B
></TT
> &#8212; limits the applet display
	  to the desktop currently in use, including all its
	  viewports.</P
></LI
><LI
><P
><TT
CLASS="GUILABEL"
><B
>Raise area grid over tasks</B
></TT
>
	  &#8212; If you use multiple viewports (not only multiple
	  desktops) with your window manager, <TT
CLASS="APPLICATION"
>Desk
	  Guide</TT
> draws a
	  viewport grid in the current desktop. It can either draw the
	  grid on top of the windows or below them.</P
></LI
><LI
><P
><TT
CLASS="GUILABEL"
><B
>Show Desk-Guide tooltips</B
></TT
> &#8212;
	  Display tooltips related to various
	  <TT
CLASS="APPLICATION"
>Desk Guide</TT
> applet components. The arrow
	  is the only widget that displays a tooltip.</P
></LI
><LI
><P
><TT
CLASS="GUILABEL"
><B
>Desk-Guide tooltip delay [ms]</B
></TT
> &#8212;
	  delay, in milliseconds, before the tooltip is displayed. You
	  may either type in a number or use the arrows to change the
	  number.</P
></LI
><LI
><P
><TT
CLASS="GUILABEL"
><B
>Show desktop name tooltips</B
></TT
>
	  &#8212; Some window managers, such as
	  <TT
CLASS="APPLICATION"
>Enlightenment</TT
>, allow you to name
	  your desktops. The feature directs
	  <TT
CLASS="APPLICATION"
>Deskguide</TT
> to show tooltips
	  displaying the desktop's name.</P
></LI
><LI
><P
><TT
CLASS="GUILABEL"
><B
>Desktop name tooltip delay [ms]</B
></TT
>
	  &#8212;  delay, in milliseconds, before the tooltip is
	  displayed. You may either type in a number or use the arrows
	  to change the number.</P
></LI
></UL
></P
></DIV
><DIV
CLASS="SECT4"
><H4
CLASS="SECT4"
><A
NAME="DESKGUIDE-PROPERTIES-TASKS"
>Properties - Tasks</A
></H4
><DIV
CLASS="FIGURE"
><A
NAME="DESKGUIDE-PROPERTIES-TASKS-FIG"
></A
><P
><IMG
SRC="./figs/deskguide-properties-tasks-fig.png"></P
><P
><B
>Figure 64. Properties Dialog - Tasks</B
></P
></DIV
><P
>Options include:</P
><P
></P
><UL
><LI
><P
><TT
CLASS="GUILABEL"
><B
>Show hidden tasks (HIDDEN)</B
></TT
>, 
	<TT
CLASS="GUILABEL"
><B
>Show shaded tasks (SHADED)</B
></TT
>,
	 <TT
CLASS="GUILABEL"
><B
>Show tasks which hide from window list
	  (SKIP-WINLIST)</B
></TT
>, <TT
CLASS="GUILABEL"
><B
>Show tasks which hide from taskbar
	  (SKIP-TASKBAR)</B
></TT
> &#8212; These four items allow
	<TT
CLASS="APPLICATION"
>Deskguide</TT
> to display applications
	running with flags set that would normally hide them from an
	application like this. For instance the
	<TT
CLASS="APPLICATION"
>panel</TT
> is flagged as
	HIDDEN, HIDE_FROM_WINLIST and
	HIDE_FROM_TASKBAR. Selecting these options will allow
	<TT
CLASS="APPLICATION"
>Deskguide</TT
> to show such
	applications.</P
></LI
></UL
></DIV
><DIV
CLASS="SECT4"
><H4
CLASS="SECT4"
><A
NAME="DESKGUIDE-PROPERTIES-GEOMETRY"
>Properties - Geometry</A
></H4
><DIV
CLASS="FIGURE"
><A
NAME="DESKGUIDE-PROPERTIES-GEOMETRY-FIG"
></A
><P
><IMG
SRC="./figs/deskguide-properties-geometry-fig.png"></P
><P
><B
>Figure 65. Properties Dialog - Geometry</B
></P
></DIV
><P
>Options include:</P
><P
></P
><UL
><LI
><P
><TT
CLASS="GUILABEL"
><B
>Desktop Height [pixels]</B
></TT
> &#8212;
	 sets the height of the desktop. By default this is greyed
	 out, and the panel size automatically sets the desktop
	 height. To activate it uncheck the <TT
CLASS="GUILABEL"
><B
>Override desktop
	 height with panel size</B
></TT
> checkbox.</P
></LI
><LI
><P
><TT
CLASS="GUILABEL"
><B
>Override desktop height with panel
	 size</B
></TT
> &#8212; forces <TT
CLASS="APPLICATION"
>Desk
	 Guide</TT
> to automatically size itself to the
	 panel. Unchecking this allows you to manually set the height
	 using the <TT
CLASS="GUILABEL"
><B
>Desktop Height</B
></TT
> setting above.</P
></LI
><LI
><P
><TT
CLASS="GUILABEL"
><B
>Divide height by number of vertical
	 areas</B
></TT
> &#8212; divide the total applet
	 height by the number of rows of desktop areas visible.</P
></LI
><LI
><P
><TT
CLASS="GUILABEL"
><B
>Rows of desktops</B
></TT
> &#8212; set the
	 number of rows of desktop maps <TT
CLASS="APPLICATION"
>Desk
	 Guide</TT
> creates in the panel to represent your
	 desktops.</P
></LI
><LI
><P
><TT
CLASS="GUILABEL"
><B
>Divide height by number of rows</B
></TT
>
	 &#8212; forces <TT
CLASS="APPLICATION"
>Desk
	 Guide</TT
> to fit all the rows of desktops into the
	 height specified above (either one you have manually
	 specified or one set automatically to match the height of the
	 panel). Unchecking this, if you have more than one row,
	 allows <TT
CLASS="APPLICATION"
>Desk Guide</TT
> to expand
	 vertically to two or more times normal height.</P
></LI
></UL
><P
>The options for <SPAN
CLASS="INTERFACE"
>Vertical Layout</SPAN
> are
      mirror those for horizontal layout above, but effect the width
      instead of height of the applet, and the number of columns it
      occupies instead of the number of rows.</P
></DIV
><DIV
CLASS="SECT4"
><H4
CLASS="SECT4"
><A
NAME="DESKGUIDE-PROPERTIES-ADVANCED"
>Properties - Advanced</A
></H4
><DIV
CLASS="FIGURE"
><A
NAME="DESKGUIDE-PROPERTIES-ADVANCED-FIG"
></A
><P
><IMG
SRC="./figs/deskguide-properties-advanced-fig.png"></P
><P
><B
>Figure 66. Properties Dialog - Advanced</B
></P
></DIV
><P
>Advanced options allow you to control <TT
CLASS="APPLICATION"
>Desk
      Guide's</TT
> behavior with specific window managers,
      along with other settings.</P
><P
></P
><UL
><LI
><P
><TT
CLASS="GUILABEL"
><B
>Draw desktops double-buffered
	 (recommended)</B
></TT
> &#8212; controls the method
	 <TT
CLASS="APPLICATION"
>Desk Guide</TT
> draws desktops. Without
	 double-buffering, you may see flicker on slower
	 machines. With it, you may see slower performance on network
	 connections.</P
></LI
><LI
><P
><TT
CLASS="GUILABEL"
><B
>Window manager moves decoration window
	 instead</B
></TT
> &#8212; Check this if, when you move a
	 window with the middle mouse button, but the resulting window
	 position is off. If in doubt, check this if you use any of
	 the window managers mentioned
	 (<TT
CLASS="APPLICATION"
>AfterStep</TT
>,
	 <TT
CLASS="APPLICATION"
>Enlightenment</TT
>,
	 <TT
CLASS="APPLICATION"
>FVWM</TT
>,
	 <TT
CLASS="APPLICATION"
>IceWM</TT
>, or
	 <TT
CLASS="APPLICATION"
>Sawmill</TT
>, now known as
	 <TT
CLASS="APPLICATION"
>Sawfish</TT
>).</P
></LI
><LI
><P
><TT
CLASS="GUILABEL"
><B
>Window manager changes active area on all
	 desktops</B
></TT
> &#8212; If you have more than one
	 desktop, with multiple work areas within each desktop, this
	 option can be used to force the window manager to change the
	 active work area within all the desktops simultaneously if
	 you change your work area on one.</P
></LI
><LI
><P
><TT
CLASS="GUILABEL"
><B
>Window manager expects pager to modify
	 area+desktop</B
></TT
> &#8212; Currently has no effect.</P
></LI
><LI
><P
><TT
CLASS="GUILABEL"
><B
>Popdown task view automatically</B
></TT
> &#8212;
	 Automatically pops down the task view window after you click on an
	 application in the task view list. If unchecked, you must click a
	 second time on the task view arrow to get the window to pop down.</P
></LI
></UL
></DIV
><DIV
CLASS="SECT4"
><H4
CLASS="SECT4"
><A
NAME="AEN6729"
>More Information</A
></H4
><P
>All <SPAN
CLASS="INTERFACE"
>Properties</SPAN
> dialogs have the following
     buttons at the bottom of the dialog:
     <P
></P
><UL
><LI
><P
>        <B
CLASS="GUIBUTTON"
>OK</B
> &#8212;
        Pressing <B
CLASS="GUIBUTTON"
>OK</B
> will activate any changes
        in the properties you have made and close the
        <SPAN
CLASS="INTERFACE"
>Properties</SPAN
> dialog.
       </P
></LI
><LI
><P
>        <B
CLASS="GUIBUTTON"
>Apply</B
> &#8212;
        Pressing <B
CLASS="GUIBUTTON"
>Apply</B
> at any time will
        make your changes active without closing the
        <SPAN
CLASS="INTERFACE"
>Properties</SPAN
> dialog.  This is helpful if
        you would like to test the effects of the changes you have
        made but may want to continue changing the properties.
       </P
></LI
><LI
><P
>        <B
CLASS="GUIBUTTON"
>Close</B
> &#8212;
        Pressing <B
CLASS="GUIBUTTON"
>Close</B
> will close the
        <SPAN
CLASS="INTERFACE"
>Properties</SPAN
> dialog.  Only changes in the
        configuration which were previously applied with the
        <B
CLASS="GUIBUTTON"
>Apply</B
> button will persist.  Other
        changes will not be made active.
       </P
></LI
><LI
><P
>        <B
CLASS="GUIBUTTON"
>Help</B
> &#8212;
        Pressing <B
CLASS="GUIBUTTON"
>Help</B
> brings up the manual for
        the application, opening it to the page describing the
        <SPAN
CLASS="INTERFACE"
>Properties</SPAN
> dialog.


    
    </P
></LI
></UL
></P
></DIV
><DIV
CLASS="SECT4"
><H4
CLASS="SECT4"
><A
NAME="DESKGUIDE-STANDARD-RIGHT-CLICK-ITEMS"
>Standard Pop-Up Items</A
></H4
><P
>     All applets should have the following items in their right-click
     <B
CLASS="GUIMENU"
>pop-up menu</B
>:
     <P
></P
><DIV
CLASS="VARIABLELIST"
><DL
><DT
>Remove from panel</DT
><DD
><P
>         The <B
CLASS="GUIMENUITEM"
>Remove from panel</B
> menu item
         removes the applet from the <SPAN
CLASS="INTERFACE"
>Panel</SPAN
>. 
        </P
></DD
><DT
>Move</DT
><DD
><P
>         After selecting <B
CLASS="GUIMENUITEM"
>Move</B
>, your mouse
         pointer will change appearance (typically to a cross with
         arrows in each direction). As you move your mouse, the applet
         will move with it.  When you have finished moving the applet,
         click any mouse button and the applet will anchor in its
         current position.  Note that applets can be moved between two
         <SPAN
CLASS="INTERFACE"
>Panels</SPAN
> this way.
        </P
></DD
><DT
>Panel</DT
><DD
><P
>         The <B
CLASS="GUISUBMENU"
>Panel</B
> submenu contains various
         items and submenus for adding and removing
         <SPAN
CLASS="INTERFACE"
>Panels</SPAN
> and applets and for changing
         the configuration.
        </P
></DD
><DT
>About</DT
><DD
><P
>         The <B
CLASS="GUIMENUITEM"
>About...</B
> menu item brings up a 
         dialogue box containing various information about the applet,
         typically including the applet's  name, version, author,
         copyright, license and description. 
        </P
></DD
><DT
>Help</DT
><DD
><P
>         The <B
CLASS="GUIMENUITEM"
>Help</B
> menu item brings up the help
         manual for the applet. 
        </P
></DD
></DL
></DIV
>
    </P
></DIV
></DIV
><DIV
CLASS="SECT3"
><H3
CLASS="SECT3"
><A
NAME="DESKGUIDE-APPLET-BUGS"
>Known Bugs and Limitations</A
></H3
><P
>The <TT
CLASS="GUILABEL"
><B
>Window manager expects pager to modify
	 area+desktop</B
></TT
> feature on the <SPAN
CLASS="INTERFACE"
>advanced
    properties</SPAN
> window currently has no effect.
    
    </P
></DIV
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="MINI-COMMANDER"
>Mini-Commander Applet</A
></H2
><P
>	<TT
CLASS="APPLICATION"
>Mini-Commander</TT
> applet, shown in <A
HREF="utility-applets.html#MINI-COMMANDER-APPLET-FIG"
>Figure 67</A
>, adds a command line to your
	<SPAN
CLASS="INTERFACE"
>Panel</SPAN
>. It features command completion,
	command history, changeable macros and an optional built-in clock.
	Because of the changeable macros you can use it for many different
	tasks. You can simply start a program (or a short macro) or view a
	web page or search for a man/info page
	etc. <TT
CLASS="APPLICATION"
>Mini-Commander</TT
> can be detached from
	your <SPAN
CLASS="INTERFACE"
>Panel</SPAN
> using an optional handler on the
	side, which is especially usefull for people who use vertical
	panels.
      </P
><P
>	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"
>Mini-Commander</B
>.
      </P
><DIV
CLASS="FIGURE"
><A
NAME="MINI-COMMANDER-APPLET-FIG"
></A
><P
><IMG
SRC="./figs/mini-commander_applet.png"></P
><P
><B
>Figure 67. Mini-Commander Applet</B
></P
></DIV
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="MINI-COMMANDER-USAGE"
>Usage</A
></H2
><P
>    To start a program or run a command, simply enter the program or
    command and press return. Or, to browse for an application or command
    in your filesystem, click on the small <B
CLASS="GUIICON"
>circle</B
>
    in the lower corner.
   </P
><P
>    <TT
CLASS="APPLICATION"
>Mini-Commander</TT
> has command
    completion (similar to many other user shells).  Thus, you often
    have not to enter the full name but only the first few characters
    followed by the <B
CLASS="KEYCAP"
>tab</B
>
    key. <TT
CLASS="APPLICATION"
>Mini-Commander</TT
> will try to
    complete the program name in the same way most UNIX shells do. 
   </P
><P
>    <TT
CLASS="APPLICATION"
>Mini-Commander</TT
> also has command
    history, which allows you to recall previous commands by pressing
    the <B
CLASS="KEYCAP"
>arrow-up</B
> or <B
CLASS="KEYCAP"
>arrow-down</B
>
    key. This works like the command history in most UNIX shells. Note
    that commands are not stored in the history if it is already
    present in the history in order to avoid duplication.  You may
    also access the history list by pressing the small <B
CLASS="GUIBUTTON"
>down
    arrow icon</B
> in the applet and selecting a command from
    the history list.
   </P
><P
>    <TT
CLASS="APPLICATION"
>Mini-Commander</TT
> has the ability to use
    macros. It has some predefined macros. For example if
    you enter
    <B
CLASS="COMMAND"
>term:<TT
CLASS="REPLACEABLE"
><I
>command</I
></TT
></B
> then
    <B
CLASS="COMMAND"
><TT
CLASS="REPLACEABLE"
><I
>command</I
></TT
></B
> is executed
    in a terminal window. Or if you enter an URL then your web browser is
    used to view it.  Additionally you can define your own macros or
    change the predefined ones.
   </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="utility-applets.html#MINI-COMMANDER-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"
>Mini-commander
       Applet</TT
>, including the applet's version and the
       author's name.
      </P
></LI
></UL
>
   </P
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="MINI-COMMANDER-PREFS"
>Customization</A
></H2
><P
>      You can customize <TT
CLASS="APPLICATION"
>Mini-Commander</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="utility-applets.html#MINI-COMMANDER-SETTINGS-FIG-1"
>Figure 68</A
>), which allows you to
      change various settings.
    </P
><DIV
CLASS="FIGURE"
><A
NAME="MINI-COMMANDER-SETTINGS-FIG-1"
></A
><P
><IMG
SRC="./figs/mini-commander_settings_general.png"></P
><P
><B
>Figure 68. Properties dialog: General Tab</B
></P
></DIV
><P
>     The properties in the <TT
CLASS="GUILABEL"
><B
>General</B
></TT
> tab are:
     <P
></P
><UL
><LI
><P
>        Show time &#8212; If this button is checked, the time will be
        shown in the lower corner of the applet.
       </P
></LI
><LI
><P
>        Show date &#8212; If this button is checked, the date will be
        shown in the lower corner of the applet.
       </P
></LI
><LI
><P
>        Show handle &#8212; If this button is checked, a handle will
        be attached to the edge of the applet, allowing you to detach
        the applet from the <SPAN
CLASS="INTERFACE"
>Panel</SPAN
>.  You may
        re-attach the applet on the <SPAN
CLASS="INTERFACE"
>Panel</SPAN
> by
        dragging it back into place.
       </P
></LI
><LI
><P
>        Show frame &#8212; If this button is checked, a thin black
        frame will be drawn around the applet.
       </P
></LI
><LI
><P
>        Enable history based auto completion &#8212; If this button is
        selected, <TT
CLASS="APPLICATION"
>Mini-Commander</TT
> will
        automatically complete commands using the history list.
       </P
></LI
><LI
><P
>        Applet width &#8212; Enter the desired applet width here.
       </P
></LI
><LI
><P
>        Applet height &#8212; Enter the desired applet height here.
       </P
></LI
><LI
><P
>        Command line height &#8212; (This feature is disabled.)
       </P
></LI
><LI
><P
>        Command line foreground &#8212; Select the foreground color,
        used for the text you enter.
       </P
></LI
><LI
><P
>        Command line background &#8212; Selecting the background
        color, used for the background behind the text in the entry.
       </P
></LI
></UL
>
    </P
><P
>     The <TT
CLASS="GUILABEL"
><B
>Macros</B
></TT
> tab consists of a list of up to
     99 macros, each of which is a regular expression
     (<TT
CLASS="GUILABEL"
><B
>Regex</B
></TT
>) and a macro
     (<TT
CLASS="GUILABEL"
><B
>Macro</B
></TT
>).  Enter the regular expression for
     <TT
CLASS="APPLICATION"
>Mini-Commander</TT
> to match in the left
     column, and the corresponding macro which should be executed in
     the right column.  The default setting has many useful macros
     already defined, which may be helpful in learning to write your
     own macros.
    </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="MIN-COMMANDER-FAQ"
>Frequently Asked Questions</A
></H2
><P
>    Here are listed some frequently asked questions and the answers to
    them.
   </P
><DIV
CLASS="QANDASET"
><DL
><DT
>1. <A
HREF="qandaset6898.html#AEN6900"
>       Why am I not able to give
       <TT
CLASS="APPLICATION"
>Mini-Commander</TT
> keyboard focus?
      </A
></DT
></DL
><DIV
CLASS="QANDAENTRY"
><DIV
CLASS="QUESTION"
><P
><A
NAME="AEN6900"
></A
><B
>1. </B
>       Why am I not able to give
       <TT
CLASS="APPLICATION"
>Mini-Commander</TT
> keyboard focus?
      </P
></DIV
><DIV
CLASS="ANSWER"
><P
><B
> </B
>       This is a confusing problem which seems to have several reasons
       and which occurs only under certain conditions.
      </P
><P
>       If you cannot give <TT
CLASS="APPLICATION"
>Mini-Commander</TT
>
       applet keyboard focus at all then this could be a problem with
       you window manager.  If this is true for you it would helpful
       if you write me a short mail and tell me what window manager
       you are using (name and version).
      </P
><P
>       Sometimes it happens that you can give keyboard focus to
      <TT
CLASS="APPLICATION"
>Mini-Commander</TT
> applet only for the
      first time.  After this it is impossible
      to focus it again.  Currently the reason for this bug is
      unknown.
      </P
></DIV
></DIV
></DIV
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="MINI-COMMANDER-BUGS"
>Known Bugs and Limitations</A
></H2
><P
>    In some instances, it is impossible to give
    <TT
CLASS="APPLICATION"
>Mini-Commander</TT
> focus after the first
    time.
   </P
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="MINI-COMMANDER-FURTHERINFO"
>Further Information</A
></H2
><P
>    For more information on <TT
CLASS="APPLICATION"
>Mini-Commander</TT
>
    applet, check out its web page at <A
HREF="http://om.filewatcher.org/mini-commander/"
TARGET="_top"
>    http://om.filewatcher.org/mini-commander/</A
>.
   </P
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="DRIVEMOUNTAPPLET"
>Drive Mount Applet</A
></H2
><P
>   <TT
CLASS="APPLICATION"
>Drive Mount Applet</TT
>, shown in <A
HREF="utility-applets.html#DRIVEMOUNTAPPLET-FIG"
>Figure 69</A
>, allows you to quickly and easily
   mount and unmount various types of drives and filesystems on your
   computer.  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"
>Drive Mount</B
>.
  </P
><DIV
CLASS="FIGURE"
><A
NAME="DRIVEMOUNTAPPLET-FIG"
></A
><P
><IMG
SRC="./figs/drivemount_applet_floppy.png"></P
><P
><B
>Figure 69. Drive Mount Applet</B
></P
></DIV
><DIV
CLASS="NOTE"
><P
></P
><TABLE
CLASS="NOTE"
WIDTH="100%"
BORDER="0"
><TR
><TD
WIDTH="25"
ALIGN="CENTER"
VALIGN="TOP"
><IMG
SRC="./stylesheet-images/note.gif"
HSPACE="5"
ALT="Note"></TD
><TH
ALIGN="LEFT"
VALIGN="CENTER"
><B
>NOTE</B
></TH
></TR
><TR
><TD
>&nbsp;</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
><P
>    Many filesystems on Linux and Unix systems must be manually
    mounted and unmounted.  After a filesystem is mounted, you can
    read and write to it.  When you are finished with a filesystem,
    you should unmount it.  It is important to unmount removable
    drives, such as floppy disks and Zip disks,
    before removing the media, because Linux and Unix systems do not
    always write the changes made immediately.  They typically buffer
    the changes made to the disk in order to improve the speed of the
    system. Partitions on fixed drives, such as your hard drive, are
    typically mounted automatically when your computer boots and
    unmounted when it shuts down.  Removable media must be mounted and
    unmounted by hand, such as by using <TT
CLASS="APPLICATION"
>Drive
    Mount</TT
> applet.  
   </P
><P
>    The "root
    filesystem" is the main filesystem on your computer starting with
    "/" (root).  Other filesystems are associated with directories inside
    the root filesystem.  These are called "mount points", which are
    just empty directories.  When a filesystem is mounted, their
    contents appear inside this directory.  As an example, most
    systems create a mount point "/mnt/floppy" which is just an empty
    directory if your floppy drive is not mounted, and which contains
    the contents of your floppy if the floppy drive is mounted.
   </P
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="SECT3"
><H3
CLASS="SECT3"
><A
NAME="DRIVEMOUNT-USAGE"
>Usage</A
></H3
><P
>    To mount or unmount a drive, simply click on the
    <TT
CLASS="APPLICATION"
>Drive Mount Applet</TT
> icon with the left
    mouse button.  For drives which can eject their media, such as 
    most CDROM's and JAZ drives, you can eject the drive by clicking on the
    icon with the right mouse button and selecting
    <B
CLASS="GUIMENUITEM"
>Eject</B
>. To browse the contents of the
    drive with the GNOME File Manager, select
    <B
CLASS="GUIMENUITEM"
>Browse&#8230;</B
>. 
   </P
><P
>    Right-clicking on the applet brings up a menu containing the
    following items:
    <P
></P
><UL
><LI
><P
>       <B
CLASS="GUIMENUITEM"
>Browse&#8230;</B
> &#8212; shows
       the contents of the drive using the GNOME File Manager.
       The drive must be mounted for this to work.
      </P
></LI
><LI
><P
>       <B
CLASS="GUIMENUITEM"
>Eject</B
> &#8212; ejects the
       storage medium for drives which can be ejected, such as       
       CDROM's and JAZ drives.
      </P
></LI
><LI
><P
>       <B
CLASS="GUIMENUITEM"
>Properties&#8230;</B
> &#8212;
       opens the <A
HREF="utility-applets.html#DRIVEMOUNTAPPLET-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"
>Drive Mount
       Applet</TT
>, including the applet's version and the
       author's name.
      </P
></LI
></UL
>
   </P
><P
>    The mount point and mount status of a drive is shown in a tooltip
    if the cursor is left over the applet for a short time, as shown
    in <A
HREF="utility-applets.html#DRIVEMOUNTAPPLETTOOLTIPS-FIG"
>Figure 70</A
>.
    <DIV
CLASS="FIGURE"
><A
NAME="DRIVEMOUNTAPPLETTOOLTIPS-FIG"
></A
><P
><IMG
SRC="./figs/drivemount_applet_tooltip.png"></P
><P
><B
>Figure 70. Drive Mount Applet showing tooltip</B
></P
></DIV
>
   </P
></DIV
><DIV
CLASS="SECT3"
><H3
CLASS="SECT3"
><A
NAME="DRIVEMOUNTAPPLET-PREFS"
>Customization</A
></H3
><P
>      You can customize <TT
CLASS="APPLICATION"
>Drive Mount</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="utility-applets.html#DRIVEMOUNT-SETTINGS-FIG"
>Figure 71</A
>), which allows you to
      change various settings.
    </P
><DIV
CLASS="FIGURE"
><A
NAME="DRIVEMOUNT-SETTINGS-FIG"
></A
><P
><IMG
SRC="./figs/drivemount_applet_settings.png"></P
><P
><B
>Figure 71. Properties dialog</B
></P
></DIV
><P
>     The properties are:
     <P
></P
><UL
><LI
><P
>        Mount Point &#8212; This is the mount point used when mounting
        the drive.  If you are unfamiliar with mount points, this is
        an empty directory which will hold the contents of the drive
        whenever the drive is mounted.  Mount points can occur
        anywhere in your filesystem, but the convention is to put all
        mount points for removable drives in the  <TT
CLASS="FILENAME"
>/mnt</TT
>
        directory.
       </P
></LI
><LI
><P
>        Update in seconds &#8212; This is the interval in seconds at
        which <TT
CLASS="APPLICATION"
>Drive Mount</TT
> refreshes its
        icon by checking with the mount status.  This is only
        important if you sometimes mount or unmount a drive using a
        command or application besides <TT
CLASS="APPLICATION"
>Drive
        Mount</TT
> sometimes.
       </P
></LI
><LI
><P
>        Icon &#8212; This determines the icons (one for unmounted and
        one for mounted) displayed for the
        drive.  There are icon sets for most of the commonly used
        drives(floppy, CDROM, Zip, hard disk, and JAZ).
        They are shown in <A
HREF="utility-applets.html#DRIVEMOUNTAPPLETALL-FIG"
>Figure 72</A
>. You may also select
        <B
CLASS="GUIMENUITEM"
>Custom</B
>; this allows you to specify
        your own icons.
       </P
><DIV
CLASS="FIGURE"
><A
NAME="DRIVEMOUNTAPPLETALL-FIG"
></A
><P
><IMG
SRC="./figs/drivemount_applet_all.png"></P
><P
><B
>Figure 72. Icons for Mounted and Unmounted Drives of Various Types</B
></P
></DIV
><P
>        Notice that <A
HREF="utility-applets.html#DRIVEMOUNTAPPLETALL-FIG"
>Figure 72</A
>
        shows the icons for the unmounted and mounted states of (from
        left to right) floppy, CDROM, Zip, JAZ, and hard disk drives.
       </P
></LI
><LI
><P
>        Custom icon for mounted  &#8212; A custom icon which is
        displayed when the drive is mounted.  This option is only
        available if the <B
CLASS="GUIMENU"
>Icon:</B
> selection is set to
        "Custom". 
       </P
></LI
><LI
><P
>        Custom icon for not mounted  &#8212; A custom icon which is
        displayed when the drive is not mounted.  This option is only
        available if the <B
CLASS="GUIMENU"
>Icon:</B
> selection is set to
        "Custom". 
       </P
></LI
><LI
><P
>        Scale size to panel &#8212; Selecting this option scales
        the size of the mounted and unmounted icons with the
        <SPAN
CLASS="INTERFACE"
>Panel</SPAN
>'s size.  If this option is not
        set the icon sizes are fixed, independent of the size of
        the <SPAN
CLASS="INTERFACE"
>Panel</SPAN
>. Selecting this option
        typically makes for a nicer appearance.  For very small
        <SPAN
CLASS="INTERFACE"
>Panel</SPAN
> sizes, unselecting this option
        may be useful, as it forces the applet to appear rotated and
        larger, which makes it easier to see.
       </P
></LI
><LI
><P
>        Use automount friendly status test &#8212; Select this option
        if you use automount, otherwise leave it unselected.
       </P
><DIV
CLASS="NOTE"
><P
></P
><TABLE
CLASS="NOTE"
WIDTH="90%"
BORDER="0"
><TR
><TD
WIDTH="25"
ALIGN="CENTER"
VALIGN="TOP"
><IMG
SRC="./stylesheet-images/note.gif"
HSPACE="5"
ALT="Note"></TD
><TH
ALIGN="LEFT"
VALIGN="CENTER"
><B
>NOTE</B
></TH
></TR
><TR
><TD
>&nbsp;</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
><P
>         The default command used by <TT
CLASS="APPLICATION"
>Drive
         Mount</TT
>to test whether a drive is mounted is
         <B
CLASS="COMMAND"
>stat</B
> and would cause the drive to actually be
         mounted if the user is using
         <TT
CLASS="APPLICATION"
>automount</TT
>. If this button is 
         selected, it uses <B
CLASS="COMMAND"
>mount</B
> instead, which
         does not cause <TT
CLASS="APPLICATION"
>automount</TT
> to mount
         the drive.  The reason this button is not selected by default
         is that <B
CLASS="COMMAND"
>mount</B
> is more cpu intensive than
         <B
CLASS="COMMAND"
>stat</B
>. 
        </P
></TD
></TR
></TABLE
></DIV
></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="SECT3"
><H3
CLASS="SECT3"
><A
NAME="DRIVEMOUNTAPPLET-CONFIGURING"
>Configuring Your System</A
></H3
><DIV
CLASS="WARNING"
><P
></P
><TABLE
CLASS="WARNING"
WIDTH="100%"
BORDER="0"
><TR
><TD
WIDTH="25"
ALIGN="CENTER"
VALIGN="TOP"
><IMG
SRC="./stylesheet-images/warning.gif"
HSPACE="5"
ALT="Warning"></TD
><TH
ALIGN="LEFT"
VALIGN="CENTER"
><B
>WARNING</B
></TH
></TR
><TR
><TD
>&nbsp;</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
><P
>     This section is intended for system administrators and advanced
     users.
    </P
></TD
></TR
></TABLE
></DIV
><P
>    In order for <TT
CLASS="APPLICATION"
>Drive Mount Applet</TT
> to work
    properly, the system may need to be configured by the system
    administrator, using root priveleges.  This section provides a
    very basic introduction.
   </P
><P
>    Information describing the mount point and filesystem type of each
    drive is kept in <TT
CLASS="FILENAME"
>/etc/fstab</TT
>.  This can be
    configured by hand or by using the
    <TT
CLASS="APPLICATION"
>linuxconf</TT
> application. For drives which
    do not always have a single filesystem type (such as a floppy
    drive which may have msdos or ext2 filesystems), you should use
    "auto" for the filesystem type.  Each device has a single line in
    /etc/fstab of the following form:
    <TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>    /dev/fd0        /mnt/floppy      auto    noauto,rw,user  0 0
    </PRE
></TD
></TR
></TABLE
>
    This entry describes the first floppy device (/dev/fd0) as having
    a mount point of <TT
CLASS="FILENAME"
>/mnt/floppy</TT
>, a variable
    filesystem type which should be automatically detected, and the
    following configurations: "noauto"&#8212; Do not automatically
    mount the drive when the computer is booted, "rw"&#8212; The drive
    is readable and writable, and "user"&#8212; Users have permission
    to mount the drive.  These, along with the last two fields which
    we do not describe here, are discussed in detail in the fstab man
    pages, available by typing <B
CLASS="COMMAND"
>man fstab</B
> or through
    the <TT
CLASS="APPLICATION"
>GNOME Help Browser</TT
>.
   </P
><P
>    The <TT
CLASS="APPLICATION"
>linuxconf</TT
> application provides a
    graphical interface to controlling these filesystems.  To start
    <TT
CLASS="APPLICATION"
>linuxconf</TT
>, just type
    <B
CLASS="COMMAND"
>linuxconf</B
> in a shell window (you must log in as
    root). Select 
    <B
CLASS="GUIMENU"
>Config</B
>-&gt;<B
CLASS="GUISUBMENU"
>File systems</B
>-&gt;<B
CLASS="GUIMENUITEM"
>Access local drive</B
>. 
    To edit an entry, just select
    it. <TT
CLASS="APPLICATION"
>linuxconf</TT
> is meant to be easy
    to use, and has its own internal help system to guide you
    through the process. You may also add new entries by selecting the
    <B
CLASS="GUIBUTTON"
>Add</B
> button.
   </P
></DIV
><DIV
CLASS="SECT3"
><H3
CLASS="SECT3"
><A
NAME="DRIVEMOUNTAPPLET-TROUBLESHOOTING"
>Troubleshooting and Understanding Error Messages</A
></H3
><P
>    If you do not have your system configured properly, you may
    encounter certain error messages when trying to mount or access
    certain drives. Here are some of the more common error messages
    and their causes: 
    <P
></P
><UL
><LI
><P
>       <SPAN
CLASS="QUOTE"
>"mount: /dev/fd0 is not a valid block
       device"</SPAN
>&#8212; The most common cause for this error is
       that the drive (in this example, /dev/fd0, corresponding to the
       floppy drive) is empty. 
      </P
></LI
><LI
><P
>       <SPAN
CLASS="QUOTE"
>"mount: only root can mount /dev/fda on
       /mnt/floppy"</SPAN
>&#8212; You do not have permission to mount
       this drive.  Contact the system administrator, who can give you
       permission. 
      </P
><DIV
CLASS="NOTE"
><P
></P
><TABLE
CLASS="NOTE"
WIDTH="90%"
BORDER="0"
><TR
><TD
WIDTH="25"
ALIGN="CENTER"
VALIGN="TOP"
><IMG
SRC="./stylesheet-images/note.gif"
HSPACE="5"
ALT="Note"></TD
><TH
ALIGN="LEFT"
VALIGN="CENTER"
><B
>NOTE</B
></TH
></TR
><TR
><TD
>&nbsp;</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
><P
>        You can set a drive to be mountable and unmountable by users by
        adding "users" to the mount options (fourth column) in
        <TT
CLASS="FILENAME"
>/etc/fstab</TT
>.  This may be done by hand or
        by using <TT
CLASS="APPLICATION"
>linuxconf</TT
>, using the
        <TT
CLASS="GUILABEL"
><B
>Local volume</B
></TT
> tab in  
       <B
CLASS="GUIMENU"
>Config</B
>-&gt;<B
CLASS="GUISUBMENU"
>File systems</B
>-&gt;<B
CLASS="GUIMENUITEM"
>Access local drive</B
>. After you select the correct drive from the list,
        it will show you the <TT
CLASS="GUILABEL"
><B
>Volume
        specifications</B
></TT
>.  Click on the
        <TT
CLASS="GUILABEL"
><B
>Options</B
></TT
> tab, and select the
        <B
CLASS="GUIBUTTON"
>User mountable</B
> button. 
       </P
></TD
></TR
></TABLE
></DIV
></LI
><LI
><P
>       <SPAN
CLASS="QUOTE"
>"mount: wrong fs type, bad option, bad superblock on
       /dev/cdrom, or too many mounted file systems"</SPAN
>&#8212;
       This error can be caused by several problems.  It is most
       commonly caused by having the write filesystem type, such as
       trying to mount a music CDROM as if it held data, or trying to
       mount an msdos formatted floppy as ext2.
      </P
></LI
><LI
><P
>       <SPAN
CLASS="QUOTE"
>"mount /mnt/cdrom 2&#62;&#38;1 reported: mount: No medium
       found"</SPAN
>&#8212; This error indicates the drive, in
       this case the CDROM drive, is empty.
      </P
></LI
><LI
><P
>       <SPAN
CLASS="QUOTE"
>"umount /mnt/cdrom 2&#62;&#38;1 reported: umount: /mnt/cdrom:
       device is busy"</SPAN
>&#8212; This error indicates that the
       drive cannot be unmounted because the drive is being used by
       the computer.  This often happens if you have the
       <TT
CLASS="APPLICATION"
>GNOME File Manager</TT
> open to a
       directory on the drive or if you have a terminal window open
       with the working directory on the drive.
      </P
></LI
><LI
><P
>       <SPAN
CLASS="QUOTE"
>"umount: can't find /mnt/floppy in /etc/fstab or /etc/mtab
       "</SPAN
>&#8212;
       This indicates that the system has not been configured to mount
       the mount point you are trying to use.  In many cases, you may
       have put the wrong mount point in the <TT
CLASS="GUILABEL"
><B
>Mount
       point</B
></TT
> entry in the <SPAN
CLASS="INTERFACE"
>Properties
       Dialog</SPAN
> (see <A
HREF="utility-applets.html#DRIVEMOUNTAPPLET-PREFS"
>the section called <I
>Customization</I
></A
>). To find out which mount
       point you should be using, contact your system administrator.
      </P
><DIV
CLASS="NOTE"
><P
></P
><TABLE
CLASS="NOTE"
WIDTH="90%"
BORDER="0"
><TR
><TD
WIDTH="25"
ALIGN="CENTER"
VALIGN="TOP"
><IMG
SRC="./stylesheet-images/note.gif"
HSPACE="5"
ALT="Note"></TD
><TH
ALIGN="LEFT"
VALIGN="CENTER"
><B
>NOTE</B
></TH
></TR
><TR
><TD
>&nbsp;</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
><P
>        Each device (filesystem or drive) which can be mounted should
        be listed in the <TT
CLASS="FILENAME"
>/etc/fstab</TT
> configuration
        file. Reading this file will tell you which devices are
        configured for your system.  To add or modify entries, you can
        edit this file by hand or by using the
        <TT
CLASS="APPLICATION"
>linuxconf</TT
> application.
       </P
></TD
></TR
></TABLE
></DIV
></LI
><LI
><P
>       <SPAN
CLASS="QUOTE"
>"mount: /dev/fd0 already mounted or /mnt/floppy busy
       mount: according to mtab, /dev/fd0 is mounted on /mnt/floppy_ext2
       "</SPAN
>&#8212;
       This error occurs if you have a single device (in this case
       /dev/fd0) configured for multiple mount points and you try to
       mount one mount point while another one is already mounted.
       Having multiple mount points for a single device typically is
       not necessary.
      </P
></LI
><LI
><P
>       <SPAN
CLASS="QUOTE"
>"mount: the kernel does not recognize /dev/sda4 as a
       block device(maybe 'insmod driver'?)"</SPAN
>&#8212; Contact
       your system administrator. (This error
       occurs if your kernel is not properly configured to
       automatically mount the necessary kernel modules to read the
       device.)
      </P
></LI
></UL
>
   </P
></DIV
><DIV
CLASS="SECT3"
><H3
CLASS="SECT3"
><A
NAME="DRIVEMOUNT-BUGS"
>Known Bugs and Limitations</A
></H3
><P
>    <B
CLASS="GUIMENUITEM"
>Eject</B
> does not always work.  Trying to
    Eject with the drive mounted does not give a warning, explaining
    why the drive does not eject.
   </P
></DIV
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="TASKLIST-APPLET"
>Tasklist Applet</A
></H2
><P
> 
    <TT
CLASS="APPLICATION"
>Tasklist</TT
> applet, shown in <A
HREF="utility-applets.html#TASKLIST-APPLET-FIG"
>Figure 73</A
>, displays a table showing windowed
    applications running on your computer. Depending on the options
    chosen, you can display either those on the desktop currently in
    use, or on all virtual desktops. To add this applet to a
    <SPAN
CLASS="INTERFACE"
>Panel</SPAN
>, right-click on the panel and choose
         <B
CLASS="GUIMENU"
>Applets</B
>-&gt;<B
CLASS="GUISUBMENU"
>Utility</B
>-&gt;<B
CLASS="GUIMENUITEM"
>Tasklist</B
>. 
   </P
><DIV
CLASS="FIGURE"
><A
NAME="TASKLIST-APPLET-FIG"
></A
><P
><IMG
SRC="./figs/tasklist-fig.png"></P
><P
><B
>Figure 73. Tasklist</B
></P
></DIV
><DIV
CLASS="SECT3"
><H3
CLASS="SECT3"
><A
NAME="TASKLIST-APPLET-USAGE"
>Usage</A
></H3
><P
><TT
CLASS="APPLICATION"
>Tasklist</TT
> allows you to quickly
    navigate the applications running on your computer, displaying
    icons and application names for each application that meets the
    criteria you've set in the <A
HREF="utility-applets.html#TASKLIST-APPLET-PROPERTIES"
>properties window</A
>. Clicking
    on an icon or application name gives focus to that application,
    bringing it to the foreground so it accepts your keyboard input.</P
><P
>Right-clicking with the mouse on an application's icon or
    text in the applet brings up the following menu:</P
><DIV
CLASS="FIGURE"
><A
NAME="TASKLIST-RIGHTCLICK-FIG"
></A
><P
><IMG
SRC="./figs/tasklist-rightclick-fig.png"></P
><P
><B
>Figure 74. Tasklist Right-Click Options</B
></P
></DIV
><P
>    <P
></P
><UL
><LI
><P
><TT
CLASS="GUILABEL"
><B
>Iconify</B
></TT
>  &#8212; reduce the
	  selected application to a panel icon. When an application
	  already has been iconified, the menu item changes to
	  <TT
CLASS="GUILABEL"
><B
>Restore</B
></TT
>. Clicking on it restores the
	  application to your desktop.</P
></LI
><LI
><P
><TT
CLASS="GUILABEL"
><B
>Shade</B
></TT
> &#8212; minimize the
	  application to a single window bar. When an application
	  has been Shaded, the menu item changes to
	  <TT
CLASS="GUILABEL"
><B
>Unshade</B
></TT
>. Clicking on
	  <TT
CLASS="GUILABEL"
><B
>Unshade</B
></TT
> restores the application to
	  full size.</P
></LI
><LI
><P
><TT
CLASS="GUILABEL"
><B
>Stick</B
></TT
> &#8212; make application
	  "sticky", which means it remains in your field of view when
	  you change virtual desktops, following you as you go. When
	  an application is sticky, the menu option
	  <TT
CLASS="GUILABEL"
><B
>Unstick</B
></TT
> is displayed, allowing you to
	  leave an application behind as you continue your virtual
	  desktop travels.</P
></LI
><LI
><P
><TT
CLASS="GUILABEL"
><B
>Kill</B
></TT
> &#8212; kills the
	  application. The <A
HREF="utility-applets.html#TASKLIST-APPLET-PROPERTIES"
>properties
	  dialog</A
> allows you to
	  have <TT
CLASS="APPLICATION"
>Tasklist</TT
> prompt you for
	  confirmation before causing an application's untimely death.</P
></LI
></UL
></P
></DIV
><DIV
CLASS="SECT3"
><H3
CLASS="SECT3"
><A
NAME="TASKLIST-APPLET-RIGHT-CLICK"
>Right-Click Pop-Up Menu Items</A
></H3
><P
> 
     In addition to the standard menu items (see <A
HREF="utility-applets.html#TASKLIST-STANDARD-RIGHT-CLICK-ITEMS"
>the section called <I
>Standard Pop-Up Items</I
></A
>), the
    right-clickpop-up menu has
    <B
CLASS="GUIMENUITEM"
>Properties...</B
> item &#8212; This menu
    item opens the <SPAN
CLASS="INTERFACE"
>Properties</SPAN
> dialog (see <A
HREF="utility-applets.html#TASKLIST-APPLET-PROPERTIES"
>the section called <I
>Properties</I
></A
>) which allows you to
    customize the appearance and behavior of this applet.
    </P
></DIV
><DIV
CLASS="SECT3"
><H3
CLASS="SECT3"
><A
NAME="TASKLIST-APPLET-PROPERTIES"
>Properties</A
></H3
><P
>     You can configure <TT
CLASS="APPLICATION"
>Tasklist</TT
> applet by
     right-clicking on the applet and choosing the
     <B
CLASS="GUIMENUITEM"
>Properties...</B
> menu item. This will open the
     <SPAN
CLASS="INTERFACE"
>Properties</SPAN
> dialog, shown in <A
HREF="utility-applets.html#TASKLIST-APPLET-PROPERTIES-FIG"
>Figure 75</A
>.
    </P
><DIV
CLASS="FIGURE"
><A
NAME="TASKLIST-APPLET-PROPERTIES-FIG"
></A
><P
><IMG
SRC="./figs/tasklist-properties.png"></P
><P
><B
>Figure 75. Properties Dialog</B
></P
></DIV
><P
>The <SPAN
CLASS="INTERFACE"
>Properties dialog</SPAN
> allows to you
    control which tasks are displayed:
<P
></P
><UL
><LI
><P
><TT
CLASS="GUILABEL"
><B
>Show normal applications</B
></TT
> &#8212;
	  display, in the applet, all applications on the current
	  desktop that have not been minimized.</P
></LI
><LI
><P
><TT
CLASS="GUILABEL"
><B
>Show iconified (minimized) applications
	  </B
></TT
> &#8212; show all applications on the current
	  desktop that have been minimized</P
></LI
><LI
><P
><TT
CLASS="GUILABEL"
><B
>Show normal applications on all
	  desktops</B
></TT
> &#8212; show all full-sized,
	  non-minimized applications on all desktops. For this to
	  work, you must also have checked the <TT
CLASS="GUILABEL"
><B
>Show normal
	  applications</B
></TT
> checkbox above.</P
></LI
><LI
><P
><TT
CLASS="GUILABEL"
><B
>Show iconified (minimized) applications on
	  all desktops</B
></TT
> &#8212; show all applications that
	  have been minimized on all desktops. For this to work, you
	  must also have checked <TT
CLASS="GUILABEL"
><B
>Show iconified (minimized)
	  applications</B
></TT
> above.</P
></LI
></UL
></P
><P
><P
></P
><UL
><LI
><P
><TT
CLASS="GUILABEL"
><B
>Show mini icons</B
></TT
> &#8212; Some
	  applications support a miniature icon. This option displays
	  it on the <TT
CLASS="APPLICATION"
>Tasklist</TT
> panel.</P
></LI
><LI
><P
><TT
CLASS="GUILABEL"
><B
>Confirm before killing windows</B
></TT
>
	  &#8212; have the applet prompt you before you're permitted
	  to <A
HREF="utility-applets.html#TASKLIST-RIGHTCLICK-FIG"
>kill an
	  application</A
>.</P
></LI
><LI
><P
><TT
CLASS="GUILABEL"
><B
>Move iconified tasks to current workspace
	    when restoring</B
></TT
> &#8212; automatically switches
	    the desktop work area on your screen to the one containing
	    the application you click on in the
	    <TT
CLASS="APPLICATION"
>Tasklist</TT
> panel.</P
></LI
></UL
>&#13;</P
><DIV
CLASS="FIGURE"
><A
NAME="TASKLIST-APPLET-SIZE-FIG"
></A
><P
><IMG
SRC="./figs/tasklist-properties-size.png"></P
><P
><B
>Figure 76. Properties Dialog - Size</B
></P
></DIV
><P
>The <SPAN
CLASS="INTERFACE"
>size properties dialog</SPAN
> controls
    how much space <TT
CLASS="APPLICATION"
>Tasklist</TT
> takes up on
    your panel:
<P
></P
><UL
><LI
><P
><TT
CLASS="GUILABEL"
><B
>Follow panel size</B
></TT
>
	  &#8212; have <TT
CLASS="APPLICATION"
>Tasklist</TT
> size
	  determined automatically based on panel size. This overrides
	  other size options.</P
></LI
><LI
><P
><TT
CLASS="GUILABEL"
><B
>Tasklist width (height)</B
></TT
>
	  &#8212; width (or height in vertical panel) of
	  <TT
CLASS="APPLICATION"
>Tasklist</TT
> in pixels.</P
></LI
><LI
><P
><TT
CLASS="GUILABEL"
><B
>Rows of tasks</B
></TT
>
	  &#8212; determines how many rows of task icons
	  <TT
CLASS="APPLICATION"
>Tasklist</TT
> displays.</P
></LI
><LI
><P
><TT
CLASS="GUILABEL"
><B
>Default task size</B
></TT
>
	  &#8212; set the default size for display of a task
	  item. (This only has effect if <TT
CLASS="GUILABEL"
><B
>Tasklist width is
	  dynamic</B
></TT
> is checked below.)</P
></LI
><LI
><P
><TT
CLASS="GUILABEL"
><B
>Tasklist width (height) is fixed
	  (dynamic)</B
></TT
> &#8212; Have the size of the tasklist
	  fixed or established by the applet dynamically. Setting it
	  to "fixed" means that the applet will always take the amount
	  of space set in "tasklist width", even if there are no
	  tasks. Setting it to <TT
CLASS="GUILABEL"
><B
>dynamic</B
></TT
> means that
	  the applet will take as much space as needed to show all tasks (zero if
	  there are no tasks), but not more than the value set in
	  <TT
CLASS="GUILABEL"
><B
>Tasklist width</B
></TT
>.</P
></LI
></UL
>&#13;</P
></DIV
><DIV
CLASS="SECT3"
><H3
CLASS="SECT3"
><A
NAME="AEN7237"
>Basic Properties Options</A
></H3
><P
>All <SPAN
CLASS="INTERFACE"
>Properties</SPAN
> dialogs have the following
     buttons at the bottom of the dialog:
     <P
></P
><UL
><LI
><P
>        <B
CLASS="GUIBUTTON"
>OK</B
> &#8212;
        Pressing <B
CLASS="GUIBUTTON"
>OK</B
> will activate any changes
        in the properties you have made and close the
        <SPAN
CLASS="INTERFACE"
>Properties</SPAN
> dialog.
       </P
></LI
><LI
><P
>        <B
CLASS="GUIBUTTON"
>Apply</B
> &#8212;
        Pressing <B
CLASS="GUIBUTTON"
>Apply</B
> at any time will
        make your changes active without closing the
        <SPAN
CLASS="INTERFACE"
>Properties</SPAN
> dialog.  This is helpful if
        you would like to test the effects of the changes you have
        made but may want to continue changing the properties.
       </P
></LI
><LI
><P
>        <B
CLASS="GUIBUTTON"
>Close</B
> &#8212;
        Pressing <B
CLASS="GUIBUTTON"
>Close</B
> will close the
        <SPAN
CLASS="INTERFACE"
>Properties</SPAN
> dialog.  Only changes in the
        configuration which were previously applied with the
        <B
CLASS="GUIBUTTON"
>Apply</B
> button will persist.  Other
        changes will be discarded.
       </P
></LI
><LI
><P
>        <B
CLASS="GUIBUTTON"
>Help</B
> &#8212;
        Pressing <B
CLASS="GUIBUTTON"
>Help</B
> brings up the manual for
        the application, opening it to the page describing the
        <SPAN
CLASS="INTERFACE"
>Properties</SPAN
> dialog.


    
    </P
></LI
></UL
></P
></DIV
><DIV
CLASS="SECT3"
><H3
CLASS="SECT3"
><A
NAME="TASKLIST-STANDARD-RIGHT-CLICK-ITEMS"
>Standard Pop-Up Items</A
></H3
><P
>     All applets should have the following items in their right-click
     <B
CLASS="GUIMENU"
>pop-up menu</B
>:
     <P
></P
><DIV
CLASS="VARIABLELIST"
><DL
><DT
>Remove from panel</DT
><DD
><P
>         The <B
CLASS="GUIMENUITEM"
>Remove from panel</B
> menu item
         removes the applet from the <SPAN
CLASS="INTERFACE"
>Panel</SPAN
>. 
        </P
></DD
><DT
>Move</DT
><DD
><P
>         After selecting <B
CLASS="GUIMENUITEM"
>Move</B
>, your mouse
         pointer will change appearance (typically to a cross with
         arrows in each direction). As you move your mouse, the applet
         will move with it.  When you have finished moving the applet,
         click any mouse button and the applet will anchor in its
         current position.  Note that applets can be moved between two
         <SPAN
CLASS="INTERFACE"
>Panels</SPAN
> this way.
        </P
></DD
><DT
>Panel</DT
><DD
><P
>         The <B
CLASS="GUISUBMENU"
>Panel</B
> submenu contains various
         items and submenus for adding and removing
         <SPAN
CLASS="INTERFACE"
>Panels</SPAN
> and applets and for changing
         the configuration.
        </P
></DD
><DT
>About</DT
><DD
><P
>         The <B
CLASS="GUIMENUITEM"
>About...</B
> menu item brings up a 
         dialogue box containing various information about the applet,
         typically including the applet's  name, version, author,
         copyright, license and desciption. 
        </P
></DD
><DT
>Help</DT
><DD
><P
>         The <B
CLASS="GUIMENUITEM"
>Help</B
> menu item brings up the help
         manual for the applet. 
        </P
></DD
></DL
></DIV
>
    </P
></DIV
><DIV
CLASS="SECT3"
><H3
CLASS="SECT3"
><A
NAME="TASKLIST-APPLET-BUGS"
>Known Bugs and Limitations</A
></H3
><P
>     There are no known bugs in the
     <TT
CLASS="APPLICATION"
>Tasklist</TT
> applet. 
    </P
></DIV
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="GKBAPPLET"
>GNOME KeyBoard Applet</A
></H2
><P
>   <TT
CLASS="APPLICATION"
>GNOME KeyBoard Applet</TT
>, shown with its
   default configuration in <A
HREF="utility-applets.html#GKBAPPLET-FIG"
>Figure 77</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="./figs/gkb_applet.png"></P
><P
><B
>Figure 77. GNOME KeyBoard Applet</B
></P
></DIV
><DIV
CLASS="SECT3"
><H3
CLASS="SECT3"
><A
NAME="GKB-USAGE"
>Usage</A
></H3
><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="utility-applets.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="SECT3"
><H3
CLASS="SECT3"
><A
NAME="GKBAPPLET-PREFS"
>Customization</A
></H3
><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="utility-applets.html#GKBAPPLET-SETTINGS-FIG"
>Figure 78</A
>), which allows you to
      add, configure, and remove keymaps.
    </P
><DIV
CLASS="FIGURE"
><A
NAME="GKBAPPLET-SETTINGS-FIG"
></A
><P
><IMG
SRC="./figs/gkb_applet_settings.png"></P
><P
><B
>Figure 78. 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="utility-applets.html#GKBAPPLET-SETTINGS-FIG"
>Figure 78</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="SECT3"
><H3
CLASS="SECT3"
><A
NAME="GKB-BUGS"
>Known Bugs and Limitations</A
></H3
><P
>    The sequence that the keymap tabs appear is not preserved after
    you close the <SPAN
CLASS="INTERFACE"
>Preferences Dialog</SPAN
>.
   </P
></DIV
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="GWEATHER"
>GNOME Weather Applet</A
></H2
><P
>   <TT
CLASS="APPLICATION"
>GNOME Weather</TT
> applet, shown in <A
HREF="utility-applets.html#GWEATHERAPPLET-FIG"
>Figure 79</A
>, retrieves and displays various
   weather information. 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"
>GNOME Weather</B
>.
  </P
><DIV
CLASS="FIGURE"
><A
NAME="GWEATHERAPPLET-FIG"
></A
><P
><IMG
SRC="./figs/gweather_applet.png"></P
><P
><B
>Figure 79. GNOME Weather Applet</B
></P
></DIV
><DIV
CLASS="SECT3"
><H3
CLASS="SECT3"
><A
NAME="GWEATHER-USAGE"
>Usage</A
></H3
><P
>    <TT
CLASS="APPLICATION"
>GNOME Weather</TT
> displays the current
    temperature and weather conditions in numeric and iconified form
    inside the applet.  For further information, double-click on the
    applet. This will open up the <SPAN
CLASS="INTERFACE"
>Weather Information
    Window</SPAN
>, shown in <A
HREF="utility-applets.html#GWEATHER-WEATHER-FIG"
>Figure 80</A
>. This displays the current weather
    information and either a one-day or five-day forecast.
   </P
><DIV
CLASS="FIGURE"
><A
NAME="GWEATHER-WEATHER-FIG"
></A
><P
><IMG
SRC="./figs/gweather_weather.png"></P
><P
><B
>Figure 80. Weather Information Window</B
></P
></DIV
><P
>    Right-clicking on the applet brings up a menu containing the
    following items:
    <P
></P
><UL
><LI
><P
>       <B
CLASS="GUIMENUITEM"
>Update</B
> &#8212;
       refreshes the weather information and display.
      </P
></LI
><LI
><P
>       <B
CLASS="GUIMENUITEM"
>Properties&#8230;</B
> &#8212;
       opens the <A
HREF="utility-applets.html#GWEATHER-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 Weather
       Applet</TT
>, inluding the applet's version and the
       author's name.
      </P
></LI
></UL
>
   </P
></DIV
><DIV
CLASS="SECT3"
><H3
CLASS="SECT3"
><A
NAME="GWEATHER-PREFS"
>Customization</A
></H3
><P
>      You can customize <TT
CLASS="APPLICATION"
>GNOME Weather</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="utility-applets.html#GWEATHER-SETTINGS-FIG"
>Figure 81</A
>), which allows you to
      change various settings.
    </P
><DIV
CLASS="FIGURE"
><A
NAME="GWEATHER-SETTINGS-FIG"
></A
><P
><IMG
SRC="./figs/gweather_settings.png"></P
><P
><B
>Figure 81. Properties dialog</B
></P
></DIV
><P
>     The properties in the <TT
CLASS="GUILABEL"
><B
>Basic</B
></TT
> tab are:
     <P
></P
><UL
><LI
><P
>        Update Interval &#8212; This option determines how often
        <TT
CLASS="APPLICATION"
>GNOME Weather</TT
> will connect 
        to the server(s) and retrieve weather information. Current
        conditions, forecast and radar map (if enabled) will be
        downloaded
       </P
><DIV
CLASS="NOTE"
><P
></P
><TABLE
CLASS="NOTE"
WIDTH="90%"
BORDER="0"
><TR
><TD
WIDTH="25"
ALIGN="CENTER"
VALIGN="TOP"
><IMG
SRC="./stylesheet-images/note.gif"
HSPACE="5"
ALT="Note"></TD
><TH
ALIGN="LEFT"
VALIGN="CENTER"
><B
>NOTE</B
></TH
></TR
><TR
><TD
>&nbsp;</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
><P
>         Note that the <TT
CLASS="GUILABEL"
><B
>Update Interval</B
></TT
> only
         determines how often your computer downloads information from
         the server(s).  The update time shown in the
         <SPAN
CLASS="INTERFACE"
>Current Conditions</SPAN
> tab (viewed by
         double-clicking on the applet) indicates when those
         measurements were  renewed on the server, rather than when
         they were last retrieved.
        </P
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="NOTE"
><P
></P
><TABLE
CLASS="NOTE"
WIDTH="90%"
BORDER="0"
><TR
><TD
WIDTH="25"
ALIGN="CENTER"
VALIGN="TOP"
><IMG
SRC="./stylesheet-images/note.gif"
HSPACE="5"
ALT="Note"></TD
><TH
ALIGN="LEFT"
VALIGN="CENTER"
><B
>NOTE</B
></TH
></TR
><TR
><TD
>&nbsp;</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
><P
>         You can disable automatic updates by unchecking the
         <TT
CLASS="GUILABEL"
><B
>Update enabled</B
></TT
> box.  On the other hand, you can
         also force <TT
CLASS="APPLICATION"
>GNOME Weather</TT
> to
         perform an update by choosing the corresponding option in the
         popup menu.  These two options are very useful if you have an
         intermitant internet connection, such as a laptop or modem
         provides.  
        </P
></TD
></TR
></TABLE
></DIV
></LI
><LI
><P
>        Update enabled &#8212; Select this if you would like
        <TT
CLASS="APPLICATION"
>GNOME Weather</TT
> to automatically
        download the latest weather information at the time interval
        specified by <TT
CLASS="GUILABEL"
><B
>Update</B
></TT
>.  Deselect this if
        you would only like weather updates to be done manually, by
        right-clicking on the applet and selecting
        <B
CLASS="GUIMENUITEM"
>Update</B
>.
       </P
></LI
><LI
><P
>        Use metric &#8212; By default <TT
CLASS="APPLICATION"
>GNOME
        Weather</TT
> uses the imperial system of
        units. Select this box to use metric units. The units used are shown in
        <A
HREF="utility-applets.html#TAB-UNITS"
>Table 1</A
>.
       </P
><DIV
CLASS="TABLE"
><A
NAME="TAB-UNITS"
></A
><P
><B
>Table 1. Measurement Units</B
></P
><TABLE
BORDER="1"
BGCOLOR="#E0E0E0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><THEAD
><TR
><TH
ALIGN="LEFT"
VALIGN="TOP"
>Quantity</TH
><TH
ALIGN="LEFT"
VALIGN="TOP"
>Metric</TH
><TH
ALIGN="LEFT"
VALIGN="TOP"
>Imperial</TH
></TR
></THEAD
><TBODY
><TR
><TD
ALIGN="LEFT"
VALIGN="TOP"
>Temperature</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
>deg Celsius</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
>deg Farenheit</TD
></TR
><TR
><TD
ALIGN="LEFT"
VALIGN="TOP"
>Windspeed</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
>km/h</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
>mph</TD
></TR
><TR
><TD
ALIGN="LEFT"
VALIGN="TOP"
>Pressure</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
>mmHg</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
>inHg</TD
></TR
><TR
><TD
ALIGN="LEFT"
VALIGN="TOP"
>Visibility</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
>km</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
>miles</TD
></TR
></TBODY
></TABLE
></DIV
></LI
><LI
><P
>        Detailed Forecast &#8212; Select this if you would like
        <TT
CLASS="APPLICATION"
>GNOME Weather</TT
> to retrieve the
        full five day forecast for your particular area. Note that
        these forecasts may not be
        available for some locations. 
       </P
><P
>        The forecast retrieved when this
        button is not selected is a brief
        forecast for the broader area containing the selected location
        (usually the entire state) and typically is a 5-day forecast. 
       </P
><DIV
CLASS="NOTE"
><P
></P
><TABLE
CLASS="NOTE"
WIDTH="90%"
BORDER="0"
><TR
><TD
WIDTH="25"
ALIGN="CENTER"
VALIGN="TOP"
><IMG
SRC="./stylesheet-images/note.gif"
HSPACE="5"
ALT="Note"></TD
><TH
ALIGN="LEFT"
VALIGN="CENTER"
><B
>NOTE</B
></TH
></TR
><TR
><TD
>&nbsp;</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
><P
>         Note that the detailed forecasts downloaded from IWIN are
         available only for US cities. 
        </P
></TD
></TR
></TABLE
></DIV
></LI
></UL
>
    </P
><P
>     The properties in the <TT
CLASS="GUILABEL"
><B
>Network</B
></TT
> tab should be
     used if your computer is located behind a firewall.  These
     properties are:
     <P
></P
><UL
><LI
><P
>        Use proxy &#8212; Select this button if your computer is
        behind a firewall and you must use an HTTP proxy to access the
        Web.
       </P
></LI
><LI
><P
>        Proxy host &#8212; Enter your proxy host IP address here (if
        you are using a HTTP proxy).
       </P
></LI
><LI
><P
>        Username &#8212; Enter your username here.
       </P
></LI
><LI
><P
>        Password &#8212; Enter your password here. (Note that this
        password will be saved in a private configuration file but
        will not be encrypted.)
       </P
></LI
></UL
>
    </P
><P
>     The <TT
CLASS="GUILABEL"
><B
>Location</B
></TT
> tab allows you to specify the
     geographic location that you would like <TT
CLASS="APPLICATION"
>GNOME
     Weather</TT
> applet to display the weather information
     for. Click on any plus (+) symbol to expand the tree or any minus
     (-) symbol to collapse a tree branch.  Select the city or region
     by clicking with the first mouse button.
    </P
><P
>     Locations are organized in a three-level hierarchy.  The top
     level contains broader geographical areas, the second contains
     sub-regions of these areas and the last contains the particular
     locations.  This hierarchy is essentially based on the way
     information is organized in the US NWS (National Weather
     Service), and that is the reason that the US and Canada appear on
     the topmost level.
    </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"
>Cancel</B
> button.
    </P
></DIV
><DIV
CLASS="SECT3"
><H3
CLASS="SECT3"
><A
NAME="GWEATHER-FURTHERINFO"
>Further Information</A
></H3
><P
>    <TT
CLASS="APPLICATION"
>GNOME Weather</TT
> has a homepage at <A
HREF="http://gweather.dhs.org/"
TARGET="_top"
>http://gweather.dhs.org/</A
>.
    Here you can find the latest <A
HREF="http://gweather.dhs.org/Locations"
TARGET="_top"
>Locations</A
> file,
    which is periodically updated with new cities, as sent in by
    users.  If your city is not included in the distribution, please
    send an email to Spiros Papadimitriou
    (<TT
CLASS="EMAIL"
>&#60;<A
HREF="mailto:spapadim+@cs.cmu.edu"
>spapadim+@cs.cmu.edu</A
>&#62;</TT
>)  with the necessary
    information and it will be included in the next release.
   </P
><P
>    You may also want to visit the homepage if you are curious to see
    <A
HREF="http://gweather.dhs.org/news.html"
TARGET="_top"
>what's new</A
>.
   </P
></DIV
><DIV
CLASS="SECT3"
><H3
CLASS="SECT3"
><A
NAME="GWEATHER-BUGS"
>Known Bugs and Limitations</A
></H3
><DIV
CLASS="SECT4"
><H4
CLASS="SECT4"
><A
NAME="BLOCKING-IO"
>Blocking Input/Output</A
></H4
><P
>     Even though <TT
CLASS="APPLICATION"
>GNOME Weather</TT
> now uses
     non-blocking I/O to retrieve data from the network, there are
     still some steps that block execution.  Most notably,
     establishing a TCP connection to remote hosts is a blocking
     operation.  Because the NWS and IWIN web servers are often
     heavily loaded, this step may take a significant amount of time.
     While that happens, the application is unable to respond to CORBA
     requests from the <SPAN
CLASS="INTERFACE"
>Panel</SPAN
>.  In its current
     implementation, the <SPAN
CLASS="INTERFACE"
>Panel</SPAN
> iterates through
     all applications and sends frequent CORBA requests (eg. for
     saving state).  If an applet cannot respond for any reason, then
     the <SPAN
CLASS="INTERFACE"
>Panel</SPAN
> will block waiting for a
     response.
    </P
><P
>     While the <SPAN
CLASS="INTERFACE"
>Panel</SPAN
> is blocked, it will not
     respond to any user (or application) requests.  For instance,
     <SPAN
CLASS="INTERFACE"
>Panel</SPAN
> movement and
     <SPAN
CLASS="INTERFACE"
>Panel</SPAN
> menus (the ones that appear upon a
     right click) will not work.  However, other applets in the
     <SPAN
CLASS="INTERFACE"
>Panel</SPAN
> should work (unless they have made a
     CORBA request to the <SPAN
CLASS="INTERFACE"
>Panel</SPAN
>, eg. for
     querying <SPAN
CLASS="INTERFACE"
>Panel</SPAN
> size).  As soon as the
     blocking operation in <TT
CLASS="APPLICATION"
>GNOME Weather</TT
>
     completes, things should return to normal (and user interface
     requests that were buffered will be executed).
    </P
><P
>     There is an experimental version of <TT
CLASS="APPLICATION"
>GNOME
     Weather</TT
> that uses a separate thread for HTTP
     processing, which may be incorporated  (temporarily) in the next
     release.  However, the final solution is
     <TT
CLASS="APPLICATION"
>gnome-vfs</TT
> which will  be part of GNOME
     2.0 and will offer cross-platform support for fully asynchronous
     I/O.
    </P
></DIV
></DIV
><DIV
CLASS="SECT3"
><H3
CLASS="SECT3"
><A
NAME="GWEATHER-FAQ"
>Frequently Asked Questions</A
></H3
><P
>    This is a list of frequently asked questions about
    <TT
CLASS="APPLICATION"
>GNOME Weather</TT
>.  For further information
    and updates, please visit the <A
HREF="http://gweather.dhs.org/"
TARGET="_top"
>GNOME Weather homepage</A
>.  If
    your question is still unresolved, you can email the author at
    <TT
CLASS="EMAIL"
>&#60;<A
HREF="mailto:spapadim+gweather@cs.cmu.edu"
>spapadim+gweather@cs.cmu.edu</A
>&#62;</TT
>.
   </P
><DIV
CLASS="SECT4"
><H4
CLASS="SECT4"
><A
NAME="AEN7547"
>Why does GNOME Weather freezes my Panel?</A
></H4
><P
>     This is due to the blocking nature of certain network operations
     (see also <A
HREF="utility-applets.html#BLOCKING-IO"
>the section called <I
>Blocking Input/Output</I
></A
>) and due to the way the
     <SPAN
CLASS="INTERFACE"
>Panel</SPAN
> currently works.
    </P
></DIV
><DIV
CLASS="SECT4"
><H4
CLASS="SECT4"
><A
NAME="AEN7552"
>Why does location list appears empty?</A
></H4
><P
>     This is probably because the <TT
CLASS="FILENAME"
>Locations</TT
> file
     was not installed in the proper place.  This is usually because
     <TT
CLASS="APPLICATION"
>GNOME Weather</TT
> and GNOME were not
     configured in the same way.  The file containing the locations
     must be installed in the <TT
CLASS="FILENAME"
>gweather</TT
>
     subdirectory, under the gnome data directory.  You can find out
     the latter with the <TT
CLASS="USERINPUT"
><B
>gnome-config --datadir</B
></TT
>
     command.
    </P
><P
>     If you have compiled gnome-applets yourself, make sure that you
     have used <TT
CLASS="USERINPUT"
><B
>configure --prefix=`gnome-config --prefix`
     --sysconfdir=`gnome-config --sysconfdir`</B
></TT
>.  Binary
     RPMs assume a that the prefix and sysconfdir are
     <TT
CLASS="FILENAME"
>/usr</TT
> and <TT
CLASS="FILENAME"
>/etc</TT
>,
     respectively.  If you have compiled GNOME yourself with different
     options, you need to download and compile gnome-applets yourself.
    </P
></DIV
><DIV
CLASS="SECT4"
><H4
CLASS="SECT4"
><A
NAME="AEN7563"
>Why does GNOME Weather display a question mark and dashes
     for current conditions?</A
></H4
><P
>     This will happen if <TT
CLASS="APPLICATION"
>GNOME Weather</TT
>
     cannot access the NWS server for  any reason.  This may be
     because your network  connection is down, or the NWS server is
     down, or maybe the NWS server does not currently have any
     information about your location.
    </P
></DIV
><DIV
CLASS="SECT4"
><H4
CLASS="SECT4"
><A
NAME="AEN7567"
>Why does GNOME Weather say that a forecast is not
     available?</A
></H4
><P
>     If you have enabled detailed forecasts, then it is possible that
     one may not be available for your location.  In this case, try
     disabling detailed forecasts.
    </P
><P
>     Another possible reason is that the IWIN server is down and
     <TT
CLASS="APPLICATION"
>GNOME Weather</TT
> cannot retrieve forecast
     information.  The problem should go away as soon as the IWIN
     server is up  again.
    </P
></DIV
></DIV
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="QUICKLAUNCH"
>QuickLaunch Applet</A
></H2
><P
>   <TT
CLASS="APPLICATION"
>QuickLaunch</TT
> is an applet
   which holds application launchers.  It shrinks the launcher icons
   to their smallest size to save room on your panel.  The example
   <TT
CLASS="APPLICATION"
>QuickLaunch Applet</TT
> shown in <A
HREF="utility-applets.html#QUICKLAUNCHAPPLET-FIG"
>Figure 82</A
> contains eight GNOME
   application launchers in a standard-sized <SPAN
CLASS="INTERFACE"
>Panel</SPAN
>.
   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"
>QuickLaunch</B
>.
  </P
><DIV
CLASS="FIGURE"
><A
NAME="QUICKLAUNCHAPPLET-FIG"
></A
><P
><IMG
SRC="./figs/quicklaunch_applet.png"></P
><P
><B
>Figure 82. QuickLaunch Applet</B
></P
></DIV
><DIV
CLASS="SECT3"
><H3
CLASS="SECT3"
><A
NAME="QUICKLAUNCHAPPLET-USAGE"
>Usage</A
></H3
><P
>    To add a launcher to the <TT
CLASS="APPLICATION"
>QuickLaunch</TT
>
    applet, just drag it from its current position (either on a
    <SPAN
CLASS="INTERFACE"
>Panel</SPAN
> or in the <B
CLASS="GUIMENU"
>Main
    Menu</B
>) onto the <TT
CLASS="APPLICATION"
>QuickLaunch</TT
>
    applet using the left mouse button.
    To remove a launcher from the
    <TT
CLASS="APPLICATION"
>QuickLaunch</TT
> applet, just right-click on 
    the launcher and select <TT
CLASS="GUILABEL"
><B
>Delete launcher</B
></TT
>.  To
    configure the properties of a launcher which is in your
    <TT
CLASS="APPLICATION"
>QuickLaunch</TT
> applet, right-click on the
    launcher and select <TT
CLASS="GUILABEL"
><B
>Launcher
    Properties&#8230;</B
></TT
>. 
   </P
><P
>    The vertical bar at the left edge of the applet is used for
    easily moving the applet in your <SPAN
CLASS="INTERFACE"
>Panel</SPAN
>.
    Grab the applet by depressing the left or center mouse button and
    then move the applet, releasing the mouse button when finished.
    This vertical bar is also used to access the applet menu items by
    right-clicking on this bar.
   </P
><P
>    Right-clicking on the vertical bar on the left side of the applet
    brings up a menu containing the following items:
    <P
></P
><UL
><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"
>APPLET
       Applet</TT
>, inluding the applet's version and the
       author's name.
      </P
></LI
></UL
>
   </P
></DIV
><DIV
CLASS="SECT3"
><H3
CLASS="SECT3"
><A
NAME="QUICKLAUNCH-BUGS"
>Known Bugs and Limitations</A
></H3
><P
>    It is not possible to re-arrange launchers inside the
    <TT
CLASS="APPLICATION"
>QuickLaunch</TT
> applet.  It is also not
    possible to have multiple <TT
CLASS="APPLICATION"
>QuickLaunch</TT
>
    applets with different contents.
   </P
></DIV
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="TICKASTAT"
>Tick-a-Stat Applet</A
></H2
><P
>   <TT
CLASS="APPLICATION"
>Tick-a-Stat</TT
> applet, shown in <A
HREF="utility-applets.html#TICKASTAT-APPLET-FIG"
>Figure 83</A
>, watches various aspects of your
   system and delivers information when certain events occur.  For
   example, it can watch the CPU load and warn you when the CPU is
   being overloaded with concurrent processes.  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"
>Tick-a-Stat</B
>.
  </P
><DIV
CLASS="FIGURE"
><A
NAME="TICKASTAT-APPLET-FIG"
></A
><P
><IMG
SRC="./figs/tickastat_applet.png"></P
><P
><B
>Figure 83. Tick-a-Stat Applet</B
></P
></DIV
><DIV
CLASS="SECT3"
><H3
CLASS="SECT3"
><A
NAME="TICKASTAT-USAGE"
>Usage</A
></H3
><P
>    After you have configured <TT
CLASS="APPLICATION"
>Tick-a-Stat</TT
>,
    it will run continuously and does not require any input.
    General configuration of <TT
CLASS="APPLICATION"
>Tick-a-Stat</TT
> is
    explained in <A
HREF="utility-applets.html#TICKASTAT-PREFS"
>the section called <I
>Customization</I
></A
>.  There are several
    modules which can be used.  Their function and configuration is
    described in <A
HREF="utility-applets.html#TICKASTAT-MODULES"
>the section called <I
>Modules</I
></A
>.
   </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="utility-applets.html#TICKASTAT-PREFS"
>       <TT
CLASS="GUILABEL"
><B
>Properties</B
></TT
></A
> dialog.
      </P
></LI
><LI
><P
>       <B
CLASS="GUIMENUITEM"
>Event Log&#8230;</B
> &#8212;
       opens the <A
HREF="utility-applets.html#TICKASTAT-EVENTLOG"
>       <TT
CLASS="GUILABEL"
><B
>Event Log</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"
>Tick-a-Stat
       Applet</TT
>, inluding the applet's version and the
       author's name.
      </P
></LI
></UL
>
   </P
></DIV
><DIV
CLASS="SECT3"
><H3
CLASS="SECT3"
><A
NAME="TICKASTAT-PREFS"
>Customization</A
></H3
><P
>      You can customize <TT
CLASS="APPLICATION"
>Tick-a-Stat</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="utility-applets.html#TICKASTAT-SETTINGS-FIG"
>Figure 84</A
>), which allows you to
      change various settings.
    </P
><DIV
CLASS="FIGURE"
><A
NAME="TICKASTAT-SETTINGS-FIG"
></A
><P
><IMG
SRC="./figs/tickastat_settings.png"></P
><P
><B
>Figure 84. Properties dialog</B
></P
></DIV
><P
>     The <TT
CLASS="GUILABEL"
><B
>Modules</B
></TT
> tab lists the various modules
     you can enable.  Select a module from <TT
CLASS="GUILABEL"
><B
>Module</B
></TT
>
     list on the left to configure it in the pane on the right.  Each
     module and its configurable properties are described in <A
HREF="utility-applets.html#TICKASTAT-MODULES"
>the section called <I
>Modules</I
></A
>. 
    </P
><P
>     The properties in the <TT
CLASS="GUILABEL"
><B
>General</B
></TT
> tab are:
     <P
></P
><UL
><LI
><P
>        Enable logging of events &#8212; If this button is
        checked, a log of each event detected by an enabled module
        will be written to the file named in the <TT
CLASS="GUILABEL"
><B
>Log
        path</B
></TT
> entry.
       </P
></LI
><LI
><P
>        Log Path &#8212; This is name of the file which will be used
        to store the event log.
       </P
></LI
></UL
>
    </P
><P
>     The properties in the <TT
CLASS="GUILABEL"
><B
>Display</B
></TT
> tab are:
     <P
></P
><UL
><LI
><P
>        Smooth scroll &#8212; Selecting this button causes old events
        to slowly scroll upwards when new events occur, instead of
        quickly moving up to make room.
       </P
></LI
><LI
><P
>        Smooth type &#8212; Selecting this button causes new text to
        be slowly typed across the applet as if somebody is typing it,
        instead of appearing very quickly.
       </P
></LI
><LI
><P
>        Delay when wrapping text &#8212; This is the time delay (in
        tenths of a second) that it pauses when it wraps a message
        around the right edge of the applet (ie. for a carriage return).
       </P
></LI
><LI
><P
>        Scroll speed between lines (Smooth scroll) &#8212; This is the
        speed at which lines are scrolled upwards.
       </P
></LI
><LI
><P
>        Width &#8212; This is the width(in pixels) of the applet.
       </P
></LI
><LI
><P
>        Use all room on panel &#8212; Selecting this button expands
        the applet along the <SPAN
CLASS="INTERFACE"
>Panel</SPAN
> to fill all
        space (up to any neighboring Panel objects if they exist.)
       </P
></LI
><LI
><P
>        Height &#8212; This is the height(in pixels) of the applet.
       </P
></LI
><LI
><P
>        Use panel size hint &#8212; Selecting this button causes the
        applet to try to size itself to fit the
        <SPAN
CLASS="INTERFACE"
>Panel</SPAN
> height.
       </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"
>Cancel</B
> button.
    </P
></DIV
><DIV
CLASS="SECT3"
><H3
CLASS="SECT3"
><A
NAME="TICKASTAT-MODULES"
>Modules</A
></H3
><P
>     <TT
CLASS="APPLICATION"
>Tick-a-Stat</TT
> has several modules.
     Each module watches a certain part of your system and responds
     to different evens. Multiple modules can be run enabled at once.
     The standard <TT
CLASS="APPLICATION"
>Tick-a-Stat</TT
> modules are
     described below.
    </P
><DIV
CLASS="SECT4"
><H4
CLASS="SECT4"
><A
NAME="TICKASTAT-TESTMODULE"
>Test Module</A
></H4
><P
>      The Test module is a simple module that just prints
      <SPAN
CLASS="QUOTE"
>"Testing line from test module :)"</SPAN
> in the applet
      every few seconds.
     </P
></DIV
><DIV
CLASS="SECT4"
><H4
CLASS="SECT4"
><A
NAME="TICKASTAT-COREDUMPMODULE"
>Core Dump Catcher Module</A
></H4
><P
>	    The Dump Monitor module monitors a certain path for core dumps.
	    If it finds one, it time stamps it and logs the backtrace. It also
	    displays a core dump logo and message in the main applet, as
	    shown in <A
HREF="utility-applets.html#TICKASTAT-COREDUMP-FIG"
>Figure 85</A
> and optionally
	      will open a dialog displaying the backtrace.
	  </P
><DIV
CLASS="FIGURE"
><A
NAME="TICKASTAT-COREDUMP-FIG"
></A
><P
><IMG
SRC="./figs/tickastat_coredump.png"></P
><P
><B
>Figure 85. Tick-a-Stat Showing a Core Dump</B
></P
></DIV
><P
>	    The Core Dump module settings are:
	    <P
></P
><UL
><LI
><P
>		  Enable this module &#8212; Selecting this button activates the
		  module.
		</P
></LI
><LI
><P
>		  Show backtrace dialog on new core files &#8212; Selecting this
		  button will cause <TT
CLASS="APPLICATION"
>Tick-a-Stat</TT
> to
		  open a dialog showing the backtrace each time a new core dump
		  is found.
		</P
></LI
><LI
><P
>		  Path to monitor &#8212; Enter the name of the directory you
		  would like the Core Dump module to monitor for core dumps. 
		</P
></LI
></UL
>
	  </P
></DIV
><DIV
CLASS="SECT4"
><H4
CLASS="SECT4"
><A
NAME="TICKASTAT-LOADMONITORMODULE"
>Load Average Monitor Module</A
></H4
><P
>	    The Load Average Monitor module monitors the systems CPU usage
	    and warns you when the number of processes(programs) sharing the
	    CPU is too high.  (This will cause poor performance of each
	    process and can be indicative of an errant program or daemon.) 
	    When the CPU load is high it will display a warning, as shown in
	    <A
HREF="utility-applets.html#TICKASTAT-LOADMONITOR-FIG"
>Figure 86</A
>. For even higher
	      loads, an alert is displayed.
	  </P
><DIV
CLASS="FIGURE"
><A
NAME="TICKASTAT-LOADMONITOR-FIG"
></A
><P
><IMG
SRC="./figs/tickastat_loadaverage.png"></P
><P
><B
>Figure 86. Tick-a-Stat Showing a Load Warning</B
></P
></DIV
><P
>	    The Load Average Monitor module settings are:
	    <P
></P
><UL
><LI
><P
>		  Enable this module &#8212; Selecting this button activates the
		  module.
		</P
></LI
><LI
><P
>		  Check every (Seconds) &#8212; Set this to the interval (in
		  seconds) between checking the load.
		</P
></LI
><LI
><P
>		  Show pop-up dialog for this event &#8212; Select this button
		  to have a pop-up dialog open each time a warning (or alert)
		  is issued.  (This option occurs in both the Warning and Alert
		  sections.) 
		</P
></LI
><LI
><P
>		  Load average threshold &#8212; Set this to the load (the
		  average number of running programs which request use of the
		  CPU at any instant in time). (This option occurs in both the
		  Warning and Alert sections.) 
		</P
></LI
><LI
><P
>		  Text to display &#8212; Enter the message which should be
		  displayed when the load reaches the threshold level.
		</P
></LI
></UL
>
	  </P
></DIV
><DIV
CLASS="SECT4"
><H4
CLASS="SECT4"
><A
NAME="TICKASTAT-FILETAILERMODULE"
>File Tailer Module</A
></H4
><P
>	    The File Tailer module shows any lines which are added to the
	    end of a given file.  This is typically used to monitor the
	    output log files created by many programs.
	  </P
><P
>	    The File Tailerr module settings are:
	    <P
></P
><UL
><LI
><P
>		  Enable this module &#8212; Selecting this button activates the
		  module.
		</P
></LI
><LI
><P
>		  Path to tail &#8212; Set this to the name of the file you
		  wish to tail.  (The term "tail" refers to watching the tail,
		  or end, of a file.  In a shell, one can do this using the
		  <B
CLASS="COMMAND"
>tail</B
> command, typically with the "-f"
		  flag.) 
		</P
></LI
><LI
><P
>		  Show pop-up dialog for new line &#8212; Select this
		  to have a pop-up dialog showing the new line open each time a
		  new line is added to the file.
		</P
></LI
></UL
>
	  </P
></DIV
></DIV
><DIV
CLASS="SECT3"
><H3
CLASS="SECT3"
><A
NAME="TICKASTAT-EVENTLOG"
>The Event Log</A
></H3
><P
>	  The event log is used to keep track of any events which register in
	  <TT
CLASS="APPLICATION"
>Tick-a-Stat</TT
>.  The file used for the event
	  log and whether event logging is enabled are specified in the
	  <TT
CLASS="GUILABEL"
><B
>General</B
></TT
> tab of the <A
HREF="utility-applets.html#TICKASTAT-PREFS"
> <TT
CLASS="GUILABEL"
><B
>Properties</B
></TT
></A
>
	  dialog. To view the event log, right click on the applet and select
	  <B
CLASS="GUIMENUITEM"
>Event log&#8230;</B
>.
	</P
></DIV
><DIV
CLASS="SECT3"
><H3
CLASS="SECT3"
><A
NAME="TICKASTATAPPLET-BUGS"
>Known Bugs and Limitations</A
></H3
><P
>	  This applet has no known bugs.
	</P
></DIV
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="GNOTES"
>GNOTES! Applet</A
></H2
><P
> 
    <TT
CLASS="APPLICATION"
>GNOTES!</TT
> applet, shown in <A
HREF="utility-applets.html#GNOTES-FIG"
>Figure 87</A
>, allows you to cover your 
    GNOME desktop with little, yellow, virtual sticky-notes.  To 
    learn how 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"
>GNotes!</B
>.
  </P
><DIV
CLASS="FIGURE"
><A
NAME="GNOTES-FIG"
></A
><P
><IMG
SRC="./figs/gnotes-fig.png"></P
><P
><B
>Figure 87. GNOTES!</B
></P
></DIV
><DIV
CLASS="SECT3"
><H3
CLASS="SECT3"
><A
NAME="GNOTES-USAGE"
>Usage</A
></H3
><P
>     This applet places a yellow sticky-note on your desktop. To use it,
     left-click on the <B
CLASS="GUIICON"
>GNOTES!</B
> icon to make a new
     note appear on your desktop.  After creating a new note, you may
     then left-click within  the yellow area of the note to begin
     adding text to it. 
    </P
></DIV
><DIV
CLASS="SECT3"
><H3
CLASS="SECT3"
><A
NAME="GNOTES-RIGHT-CLICK"
>Right-Click Pop-Up Menu Items</A
></H3
><P
> 
     In addition to the standard menu items, the right-click pop-up menu has 
     the following items: 
     <P
></P
><UL
><LI
><P
>        <B
CLASS="GUIMENUITEM"
>Properties&#8230;</B
> &#8212; opens
	the <A
HREF="utility-applets.html#GNOTES-PROPERTIES"
><SPAN
CLASS="INTERFACE"
> 
	Properties</SPAN
></A
> dialog which allows you to
        customize the appearance and behavior of this applet.
       </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"
>APPLET
       Applet</TT
>, inluding the applet's version and the
       author's name.
      </P
></LI
><LI
><P
>        <B
CLASS="GUIMENUITEM"
>Raise Notes</B
> &#8212; causes all your
	notes to appear above any overlapping windows.
       </P
></LI
><LI
><P
>        <B
CLASS="GUIMENUITEM"
>Lower Notes</B
> &#8212; causes all your
 	notes to be hidden below any overlapping windows.
       </P
></LI
><LI
><P
>        <B
CLASS="GUIMENUITEM"
>Hide Notes</B
> &#8212; causes all your
	notes to become hidden from view.  It does not destroy your notes.
       </P
></LI
><LI
><P
>        <B
CLASS="GUIMENUITEM"
>Show Notes</B
> &#8212; brings your
	notes back into view if you used the 
	<B
CLASS="GUIMENUITEM"
>Hide Notes</B
> menu command.
       </P
></LI
></UL
>
    </P
></DIV
><DIV
CLASS="SECT3"
><H3
CLASS="SECT3"
><A
NAME="INDIVIDUAL-NOTE-RIGHT-CLICK"
>Right-Clicking on the Left Border of Individual Notes</A
></H3
><P
> 
     You may also right-click on the left border of each of the notes on your
     desktop to change their individual properties.

    <P
></P
><UL
><LI
><P
>        <B
CLASS="GUIMENUITEM"
>Raise Note</B
> &#8212; This menu
        item causes your note to appear above any overlapping windows. 
       </P
></LI
><LI
><P
>        <B
CLASS="GUIMENUITEM"
>Lower Note</B
> &#8212; This
        menu item causes your note to be placed below any overlapping
	windows.
       </P
></LI
><LI
><P
>        <B
CLASS="GUIMENUITEM"
>Hide Note</B
> &#8212; This menu
        item causes your note to become hidden from view.  It does
	not destroy your note.
       </P
></LI
><LI
><P
>        <B
CLASS="GUIMENUITEM"
>Destroy Note</B
> &#8212; This menu
        item permanently removes your note from the desktop. Unlike
	<B
CLASS="GUIMENUITEM"
>Hide Notes</B
>, you may not recover
	your note.
       </P
></LI
></UL
>
    </P
></DIV
><DIV
CLASS="SECT3"
><H3
CLASS="SECT3"
><A
NAME="GNOTES-PROPERTIES"
>Properties</A
></H3
><P
>     You can configure <TT
CLASS="APPLICATION"
>GNOTES!</TT
> applet by
     right-clicking on the applet and choosing the
     <B
CLASS="GUIMENUITEM"
>Properties...</B
> menu item. This will open the
     <SPAN
CLASS="INTERFACE"
>Properties</SPAN
> dialog, shown in 
     <A
HREF="utility-applets.html#GNOTES-PROPERTIES-FIG"
>Figure 2</A
>.
    </P
><DIV
CLASS="FIGURE"
><A
NAME="GNOTES-PROPERTIES-FIG"
></A
><P
><IMG
SRC="./figs/gnotes-properties.png"></P
><P
><B
>Figure 88. Properties Dialog</B
></P
></DIV
><P
> 
     To change the default size at which your notes appear on the desktop, you
     may either click on the <B
CLASS="GUIBUTTON"
>up</B
> and
     <B
CLASS="GUIBUTTON"
>down</B
> arrows, or type values (in pixels) directly 
     into the fields next to the <TT
CLASS="GUILABEL"
><B
>Default Height</B
></TT
> and
     <TT
CLASS="GUILABEL"
><B
>Default Width</B
></TT
> labels.
    </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"
>Cancel</B
> button.
    </P
></DIV
><DIV
CLASS="SECT3"
><H3
CLASS="SECT3"
><A
NAME="GNOTES-BUGS"
>Known Bugs and Limitations</A
></H3
><P
>     Setting the <TT
CLASS="GUILABEL"
><B
>Default Height</B
></TT
> or <TT
CLASS="GUILABEL"
><B
>Default
     Width</B
></TT
> may cause the <TT
CLASS="APPLICATION"
>GNOTES</TT
> to crash.
     </P
><P
>    After first adding <TT
CLASS="APPLICATION"
>GNOTES!</TT
> to your
    <SPAN
CLASS="INTERFACE"
>Panel</SPAN
>, clicking on the first note you create may
    cause a second note to be created on your desktop.
    </P
></DIV
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="SCREENSHOOTER-APPLET"
>ScreenShooter Applet</A
></H2
><P
>     <TT
CLASS="APPLICATION"
>Screen-Shooter</TT
> is a handy little 
     screengrabber which is simple to use. It sits in your panel
     and you can click on it to take a screenshot of either the
     whole desktop or just a single window. 
   </P
><P
>     To add the applet to your <SPAN
CLASS="INTERFACE"
>panel</SPAN
>, you can
     right-click on an empty part of the <SPAN
CLASS="INTERFACE"
>panel</SPAN
> 
     and follow the sequence
    <B
CLASS="GUIMENU"
>Applets</B
>-&gt;<B
CLASS="GUISUBMENU"
>Utility</B
>-&gt;<B
CLASS="GUIMENUITEM"
>ScreenShooter</B
>.
   </P
><DIV
CLASS="SECT3"
><H3
CLASS="SECT3"
><A
NAME="SCREENSHOOTER-USAGE"
>Usage</A
></H3
><P
></P
><UL
><LI
><P
>        To take a picture of the entire <SPAN
CLASS="INTERFACE"
>desktop</SPAN
>,
        left-click on the <B
CLASS="GUIBUTTON"
>image of a monitor</B
>. This
        button is the lower of the two on a normally-sized horizontal 
        <SPAN
CLASS="INTERFACE"
>panel</SPAN
> and the right-hand button on a 
        narrow horizontal <SPAN
CLASS="INTERFACE"
>panel</SPAN
> or a vertical
        <SPAN
CLASS="INTERFACE"
>panel</SPAN
>.
      </P
></LI
><LI
><P
>        To take a picture of just one <SPAN
CLASS="INTERFACE"
>window</SPAN
>,
        left-click on the <B
CLASS="GUIBUTTON"
>image of a window</B
>.
        This button is the top one on a normally-sized horizontal 
        <SPAN
CLASS="INTERFACE"
>panel</SPAN
> and the left-hand one on a narrow
        horizontal <SPAN
CLASS="INTERFACE"
>panel</SPAN
> or a vertical
        <SPAN
CLASS="INTERFACE"
>panel</SPAN
>. The button will stay pressed in
        and the cursor will change to a cross. Move the cursor to the 
        window you want a picture of, and click in that window to select 
        it. 
      </P
></LI
></UL
><P
>       Right-clicking on the applet brings up a <B
CLASS="GUIMENU"
>menu</B
>
       containing the usual options for an applet, including a
       <B
CLASS="GUIMENUITEM"
>Properties</B
> option 
       <A
HREF="utility-applets.html#SCREENSHOOTER-PREFS"
>described below</A
>.
    </P
></DIV
><DIV
CLASS="SECT3"
><H3
CLASS="SECT3"
><A
NAME="SCREENSHOOTER-PREFS"
>Settings</A
></H3
><P
>     <TT
CLASS="APPLICATION"
>Screen-Shooter</TT
> can be configured to do
     a number of different things. To configure
     <TT
CLASS="APPLICATION"
>Screen-Shooter</TT
>, click on the applet
     with mouse button 3 (usually, right mouse button) and select
     <B
CLASS="GUIMENUITEM"
>Properties</B
> from the
     <B
CLASS="GUIMENU"
>popup</B
> menu. The
     <SPAN
CLASS="INTERFACE"
>Preferences</SPAN
> dialogue has seven sections
     described below. Five of these are visible initially: two more
     sections are available from a toggle in the first section. 
   </P
></DIV
><DIV
CLASS="SECT3"
><H3
CLASS="SECT3"
><A
NAME="SCREENSHOOTER-PREFERENCES-0"
>General Preferences</A
></H3
><P
></P
><DIV
CLASS="VARIABLELIST"
><DL
><DT
><TT
CLASS="GUILABEL"
><B
>Capture WM decorations when grabbing a window</B
></TT
></DT
><DD
><P
>         The <B
CLASS="GUIBUTTON"
>capture decorations</B
> checkbox controls 
         whether or not the <SPAN
CLASS="INTERFACE"
>titlebar</SPAN
> and edges of a 
         <SPAN
CLASS="INTERFACE"
>window</SPAN
> are included. It is only relevant
         when <TT
CLASS="APPLICATION"
>Screen-Shooter</TT
> is taking a 
         picture of a single <SPAN
CLASS="INTERFACE"
>window</SPAN
> rather than of
         the whole screen or of a rectangle you have selected. The default is 
         for this to be checked and for the <SPAN
CLASS="INTERFACE"
>titlebar</SPAN
>
         and window borders to be included in the shot.
       </P
></DD
><DT
><TT
CLASS="GUILABEL"
><B
>Give audio feedback using the keyboard bell
      </B
></TT
></DT
><DD
><P
>         The <B
CLASS="GUIBUTTON"
>audio feedback</B
> checkbox controls 
         whether or not <TT
CLASS="APPLICATION"
>Screen-Shooter</TT
> will 
         beep when it actually takes the shot. The default is to beep.
       </P
></DD
><DT
><TT
CLASS="GUILABEL"
><B
>Display spurious options</B
></TT
></DT
><DD
><P
>         The <B
CLASS="GUIBUTTON"
>spurious options</B
> checkbox controls whether
         some of <TT
CLASS="APPLICATION"
>Screen-Shooter</TT
>'s more esoteric
         options are available. The default is off (i.e., they are not
         available). Checking this option makes two sections called 
         <A
HREF="utility-applets.html#SCREENSHOOTER-PREFERENCES-5"
>Spurious 1</A
> and 
         <A
HREF="utility-applets.html#SCREENSHOOTER-PREFERENCES-6"
>Spurious 2</A
> visible
         in the preferences dialogue.
       </P
></DD
><DT
><TT
CLASS="GUILABEL"
><B
>Delay before taking shot</B
></TT
></DT
><DD
><P
>         When taking shots of the <SPAN
CLASS="INTERFACE"
>desktop</SPAN
>, you can 
         set a delay between clicking on the
         <TT
CLASS="APPLICATION"
>Screen-Shooter</TT
> and the shot being taken. 
         The delay can be up to one minute. This can be very useful when you 
         want to focus on a particular <SPAN
CLASS="INTERFACE"
>window</SPAN
> or if 
         you want to bring up a <SPAN
CLASS="INTERFACE"
>menu</SPAN
>. 
       </P
></DD
><DT
><TT
CLASS="GUILABEL"
><B
>Compression quality</B
></TT
></DT
><DD
><P
>         Compression quality does not refer to how tightly a file is
         compressed, but to how well it retains detail after
         compression. The higher the compression quality, the better
         the quality of the image, but the larger the size of the resulting 
         file. It is relevant when you are saving something as a JPEG,
         a MIFF or a PNG file. The default compression quality is 75%.
       </P
></DD
><DT
><TT
CLASS="GUILABEL"
><B
>Create monochrome image</B
></TT
></DT
><DD
><P
>         A fairly self-explanatory option: if this is selected,
         the resulting image will be in monochrome. This is off by default.
       </P
></DD
><DT
><TT
CLASS="GUILABEL"
><B
>Invert colours in image</B
></TT
></DT
><DD
><P
>         Another self-explanatory option: if this is selected, the colours 
         of the image are reversed so that white becomes black, pale purple 
         becomes greenish, and so on. Lovely -- but rarely useful! Off by 
         default.
       </P
></DD
></DL
></DIV
></DIV
><DIV
CLASS="SECT3"
><H3
CLASS="SECT3"
><A
NAME="SCREENSHOOTER-PREFERENCES-1"
>Files, Apps</A
></H3
><P
></P
><DIV
CLASS="VARIABLELIST"
><DL
><DT
><TT
CLASS="GUILABEL"
><B
>Directory to save file in</B
></TT
></DT
><DD
><P
>         The directory to save the shot in must exist already:
         <TT
CLASS="APPLICATION"
>Screen-Shooter</TT
> will not create
         it for you. If you try to save it to somewhere that does 
         not exist, then no screenshot will be taken. The default 
         directory is <TT
CLASS="FILENAME"
>~/</TT
>: your home directory.
       </P
></DD
><DT
><TT
CLASS="GUILABEL"
><B
>Filename for images</B
></TT
></DT
><DD
><P
>         <TT
CLASS="APPLICATION"
>Screen-Shooter</TT
> is designed to allow the
	 user maximum flexibility in naming each shot. The filename field
	 (as well as the directory field) is passed to a shell for normal
	 shell expansion before being used. This allows you to use the
	 output of programs, scripts or environment variables to name your
	 shots. The reason for this is to allow unique filenames.
	 By default, Screen-Shooter will create a name which is based on 
         the time and date it was taken: this of course should always be
	 unique. The default filename is 
         <TT
CLASS="FILENAME"
>`date +%Y_%m_%d_%H%M%S`_shot.jpg</TT
>.
         As you can see, the filename includes the output of the date
	 command in order to generate a datestamp.
         So it makes up a name based on the date, using the format the
         percentage symbols and letters tell it. Then it adds the rest
         of the name from outside the backticks to the date it has used.
         Explanations of the cryptic percentage symbols can be found
         in <B
CLASS="COMMAND"
>man date</B
>, but the arguments in the
         default filename are:
       </P
><P
></P
><DIV
CLASS="VARIABLELIST"
><DL
><DT
>%H</DT
><DD
><P
>The hour of the day (from 00 to 23)</P
></DD
><DT
>%M</DT
><DD
><P
>The minute of the hour (from 00 to 59)</P
></DD
><DT
>%S</DT
><DD
><P
>The second of the minute (from 00 to 60)</P
></DD
><DT
>%d</DT
><DD
><P
>The day of the month (from 01 to 31)</P
></DD
><DT
>%m</DT
><DD
><P
>The month of the year (from 01 to 12)</P
></DD
><DT
>%y</DT
><DD
><P
>The final two digits of the year</P
></DD
></DL
></DIV
><P
>         Other examples of filenames you might use are:
       </P
><P
></P
><UL
><LI
><P
><TT
CLASS="FILENAME"
>screenshot-`date +%Y%m%d-%H%M%S`.jpg</TT
></P
></LI
><LI
><P
><TT
CLASS="FILENAME"
>pic-`date +%H%M%S`.png</TT
></P
></LI
><LI
><P
><TT
CLASS="FILENAME"
>myshot.jpg</TT
></P
></LI
><LI
><P
><TT
CLASS="FILENAME"
>`my_own_script_to_create_a_filename`.jpg</TT
></P
></LI
></UL
><P
>         The filename suffix determines the filetype. Screen-Shooter
	 supports what can only be described as a ridiculous number of
	 different image formats. Try your luck. For a full list, type
	 <B
CLASS="COMMAND"
>man convert</B
>. You can even try .html to create a
	 client-side image map, and wild things like that.
       </P
><P
>         If your filename suffix is not something <TT
CLASS="APPLICATION"
>Screen-Shooter
         </TT
> recognises, or you omit one, it will save the shot as a 
         MIFF file. Use the <B
CLASS="COMMAND"
>convert</B
> utility to change the
	 format later.
	 </P
></DD
><DT
>View screenshot after saving</DT
><DD
><P
>         The <TT
CLASS="GUILABEL"
><B
>view screenshot</B
></TT
> checkbox is unchecked by 
         default. After checking it, you will get a view of the shot once it 
         has been taken. You need to specify a viewer for this: the default
         is <B
CLASS="COMMAND"
>ee</B
>, which launches the
         <TT
CLASS="APPLICATION"
>Electric Eyes</TT
> image viewing program.
       </P
></DD
></DL
></DIV
></DIV
><DIV
CLASS="SECT3"
><H3
CLASS="SECT3"
><A
NAME="SCREEN-SHOOTER-PREFERENCES-2"
>Thumbnails</A
></H3
><P
></P
><DIV
CLASS="VARIABLELIST"
><DL
><DT
><TT
CLASS="GUILABEL"
><B
>Create thumbnail of image too</B
></TT
></DT
><DD
><P
>         None of the other options on this page will have any effect
         if <B
CLASS="GUIBUTTON"
>create thumbnail</B
> is not checked. 
         By default, it is off.
       </P
></DD
><DT
><TT
CLASS="GUILABEL"
><B
>Thumbnail size</B
></TT
></DT
><DD
><P
>         This is the percentage of the original's size that the thumbnail
         will be. The default is 25%.
       </P
></DD
><DT
><TT
CLASS="GUILABEL"
><B
>Thumbnail compression</B
></TT
></DT
><DD
><P
>         This is the quality of compression to use. As with the general
         preferences, the better the quality of the compression, the more
         detail will be preserved, and the bigger the thumbnail will be.
         The default for a thumbnail is 50%.
       </P
></DD
><DT
><TT
CLASS="GUILABEL"
><B
>Prefix to attach to filename</B
></TT
></DT
><DD
><P
>        This is the prefix to attach to the thumbnail filename to distinguish
        it from the full-sized shot. If you leave this blank, the 
        thumbnail will overwrite the full-sized shot and you will lose
        the full-sized one. The default prefix is "thumb-".
      </P
></DD
><DT
><TT
CLASS="GUILABEL"
><B
>Use high-quality intermediate for 
	      generating thumbnail</B
></TT
></DT
><DD
><P
>        The <B
CLASS="GUIBUTTON"
>high-quality intermediate</B
> checkbox is off 
        by default. It generates a MIFF image whilst making the thumbnail. A 
        'lossy' file format refers to a file format where data and detail is 
        irretrievably lost, but which is typically much smaller than a 
        non-lossy format image of the same thing. The typical example of a 
        lossy file format is JPEG. 
      </P
></DD
></DL
></DIV
></DIV
><DIV
CLASS="SECT3"
><H3
CLASS="SECT3"
><A
NAME="SCREENSHOOTER-PREFERENCES-3"
>Post-Processing</A
></H3
><DIV
CLASS="NOTE"
><P
></P
><TABLE
CLASS="NOTE"
WIDTH="100%"
BORDER="0"
><TR
><TD
WIDTH="25"
ALIGN="CENTER"
VALIGN="TOP"
><IMG
SRC="./stylesheet-images/note.gif"
HSPACE="5"
ALT="Note"></TD
><TH
ALIGN="LEFT"
VALIGN="CENTER"
><B
>NOTE</B
></TH
></TR
><TR
><TD
>&nbsp;</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
><P
>       These options <I
CLASS="EMPHASIS"
>munch</I
> processing power compared
       with the options in previous sections. They work by producing an
       intermediate image of the screenshot, and then performing actions
       upon it. Once any of these options are enabled, the shot will take
       longer to complete, due to the extra processing involved.
     </P
></TD
></TR
></TABLE
></DIV
><P
></P
><DIV
CLASS="VARIABLELIST"
><DL
><DT
><TT
CLASS="GUILABEL"
><B
>Normalize image</B
></TT
></DT
><DD
><P
>        The <B
CLASS="GUIBUTTON"
>normalize image</B
> checkbox transforms the 
        image to span the full range of colour values.
        Default is off.
      </P
></DD
><DT
><TT
CLASS="GUILABEL"
><B
>Equalize image</B
></TT
></DT
><DD
><P
>         The <B
CLASS="GUIBUTTON"
>equalize image</B
> checkbox enables 
         histogram-based image equalization, which is a process which
         compensates for low contrast in an image and brings out more
         detail. Default is off.
       </P
></DD
><DT
><TT
CLASS="GUILABEL"
><B
>Enhance image</B
></TT
></DT
><DD
><P
>         The <B
CLASS="GUIBUTTON"
>enhance image</B
> checkbox tells 
         <TT
CLASS="APPLICATION"
>Screen-Shooter</TT
> to clean up
	 the image as best it can, and try to remove any noise.
	 Default is off.
       </P
></DD
><DT
><TT
CLASS="GUILABEL"
><B
>Despeckle image</B
></TT
></DT
><DD
><P
>         The <B
CLASS="GUIBUTTON"
>despeckle image</B
> checkbox reduces 
         spotting by removing single pixels which are very different in 
         colour from their surroundings. The default is off.
       </P
></DD
><DT
><TT
CLASS="GUILABEL"
><B
>Sharpen image by factor</B
></TT
></DT
><DD
><P
>         Sharpening the image sharpens the image. The default is a factor
	 of zero, but it can be raised to 100%.
       </P
></DD
><DT
><TT
CLASS="GUILABEL"
><B
>Rotate image clockwise</B
></TT
></DT
><DD
><P
>         This is how many degrees clockwise to rotate the image. The 
         default is 0: unrotated.
       </P
></DD
><DT
><TT
CLASS="GUILABEL"
><B
>Adjust gamma</B
></TT
></DT
><DD
><P
>         The <B
CLASS="GUIBUTTON"
>gamma</B
> checkbox enables you to adjust the
         gamma. The gamma value is a value to do with the intensity
         of the lightness of an image (and rather complicated). The
         range <TT
CLASS="APPLICATION"
>Screen-Shooter</TT
> provides is
         from 0.8 to 2.3 with a default of 1.6. This is not a linear
         (straight) scale so you will need to experiment. Lowering the 
         gamma produces a darker image. Raising it produces a lighter one.
       </P
></DD
></DL
></DIV
></DIV
><DIV
CLASS="SECT3"
><H3
CLASS="SECT3"
><A
NAME="SCREENSHOOTER-PREFERENCES-4"
>Frills</A
></H3
><P
></P
><DIV
CLASS="VARIABLELIST"
><DL
><DT
><TT
CLASS="GUILABEL"
><B
>Create frame around image</B
></TT
></DT
><DD
><P
>         The <B
CLASS="GUIBUTTON"
>create frame</B
> checkbox is off by default.
         Checking it produces a frame around the shot taken. This frame is
         always grey, but the author notes, <SPAN
CLASS="QUOTE"
>"if anybody requests it, I'll
         add options for setting its colour"</SPAN
>.
       </P
></DD
><DT
><TT
CLASS="GUILABEL"
><B
>Frame width</B
></TT
></DT
><DD
><P
>         This determines the size of the frame in pixels. The range
         is from one pixel to fifty. The default frame is six pixels.
       </P
></DD
><DT
><TT
CLASS="GUILABEL"
><B
>Flip image vertically</B
></TT
></DT
><DD
><P
>         This gives a vertical mirror image of the shot. It can be combined
         with the following option. The default is unchecked.
       </P
></DD
><DT
><TT
CLASS="GUILABEL"
><B
>Flip image horizontally</B
></TT
></DT
><DD
><P
>         This gives a horizontal mirror image of the shot. It can be combined 
         with the preceding option. The default is unchecked.
       </P
></DD
><DT
><TT
CLASS="GUILABEL"
><B
>Emboss image</B
></TT
></DT
><DD
><P
>         Embossing an image produces an image drained of most colour and
         drawn in relief. The default is unchecked.
       </P
></DD
><DT
><TT
CLASS="GUILABEL"
><B
>Send image and thumbnail to...</B
></TT
></DT
><DD
><P
>         By placing a script or program name in the box and checking the
         <B
CLASS="GUIBUTTON"
>send to</B
> checkbox, you can invoke that script 
         or program to be automatically run on the image and thumbnail.
         This could be used to print the image out automatically,
         to invoke a script to catalogue the files, or to add the
         pictures to a website automatically. A sample script for the
         latter is available with <TT
CLASS="APPLICATION"
>Screen-Shooter</TT
>.
       </P
></DD
></DL
></DIV
></DIV
><DIV
CLASS="SECT3"
><H3
CLASS="SECT3"
><A
NAME="SCREENSHOOTER-PREFERENCES-5"
>Spurious options: part 1</A
></H3
><DIV
CLASS="NOTE"
><P
></P
><TABLE
CLASS="NOTE"
WIDTH="100%"
BORDER="0"
><TR
><TD
WIDTH="25"
ALIGN="CENTER"
VALIGN="TOP"
><IMG
SRC="./stylesheet-images/note.gif"
HSPACE="5"
ALT="Note"></TD
><TH
ALIGN="LEFT"
VALIGN="CENTER"
><B
>NOTE</B
></TH
></TR
><TR
><TD
>&nbsp;</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
><P
>        Tom Gilbert says, <SPAN
CLASS="QUOTE"
>"These options are all just plain silly. But 
        they're fun. So I included them"</SPAN
>. They also munch processing 
        power in the same manner as the post-processing options above.
      </P
></TD
></TR
></TABLE
></DIV
><P
>      To make use of any of the options listed in this section and the
      next section, you need to have selected <B
CLASS="GUIBUTTON"
>Display spurious
      options</B
> in the <A
HREF="utility-applets.html#SCREENSHOOTER-PREFERENCES-0"
>General Preferences</A
> 
      section. They will not be available otherwise. 
    </P
><P
></P
><DIV
CLASS="VARIABLELIST"
><DL
><DT
><TT
CLASS="GUILABEL"
><B
>Blur image</B
></TT
></DT
><DD
><P
>         The <B
CLASS="GUIBUTTON"
>blur image</B
> checkbox is off by default and 
         the blur factor is set to zero. By checking the checkbox and altering
         the blur factor you can blur the image. Even at the highest
         rating (100), a typical font on a typical terminal window is
         still just about decipherable.
       </P
></DD
><DT
><TT
CLASS="GUILABEL"
><B
>Create charcoal effect</B
></TT
></DT
><DD
><P
>         The <B
CLASS="GUIBUTTON"
>charcoal</B
> checkbox is off by default and
         the charcoal factor is set to zero. Charcoaling produces a
         monochrome image with a slight smudginess which increases
         with the charcoal factor. It does not deal with highlighted
         text very well, though. The maximum factor for this is 100.
       </P
></DD
><DT
><TT
CLASS="GUILABEL"
><B
>Find edges</B
></TT
></DT
><DD
><P
>         The <B
CLASS="GUIBUTTON"
>find edges</B
> checkbox is off by default and 
         the factor is set to zero. Using it produces a monochrome image
         where, rather than highlighting areas of different colours, it
         highlights the edges and borders between areas of different
         colour. Very interesting on maps and astronomical photos. The
         maximum factor for this is 100.
       </P
></DD
><DT
><TT
CLASS="GUILABEL"
><B
>Implode image</B
></TT
></DT
><DD
><P
>         The <B
CLASS="GUIBUTTON"
>implode image</B
> checkbox is off by default 
         and the factor is set to zero. Using it warps the resulting 
         screenshot as if a weight had been pressed into the centre of the 
         shot. The maximum factor for this is 100.
       </P
></DD
></DL
></DIV
></DIV
><DIV
CLASS="SECT3"
><H3
CLASS="SECT3"
><A
NAME="SCREENSHOOTER-PREFERENCES-6"
>Spurious options: part 2</A
></H3
><P
></P
><DIV
CLASS="VARIABLELIST"
><DL
><DT
><TT
CLASS="GUILABEL"
><B
>Create painted effect</B
></TT
></DT
><DD
><P
>         The <B
CLASS="GUIBUTTON"
>painted effect</B
> checkbox is off by default 
         and the radius to paint around each pixel is set to zero. Checking 
         it with a radius of about 5 produces an effect like an Impressionist
         painting. Checking it with a radius of about 50 will eat your
         CPU cycles like mad for ten minutes on a reasonably powerful
         machine. The maximum radius is 100, but you will need either
         a large machine or a lot of patience for that.
       </P
></DD
><DT
><TT
CLASS="GUILABEL"
><B
>Solarise image</B
></TT
></DT
><DD
><P
>         The <B
CLASS="GUIBUTTON"
>solarise</B
> checkbox is off by default and 
         the factor is set to zero. Solarising is an effect first noticed 
         in developing photographs from negatives. It results in a 
         negative image with different colouring from that of the
         "inverted colours" option in the general preferences. A
         solarise factor of 5 will produce startling results, but the 
         maximum factor is 100.
       </P
></DD
><DT
><TT
CLASS="GUILABEL"
><B
>Spread image pixels</B
></TT
></DT
><DD
><P
>         The <B
CLASS="GUIBUTTON"
>spread image</B
> checkbox is off by default 
         and the factor is set to zero. The result of spreading the image
         pixels by a radius of about 5 is similar to looking through
         lightly frosted glass; for heavily-frosted glass, try 25.
         The maximum is 100.
       </P
></DD
><DT
><TT
CLASS="GUILABEL"
><B
>Swirl pixels</B
></TT
></DT
><DD
><P
>         The <B
CLASS="GUIBUTTON"
>swirl pixels</B
> checkbox is off by default 
         and the factor is set to zero. Swirling the pixels results in a
         distorted image similar to an imploded image except that it 
         swirls around the central point rather than stretching to
         it. A radius of 20 produces an effect like a fairground distorting 
         mirror, only not a mirror-image; 90 a much increased version 
         (although text is still legible); at 180 the entire image is 
         warped; and at the maximum of 360 a spiral effect is created.
       </P
></DD
></DL
></DIV
></DIV
><DIV
CLASS="SECT3"
><H3
CLASS="SECT3"
><A
NAME="SCREENSHOOTER-BUGS"
>Known bugs and limitations</A
></H3
><P
></P
><UL
><LI
><P
>       Often screenshots saved in PNG format show incorrectly in
       <TT
CLASS="APPLICATION"
>Netscape</TT
> or the <TT
CLASS="APPLICATION"
>GNOME Help 
       Browser</TT
>. This is due to bugs in Netscape and 
       and GNOME image libraries, not to bugs in 
       <TT
CLASS="APPLICATION"
>Screen-Shooter</TT
>. You can view such
       screenshots in a different image-viewing program; or you can try 
       changing image compression level in the <A
HREF="utility-applets.html#SCREENSHOOTER-PREFERENCES-0"
>Preferences dialogue box</A
>,
       which sometimes helps.
     </P
></LI
></UL
></DIV
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="WHEREAMI"
>Where Am I? Applet</A
></H2
><P
>   <TT
CLASS="APPLICATION"
>Where Am I?</TT
> applet, shown in <A
HREF="utility-applets.html#WHEREAMIAPPLET-FIG"
>Figure 89</A
>, shows the position
   of your mouse pointer on the screen, reporting the coordinates as
   <TT
CLASS="PARAMETER"
><I
>x</I
></TT
> and <TT
CLASS="PARAMETER"
><I
>y</I
></TT
>, where
   <TT
CLASS="PARAMETER"
><I
>x</I
></TT
> is horizontal and <TT
CLASS="PARAMETER"
><I
>y</I
></TT
>
   is vertical.  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"
>Where Am I?</B
>.
  </P
><DIV
CLASS="FIGURE"
><A
NAME="WHEREAMIAPPLET-FIG"
></A
><P
><IMG
SRC="./figs/whereami_applet.png"></P
><P
><B
>Figure 89. Where Am I? Applet</B
></P
></DIV
><DIV
CLASS="SECT3"
><H3
CLASS="SECT3"
><A
NAME="WHEREAMI-USAGE"
>Usage</A
></H3
><P
>    You don't need to do anything special to use this applet. It will
    report the position of your cursor as you move your mouse about.
   </P
><P
>    Right-clicking on the applet brings up a menu containing the
    following items:
    <P
></P
><UL
><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"
>Where Am I?
       Applet</TT
>, inluding the applet's version and the
       author's name.
      </P
></LI
></UL
>
   </P
></DIV
><DIV
CLASS="SECT3"
><H3
CLASS="SECT3"
><A
NAME="WHEREAMI-BUGS"
>Known Bugs and Limitations</A
></H3
><P
>    This applet has no known bugs.
   </P
></DIV
></DIV
></DIV
><DIV
CLASS="NAVFOOTER"
><HR
ALIGN="LEFT"
WIDTH="100%"><TABLE
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
><A
HREF="network-applets.html"
>&#60;&#60;&#60; Previous</A
></TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="index.html"
>Home</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
><A
HREF="clock-applets.html"
>Next &#62;&#62;&#62;</A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
>Network Applets</TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="gnome-applets.html"
>Up</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
>Clock Applets</TD
></TR
></TABLE
></DIV
></BODY
></HTML
>