19 February 1995
                           HEBREW CALENDAR for WINDOWS
                        Version 7.2 and 7.21 and Updates
                           ===========================
FEATURES
--------
     *Covers 600 years: Common 1600-2200, Hebrew 5360-5960
     *Convert dates from Common-to-Hebrew or Hebrew-to-Common
     *Instantly display dates on dual calendars with holidays; sunrise,
      sunset, Shabbat candle lighting and ending times; and Hour-of-Time 
      (Sha'a Zmani) and full Zmanim
     *QuickDate feature for rapid date entry or conversion
     *Mini-Floating Window option, alway stays on top of other applications
     *Accurate sunrise/sunset times at user-defined location
     *Print full month calendars with Truetype fonts showing both dates,
      holidays, and times
     *Holiday/observance lists for each year
     *Israel/Diaspora preference selectable
     *First-of-Month relationships for each year
     *Shabbat (annual cycle) and holiday Torah/Haftarah readings
     *12/24-hour time formats
     *Shabbat candle lighting and ending times with respect to sunset with 
      selectable defaults or specific locations can be set independently
     *Selectable date formats (MM-DD-YYYY and DD-MM-YYYY)
     *Yahrzeit and birthday anniversaries with selectable printing range
     *Personal anniversary database shows date of next observance
     *Geographic database for cities
     *Readings and holiday descriptions in user-editable text files
     *Direct access to Windows Cardfile and Notepad for personal information
     *Windows Clipboard and Printer support
     *Point-and-click user interface

INSTALLATION
------------
a) From Supplied Disk: Run SETUP on the installation floppy disk from 
Windows.

b) From ZIP File: UnZIP to a subdirectory such as HEBCAL. Install 
HEBCALW.EXE in a Windows program group. You must have VBRUN300.DLL in your 
Windows System subdirectory to run HEBREW CALENDAR. If you don't have this 
run-time library, it is probably available from the same source where you 
acquired HEBREW CALENDAR.

If you have registered, enter your name and ID number EXACTLY as received
on the Information & Registration selection on the Main Menu. SAVE A COPY OF
YOUR ID NUMBER!!!!! If you lose it, contact the Calendar Maven.

INSTALLATION PROBLEMS
---------------------
ID Number Not Recognized as Valid - Your registered name and number must be
entered exactly as received. This includes spaces, punctuation, and any 
ampersands.

DDEML.DLL Cannot Be Installed - Ignore and continue with installation.

Setup Cannot Install Some Files - May be related to VER.DLL in your Windows
System subdirectory. Rename it VER.DL_ and run Setup again.

Colors Are Wrong - May be related to THREED.VBX. If this file is in your
Hebrew Calendar subdirectory, try copying it to your Windows System
subdirectory.

COMMDLG.DLL Warning - This file is being used by another and probably
non-obvious program. Enter IGNORE.

If problems persist, contact the Calendar Maven. DO NOT contact PsL, 
Compuserve or anyone else.

UPGRADING/UPDATING FROM PREVIOUS VERSIONS
-----------------------------------------
This version may be installed directly over previous versions since 7.0. If
you are currently using an older version, delete all previous files or
install to a new directory.

Starting with Version 7.0, the format of HEBCAL.CFG and CITIES.DAT was
changed. Older format files will not work properly with newer versions of 
HEBREW CALENDAR.

This version will not overwrite HEBCAL.CFG, PERSONAL.DAT, HEBCAL.TXT or
HEBCAL.CRD.

UPGRADES AND UPDATES
--------------------
An "update" corrects bugs and problems or makes some minor program
improvements. An "upgrade" represents the incorporation of major 
improvements or features. 

Updates:
At present, there are no plans to charge for updates. New versions are
regularly posted to America Online (AOL), Compuserve (CIS) and Internet.
     Look for filenames with format HBCL*.ZIP:
          AOL:       Keyword SOFTWARE CENTER, search JoeMKohn
          CIS:       WINDOWS SHAREWARE Forum, search 74651,116
          Internet:  ftp oak.oakland.edu SIMTEL/win3/calendar

If you prefer, a 3-1/2 inch floppy disk with the latest version may be 
ordered directly from the Calendar Maven for US$6 (cash, check or money 
order) to cover shipping and handling. This disk is not available through
PsL or Compuserve.

Upgrades:
Registered users must re-register to obtain a new ID number.

If you have registered HEBREW CALENDAR within the past 60-days, the upgrade
is free by contacting the Calendar Maven directly for a new ID number. DO 
NOT contact PsL or Compuserve.

If you registered more than 60-days ago, the upgrade fee is US$10, add US$3
for a disk with the latest version. This payment may be made through the 
same methods as regular registration, see below.

