


asmail(0.55)                                         asmail(0.55)


NNAAMMEE
       aassmmaaiill - AfterStep Mail

SSYYNNOOPPSSIISS
       aassmmaaiill [file] [options ...]

DDEESSCCRRIIPPTTIIOONN
       The  aassmmaaiill  is  a "mail-checker" like xbiff, but with the
       Afterstep look 'n feel. It indicates the  status  of  your
       mailbox.  It  can  be put in the Wharf, execute program on
       incoming mail, execute program on mouse  click,  show  XPM
       icon's, show animations and more...

FFIILLEE
       But default aassmmaaiill uses ~/.asmailrc as configuration file,
       but if want to use another file you just specify the  name
       on the command-line.


OOPPTTIIOONNSS
       --hheellpp
              Prints a help message

       --ggeeoommeettrryy <geom>
              Specifies the geometry of the aassmmaaiill window.

       --ddiissppllaayy <disp>
              Specifies the display to use.

       --ttiittllee <string>
              Specifies the title string of the aassmmaaiill window.

       --nnaammee <string>
              Specifies  the  client  instance,  icon  and  title
              string of the aassmmaaiill window.


CCOONNFFIIGGUURRAATTIIOONN FFIILLEE
       Here is a list of the keywords that can  be  used  in  the
       configuration file.

       NNooBBeeeepp
              Do not signal when new mail is found.

       NNooSShhaappee
              Truns  off  shaped  window.  Shaped window is often
              usefull if your would like to place aassmmaaiill in  your
              Wharf.

       LLoocckkSShhaappee
              Use  this  option  if all icons have the same shape
              and size, this will save some CPU time if  you  are
              using animations.




asmail                     Apr 13 2000                          1





asmail(0.55)                                         asmail(0.55)


       MMaaiillFFiilleess

               [ mbox ]
               [ Maildir/ ]
               [ ::popserver username passwd <port> ]
               [ >>imapserver username passwd <port> <mailbox> ]


       EEnndd
              Specifies  which  mailfile(s) and pop-account(s) to
              use. You can define  multiple  mailboxes.  If  this
              option  is left out $MAIL will be used as mailfile.
              When using pop or IMAP  mailboxes  make  sure  that
              your  configfile is not world readable, it contains
              usernames and passwords which really should not  be
              readable  to anyone. Ports and the mailbox name for
              IMAP boxes are  optional.  If  the  mailbox  is  in
              Maildir  format,  end  the  directory  name  with a
              slash.


       UUppddaattee <sec>
              Specifies the update frequency. Default is  5  sec-
              onds.

       EExxeeccuuttee <program>
              Specifies  the  program to execute when left mouse-
              button click is invoked on the aassmmaaiill window.

       NNeewwMMaaiillEExxeeccuuttee <program>
              Specifies the program to execute when new  mail  is
              found.

       AAllwwaayyssNNeewwMMaaiillEExxeeccuuttee
              Always  execute  when  new  mail is found.  If this
              option is revomed asmail will only execute when new
              mail  is  found  when  the  status  is changed from
              "nomail/oldmail" to "newmail".

       EExxeeccuutteeOOnnUUppddaattee <program>
              This option is useful if you  want  to  "pop"  your
              mail from a mailserver. Asmail will execute a spec-
              ified program (i.e. popclient, get_mail, ...)  just
              before every update of the mailbox status.

       NNuummOOffMMssggMMooddee <mode>
              With  this option you can get asmail to display the
              number of messages and/or new messages in the mail-
              box.
              Mode can be set to:
              0 = Disable feature (default)
              1 = NumOfNewMail/NumOfMail
              2 = NumOfNewMail
              3 = NumOfMail



asmail                     Apr 13 2000                          2





asmail(0.55)                                         asmail(0.55)


       NNuummOOffMMssggPPoossiittiioonn <x> <y>
              Position of the text, must be inside the icon mask.

       NNuummOOffMMssggFFoonntt <font>
              Font to use.

       NNuummOOffMMssggCCoolloorr <color>
              Color to use.

       TTiimmeeSSttaammppMMooddee
              This option is useful if you  are  using  utilities
              like  procmail.  Asmail  will change status to "New
              Mail" when the time-stamp of the last  modification
              of the mailfile is changed.

       AAnniimmaattiioonnSSppeeeedd <nomail> <oldmail> <newmail>
              Sets  the delay between two images in an animation.


       NNooMMaaiill / OOllddMMaaiill / NNeewwMMaaiill

              <xpm-icon>
              <...>

       EEnndd
              Assign icons and/or animations. Just list the icons
              in  the  order  you  want  them to be shown. If you
              don't wnat an animation just list one icon  and  if
              you want to use the aassmmaaiill default icons leave this
              option out.

       ##
              Comment.


EEXXAAMMPPLLEESS
       Here is an example of how to start aassmmaaiill from the command
       line.  It  will  use  myconfig.asmailrc  for configuration
       instead of ~/.asmailrc.

       asmail myconfig.asmailrc &

       Here is an example of how to start aassmmaaiill  from  aafftteerrsstteepp
       and  put it in the Wharf. Place the following line in your
       _._s_t_e_p_r_c file in your home directory.

       *Wharf - - Swallow "asmail" asmail &


       Here is an example of a configuration file.

       #########################################################
       # .asmailrc - asmail configuration file                 #
       #########################################################



asmail                     Apr 13 2000                          3





asmail(0.55)                                         asmail(0.55)


       NoBeep
       MailFiles
            /var/spool/mail/per
            /home/per/mail/mbox
            ::pop.foo.org joe.doe abraxas 10110
            ::pop.isp.com josef SecretWord423
       End
       Update 10
       Execute xterm -T Pine -e pine -i &
       NewMailExecute cat message.au > /dev/audio &
       AlwaysNewMailExecute
       AnimationSpeed 10 10 5
       LockShape

       NoMail
            /usr/include/X11/pixmaps/nomail.xpm
       End

       OldMail
            /usr/include/X11/pixmaps/oldmail.xpm
       End

       NewMail
            /usr/include/X11/pixmaps/newmail1.xpm
            /usr/include/X11/pixmaps/newmail2.xpm
            /usr/include/X11/pixmaps/newmail3.xpm
       End



CCOOPPYYRRIIGGHHTT
       This program is Copyright (c) 1996, 1997 by Per Liden.  No
       guarantees or warranties are provided, use this program at
       your own risk.  It may be freely copied and used  as  long
       as this copyright-notice is left intact. Modifications and
       extensions after 1998 are done by Martin Domig.

AAUUTTHHOORR
       Per Liden

SSPPEECCIIAALL TTHHAANNKKSS TTOO
       Stephan K. Zitz (zitz@io.com)
       Gyula Matics (mgyula@eik.bme.hu)
       Steve Martin (smartin@henge.com)
       Christopher Seawood (cseawood@qualcomm.com)

MMAAIINNTTAAIINNEERR
       Martin Domig (martin.domig@gmx.net)









asmail                     Apr 13 2000                          4


