Copyright: (C) Enzo Ciaffarafa, 1994 - 1995


Contents

 Anno Domini, v2.15

Copyright (C) Enzo Ciaffarafa, 8th February 1995.

(1) Overview

(2) Installation and Setup

(3) Registration

(4) Using Anno Domini

(5) Troubleshooting

(6) Revisons

(7) Disclaimer


(1) Overview

Anno Domini is a Windows calendar program which is designed to accompany the many personal information managers (PIMs) on the market and has the following features:

•	Display a Gregorian calendar for any month from the years 1753 and 2153 and also display the current date, time, week number, days elapsed and days left in the current year;

•	Display the moon phases for any given month from the year 1753 to the year 2153 and show the dates and times at which the moon phases occur;

•	Display the times of sunrise and sunset for any day between the years 1753 and 2153 for any location around the world;

•	Display the major national holidays and events for England, Wales, Scotland, Northern Ireland, Republic of Ireland, the United States of America, Canada and Europe for any given year until the year 2153 and highlight the next event which will occur in relation to the current date. Also, all of the major Christian festivals including the movable events such as Easter Sunday and Advent Sunday, etc., for any given year from 1753 to 2153 are displayed;

•	On This Day feature which displays for the current date 4 historical events which occurred in the past and the birth dates of 4 famous people from the past and the modern day;

•	Save Reports feature allowing you to store to disk in ASCII text format or output to an attached printer a calendar for the selected year, the times and dates of all the moon phases for the selected year, the times of sunrise and sunset for each week in the selected year and all the national holidays, events and Christian festivals for the selected country and year;

•	System Info feature which displays computer specific information such as memory usage, free hard disk space, time using Windows, selected printer and video driver etc.

•	Minimize the calendar window and see the current day, date and time displayed in the icon along with a view of the current moon phase which is updated on the hour;

•	Select any day on the currently displayed calendar month with the mouse and view the week number, day number and days left in the year, the difference in days between the current date and the selected date along with the times of sunrise and sunset, the number of hours of daylight and any national or world event occurring on that date;

•	View the time zones of all the major countries around the world and select your country specific details from a database of over 500+ cities around the world.


(2) Installation and Setup

To install Anno Domini correctly for Windows, after unzipping the compressed ADOMIN2.ZIP file to a directory of your choice on the hard-disk of you computer, the following 7 files should decompress to your hard disk:

•	AD_215.EXE;

•	AD_HELP.HLP;

•	MOON_SX2.DLL;

•	MOON_DX2.DLL;

•	CHIME.WAV;

•	README.TXT;

•	CTL3D.DLL.

Once this has happened, run Microsoft Windows 3.1 or later and step through the following procedure:

(a) Open up the Program Manager and select a program group in which you wish to store the Anno Domini icon. If you want Anno Domini to be loaded every time you start Microsoft Windows, select the Startup group window.

(b) Select New from the File menu of Program Manager.

(c) Select the Program item radio button from the dialog box and click OK.

(d) The Program Item Properties dialog box should now appear.

(e) In the Description field give the program a name, e.g. Anno Domini.

(f) In the Command Line field enter the full path name of where the Anno Domini executable file is stored on your hard-disk, e.g. C:\A_DOMINI\AD_215.EXE.

N.B. As an alternative to the above, simply open up the Windows File Manager program and drag the AD_215.EXE file into any of the groups inside the Program Manager (though preferably the Startup group). Then select the Properties item from the File menu of Windows Pogram Manager and continue with steps (g) to (l).

(g) In the Working Directory field, enter the path of the directory which stores the Anno Domini executable file on your hard-disk, e.g. C:\A_DOMINI. This step is very important!

(h) If you wish Anno Domini to start as a minimized icon (highly recommended), select the Run Minimized check box.

(I) Click the OK button and the Anno Domini icon will appear in your selected Windows group. Simply double-click the Anno Domini icon to execute the program.

N.B. Also make sure that the Wrap Title check box has been selected in the Desktop section of the Windows Control Panel software. This makes sure that the date and time shown in the iconic display of Anno Domini is displayed neatly on the desktop.


(3) Registration

Anno Domini is not a free program nor in the public domain but is a shareware program. This means that you can use the program for a limited amount of time before making a payment.

You can use Anno Domini legally for a period of 14 days from the day the program was first installed on your computer system. After that period of time has elapsed, if you wish to continue using the program, you must register your copy of Anno Domini.

Registration of Anno Domini involves sending a cheque for £10 (sterling) or $15 for American users made payable to E. Ciaffarafa, along with your name and address to the following address:

25 Woodview, Bradford, West Yorkshire, BD8 7AJ

England, Great Britain.

Please write Anno Domini in the left hand corner of your envelope and make sure you enclose your own address. Registered users can legally use the Anno Domini program on a single computer for an indefinite period of time.

Registered users receive a personalized registration number which can be used to disable the reminder dialog which appears each time you quit the program when users have not registered the product via the Register option under the Options menu of the Anno Domini program.

Why Should I Register?

•	You will be automatically registered for all future shareware versions of Anno Domini;

•	Avoid paying higher registration fees for later versions of Anno Domini;

•	Receive product support via e-mail;

•	Receive advanced notification of updates and new releases;

•	Gain access to program features not available to unregistered users;

