asmail(0.54)                                         asmail(0.54)



NAME

       asmail - AfterStep Mail


SYNOPSIS

       asmail [file] [options ...]


DESCRIPTION

       The  asmail  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...


FILE

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



OPTIONS

       -help
              Prints a help message

       -geometry <geom>
              Specifies the geometry of the asmail window.

       -display <disp>
              Specifies the display to use.

       -title <string>
              Specifies the title string of the asmail window.

       -name <string>
              Specifies  the  client  instance,  icon  and  title
              string of the asmail window.



CONFIGURATION FILE

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

       NoBeep
              Do not signal when new mail is found.

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

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




asmail                     Jun 21 1999                          1





asmail(0.54)                                         asmail(0.54)


       MailFiles

               [ mailfile ]
               [ ::popserver username passwd <port> ]
               [ >>imapserver username passwd <port> <mailbox> ]

       End
              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.

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

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

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

       AlwaysNewMailExecute
              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".

       ExecuteOnUpdate <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.

       NumOfMsgMode <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

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





asmail                     Jun 21 1999                          2





asmail(0.54)                                         asmail(0.54)


       NumOfMsgFont <font>
              Font to use.

       NumOfMsgColor <color>
              Color to use.

       TimeStampMode
              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.

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


       NoMail / OldMail / NewMail

              <xpm-icon>
              <...>

       End
              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 asmail default icons leave this
              option out.

       #
              Comment.



EXAMPLES

       Here is an example of how to start asmail 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 asmail  from  afterstep
       and  put it in the Wharf. Place the following line in your
       .steprc file in your home directory.

       *Wharf - - Swallow "asmail" asmail &


       Here is an example of a configuration file.

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

       NoBeep
       MailFiles



asmail                     Jun 21 1999                          3





asmail(0.54)                                         asmail(0.54)


            /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




COPYRIGHT

       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.


AUTHOR

       Per Liden
       per@oden.rsn.hk-r.se
       http://oden.rsn.hk-r.se/~per


SPECIAL THANKS TO

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













asmail                     Jun 21 1999                          4





































































Man(1) output converted with man2html