Mercurial > hg > xemacs-beta

comparison man/xemacs/calendar.texi @ 316:512e409c26a2 r21-0b56

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Import from CVS: tag r21-0b56
author cvs
date Mon, 13 Aug 2007 10:44:46 +0200
parents 70ad99077275
children afd57c14dfc8
comparison
equal deleted inserted replaced
315:5e87bc5b1ee4 316:512e409c26a2
192 @kbd{o} (@code{calendar-other-month}) prompts for a month and year, 192 @kbd{o} (@code{calendar-other-month}) prompts for a month and year,
193 then centers the three-month calendar around that month. 193 then centers the three-month calendar around that month.
194 194
195 @kindex . @r{(Calendar mode)} 195 @kindex . @r{(Calendar mode)}
196 @findex calendar-goto-today 196 @findex calendar-goto-today
197 You can return to today's date with @kbd{.} 197 You can return to today's date with @kbd{.}@:
198 (@code{calendar-goto-today}). 198 (@code{calendar-goto-today}).
199 199
200 @node Scroll Calendar, Mark and Region, Calendar Motion, Calendar/Diary 200 @node Scroll Calendar, Mark and Region, Calendar Motion, Calendar/Diary
201 @subsection Scrolling the Calendar through Time 201 @subsection Scrolling the Calendar through Time
202 202
391 @item t y 391 @item t y
392 Generate a calendar for one year 392 Generate a calendar for one year
393 (@code{cal-tex-cursor-year}). 393 (@code{cal-tex-cursor-year}).
394 @item t Y 394 @item t Y
395 Generate a sideways-printing calendar for one year 395 Generate a sideways-printing calendar for one year
396 (@code{cal-tex-cursor-landscape-year}). 396 (@code{cal-tex-cursor-year-landscape}).
397 @item t f y 397 @item t f y
398 Generate a Filofax-style calendar for one year 398 Generate a Filofax-style calendar for one year
399 (@code{cal-tex-cursor-filofax-year}). 399 (@code{cal-tex-cursor-filofax-year}).
400 @end table 400 @end table
401 401
478 equinoxes. 478 equinoxes.
479 479
480 @findex list-holidays 480 @findex list-holidays
481 The command @kbd{M-x list-holidays} displays the list of holidays for 481 The command @kbd{M-x list-holidays} displays the list of holidays for
482 a range of years. This function asks you for the starting and stopping 482 a range of years. This function asks you for the starting and stopping
483 years, and allows you to chose all the holidays or one of several 483 years, and allows you to choose all the holidays or one of several
484 categories of holidays. You can use this command even if you don't have 484 categories of holidays. You can use this command even if you don't have
485 a calendar window. 485 a calendar window.
486 486
487 The dates used by Emacs for holidays are based on @emph{current 487 The dates used by Emacs for holidays are based on @emph{current
488 practice}, not historical fact. Historically, for instance, the start 488 practice}, not historical fact. Historically, for instance, the start
996 Unmark the calendar window (@code{calendar-unmark}). 996 Unmark the calendar window (@code{calendar-unmark}).
997 @item M-x print-diary-entries 997 @item M-x print-diary-entries
998 Print hard copy of the diary display as it appears. 998 Print hard copy of the diary display as it appears.
999 @item M-x diary 999 @item M-x diary
1000 Display all diary entries for today's date. 1000 Display all diary entries for today's date.
1001 @item M-x diary-mail-entries
1002 Mail yourself email reminders about upcoming diary entries.
1001 @end table 1003 @end table
1002 1004
1003 @kindex d @r{(Calendar mode)} 1005 @kindex d @r{(Calendar mode)}
1004 @findex view-diary-entries 1006 @findex view-diary-entries
1005 Displaying the diary entries with @kbd{d} shows in a separate window 1007 Displaying the diary entries with @kbd{d} shows in a separate window
1051 1053
1052 If you put @code{(diary)} in your @file{.emacs} file, this 1054 If you put @code{(diary)} in your @file{.emacs} file, this
1053 automatically displays a window with the day's diary entries, when you 1055 automatically displays a window with the day's diary entries, when you
1054 enter Emacs. The mode line of the displayed window shows the date and 1056 enter Emacs. The mode line of the displayed window shows the date and
1055 any holidays that fall on that date. 1057 any holidays that fall on that date.
1058
1059 @findex diary-mail-entries
1060 @vindex diary-mail-days
1061 Many users like to receive notice of events in their diary as email.
1062 To send such mail to yourself, use the command @kbd{M-x
1063 diary-mail-entries}. A prefix argument specifies how many days
1064 (starting with today) to check; otherwise, the variable
1065 @code{diary-mail-days} says how many days.
1056 1066
1057 @node Format of Diary File, Date Formats, Diary Commands, Diary 1067 @node Format of Diary File, Date Formats, Diary Commands, Diary
1058 @subsection The Diary File 1068 @subsection The Diary File
1059 @cindex diary file 1069 @cindex diary file
1060 1070
1758 Gregorian date on which daylight savings time starts or (respectively) 1768 Gregorian date on which daylight savings time starts or (respectively)
1759 ends, in the form of a list @code{(@var{month} @var{day} @var{year})}. 1769 ends, in the form of a list @code{(@var{month} @var{day} @var{year})}.
1760 The values should be @code{nil} if your area does not use daylight 1770 The values should be @code{nil} if your area does not use daylight
1761 savings time. 1771 savings time.
1762 1772
1763 Emacs uses these expressions to determine the start and end dates of 1773 Emacs uses these expressions to determine the starting date of
1764 daylight savings time as holidays and for correcting times of day in the 1774 daylight savings time for the holiday list and for correcting times of
1765 solar and lunar calculations. 1775 day in the solar and lunar calculations.
1766 1776
1767 The values for Cambridge, Massachusetts are as follows: 1777 The values for Cambridge, Massachusetts are as follows:
1768 1778
1769 @example 1779 @example
1770 @group 1780 @group
1772 (calendar-nth-named-day -1 0 10 year) 1782 (calendar-nth-named-day -1 0 10 year)
1773 @end group 1783 @end group
1774 @end example 1784 @end example
1775 1785
1776 @noindent 1786 @noindent
1777 i.e., the first 0th day (Sunday) of the fourth month (April) in 1787 That is, the first 0th day (Sunday) of the fourth month (April) in
1778 the year specified by @code{year}, and the last Sunday of the tenth month 1788 the year specified by @code{year}, and the last Sunday of the tenth month
1779 (October) of that year. If daylight savings time were 1789 (October) of that year. If daylight savings time were
1780 changed to start on October 1, you would set 1790 changed to start on October 1, you would set
1781 @code{calendar-daylight-savings-starts} to this: 1791 @code{calendar-daylight-savings-starts} to this:
1782 1792
1807 difference between daylight savings time and standard time, measured in 1817 difference between daylight savings time and standard time, measured in
1808 minutes. The value for Cambridge, Massachusetts is 60. 1818 minutes. The value for Cambridge, Massachusetts is 60.
1809 1819
1810 @c @vindex calendar-daylight-savings-starts-time too long! 1820 @c @vindex calendar-daylight-savings-starts-time too long!
1811 @vindex calendar-daylight-savings-ends-time 1821 @vindex calendar-daylight-savings-ends-time
1812 The variable @code{calendar-daylight-savings-starts-time} and the 1822 The two variables @code{calendar-daylight-savings-starts-time} and
1813 variable @code{calendar-daylight-savings-ends-time} specify the number 1823 @code{calendar-daylight-savings-ends-time} specify the number of minutes
1814 of minutes after midnight local time when the transition to and from 1824 after midnight local time when the transition to and from daylight
1815 daylight savings time should occur. For Cambridge, both variables' 1825 savings time should occur. For Cambridge, Massachusetts both variables'
1816 values are 120. 1826 values are 120.
1817 1827
1818 @node Diary Customizing 1828 @node Diary Customizing
1819 @subsubsection Customizing the Diary 1829 @subsubsection Customizing the Diary
1820 1830