|
163
|
1 ;;; DO NOT MODIFY THIS FILE
|
|
|
2 (if (not (featurep 'calendar-autoloads))
|
|
|
3 (progn
|
|
|
4
|
|
|
5 ;;;### (autoloads nil "cal-dst" "calendar/cal-dst.el")
|
|
|
6
|
|
|
7 (put 'calendar-daylight-savings-starts 'risky-local-variable t)
|
|
|
8
|
|
|
9 (put 'calendar-daylight-savings-ends 'risky-local-variable t)
|
|
|
10
|
|
|
11 ;;;***
|
|
|
12
|
|
|
13 ;;;### (autoloads nil "cal-x" "calendar/cal-x.el")
|
|
|
14
|
|
|
15 (defvar calendar-setup 'one-frame "\
|
|
|
16 The frame set up of the calendar.
|
|
|
17 The choices are `one-frame' (calendar and diary together in one separate,
|
|
|
18 dediciated frame) or `two-frames' (calendar and diary in separate, dedicated
|
|
|
19 frames); with any other value the current frame is used.")
|
|
|
20
|
|
|
21 ;;;***
|
|
|
22
|
|
|
23 ;;;### (autoloads (list-yahrzeit-dates calendar) "calendar" "calendar/calendar.el")
|
|
|
24
|
|
|
25 (defcustom calendar-week-start-day 0 "*The day of the week on which a week in the calendar begins.\n0 means Sunday (default), 1 means Monday, and so on." :type 'integer :group 'calendar)
|
|
|
26
|
|
|
27 (defcustom calendar-offset 0 "*The offset of the principal month from the center of the calendar window.\n0 means the principal month is in the center (default), -1 means on the left,\n+1 means on the right. Larger (or smaller) values push the principal month off\nthe screen." :type 'integer :group 'calendar)
|
|
|
28
|
|
|
29 (defcustom view-diary-entries-initially nil "*Non-nil means display current date's diary entries on entry.\nThe diary is displayed in another window when the calendar is first displayed,\nif the current date is visible. The number of days of diary entries displayed\nis governed by the variable `number-of-diary-entries'." :type 'boolean :group 'diary)
|
|
|
30
|
|
|
31 (defcustom number-of-diary-entries 1 "*Specifies how many days of diary entries are to be displayed initially.\nThis variable affects the diary display when the command M-x diary is used,\nor if the value of the variable `view-diary-entries-initially' is t. For\nexample, if the default value 1 is used, then only the current day's diary\nentries will be displayed. If the value 2 is used, then both the current\nday's and the next day's entries will be displayed.\n\nThe value can also be a vector such as [0 2 2 2 2 4 1]; this value\nsays to display no diary entries on Sunday, the display the entries\nfor the current date and the day after on Monday through Thursday,\ndisplay Friday through Monday's entries on Friday, and display only\nSaturday's entries on Saturday.\n\nThis variable does not affect the diary display with the `d' command\nfrom the calendar; in that case, the prefix argument controls the\nnumber of days of diary entries displayed." :type 'integer :group 'diary)
|
|
|
32
|
|
|
33 (defcustom mark-diary-entries-in-calendar nil "*Non-nil means mark dates with diary entries, in the calendar window.\nThe marking symbol is specified by the variable `diary-entry-marker'." :type 'boolean :group 'diary)
|
|
|
34
|
|
|
35 (defcustom view-calendar-holidays-initially nil "*Non-nil means display holidays for current three month period on entry.\nThe holidays are displayed in another window when the calendar is first\ndisplayed." :type 'boolean :group 'holidays)
|
|
|
36
|
|
|
37 (defcustom mark-holidays-in-calendar nil "*Non-nil means mark dates of holidays in the calendar window.\nThe marking symbol is specified by the variable `calendar-holiday-marker'." :type 'boolean :group 'holidays)
|
|
|
38
|
|
|
39 (defcustom all-hebrew-calendar-holidays nil "*If nil, show only major holidays from the Hebrew calendar.\nThis means only those Jewish holidays that appear on secular calendars.\n\nIf t, show all the holidays that would appear in a complete Hebrew calendar." :type 'boolean :group 'holidays)
|
|
|
40
|
|
|
41 (defcustom all-christian-calendar-holidays nil "*If nil, show only major holidays from the Christian calendar.\nThis means only those Christian holidays that appear on secular calendars.\n\nIf t, show all the holidays that would appear in a complete Christian\ncalendar." :type 'boolean :group 'holidays)
|
|
|
42
|
|
|
43 (defcustom all-islamic-calendar-holidays nil "*If nil, show only major holidays from the Islamic calendar.\nThis means only those Islamic holidays that appear on secular calendars.\n\nIf t, show all the holidays that would appear in a complete Islamic\ncalendar." :type 'boolean :group 'holidays)
|
|
|
44
|
|
|
45 (defcustom calendar-load-hook nil "*List of functions to be called after the calendar is first loaded.\nThis is the place to add key bindings to `calendar-mode-map'." :type 'hook :group 'calendar)
|
|
|
46
|
|
|
47 (defcustom initial-calendar-window-hook nil "*List of functions to be called when the calendar window is first opened.\nThe functions invoked are called after the calendar window is opened, but\nonce opened is never called again. Leaving the calendar with the `q' command\nand reentering it will cause these functions to be called again." :type 'hook :group 'calendar)
|
|
|
48
|
|
|
49 (defcustom today-visible-calendar-hook nil "*List of functions called whenever the current date is visible.\nThis can be used, for example, to replace today's date with asterisks; a\nfunction `calendar-star-date' is included for this purpose:\n (setq today-visible-calendar-hook 'calendar-star-date)\nIt can also be used to mark the current date with `calendar-today-marker';\na function is also provided for this:\n (setq today-visible-calendar-hook 'calendar-mark-today)\n\nThe corresponding variable `today-invisible-calendar-hook' is the list of\nfunctions called when the calendar function was called when the current\ndate is not visible in the window.\n\nOther than the use of the provided functions, the changing of any\ncharacters in the calendar buffer by the hooks may cause the failure of the\nfunctions that move by days and weeks." :type 'hook :group 'calendar)
|
|
|
50
|
|
|
51 (defcustom today-invisible-calendar-hook nil "*List of functions called whenever the current date is not visible.\n\nThe corresponding variable `today-visible-calendar-hook' is the list of\nfunctions called when the calendar function was called when the current\ndate is visible in the window.\n\nOther than the use of the provided functions, the changing of any\ncharacters in the calendar buffer by the hooks may cause the failure of the\nfunctions that move by days and weeks." :type 'hook :group 'calendar)
|
|
|
52
|
|
|
53 (defcustom diary-file "~/diary" "*Name of the file in which one's personal diary of dates is kept.\n\nThe file's entries are lines in any of the forms\n\n MONTH/DAY\n MONTH/DAY/YEAR\n MONTHNAME DAY\n MONTHNAME DAY, YEAR\n DAYNAME\n\nat the beginning of the line; the remainder of the line is the diary entry\nstring for that date. MONTH and DAY are one or two digit numbers, YEAR is\na number and may be written in full or abbreviated to the final two digits.\nIf the date does not contain a year, it is generic and applies to any year.\nDAYNAME entries apply to any date on which is on that day of the week.\nMONTHNAME and DAYNAME can be spelled in full, abbreviated to three\ncharacters (with or without a period), capitalized or not. Any of DAY,\nMONTH, or MONTHNAME, YEAR can be `*' which matches any day, month, or year,\nrespectively.\n\nThe European style (in which the day precedes the month) can be used\ninstead, if you execute `european-calendar' when in the calendar, or set\n`european-calendar-style' to t in your .emacs file. The European forms are\n\n DAY/MONTH\n DAY/MONTH/YEAR\n DAY MONTHNAME\n DAY MONTHNAME YEAR\n DAYNAME\n\nTo revert to the default American style from the European style, execute\n`american-calendar' in the calendar.\n\nA diary entry can be preceded by the character\n`diary-nonmarking-symbol' (ordinarily `&') to make that entry\nnonmarking--that is, it will not be marked on dates in the calendar\nwindow but will appear in a diary window.\n\nMultiline diary entries are made by indenting lines after the first with\neither a TAB or one or more spaces.\n\nLines not in one the above formats are ignored. Here are some sample diary\nentries (in the default American style):\n\n 12/22/1988 Twentieth wedding anniversary!!\n &1/1. Happy New Year!\n 10/22 Ruth's birthday.\n 21: Payday\n Tuesday--weekly meeting with grad students at 10am\n Supowit, Shen, Bitner, and Kapoor to attend.\n 1/13/89 Friday the thirteenth!!\n &thu 4pm squash game with Lloyd.\n mar 16 Dad's birthday\n April 15, 1989 Income tax due.\n &* 15 time cards due.\n\nIf the first line of a diary entry consists only of the date or day name with\nno trailing blanks or punctuation, then that line is not displayed in the\ndiary window; only the continuation lines is shown. For example, the\nsingle diary entry\n\n 02/11/1989\n Bill Blattner visits Princeton today\n 2pm Cognitive Studies Committee meeting\n 2:30-5:30 Lizzie at Lawrenceville for `Group Initiative'\n 4:00pm Jamie Tappenden\n 7:30pm Dinner at George and Ed's for Alan Ryan\n 7:30-10:00pm dance at Stewart Country Day School\n\nwill appear in the diary window without the date line at the beginning. This\nfacility allows the diary window to look neater, but can cause confusion if\nused with more than one day's entries displayed.\n\nDiary entries can be based on Lisp sexps. For example, the diary entry\n\n %%(diary-block 11 1 1990 11 10 1990) Vacation\n\ncauses the diary entry \"Vacation\" to appear from November 1 through November\n10, 1990. Other functions available are `diary-float', `diary-anniversary',\n`diary-cyclic', `diary-day-of-year', `diary-iso-date', `diary-french-date',\n`diary-hebrew-date', `diary-islamic-date', `diary-mayan-date',\n`diary-yahrzeit', `diary-sunrise-sunset', `diary-phases-of-moon',\n`diary-parasha', `diary-omer', `diary-rosh-hodesh', and\n`diary-sabbath-candles'. See the documentation for the function\n`list-sexp-diary-entries' for more details.\n\nDiary entries based on the Hebrew and/or the Islamic calendar are also\npossible, but because these are somewhat slow, they are ignored\nunless you set the `nongregorian-diary-listing-hook' and the\n`nongregorian-diary-marking-hook' appropriately. See the documentation\nfor these functions for details.\n\nDiary files can contain directives to include the contents of other files; for\ndetails, see the documentation for the variable `list-diary-entries-hook'." :type 'file :group 'diary)
|
|
|
54
|
|
|
55 (defcustom diary-nonmarking-symbol "&" "*Symbol indicating that a diary entry is not to be marked in the calendar." :type 'string :group 'diary)
|
|
|
56
|
|
|
57 (defcustom hebrew-diary-entry-symbol "H" "*Symbol indicating a diary entry according to the Hebrew calendar." :type 'string :group 'diary)
|
|
|
58
|
|
|
59 (defcustom islamic-diary-entry-symbol "I" "*Symbol indicating a diary entry according to the Islamic calendar." :type 'string :group 'diary)
|
|
|
60
|
|
|
61 (defcustom diary-include-string "#include" "*The string indicating inclusion of another file of diary entries.\nSee the documentation for the function `include-other-diary-files'." :type 'string :group 'diary)
|
|
|
62
|
|
|
63 (defcustom sexp-diary-entry-symbol "%%" "*The string used to indicate a sexp diary entry in diary-file.\nSee the documentation for the function `list-sexp-diary-entries'." :type 'string :group 'diary)
|
|
|
64
|
|
|
65 (defcustom abbreviated-calendar-year t "*Interpret a two-digit year DD in a diary entry as either 19DD or 20DD.\nFor the Gregorian calendar; similarly for the Hebrew and Islamic calendars.\nIf this variable is nil, years must be written in full." :type 'boolean :group 'diary)
|
|
|
66
|
|
|
67 (defcustom european-calendar-style nil "*Use the European style of dates in the diary and in any displays.\nIf this variable is t, a date 1/2/1990 would be interpreted as February 1,\n1990. The accepted European date styles are\n\n DAY/MONTH\n DAY/MONTH/YEAR\n DAY MONTHNAME\n DAY MONTHNAME YEAR\n DAYNAME\n\nNames can be capitalized or not, written in full, or abbreviated to three\ncharacters with or without a period." :type 'boolean :group 'diary)
|
|
|
68
|
|
|
69 (defcustom american-date-diary-pattern '((month "/" day "[^/0-9]") (month "/" day "/" year "[^0-9]") (monthname " *" day "[^,0-9]") (monthname " *" day ", *" year "[^0-9]") (dayname "\\W")) "*List of pseudo-patterns describing the American patterns of date used.\nSee the documentation of `diary-date-forms' for an explanation." :type '(repeat (choice (cons :tag "Backup" (const backup) (repeat (list :inline t :format "%v" (symbol :tag "Keyword") (choice symbol regexp)))) (repeat (list :inline t :format "%v" (symbol :tag "Keyword") (choice symbol regexp))))) :group 'diary)
|
|
|
70
|
|
|
71 (defcustom european-date-diary-pattern '((day "/" month "[^/0-9]") (day "/" month "/" year "[^0-9]") (backup day " *" monthname "\\W+\\<[^*0-9]") (day " *" monthname " *" year "[^0-9]") (dayname "\\W")) "*List of pseudo-patterns describing the European patterns of date used.\nSee the documentation of `diary-date-forms' for an explanation." :type '(repeat (choice (cons :tag "Backup" (const backup) (repeat (list :inline t :format "%v" (symbol :tag "Keyword") (choice symbol regexp)))) (repeat (list :inline t :format "%v" (symbol :tag "Keyword") (choice symbol regexp))))) :group 'diary)
|
|
|
72
|
|
|
73 (defcustom european-calendar-display-form '((if dayname (concat dayname ", ")) day " " monthname " " year) "*Pseudo-pattern governing the way a date appears in the European style.\nSee the documentation of calendar-date-display-form for an explanation." :type 'sexp :group 'calendar)
|
|
|
74
|
|
|
75 (defcustom american-calendar-display-form '((if dayname (concat dayname ", ")) monthname " " day ", " year) "*Pseudo-pattern governing the way a date appears in the American style.\nSee the documentation of `calendar-date-display-form' for an explanation." :type 'sexp :group 'calendar)
|
|
|
76
|
|
|
77 (defcustom print-diary-entries-hook 'lpr-buffer "*List of functions called after a temporary diary buffer is prepared.\nThe buffer shows only the diary entries currently visible in the diary\nbuffer. The default just does the printing. Other uses might include, for\nexample, rearranging the lines into order by day and time, saving the buffer\ninstead of deleting it, or changing the function used to do the printing." :type 'hook :group 'diary)
|
|
|
78
|
|
|
79 (defcustom list-diary-entries-hook nil "*List of functions called after diary file is culled for relevant entries.\nIt is to be used for diary entries that are not found in the diary file.\n\nA function `include-other-diary-files' is provided for use as the value of\nthis hook. This function enables you to use shared diary files together\nwith your own. The files included are specified in the diary file by lines\nof the form\n\n #include \"filename\"\n\nThis is recursive; that is, #include directives in files thus included are\nobeyed. You can change the \"#include\" to some other string by changing\nthe variable `diary-include-string'. When you use `include-other-diary-files'\nas part of the list-diary-entries-hook, you will probably also want to use the\nfunction `mark-included-diary-files' as part of `mark-diary-entries-hook'.\n\nFor example, you could use\n\n (setq list-diary-entries-hook\n '(include-other-diary-files sort-diary-entries))\n (setq diary-display-hook 'fancy-diary-display)\n\nin your `.emacs' file to cause the fancy diary buffer to be displayed with\ndiary entries from various included files, each day's entries sorted into\nlexicographic order." :type 'hook :group 'diary)
|
|
|
80
|
|
|
81 (defcustom diary-hook nil "*List of functions called after the display of the diary.\nCan be used for appointment notification." :type 'hook :group 'diary)
|
|
|
82
|
|
|
83 (defcustom diary-display-hook nil "*List of functions that handle the display of the diary.\nIf nil (the default), `simple-diary-display' is used. Use `ignore' for no\ndiary display.\n\nOrdinarily, this just displays the diary buffer (with holidays indicated in\nthe mode line), if there are any relevant entries. At the time these\nfunctions are called, the variable `diary-entries-list' is a list, in order\nby date, of all relevant diary entries in the form of ((MONTH DAY YEAR)\nSTRING), where string is the diary entry for the given date. This can be\nused, for example, a different buffer for display (perhaps combined with\nholidays), or produce hard copy output.\n\nA function `fancy-diary-display' is provided as an alternative\nchoice for this hook; this function prepares a special noneditable diary\nbuffer with the relevant diary entries that has neat day-by-day arrangement\nwith headings. The fancy diary buffer will show the holidays unless the\nvariable `holidays-in-diary-buffer' is set to nil. Ordinarily, the fancy\ndiary buffer will not show days for which there are no diary entries, even\nif that day is a holiday; if you want such days to be shown in the fancy\ndiary buffer, set the variable `diary-list-include-blanks' to t." :type 'hook :group 'diary)
|
|
|
84
|
|
|
85 (defcustom nongregorian-diary-listing-hook nil "*List of functions called for listing diary file and included files.\nAs the files are processed for diary entries, these functions are used to cull\nrelevant entries. You can use either or both of `list-hebrew-diary-entries'\nand `list-islamic-diary-entries'. The documentation for these functions\ndescribes the style of such diary entries." :type 'hook :group 'diary)
|
|
|
86
|
|
|
87 (defcustom mark-diary-entries-hook nil "*List of functions called after marking diary entries in the calendar.\n\nA function `mark-included-diary-files' is also provided for use as the\nmark-diary-entries-hook; it enables you to use shared diary files together\nwith your own. The files included are specified in the diary file by lines\nof the form\n #include \"filename\"\nThis is recursive; that is, #include directives in files thus included are\nobeyed. You can change the \"#include\" to some other string by changing the\nvariable `diary-include-string'. When you use `mark-included-diary-files' as\npart of the mark-diary-entries-hook, you will probably also want to use the\nfunction `include-other-diary-files' as part of `list-diary-entries-hook'." :type 'hook :group 'diary)
|
|
|
88
|
|
|
89 (defcustom nongregorian-diary-marking-hook nil "*List of functions called for marking diary file and included files.\nAs the files are processed for diary entries, these functions are used to cull\nrelevant entries. You can use either or both of `mark-hebrew-diary-entries'\nand `mark-islamic-diary-entries'. The documentation for these functions\ndescribes the style of such diary entries." :type 'hook :group 'diary)
|
|
|
90
|
|
|
91 (defcustom diary-list-include-blanks nil "*If nil, do not include days with no diary entry in the list of diary entries.\nSuch days will then not be shown in the fancy diary buffer, even if they\nare holidays." :type 'boolean :group 'diary)
|
|
|
92
|
|
|
93 (defcustom holidays-in-diary-buffer t "*Non-nil means include holidays in the diary display.\nThe holidays appear in the mode line of the diary buffer, or in the\nfancy diary buffer next to the date. This slows down the diary functions\nsomewhat; setting it to nil makes the diary display faster." :type 'boolean :group 'diary)
|
|
|
94
|
|
|
95 (defcustom general-holidays '((holiday-fixed 1 1 "New Year's Day") (holiday-float 1 1 3 "Martin Luther King Day") (holiday-fixed 2 2 "Ground Hog Day") (holiday-fixed 2 14 "Valentine's Day") (holiday-float 2 1 3 "President's Day") (holiday-fixed 3 17 "St. Patrick's Day") (holiday-fixed 4 1 "April Fool's Day") (holiday-float 5 0 2 "Mother's Day") (holiday-float 5 1 -1 "Memorial Day") (holiday-fixed 6 14 "Flag Day") (holiday-float 6 0 3 "Father's Day") (holiday-fixed 7 4 "Independence Day") (holiday-float 9 1 1 "Labor Day") (holiday-float 10 1 2 "Columbus Day") (holiday-fixed 10 31 "Halloween") (holiday-fixed 11 11 "Veteran's Day") (holiday-float 11 4 4 "Thanksgiving")) "*General holidays. Default value is for the United States.\nSee the documentation for `calendar-holidays' for details." :type 'sexp :group 'holidays)
|
|
|
96
|
|
|
97 (put 'general-holidays 'risky-local-variable t)
|
|
|
98
|
|
|
99 (defcustom local-holidays nil "*Local holidays.\nSee the documentation for `calendar-holidays' for details." :type 'sexp :group 'holidays :group 'local)
|
|
|
100
|
|
|
101 (put 'local-holidays 'risky-local-variable t)
|
|
|
102
|
|
|
103 (defcustom other-holidays nil "*User defined holidays.\nSee the documentation for `calendar-holidays' for details." :type 'sexp :group 'holidays)
|
|
|
104
|
|
|
105 (put 'other-holidays 'risky-local-variable t)
|
|
|
106
|
|
|
107 (defvar hebrew-holidays-1 '((holiday-rosh-hashanah-etc) (if all-hebrew-calendar-holidays (holiday-julian 11 (let* ((m displayed-month) (y displayed-year) (year)) (increment-calendar-month m y -1) (let ((year (extract-calendar-year (calendar-julian-from-absolute (calendar-absolute-from-gregorian (list m 1 y)))))) (if (zerop (% (1+ year) 4)) 22 21))) "\"Tal Umatar\" (evening)"))))
|
|
|
108
|
|
|
109 (put 'hebrew-holidays-1 'risky-local-variable t)
|
|
|
110
|
|
|
111 (defvar hebrew-holidays-2 '((if all-hebrew-calendar-holidays (holiday-hanukkah) (holiday-hebrew 9 25 "Hanukkah")) (if all-hebrew-calendar-holidays (holiday-hebrew 10 (let ((h-year (extract-calendar-year (calendar-hebrew-from-absolute (calendar-absolute-from-gregorian (list displayed-month 28 displayed-year)))))) (if (= (% (calendar-absolute-from-hebrew (list 10 10 h-year)) 7) 6) 11 10)) "Tzom Teveth")) (if all-hebrew-calendar-holidays (holiday-hebrew 11 15 "Tu B'Shevat"))))
|
|
|
112
|
|
|
113 (put 'hebrew-holidays-2 'risky-local-variable t)
|
|
|
114
|
|
|
115 (defvar hebrew-holidays-3 '((if all-hebrew-calendar-holidays (holiday-hebrew 11 (let ((m displayed-month) (y displayed-year)) (increment-calendar-month m y 1) (let* ((h-year (extract-calendar-year (calendar-hebrew-from-absolute (calendar-absolute-from-gregorian (list m (calendar-last-day-of-month m y) y))))) (s-s (calendar-hebrew-from-absolute (if (= (% (calendar-absolute-from-hebrew (list 7 1 h-year)) 7) 6) (calendar-dayname-on-or-before 6 (calendar-absolute-from-hebrew (list 11 17 h-year))) (calendar-dayname-on-or-before 6 (calendar-absolute-from-hebrew (list 11 16 h-year)))))) (day (extract-calendar-day s-s))) day)) "Shabbat Shirah"))))
|
|
|
116
|
|
|
117 (put 'hebrew-holidays-3 'risky-local-variable t)
|
|
|
118
|
|
|
119 (defvar hebrew-holidays-4 '((holiday-passover-etc) (if (and all-hebrew-calendar-holidays (let* ((m displayed-month) (y displayed-year) (year)) (increment-calendar-month m y -1) (let ((year (extract-calendar-year (calendar-julian-from-absolute (calendar-absolute-from-gregorian (list m 1 y)))))) (= 21 (% year 28))))) (holiday-julian 3 26 "Kiddush HaHamah")) (if all-hebrew-calendar-holidays (holiday-tisha-b-av-etc))))
|
|
|
120
|
|
|
121 (put 'hebrew-holidays-4 'risky-local-variable t)
|
|
|
122
|
|
|
123 (defvar hebrew-holidays (append hebrew-holidays-1 hebrew-holidays-2 hebrew-holidays-3 hebrew-holidays-4) "\
|
|
|
124 *Jewish holidays.
|
|
|
125 See the documentation for `calendar-holidays' for details.")
|
|
|
126
|
|
|
127 (put 'hebrew-holidays 'risky-local-variable t)
|
|
|
128
|
|
|
129 (defvar christian-holidays '((if all-christian-calendar-holidays (holiday-fixed 1 6 "Epiphany")) (holiday-easter-etc) (if all-christian-calendar-holidays (holiday-greek-orthodox-easter)) (if all-christian-calendar-holidays (holiday-fixed 8 15 "Assumption")) (if all-christian-calendar-holidays (holiday-advent)) (holiday-fixed 12 25 "Christmas") (if all-christian-calendar-holidays (holiday-julian 12 25 "Eastern Orthodox Christmas"))) "\
|
|
|
130 *Christian holidays.
|
|
|
131 See the documentation for `calendar-holidays' for details.")
|
|
|
132
|
|
|
133 (put 'christian-holidays 'risky-local-variable t)
|
|
|
134
|
|
|
135 (defvar islamic-holidays '((holiday-islamic 1 1 (format "Islamic New Year %d" (let ((m displayed-month) (y displayed-year)) (increment-calendar-month m y 1) (extract-calendar-year (calendar-islamic-from-absolute (calendar-absolute-from-gregorian (list m (calendar-last-day-of-month m y) y))))))) (if all-islamic-calendar-holidays (holiday-islamic 1 10 "Ashura")) (if all-islamic-calendar-holidays (holiday-islamic 3 12 "Mulad-al-Nabi")) (if all-islamic-calendar-holidays (holiday-islamic 7 26 "Shab-e-Mi'raj")) (if all-islamic-calendar-holidays (holiday-islamic 8 15 "Shab-e-Bara't")) (holiday-islamic 9 1 "Ramadan Begins") (if all-islamic-calendar-holidays (holiday-islamic 9 27 "Shab-e Qadr")) (if all-islamic-calendar-holidays (holiday-islamic 10 1 "Id-al-Fitr")) (if all-islamic-calendar-holidays (holiday-islamic 12 10 "Id-al-Adha"))) "\
|
|
|
136 *Islamic holidays.
|
|
|
137 See the documentation for `calendar-holidays' for details.")
|
|
|
138
|
|
|
139 (put 'islamic-holidays 'risky-local-variable t)
|
|
|
140
|
|
|
141 (defvar solar-holidays '((if (fboundp 'atan) (solar-equinoxes-solstices)) (if (progn (require 'cal-dst) t) (funcall 'holiday-sexp calendar-daylight-savings-starts '(format "Daylight Savings Time Begins %s" (if (fboundp 'atan) (solar-time-string (/ calendar-daylight-savings-starts-time (float 60)) calendar-standard-time-zone-name) "")))) (funcall 'holiday-sexp calendar-daylight-savings-ends '(format "Daylight Savings Time Ends %s" (if (fboundp 'atan) (solar-time-string (/ calendar-daylight-savings-ends-time (float 60)) calendar-daylight-time-zone-name) "")))) "\
|
|
|
142 *Sun-related holidays.
|
|
|
143 See the documentation for `calendar-holidays' for details.")
|
|
|
144
|
|
|
145 (put 'solar-holidays 'risky-local-variable t)
|
|
|
146
|
|
|
147 (defvar calendar-holidays (append general-holidays local-holidays other-holidays christian-holidays hebrew-holidays islamic-holidays solar-holidays) "\
|
|
|
148 *List of notable days for the command M-x holidays.
|
|
|
149
|
|
|
150 Additional holidays are easy to add to the list, just put them in the list
|
|
|
151 `other-holidays' in your .emacs file. Similarly, by setting any of
|
|
|
152 `general-holidays', `local-holidays' `christian-holidays', `hebrew-holidays',
|
|
|
153 `islamic-holidays', or `solar-holidays' to nil in your .emacs file, you can
|
|
|
154 eliminate unwanted categories of holidays. The intention is that (in the US)
|
|
|
155 `local-holidays' be set in site-init.el and `other-holidays' be set by the
|
|
|
156 user.
|
|
|
157
|
|
|
158 Entries on the list are expressions that return (possibly empty) lists of
|
|
|
159 items of the form ((month day year) string) of a holiday in the in the
|
|
|
160 three-month period centered around `displayed-month' of `displayed-year'.
|
|
|
161 Several basic functions are provided for this purpose:
|
|
|
162
|
|
|
163 (holiday-fixed MONTH DAY STRING) is a fixed date on the Gregorian calendar
|
|
|
164 (holiday-float MONTH DAYNAME K STRING &optional day) is the Kth DAYNAME in
|
|
|
165 MONTH on the Gregorian calendar (0 for Sunday,
|
|
|
166 etc.); K<0 means count back from the end of the
|
|
|
167 month. An optional parameter DAY means the Kth
|
|
|
168 DAYNAME after/before MONTH DAY.
|
|
|
169 (holiday-hebrew MONTH DAY STRING) a fixed date on the Hebrew calendar
|
|
|
170 (holiday-islamic MONTH DAY STRING) a fixed date on the Islamic calendar
|
|
|
171 (holiday-julian MONTH DAY STRING) a fixed date on the Julian calendar
|
|
|
172 (holiday-sexp SEXP STRING) SEXP is a Gregorian-date-valued expression
|
|
|
173 in the variable `year'; if it evaluates to
|
|
|
174 a visible date, that's the holiday; if it
|
|
|
175 evaluates to nil, there's no holiday. STRING
|
|
|
176 is an expression in the variable `date'.
|
|
|
177
|
|
|
178 For example, to add Bastille Day, celebrated in France on July 14, add
|
|
|
179
|
|
|
180 (holiday-fixed 7 14 \"Bastille Day\")
|
|
|
181
|
|
|
182 to the list. To add Hurricane Supplication Day, celebrated in the Virgin
|
|
|
183 Islands on the fourth Monday in August, add
|
|
|
184
|
|
|
185 (holiday-float 8 1 4 \"Hurricane Supplication Day\")
|
|
|
186
|
|
|
187 to the list (the last Monday would be specified with `-1' instead of `4').
|
|
|
188 To add the last day of Hanukkah to the list, use
|
|
|
189
|
|
|
190 (holiday-hebrew 10 2 \"Last day of Hanukkah\")
|
|
|
191
|
|
|
192 since the Hebrew months are numbered with 1 starting from Nisan, while to
|
|
|
193 add the Islamic feast celebrating Mohammed's birthday use
|
|
|
194
|
|
|
195 (holiday-islamic 3 12 \"Mohammed's Birthday\")
|
|
|
196
|
|
|
197 since the Islamic months are numbered from 1 starting with Muharram. To
|
|
|
198 add Thomas Jefferson's birthday, April 2, 1743 (Julian), use
|
|
|
199
|
|
|
200 (holiday-julian 4 2 \"Jefferson's Birthday\")
|
|
|
201
|
|
|
202 To include a holiday conditionally, use the sexp form or a conditional. For
|
|
|
203 example, to include American presidential elections, which occur on the first
|
|
|
204 Tuesday after the first Monday in November of years divisible by 4, add
|
|
|
205
|
|
|
206 (holiday-sexp
|
|
|
207 (if (zerop (% year 4))
|
|
|
208 (calendar-gregorian-from-absolute
|
|
|
209 (1+ (calendar-dayname-on-or-before
|
|
|
210 1 (+ 6 (calendar-absolute-from-gregorian
|
|
|
211 (list 11 1 year)))))))
|
|
|
212 \"US Presidential Election\")
|
|
|
213
|
|
|
214 or
|
|
|
215
|
|
|
216 (if (zerop (% displayed-year 4))
|
|
|
217 (holiday-fixed 11
|
|
|
218 (extract-calendar-day
|
|
|
219 (calendar-gregorian-from-absolute
|
|
|
220 (1+ (calendar-dayname-on-or-before
|
|
|
221 1 (+ 6 (calendar-absolute-from-gregorian
|
|
|
222 (list 11 1 displayed-year)))))))
|
|
|
223 \"US Presidential Election\"))
|
|
|
224
|
|
|
225 to the list. To include the phases of the moon, add
|
|
|
226
|
|
|
227 (lunar-phases)
|
|
|
228
|
|
|
229 to the holiday list, where `lunar-phases' is an Emacs-Lisp function that
|
|
|
230 you've written to return a (possibly empty) list of the relevant VISIBLE dates
|
|
|
231 with descriptive strings such as
|
|
|
232
|
|
|
233 (((2 6 1989) \"New Moon\") ((2 12 1989) \"First Quarter Moon\") ... ).")
|
|
|
234
|
|
|
235 (put 'calendar-holidays 'risky-local-variable t)
|
|
|
236
|
|
|
237 (autoload 'calendar "calendar" "\
|
|
|
238 Display a three-month calendar in another window.
|
|
|
239 The three months appear side by side, with the current month in the middle
|
|
|
240 surrounded by the previous and next months. The cursor is put on today's date.
|
|
|
241
|
|
|
242 If called with an optional prefix argument, prompts for month and year.
|
|
|
243
|
|
|
244 This function is suitable for execution in a .emacs file; appropriate setting
|
|
|
245 of the variable `view-diary-entries-initially' will cause the diary entries for
|
|
|
246 the current date to be displayed in another window. The value of the variable
|
|
|
247 `number-of-diary-entries' controls the number of days of diary entries
|
|
|
248 displayed upon initial display of the calendar.
|
|
|
249
|
|
|
250 An optional prefix argument ARG causes the calendar displayed to be ARG
|
|
|
251 months in the future if ARG is positive or in the past if ARG is negative;
|
|
|
252 in this case the cursor goes on the first day of the month.
|
|
|
253
|
|
|
254 Once in the calendar window, future or past months can be moved into view.
|
|
|
255 Arbitrary months can be displayed, or the calendar can be scrolled forward
|
|
|
256 or backward.
|
|
|
257
|
|
|
258 The cursor can be moved forward or backward by one day, one week, one month,
|
|
|
259 or one year. All of these commands take prefix arguments which, when negative,
|
|
|
260 cause movement in the opposite direction. For convenience, the digit keys
|
|
|
261 and the minus sign are automatically prefixes. The window is replotted as
|
|
|
262 necessary to display the desired date.
|
|
|
263
|
|
|
264 Diary entries can be marked on the calendar or displayed in another window.
|
|
|
265
|
|
|
266 Use M-x describe-mode for details of the key bindings in the calendar window.
|
|
|
267
|
|
|
268 The Gregorian calendar is assumed.
|
|
|
269
|
|
|
270 After loading the calendar, the hooks given by the variable
|
|
|
271 `calendar-load-hook' are run. This is the place to add key bindings to the
|
|
|
272 calendar-mode-map.
|
|
|
273
|
|
|
274 After preparing the calendar window initially, the hooks given by the variable
|
|
|
275 `initial-calendar-window-hook' are run.
|
|
|
276
|
|
|
277 The hooks given by the variable `today-visible-calendar-hook' are run
|
|
|
278 everytime the calendar window gets scrolled, if the current date is visible
|
|
|
279 in the window. If it is not visible, the hooks given by the variable
|
|
|
280 `today-invisible-calendar-hook' are run. Thus, for example, setting
|
|
|
281 `today-visible-calendar-hook' to 'calendar-star-date will cause today's date
|
|
|
282 to be replaced by asterisks to highlight it whenever it is in the window." t nil)
|
|
|
283
|
|
|
284 (autoload 'list-yahrzeit-dates "calendar" "\
|
|
|
285 List Yahrzeit dates for *Gregorian* DEATH-DATE from START-YEAR to END-YEAR.
|
|
|
286 When called interactively from the calendar window, the date of death is taken
|
|
|
287 from the cursor position." t nil)
|
|
|
288
|
|
|
289 ;;;***
|
|
|
290
|
|
|
291 ;;;### (autoloads (diary) "diary-lib" "calendar/diary-lib.el")
|
|
|
292
|
|
|
293 (autoload 'diary "diary-lib" "\
|
|
|
294 Generate the diary window for ARG days starting with the current date.
|
|
|
295 If no argument is provided, the number of days of diary entries is governed
|
|
|
296 by the variable `number-of-diary-entries'. This function is suitable for
|
|
|
297 execution in a `.emacs' file." t nil)
|
|
|
298
|
|
|
299 ;;;***
|
|
|
300
|
|
|
301 ;;;### (autoloads (holidays) "holidays" "calendar/holidays.el")
|
|
|
302
|
|
|
303 (autoload 'holidays "holidays" "\
|
|
|
304 Display the holidays for last month, this month, and next month.
|
|
|
305 If called with an optional prefix argument, prompts for month and year.
|
|
|
306
|
|
|
307 This function is suitable for execution in a .emacs file." t nil)
|
|
|
308
|
|
|
309 ;;;***
|
|
|
310
|
|
|
311 ;;;### (autoloads (phases-of-moon) "lunar" "calendar/lunar.el")
|
|
|
312
|
|
|
313 (autoload 'phases-of-moon "lunar" "\
|
|
|
314 Display the quarters of the moon for last month, this month, and next month.
|
|
|
315 If called with an optional prefix argument, prompts for month and year.
|
|
|
316
|
|
|
317 This function is suitable for execution in a .emacs file." t nil)
|
|
|
318
|
|
|
319 ;;;***
|
|
|
320
|
|
|
321 ;;;### (autoloads (solar-equinoxes-solstices sunrise-sunset) "solar" "calendar/solar.el")
|
|
|
322
|
|
|
323 (defvar calendar-time-display-form '(12-hours ":" minutes am-pm (if time-zone " (") time-zone (if time-zone ")")) "\
|
|
|
324 *The pseudo-pattern that governs the way a time of day is formatted.
|
|
|
325
|
|
|
326 A pseudo-pattern is a list of expressions that can involve the keywords
|
|
|
327 `12-hours', `24-hours', and `minutes', all numbers in string form,
|
|
|
328 and `am-pm' and `time-zone', both alphabetic strings.
|
|
|
329
|
|
|
330 For example, the form
|
|
|
331
|
|
|
332 '(24-hours \":\" minutes
|
|
|
333 (if time-zone \" (\") time-zone (if time-zone \")\"))
|
|
|
334
|
|
|
335 would give military-style times like `21:07 (UTC)'.")
|
|
|
336
|
|
|
337 (defvar calendar-latitude nil "\
|
|
|
338 *Latitude of `calendar-location-name' in degrees.
|
|
|
339
|
|
|
340 The value can be either a decimal fraction (one place of accuracy is
|
|
|
341 sufficient), + north, - south, such as 40.7 for New York City, or the value
|
|
|
342 can be a vector [degrees minutes north/south] such as [40 50 north] for New
|
|
|
343 York City.
|
|
|
344
|
|
|
345 This variable should be set in site-local.el.")
|
|
|
346
|
|
|
347 (defvar calendar-longitude nil "\
|
|
|
348 *Longitude of `calendar-location-name' in degrees.
|
|
|
349
|
|
|
350 The value can be either a decimal fraction (one place of accuracy is
|
|
|
351 sufficient), + east, - west, such as -73.9 for New York City, or the value
|
|
|
352 can be a vector [degrees minutes east/west] such as [73 55 west] for New
|
|
|
353 York City.
|
|
|
354
|
|
|
355 This variable should be set in site-local.el.")
|
|
|
356
|
|
|
357 (defvar calendar-location-name '(let ((float-output-format "%.1f")) (format "%s%s, %s%s" (if (numberp calendar-latitude) (abs calendar-latitude) (+ (aref calendar-latitude 0) (/ (aref calendar-latitude 1) 60.0))) (if (numberp calendar-latitude) (if (> calendar-latitude 0) "N" "S") (if (equal (aref calendar-latitude 2) 'north) "N" "S")) (if (numberp calendar-longitude) (abs calendar-longitude) (+ (aref calendar-longitude 0) (/ (aref calendar-longitude 1) 60.0))) (if (numberp calendar-longitude) (if (> calendar-longitude 0) "E" "W") (if (equal (aref calendar-latitude 2) 'east) "E" "W")))) "\
|
|
|
358 *Expression evaluating to name of `calendar-longitude', calendar-latitude'.
|
|
|
359 For example, \"New York City\". Default value is just the latitude, longitude
|
|
|
360 pair.
|
|
|
361
|
|
|
362 This variable should be set in site-local.el.")
|
|
|
363
|
|
|
364 (autoload 'sunrise-sunset "solar" "\
|
|
|
365 Local time of sunrise and sunset for today. Accurate to +/- 2 minutes.
|
|
|
366 If called with an optional prefix argument, prompt for date.
|
|
|
367
|
|
|
368 If called with an optional double prefix argument, prompt for longitude,
|
|
|
369 latitude, time zone, and date, and always use standard time.
|
|
|
370
|
|
|
371 This function is suitable for execution in a .emacs file." t nil)
|
|
|
372
|
|
|
373 (autoload 'solar-equinoxes-solstices "solar" "\
|
|
|
374 Date and time of equinoxes and solstices, if visible in the calendar window.
|
|
|
375 Requires floating point." nil nil)
|
|
|
376
|
|
|
377 ;;;***
|
|
|
378
|
|
|
379 (provide 'calendar-autoloads)
|
|
|
380 ))
|