•	You will make the author of Anno Domini very happy!

Please feel free to pass on the ADOMINI2.ZIP file to friends and colleagues but do please register your copy. The Anno Domini program will continually be updated as I have many new ideas to implement so look out for later versions of the program from your shareware distributors or your online service.

I would appreciate any comments and suggestions for improving the Anno Domini program and I can be contacted by Internet e-mail at either one of the following addresses:

Enzo.Ciaffarafa@wlink.com

Enzo.Ciaffarafa@worldlk.exnet.com

Remember that your registration of the product will encourage me to further enhance the program. Enjoy!


(4) Using Anno Domini

Calendar Window

Minimized Calendar Window

Moon Phase Window

Events Window

On This Day

Save Reports

Menu Commands

Icon Bar

Keyboard and Mouse Shortcuts


(5) Troubleshooting

The most common questions on how to install and operate Anno Domini are covered below.

Installation

Anno Domini tells me it can't find a particular file. What could cause this to happen?

I can't find my city in Anno Domini's database. What do I do?

Controlling Anno Domini

How do I alter the format of the information displayed in the windows?

How do I view the moon phases and events for a year other than the current year?

How do I stop the On This Day information appearing each time I run Anno Domini?

How can I quickly get Anno Domini to display the calendar for the current month and year?

How do I exit the Anno Domini program?

Using Anno Domini

Can I view the events for a country other than my own?

Can I find out the times of sunrise and sunset for a date other than the current date?

Can I find out the date & time of the next moon phase without opening the moon phase window?

What does the blue, highlighted text in the Events window signify?

Can I view the sunrise/sunset times of another city without searching throught the database?

I have added a new city to the database but how do I edit or delete that new city?

Reports

I have saved the reports to disk but I can't find the files. Where are they stored?

How can I print part of the reports instead of all four pages?

Other Problems

Anno Domini seems slow in operation on my computer. How can I speed it up?

I don't hear a chime on the hour. How do I rectify this?


Anno Domini Cannot Find a File

If Anno Domini reports that it cannot find a paticular file that it is looking for, one of two things could have happened. Either an Anno Domini file has been deleted or a working directory for Anno Domini has not been selected.

Anno Domini ships with 7 files which are as follows:

•	AD_215.EXE;

•	AD_HELP.HLP;

•	MOON_SX2.DLL;

•	MOON_DX2.DLL;

•	CHIME.WAV;

•	README.TXT;

•	CTL3D.DLL.

Make sure that these files are still inside your Anno Domini directory. If you have these files in your Anno Domini directory and you still receive file not found errors then make sure you have entered a working directory for Anno Domini when you installed Anno Domini via the Program Manager.

Select the Anno Domini icon inside Program Manager and select Properties from the File menu of Program Manager. The working directory should be the same path as your Anno Domini directory, e.g. if you stored the files the Anno Domini files inside the directory C:\WINDOWS\A_DOMINI then the working directory should be set to the same path.


Your City is Not In the Anno Domini Database

If you cannot find your city in the database, then select the city which is closest to your own city from the database, making sure that the city you choose is still in your country! If you can find out your time zone, latitude and longitude on Earth from an encyclopedia then you can add this information to the Anno Domini database.


Altering the Information Displayed in the Anno Domini Windows

The amount of detail and the type of information displayed in the Anno Domini windows can be altered via the Preferences dialog. From here you can add or remove as much information from the windows as best suits you.


Viewing Moon Phases and Events for a Another Month and Year

To view the moon phases and events for a different month and year, simply use the scroll bars in the calendar window. If you alter the positions of the scroll bars in the calendar window while having the moon phase or events window open, their windows will be automatically updated.


Stopping the On This Day Dialog Appearing on Startup

When you installed Anno Domini, the program defaults to showing the On This Day  information each time you execute the program and open the calendar window. You can prevent this happening by deselecting the Display On This Day at Startup check box inside the On This day dialog and clicking the Ok button.


Quickly Viewing the Calendar for the Current Month and Year

To return to the calendar for the current month and year simply click the right mouse button once anywhere inside the calendar window. All of the open Anno Domini windows will be updated automatically to reflect this change.


Exiting from Anno Domini

To quit the Anno Domini program, either

(A) select the close function from the Anno Domini menu;

(B) double-click the close box from the Anno Domini calendar window;

(C) hold down the ALT key while simultaneously pressing the F4 function key;

(D) select the Exit Windows function from the Anno Domini menu.

If you have not registered Anno Domini, the About dialog will appear with 3 check boxes at the base of the dialog. To exit Anno Domini you must make sure that all 3 check boxes are selected before you will be allowed to quit Anno Domini. If you register Anno Domini, this feature will be disabled.


Viewing the Events of Another Country

You can view the events of a different country in the events window to the one you are using via the Preferences dialog. If you do this though, the times of the moon phases and sunrise and sunset will take into account Daylight Saving Time (DST) for the new country. This will not affect a change between any of the countries of the United Kingdom and the Republic of Ireland as they all have the same Daylight Saving Time and time zones but times will be affected if you choose to view the events for the U.S.A., Europe or World.


Viewing the Sunrise and Sunset Times for a Different Date

