
********************************************
*                                          *
*     Program : AmigaDiary version 1.0     *
*                                          *
*     Author  : Andrew K. Pearson          *
*		                                   *
*     Machine : Commodore Amiga A500       *
*                                          *
* 			                               *
*     (c) Andrew Pearson 1992/93           *
*		                                   *
********************************************



Documentation	20/2/93
======================


	AmigaDiary is a handy workbench tool of the type that currently 
abound office PC's. It is a mouse driven diary capable of storing all
personal events and is the perfect solution to all those forgotten 
birthdays, missed appointments etc.


Getting Started
---------------

	AmigaDiary can be started by double clicking the diary icon 
from the workbench, or by typing "run AmigaDiary" from the CLI. If you
wish a default file to be loaded each time you start up, save your
entries file in the s directory as diary.def


The Interface
-------------

	The main diary display shows open 'pages' of the diary. The 
current date is displayed in the centre of the display. There are four 
arrows under the pages - these represent (left to right) week backward, 
day backward, day forward, week forward - and are used to move to 
dates within close proximity to the current date. 
	The eight gadgets at the bottom of the screen represent the 
main diary functions :


LOOKUP	This gadget is used to go immediately to a date that is without 
------	having to use the arrow gadgets. If clicked, a requestor will 
 	appear prompting the user for the day in the format shown.


ADD	This gadget allows the user to add an entry into the diary which,
---	heck, I suppose is quite vital. A window will appear with gadgets 
	to input and manipulate your entry. More about this under 'The 
	Add Entry window'.


EDIT	This allows the user to alter, or delete any entries in the diary.
----	When clicked, it opens an edit window which is used to step through
	the entries for that day. To edit an entry, you must go to that 
	date first, using either the arrow gadgets or the LOOKUP gadget. 
	More editing under 'The Edit Entry window'.


SCRIBBLE The ScribblePad is used to jote down notes, reminders, and any
-------- entry which does not have a specific date eg. 'get a haircut'.
	 Scribblepad entries are added in the same way as diary entries,
	 to activate the appropriate window, select SCRIBBLE, then select
	 ADD from the scribblepad gadgets. Note - scribblepad entries have
	 no time option.


LOAD	Allows the user to load a previously stored, AmigaDiary file.
----


SAVE	Allows the user to save all information in the diary, including
----	the scribblepad, in an external file.


ABOUT	Information about the program and author. 
-----


SHRINK	Reduces the diary to a small window. This allows you to 'pop' it in
------	the background without having to quit. The diary can be 'unshrunk'
	by closing the shrink window.



THE ADD ENTRY WINDOW
--------------------

	This window supplies the gadgets to add diary entries. 


Entry        : This string gadget is for the entry text
Hours        : Supply a time in hours (24hr clock) for the entry, if required
Mins         : Supply a time in minutes, if required
Include time : Entries do not necessarily need a time, eg. 'Go shopping' 
               could apply at any time. These entries are displayed at the 
               bottom of the diary page.
Add          : Creates an entry from the inputs given, and inserts it into 
               the diary.
Clear        : Clears all the inputs in the gadgets.
Cancel       : Cancels choice, ie. closes the window without adding the 
               entry.



THE EDIT ENTRY WINDOW
---------------------

	This window supplies the gadgets to edit diary entries.

Entry	  	: as above
Hours		: as above
Mins		: as above
Include Time	: as above
Prev		: Retrieves the next diary entry for that day
Next		: Retrieves the previous diary entry for that day
Delete		: Removes the entry from the diary
Clear		: Clears the gadget values
Change		: Applies the changes to the entry
Done		: Finish, ie. close the edit entry window



HOTKEYS
-------

    The letters that are underlined in the program gadgets indicate
the keys that can activate the gadget by pressing along with SHIFT.



	If you have any suggestions, bug reports, etc. please send them
    to :-

		Andrew Pearson
		216 Deeside Gardens,
		Aberdeen AB1 7PS
		Scotland

		OR:   email   akp@uk.ac.ed.dcs
			      andrewp@uk.ac.ed.castle




