.TH HEBCAL 1 "Hebcal Version 1.4" "Danny Sadinoff"
.SH NAME
hebcal - a Jewish calendar generator
.SH SYNOPSIS
.B hebcal
[ 
\-dehostTw
] [ 
\-i
.I file
] [[
.I month
[
.I day
]]
.I year
]
.br
.B hebcal help
.SH DESCRIPTION
With no arguments, 
.B hebcal
will print to stdout the 
dates of the Jewish holidays in the current
secular year.  Each line is prefixed with a gregorian date of the form
mm/dd/yy.  
.sp
By specifying 
.I month,
.I day,
or 
.I year 
output can be limited to a particular month or date
in a particular year.  
.sp
.I year
is an integer (it can be negative).  So 92 is in the early Christian
era, not the late twentieth century.
.sp
.I month
is a number from 1..12.
.sp
.I day 
is a number from 1..31.
.sp
For example, the command
.nf

	hebcal 10 1992

.fi
will print out the holidays occurring in October of 1992.
.PP
A few other bells and whistles include the weekly 
.I sedrah
as well as the day of the week, the count of the 
.I omer,
and the Hebrew date.
.PP
Output from hebcal can be used to drive calendar(1).  
Day\-to\-day use for hebcal is provided for in the 
.B -T
 and 
.B -t
switches, which print out Jewish calendar entries for the current date.
.PP
.SH OPTIONS
.TP 1.0i
.B "  -d"
Add the Hebrew date to the output.
.TP
.B "  -e"
Change the output format to European\-style dates: dd/mm/yyyy
.TP
.B "  -h"
Supress holidays in output.
.TP
.B "  -o"
Add the count of the 
.I omer
to the output.
.TP
.B "  -s"
Add the weekly sedra to the output.  
.TP
.B "  -t"
Print calendar entry for today's date only.  -d is asserted with this option.
.TP
.B "  -T"
Same as -t, only without the gregorian date.  This option is useful in
login scripts, just to see what's happening today in the Jewish calendar.
.TP
.B "  -w"
Add the day of the week to the output.
.SH EXAMPLES
.LP
To find the days of the 
.I omer 
in 1997, printing the days of the week:
.RS
.nf
.ft B
example% hebcal -how 1997
.br
4/23/97 Wed, 1st day of the Omer
.br
4/24/97 Thu, 2nd day of the Omer
.br
4/25/97 Fri, 3rd day of the Omer
.br
 .
.br
 .
.br
 .
.br
6/9/97 Mon, 48th day of the Omer
.br
6/10/97 Tue, 49th day of the Omer
.RE
.LP
To just print the weekly sedrot of December 2000
.RS
.nf
.ft B
example% hebcal -hp 12 2000
.br
12/2/00 Parshat Toldot
.br
12/9/00 Parshat Vayetzei
.br
12/16/00 Parshat Vayishlach
.br
12/23/00 Parshat Vayeshev
.br
12/30/00 Parshat Miketz
.br
.RE
.LP 
To find out what's happening in the Jewish calendar today, use
.RS
.nf
.ft B
example% hebcal -T
.br
19 of Nisan, 5752
.br
Pesach V (CH"M)
.br
4th day of the Omer
.br
.RE
.SH AUTHOR
Danny Sadinoff, University of Pennsylvania
.SH SEE ALSO
calendar(1), hcal(1), hdate(1), omer(1), rise(1)
.sp
The motivation for the algorithms in this program is the
.I "Tur Shulchan Aruch.  "
A well written treatment of the Jewish calendar is given in 
.I Understanding the Jewish Calendar
by Rabbi Nathan Bushwick.  A more complete bibliography on the topic
can be found there.
.SH BUGS
There are some omissions from the list of included holidays, including
;Yom Yerushalayim. 
.sp
Right now, hebcal dosn't perform enough sanity checking on input
dates.
.sp
Hebcal performs no checking for changes between the julian and
gregorian calendar, so secular dates before 1752 are untrustworthy.
.sp 
Hebcal cannot currently handle date computations before 2 C.E.  sorry.
.SH BUG REPORTS TO
Danny Sadinoff	sadinoff@eniac.seas.upenn.edu