gunnar: server/kolab-filter/filter/docs AUTHORS, NONE, 1.1 ChangeLog, NONE, 1.1 INSTALL, NONE, 1.1

[cvs at kolab.org]

Author: gunnar

Update of /kolabrepository/server/kolab-filter/filter/docs
In directory doto:/tmp/cvs-serv1219/filter/docs

Added Files:
	AUTHORS ChangeLog INSTALL 
Log Message:
kolab-resource-handlers splitted completely into kolab-freebusy and kolab-filter. Basic package installation of kolab-filter works.

--- NEW FILE: AUTHORS ---
Originally written by Steffen Hansen <steffen at klaralvdalens-datakonsult.se>

  Copyright (c) 2004 - 2007  Steffen Hansen
  Copyright (c) 2004 - 2007  Klaraelvdalens Datakonsult AB

Portions based on work by the following people:

  (c) 2005 - 2006  Richard Bos          <richard at radoeka.nl>
  (c) 2005 - 2006  Marcus Hüwe          <suse-tux at gmx.de>
  (c) 2005 - 2006  Martin Konold        <martin.konold at erfrakon.de>
  (c) 2006 - 2007  Thomas Arendsen Hein <thomas at intevation.de>
  (c) 2006 - 2007  Gunnar Wrobel        <wrobel at pardus.de>


Portions based on work by the following companies:

  (c) 2005 - 2006  erfrakon Partnerschaftsgesellschaft
  (c) 2006 - 2007  Intevation GmbH
  (c) 2006 - 2007  p at rdus


Contributions by the following people:

  Sascha Wilde         <wilde at intevation.de>  


(Established based on the following guidlines:

 People with CVS access and more than two commits are being listed in
 the first list, their corresponding company in the second list. The
 order of appearences is sorted by date of last contribution, longest
 period of contributions and finally based on alphabetical order. The
 listed contributors comitted less than three patches or do not have
 CVS access.)
--- NEW FILE: ChangeLog ---
2007-08-09  Gunnar Wrobel  <p at rdus.de>

	The package was split into a library
	part (php-kolab/Kolab_Filter) and a script part
	part (kolab-filter).

2006-11-01  Gunnar Wrobel  <wrobel at pardus.de>

	* resmgr/kolabfilter.php.in ($addrs):

	Fixed kolabfilter script for PHP5 (array_merge problems).

2005-12-22 Richard Bos <richard at radoeka.nl>
	* resmgr/kolabfilter.php.in,
	  resmgr/kolabmailboxfilter.php.in: changed @phplibdir2@/pear to
	  @phppeardir@

2005-12-17 richard Bos <richard at radoeka.nl>
	* resmgr/kolabfilter.php.in,
	  resmgr/kolabmailboxfilter.php.in: @resmgr_filter@ replaced by
	  @resmgr_filterdir@

2005-11-28 Marcus Hüwe <suse-tux at gmx.de>
	* resmgr/kolabfilter.php: moved to resmgr/kolabfilter.php.in,
	  introduced autoconf variables: @PHP@, @phplibdir2@, @resmgr_filter@
	* resmgr/kolabmailboxfilter.php: moved to resmgr/kolabmailboxfilter.php.in,
	  introduced autoconf variables: @PHP@, @phplibdir2@, @resmgr_confdir@,
	  @resmgr_filter@
	* resmgr/resmgr.conf: moved to resmgr/resmgr.conf.in,
	  introduced autoconf variables: @webserver_document_root@, @sysconfdir@,
	  @resmgr_logfile@

--- NEW FILE: INSTALL ---
=========================
 Installing kolab-filter
=========================

This document contains instructions for installing the Kolab MTA
filters on your server. Usually you won't need to do this manually
since it is part of the OpenPKG based installation of the Kolab
Groupware Server. These instructions are only relevant if you wish to
install the filters on a non-OpenPKG platform.


Obtaining kolab-filter
======================

Currently no source packages of kolab-filter are being
distributed. You will have to use CVS to check out the source code and
build a package by running

 make dist


Prerequisites
=============

To function properly, kolab-filter requires the following:

1. PHP:

   You need a PHP variant that has been patched for Kolab. It needs to
   support IMAP annotations. You are advised to use PHP 5

2. The following Kolab PEAR packages:

   a. Kolab_Filter


Installing kolab-filter
=======================

kolab-filter is written in PHP and two scripts that should be called
over the command line. You should install the scripts in a suitable
directory on your system. The config.php file needs to be placed
alongside with the two PHP scripts.

Since kolab-filter is written in PHP, there is no compilation
necessary; simply expand the source package and make sure the scripts
end up in a sensible location. You will need to replace the "@PHP@"
entry at the top of the scripts with the path to your PHP executable.


Configuring kolab-filter
==========================

You can modify the config.php within the kolab-filter base directory
to suit you needs but on a standard Kolab Server installation you will
usually have a configuration template somewhere in your
kolab/templates directory that will get rewritten to the location of
the config.php file.

Make sure the values within that template match your platform.


Obtaining Support
=================

If you encounter problems with kolab-filter, help is available!

1. Wiki

   A lot of typical question have been collected in the Kolab wiki at

     http://wiki.kolab.org

   You'll find both a FAQ and a troubleshooting section there.

2. Mailing lists

   The Kolab project also runs a number of mailing lists where you ask
   all the question left unanswered by the wiki.  Information,
   archives, and subscription information can be found at
  
     http://www.kolab.org

3. IRC

   Kolab developers, contributors and users may also be found on IRC,
   on the channel #kolab on the Freenode Network (irc.freenode.net).

4. Commercial support

   Commercial support is available at 

     http://www.kolab-konsortium.com