    gpcalendar : A calendar for programmers (and others...)
    Copyright (C) 2002 Andrew Robertson <critter_75075@yahoo.com>

    This program is free software; you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation; either version 2 of the License, or
    (at your option) any later version.

    This program is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU General Public License for more details.

    You should have received a copy of the GNU General Public License
    along with this program; if not, write to the Free Software
    Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA

For more information, see my website at http://www.geocities.com/critter_75075/ or
email me!

GPCalendar, or Gtk Programmers Calendar, is intended for technical people who do not
think about days in terms of events and tasks, but think about them in terms of files and
projects.  Also, it is intended for people who 'log' their activities every day but may not
know what they will do tomorrow.

This started as a project several years ago in Gtk-Perl.  But, that feel by the wayside when I
could not get it working under Windows.  This new version (written in two months) is in
GTK-Freepascal and compiles equally well on Linux and Windows!  For more information,
please see http://www.freepascal.org/.

The default (and currently only) calendar format is a simple directory.
Within the directory are files and sub directories.  Files and sub directories
(at the first level) are named with a DTS (date time stamp) prefix.  If they
are files, they have a suffix that allows intelligent handling (GVim for .txt,
Mozilla for .html etc) (not supported yet).  Directories only have a date and a topic.  Every file
and directory has a topic in it's name.  Date prefixes, topics, and type suffixes are
or will be optional.  So, you may have a directory named Journal in your
home directory (or Projects, or Calendar) for all of the calendar/log entries.  An example sub directory
may be named 20020826.gpcalendar .  An example file may be named
20020826.staff_meeting.txt .  Another valid file may be named 20020826.txt .
Or, even just txt .  However, files that have only one element in their names will
not be parsed for now.  An example directory listing is:

/home/andy/Journal/20020805.gpcalendar/
/home/andy/Journal/20020806.party_pictures/
/home/andy/Journal/20020807.txt
/home/andy/Journal/20021005.staff_meeting.html
/home/andy/Journal/20031031.company_party/

You may have multiple calendar directories.  Future entries (entries with
dates greater than today) are valid.  Time of day support is planned.

Any ideas/flames/code are welcome.

Enjoy!
     andy
