The Book of Islam

RELEASE V0.19b, FRIDAY 18th AUGUST 1995. (Freeware)

In the name of Allah, the Beneficent, the Merciful.

CONTENTS
[1] 	INTRODUCTION
[2] 	USAGE
[3] 	A QUICK RUN/INSTALL
[4]	COMMENTS AND CONTRIBUTIONS
[5] 	FULL INSTALLATION
[6]     UPGRADING FROM A PREVIOUS VERSION
[7]     FILE CRC'S
[8]     FREEWARE STATUS

To jump to a particular section, use the search facility on your
viewer/editor to search for "[x] " where x is the section number.

[1] INTRODUCTION

Welcome to The Book of Islam, this is a project whose aim is to produce
a multimedia hypertext version of the Quran and other Islamic writings.

This current version is a beta test version. Hence you may find errors
and omissions.

[2] USAGE

In order to run this package, you will need a PC compatible running MS
Windows V3.1. This package uses the Windows help engine, thus
winhelp.exe must be accessible by windows.

The package follows the winhelp philosophy of hypertext links, refer to
your Windows manual or Help|How to use help.

[3] A QUICK RUN/INSTALL

This package can only be run from a hard disk due to it's size. The
program executable is "ISLAM.HLP". Copy this into a directory of your
choosing, and then run as an executable from Windows.

If this method fails, try running winhelp.exe which should be
located in your windows directory, then choose file|open, islam.hlp.

I am able to provide limited technical support on this package via
e-mail (u2i06@bilbo.teach.cs.keele.ac.uk)

If you wish to uninstall the package just delete the file islam.hlp. If
you wish to continue using the Book of Islam please refer to the full
installation section.

[4] COMMENTS AND CONTRIBUTIONS

If you wish to comment or add to this package with additional writings,
errors or with your views, please feel free to e-mail
u2i06@bilbo.teach.cs.keele.ac.uk or write to; Yasin Poptani, 111 Arundel
Drive, South Harrow, Middlesex, London, United Kingdom. HA2 8PW. Please
send contributions in plain unformatted ASCII.

Unfortunately in order to keep the Book of Islam relatively small, I
have removed the Picture Gallery from the package. I shall be working on
an independent viewer at a later stage to be packaged as the graphics
pack.

A sound pack (issnd001.zip) is available from the same source to be used
in conjunction with this package. You will need a sound card together
with the Microsoft ADPCM sound driver, please refer to the readme which
comes with the pack.

[5] FULL INSTALLATION

In order to maximise the ease of use, and to prepare your system for
updates or even add-ons such as the sound pack or the upcoming graphics
pack, it is recommended that a full installation is followed.

* Create a directory by opening File Manager, using the option
File|Create Directory.

* Copy the program files into the directory by dragging their icons into
the directory folder.

* Open Program Manager and select a program group that you want The Book
of Islam to reside in. Select File|New|Program Item to bring up the
program properties dialog box.

* Select Browse to find and select ISLAM.HLP. 

* Select Change Icon to find and select the icon in ISLAM.ICO

* Enter "The Book of Islam" in the description field.

* Select OK to return you to Program Manager. 

Creating a program icon on the program manager has two main effects,
first it gives you ease of access to the program instead of the run
command. It also sets up a working directory which is crucial for The
Book of Islam to find add-ons such as the sound pack.

Note : If program manager cannot execute the Islam.hlp properly then try
WINHELP <DRIVE & DIRECTORY>ISLAM.HLP e.g. WINHELP C:\ISLAM\ISLAM.HLP.
However make sure in this instance that the working directory is set to
C:\ISLAM.

[6]     UPGRADING FROM A PREVIOUS VERSION

To upgrade from a previous version simply copy the new files over the
old.

[7]     FILE CRC'S

The following are the CRC's for all the files that come with this
package. To authenticate these crc's, use pgp together with my public
key obtainable by fingering u2i06@bilbo.teach.cs.keele.ac on this readme
file.

        ISLAM.HLP   : crc16=296E  crc32=C627D834
        FILE_ID.DIZ : crc16=D3E9  crc32=5C493DDC
        ISLAM.ICO   : crc16=2C07  crc32=4E3326B5

If you find that the crc's are invalid please do report this.

[8] FREEWARE STATUS

Compilation Copyright 1995 by Yasin Poptani. Permission to copy and
distribute this material for any purpose and without fee is hereby
granted, provided that the above copyright notice and this permission
notice appear in all copies.  The author makes no representations about
the accuracy or suitability of this material for any purpose.  It is
provided as is, without any express or implied warranties.  The author
will assume no liability for damages either from the direct use of this
product or as a consequence of the use of this product.

Yasin Poptani
(u2i06@bilbo.teach.cs.keele.ac.uk)
