There are the four files: calendar.el, diary.el, holidays.el, and
calendar.texinfo.  You need to store them in a directory that is on your emacs
load-path, byte-compile them (for speed), and add the following lines to your
.emacs file:

(autoload 'holidays "holidays"
  "Prepare a list of holidays in the previous, present, and next months." t)
(autoload 'calendar "calendar"
  "Display a three-month calendar window." t)
(autoload 'diary "diary"
  "Display a window of diary entries." t)

;; The following lines can be included or omitted, as you prefer

(setq mark-holidays-in-calendar t)
;;(setq all-hebrew-calendar-holidays t)
;;(setq all-islamic-calendar-holidays t)
;;(setq all-christian-calendar-holidays t)
(setq diary-list-include-blanks t)
(setq nongregorian-diary-marking-hook 'mark-hebrew-diary-entries)
(setq mark-diary-entries-hook 'mark-included-diary-files)
(setq nongregorian-diary-listing-hook 'list-hebrew-diary-entries)
(setq list-diary-entries-hook
      '(include-other-diary-files
        (lambda nil
          (setq diary-entries-list
                (sort diary-entries-list 'diary-entry-compare)))))
(setq diary-display-hook 'fancy-diary-display)


The fourth message is the file calendar.texinfo that is the documentation.


The big change in version 4 is the inclusion of sexp diary entries such as:

&%%(diary-day-of-year)
&%%(diary-hebrew-date)
&%%(diary-rosh-hodesh)
&%%(diary-parasha)
&%%(diary-omer)
%%(diary-yahrzeit 3 10 1964) Leah J. Reingold
&%%(diary-anniversary 12 22 1968) Ruth and Ed's %d%s wedding anniversary

and many others.  Read the texinfo file!

To obtain the latest release by email, send a message to
reingold@emr.cs.uiuc.edu with the subject field "send-emacs-cal" (no quotes).
The files can also be obtained by anonymous ftp from
          reingold@emr.cs.uiuc.edu:/pub/emacs/calendar/

To obtain a HARD COPY of a paper describing the various calendrical
calculations, including the details of the Hebrew, Islamic, ISO, and other
calendars, send a message to reingold@emr.cs.uiuc.edu with the subject field
"send-paper-cal" (no quotes) INCLUDING YOUR POSTAL ADDRESS (SNAIL) in the
message body.
