Copyright (c) 1993 by Sanjay Ghemawat

Requirements
============

You will need to have the following if you want to build ical.
	* A C++ compiler
	* Tcl and Tk library and header files
	* X11 library and header files

If you run into a problem with this process, or have gripes about
the installation process, please send mail to me at "sanjay@lcs.mit.edu".

Build Overview
==============

The build process combines a number of Makefile fragments into one
Makefile and then uses that to build ical.  Various Makefile fragments
are stored in the config subdirectory.

Steps
=====

* Execute "config/os-type".

  This shell script will try and determine your operating system type.
  If the script prints out "unknown", try and fix it so that it
  generates the correct OS type.  Send me your changes so that they
  make it into the next release.  Also see the porting section below.

  Occurrences of $(OS) in the rest of this description should be replaced
  by the OS type as determined by config/os-type.

* Edit config/Make.local or config/Make.$(OS).local.

  These files customize the build process to your needs.  See
  "config/README" to figure out what should go in these files.

  You should put changes that apply to all operating systems supported
  at your site in Make.local, and put operating system specific
  changes in Make.$(OS).local.

  You should not have to change any of the other files in the config
  directory unless you are porting to a new operating system.

* make clean

* make depend

  This step is optional unless you plan on making local changes to ical.

* make

  This will build a calendar shell "calshell" and two wrapper scripts,
  "ical" and "ical.test".  You can run "ical.test" while in the
  top-level distribution directory to check out various features of
  ical.

* make install

  The files installed by "make install" are

  $(BINDIR)/
	ical		The actual application script
	calshell	Shell used by ical

  $(LIBDIR)/
	ical/*		Various Tcl/Tk files

  $(MANDIR)/
	man1/ical.1	Manual page

Porting to a new OS
===================

If you are porting to a new operating system, put Makefile changes
that are not specific to your site in config/Make.$(OS) and mail that
file back to me at "sanjay@lcs.mit.edu".  Look at config/Make.OSF1 or
config/Make.ULTRIX for an example.
