comparison lisp/calendar/auto-autoloads.el @ 163:0132846995bd r20-3b8

Import from CVS: tag r20-3b8
author cvs
date Mon, 13 Aug 2007 09:43:35 +0200
parents
children e121b013d1f0
comparison
equal deleted inserted replaced
162:4de2936b4e77 163:0132846995bd
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 ))