To view the times of sunrise and sunset for a date other than the current date, simply select the desired date from the calendar window with the mouse and click the left mouse button. A cross-hair will surround the newly selected date and the three status lines of the calendar window will be updated if the user holds the left mouse button down. Simply let go of the left mouse button to return the display for the current date.


Viewing the Date and Time of the Next Moon Phase

To view the date and time of the next moon phase to occur in relation to the current date and time simply click the left mouse button on the top status line of the calendar window (where the current date, time, days elapsed etc. is shown) and hold the left mouse button down. The bottom, green status line will then change to a black backround with white text showing you the time and date of the next moon phase.


Blue Highlighted Text in the Events Windows

The blue highlighted text which appears in the events window signifies the next national event, holiday or festival which will occur in relation to the current date for your selected country.


Quickly Selecting a Different Position on Earth

In the Your Position on Earth dialog, Anno Domini keeps a record of all the cities you have chosen and used from the database. These cities are displayed in the second list box of the dialog (between the Edit and New buttons) and shows the last five cities you have chosen from the database. If you wish to swap between different cities in your country, after having selected them from the main list box at the top of the dialog,  you can simply choose them from the second list box without the need to scan all 500+ cities in the first list box to select another city of your choice.


Deleting or Editing a New City from the Anno Domini Database

To delete a new city which you have added to the Anno Domini database, you must first select a different city before you will be allowed to select your new city for deleting. Anno Domini will not let you delete a city that has been added to the database if that city is currently in use. To edit your new city, simply click on the edit button after selecting your new city. You will not be able to alter the name of your city using this method.


Where are the Report Files Saved To?

When you select the save reports to disk function, Anno Domini will create four ASCII text files to disk with the following names in the following order:

(1) CALENDAR.TXT(A calendar for the selected year).

(2) MOON.TXT (The moon phases for the selected year).

(3) SUNRISE.TXT (Sunrise and sunset times for the selected year or months)

(4) EVENTS.TXT (Events for the selected country and year).

These files are stored in your working directory, i.e. the same directory where you have installed the Anno Domini program files.

Important note!

Anno Domini will overwrite any files with these names in that directory with the new reports. If you wish to keep a previous set of reports, copy the four .TXT files to a different directory or rename them.


Printing a Selected Range of Reports

If after you have selected the Send reports to printer function and you wish to only print some and not all of the reports, then on the printer dialog, select the Pages radio button instead of the All button and you will be able to select a range from 1 to 4. Page 1 represents CALENDAR.TXT, page 2 represents MOON.TXT, page 3 represents SUNRISE.TXT and page 4 represents EVENTS.TXT.


Making Anno Domini Run Faster

If Anno Domini appears to be slow in its operation, especially if you only have the calendar window open, then you can remove some of the information displayed in the calendar window or increase the speed of the moon phase calculations via the Preferences dialog.

Selecting the Approx. phases check box will increase the speed of the moon phase calculations with a trade off in accuracy. Moon phase times will only be accurate to within 45 minutes but will substantially increase the performance of the program. You can also choose not to display the moon phases in the calendar window itself which will also speed up performance.

Anno Domini has been designed to be as efficient as possible in carrying out its calculations and will make use of a math co-processor if one is installed in your machine to increase the speed of its calculations greatly.


Anno Domini Does Not Chime on The Hour

Make sure that the Hourly Chime check box is selected in the Preferences dialog. If you have a sound card and driver installed capable of playing .WAV digitized sound files, Anno Domini will play the CHIME.WAV sound file situated in your Anno Domini directory. If this file is not found or your system does not have a sound card, the system default sound is played as long as you have not switched off the sound via the Sound program in Windows Control Panel.


(6) Revisions

v2.15: 8th February 1995

   Allowed users to edit the details of a user-defined city that is currently in use. Fixed small bug in the next moon phase display when users were using am/pm time format. Made a small adjustment in the sunrise/sunset calculations to make sure the times displayed are valid. Registered users can now send to disk or printer the times of sunrise and sunset for every day of the current calendar month and the month after that.

v2.10: 31st January 1995

   Fixed bugs concerning a user-defined location. Program did not respond correctly to a location in the southern hemisphere and problems with the edit and delete functions. Added the ability to specify which country's events you wish to view with a user-defined location. Also fixed bug when displaying the date of the next moon phase. Sometimes the incorrect day of the week was displayed for the date of the next moon phase.

v2.01: 10th January 1995

   Added events for Canada and fixed bug where certain events did not appear on the bottom status line of the calendar window when a specific calendar date was selected with the mouse.

v2.00: 5th January 1995

   Initial release of Anno Domini;


(7) Disclaimer

THE ANNO DOMINI PROGRAM IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. I MAKE NO WARRANTIES, EXPRESSED OR IMPLIED, THAT THE ANNO DOMINI PROGRAM IS FREE OF ERROR, OR IS CONSISTENT WITH ANY PARTICULAR STANDARD OF MERCHANTABILITY, OR THAT IT WILL MEET YOUR REQUIREMENTS FOR ANY PARTICULAR APPLICATION.

ANNO DOMINI SHOULD NOT BE RELIED ON FOR SOLVING A PROBLEM WHOSE INCORRECT SOLUTION COULD RESULT IN INJURY TO A PERSON OR LOSS OF PROPERTY.  IF YOU DO USE ANNO DOMINI IN SUCH A MANNER, IT IS AT YOUR OWN RISK.

