Gyrus: GNOME IMAP/Cyrus Administrator.
======================================

Gyrus is a tool for the administration of mailboxes in IMAP/Cyrus servers. It
is designed for being used in the GNOME Desktop.

Gyrus is free software, you are free and encouraged to copy it and distribute 
it. See the COPYING file for details.

* Getting Gyrus

Gyrus can be freely downloaded from its Web page: http://gyrus.gnome.cl. If you
want to get the development version, you can check it out from the GNOME CVS:

  $ cvs -z3 -d :pserver:anonymous@anoncvs.gnome.org:/cvs/gnome login
  $ cvs -z3 -d :pserver:anonymous@anoncvs.gnome.org:/cvs/gnome co gyrus

Normally, the development version is pretty stable, so don't feel too scared to
download it.

* Dependencies

The needed dependencies include:

gconf-2.0 (>= 2.0.0)
libbonoboui-2.0 (>= 2.0.0)
gtk+-2.0 (>= 2.4.0)
libglade-2.0 (>= 2.0.0)
libgnomeui-2.0 (>= 2.6.0)
gnet-2.0 (>= 2.0.0)
libgnomeprintui-2.2 (>= 2.10.0)

* Features

  - Connections:

    Currently, gyrus support only plain IMAP connections (normally, these 
    go by port 143). In the future, secure connections will be implemented.

    Also, servers using the UNIX hierarchy separator are supported.

  - Mailboxes:

    Gyrus allows you to browse through all the mailboxes of the server. For
    a better performance, you can search a desired mailbox with the 'Find' 
    dialog.

    You can create mailboxes: for new users, or as sub-mailboxes for existing
    ones.
    
    Also, if you have the needed permissions, you can delete mailboxes easily.

  - Quota Management:
    
    With Gyrus you can define the Quota of mailboxes (ie. the maximum amount 
    of space resources that a user can use in its mailboxes).

    It is posible to create printable reports of mailboxes whose quota is 
    over a percentage, so administrator can easily monitor mailboxes
    with quota exceeded.
    
  - Access Control List:

    Gyrus lets you administrate the ACL of each mailbox, i.e., to create, 
    delete, remove and modify the entries of Access Control List.

* Contributing:

Currently Gyrus is being developed and maintained by Claudio Saavedra 
<csaavedra@alumnos.utalca.cl>. As many free software hackers, Claudio doesn't
have too many time to hack in the application, so your cooperation will
be *very* appreciated.

For things that need to be worked you can check the TODO file that should
come with any gyrus distribution.

If you want to send bug reports, patches, improvements, suggestions, please 
use http://bugzilla.gnome.org under the module 'gyrus'. Questions, 
congratulations, flames, please send them to the gyrus mailing list 
<gyrus-list@gnome.org>. Instructions to suscribe to the list follow.

* Mailing List:

For any question regarding the software and/or sugestions to the development
team, please suscribe to the gyrus mailing list in the following address:

http://mail.gnome.org/mailman/listinfo/gyrus-list

The mails should be sent to to <gyrus-list@gnome.org>. Every kind of feedback 
is welcome.

* Credits:

  - Mantainer and Main Developer:

  Claudio Saavedra <csaavedra@alumnos.utalca.cl>

  - Original Author:

  Alejandro Valdés <avaldes@utalca.cl>

  - Former Contributors:

  Jorge Bustos <jbustos@utalca.cl>
  Juan Carlos Inostroza <jci@tux.cl>
  Mario Fuentes <mario@gnome.cl>
  Felipe Barros <felipe@linuxlab.cl>

* Known Bugs:

  - When the inactivity time is reached and the server sends a "BYE LOGOUT"
    command and disconnects, Gyrus 'can' hang out.

  - Even when it's not a bug, gyrus still can't handle secure connections. 
    Please do not report this as a bug, we are working on it.
