[[ TAGHVEEM.TXT : 2111 in TAGHVEEM.TXT ]]

TAGHVEEM is a Jalali calendar program for Windows. It has been tested under Windows
3.1 both in standard and enhancement mode. I have no access to Windows 3.0. To load
the program, ftp TGHVM.EXE from TEHRAN.STANFORD.EDU. This is a self extracting
executable. Copy it to a directory where you want to run the calendar program from
and execute it from DOS command. It produces the following files:

  - taghveem.exe  This is the executable file.
  - taghveem.ini  Contains some parameters. This file must reside in the same
                  directory as taghveem.exe
  - bwcc.dll      This is a Borland DLL. Copy it to a directory in your PATH.
                  If you already have this file on your system, you can delete this
                  copy.
  - taghveem.txt  This file.

After the installation, you can run the program from Windows like any other
Windows program. Before running the program, be sure you have installed Parsziba
font also available from TEHRAN.STANFORD.EDU.

The program has two windows. None of the windows have title bar but both can be
resized and moved. The location and size of the windows will be stored in .ini
file and is used in the next session. Both windows have a menu that can be
activated by double clicking the left mouse button anywhere in the window
client area. All the menu items have short cut keys. The menus are not displayed
where you expect it. This is bug that I have not been able to solve :-( But I
have found the use of short cut much more easier.

The main window, which is displayed upon program startup, shows day of the week,
day of the month, month, and current local time. The month and day of the month is
in Jalali calendar. The menu of this window contains the following entries. The short
cut keys are given in ().

Month (Alt+m)     Displays the month window (discussed below).
Iran Time (Alt+t) Toggles between Iran and local time (discussed below).
Minimize (Alt+i)  Minimizes the window.
Restore (Alt+r)   Restores the window.
Exit (Alt+F4)     Terminates the program.

The second entry toggles the time in the main window between Iran time and local
time. When the window shows the Iran time the text of this menu entry reads "Local
Time" and an Iranian flag is displayed in the window. For the Iran time to be
displayed correctly, the environment variable TZ must be set according to the
following guide line (taken from help file of Boraland C++ compiler). Use SET
command in your autoexec.bat file to set TZ. 

[start of Boralnd help file entry]

This is the format of the TZ environment string: 

TZ = zzz[+/-]d[d][lll] 

Component  	What It Represents

zzz  	    Three-character string representing the name of the current   time zone. 
            All three characters are required.  

[+/-]d[d]   Required field containing an optionally signed number with 1 or more 
            digits. This number is the local time zone's difference from GMT in
            hours.   
              - Positive numbers adjust westward from GMT.   
              - Negative numbers adjust eastward from GMT.   
           This number is used in the calculation of timezone.  

lll        Optional three-character field that represents the local time zone's 
           daylight saving time.   
             - If this field is present, daylight is set to non-zero.     
             - If this field is absent, daylight is set to 0.   

[end of Boralnd help file entry]

Daylight saving time in Iran starts from the first day of Farvardin and end the first
day of Mehr. TAGVHEEM takes care of this change. The setting of this toggle will be
retained between session.

The month window, which is invoked by selecting Month entry of the main window menu,
displays the calendar of the current Jalali month. The menu of this window contains
the following entries. The short cut keys are given in ().

Current Month (Home)       Displays the page for th ecurrent month.
Next Month (Page Down)     Advances the currently displayed page by one month.
Last Month (Page Up)       Opposite of the above.
Next Year(Shift+Page Down) Advances the currently displayed page by one year.
Last Year (Shift +Page Up) Opposite of the above.
Specific Month(Insert)     Displays a dialog box to choose specific year and month.
Minimize (Alt+i)           Minimizes the window.
Restore (Alt+r)            Restores the window.
Close (Alt+F4)             Closes the month window.

I like to thank Ali Moayedian (Mash Cheragh Ali) for furnishing the software that
converts between Jalali and Georgian calendars, Tooraj Enayati for his Parsziba
font, and Noushin Bashir for providing the beautiful taghveen icon. The Zodiac
symbols were digitize from a corss-stitch book (You should have seen my wife's
impression when I came home from the library with a cross-stitch book). The
credit for the "Iran Time" option goes to Noushin and Toraj for suggesting it.

If you have any comments, suggestion, or complains, please E-mail the to 
aaalavi@ingr.com.

Ahmad Alavi
July 12, 1993