COPYING AND DISTRIBUTION
------------------------
HEBREW CALENDAR is distributed as shareware and may be copied and 
distributed without fee other than for nominal distribution costs. The 
distribution files must not be altered in anyway. You may give copies to 
your friends and any other interested parties.

The distribution of the intact, unaltered ZIP file is encouraged! Feel free
to upload to your favorite BBS, online service, or Internet FTP.

If registered, you may NOT give your personal ID number to anyone.

FREE EVALUATION
---------------
As shareware, you can evaluate the program free of charge.  If you find 
HEBREW CALENDAR useful and continue to use it, you must register and pay the 
required fee.

LICENSE AND DISCLAIMER
----------------------
HEBREW CALENDAR is licensed for the personal use of the registered user on
two computers, for example, work and at home.

Every effort has been made to ensure the accuracy of HEBREW CALENDAR, 
however, the Calendar Maven assumes no liability for errors, problems, or 
consequences due to its use.

The Calendar Maven reserves the right to make changes, corrections and 
improvements without notification or obligation.

HELP
----
The only form of help available within HEBREW CALENDAR are the ABOUT... 
buttons and the Help panels at the bottom of most of the Windows. The Help 
panels display context sensitive information relevant to particular controls
or the location of the mouse cursor.

QUICKDATE
---------
QuickDate provides the means for direct date entry, either Common or Hebrew.
This can be used for quick date conversion or as a "go-to-date" capability
in the Calendars.

From the Main Menu, QuickDate provides a miniature Window that can provide a
convenient means of converting dates for use in other applications. As an 
option, QuickDate can be made to "float," staying on top of all other 
applications, or can be selected to startup immediately upon starting HEBREW
CALENDAR.

TORAH/HAFTARAH READINGS
-----------------------
Shabbat readings are based on the annual schedule defined in Arthur Spier's 
"The Comprehensive Hebrew Calendar." Readings may be accessed from the 
Calendar and Readings Window using either the Readings button or clicking 
the right mouse button on a Saturday or holiday.

MODIFYING HOLIDAY DESCRIPTIONS AND TORAH/HAFTARAH READINGS
----------------------------------------------------------
The descriptions and readings are contained in separate text files, 
HOLIDAYS.DAT and READINGS.DAT, respectively. This allows SKILLED users to 
make changes to match preferences. Instructions are noted in each file. DO 
NOT attempt to make changes unless you are familiar with text file formats
and editing. Since weekly readings may draw from several different 
selections, the user is cautioned when any making changes. The most common 
changes might be to edit selections showing optional Sephardi and Ashkenazi 
rituals to indicate one's specific preference.

ANNIVERSARIES
-------------
You may determine both birthday and yahrzeit anniversaries, which have
slightly different rules. The birthday feature may be used for general
anniversaries as well.

COMMON YEARS AND THE GREGORIAN CALENDAR
---------------------------------------
As used in HEBREW CALENDAR, the Common dates follow the classic Gregorian
calendar devised in 1582. The Gregorian calendar was NOT universally 
adopted. For example, the United States and United Kingdom did not make the
change until 1752. Therefore, users are advised to determine what calendar
rules apply in different countries, especially when researching older dates.

SUNRISE/SUNSET TIMES
--------------------
HEBREW CALENDAR uses a new improved algorithm which appears to be accurate 
to within a minute or two at sea-level. If you find that the sunrise/sunset
times are not accurate enough for your requirements, you may need to input 
the elevation for your location using Location Setup from the Main Menu. 
Your local elevation above sea-level, can be obtained from local weather 
bureaus, maps, or airports. With elevation correction, the algorithm should 
provide sea-level accuracy at your location.

SHABBAT CANDLE LIGHTING AND ENDING TIMES
----------------------------------------
HEBREW CALENDAR provides default times of 18 minutes and 45 minutes, 
respectively, for candle lighting on Friday and the end of Shabbat on
Saturday. These defaults may be changed in Preferences from the Main Menu.

Recognizing that local customs may vary, these times may be set
independently for each location using Location Setup from the Main Menu. For
example, Jerusalem candle lighting can be 40 minutes without changing the 18
minute candle lighting in New York City.

CITY LIST
---------
The city list for sunset setup has been greatly expanded through the help of
Joseph Lattke (Gateshead Ltd.). 'Yosef' is affiliated with LUACH (Calendar),
a Jewish BBS. You can login to LUACH at 1-201-656-3942.

Except as noted, all cities in the supplied database use a default elevation 
of 0 meters and the default Shabbat times. Jerusalem has a candle lighting 
time of 40 minutes. Canton, Ohio has an elevation of 366 meters.

