===============================================================================
 Mail Notification installation instructions
===============================================================================

Index

	0. About this document
	1. Dependencies
	2. Instructions
	3. Configure options

0. About this document

	$Id: INSTALL,v 1.14 2004/10/25 13:03:00 jylefort Exp $

	Copyright (c) 2003, 2004 Jean-Yves Lefort.

	This document is part of Mail Notification.
	It may be distributed under the same terms as Mail Notification.

1. Dependencies

	Mandatory libraries:

		* GTK+ (version 2.4.0 or superior)
		  http://www.gtk.org/

		* GNOME (version 2.6.0 or superior)
		  http://www.gnome.org/

	Optional libraries:

		* for Gmail support:

		  GNOME (version 2.8.0 or superior)
		  http://www.gnome.org/

		* for SSL/TLS support:

		  OpenSSL (version 0.9.5b or superior)
		  http://www.openssl.org/

		* for SASL authentication support:

		  Cyrus SASL (version 2.0 or superior)
		  http://asg.web.cmu.edu/sasl/sasl-library.html

		* for MIME support:

		  GMime (version 2.1.0 or superior)
		  http://spruce.sourceforge.net/gmime/

2. Instructions

	Mail Notification uses the well-known GNU build system. Hence,
	the following usual sequence will probably satisfy most users:

		$ ./configure --prefix=/usr
		$ make
		<get root privileges, if needed>
		$ make install

	IMPORTANT:

		* You must install Mail Notification in the same
		  prefix as GNOME (commonly /usr or /opt/gnome). To
		  know where GNOME is installed on your system, type:

			$ pkg-config --variable prefix libgnome-2.0

		* Due to a bug in bonobo-activation
		  (http://bugzilla.gnome.org/show_bug.cgi?id=151082),
		  your session must be restarted after installing Mail
		  Notification.

	The ./configure script options are documented below. They are
	enabled by default and automatically disabled if a requirement
	is not met, so you probably do not need to use them.

3. Configure options

	--enable-mbox (default: yes)

		Enable mbox mailbox support.

	--enable-mh (default: yes)

		Enable MH mailbox support.

	--enable-maildir (default: yes)

		Enable Maildir mailbox support.

	--enable-pop3 (default: yes)

		Enable POP3 mailbox support.

	--enable-imap (default: yes)

		Enable IMAP mailbox support.

	--enable-ssl (default: yes)

		Enable SSL/TLS support.

		Requirements: OpenSSL version 0.9.5b or superior.
		Applies to: POP3, IMAP.

	--enable-sasl (default: yes)

		Enable SASL authentication support.

		Requirements: Cyrus SASL version 2.0 or superior.
		Applies to: POP3, IMAP.

	--enable-sylpheed (default: yes)

		Enable Sylpheed format support.

	--enable-gmail (default: yes)

		Enable Gmail mailbox support.

		Requirements: GNOME version 2.8.0 or superior.

	--enable-ipv6 (default: yes)

		Enable IPv6 support.

		Applies to: POP3, IMAP.

	--enable-mime (default: yes)

		Enable MIME support. If this option is disabled, the
		mail summary will not be able to display messages of
		mbox, MH, Maildir, POP3, IMAP and Sylpheed mailboxes.

		Requirements: GMime version 2.0 or superior.
		Applies to: mbox, MH, Maildir, POP3, IMAP, Sylpheed.
