Date: Sun, 19 Apr 98 13:08:53 -0500
From: Kamal Abdali <k.abdali@acm.org>

PRAYTIMER is a program to produce daily, monthly, or yearly Islamic
prayer hour schedules for any location.  The schedules can be "perpetual"
or for any desired year.  The (fiqhi) variations of computing methods are
under user control.  

The program can be used in batch mode or interactively to produce in each 
session as many schedules as desired.  In batch mode, the data is read 
from standard input, and the schedule is written to standard output.
In interactive mode, the user is prompted on the terminal (stderr) for
location name, geographical data, and the schedule date, month or year. 

This directory contains the following seven files:

   README.txt --- This file.
   praytimer.c --- C source code.
   praytimer.man --- Manual page file in Unix troff/tman style.
   praytimer.1, praytimer.pdf --- Manual page in ASCII, PDF.
   dc2013.dta, dc2013.out --- Input, output for testing the program.

The source is quite portable.  To compile the program under Unix, 
the following command should work:

   cc -O -o praytimer praytimer.c -lm

Please make sure that the program works by testing it on at least the
data provided.  Under Unix, try these commands:

   praytimer -r1 -a15 < dc2013.dta > out
   diff out dc2013.out > out.diff

The file out.diff should be empty, or should contain only occasional 
differences of at most one minute in some prayer times.  Larger errors
are most likely due to insufficient arithmetic precision.  The program 
uses these numeric types: SHORT, LONG, FLOAT, and DOUBLE.  For correct 
results, their sizes in bytes must be at least 2, 4, 4, and 8, 
respectively, and the intermediate floating point arithmetic must be 
carried out in double precision.

Please report bugs by e-mail to 

    Kamal Abdali
    k.abdali@acm.org, kabdali@gmail.com, or kabdali@yandex.com

The code for PRAYTIMER has been derived by Kamal Abdali from his 
Minaret program.