THE AUTHOR DISCLAIMS ALL LIABILITY FOR DIRECT, INCIDENTAL, OR CONSEQUENTIAL DAMAGES RESULTING FROM YOUR USE OF ANNO DOMINI.


Calendar Window

The calendar window is the control centre for the whole Anno Domini program. From here you can select all of the Anno Domini features either by the menu or the icon bar and view a calendar month for any month between the years 1753 and 2153. An example of what you see for the month of December 1994 is shown below:

The very top line of the calendar shows a status line (black text on a yellow background) giving the current date, time, week number and the number of days elapsed followed by the number of days left in the current year. This line is continually updated to reflect the current date and time. An example is shown below:

Below this line, the selected month and year is displayed. In this example, the year 1994 is not a leap year but if we were viewing a calendar month for the year 1996, a black line will be drawn under the year. This means that particular year is a leap year. When a calendar year is displayed without an underline, then that year is not a leap year.

When the calendar window opens for the first time, the month and year is set to the current date. To alter the date of the calendar shown, there are two scroll bars, one vertical, the other horizontal. The vertical scroll bar controls the month of the calendar shown while the horizontal scroll bar controls the year of the calendar shown. Simply click on the up and down arrows or drag the thumbwheel of the scroll bars to adjust the date of the calendar month shown.

Different coloured text is used to highlight the various features of the calendar. The grey coloured numbers represent the days in the previous or next month. The red numbers highlight the days occurring at the weekend in the current month whereas the black numbers highlight the working days of the week occurring in the current month.

On the right-hand side of the calendar, shown in blue numbers, are the week numbers for the selected calendar month. In this example, the week numbers are 48, 49, 50, 51, 52, 1. This information can be removed, if required, via the Preferences dialog.

In small, grey text to the left of some the days shown in the calendar are the days on which one of four moon phases occur. The moon phases are represented by a two letter abbreviation and are as follows:

nm = new moon, fq = first quarter, fm = full moon, lq = last quarter.

In the example calendar above, moon phases occur on the 2nd, 9th, 18th and 25th of December. The moon phase for the 18th of December 1994 (a full moon) appears as follows:

This information can be removed if required via the Preferences dialog. Also note that more information can be found on the exact time of the moon phases via the moon phases option from the menu or the icon bar.

Above the year scroll bar is another yellow status line which shows the times of sunrise and sunset for your selected position on earth. The latitude is shown to the left of the sunrise time while the longitude is shown to the right of the sunset time (in degrees and minutes). An example for London, England at latitude 51°30N and longitude 000°10W on the 25th December 1994 is shown below:

The latitude and longitude positions can be removed from the display via the Preferences dialog. Your latitude and longitude can be altered via the Your Position On Earth dialog.

The bottom line of the calendar shows the event which occurs on the current day and the types of events which are shown here can be changed via the Preferences dialog. The example above shows that the 25th December is Christmas Day.

The current day, if visible on the currently displayed calendar, is highlighted by a yellow square with blue text. In the example above, the 25th December happens to be the current day and is highlighted as follows:

Special Feature!

Using the mouse, you can select any of the numbers representing the days of the month displayed in the current calendar (Anno Domini will place a cross-hair around the selected date) and Anno Domini will change its three status lines to reflect the new date selected by the user. This is a handy way of finding the times of sunrise and sunset for dates in advance or dates that have passed.

Using this function will show the user two new pieces of information. In the very top status line, the current time is removed and at the very end of the status line (in brackets) it will show the difference in days between the current calendar date (highlighted by blue text in a yellow box) and the date selected by the user with the mouse (displayed by a cross-hair). The second status line changes by not only displaying the times of sunrise and sunset for the selected date but also displaying the number of hours the sun will be above the horizon for that given date in hours, minutes and seconds. Finally, the green status line will also change to reflect the event which occurs on that selected date. Simply let go of the mouse button to return the display to normal.

An example is shown below where the user has selected the 31st December 1994 when the current date is the 25th December 1994:

Important Note!

If you are viewing a calendar month which is not the actual current month and year, then you can quickly return to the current calendar month and year by clicking the right mouse button anywhere inside the calendar window.


Minimized Calendar Window

When the calendar window is minimized to an icon, the current date and time is shown in the icon, an example of which is shown below:

The format of the date and time and how often the time is updated can be altered via the Preferences menu option.

If the moon phases option has been selected in the icon display preference, the current moon phase is also displayed in the icon, an example of which is shown below, otherwise, the standard Anno Domini icon is displayed.


Moon Phases

Anno Domini calculates the dates and times of all the moon phases from the year 1753 to the year 2153. Selecting the Moon Phases option from the menu or the icon bar a new window showing the dates and times of all the moon phases for the currently selected month will appear. An example for December 1994 is shown below.

The title of the window indicates the current year selected (this can be altered via the scroll bars in the calendar window), and next to the year in brackets is the currently selected time zone. Make sure you have the correct time zone for your country. The reason for this is that the times for the moon phases are shown in local time which is dependent on the selected time zone. Also, depending on the country selected from the Preferences dialog, the times also take into account Daylight Saving Time (DST) for the selected country.

