What is Wcal
--------------

*****************************************************************************
*                                                                           *
* NOTICE: Wcal is looking for a new maintainer. I can no longer put enough  *
* time into developing Wcal. If you are interested in taking over           *
* development of Wcal, please email me.                                     *
*                                                                           *
*****************************************************************************

Wcal is a web based calendar/planner especially suitable for multi-user
setups in an Intranet. Useful for companies and other organizations who wish
to publish schedules and timetables for their employees and members on the
web.

Features include

  - Several users with their own or shared calendars
  - Read-only views
  - Weekly and monthly repeating events
  - Uses web server's access control methods
  - Separate access control definition for each user

Wcal is released under GNU General Public License (GPL). I welcome any bug
(or success) reports, suggestions or any patches you have needed to make
this work, and I hope people will find this as useful a tool as I have.

The latest version can be found from http://www.woods.iki.fi/pub/wcal/.

Prerequisites
-------------

Wcal is developed on Linux & Apache, but should work with minor modifactions
on any Unix platform. Access control is likely to work only on Apache and
NCSA web servers, but I plan to replace it with better scheme soon.

Wcal requires perl 5.004 or higher.

Wcal uses modules Data::Dumper and Date::Manip that don't come with the
standard perl distribution as of perl 5.004. They are available in CPAN.
Install these modules before proceeding. The versions that come with Wcal
distribution should be good. Version 5.22 or higher of Date::Manip is
REQUIRED.

You also need a C compiler.

As Wcal isn't as fast as one could hope, your computer should be a pentium
or equivalent or faster.

See file INSTALL for installation instructions.

Usage
-----

Once you have installed Wcal as instructed in INSTALL, point your browser to
the URL that maps to the directory you typed into HTML_DIR variable of the
Makefile, by default /wcal. Usage of Wcal should be obvious, just try
clicking on any links.

For information about the configuration file wcal.conf, see the manual page
wcal.conf.5.


			Samuli Krkkinen <skarkkai@woods.iki.fi>
