$Id: INSTALL,v 1.2 94/04/28 18:15:12 leon Exp $
/* 
 * Copyright 1994 GROUPE BULL
 *
 * Permission to use, copy, modify, and distribute this software and its
 * documentation for any purpose and without fee is hereby granted, provided
 * that the above copyright notice appear in all copies and that both that
 * copyright notice and this permission notice appear in supporting
 * documentation, and that the name of GROUPE BULL not be used in advertising
 * or publicity pertaining to distribution of the software without specific,
 * written prior permission.  GROUPE BULL makes no representations about the
 * suitability of this software for any purpose.  It is provided "as is"
 * without express or implied warranty.
 *
 * GROUPE BULL disclaims all warranties with regard to this software,
 * including all implied warranties of merchantability and fitness,
 * in no event shall GROUPE BULL be liable for any special,
 * indirect or consequential damages or any damages
 * whatsoever resulting from loss of use, data or profits,
 * whether in an action of contract, negligence or other tortious
 * action, arising out of or in connection with the use 
 * or performance of this software.
 *
 */

*** Compiling k-lendars

1 - go into the k-lendars directory
2 - edit the Imakefile, according to your system
3 - run xmkmf
4 - run make install (or just make if you do not want to install the binaries)


*** Configuring your mail environment




   ***   WARNING   ***   WARNING   ***   WARNING   ***   WARNING   ***   

INSTALLATION OF MAIL DISPATCH MECHANISMS MAY LEAD TO A LOSS OF MAILS.

GROUPE BULL AND I DISCLAIM ALL WARRANTIES WITH REGARD TO THIS SOFTWARE.

   ***   WARNING   ***   WARNING   ***   WARNING   ***   WARNING   ***  




k-lendars uses email as media for inter-process communications
every mail involved in the Cm protocol should be forwarded to special scripts:
	CmProtocol: cm-dispatch
	CmAdministration: cm-admin
If you do not configure your emial environment to do this job you won't be 
able to use the multi user k-lendars capabilities.

This must be done using some dispatch mechanisms like procmail or slocal:

*** Using procmail

- procmail-2.71 may be found on avahi.inria.fr:/pub/procmail-2.71.tar.gz

- Edit your ~/.forward, in order to forward incoming messages to procmail

"|/net/koala/bin/sun4/procmail #leon"

(with the absolute path of procmail,  and do not forget the #<login> argument)

- Create (or modify) your ~/.procmailrc file
a .procmailrc file should contain variables and filters declarations. 
Here is a minimal .procmailrc:

DEFAULT = $HOME/Mail/INBOX

every mail forwarded to procmail will be appended to the $HOME/Mail/INBOX file.

The k-lendars dispatch mechanisms requires two filters:

:
CmProtocol
|/net/koala/bin/sh/cm-dispatch

:
CmAdministration
|/net/koala/bin/sh/cm-admin


This says that any mail containing the "CmProtocol" string should be forwarded
to the cm-dispatch script and every mail containing "CmAdministration" should 
be forwarded to cm-admin. Every non filtered message will be dropped into the 
$DEFAULT procmail folder.


*** Reading mails

Do not forget that: EVERY NON FILTERED MESSAGE WILL BE DROPPED INTO THE 
$DEFAULT PROCMAIL FOLDER.
So, you must configure your mailer to read this folder instead of your default
mailbox. For example, if you are using xmh, this can be done by writing a  
~/.xmhcheck file, where you give associations between a xmh folder and a 
procmail folder.

inbox /u/indri/0/koala/leon/Mail/INBOX

This says that xmh should scan the /u/indri/0/koala/leon/Mail/INBOX file and 
add the incoming messages into the inbox folder. 