The accuracy of the times of the moon phases are dependent on the setting chosen in the Preferences dialog box. If the Approx. moon phases check box is highlighted then the times of the moon phases are accurate to within 45 minutes whereas if approximate phases is not selected as is the default choice, the times of the moon phases are accurate to within 1 minute (the majority of times are exact). Choose whichever option best suits you although bare in mind that if approximate phases are selected, the calculation of the moon phases will be much quicker.

To change the month and year of the moon phases displayed, simply use the scroll bars in the calendar window to simultaneously change the calendar and the associated moon phases to the desired month and year.

Special Feature!

If you wish to find out when the next moon phase will occur and at what time in relation to the current date and time it will occur, simply click the left mouse button over the top status line of the calendar window (where the current date, time, days elapsed etc. is shown) and hold the button down and you will see the green status line at the bottom of the calendar window change to a black background with white text showing you the next moon phase along with its date and time. Simply let go of the left mouse button to return the display back to normal. The moon phase window does not need to be open for this function to work. An example of what replaces the green status line is shown below where the user requested the date and time of the next moon phase on the 10th November 1994 at 5:57 pm:


Events

One of the strongest features of Anno Domini is that it will display national and worldwide events for six different nations for any year from 1753 to the year 2153. On selecting Events from the menu or icon bar, a new window will open and depending on the country selected from the Preferences dialog, 28 different events for a given year for the selected country will be displayed.

The events are a mixture of national holidays and the major Christian festivals. All of the events are listed in chronological order and the next event which will occur in relation to the current date will be highlighted in blue text.

The year in which the events are shown can be changed via the scroll bars in the calendar window..

Important Notes!

All of the events calculated and displayed in Anno Domini are accurate to their definitions as to the end of 1994. The dates of certain events and festivals are often changed by governments at various intervals. For this reason all the events in Anno Domini conform to their latest definitions and the dates of certain events may be inaccurate for dates in the past which were governed by earlier rules.

You can view the events which occur in a different country by selecting a different country via the Preferences dialog. If you do this though, the times of the moon phases and the sunrise and sunset times will change to take into account the dates of Daylight Saving Time (DST) for that selected country. Remember to change back to your correct country to view the correct moon phase and sunrise and sunset times for your particular country.


On This Day

Selecting this function will display a dialog box showing four historical events which have occurred in the past on the current day and it will also display the birth dates of four famous people from the past and the present for the current day. Events have been included for all 365 (or 366) days possible in the currently selected year.

By default, the first time the calendar window is displayed, the On This Day dialog is automatically displayed. This feature can be turned on or off via the check box in the bottom left hand corner of the On This Day dialog.


Save Reports

Use this function if you wish to save the calendar information to disk or to output it via an attached printer. This calendar information consists of (a) a calendar for the selected year; (b) the dates and times of all the moon phases for the selected year; (c) the times of sunrise and sunset for a given day of each week in the selected year; (d) the events occurring in the selected year for your country.

On selecting this function, a dialog will appear showing the current settings of the Anno Domini program which will affect the output produced by the Save Reports function. This inclues the currently selected calendar year, the city chosen from the database of positions on Earth, your time zone, latitude and longitude on Earth, your country, time format (12 hour or 24 hour clock) and date format (Day/Month/Year or Month/Day/Year). If changes need to be made to any of the displayed settings before saving the reports, select the Cancel button. The calendar year can be changed via the scrollbars on the Anno Domini window. The city, latitude, longitude and time zone can be changed via the Your Position on Earth dialog and all the remaining settings can be altered via the Preferences dialog.

Below the displayed settings there is a check box. This allows you to select whether or not you want a hanging indent placed before any output to disk or printer.

Below the check box are a set of radio buttons which determine whether you want the reports sent to your hard disk or to an attached printer. If you select to send the output to disk, 4 ASCII text files will be created in the same directory where you installed Anno Domini called CALENDAR.TXT, MOON.TXT, SUNRISE.TXT, and EVENTS.TXT. You can use virtually any Windows or DOS based text editor or word processor to view these files at a later date. If you select the printer option, a number of dialogs will appear allowing you select your Windows printer and the format of the printed output. You can either print all 4 pages of reports or select a range of pages.


Menu Commands

Anno Domini has the following menu structure:

Options

      Always on top

      Arrange windows

      Save reports

      World time zones

      Preferences

      Position on Earth

      System info

      Register

Restart Windows

Help

Moon phases

Events

On this day

About

Exit Windows


Always On Top

Use this feature if you wish to keep the Anno Domini windows or icon upper-most above all other open windows. This function is especially useful when the Anno Domini program is iconized, allowing the current date, time and moon phase to be always visible. This function can be turned on or off either via the menu or via the Preferences dialog.


Arrange Windows

Every time the events window or the moon phase window is opened, Anno Domini will automatically centre all the windows visible on the screen. Use this command if you have moved any of the windows out of their original opening positions and you want the windows to be centred again.


World Time Zones

This command will open a dialog box displaying all the time zones for the major countries of the world. Its primary purpose is to help users identify which time zone their country lies in relative to Greenwich Mean Time (GMT). The time zone is used in Anno Domini to make sure that the times and dates of the moon phases are correct for your position on Earth.

