comparison man/xemacs/calendar.texi @ 373:6240c7796c7a r21-2b2

Import from CVS: tag r21-2b2
author cvs
date Mon, 13 Aug 2007 11:04:06 +0200
parents cc15677e0335
children de805c49cfc1
comparison
equal deleted inserted replaced
372:49e1ed2d7ed8 373:6240c7796c7a
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
1214 diary entry with the @kbd{i y} command. 1224 diary entry with the @kbd{i y} command.
1215 1225
1216 All of the above commands make marking diary entries by default. To 1226 All of the above commands make marking diary entries by default. To
1217 make a nonmarking diary entry, give a numeric argument to the command. 1227 make a nonmarking diary entry, give a numeric argument to the command.
1218 For example, @kbd{C-u i w} makes a nonmarking weekly diary entry. 1228 For example, @kbd{C-u i w} makes a nonmarking weekly diary entry.
1219
1220 All of the above commands make marking diary entries. If you want the diary
1221 entry to be nonmarking, give a prefix argument to the command. For example,
1222 @kbd{C-u i w} makes a nonmarking, weekly diary entry.
1223 1229
1224 When you modify the diary file, be sure to save the file before 1230 When you modify the diary file, be sure to save the file before
1225 exiting Emacs. 1231 exiting Emacs.
1226 1232
1227 @node Special Diary Entries,, Adding to Diary, Diary 1233 @node Special Diary Entries,, Adding to Diary, Diary
1758 Gregorian date on which daylight savings time starts or (respectively) 1764 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})}. 1765 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 1766 The values should be @code{nil} if your area does not use daylight
1761 savings time. 1767 savings time.
1762 1768
1763 Emacs uses these expressions to determine the start and end dates of 1769 Emacs uses these expressions to determine the starting date of
1764 daylight savings time as holidays and for correcting times of day in the 1770 daylight savings time for the holiday list and for correcting times of
1765 solar and lunar calculations. 1771 day in the solar and lunar calculations.
1766 1772
1767 The values for Cambridge, Massachusetts are as follows: 1773 The values for Cambridge, Massachusetts are as follows:
1768 1774
1769 @example 1775 @example
1770 @group 1776 @group
1772 (calendar-nth-named-day -1 0 10 year) 1778 (calendar-nth-named-day -1 0 10 year)
1773 @end group 1779 @end group
1774 @end example 1780 @end example
1775 1781
1776 @noindent 1782 @noindent
1777 i.e., the first 0th day (Sunday) of the fourth month (April) in 1783 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 1784 the year specified by @code{year}, and the last Sunday of the tenth month
1779 (October) of that year. If daylight savings time were 1785 (October) of that year. If daylight savings time were
1780 changed to start on October 1, you would set 1786 changed to start on October 1, you would set
1781 @code{calendar-daylight-savings-starts} to this: 1787 @code{calendar-daylight-savings-starts} to this:
1782 1788
1807 difference between daylight savings time and standard time, measured in 1813 difference between daylight savings time and standard time, measured in
1808 minutes. The value for Cambridge, Massachusetts is 60. 1814 minutes. The value for Cambridge, Massachusetts is 60.
1809 1815
1810 @c @vindex calendar-daylight-savings-starts-time too long! 1816 @c @vindex calendar-daylight-savings-starts-time too long!
1811 @vindex calendar-daylight-savings-ends-time 1817 @vindex calendar-daylight-savings-ends-time
1812 The variable @code{calendar-daylight-savings-starts-time} and the 1818 The two variables @code{calendar-daylight-savings-starts-time} and
1813 variable @code{calendar-daylight-savings-ends-time} specify the number 1819 @code{calendar-daylight-savings-ends-time} specify the number of minutes
1814 of minutes after midnight local time when the transition to and from 1820 after midnight local time when the transition to and from daylight
1815 daylight savings time should occur. For Cambridge, both variables' 1821 savings time should occur. For Cambridge, Massachusetts both variables'
1816 values are 120. 1822 values are 120.
1817 1823
1818 @node Diary Customizing 1824 @node Diary Customizing
1819 @subsubsection Customizing the Diary 1825 @subsubsection Customizing the Diary
1820 1826