					***********************************
					T A M A R - the Hebrew Calendar App
					***********************************

							Version 1.0
							***********

Description and Notes
*********************

*	This app is released as is ....



A Very Very Concise User's Guide
********************************

===========
Main Screen
===========

-	View is of Hebrew Month
-	HolyDays and Shabbat indicated by broken vertical bar either sides
-	Minor HolyDays indicated by colon either both sides
-	Minor minor HolyDays/fasts have dots either side
-	Major HolyDay / Shabbat which is also Minor or Minor minor 
		indicated by full vertical bar either sides
-	Personal Events are underlined
-	Top line has month (+ prev/next month repeat buttons)
	and year ( + prev/next year repeat buttons)
-	Under the month display: Hebrew Date / Gregorian ("English") date
-	HolyDays/Events (including Personal Events and Parshat HaShvua on Shabbat
	for current date (if any) appear in a box. Scrollable and popup-able
	if necessary

	In order to:
	------------

		* change selected day:
			tap on the required day
		* change the month (and possibly year)
			tap/press on month's prev. or next repeat buttons 
		* change the month in current year
			tap on month for list of months
		* change the year
			tap/press on year's prev. or next repeat buttons 
		* select today's date
			tap on (Today) button
		* select a date by Gregorian date
			tap on (Goto) button
		* scroll the HolyDay/Event list (if necessary)
			tap the up/down scroll arrows.
		* pop-up the HolyDay/Event list (if necessary)
			tap the diamond

		* pop up a list of commands
			tap the "!" button

	
	Menu Items:
	-----------
	Utils
		Prefs			change settings/preferences
		Datebook		insert HolyDays/Events into Palm Datebook	( NEW!!!)
	Find
		Find..			set Find parameters and search
		Find Again		search for next (previous)
	Events
		Show Events		display Show Events Screen
		Add Event		display Add Personal Event Screen
	Help
		About			the usual

	NOTE: For an easier way (in my opinion) to get to actual Menu Commands
		  use the Menu Commands (!) button.

==================
Show Events Screen
==================

-	List (sorted, scrollable) of descriptions of all Personal Events
-	Below the list is the Hebrew date of the selected event displayed in bold
	note: this is the date of the initial event
-	Below this is the Gregorian date for the next occurence of the event.
	note: this next date is relative to the current date selected on the 
	Main Screen (not necessarily today).
-	To the sides of the gregorian date are the Previous and Next buttons,
	used to find the Next and Previous Gregorian dated for
	this event.
	If there is no Previous event, i.e. the Event was added with the year
	being significant then the Previous button will not appear.
-	"Del" button to delete selected event
	If selected a "Are you sure ?" prompt will be issued.
-	"Add" button to access Add Event Screen
-	There is no Edit Event option (yet ?)
	To change an event Delete it and Add it again.
-	"N"/"D" pushbuttons control sorting of list
	N - Events are sorted by Name (description)
	D - Events are sorted by next occurrence Date
		(relative to current date on Main Screen)
-	"Done" button to get out of here
	

================
Add Event Screen
================
	
	This screen is used to add a new event.
	In the Main Screen go to the desired date and then use the
	"Events"/"Add Event" menu item (or from the Show Events Screen)

-	Hebrew date for the Event is shown on top in bold
-	Gregorian dat is shown under this
-	To the right of the Gregorian date are the d(ay)/n(ight) pushbuttons.
	If the required date is being determined by the Gregorian date then
	make sure to select whether the event happened before or after night-fall
	because the Hebrew date changes at night-fall.
-	Eneter a description in the description text entry field
-	Select the type:
		B(irthday),
		Y(ahrzeit) - anniversary of death
		A(nniversary) - general event
-	Select whether the initial year is to be considered:
		Y(es) / N(o)
	Events with an initial year will not be displayed prior to the
	initial date.
-	Cancel button - get out of here
-	OK button - store date and get out of here
	note: if the description text has not been enetered then the OK
	button will not work.


==========================			
General Preferences Screen
==========================			

-	HolyDays:		Select either Israel HolyDays or Diaspora HolyDays
-	Show			Determines which types of HolyDays/Events to mark and display
					Press select button to activate HolyDay/Event Type Screen
-	First Month:	Which month appears first in months pop-up list
-	Summer Time		Indicate whether Summer time is currently in effect.
					Useful only if Zmanim option installed


=========================			
HolyDay/Event Type Screen
=========================
	Used from Preferences screen and Datebook screen.
	Select the type of events to mark/display.

	Major			Major HolyDay
	Secondary		Secondary HolyDay/Date
	Minor			Minor HolyDay
	Shabbat			Regular Shabbat (+ Parsha)
	Spcl Shabbat	Special Shabbat
	Lists			- not yet implemented -
	Omer			Sefirat HaOmer
	Event			Personal Event

		PLEASE - No arguments as to what constitutes
				 Major/Secondary/Minor HolyDays

===============
Datebook Screen
===============

	Used for entering HolyDays/Events into the Palm Datebook app.


	When:	Select from
				Today,
				Hebrew Month
				Rest of Hebrew Month,
				English Month
				Rest of English Month
				Hebrew Year
				Rest of Hebrew Year,
				English Year
				Rest of English Year

	What:	Determines which types of HolyDays/Events to enter
			Press select button to activate HolyDay/Event Type Screen

	Note:	Determines whether all HoyDays/Events for a given day are
			to be entered as one untimed event or as separate untimed
			events for each HolyDay/Event

			If one event then the text field specifies the text for the
			event.


===========
Find Screen
===========

-	Text (not case sensitive)
-	Fwd / Back, search forwards or backwards from current date



In future releases:
*******************
*	Respond to Find
*	Zmanim = Times.
		Candle lighting etc.
		Sunrise, Sunset, earliest/latest shma etc. etc.
*	Improved efficiency, in terms of time and space.
*	HEBREW DISPLAY !!
*	Much better documentation
*	"On line" help AND explanations of HolyDays etc.
*	Better documentation
*	Avoid duplicate datebook entries
*	etc. etc.


			The main feature which I would very much like to implement is
			Zmanim (including candle lighting times). I have done some
			preliminary work towards this.
			However, for various technical reasons, I will probably	implement
			this only for PalmPilot models and not the Pilot 1000 and 5000 models.
			Unfortunately I do not have a PalmPilot and so my development
			is considerably hampered :(.
			Be patient and all will resolve itself somehow.

Known Limitations and Bugs
**************************

*	Don't try to go to a date that is beyond the Pilot's range
	(OK, I know that's the first thing you"l do :)

A Note On The Name - Tamar
**************************

For those of you who have asked - it is not my wife, daughter or
girlfriend.

Tamar is the Hebrew word for a date (the edible variety - one of the
seven species with which the land of israel is blessed)
So Tamar is a play on words - get it date, calendar.
In fact this name was given before the Pilot became the Palm. Now
it is even more "appropriate" as where do you get a date (Tamar) form ?
Why from a Palm of course !


"Payment"
*********
If you consider this application useful and you continue to use it
please consider it as:
	1. 	TzedakaWare (CharityWare)
			Make a donation to your favorite charity and let me know
or
	2.	DafWare
			Learn a daf and let me know
or
	3.	DTWare
			Send me a DT (Dvar Tora)

	(If you don't understand options 2 or 3 then use option 1).


Acknowledgements
****************
*	The Hebrew date calculations were taken from Edward M. Reingold's
	site on the Web.

Feedback / Bug Reports / Suggestions
************************************

Tamar can be found at:
	http://members.tripod.com/~YakirH/Tamar.html	
I can be contacted at:
	hyNeni@poetic.com
Please include the word "tamar" somewhere in the subject.


Release History
***************

0.5_beta - 19/March/1997 - 10/AdarB/5757
----------------------------------------
	Initial release

0.6_beta - 31/March/1997 - 22/AdarB/5757
----------------------------------------
	Added Diaspora HolyDays
	Added prev/next month selection
	Added Israel/Diaspora preference
	Added First-Month preference
	(slightly) better documentation

0.61_beta - 14/April/1997 - 7/Sivan/5757
----------------------------------------
	Fixed Omer bug in Iyar
	Added Show On Tap preference

0.7	(NOT OFFICIALY RELEASED)
-----------------------
	No longer beta - registered with Palm (USR)
	Improved display and user interface
	Fixed Shabbat Mevarchim bug


0.8	- 18/June/1997 - 13/Sivan/5757
-----------------------
	Added Find (?) by name
	Fixed minor Rosh Hodesh bug

0.81 - 22/June/1997 - 17/Sivan/5757
------------------------
	Bug fixes (Purim was missing and others)

0.9 - 24/December/1997 - Chanuka 5758
------------------------
	Changed Main Screen holiday/event indications
	Added Personal Event support
	Added 10 Tevet
	Fixed sometime Parshat HaHodesh bug
0.91 - 29/December/1997 - Chanuka 5758
------------------------
	Added Parshat HaShavua
	Replaced Find (?) button with Menu (!) button on Main Screen
	Fixed bug with event + more than 1 HolyDay
	Added Shabbat Hazon & Shabbat Nachamu
0.92 - 28/January/1998 - 1/Shvat/5758
------------------------
	Fixed bug in Parshiot (Torah readings) of some years
	Added T'U b'Shvat

1.0	 - 3/September/1999 - 22/Ellul/5759
---------------------------------------
	Datebook integration
	User Interface improvements
	Preferences changes