Hebcal 1.4 - a program for printing Jewish calendars by Danny Sadinoff DESCRIPTION Hebcal is a program which prints out the days in the Jewish calendar for a given gregorian year. Hebcal is fairly flexible in terms of which events in the Jewish calendar it displays. Each of the following can be individualy turned on or off: The Hebrew date Jewish Holdiays (including Yom Ha'atzmaut and Yom HaShoah etc.) The weekly Sedrah The day of the week The days of the Omer CHANGES Since version 1.3: This is a quickie fix of the new Chanukah routine added in the last release I also changed the suffix of the manpage from .l to .1, since it was causing some versions of make to compile the manpage as a lex file, destroying the source code in the process. Added Yom Yerushalayim Since version 1.2: Fixed a critical bug which put Purim on the 15th of Adar, instead of the 14th Now uses sys/types.h instead of stdlib.h Added the rest of the 8 days of Chanukah Added -e European output switch. Since version 1.1, the following changes were made: Changed usage-- the -p "parshiot" switch was changed to "-s" sedrot switch Fixed certain slippery variable type bugs Changed code to K&R old style Added Manpage Decided to change the "Distribu-Ware" to a normal shareware. DISTRIBUTION This program is GUILTWARE. It may be distributed freely, with a few conditions: 1) The package must be distributed INTACT with ALL source code, as well as this file. You are welcome to modify the code, but DON'T distribute it modified. This disclaimer should certainly appear with every distributed copy. 2) You can use this program for free for one week. After that trial period, if you wish to use this program, drop me a line. I'd like to know who you are, what version you're using, and how you're using hebcal, and anything else you'd like to tell me, so that I can adjust the program to meet users' needs. I am NOT demanding payment for the use of my program, but writing this program DID take time. Feel free to send $10 to me at my US Mail address. (hint) send US Mail to: send email to: Danny Sadinoff sadinoff@eniac.seas.upenn.edu 1 Cove La. Great Neck, NY 11024 Email respondents will receive notifications of new versions as they come out, as will US Mail responents (if they send me postage for a disk). If you do not mail me or email me after one week, please don't use the program, although you may feel free to distribute it further. COMPILATION The code has K&R "old style" declarations in it, so it should compile on most machines. The distribution includes a "Makefile" so once you've unpacked all the files, (including this one) just run the command "make" and that should compile everything for you. The file hebcal.1 is the manual page. For information on using man in conjunction with local manpages, see the manpage for man. Briefly, to read a manpage, type nroff -man | more OPERATION: The operation of hebcal is fairly simple. Hebcal defaults to printing out the holidays for the current gregorian year. With the command-line options, a specific gregorian year, month or date can be specified. Given one numeric argument, hebcal will print out the calendar for that year. Given two numeric argumetnts mm yyyy, it prints out the calendar for month mm of year yyyy. Given three numeric arguments mm dd yyyy, it will print out the hebrew calendar entries for day dd of month mm of year yyyy. In the last case, the -d option is automatically enabled. Be sure to give the whole year to hebcal. hebcal 92 will return the calendar for a time somewhere in the early christian era, not in the twentieth century. Use hebcal 1992 instead. usage: hebcal [-dehostTw] [[month [day]] year] hebcal help --- prints this message. OPTIONS: -d : add hebrew dates -e : use European dates (dd mm yyyy) for OUTPUT ONLY (input format the same) -h : suppress holidays -o : add days of the omer -s : add weekly sedrot -t : only output today's date. This switch implies the -d switch. -T : only output today's date, suppressing gregorian date. This switch implies the -d and -o switches. -w : add day of the week Examples: example% hebcal -ho 4/19/1992 1st day of the Omer 4/20/1992 2nd day of the Omer 4/21/1992 3rd day of the Omer 4/22/1992 4th day of the Omer 4/23/1992 5th day of the Omer 4/24/1992 6th day of the Omer . . 6/5/1992 48th day of the Omer 6/6/1992 49th day of the Omer to print out all of the data pertaining to today's date, use example% hebcal -otw 10/26/1992 Mon, 29 of Tishrei, 5753 to find out what's happening in today's Jewish calendar, use example% hebcal -T 19 of Nisan, 5752 Pesach V (CH"M) 4th day of the Omer DISCLAIMER I tried to make this program as accurate as possible. However, I take no responsibility for any horrible consequences which may come about as a result of faulty output from this program. Remember: never trust a program with a zero at the end of its revision number. The secular dates before september 1752 are off by two weeks due to the correction that took place then. The secular dates before 1522 become progressively meaningless, as I made no correction for the changeover from julian to gregorian calendars; but the Hebrew dates and years are correct. COMING SOON Features to be included in future versions: - Arba' parshiot - The ability to specify and output a particular HEBREW year, month or date. The absence of this feature is a serious drawback to hebcal as it now stands. - calendar-like operation with user specified "holidays", e.g. birthdays, yahrtzeits. - yahrtzeit lists: calculate a list of dates in successive gregorian years with the same Hebrew date. GRIPES send questions, comments or complaints to: Danny Sadinoff sadinoff@eniac.seas.upenn.edu