*********************************** 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