The time zones which are displayed in the dialog show how many hours ahead or behind Greenwich Mean Time your country is. For example, Colorado, USA has a time zone of -07.0 which means Colrado is 7 hours behind Greenwich Mean Time. India, on the other hand, has a time zone of +05.5 which means India is 5 hours and 30 minutes ahead of Greenwich Mean Time. Following this analogy, times in India are some 12 hours and 30 minutes ahead of those in Colorado in the USA.

When you first ran Anno Domini, you selected a city from the Anno Domini database which was the closest to your city in your particular country via the Your Position on Earth dialog. If you did then your time zone will have been selected for you and there is no need for you to alter this information. If you do need to add your own city to the database, make sure you enter the correct details of the time zone and latitude and longitude or the times of the moon phases and sunrise and sunset times will be innacurate for your city and country.


Preferences

This function will display a dialog box allowing you to change the operation of 3 different aspects of Anno Domini, namely, the icon display when you minimize the main calendar window, the amount of information displayed in the calendar window and finally which country you live in.

Icon Display

Window Display

Country


Icon Display

When you minimize the calendar display into an icon, you can specify the format of the date and time which is displayed in the icon.

If you want the current time displayed in a 12-hour format, e.g. 12:59 am or 4:59 pm, select the 12-hour radio button; or if you prefer a 24-hour format such 00:59 or 16:59 select the 24-hour radio button. The default choice is the 12-hour format.

You can also specify whether you want the current date displayed in the format Day/Month/Year or in the format Month/Day/Year. Select the appropriate radio button for your choice. The default choice is Day/Month/Year.

If you wish the number seconds to be displayed along with the time, select the Show seconds check box, otherwise leave it blank and the icon will update the time only every minute. The default choice is not to show the number of seconds.

If you wish to be given an audible tone on the hour, select the Hourly chime check box, otherwise leave the box blank. Anno Domini will play the digitized sound file CHIME.WAV from the Anno Domini directory on your hard disk if you have a sound card installed on your system capable of playing .WAV files.If you do not have a suitable sound system available, Anno Domini will still give out an audible tone. The default choice is to give an hourly chime.

If you wish the minimized icon to show you the moon phase for the current date graphically in the icon display select the Show moon phase check box or leave the check box blank to revert to the standard Anno Domini icon. The default option is to show the current moon phase,

Finally, if you want the Anno Domini windows or its icon display to be always uppermost above all other open windows (ideal if you always want to see the current time and moon phase) select the Always on Top check box. The default option is not to keep Anno Domini uppermost.


Window Display

There are 8 check boxes which govern the amount of information displayed in the calendar window.

The first 4 check boxes, Christian festivals, National events, Worldwide events and Saints determine the type of events which are displayed in the very bottom line of the calendar display. If Christian festivals is selected and a Christian festival, e.g. Easter Sunday falls on the current date, Anno Domini will show that festival on the bottom line of the calendar window. The same applies to the other three types of events. National events cover all the major holidays and events for a selected country, worldwide events, e.g. the date of a countrys independence cover events which are occurring in countries around the world and finally a Saints name will be shown if the current date happens to be assigned to a particular Saint.

If all 4 check boxes are selected, national events has the highest priority with Christian festivals having second priority, then follow the worldwide events and finally the Saints have least priority. If all 4 check boxes are left clear, the bottom line of the calendar window will be left blank.

Please note that this current version of Anno Domini does not display a Saint or a worldwide event for every single day of the year but if both Saints and worldwide events are selected (as is the default), then you will see one of these two types of events for all 365 or 366 days possible in any given year on the bottom line of the calendar window.

There are 2 check boxes which govern the moon phases displayed in the calendar window and the separate moon phase window. If the Moon phases check box is selected, the moon phases are shown in the calendar window and are represented in green text by two letter symbols to the left of the calendar day number as follows:

nm = new moon,  fq = first quarter, fm = full moon, lq = last quarter.

If the moon phases check box is left clear, the moon phases are not displayed in the calendar window and this will speed up the update of the calendar window.

The second check box relating to the moon phases, Approx. phases governs the accuracy of the times shown in the moon phases window. When selected, the calculations for the times of the moon phases are accurate to within 45 minutes whereas if it is not selected, the times of the moon phases are accurate to within 2 minutes. The greater the accuracy, the longer the calculations take.

The Week numbers check box controls whether week numbers are displayed in the calendar window (these are displayed in blue text on the right-hand side of the calendar).

The final check box Show position governs whether or not you want your current latitude and longitude displayed in the calendar window.


Country

Anno Domini will calculate national events for 9 different nations and it is through the set of 9 radio buttons in the Preferences dialog that you select which nations events you want displayed in the calendar window and in the events window. Choose from England, Wales, Scotland, Northern Ireland, Republic of Ireland, USA, Canada, Europe and World.

The country selected also affects the times shown in the moon phase window. Depending on the country selected, Anno Domini has to take into account the Daylight Saving Time (DST) for each country to show the moon phase times correctly for the summer months. If World is selected as the nation, Anno Domini will not take Daylight Saving Time into account.

Please note that when you selected your city from the Anno Domini database, Anno Domini automatically selected the country for you. You can override this choice by selecting a different country through this set of radio buttons.


Your Position On Earth

When you run Anno Domini for the first time, the dialog below will appear on screen. It is from here that you choose which city in the world you live in. This is necessary so that Anno Domini can calculate the dates and times of the moon phases and the times of sunrise and sunset correctly for your particular position on Earth.

