PawDate User's Manual

Covers PawDate version 1.0.2

Last updated September 5, 2000. See the PawEng web page for information on the latest version, or send e-mail to info@paweng.com. Comments or bug-reports are welcome.

[Description]   [Installation]   [Registration]   [Using PawDate]   [Known Bugs]   [What's New]

Description

PawDate is a program for keeping track of events and holidays. Do you want to know on what date Easter Sunday falls? How about Martin Luther King's birthday? Or Corpus Christi, Trinity Sunday or Rush Hashanah? With PawDate you can answer all these questions. You can even add your own holidays or events.

PawDate comes with American, Brazilian, British, Danish, French, German, Italian, Portuguese and Spanish holidays as well as European royal birthdays, ecclesiastical holidays, Jewish holidays, U.S. state observances, and dates for the great lent and paskha.

PawDate works under PalmOS 2.0 and higher. Copyright ⌐ 2000 Poul F. Williams. All Rights Reserved.

PawDate is distributed as shareware. You are welcome to evaluate PawDate before you register. Once you register, you will be able to use the full version of PawDate. Without registration you are limited to the events in the year 2000.

The LICENSE file gives the license details -- be sure to read it before you install or use PawDate.

[Top]

Installation

Before you install PawDate, make sure that:

PawDate is distributed as a standard PRC file. Install "PawDate.prc" like a regular application program using your favorite install tool, for example HotSync for Windows.

Now you need to install the event lists you are interested in. Choose one or more of the following:

American Holidays
U.S. State Observances
Brazilian Holidays
British Holidays
Danske Helligdage (Danish Holidays, in Danish)
French Holidays
German Holidays
Italian Holidays
Portuguese Holidays
Spanish Holidays
European Royal Birthdays
Ecclesiastical Calendar
Jewish Holidays
Great Lent and Paskha -- curtesy of Kersti Juva (kjuva@iname.com). (Some orthodox churches follow the western calendar -- they should remove the word "Orthodox" from the file.)

Open the "Memo Pad" application. Create a category called "PawDate" (without the quotes but with the correct capitalization). Copy each of the above event lists into its own memo within the "PawDate" category. This can be done using, for example, the Palm Desktop application for Windows. Refer to your Palm manual for more information on how to transfer memos from a PC to your Palm.

Start PawDate. If you have done everything correctly, then the "Select event list" popup list will let you choose from the event lists you have installed.

[Top]

Registration

PawDate is shareware. Until you register, PawDate only handles events for the year 2000.

The advantages of registration are:

When you register you will receive a registration code. Start PawDate and select the menu "Help" and the item "Registration". Enter the code at the prompt and press the "Okay" button. That's it!

Please make sure you have the newest version of PawDate. The newest version will be available on the PawEng web page.

Registration Fees

Fee in USD : $10
Product ID : 136364

Be sure to check the current fees on the PawEng web page.

You can pay by credit card (Visa, Eurocard/Mastercard, American Express, Diners Club), wire transfer, EuroCheque, or cash. (If you want to pay in another way, please contact ShareIt! -- see their address below.)

You can pay in either USD or EURO.

The fee is non-refundable.

How to Register

The registration process is handled by ShareIt! You can register on their secure Internet site, via phone, fax or postal mail.

Via Internet

Go directly to PawDate's Registration Page. Alternatively you can visit http://www.shareit.com and enter the Product ID 136364.

Enter your credit card information and the registration code will be sent to you via email.

Via Phone

Call +49-221-2407279. US and Canadian customers may also order by calling toll-free 1-800-903-4152.

Via Fax or Postal Mail

Please print out the following form, and fax or mail it to:

element 5 AG / ShareIt!
Vogelsanger Strasse 78
                             <-- blank line
50823 Koeln
Germany

Phone:  +49-221-2407279
Fax:    +49-221-2407278
E-mail: register@shareit.com

US checks and cash orders can be sent to the US office:

ShareIt! Inc.
PO Box 844
Greensburg, PA 15601-0844
USA

Phone: 1-724-850-8186
Fax:   1-724-850-8187
Registration Form for PawDate
Registration Form for PawDate
-----------------------------

Product ID:   136364

Product Name: PawDate

Last name:    __________________________________

First name:   __________________________________

Company:      __________________________________

Street and #: __________________________________

City, State:  __________________________________

Postal code:  __________________________________

Country:      __________________________________

Phone:        __________________________________

Fax:          __________________________________

E-Mail:       __________________________________


*** Please do not forget to include your e-mail address. ****
*** We will use e-mail to communication with you.        ****


How would you like to receive the registration code?   (circle one)

e-mail   --   fax   --   postal mail


How would you like to pay the registration fee?   (circle one)

credit card  --  wire transfer  --  EuroCheque  --  cash


Credit card information (if applicable)

Credit card:   (circle one)

Visa  --  Eurocard/Mastercard  --  American Express  --  Diners Club

Card holder:  __________________________________

Card No.:     __________________________________

Expiration Date:  ______________________________

Date / Signature: ______________________________
[Top]

Using PawDate

The main window in PawDate consists of a number of popup lists, a year selection, and a large area for displaying events.

PawDate organizes events in event lists. The top popup list lets you select from the event lists found on your Pilot. For example: "American Holidays" or "European Royalty". Below the event list popup, there are two other popup lists called "Month" and "Event". The former popup list lets you select a month. PawDate will then display all the events in the currently active event list which occur in the month. The latter popup list lets you select an event from the currently active event list. PawDate will then tell you on which day the event takes place. The year selection tells PawDate which year you are interested in.

Tap with the stylus on a date to see bring forth a calendar.

By selecting the menu item "Next event" you get the next event in the current event list. For example, if today is October 30, 2000, "Next event" will get you Halloween on October 31, 2000 assuming you are using American Holidays as your event list.

The menu item "Clear display" erases the previous events from the screen.

Event Lists in Memo Pad

You can write your own event lists in the built-in Memo Pad application. On startup, PawDate reads all memos in the category named "PawDate" and treats them as event lists.

Event lists must follow a strict syntax. The first word of an event list is the name of the list itself. This name must be in quotes. Then follows a series of event names and date descriptions. The event names must be in quotes. The date descriptions describe the dates of events.

A simple date is written "month day":

It is also possible to get the first, second, third, fourth, or last weekday in a month:

The date of Easter Sunday (both the western and the orthodox Easter) can be obtained as follows:

Jewish dates may be obtained in the following way:

All the above descriptions may be modified by adding or subtracting a number of days:

Some Jewish dates get postponed from Saturday to Sunday, and some advance from Friday/Saturday to Thursday:

Simple dates may be conditioned upon a given day of the week. For example, in America "December 24" is a holiday only if it falls on a Friday.

It is possible to find the nearest, the following and the previous day of the week to a date:

If, for example, "July 4" falls on a Monday, then "Monday after July 4" is July 4 (and not July 11). The same is true for "before" and "nearest".

You can also add or subtract days from these kinds of dates. However, be careful! You may need TWO additions or subtractions:

Note that no modification to a date can cause a change in the year. If it does, the result is an error.

The following is a simple example of an event list:

In the section Installation you will find a number of examples of event lists.

[Top]

Known Bugs

None.

[Top]

What's New

Version 1.0.2, September 5, 2000: Added Brazilian, Portuguese and Jewish holidays, U.S. state observances, and dates for the great lent and paskha. Fixed bug in "Next event" function.

Version 1.0.1, August 26, 2000: Fixed some bugs to make it run on OS 3.5.

Version 1.0, August 12, 2000: First release.

[Top]
Copyright ⌐ 2000 Poul F. Williams. All Rights Reserved.