
PrayerMinder-pp V1.2

PURPOSE
  The purpose of this software for the palm pilot is to help
Muslims mind their prayers.  It displays:

 - The Islamic prayer times for the present day, anywhere 
   on the planet Earth.
 - Islamic (Hijri) date (approximate, but adjustable).
 - The direction of Qiblah, and aditionally, can be used 
   to find North and Qiblah by pointing the Pilot
   toward the sun.

It also allows you to set alarms for any
of the prayers, and also for Tahajjud and Shurooq (sunrise).

NOTE: Due to a limitaion in the Palm Pilot, the alarm
times can only be updated when the program is running.
Therefore, whenever PrayerMinder is launched, it
automatically adjusts the alarm timings if prayer
times change.
  So, if you use alarms, you should LAUNCH PREAYERMINDER
EVERY FEW DAYS, so that the alarm warnings will get
updated. Otherwise, alarms will be played and will popup
in a dialog, but the alarm times will not be updated to
match the prayer times.


TO INSTALL
1. Please un-install any version prior to v0.4 by
   running the memory application and tapping Delete Apps,
   then selecting PrayerMinder, then tapping Delete..
2. Backup your old PrayMindDB.PDB database just to be safe.
   The databse can be found in the Palm/[user name]/Backup folder.
   On windows the Pal folder is usually found under
   C:\Program Files folder.
3. Install PrayMind.prc using the install tool that came
   with your Pilot.
4. Install PrayMindDB.PDB only if you have not installed v0.4 or
   later version.
5. Launch PrayerMinder by tapping on its icon. PrayerMinder
   V1.0 will automatically upgrade the older database
   PrayMindDB.PDB.
6. Please use the menu button on the silkscreen to access 
   configurable parameters.

MAILING LIST
Please also join the mailing list so you will be
informed of new releases. The mailing list will hardly
be used because the author is also busy with his regular
work, and cannot devote al his time to improving this
product.

You can join the mailing list by sending a blank
message to:
  prayerminder-subscribe@yahoogroups.com

or visit the PrayerMinder home page at the URL
listed at the bottom of this file, and fill the
form for the PrayerMinderPP mailing list.

THE PACKAGE:
This program is destributed as a package consisting
of a set of files including the following:

 PrayMind.prc	- the program
 PrayMindDB.PDB	- the preferences and locations database
 locations.txt	- contains coordinates etc. for many cities
                  You can get location data by clicking the
                  View Location Data button from the city's
                  prayer times page at http://www.sajda.com/
 ReadMe.txt	- this file
 mathlib.prc	- required math library

REQUIREMENTS

  - OS 3.1 or later
  - mathlib.prc (included)


COPYRIGHT
This software is Copyright Tasmin Ahmad, 1998 - 2003.
This software is charityware/dua-ware. That means you
can freely use and/or distribute the pakaged form of
the software as you wish. You are merely requested to
pray for the author's maGHfirah (forgiveness). You are
also free to send him an encouragement note! 

DISCLAIMER
If you use this software, be advised that you will do so at
your own risk and the author will not be held responsible for
any damage caused by the software.

Revision history:

v1.2 (28 September, 2005) Minor bug fix release
 1. Fixed menu pages not working on Tungsten T5.
 2. Add ability to work with display re-sizing and
    display orientation changes.
 3. Utilize hi-res display on Qiblah Finder screen.

v1.1 (17 June, 2003) Minor bug fix release
 1. Fixed bug of Ka'bah icon not appearing on the red
    arrow on the Qiblah finder screen on OS5 devices.
 2. Fixed bug of Qiblah angle on Qiblah finder screen
    being sometimes different by one degree from the
    angle on the main screen .

v1.0 (3 June, 2003) Sixth release
 1. Added Colors and Grayscale support!
 2. Fixed "Mathlib not found" error if another 
    program uses mathlib.
 3. Re-designed the Qiblah Finder compass to be 
    more attractive.
 4. Revamped alarms by making them more flexible
    and removing the annoying warnings.
 5. Made the Preferences dialog more user friendly by
    providing a list of standard Fajr/Isha methods.
 6. Added Islamic (Hijri) date.
 7. Fixed memory leaks detected by newer development tools.


v0.6 (13 October, 1999) Fifth release
 1. Added Alarms upon popular demand!!! (finally)
 2. Added fajr and isha time calculation method based on
    minutes before susrise, or after maghrib, respectively.
 3. Added day and time display to main screen.
 4. Added more stuff to help screens.
 5. Automatic upgrade of internal database from versions
    0.4. and later.
 6. Added more locations to locations.txt.

v0.5 (13 May 1999) Fourth release
 1. Fixed incorrect Asr time close to the equator.

v0.4 (13 April 1999) Third (Alpha) release
 1. Fixed incorrect Asr time in southern hemisphere.
 2. Added multiple location selection ability.
 3. Qiblah finder is now accessible by tapping the compass on the
    main screen.
 4. Changed displayed name from PrayerMinder to PrayMind so it
    fits with the other icons.
 5. Added automatic backup of modified database to Backup
    directory on HotSync.
 6. Added enough fields in the database so next update won't need a
    un-install and re-install next time.
 7. Improved Fajr/Isha twilight angle selection box.

v0.3 (24 November 1998) Second (Alpha) release
 1. Modified to use C/C++ classes and OOP techniques
 2. Added separate twilight angle selection for Isha from Fajr.
 3. Added Qiblah direction display on main screen
 4. Added menu item "Qiblah..." which brings up a screen
    showing Qiblah and North directions if you point
    the Pilot toward the sun.

v0.2 (20 October 1998) First (Alpha) release


OTHER INFO
I am planning to add more features if I get the time to do
it.  Please send me any suggestions you may have. Even if
you don't have any suggestions, I would still be very pleased
if you would send me an e-mail.

E-Mail: support2@sajda.com
WWW:    http://www.sajda.com/
