Provided by: away_0.9.5-3ubuntu1_i386 bug

NAME

       awayrc - configuration file for Away

DESCRIPTION

       An away configuration file consists of a series of commands.  Each line
       of the file may contain only one  command.   Command  names  are  case-
       insensitive.  Commands and arguments are separated by spaces.

       The  hash  mark,  or  pound sign ("#"), is used as a comment character.
       You can use it to annotate your configuration file.  All text after the
       comment character to the end of the line is ignored.

       Take  note  that  if  any mailboxes are configured in the rc file, they
       will be the only mailboxes checked, which means that you must add  your
       inbox--the $MAIL environment variable will be ignored.

COMMANDS

       mail VALUE
              This  command  allows the user to disable or enable the checking
              of the user's mailboxes.  If  mail  checking  is  disabled,  all
              mailbox  and  maildir  commands are ignored.  VALUE can be 0, 1,
              no, or yes.  The default value is 'yes'.

       mailbox FILENAME
              A file that should be checked for "new mail."  The filename will
              be  appended  to  the previous maildir declaration.  An optional
              description of the mailbox may be supplied.  If the  description
              contains  a  space,  the  entire description must be enclosed in
              braces, "{" and "}".

       maildir DIRECTORY
              A path where subsequent mailbox declarations  will  be  located.
              The only argument is the path itself.

       persist VALUE
              This  command  will  set whether to do persistent mail checking.
              VALUE can be 0, 1, no, or yes.  The default value is 'yes'.

       time SECONDS
              This command will set the number of  seconds  that  away  sleeps
              before  performing  its  background  tasks.  Presently, the only
              background task that  away  will  perform  is  the  checking  of
              mailboxes.   The  SECONDS  value  must be more than the minimum,
              which set at compile time.  The only argument is the  number  of
              seconds.  The default value is 300.

EXAMPLE

       # check mailboxes
       mail yes

       # check mail every 60 seconds
       time 60

       # do not do persistent checking
       persist no

       # inbox
       maildir /var/spool/mail
           mailbox johndoe                {your Inbox}

       # procmail folders
       maildir /home/johndoe/mail
           mailbox linux-security         {Linux Security}
           mailbox mutt-announce          {Mutt Announce}

FILES

       ~/.awayrc
              Per user configuration file.

BUGS

       Bug    reports    should   be   sent   to   the   away   mailing   list
       <away@unbeatenpath.net>.

SEE ALSO

       away(1)

AUTHORS

       Cameron Moore <cameron@unbeatenpath.net>, and others.