<HTML
><HEAD
><TITLE
>Mail Check Applet</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.54"></HEAD
><BODY
CLASS="ARTICLE"
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#840084"
ALINK="#0000FF"
><DIV
CLASS="ARTICLE"
><DIV
CLASS="TITLEPAGE"
><H1
CLASS="TITLE"
><A
NAME="AEN2"
>Mail Check Applet</A
></H1
><P
CLASS="COPYRIGHT"
><A
HREF="ln7.html"
>Copyright</A
> &copy; 2000 by <SPAN
CLASS="HOLDER"
>Telsa Gwynne and Eric Baudais</SPAN
></P
><HR
WIDTH="75%"
ALIGN="CENTER"
COLOR="#000000"
SIZE="1"></DIV
><DIV
CLASS="TOC"
><DL
><DT
><B
>Table of Contents</B
></DT
><DT
><A
HREF="index.html#APPLETS-CORE-MAILCHECK"
>The Mail Check Applet</A
></DT
></DL
></DIV
><DIV
CLASS="SECT1"
><H1
CLASS="SECT1"
><A
NAME="APPLETS-CORE-MAILCHECK"
>The Mail Check Applet</A
></H1
><P
>    The <TT
CLASS="APPLICATION"
>mailcheck applet</TT
> is an applet which
    sits in your panel and tells you when you have new email. To add 
    this applet to the panel, right-click on the panel and choose
    <B
CLASS="GUIMENU"
>Add applet</B
>-&gt;<B
CLASS="GUISUBMENU"
>Network</B
>-&gt;<B
CLASS="GUIMENUITEM"
>Mailcheck</B
>
  </P
><DIV
CLASS="FIGURE"
><A
NAME="MAILCHECK-APPLETS-CORE-FIG"
></A
><P
><IMG
SRC="mailcheck-applet.png"></P
><P
><B
>Figure 1. Mail Check Applet</B
></P
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="MAILCHECK-USAGE"
>Usage</A
></H2
><P
>      You don't need to do anything in particular to run this applet.
      Providing it is looking in the right place for your email, it
      will run itself quite happily. The following options, however,
      are available:
    </P
><P
></P
><UL
><LI
><P
>        Clicking <SPAN
CLASS="MOUSEBUTTON"
>mouse button 1</SPAN
> does nothing
        unless you have told it to start a program when you do this. You
        do this with the properties box described <A
HREF="index.html#MAILCHECK-PREFS"
>below</A
>.
      </P
></LI
><LI
><P
>        Holding down <SPAN
CLASS="MOUSEBUTTON"
>mouse button 2</SPAN
> allows
        you to drag the applet around the panel (and between panels).
        option.
      </P
></LI
><LI
><P
>        Clicking <SPAN
CLASS="MOUSEBUTTON"
>mouse button 3</SPAN
> brings up
        the typical <B
CLASS="GUIMENU"
>applet menu</B
> which includes an
        About box and a <A
HREF="index.html#MAILCHECK-PREFS"
>properties</A
>
      </P
></LI
></UL
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="MAILCHECK-PREFS"
>Preferences</A
></H2
><P
>       The mailcheck <SPAN
CLASS="INTERFACE"
>properties dialogue box</SPAN
> is
       divided into two sections, one for what the mail check applet
       does, and one for where it checks for email.
    </P
><DIV
CLASS="FIGURE"
><A
NAME="MAILCHECK-SETTINGS-MAILCHECK-FIG"
></A
><P
><IMG
SRC="mailcheck-properties-mailcheck.png"></P
><P
><B
>Figure 2. Properties dialog &#8212; Mail check tab</B
></P
></DIV
><P
></P
><DIV
CLASS="VARIABLELIST"
><DL
><DT
>Mail check options</DT
><DD
><P
>         The mail check options have six sections:
       </P
><P
></P
><DIV
CLASS="VARIABLELIST"
><DL
><DT
>Execute...before each update</DT
><DD
><P
>            Sometimes you may want to run something such as
            <TT
CLASS="APPLICATION"
>fetchmail</TT
> before the applet 
            checks for new mail. To do this, check the checkbox and
            fill in the program name in the space here.
          </P