ORDERS, REGISTRATION, UPDATES AND UPGRADES
------------------------------------------
To avoid the annoying reminder messages you must obtain a user ID number by
registering. All required information and registration assistance can be
accessed from the "Information & Registration" selection on the Main Menu.

You may register/upgrade by:

     a) Cash, check or money order payable in US funds/banks.

          * US$24 for registration and a FREE 3-1/2 inch disk with the 
            latest version of HEBREW CALENDAR.

          * US$6 for 3-1/2 inch disk with the latest version of 
            HEBREW CALENDAR. Does not include registration.

          * US$10 for upgrade re-registration only (no disk).

          * US$13 for upgrade re-registration and 3-1/2 inch disk with the
            latest version of HEBREW CALENDAR.

          You must specify version number of HEBREW CALENDAR being 
          registered.

          Send cash, check or money order, payable in US funds/banks, to:

               Joseph Kohn
               The Calendar Maven
               4333 Larchwood Circle, NW
               Canton, OH 44718-2117
               USA

     b) Mastercard, Visa, American Express or Discover Card

          * US$24 for registration only (no disk).

          * US$27 for registration and 3-1/2 inch disk with the latest 
            version of HEBREW CALENDAR.

          * US$13 for upgrade re-registration and 3-1/2 inch disk with the
            latest version of HEBREW CALENDAR.

          You must specify version number of HEBREW CALENDAR being 
          registered.

          You must provide the exact name on your charge card and use the
          charge card billing address.

          Charge card registration is available from PsL:

             Product Name:                   Hebrew Calendar Version 7.2
             Product Number:                 11546
             Product Version:                7.2

             Mailing Address:                PsL
                                             PO Box 35705
                                             Houston, TX 77235-5705
                                             USA

             Toll-Free Voice in USA Only:    800-242-4775
             Outside USA:                    713-524-6394
             FAX:                            713-524-6398

             Compuserve:                     71355,470

          NOTE: PsL CANNOT PROVIDE YOUR USER ID NUMBER OR DISK!!!

          PsL forwards your order information to the Calendar Maven!!!

          CONTACT PsL TO PLACE ORDERS ONLY!!!

          CONTACT THE CALENDAR MAVEN (SEE BELOW) FOR ORDER INQUIRIES
          AND ANY MATTERS RELATED TO HEBREW CALENDAR!!!

     c) Compuserve Shareware Registration

          Go SWREG.  

          * Search ID: 4176
            Registration:             US$24, registration only (no disk).

          * Search ID: 4177
            Upgrade Re-Registration:  US$10, re-registration only (no disk).

          NOTE: COMPUSERVE CANNOT PROVIDE YOUR USER ID NUMBER!!!

ALLOW TIME FOR ORDER PROCESSING AND MAILING, ESPECIALLY OUTSIDE THE US.

CONTACT THE CALENDAR MAVEN (SEE BELOW) IF YOU HAVE ANY ORDER PROBLEMS!!!
DO NOT CONTACT PsL OR COMPUSERVE.

TECHNICAL SUPPORT
-----------------
Contact the Calendar Maven.
DO NOT contact PsL, Compuserve, or anyone else.

PRICING/QUESTIONS/SUGGESTIONS/ORDER INQUIRIES
---------------------------------------------
Contact the Calendar Maven.

Ask about:
          *Quantity discounts
          *Site licenses
          *Fund raising
          *Customization

----------------------------------------------------------------------------
                             THE CALENDAR MAVEN
----------------------------------------------------------------------------
     Mailing Address:                        Joseph Kohn
                                             4333 Larchwood Circle, NW
                                             Canton, OH 44718-2117
                                             USA

     America Online:                         JoeMKohn

     Compuserve:                             74651,116

     Internet:                               joemkohn@aol.com
----------------------------------------------------------------------------

VERSION HISTORY
===============
7.2c -950211 Fixed Adar yahrzeit bug. Re-wrote yahrzeit code. Corrected 
             Birthday database next observance. Reduced frequency of "nag
             messages."
7.21d-950125 Added routine UpDateMinIconDate to refresh date on minimized 
             icons at midnight.
7.21c-950121 Can no longer save location as default unless registered.
7.21b-950111 Improved appearance and user interface of spin button boxes.
7.21a-950108 Fixed problem with reading first city in city list. Version 
             equivalent to Kivun Version 1.0.
7.21 -950106 Added Minimize button to Quickdate form.
7.2a -950101 New this version: 600 year coverage, Shabbat candle lighting 
             and ending times (user selectable preferences), Sha'a Zmani 
             and full Zmanim, birthday anniversaries, holiday readings, 
             improved speed and readability on Calendars, QuickDate 
             mini-Window, direct year entry, improved accuracy 
             sunrise/sunset algorithm. Re-registration required as an 
             upgrade.






