Blank lines are ignored. All text in a line after a # sign is ignored.
A line with an entry has the following format:
<Identifer>: "<Value>"
<Identifer> can consist of letters (A-Z, a-z), digits (0-9) and a dot (.).
The identifers in NAMES.TXT have the following format: <Name>.<Language>, where <Name> is an internal name which must not be changed, and <Language> is the language which is passed to the various Jewish calendar functions as the lpLanguage parameter. Several entries with the same name and different languages can exist. If the language should be omitted, the identifer only consists of the <Name> without the dot (.).
In the ZMANIM.TXT file, no language is required.
The identifers in NAMES.TXT have the following meaning:
| Identifer | Meaning |
|---|---|
| Month... | Hebrew month names, returned by JewcalGetHebrewMonthName |
| Holiday... | Jewish holidays, returned by JewcalGetJewishHolidayName and JewcalGetJewishHolidayNameEx. To exclude a specific holiday, comment it out by inserting a # sign at the beginning of the line where the holiday is. |
| HolidayTypeHoliday... | After the HolidayTypeHoliday string, there must be a consecutive
number (HolidayTypeHoliday1, HolidayTypeHoliday2, ...). There must be as many entries as holidays of the type JEWCAL_DAY_HOLIDAY. The value of each entry must be the identifer of a holiday which should have the type JEWCAL_DAY_HOLIDAY. These strings are used in the JewcalGetNearestHolidayGregorianDate and JewcalGetNearestHolidayHebrewDate functions |
| HolidayTypeYomHazicaron... | After the HolidayTypeYomHazicaron string, there must be a consecutive
number (HolidayTypeYomHazicaron1, HolidayTypeYomHazicaron2, ...). There must be as many entries as holidays of the type JEWCAL_DAY_YOMHAZICARON. The value of each entry must be the identifer of a holiday which should have the type JEWCAL_DAY_YOMHAZICARON. These strings are used in the JewcalGetNearestHolidayGregorianDate and JewcalGetNearestHolidayHebrewDate functions |
| HolidayTypeFast... | After the HolidayTypeFast string, there must be a consecutive
number (HolidayTypeFast1, HolidayTypeFast2, ...). There must be as many entries as holidays of the type JEWCAL_DAY_FAST. The value of each entry must be the identifer of a holiday which should have the type JEWCAL_DAY_FAST. These strings are used in the JewcalGetNearestHolidayGregorianDate and JewcalGetNearestHolidayHebrewDate functions |
| Omer | String for omer count (%d is the number of the omer) which appears at the end of the torah readings returned by JewcalGetReading or JewcalGetReadingEx |
| Torah... | Torah readings returned by JewcalGetReading or JewcalGetReadingEx |
| Haphtarah... | Haphtarah readings returned by JewcalGetReading or JewcalGetReadingEx |
The identifers in ZMANIM.TXT without a dot are samples for
calculation methods for shabbat times and Zmanim.
Syntax of calculation methods