></DD
><DT
>Execute...when new mail arrives</DT
><DD
><P
>            Sometimes you may want other programs to run when new mail
            arrives. It is common to tell the machine to play a noise 
            at you, for example. Checking this checkbox and filling in
            the command (such as <B
CLASS="COMMAND"
>mpg123 sillynoise.mpg</B
>
            or <B
CLASS="COMMAND"
>esdplay sillynoise.wav</B
>) will let this
            happen.
          </P
></DD
><DT
>Execute...when clicked</DT
><DD
><P
>            By putting a program name (generally a mail-reader such as
            <TT
CLASS="APPLICATION"
>balsa</TT
> or <TT
CLASS="APPLICATION"
>spruce</TT
>
            here and clicking on the checkbox, you can set things up so that
            when you click <SPAN
CLASS="MOUSEBUTTON"
>button 1</SPAN
> on the 
            applet, that program will be automatically run.
          </P
></DD
><DT
>Check for mail every...</DT
><DD
><P
>            You can adjust the range for checking whether mail has arrived
            between 1440 minutes (once a day) to never. Setting it to never
            is silly and will confuse it. The default value is every two
            minutes.
          </P
></DD
><DT
>Play a sound when new mail arrives</DT
><DD
><P
>            The sound played if you check this <B
CLASS="GUIBUTTON"
>checkbox</B
>
            is an alarm bell. It is contained in
            <TT
CLASS="FILENAME"
>$prefix/sound/events/mailcheck.soundlist</TT
>;
            if you want to change it to a different sound, alter that and
            put the sound in <TT
CLASS="FILENAME"
>$prefix/sounds/</TT
>.
          </P
></DD
><DT
>Select animation</DT
><DD
><P
>            By clicking on the <TT
CLASS="GUILABEL"
><B
>box with the animation name</B
></TT
>,
            you can get a list of different pictures which have different
            animations when new email arrives.
          </P
></DD
></DL
></DIV
></DD
></DL
></DIV
><DIV
CLASS="FIGURE"
><A
NAME="MAILCHECK-SETTINGS-MAILBOX-FIG"
></A
><P
><IMG
SRC="mailcheck-properties-mailbox.png"></P
><P
><B
>Figure 3. Properties dialog &#8212; Mailbox tab</B
></P
></DIV
><P
></P
><DIV
CLASS="VARIABLELIST"
><DL
><DT
>Mailbox options</DT
><DD
><P
>         The mailbox options have four sections, some of which will be
         greyed-out.
       </P
><P
>         By clicking on the <TT
CLASS="GUILABEL"
><B
>box with the mailbox location</B
></TT
>,
         you can tell the mailcheck applet where to look for your incoming
         email.
       </P
><P
></P
><UL
><LI
><P
>           When local mailspool or local maildir are selected as the location
           for the mailbox, then you can fill in the details on which file
           or directory the applet should check for new email. You can only
           put one filename here. The section about mail servers will be
           greyed out.
          </P
></LI
><LI
><P
>           When remote POP3 or remote IMAP are selected as the location for
           the mailbox, then you can fill in the details on the mail server,
           username and password. If the you don't supply the password, the
           applet will ask for it when it first tries to check for mail.
           The section about local filenames will be greyed out.
         </P
></LI
></UL
></DD
></DL
></DIV
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="MAILCHECK-BUGS"
>Known bugs and limitations</A
></H2
><P
></P
><UL
><LI
><P
>       Setting something to be executed before each update can hang the
       applet and the panel.
     </P
></LI
><LI
><P
>       Sometimes the animation stops happening after prolonged use.
     </P
></LI
><LI
><P
>       If you use a mail filter such as <TT
CLASS="APPLICATION"
>procmail</TT
>,
       which sorts email into different folders, the applet won't check them
       all for new email. It will only look at one file.
     </P
></LI
></UL
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="AUTHORS"
>Authors</A
></H2
><P
>    <TT
CLASS="APPLICATION"
>Mail Check</TT
> was written by  
      Miguel de Icaza (<TT
CLASS="EMAIL"
>&#60;<A
HREF="mailto:miguel@gnu.org"
>miguel@gnu.org</A
>&#62;</TT
>),
      Jacob Berkman (<TT
CLASS="EMAIL"
>&#60;<A
HREF="mailto:jberkman@andrew.cmu.edu"
>jberkman@andrew.cmu.edu</A
>&#62;</TT
>),
      Jaka Mocnik (<TT
CLASS="EMAIL"
>&#60;<A
HREF="mailto:jaka.mocnik@kiss.uni-lj.si"
>jaka.mocnik@kiss.uni-lj.si</A
>&#62;</TT
>) and
      Lennart Poettering (<TT
CLASS="EMAIL"
>&#60;<A
HREF="mailto:poettering@gmx.net"
>poettering@gmx.net</A
>&#62;</TT
>).  
      Please send all comments, suggestions, and bug 
      reports to the <A
HREF="http://bugs.gnome.org"
TARGET="_top"
>GNOME
      bug tracking database</A
>. (Instructions for submitting bug
      reports can be found <A
HREF="http://bugs.gnome.org/Reporting.html"
TARGET="_top"
>      on-line</A
>. If you are using
      GNOME 1.1 or later, you can also use <TT
CLASS="APPLICATION"
>Bug Report
      Tool</TT
> (<B
CLASS="COMMAND"
>bug-buddy</B
>), available in the
      <B
CLASS="GUISUBMENU"
>Utilities</B
> submenu of <B
CLASS="GUIMENU"
>Main
      Menu</B
>, for submitting bug reports.
   </P
><P
>      This manual was written by Telsa Gwynne (<TT
CLASS="EMAIL"
>&#60;<A
HREF="mailto:telsa@linuxchix.org"
>telsa@linuxchix.org</A
>&#62;</TT
>)
      and Eric Baudais (<TT
CLASS="EMAIL"
>&#60;<A
HREF="mailto:baudais@okstate.edu"
>baudais@okstate.edu</A
>&#62;</TT
>). Please send all comments and
      suggestions regarding this manual to the <A
HREF="http://www.gnome.org/gdp"
TARGET="_top"
>GNOME Documentation Project</A
> 
      by sending an email to <TT
CLASS="EMAIL"
>&#60;<A
HREF="mailto:docs@gnome.org"
>docs@gnome.org</A
>&#62;</TT
>. You can also
      submit comments online by using the <A
HREF="http://www.gnome.org/gdp/doctable/"
TARGET="_top"
>GNOME Documentation Status
      Table</A
>.
   </P
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="LICENSE"
>License</A
></H2
><P
>    This program is free software; you can redistribute it and/or
    modify it under the terms of the <I
CLASS="CITETITLE"
>GNU General Public
    License</I
> as published by the Free Software Foundation;
    either version 2 of the License, or (at your option) any later
    version.
   </P
><P
>    This program is distributed in the hope that it will be useful, but
    WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    <I
CLASS="CITETITLE"
>GNU General Public License</I
> for more details.
   </P
><P
>    A copy of the <I
CLASS="CITETITLE"
>GNU General Public License</I
> is
    included as an appendix to the <I
CLASS="CITETITLE"
>GNOME Users
    Guide</I
>.  You may also obtain a copy of the
    <I
CLASS="CITETITLE"
>GNU General Public License</I
> from the Free
    Software Foundation by visiting <A
HREF="http://www.fsf.org"
TARGET="_top"
>their Web site</A
> or by writing to
    <P
CLASS="ADDRESS"
>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Free&nbsp;Software&nbsp;Foundation,&nbsp;Inc.<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<SPAN
CLASS="STREET"
>59 Temple Place</SPAN
>&nbsp;-&nbsp;Suite&nbsp;330<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<SPAN
CLASS="CITY"
>Boston</SPAN
>,&nbsp;<SPAN
CLASS="STATE"
>MA</SPAN
>&nbsp;<SPAN
CLASS="POSTCODE"
>02111-1307</SPAN
><br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<SPAN
CLASS="COUNTRY"
>USA</SPAN
><br>
&nbsp;&nbsp;&nbsp;&nbsp;</P
>
   </P
></DIV
></DIV
></DIV
></BODY
></HTML
>