At the top of the dialog box you will see a listbox with a downward pointing arrow. Simply select the listbox and scan through the 500+ cities in the Anno Domini database. If you cannot find your city and country in the database, choose the city which is closest to your own city but also in your own country! Once you have selected your city, Anno Domini will tell you at what time zone this city lies in relative to Greenwich Mean Time (in hours) and the latitude and  longitude of that city on Earth. Then simply click the Ok button and Anno Domini is ready for you to use!

Important Notes!

If you do not select a city from the database, Anno Domini will default to using London, England as your city and country.

Anno Domini will automatically display the correct national holidays and events in the events window depending on the city you have chosen. You can, if you wish, override this decision by changing the country via the Preferences dialog. For a user-defined location, a dialog will appear allowing you to select the desired country for the displayed events.

Adding a New City to the Database.

If you have not been able to find your own city in the Anno Domini database and you are sure you know your time zone and your exact latitude and longitude position on Earth, then you can add this information to the database. When the Position On Earth dialog appears, click the New button and you will be able to enter your latitude, longitude and time zone into the data fields. Also enter the name of your city. Once you have entered all the information correctly, click the Add button. Your new position will then be added to the database and be used as your position on Earth.

Once you have added your new city to the database, you can change the information via the Edit button, or delete the city from the database via the Delete button. Note that you can only delete a city you have added to the database if that city is not currently in use. If the city is in use, first select another city from the database and then call the Your Position on Earth dialog again where after selecting your new city from the database, you can then delete it. Note that you can only add one new city to the database in this current version of Anno Domini.

Special Feature!

In the Your Position on Earth dialog, Anno Domini keeps a record of all the cities you have chosen and used from the database. These cities are displayed in the second list box of the dialog (between the Edit and New buttons) and shows the last five cities you have chosen from the database. If you wish to swap between different cities in your country, after having selected them from the main list box at the top of the dialog,  you can simply choose them from the second list box without the need to scan all 500+ cities in the first list box to select another city of your choice.


System Info

This function will display a dialog box showing information regarding your particular computer system. The information shown is divided into 7 distinct areas as follows:

Hardware Configuration

•	The central processor inside your PC, e.g. 386 or 486 etc.;

•	Whether you have a math coprocessor installed or not.

Operating Systems

•	The version of DOS you are using, e.g. v 6.20;

•	The version of Microsoft Windows you are using, e.g. v 3.10.

Windows Operation

•	The mode Microsoft Windows is running in, i.e. Standard or 386 Enhanced;

•	The percentage of free Windows GDI resources left;

•	The amount of time spent using Microsoft Windows since execution.

Hard drive space

•	The amount of free hard disk space in kilobytes on drives C:, D: and E: if they exist.

Video card

•	The currently installed video card and display mode.

Printer

•	The currently installed printer driver and port.

RAM

•	The total amount of Windows RAM in kilobytes, the Windows RAM used and free;

•	The total amount of physical RAM in kilobytes, the physical RAM used and free;

•	The total amount of virtual RAM in kilobytes, the virtual RAM used and free.


Register

This function will display a dialog box requesting a unique registration number and is to be used only by those people who have registered their copy of Anno Domini.

When you register your copy of Anno Domini, you will be sent a registration number. Enter this registration number in the Serial No. field and then click the OK button. The registration number you enter will be validated and if correct, will be stored to disk and the Register option will be disabled from the menu. You will then be a legitimate user of Anno Domini and any dialogs reminding you to register your copy of Anno Domini will then be disabled.


Restart Windows

Use this function if you wish to close down the current Windows session and to immediately restart Windows. This is useful if you have changed any of the settings to the Windows .INI files and you wish to see their effect immediately. A message box will appear to confirm your selection before restarting Windows.


Help

This function will open up a window containing useful information on how to use Anno Domini and how to register the program.


About

Here you can view information about the author and the version of Anno Domini running and also the registration number if the user has registered their copy of Anno Domini.


Exit Windows

Use this function if you wish to end your current Windows session and return to MS-DOS. Unlike the standard Exit Windows function inside Program Manager, no prompt is displayed before the Windows session ends if you are a registered user of Anno Domini. If you have not regeistered your copy of Anno Domini, you will be prompted before being allowed to exit Windows to avoid users accidentally quitting Windows before they are ready.


Icon Bar

An alternative method to using the menu for selecting the Anno Domini functions is to use the icon bar which appears at the top of the calendar window. The icon bar is shown below and you can click on any of the icons to find out more information:

The ten icons are shown side-by-side and represent the ten most important features of Anno Domini. Simply select the desired icon with mouse and click the left mouse button to select the function. This allows the main functions to be called quicker and easier than using the menu. Please note that some functions are only available via the menu so you will still need to access the menu at times.


Keyboard Shortcuts

Keyboard Shortcuts

Function keys F1 to F9 can be used to access Anno Domini features without using the menu as listed below:

F1 = Help	F5 = Save reports

F2 = Moon Phases	F6 = World time zones

F3 = Events	F7 = Preferences

F4 = On This Day	F8 = Position on Earth

F9 = System info


Christian Festivals
Anno Domini will calculate and display the dates of the following Christian festivals:

