particular date; @kbd{Buttons3} brings up a menu of commonly used
calendar features that are independent of any particular date. To exit
the calendar, type @kbd{q}. @xref{Calendar, Customizing the Calendar
-and Diary,, elisp, The Emacs Lisp Reference Manual}, for customization
+and Diary,, lispref, The XEmacs Lisp Reference Manual}, for customization
information about the calendar and diary.
@menu
@kindex . @r{(Calendar mode)}
@findex calendar-goto-today
- You can return to today's date with @kbd{.}
+ You can return to today's date with @kbd{.}@:
(@code{calendar-goto-today}).
@node Scroll Calendar, Mark and Region, Calendar Motion, Calendar/Diary
(@code{cal-tex-cursor-year}).
@item t Y
Generate a sideways-printing calendar for one year
-(@code{cal-tex-cursor-landscape-year}).
+(@code{cal-tex-cursor-year-landscape}).
@item t f y
Generate a Filofax-style calendar for one year
(@code{cal-tex-cursor-filofax-year}).
@findex list-holidays
The command @kbd{M-x list-holidays} displays the list of holidays for
a range of years. This function asks you for the starting and stopping
-years, and allows you to chose all the holidays or one of several
+years, and allows you to choose all the holidays or one of several
categories of holidays. You can use this command even if you don't have
a calendar window.
for how daylight savings time is determined.
As a user, you might find it convenient to set the calendar location
-variables for your usual physical location in your @file{.emacs} file.
-And when you install Emacs on a machine, you can create a
-@file{default.el} file which sets them properly for the typical location
-of most users of that machine. @xref{Init File}.
+variables for your usual physical location in your init file. And when
+you install Emacs on a machine, you can create a @file{default.el} file
+which sets them properly for the typical location of most users of that
+machine. @xref{Init File}.
@node Lunar Phases, Other Calendars, Sunrise/Sunset, Calendar/Diary
@subsection Phases of the Moon
Print hard copy of the diary display as it appears.
@item M-x diary
Display all diary entries for today's date.
+@item M-x diary-mail-entries
+Mail yourself email reminders about upcoming diary entries.
@end table
@kindex d @r{(Calendar mode)}
few days as well; the variable @code{number-of-diary-entries} specifies
how many days to include (@pxref{Customization}).
- If you put @code{(diary)} in your @file{.emacs} file, this
+ If you put @code{(diary)} in your init file, this
automatically displays a window with the day's diary entries, when you
-enter Emacs. The mode line of the displayed window shows the date and
-any holidays that fall on that date.
+enter Emacs. @xref{Init File}. The mode line of the displayed window
+shows the date and any holidays that fall on that date.
+
+@findex diary-mail-entries
+@vindex diary-mail-days
+ Many users like to receive notice of events in their diary as email.
+To send such mail to yourself, use the command @kbd{M-x
+diary-mail-entries}. A prefix argument specifies how many days
+(starting with today) to check; otherwise, the variable
+@code{diary-mail-days} says how many days.
@node Format of Diary File, Date Formats, Diary Commands, Diary
@subsection The Diary File
All of the above commands make marking diary entries by default. To
make a nonmarking diary entry, give a numeric argument to the command.
For example, @kbd{C-u i w} makes a nonmarking weekly diary entry.
-
- All of the above commands make marking diary entries. If you want the diary
-entry to be nonmarking, give a prefix argument to the command. For example,
-@kbd{C-u i w} makes a nonmarking, weekly diary entry.
When you modify the diary file, be sure to save the file before
exiting Emacs.
@code{t}, calling up the calendar automatically displays the diary
entries for the current date as well. The diary dates appear only if
the current date is visible. If you add both of the following lines to
-your @file{.emacs} file:@refill
+your init file:@refill
@example
(setq view-diary-entries-initially t)
@end example
@noindent
-this displays both the calendar and diary windows whenever you start Emacs.
+this displays both the calendar and diary windows whenever you start
+Emacs. @xref{Init File}.
@vindex view-calendar-holidays-initially
Similarly, if you set the variable
For example, suppose you want to add Bastille Day, celebrated in
France on July 14. You can do this by adding the following line
-to your @file{.emacs} file:
+to your init file:
@smallexample
(setq other-holidays '((holiday-fixed 7 14 "Bastille Day")))
@end smallexample
+@xref{Init File}.
+
@noindent
The holiday form @code{(holiday-fixed 7 14 "Bastille Day")} specifies the
fourteenth day of the seventh month (July).
The values should be @code{nil} if your area does not use daylight
savings time.
- Emacs uses these expressions to determine the start and end dates of
-daylight savings time as holidays and for correcting times of day in the
-solar and lunar calculations.
+ Emacs uses these expressions to determine the starting date of
+daylight savings time for the holiday list and for correcting times of
+day in the solar and lunar calculations.
The values for Cambridge, Massachusetts are as follows:
@end example
@noindent
-i.e., the first 0th day (Sunday) of the fourth month (April) in
+That is, the first 0th day (Sunday) of the fourth month (April) in
the year specified by @code{year}, and the last Sunday of the tenth month
(October) of that year. If daylight savings time were
changed to start on October 1, you would set
@c @vindex calendar-daylight-savings-starts-time too long!
@vindex calendar-daylight-savings-ends-time
- The variable @code{calendar-daylight-savings-starts-time} and the
-variable @code{calendar-daylight-savings-ends-time} specify the number
-of minutes after midnight local time when the transition to and from
-daylight savings time should occur. For Cambridge, both variables'
+ The two variables @code{calendar-daylight-savings-starts-time} and
+@code{calendar-daylight-savings-ends-time} specify the number of minutes
+after midnight local time when the transition to and from daylight
+savings time should occur. For Cambridge, Massachusetts both variables'
values are 120.
@node Diary Customizing
@cindex sorting diary entries
If you use the fancy diary display, you can use the normal hook
@code{list-diary-entries-hook} to sort each day's diary entries by their
-time of day. Add this line to your @file{.emacs} file:
+time of day. Add this line to your init file:
@findex sort-diary-entries
@example
(add-hook 'list-diary-entries-hook 'sort-diary-entries t)
@end example
+@xref{Init File}.
+
@noindent
For each day, this sorts diary entries that begin with a recognizable
time of day according to their times. Diary entries without times come
projects / chise / xemacs-chise.git.1 / blobdiff