Mercurial > hg > xemacs-beta
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 |