Date: Tue, 04 Feb 92 21:40:53 -0500
From: Kamal Abdali <k.abdali@acm.org>

PRAYSCHEDULER is a program to produce pleasant looking Islamic prayer 
time schedules for any location.  The schedules can be "perpetual" or 
for any desired year.  The (fiqhi) variations of computing methods are 
under user control.  Geographical data about the location is read from
standard input, and the TeX code for the schedule is written to
standard output .

This directory contains the following nine files:

   README.txt --- This file.
   prayscheduler.c, prayscheduler.h --- C source and header files.
   prayscheduler.man --- Manual page file in Unix troff/tman style.
   prayscheduler.1, prayscheduler.pdf --- Manual page in ASCII, PDF.
   dc2013.dta, dc2013.tex --- Input, output for testing the program.
   dc2013.pdf --- PDF output when dc2013.tex is processed by TeX.

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

   cc -O -o prayscheduler prayscheduler.c -lm

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

   ./prayscheduler -r1 -a15 < dc2013.dta > out.tex
   diff out.tex dc2013.tex > 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 to

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

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