/usr/share/doc/hebcal/README is in hebcal 3.5-2.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 | Hebcal 3.5 - a program for printing Jewish calendars
by Danny Sadinoff
portions by Michael J. Radwin
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
TODO:
I'm porting hebcal to perl5, which will solve, once and for all,
everyone's porting headaches.
INSTALLATION
Since you're reading this, you have already successfully unpacked the
source files. The next step is to customize the program for your
city.
Examine cities.h. If your city is in there, run configure using the
--with-city=CITYNAME option as follows:
./configure --with-city=Chicago
you may have to quote spaces:
./configure --with-city="Los Angeles"
If your city is NOT on the list, then in order to customize hebcal to
your city, you will need to pass it the lattitude, longitude, timezone
and daylight savings code (see the manual).
Suppose you live in Oshkosh, Wisconsin.
Your lattitude is 44d1'29", and your longitude is 88d32'33".
You are in timezone Z-6, with the daylight savings scheme normal to
the US. We'll round the geographic coordinates to the nearest minute.
In order to get candlelighting times for the current year, you would
type
hebcal -ch -l44,1 -L 88,33 -z-6 -Zusa
Now this can get rough on the fingers if you do it a lot, so the
HEBCAL_OPTS environment variable is available for you to use. Every
time hebcal is run, it checks this variable. If it is non-empty, the
arguments in that variable are read as though they were typed at the
command line before the ones you actually type.
So you might set HEBCAL_OPTS to be
-l44,1 -L 88,33 -z-6 -Zusa
and if you type
hebcal -ch
hebcal will think you typed
hebcal -l44,1 -L 88,33 -z-6 -Zusa -ch
REMEMBER: negative longitudes are EAST of Greenwich.
For information on setting environment variables, consult your local
guru.
Once an install is complete, there are three ways to change cities, or
pick a city not on the list:
1) change the CITY environment variable
2) change the HEBCAL_OPTS variable to reflect the new city's coordinates.
3) pass a -C city argument to hebcal.
You can check where hebcal thinks it is by typing
hebcal info
at the command line.
-----------
The file hebcal.1 is the manual page, and is created when you compile
the program.
For information on using man in conjunction with local
manpages, see the manpage for man. If you want to see what the
manpage would look like, type
make MANUAL
at the command line, and the shell will deposit a text version of the
manpage in the file MANUAL.
DISTRIBUTION
Copyright (C) 1994-2006 Danny Sadinoff
Portions Copyright (c) 2002 Michael J. Radwin. All Rights Reserved.
Hebcal is distributed under the GNU Public License. The program
and its source code may be freely distributed. For details, see
the file COPYING in the distribution.
If you are going to use this program, please 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. The "free" in the GNU public license
refers to distribution, not necessarily payment. Feel free to send
$10 or multiples of $18 or just a postcard to me at my US Mail
address (email me for it).
send email to:
danny@sadinoff.com
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).
The latest version of the code will be available from
http://sourceforge.net/projects/hebcal
|