This is the README file for vcal.

Author:

   Adam Stein (adam@scan.mc.xerox.com)

Copyright:

  Copyright (c) 2000  Xerox Corporation.  All Rights Reserved.

  Permission to use, copy, modify  and  distribute  without  charge
  this  software,  documentation, images, etc. is granted, provided
  that this copyright and the author's name is retained.

  A fee may be charged for this program ONLY to recover  costs  for
  distribution  (i.e.  media costs).  No profit can be made on this
  program.

  The author assumes no responsibility for  disasters  (natural  or
  otherwise) as a consequence of use of this software.

Description:

  This program reads vCalendar format files and add the appointments to
  a user's CDE desktop calendar.

  The latest version can always be found at:

	http://www.csh.rit.edu/~adam/Progs/

Requirements:

  This program requires Perl 5.004 or higher.  Also required are
  the following Perl modules:
  
	Calendar::CSA	(by Kenneth Albanowski, version 0.8 or newer)
	CGI		(by Lincoln Stein, version 2.56 or newer)
	Date::Calc	(by Steffen Beyer, version 4.2 or newer)
	Net::ICal	(by Eric Busboom, version 0.08 or newer)
	Time-modules	[contains Time::ParseDate & Time::Timezone]
			(by Graham Barr, David Muir, & Paul Foley, 
			 version 98.081201 or newer)

  All modules can be found at CPAN sites:
  
	ftp://theory.uwinnipeg.ca/pub/CPAN/SITES.html

  In addition, CGI can be found at:

	http://stein.cshl.org/WWW/software/CGI/

  and Date::Calc can be found at:

	http://www.engelschall.com/u/sb/download/

Installation:

  This program has only been tested on Solaris 2.6 systems.

  Change the first line in "vcal" to reflect where Perl is installed
  on your system.

  Copy the "vcal" program to your bin directory of choice (i.e. /usr/local/bin)

  Copy the "vcal.man" file to your man directory of choice
  (i.e. /usr/local/man/mann/vcal.n)

Using

  To use, simply pass a vCalendar format file either through stdin or
  as a filename on the command line.  The calendar to add the appointments
  to can come from the command line or an environment variable.
  
  "Vcal" can be used as a helper application in a web browser to
  automatically add appointments from vCalendar files on a web page.

  Also, "vcal" can be used as a helper application within CDE (i.e.
  opening a vCalendar attachment in dtmail or double clicking a vCalendar
  file with dtfile).

Bugs/Additions:

  I would appreciate knowing about any bugs either found or
  fixed and any enhancements made.  I would like to keep a
  centralized version with the upgrades so that there aren't
  50 million different versions.  I can't make any
  guarantees to when bug fixes would be made (if any are
  found :-{), but I'll do my best.

  I hope this program is of use to you, either in it's capacity or as
  an example in Perl programming.

