This is still another new and improved release (2.1) of the infamous Pcal
program.  The changes this time are:

	1) Elementary cpp-like functionality has been added; the date file
	   now supports define|undef, if{n}def ... { else ... } endif, and
	   include:

		ifdef meetings
		include meetings.dat
		undef meetings
		endif

	   Symbols may be {un}defined on the command line via the new -D
	   and -U options described below; symbol names are treated in a
	   case-insensitive manner.  "define" alone deletes all symbol
	   definitions; "ifdef" alone is always false; "ifndef" alone is
	   always true.

	   The names of files to be included may be optionally surrounded
	   by "" or <>; non-absolute path names are taken to be relative
	   to the directory where the file containing the include directive
	   exists.  The Un*x flavor is smart enough to translate file names
	   starting with "~/".

	2) Pcal now looks for environment variable (global symbol on VMS)
	   PCAL_OPTS, which is parsed for command line options; flags set
	   there override the program defaults but are overridden by values
	   set in the date file or explicitly on the command line:

		setenv PCAL_OPTS "-t Times-Bold"	(Un*x)
		$ PCAL_OPTS == "-t Times-Bold"		(VMS)

	3) Pcal also looks for environment variable (logical name on VMS)
	   PCAL_DIR which points to the default directory for the calendar/
	   CALENDAR.DAT file.

		setenv PCAL_DIR "/u4/users/awr/pcal"	(Un*x)
		$ define PCAL_DIR "DISK11:[AWR.PCAL]"	(VMS)

	   In response to many requests, Un*x pcal looks for .calendar; if
	   that does not exist, it looks for calendar as before.

	4) The -D and -U flags have been added to define or undefine symbols
	   for the preprocessor; if these are specified on the command line,
	   they take effect prior to reading the date file.  -D alone clears
	   all previously-defined symbols.

		pcal -D meetings			(Un*x)
		$ pcal -"D" meetings			(VMS)

	5) The -L, -C, and -R flags have been added to specify left, center,
	   and right foot strings.  Foot strings consisting of multiple words
	   should be specified in single or double quotes:

		opt -C "Languages and Tools Group"

	6) The '-' (also '--') dummy flag has been added to disambiguate
	   cases such as the following:

		pcal -t 9 90

	   which may now be specified as

		pcal -t - 9 90		or	pcal -t -- 9 90

	7) As many have noticed, Pcal used to overstrike multiple text lines
	   for the same date if the lines were not contiguous in the date
	   file; this has been fixed.  Also, the text accompanying holidays
	   is written in the otherwise-unused space adjacent to the date.

The accompanying file called "ReadMe.orig" came with the original distribution
as README and states this program is copyrighted but with permission to modify
and redistribute.

Andrew W. Rogers

Additional note: This distribution includes a VMS HELP file written by
Richard Dyson.  Countless other people worked on pcal long before me; see
the ReadMe.orig file and topline comments in pcal.c; special thanks to
Mark Kantrowitz, Joe Brownlee, and Eric Hammond for their contributions
and suggestions which I have incorporated into release 2.1.
