comparison man/xemacs/calendar.texi @ 371:cc15677e0335 r21-2b1

Import from CVS: tag r21-2b1
author cvs
date Mon, 13 Aug 2007 11:03:08 +0200
parents a4f53d9b3154
children 6240c7796c7a
comparison
equal deleted inserted replaced
370:bd866891f083 371:cc15677e0335
13 13
14 @kbd{Button2} in the calendar brings up a menu of operations on a 14 @kbd{Button2} in the calendar brings up a menu of operations on a
15 particular date; @kbd{Buttons3} brings up a menu of commonly used 15 particular date; @kbd{Buttons3} brings up a menu of commonly used
16 calendar features that are independent of any particular date. To exit 16 calendar features that are independent of any particular date. To exit
17 the calendar, type @kbd{q}. @xref{Calendar, Customizing the Calendar 17 the calendar, type @kbd{q}. @xref{Calendar, Customizing the Calendar
18 and Diary,, lispref, The XEmacs Lisp Reference Manual}, for customization 18 and Diary,, elisp, The Emacs Lisp Reference Manual}, for customization
19 information about the calendar and diary. 19 information about the calendar and diary.
20 20
21 @menu 21 @menu
22 * Calendar Motion:: Moving through the calendar; selecting a date. 22 * Calendar Motion:: Moving through the calendar; selecting a date.
23 * Scroll Calendar:: Bringing earlier or later months onto the screen. 23 * Scroll Calendar:: Bringing earlier or later months onto the screen.
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-year-landscape}). 396 (@code{cal-tex-cursor-landscape-year}).
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 choose all the holidays or one of several 483 years, and allows you to chose 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.
1003 @end table 1001 @end table
1004 1002
1005 @kindex d @r{(Calendar mode)} 1003 @kindex d @r{(Calendar mode)}
1006 @findex view-diary-entries 1004 @findex view-diary-entries
1007 Displaying the diary entries with @kbd{d} shows in a separate window 1005 Displaying the diary entries with @kbd{d} shows in a separate window
1053 1051
1054 If you put @code{(diary)} in your @file{.emacs} file, this 1052 If you put @code{(diary)} in your @file{.emacs} file, this
1055 automatically displays a window with the day's diary entries, when you 1053 automatically displays a window with the day's diary entries, when you
1056 enter Emacs. The mode line of the displayed window shows the date and 1054 enter Emacs. The mode line of the displayed window shows the date and
1057 any holidays that fall on that date. 1055 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.
1066 1056
1067 @node Format of Diary File, Date Formats, Diary Commands, Diary 1057 @node Format of Diary File, Date Formats, Diary Commands, Diary
1068 @subsection The Diary File 1058 @subsection The Diary File
1069 @cindex diary file 1059 @cindex diary file
1070 1060
1224 diary entry with the @kbd{i y} command. 1214 diary entry with the @kbd{i y} command.
1225 1215
1226 All of the above commands make marking diary entries by default. To 1216 All of the above commands make marking diary entries by default. To
1227 make a nonmarking diary entry, give a numeric argument to the command. 1217 make a nonmarking diary entry, give a numeric argument to the command.
1228 For example, @kbd{C-u i w} makes a nonmarking weekly diary entry. 1218 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.
1229 1223
1230 When you modify the diary file, be sure to save the file before 1224 When you modify the diary file, be sure to save the file before
1231 exiting Emacs. 1225 exiting Emacs.
1232 1226
1233 @node Special Diary Entries,, Adding to Diary, Diary 1227 @node Special Diary Entries,, Adding to Diary, Diary
1764 Gregorian date on which daylight savings time starts or (respectively) 1758 Gregorian date on which daylight savings time starts or (respectively)
1765 ends, in the form of a list @code{(@var{month} @var{day} @var{year})}. 1759 ends, in the form of a list @code{(@var{month} @var{day} @var{year})}.
1766 The values should be @code{nil} if your area does not use daylight 1760 The values should be @code{nil} if your area does not use daylight
1767 savings time. 1761 savings time.
1768 1762
1769 Emacs uses these expressions to determine the starting date of 1763 Emacs uses these expressions to determine the start and end dates of
1770 daylight savings time for the holiday list and for correcting times of 1764 daylight savings time as holidays and for correcting times of day in the
1771 day in the solar and lunar calculations. 1765 solar and lunar calculations.
1772 1766
1773 The values for Cambridge, Massachusetts are as follows: 1767 The values for Cambridge, Massachusetts are as follows:
1774 1768
1775 @example 1769 @example
1776 @group 1770 @group
1778 (calendar-nth-named-day -1 0 10 year) 1772 (calendar-nth-named-day -1 0 10 year)
1779 @end group 1773 @end group
1780 @end example 1774 @end example
1781 1775
1782 @noindent 1776 @noindent
1783 That is, the first 0th day (Sunday) of the fourth month (April) in 1777 i.e., the first 0th day (Sunday) of the fourth month (April) in
1784 the year specified by @code{year}, and the last Sunday of the tenth month 1778 the year specified by @code{year}, and the last Sunday of the tenth month
1785 (October) of that year. If daylight savings time were 1779 (October) of that year. If daylight savings time were
1786 changed to start on October 1, you would set 1780 changed to start on October 1, you would set
1787 @code{calendar-daylight-savings-starts} to this: 1781 @code{calendar-daylight-savings-starts} to this:
1788 1782
1813 difference between daylight savings time and standard time, measured in 1807 difference between daylight savings time and standard time, measured in
1814 minutes. The value for Cambridge, Massachusetts is 60. 1808 minutes. The value for Cambridge, Massachusetts is 60.
1815 1809
1816 @c @vindex calendar-daylight-savings-starts-time too long! 1810 @c @vindex calendar-daylight-savings-starts-time too long!
1817 @vindex calendar-daylight-savings-ends-time 1811 @vindex calendar-daylight-savings-ends-time
1818 The two variables @code{calendar-daylight-savings-starts-time} and 1812 The variable @code{calendar-daylight-savings-starts-time} and the
1819 @code{calendar-daylight-savings-ends-time} specify the number of minutes 1813 variable @code{calendar-daylight-savings-ends-time} specify the number
1820 after midnight local time when the transition to and from daylight 1814 of minutes after midnight local time when the transition to and from
1821 savings time should occur. For Cambridge, Massachusetts both variables' 1815 daylight savings time should occur. For Cambridge, both variables'
1822 values are 120. 1816 values are 120.
1823 1817
1824 @node Diary Customizing 1818 @node Diary Customizing
1825 @subsubsection Customizing the Diary 1819 @subsubsection Customizing the Diary
1826 1820