The Epiphany, Ash Wednesday, Palm Sunday, Good Friday, Easter Sunday, Ascension Day, Whit Sunday, Trinity Sunday, Corpus Christi, The Assumption, The Immaculate Conception, All Saints Day, All Souls Day, Advent Sunday and Christmas Day.


DST/BST
Daylight Saving Time (DST) or British Summer Time (BST) is achieved by advancing the clock one hour during the summer months.

In the USA and Canada, DST begins on the first Sunday of April and ends on the last Sunday in October and takes effect from 2:00 am local time.

In England, Wales, Scotland, Northern Ireland and the Republic of Ireland, BST begins on the last Sunday in March and ends on the Sunday following the fourth Saturday in the month of  October and takes effect from 1:00 am local time.

In Europe, DST begins on the last Sunday of March and ends on the last Sunday in September and takes effect from 2:00 am local time.


Leap Year
A leap year is a year in which the month of February has 29 days instead of the usual 28 days. A Leap year is defined as being a year that is divisible by 4 and not divisible by 400.


GMT
The world is divided into 24 zones, each of 15 degrees of arc, or one hour apart in time. The Greenwich meridian (Greenwich, England) at 0 degrees extends through the centre of the initial zone. Zones to the east are numbered from 1 to 12 and are prefixed with a plus sign indicating the number of hours ahead of the Greenwich meridian whereas the zones to the left of Greenwich are prefixed with a minus sign indicating the number of hours behind the Greenwich meridian.


Gregorian Calendar
The Gregorian calendar was adopted by Italy, France, Spain, Luxembourg and Portugal in 1582 after Pope Gregory XIII decreed that the previously used Julian calendar had an accumulative error which meant that 10 days had been missed. The new calendar system came into effect on the day following  the 4th of October, 1582 and was to be called the 15th of October and took into account this error for future years with the introduction of leap years.

The Gregorian calendar did not come into effect for Great Britain and America until the 2nd of September 1752 of the Julian calendar system where it was decreed that the day following should be called the 14th of September, a loss of 11 days.


Latitude
For the purposes of geography and navigation, the Earths surface is divided into degrees, minutes and seconds of latitude and longitude. An imaginary line from the the equator to the centre of the Earth and another imaginary line from either the North or South Pole would meet the centre of the Earth at an angle of 90°. This angle is divided into degrees north (N) or south (S) of the equator, e.g. 0° at the equator, 90°N at the Noth Pole and 90°S at the South Pole. Each degree is subdivided into 60 minutes and each minute is further subdivided into 60 seconds.

A circle joining the points with the same degree reading, forms a line parallel to the Equator, called a line of latitude. Every place on that line has the same latitude.


Longitude

For the purposes of geography and navigation, the Earths surface is divided into degrees, minutes and seconds of latitude and longitude. A line of longitude joins places on Earth at which the sun is at its highest point in the sky at the same time. Each line of longitude runs froms Pole to Pole. Longitude is measured in angles west (W) or east (E) of the Prime Meridian (latitude = 0°) which passes through Greenwich, England. Longitude represents differences in time on Earth. Noon occurs an hour earlier for each 15° of longitude to the west while noon occurs an hour later for each 15° of longitude to the east. Hence the need for various time zones around the world.

The 180° line of longitude is the International Date Line for most of its length. Travellers going east of the Date Line set their calendar back one day whereas those travelling west set their calendar forward one day.


Sunrise
The time of sunrise occurs daily when the upper limb of the Sun first appears above the eastern horizon to a human observer at sea-level.


Sunset
The time of sunset occurs daily when the upper limb of the Sun disappears below the western horizon to a human observer at sea-level.


SaveReportsIcon
   Save Reports

Selecting this function activates the Save Reports feature and allows you to either save to disk or send to printer 4 different reports.


HelpIcon
   Help

Selecting this icon will activate the on-line help for Anno Domini.


MoonIcon
  Moon Phases

Selecting this icon will open a new window showing the dates and times of the moon phases for the currently selected calendar month and year.


EventsIcon
  Events

Selecting this icon will open a new window showing 28 national events and holidays for the currently selected calendar year and country.


BookIcon
  On This Day

Selecting this icon will active the On This Day feature which will open a dialog showing 4 historic events which occurred on the current day in the past and also the birthdates of 4 famous people from the past and present.


ArrangeIcon
  Arrange Windows

Selecting this icon activates the Arrange Windows function which will centre all the open Anno Domini windows on the screen.


ZonesIcon
  World Time Zones

Selecting this icon will open a dialog showing the major countries of the world with their associated time zones relative to Greenwich Mean Time.


PreferenceIcon
  Preferences

Selecting this icon will open the Preferences dialog allowing you to alter the settings of the Anno Domini program.


CardIcon
  Your Position On Earth

Selecting this icon will open a dialog where you can select your particular country specific details, i.e. your country's position on Earth and time zone from a database of some 500+ cities around the world.


SysInfoIcon
   System Info

Selecting this icon will open the System Info dialog which will show computer specific information such as memory usage, hard disk space, installed printer etc.


Glossary

A-C

Christian Festivals

D

DST/BST

E-G

GMT

Gregorian Calendar

H-L

Latitude

Leap Year

Longitude

M-S

Sunrise

Sunset

T-Z