Diary: Version 0.10 (16/11/2011)
Author: Andy Broad <andy()broad.ology.org.uk>
Copyright: Andy Broad 2006-2011

This is the latest  release of a simple to use Diary program.
It's conceived as an AmigaOS4 replacement for the Digita Organiser
but is not intended to be a direct clone of that program. It has a
GUI styled on a traditional paper diary and also an Arexx interface,
Oh and it's a commodity.

Installation:

Copy the contents of the archive to the location of your choice.
say Work:Organiser.

Usage:

The archive contains two programs Diary and import.

---
DIARY is the main program. It can be run from CLI or workbench.

Tooltypes / command line options

FILE          - the diary file to be loaded. If not set when starting from
                a Project icon the filename will be derived from the icon.
CX_POPUP/K    - set to YES to open window on program start. (defaults to YES)
CX_POPKEY/K   - sets the popup hotkey, defaults to "ctrl alt d"
CX_PRIORITY/K - set the commodity priority

The GUI is fairly simple, click on EDIT / DELETE to toggle modes, in edit mode
clicking on a day gadget will bring up a window to enter a new event entry.
Clicking on an event title will allow editing an existing event. In delete mode
clicking on and event allows to remove it. (with warning req!)

Before iconification or quiting Diary will ask you to save if the diary was
modified.

---
IMPORT is a quick and dirty tool which allows you to convert a Digita Organiser
1.1
file to the new format. It works by creating a set of Arexx commands that can be
pasted
into a script. Run this script to create your new diary.

eg:
>work:Organiser/Import Ram:olddiaray >ram:new.rexx

Then edit new.rexx adding

/* */

options results
address DIARY

to the beginning of the file.

You may well find you need to edit the arexx commands by hand, particularly if
had
quotes or apostrophes in any of your titles or notes.

It works quite well for a 1.1 file may not work at all for later versions. Use
with
caution, you may lose data.


KNOWN BUGS:

Adding a large number of events to a given day or creating events will long
title will
distort the GUI.


TODO:

Improve the GUI.
Extend Localisation
Extend ARexx interface.
Add Alarms function
Add automation functions. (run commands at start and end of events)
Produce proper documentation (probably html)

HISTORY:
0.10 Fixed bug where leap dates (29th Feb) was shown on non leap years
     when in month in view mode.
     Fixed bug where the current leap year was counted twice.
     Fixed bug with not displaying alternate sundays in days in view mode

0.9 CX_PRIORITY was read as a integer rather than a pointer to an integer

0.8 Pen colours no longer corrupted if workbench is closedand reopened

0.7 Added month in view mode.

    Numbers of events shown per day limited, dependent on mode, default is
    3 month, 4 week, 10 day.

    Month in view mode no longer shows times.

0.6 Added days in view mode.

    Now supports AISS for gadget images.

0.5 Changing EndTime gadget will now cause the EndDate gadget to be set to the
    start date if not allready set. Clearing the End Date gadget will still
clear
    the EndTime as well.

    When the 1st of the month fell on a sunday it the wrong week would be
displayed.
    (FIXED)

    Added ICONIFY, SHOW, and HIDE, arexx commands.

    Arexx and commodity quit options now bring up a save requester if the diray
has
    been mofified.
    A cancel option has been added to this requester

    Added NEXT KEY/N ; PREV KEY/N ; GET KEY/N,FIELD/K,STEM/K DELETE
KEY/N/A,FORCE Arexx Comands

    Now displays multiple events in a day in chronological order.

    Added "calender gadget" the "empty" "eigth" day.

    Changed usage of timer.device so that it doesn't matter if the sytem time is
set
    backwards.

    Added "Actions" on start an end  times of events.

    Rearranged GUI slightly to improve look / save space/

    Added html documentation to the archive.

0.4 First Public release:
0.1. - 0.3 Internal test builds.

LICENSE:

This software is released as FREEWARE, however the author retains the right to
modify this license for later version of the software.

DISCLAIMER:

No responsibility is taken by the author for any lost data, missed appointments
etc.


DONATIONS:

This work has been largely been to done to fulfil my own needs and to support
the AmigaOS 4 community in general, but it does take a lot of time so if you
would like to make a donation there is a PayPal button at
http://www.broad.ology.org.uk/amiga/