This file gives a brief (very brief) description of the Tcl interface
provided by the C++ code.

Calendar Operations
===================

<name> delete

<name> main			-- return main calendar file name
<name> include <file>		-- include calendar
<name> exclude <file>		-- exclude calendar
<name> forincludes <var> {...}	-- yield included calendar names

<name> add <item> [<cal-name>]	-- add item to cal (default is main)
<name> remove <item>		-- remove item
<name> changed <item>		-- mark <item> as changed
<name> hide <item>		-- hide item from user view

<name> readonly [<cal-name>]	-- returns boolean (default main cal)

<name> dirty  [<file>]		-- <file> modified locally?
<name> stale  [<file>]		-- <file> modified by somebody else?
<name> save   [<file>]		-- save changes
<name> reread [<file>]		-- read calendars from disk

<name> option <name> [<value>]	-- get or set calendar option

<name> query <start> <finish> <itemvar> <datevar> <body>
	For any item occurrence within the range of dates specified
	by <start> and <finish>, set <itemvar> to the item handle,
	set <datevar> to the occurrence date, and then evaluate <body>.

<name> listing <start> <finish> <itemvar> <datevar> <body>
	For all items <i>,
	    For each occurrence of <i> in start..finish+[<i> earlywarning]
		Set <itemvar> to <i>, <datevar> to the occurrence date
		and execute <body>.
	The executions of <body> are sorted by occurrence.

<name> incalendar <calendar> <itemvar> <body>
	For all items <i> in <calendar>
	    Set <itemvar> to <i> and execute <body>.
	The executions of <body> are sorted by date of first occurrence.

Notice Operations
=================

<n> length			-- Returns integer
<n> length <length>
<n> clone			-- Returns new <item>
<n> is <type>			-- Returns boolean


Appointment Operations
======================

<a> length			-- Returns integer
<a> length <length>
<a> starttime			-- Returns minutes
<a> starttime <minutes>
<a> clone			-- Returns new <item>
<a> is appt			-- Returns boolean
<i> alarms			-- Return list of alarms/signal error
<i> alarms <list>		-- Set list of alarms


Item Operations
===============

<i> delete

<i> calendar			-- Returns <calendar>
<i> text			-- Returns text
<i> text <text>
<i> earlywarning		-- Returns integer
<i> earlywarning <days>
<i> owner			-- Returns <owner name>
<i> owned			-- Does current user own item?
<i> own				-- Makes current user the owner
<i> hilite			-- Hilite mode (always|never|holiday)
<i> hilite <mode>		-- Set hilite mode

<i> contains <date>		-- Returns boolean
<i> empty			-- Returns boolean
<i> repeats			-- Returns boolean
<i> first			-- Returns date
<i> next <date>			-- Returns date/signals error
<i> type			-- Returns repetition type (string)

<i> date <date>
<i> dayrepeat <interval> <anchor>
<i> monthrepeat <interval> <anchor>
<i> weekdays <weekday>...
<i> start <date>
<i> finish <date>
<i> deleteon <date>

Date Operations
===============

date make <day> <month> <year>	-- returns date
date today			-- returns date
date first			-- returns date
date last			-- returns date
date monthsize <date>		-- returns integer
date monthday <date>		-- returns monthday
date weekday <date>		-- returns weekday
date month <date>		-- returns month
date year <date>		-- returns year
date split <date>		-- returns monthday,weekday,month,year

Time command
============

time now		-- returns time
time date <time>	-- returns date on which <time> occurs
time hour <time>	-- returns hour of the day
time minute <time>	-- returns minute within hour
time second <time>	-- returns seconds within minute
time millisecond <time>	-- returns millisec within second
time split <time>	-- returns hour,minute,second,millisecond
