Mercurial > emacs
annotate lisp/calendar/appt.el @ 88336:f6a3624b4de6
*** empty log message ***
author | Alex Schroeder <alex@gnu.org> |
---|---|
date | Tue, 11 Apr 2006 13:29:07 +0000 |
parents | d7ddb3e565de |
children |
rev | line source |
---|---|
38412
253f761ad37b
Some fixes to follow coding conventions in files maintained by FSF.
Pavel Janík <Pavel@Janik.cz>
parents:
30538
diff
changeset
|
1 ;;; appt.el --- appointment notification functions |
662
8a533acedb77
*** empty log message ***
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
179
diff
changeset
|
2 |
88155 | 3 ;; Copyright (C) 1989, 1990, 1994, 1998, 2001, 2002, 2003, 2004, 2005 |
4 ;; Free Software Foundation, Inc. | |
846
20674ae6bf52
*** empty log message ***
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
807
diff
changeset
|
5 |
807
4f28bd14272c
*** empty log message ***
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
777
diff
changeset
|
6 ;; Author: Neil Mager <neilm@juliet.ll.mit.edu> |
88155 | 7 ;; Maintainer: Glenn Morris <rgm@gnu.org> |
807
4f28bd14272c
*** empty log message ***
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
777
diff
changeset
|
8 ;; Keywords: calendar |
4f28bd14272c
*** empty log message ***
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
777
diff
changeset
|
9 |
179 | 10 ;; This file is part of GNU Emacs. |
11 | |
12 ;; GNU Emacs is free software; you can redistribute it and/or modify | |
13 ;; it under the terms of the GNU General Public License as published by | |
807
4f28bd14272c
*** empty log message ***
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
777
diff
changeset
|
14 ;; the Free Software Foundation; either version 2, or (at your option) |
179 | 15 ;; any later version. |
16 | |
17 ;; GNU Emacs is distributed in the hope that it will be useful, | |
18 ;; but WITHOUT ANY WARRANTY; without even the implied warranty of | |
19 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | |
20 ;; GNU General Public License for more details. | |
21 | |
22 ;; You should have received a copy of the GNU General Public License | |
14169 | 23 ;; along with GNU Emacs; see the file COPYING. If not, write to the |
88155 | 24 ;; Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, |
25 ;; Boston, MA 02110-1301, USA. | |
179 | 26 |
807
4f28bd14272c
*** empty log message ***
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
777
diff
changeset
|
27 ;;; Commentary: |
4f28bd14272c
*** empty log message ***
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
777
diff
changeset
|
28 |
179 | 29 ;; |
30 ;; appt.el - visible and/or audible notification of | |
88155 | 31 ;; appointments from diary file. |
179 | 32 ;; |
33 ;;; | |
28404 | 34 ;;; Thanks to Edward M. Reingold for much help and many suggestions, |
179 | 35 ;;; And to many others for bug fixes and suggestions. |
36 ;;; | |
37 ;;; | |
49598
0d8b17d428b5
Trailing whitepace deleted.
Juanma Barranquero <lekktu@gmail.com>
parents:
46909
diff
changeset
|
38 ;;; This functions in this file will alert the user of a |
88155 | 39 ;;; pending appointment based on his/her diary file. This package |
40 ;;; is documented in the Emacs manual. | |
179 | 41 ;;; |
88155 | 42 ;;; To activate this package, simply use (appt-activate 1). |
43 ;;; A `diary-file' with appointments of the format described in the | |
44 ;;; documentation of the function `appt-check' is required. | |
45 ;;; Relevant customizable variables are also listed in the | |
46 ;;; documentation of that function. | |
49598
0d8b17d428b5
Trailing whitepace deleted.
Juanma Barranquero <lekktu@gmail.com>
parents:
46909
diff
changeset
|
47 ;;; |
88155 | 48 ;;; Today's appointment list is initialized from the diary when this |
49 ;;; package is activated. Additionally, the appointments list is | |
50 ;;; recreated automatically at 12:01am for those who do not logout | |
51 ;;; every day or are programming late. It is also updated when the | |
52 ;;; `diary-file' is saved. Calling `appt-check' with an argument forces | |
53 ;;; a re-initialization at any time. | |
179 | 54 ;;; |
88155 | 55 ;;; In order to add or delete items from today's list, without |
56 ;;; changing the diary file, use `appt-add' and `appt-delete'. | |
179 | 57 ;;; |
88155 | 58 |
28404 | 59 ;;; Brief internal description - Skip this if you are not interested! |
179 | 60 ;;; |
88155 | 61 ;;; The function `appt-make-list' creates the appointments list which |
62 ;;; `appt-check' reads. | |
179 | 63 ;;; |
5659
32a02ab40d58
(appt-check): Use the new variables
Richard M. Stallman <rms@gnu.org>
parents:
5034
diff
changeset
|
64 ;;; You can change the way the appointment window is created/deleted by |
88155 | 65 ;;; setting the variables |
5659
32a02ab40d58
(appt-check): Use the new variables
Richard M. Stallman <rms@gnu.org>
parents:
5034
diff
changeset
|
66 ;;; |
32a02ab40d58
(appt-check): Use the new variables
Richard M. Stallman <rms@gnu.org>
parents:
5034
diff
changeset
|
67 ;;; appt-disp-window-function |
32a02ab40d58
(appt-check): Use the new variables
Richard M. Stallman <rms@gnu.org>
parents:
5034
diff
changeset
|
68 ;;; and |
32a02ab40d58
(appt-check): Use the new variables
Richard M. Stallman <rms@gnu.org>
parents:
5034
diff
changeset
|
69 ;;; appt-delete-window-function |
32a02ab40d58
(appt-check): Use the new variables
Richard M. Stallman <rms@gnu.org>
parents:
5034
diff
changeset
|
70 ;;; |
88155 | 71 ;;; For instance, these variables could be set to functions that display |
5659
32a02ab40d58
(appt-check): Use the new variables
Richard M. Stallman <rms@gnu.org>
parents:
5034
diff
changeset
|
72 ;;; appointments in pop-up frames, which are lowered or iconified after |
88155 | 73 ;;; `appt-display-interval' minutes. |
5659
32a02ab40d58
(appt-check): Use the new variables
Richard M. Stallman <rms@gnu.org>
parents:
5034
diff
changeset
|
74 ;;; |
807
4f28bd14272c
*** empty log message ***
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
777
diff
changeset
|
75 |
4f28bd14272c
*** empty log message ***
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
777
diff
changeset
|
76 ;;; Code: |
4f28bd14272c
*** empty log message ***
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
777
diff
changeset
|
77 |
8500 | 78 ;; Make sure calendar is loaded when we compile this. |
79 (require 'calendar) | |
80 | |
12549 | 81 |
957 | 82 ;;;###autoload |
17624
7634c31da26e
Add defgroup and use defcustom.
Richard M. Stallman <rms@gnu.org>
parents:
15679
diff
changeset
|
83 (defcustom appt-issue-message t |
179 | 84 "*Non-nil means check for appointments in the diary buffer. |
88155 | 85 To be detected, the diary entry must have the format described in the |
86 documentation of the function `appt-check'." | |
17624
7634c31da26e
Add defgroup and use defcustom.
Richard M. Stallman <rms@gnu.org>
parents:
15679
diff
changeset
|
87 :type 'boolean |
7634c31da26e
Add defgroup and use defcustom.
Richard M. Stallman <rms@gnu.org>
parents:
15679
diff
changeset
|
88 :group 'appt) |
179 | 89 |
88155 | 90 (make-obsolete-variable 'appt-issue-message |
91 "use the function `appt-activate', and the \ | |
92 variable `appt-display-format' instead." "22.1") | |
93 | |
957 | 94 ;;;###autoload |
17624
7634c31da26e
Add defgroup and use defcustom.
Richard M. Stallman <rms@gnu.org>
parents:
15679
diff
changeset
|
95 (defcustom appt-message-warning-time 12 |
7634c31da26e
Add defgroup and use defcustom.
Richard M. Stallman <rms@gnu.org>
parents:
15679
diff
changeset
|
96 "*Time in minutes before an appointment that the warning begins." |
7634c31da26e
Add defgroup and use defcustom.
Richard M. Stallman <rms@gnu.org>
parents:
15679
diff
changeset
|
97 :type 'integer |
7634c31da26e
Add defgroup and use defcustom.
Richard M. Stallman <rms@gnu.org>
parents:
15679
diff
changeset
|
98 :group 'appt) |
179 | 99 |
957 | 100 ;;;###autoload |
17624
7634c31da26e
Add defgroup and use defcustom.
Richard M. Stallman <rms@gnu.org>
parents:
15679
diff
changeset
|
101 (defcustom appt-audible t |
7634c31da26e
Add defgroup and use defcustom.
Richard M. Stallman <rms@gnu.org>
parents:
15679
diff
changeset
|
102 "*Non-nil means beep to indicate appointment." |
7634c31da26e
Add defgroup and use defcustom.
Richard M. Stallman <rms@gnu.org>
parents:
15679
diff
changeset
|
103 :type 'boolean |
7634c31da26e
Add defgroup and use defcustom.
Richard M. Stallman <rms@gnu.org>
parents:
15679
diff
changeset
|
104 :group 'appt) |
179 | 105 |
957 | 106 ;;;###autoload |
17624
7634c31da26e
Add defgroup and use defcustom.
Richard M. Stallman <rms@gnu.org>
parents:
15679
diff
changeset
|
107 (defcustom appt-visible t |
88155 | 108 "*Non-nil means display appointment message in echo area. |
109 This variable is only relevant if `appt-msg-window' is nil." | |
110 :type 'boolean | |
111 :group 'appt) | |
112 | |
113 (make-obsolete-variable 'appt-visible 'appt-display-format "22.1") | |
114 | |
115 ;;;###autoload | |
116 (defcustom appt-msg-window t | |
117 "*Non-nil means display appointment message in another window. | |
118 If non-nil, this variable overrides `appt-visible'." | |
17624
7634c31da26e
Add defgroup and use defcustom.
Richard M. Stallman <rms@gnu.org>
parents:
15679
diff
changeset
|
119 :type 'boolean |
7634c31da26e
Add defgroup and use defcustom.
Richard M. Stallman <rms@gnu.org>
parents:
15679
diff
changeset
|
120 :group 'appt) |
179 | 121 |
88155 | 122 (make-obsolete-variable 'appt-msg-window 'appt-display-format "22.1") |
123 | |
124 ;; TODO - add popup. | |
125 (defcustom appt-display-format 'ignore | |
126 "How appointment reminders should be displayed. | |
127 The options are: | |
128 window - use a separate window | |
129 echo - use the echo area | |
130 nil - no visible reminder. | |
131 See also `appt-audible' and `appt-display-mode-line'. | |
132 | |
133 The default value is 'ignore, which means to fall back on the value | |
134 of the (obsolete) variables `appt-msg-window' and `appt-visible'." | |
135 :type '(choice | |
136 (const :tag "Separate window" window) | |
137 (const :tag "Echo-area" echo) | |
138 (const :tag "No visible display" nil)) | |
139 :group 'appt | |
140 :version "22.1") | |
141 | |
957 | 142 ;;;###autoload |
17624
7634c31da26e
Add defgroup and use defcustom.
Richard M. Stallman <rms@gnu.org>
parents:
15679
diff
changeset
|
143 (defcustom appt-display-mode-line t |
88155 | 144 "*Non-nil means display minutes to appointment and time on the mode line. |
145 This is in addition to any other display of appointment messages." | |
17624
7634c31da26e
Add defgroup and use defcustom.
Richard M. Stallman <rms@gnu.org>
parents:
15679
diff
changeset
|
146 :type 'boolean |
7634c31da26e
Add defgroup and use defcustom.
Richard M. Stallman <rms@gnu.org>
parents:
15679
diff
changeset
|
147 :group 'appt) |
179 | 148 |
957 | 149 ;;;###autoload |
17624
7634c31da26e
Add defgroup and use defcustom.
Richard M. Stallman <rms@gnu.org>
parents:
15679
diff
changeset
|
150 (defcustom appt-display-duration 10 |
88155 | 151 "*The number of seconds an appointment message is displayed. |
152 Only relevant if reminders are to be displayed in their own window." | |
17624
7634c31da26e
Add defgroup and use defcustom.
Richard M. Stallman <rms@gnu.org>
parents:
15679
diff
changeset
|
153 :type 'integer |
7634c31da26e
Add defgroup and use defcustom.
Richard M. Stallman <rms@gnu.org>
parents:
15679
diff
changeset
|
154 :group 'appt) |
179 | 155 |
957 | 156 ;;;###autoload |
17624
7634c31da26e
Add defgroup and use defcustom.
Richard M. Stallman <rms@gnu.org>
parents:
15679
diff
changeset
|
157 (defcustom appt-display-diary t |
88155 | 158 "*Non-nil displays the diary when the appointment list is first initialized. |
17624
7634c31da26e
Add defgroup and use defcustom.
Richard M. Stallman <rms@gnu.org>
parents:
15679
diff
changeset
|
159 This will occur at midnight when the appointment list is updated." |
7634c31da26e
Add defgroup and use defcustom.
Richard M. Stallman <rms@gnu.org>
parents:
15679
diff
changeset
|
160 :type 'boolean |
7634c31da26e
Add defgroup and use defcustom.
Richard M. Stallman <rms@gnu.org>
parents:
15679
diff
changeset
|
161 :group 'appt) |
179 | 162 |
17624
7634c31da26e
Add defgroup and use defcustom.
Richard M. Stallman <rms@gnu.org>
parents:
15679
diff
changeset
|
163 (defcustom appt-display-interval 3 |
7634c31da26e
Add defgroup and use defcustom.
Richard M. Stallman <rms@gnu.org>
parents:
15679
diff
changeset
|
164 "*Number of minutes to wait between checking the appointment list." |
7634c31da26e
Add defgroup and use defcustom.
Richard M. Stallman <rms@gnu.org>
parents:
15679
diff
changeset
|
165 :type 'integer |
7634c31da26e
Add defgroup and use defcustom.
Richard M. Stallman <rms@gnu.org>
parents:
15679
diff
changeset
|
166 :group 'appt) |
49598
0d8b17d428b5
Trailing whitepace deleted.
Juanma Barranquero <lekktu@gmail.com>
parents:
46909
diff
changeset
|
167 |
88155 | 168 (defcustom appt-disp-window-function 'appt-disp-window |
169 "Function called to display appointment window. | |
170 Only relevant if reminders are being displayed in a window." | |
171 :type '(choice (const appt-disp-window) | |
172 function) | |
173 :group 'appt) | |
174 | |
175 (defcustom appt-delete-window-function 'appt-delete-window | |
176 "Function called to remove appointment window and buffer. | |
177 Only relevant if reminders are being displayed in a window." | |
178 :type '(choice (const appt-delete-window) | |
179 function) | |
180 :group 'appt) | |
181 | |
182 | |
183 ;;; Internal variables below this point. | |
184 | |
185 (defconst appt-buffer-name " *appt-buf*" | |
5659
32a02ab40d58
(appt-check): Use the new variables
Richard M. Stallman <rms@gnu.org>
parents:
5034
diff
changeset
|
186 "Name of the appointments buffer.") |
49598
0d8b17d428b5
Trailing whitepace deleted.
Juanma Barranquero <lekktu@gmail.com>
parents:
46909
diff
changeset
|
187 |
88155 | 188 (defvar appt-time-msg-list nil |
189 "The list of appointments for today. | |
190 Use `appt-add' and `appt-delete' to add and delete appointments. | |
191 The original list is generated from today's `diary-entries-list', and | |
192 can be regenerated using the function `appt-check'. | |
193 Each element of the generated list has the form (MINUTES STRING [FLAG]); where | |
194 MINUTES is the time in minutes of the appointment after midnight, and | |
195 STRING is the description of the appointment. | |
196 FLAG, if non-nil, says that the element was made with `appt-add' | |
197 so calling `appt-make-list' again should preserve it.") | |
49598
0d8b17d428b5
Trailing whitepace deleted.
Juanma Barranquero <lekktu@gmail.com>
parents:
46909
diff
changeset
|
198 |
88155 | 199 (defconst appt-max-time (1- (* 24 60)) |
200 "11:59pm in minutes - number of minutes in a day minus 1.") | |
5034
c7badee38b64
(appt-display-interval): New variable.
Richard M. Stallman <rms@gnu.org>
parents:
957
diff
changeset
|
201 |
23112
81052242dbce
(appt-mode-string): New variable.
Richard M. Stallman <rms@gnu.org>
parents:
17624
diff
changeset
|
202 (defvar appt-mode-string nil |
23297
e23cdc314c10
(appt-interval): Variable deleted.
Karl Heuer <kwzh@gnu.org>
parents:
23124
diff
changeset
|
203 "String being displayed in the mode line saying you have an appointment. |
88155 | 204 The actual string includes the amount of time till the appointment. |
205 Only used if `appt-display-mode-line' is non-nil.") | |
23297
e23cdc314c10
(appt-interval): Variable deleted.
Karl Heuer <kwzh@gnu.org>
parents:
23124
diff
changeset
|
206 |
e23cdc314c10
(appt-interval): Variable deleted.
Karl Heuer <kwzh@gnu.org>
parents:
23124
diff
changeset
|
207 (defvar appt-prev-comp-time nil |
88155 | 208 "Time of day (mins since midnight) at which we last checked appointments. |
209 A nil value forces the diary file to be (re-)checked for appointments.") | |
23297
e23cdc314c10
(appt-interval): Variable deleted.
Karl Heuer <kwzh@gnu.org>
parents:
23124
diff
changeset
|
210 |
e23cdc314c10
(appt-interval): Variable deleted.
Karl Heuer <kwzh@gnu.org>
parents:
23124
diff
changeset
|
211 (defvar appt-now-displayed nil |
e23cdc314c10
(appt-interval): Variable deleted.
Karl Heuer <kwzh@gnu.org>
parents:
23124
diff
changeset
|
212 "Non-nil when we have started notifying about a appointment that is near.") |
e23cdc314c10
(appt-interval): Variable deleted.
Karl Heuer <kwzh@gnu.org>
parents:
23124
diff
changeset
|
213 |
88155 | 214 (defvar appt-display-count nil |
215 "Internal variable used to count number of consecutive reminders.") | |
216 | |
217 (defvar appt-timer nil | |
218 "Timer used for diary appointment notifications (`appt-check'). | |
219 If this is non-nil, appointment checking is active.") | |
220 | |
221 | |
222 ;;; Functions. | |
23112
81052242dbce
(appt-mode-string): New variable.
Richard M. Stallman <rms@gnu.org>
parents:
17624
diff
changeset
|
223 |
88155 | 224 (defun appt-display-message (string mins) |
225 "Display a reminder about an appointment. | |
226 The string STRING describes the appointment, due in integer MINS minutes. | |
227 The format of the visible reminder is controlled by `appt-display-format'. | |
228 The variable `appt-audible' controls the audible reminder." | |
229 ;; let binding for backwards compatability. Remove when obsolete | |
230 ;; vars appt-msg-window and appt-visible are dropped. | |
231 (let ((appt-display-format | |
232 (if (eq appt-display-format 'ignore) | |
233 (cond (appt-msg-window 'window) | |
234 (appt-visible 'echo)) | |
235 appt-display-format))) | |
236 (cond ((eq appt-display-format 'window) | |
237 (funcall appt-disp-window-function | |
238 (number-to-string mins) | |
239 ;; TODO - use calendar-month-abbrev-array rather | |
240 ;; than %b? | |
241 (format-time-string "%a %b %e " (current-time)) | |
242 string) | |
243 (run-at-time (format "%d sec" appt-display-duration) | |
244 nil | |
245 appt-delete-window-function)) | |
246 ((eq appt-display-format 'echo) | |
247 (message "%s" string))) | |
248 (if appt-audible (beep 1)))) | |
249 | |
250 | |
251 (defun appt-check (&optional force) | |
252 "Check for an appointment and update any reminder display. | |
253 If optional argument FORCE is non-nil, reparse the diary file for | |
254 appointments. Otherwise the diary file is only parsed once per day, | |
255 and when saved. | |
256 | |
179 | 257 Note: the time must be the first thing in the line in the diary |
88155 | 258 for a warning to be issued. The format of the time can be either |
259 24 hour or am/pm. For example: | |
179 | 260 |
88155 | 261 02/23/89 |
262 18:00 Dinner | |
49598
0d8b17d428b5
Trailing whitepace deleted.
Juanma Barranquero <lekktu@gmail.com>
parents:
46909
diff
changeset
|
263 |
179 | 264 Thursday |
265 11:45am Lunch meeting. | |
266 | |
23297
e23cdc314c10
(appt-interval): Variable deleted.
Karl Heuer <kwzh@gnu.org>
parents:
23124
diff
changeset
|
267 Appointments are checked every `appt-display-interval' minutes. |
e23cdc314c10
(appt-interval): Variable deleted.
Karl Heuer <kwzh@gnu.org>
parents:
23124
diff
changeset
|
268 The following variables control appointment notification: |
179 | 269 |
88155 | 270 `appt-display-format' |
271 Controls the format in which reminders are displayed. | |
179 | 272 |
23112
81052242dbce
(appt-mode-string): New variable.
Richard M. Stallman <rms@gnu.org>
parents:
17624
diff
changeset
|
273 `appt-audible' |
88155 | 274 Variable used to determine if reminder is audible. |
5034
c7badee38b64
(appt-display-interval): New variable.
Richard M. Stallman <rms@gnu.org>
parents:
957
diff
changeset
|
275 Default is t. |
179 | 276 |
88155 | 277 `appt-message-warning-time' |
278 Variable used to determine when appointment message | |
279 should first be displayed. | |
280 | |
281 `appt-display-mode-line' | |
282 If non-nil, a generic message giving the time remaining | |
283 is shown in the mode-line when an appointment is due. | |
179 | 284 |
88155 | 285 `appt-display-interval' |
286 Interval in minutes at which to check for pending appointments. | |
287 | |
288 `appt-display-diary' | |
289 Display the diary buffer when the appointment list is | |
290 initialized for the first time in a day. | |
291 | |
292 The following variables are only relevant if reminders are being | |
293 displayed in a window: | |
179 | 294 |
23112
81052242dbce
(appt-mode-string): New variable.
Richard M. Stallman <rms@gnu.org>
parents:
17624
diff
changeset
|
295 `appt-display-duration' |
88155 | 296 The number of seconds an appointment message is displayed. |
5034
c7badee38b64
(appt-display-interval): New variable.
Richard M. Stallman <rms@gnu.org>
parents:
957
diff
changeset
|
297 |
23297
e23cdc314c10
(appt-interval): Variable deleted.
Karl Heuer <kwzh@gnu.org>
parents:
23124
diff
changeset
|
298 `appt-disp-window-function' |
88155 | 299 Function called to display appointment window. |
49598
0d8b17d428b5
Trailing whitepace deleted.
Juanma Barranquero <lekktu@gmail.com>
parents:
46909
diff
changeset
|
300 |
23297
e23cdc314c10
(appt-interval): Variable deleted.
Karl Heuer <kwzh@gnu.org>
parents:
23124
diff
changeset
|
301 `appt-delete-window-function' |
88155 | 302 Function called to remove appointment window and buffer." |
179 | 303 |
23297
e23cdc314c10
(appt-interval): Variable deleted.
Karl Heuer <kwzh@gnu.org>
parents:
23124
diff
changeset
|
304 (let* ((min-to-app -1) |
e23cdc314c10
(appt-interval): Variable deleted.
Karl Heuer <kwzh@gnu.org>
parents:
23124
diff
changeset
|
305 (prev-appt-mode-string appt-mode-string) |
e23cdc314c10
(appt-interval): Variable deleted.
Karl Heuer <kwzh@gnu.org>
parents:
23124
diff
changeset
|
306 (prev-appt-display-count (or appt-display-count 0)) |
e23cdc314c10
(appt-interval): Variable deleted.
Karl Heuer <kwzh@gnu.org>
parents:
23124
diff
changeset
|
307 ;; Non-nil means do a full check for pending appointments |
e23cdc314c10
(appt-interval): Variable deleted.
Karl Heuer <kwzh@gnu.org>
parents:
23124
diff
changeset
|
308 ;; and display in whatever ways the user has selected. |
e23cdc314c10
(appt-interval): Variable deleted.
Karl Heuer <kwzh@gnu.org>
parents:
23124
diff
changeset
|
309 ;; When no appointment is being displayed, |
e23cdc314c10
(appt-interval): Variable deleted.
Karl Heuer <kwzh@gnu.org>
parents:
23124
diff
changeset
|
310 ;; we always do a full check. |
e23cdc314c10
(appt-interval): Variable deleted.
Karl Heuer <kwzh@gnu.org>
parents:
23124
diff
changeset
|
311 (full-check |
e23cdc314c10
(appt-interval): Variable deleted.
Karl Heuer <kwzh@gnu.org>
parents:
23124
diff
changeset
|
312 (or (not appt-now-displayed) |
e23cdc314c10
(appt-interval): Variable deleted.
Karl Heuer <kwzh@gnu.org>
parents:
23124
diff
changeset
|
313 ;; This is true every appt-display-interval minutes. |
88155 | 314 (zerop (mod prev-appt-display-count appt-display-interval)))) |
23297
e23cdc314c10
(appt-interval): Variable deleted.
Karl Heuer <kwzh@gnu.org>
parents:
23124
diff
changeset
|
315 ;; Non-nil means only update the interval displayed in the mode line. |
e23cdc314c10
(appt-interval): Variable deleted.
Karl Heuer <kwzh@gnu.org>
parents:
23124
diff
changeset
|
316 (mode-line-only |
e23cdc314c10
(appt-interval): Variable deleted.
Karl Heuer <kwzh@gnu.org>
parents:
23124
diff
changeset
|
317 (and (not full-check) appt-now-displayed))) |
179 | 318 |
23297
e23cdc314c10
(appt-interval): Variable deleted.
Karl Heuer <kwzh@gnu.org>
parents:
23124
diff
changeset
|
319 (when (or full-check mode-line-only) |
e23cdc314c10
(appt-interval): Variable deleted.
Karl Heuer <kwzh@gnu.org>
parents:
23124
diff
changeset
|
320 (save-excursion |
5034
c7badee38b64
(appt-display-interval): New variable.
Richard M. Stallman <rms@gnu.org>
parents:
957
diff
changeset
|
321 |
23297
e23cdc314c10
(appt-interval): Variable deleted.
Karl Heuer <kwzh@gnu.org>
parents:
23124
diff
changeset
|
322 ;; Get the current time and convert it to minutes |
e23cdc314c10
(appt-interval): Variable deleted.
Karl Heuer <kwzh@gnu.org>
parents:
23124
diff
changeset
|
323 ;; from midnight. ie. 12:01am = 1, midnight = 0. |
5034
c7badee38b64
(appt-display-interval): New variable.
Richard M. Stallman <rms@gnu.org>
parents:
957
diff
changeset
|
324 |
23297
e23cdc314c10
(appt-interval): Variable deleted.
Karl Heuer <kwzh@gnu.org>
parents:
23124
diff
changeset
|
325 (let* ((now (decode-time)) |
e23cdc314c10
(appt-interval): Variable deleted.
Karl Heuer <kwzh@gnu.org>
parents:
23124
diff
changeset
|
326 (cur-hour (nth 2 now)) |
e23cdc314c10
(appt-interval): Variable deleted.
Karl Heuer <kwzh@gnu.org>
parents:
23124
diff
changeset
|
327 (cur-min (nth 1 now)) |
e23cdc314c10
(appt-interval): Variable deleted.
Karl Heuer <kwzh@gnu.org>
parents:
23124
diff
changeset
|
328 (cur-comp-time (+ (* cur-hour 60) cur-min))) |
e23cdc314c10
(appt-interval): Variable deleted.
Karl Heuer <kwzh@gnu.org>
parents:
23124
diff
changeset
|
329 |
49598
0d8b17d428b5
Trailing whitepace deleted.
Juanma Barranquero <lekktu@gmail.com>
parents:
46909
diff
changeset
|
330 ;; At the first check in any given day, update our |
23297
e23cdc314c10
(appt-interval): Variable deleted.
Karl Heuer <kwzh@gnu.org>
parents:
23124
diff
changeset
|
331 ;; appointments to today's list. |
5034
c7badee38b64
(appt-display-interval): New variable.
Richard M. Stallman <rms@gnu.org>
parents:
957
diff
changeset
|
332 |
88155 | 333 (if (or force ; eg initialize, diary save |
334 (null appt-prev-comp-time) ; first check | |
335 (< cur-comp-time appt-prev-comp-time)) ; new day | |
23297
e23cdc314c10
(appt-interval): Variable deleted.
Karl Heuer <kwzh@gnu.org>
parents:
23124
diff
changeset
|
336 (condition-case nil |
88155 | 337 (if appt-display-diary |
338 (let ((diary-hook | |
339 (if (assoc 'appt-make-list diary-hook) | |
340 diary-hook | |
341 (cons 'appt-make-list diary-hook)))) | |
342 (diary)) | |
343 (let* ((diary-display-hook 'appt-make-list) | |
344 (d-buff (find-buffer-visiting | |
345 (substitute-in-file-name diary-file))) | |
346 (selective | |
347 (if d-buff ; Diary buffer exists. | |
348 (with-current-buffer d-buff | |
349 diary-selective-display)))) | |
350 (diary) | |
351 ;; If the diary buffer existed before this command, | |
352 ;; restore its display state. Otherwise, kill it. | |
353 (if d-buff | |
354 ;; Displays the diary buffer. | |
355 (or selective (show-all-diary-entries)) | |
356 (and | |
357 (setq d-buff (find-buffer-visiting | |
358 (substitute-in-file-name diary-file))) | |
359 (kill-buffer d-buff))))) | |
23297
e23cdc314c10
(appt-interval): Variable deleted.
Karl Heuer <kwzh@gnu.org>
parents:
23124
diff
changeset
|
360 (error nil))) |
23124
176e4901705d
(appt-check): Clear appt-mode-string if we don't put something in it.
Karl Heuer <kwzh@gnu.org>
parents:
23123
diff
changeset
|
361 |
88155 | 362 (setq appt-prev-comp-time cur-comp-time |
363 appt-mode-string nil | |
364 appt-display-count nil) | |
23297
e23cdc314c10
(appt-interval): Variable deleted.
Karl Heuer <kwzh@gnu.org>
parents:
23124
diff
changeset
|
365 |
e23cdc314c10
(appt-interval): Variable deleted.
Karl Heuer <kwzh@gnu.org>
parents:
23124
diff
changeset
|
366 ;; If there are entries in the list, and the |
e23cdc314c10
(appt-interval): Variable deleted.
Karl Heuer <kwzh@gnu.org>
parents:
23124
diff
changeset
|
367 ;; user wants a message issued, |
e23cdc314c10
(appt-interval): Variable deleted.
Karl Heuer <kwzh@gnu.org>
parents:
23124
diff
changeset
|
368 ;; get the first time off of the list |
e23cdc314c10
(appt-interval): Variable deleted.
Karl Heuer <kwzh@gnu.org>
parents:
23124
diff
changeset
|
369 ;; and calculate the number of minutes until the appointment. |
5034
c7badee38b64
(appt-display-interval): New variable.
Richard M. Stallman <rms@gnu.org>
parents:
957
diff
changeset
|
370 |
23297
e23cdc314c10
(appt-interval): Variable deleted.
Karl Heuer <kwzh@gnu.org>
parents:
23124
diff
changeset
|
371 (if (and appt-issue-message appt-time-msg-list) |
e23cdc314c10
(appt-interval): Variable deleted.
Karl Heuer <kwzh@gnu.org>
parents:
23124
diff
changeset
|
372 (let ((appt-comp-time (car (car (car appt-time-msg-list))))) |
e23cdc314c10
(appt-interval): Variable deleted.
Karl Heuer <kwzh@gnu.org>
parents:
23124
diff
changeset
|
373 (setq min-to-app (- appt-comp-time cur-comp-time)) |
5034
c7badee38b64
(appt-display-interval): New variable.
Richard M. Stallman <rms@gnu.org>
parents:
957
diff
changeset
|
374 |
49598
0d8b17d428b5
Trailing whitepace deleted.
Juanma Barranquero <lekktu@gmail.com>
parents:
46909
diff
changeset
|
375 (while (and appt-time-msg-list |
23297
e23cdc314c10
(appt-interval): Variable deleted.
Karl Heuer <kwzh@gnu.org>
parents:
23124
diff
changeset
|
376 (< appt-comp-time cur-comp-time)) |
49598
0d8b17d428b5
Trailing whitepace deleted.
Juanma Barranquero <lekktu@gmail.com>
parents:
46909
diff
changeset
|
377 (setq appt-time-msg-list (cdr appt-time-msg-list)) |
23297
e23cdc314c10
(appt-interval): Variable deleted.
Karl Heuer <kwzh@gnu.org>
parents:
23124
diff
changeset
|
378 (if appt-time-msg-list |
49598
0d8b17d428b5
Trailing whitepace deleted.
Juanma Barranquero <lekktu@gmail.com>
parents:
46909
diff
changeset
|
379 (setq appt-comp-time |
23297
e23cdc314c10
(appt-interval): Variable deleted.
Karl Heuer <kwzh@gnu.org>
parents:
23124
diff
changeset
|
380 (car (car (car appt-time-msg-list)))))) |
5034
c7badee38b64
(appt-display-interval): New variable.
Richard M. Stallman <rms@gnu.org>
parents:
957
diff
changeset
|
381 |
23297
e23cdc314c10
(appt-interval): Variable deleted.
Karl Heuer <kwzh@gnu.org>
parents:
23124
diff
changeset
|
382 ;; If we have an appointment between midnight and |
e23cdc314c10
(appt-interval): Variable deleted.
Karl Heuer <kwzh@gnu.org>
parents:
23124
diff
changeset
|
383 ;; 'appt-message-warning-time' minutes after midnight, |
e23cdc314c10
(appt-interval): Variable deleted.
Karl Heuer <kwzh@gnu.org>
parents:
23124
diff
changeset
|
384 ;; we must begin to issue a message before midnight. |
e23cdc314c10
(appt-interval): Variable deleted.
Karl Heuer <kwzh@gnu.org>
parents:
23124
diff
changeset
|
385 ;; Midnight is considered 0 minutes and 11:59pm is |
e23cdc314c10
(appt-interval): Variable deleted.
Karl Heuer <kwzh@gnu.org>
parents:
23124
diff
changeset
|
386 ;; 1439 minutes. Therefore we must recalculate the minutes |
49598
0d8b17d428b5
Trailing whitepace deleted.
Juanma Barranquero <lekktu@gmail.com>
parents:
46909
diff
changeset
|
387 ;; to appointment variable. It is equal to the number of |
0d8b17d428b5
Trailing whitepace deleted.
Juanma Barranquero <lekktu@gmail.com>
parents:
46909
diff
changeset
|
388 ;; minutes before midnight plus the number of |
23297
e23cdc314c10
(appt-interval): Variable deleted.
Karl Heuer <kwzh@gnu.org>
parents:
23124
diff
changeset
|
389 ;; minutes after midnight our appointment is. |
179 | 390 |
23297
e23cdc314c10
(appt-interval): Variable deleted.
Karl Heuer <kwzh@gnu.org>
parents:
23124
diff
changeset
|
391 (if (and (< appt-comp-time appt-message-warning-time) |
e23cdc314c10
(appt-interval): Variable deleted.
Karl Heuer <kwzh@gnu.org>
parents:
23124
diff
changeset
|
392 (> (+ cur-comp-time appt-message-warning-time) |
e23cdc314c10
(appt-interval): Variable deleted.
Karl Heuer <kwzh@gnu.org>
parents:
23124
diff
changeset
|
393 appt-max-time)) |
e23cdc314c10
(appt-interval): Variable deleted.
Karl Heuer <kwzh@gnu.org>
parents:
23124
diff
changeset
|
394 (setq min-to-app (+ (- (1+ appt-max-time) cur-comp-time)) |
e23cdc314c10
(appt-interval): Variable deleted.
Karl Heuer <kwzh@gnu.org>
parents:
23124
diff
changeset
|
395 appt-comp-time)) |
5034
c7badee38b64
(appt-display-interval): New variable.
Richard M. Stallman <rms@gnu.org>
parents:
957
diff
changeset
|
396 |
49598
0d8b17d428b5
Trailing whitepace deleted.
Juanma Barranquero <lekktu@gmail.com>
parents:
46909
diff
changeset
|
397 ;; issue warning if the appointment time is |
23297
e23cdc314c10
(appt-interval): Variable deleted.
Karl Heuer <kwzh@gnu.org>
parents:
23124
diff
changeset
|
398 ;; within appt-message-warning time |
5034
c7badee38b64
(appt-display-interval): New variable.
Richard M. Stallman <rms@gnu.org>
parents:
957
diff
changeset
|
399 |
23297
e23cdc314c10
(appt-interval): Variable deleted.
Karl Heuer <kwzh@gnu.org>
parents:
23124
diff
changeset
|
400 (when (and (<= min-to-app appt-message-warning-time) |
e23cdc314c10
(appt-interval): Variable deleted.
Karl Heuer <kwzh@gnu.org>
parents:
23124
diff
changeset
|
401 (>= min-to-app 0)) |
88155 | 402 (setq appt-now-displayed t |
403 appt-display-count (1+ prev-appt-display-count)) | |
23297
e23cdc314c10
(appt-interval): Variable deleted.
Karl Heuer <kwzh@gnu.org>
parents:
23124
diff
changeset
|
404 (unless mode-line-only |
88155 | 405 (appt-display-message (cadr (car appt-time-msg-list)) |
406 min-to-app)) | |
23297
e23cdc314c10
(appt-interval): Variable deleted.
Karl Heuer <kwzh@gnu.org>
parents:
23124
diff
changeset
|
407 (when appt-display-mode-line |
e23cdc314c10
(appt-interval): Variable deleted.
Karl Heuer <kwzh@gnu.org>
parents:
23124
diff
changeset
|
408 (setq appt-mode-string |
88155 | 409 (format " App't in %s min." min-to-app))) |
5034
c7badee38b64
(appt-display-interval): New variable.
Richard M. Stallman <rms@gnu.org>
parents:
957
diff
changeset
|
410 |
23297
e23cdc314c10
(appt-interval): Variable deleted.
Karl Heuer <kwzh@gnu.org>
parents:
23124
diff
changeset
|
411 ;; When an appointment is reached, |
e23cdc314c10
(appt-interval): Variable deleted.
Karl Heuer <kwzh@gnu.org>
parents:
23124
diff
changeset
|
412 ;; delete it from the list. |
e23cdc314c10
(appt-interval): Variable deleted.
Karl Heuer <kwzh@gnu.org>
parents:
23124
diff
changeset
|
413 ;; Reset the count to 0 in case we display another |
e23cdc314c10
(appt-interval): Variable deleted.
Karl Heuer <kwzh@gnu.org>
parents:
23124
diff
changeset
|
414 ;; appointment on the next cycle. |
88155 | 415 (if (zerop min-to-app) |
416 (setq appt-time-msg-list (cdr appt-time-msg-list) | |
23297
e23cdc314c10
(appt-interval): Variable deleted.
Karl Heuer <kwzh@gnu.org>
parents:
23124
diff
changeset
|
417 appt-display-count nil))))) |
5034
c7badee38b64
(appt-display-interval): New variable.
Richard M. Stallman <rms@gnu.org>
parents:
957
diff
changeset
|
418 |
23297
e23cdc314c10
(appt-interval): Variable deleted.
Karl Heuer <kwzh@gnu.org>
parents:
23124
diff
changeset
|
419 ;; If we have changed the mode line string, |
e23cdc314c10
(appt-interval): Variable deleted.
Karl Heuer <kwzh@gnu.org>
parents:
23124
diff
changeset
|
420 ;; redisplay all mode lines. |
e23cdc314c10
(appt-interval): Variable deleted.
Karl Heuer <kwzh@gnu.org>
parents:
23124
diff
changeset
|
421 (and appt-display-mode-line |
e23cdc314c10
(appt-interval): Variable deleted.
Karl Heuer <kwzh@gnu.org>
parents:
23124
diff
changeset
|
422 (not (equal appt-mode-string |
e23cdc314c10
(appt-interval): Variable deleted.
Karl Heuer <kwzh@gnu.org>
parents:
23124
diff
changeset
|
423 prev-appt-mode-string)) |
e23cdc314c10
(appt-interval): Variable deleted.
Karl Heuer <kwzh@gnu.org>
parents:
23124
diff
changeset
|
424 (progn |
e23cdc314c10
(appt-interval): Variable deleted.
Karl Heuer <kwzh@gnu.org>
parents:
23124
diff
changeset
|
425 (force-mode-line-update t) |
e23cdc314c10
(appt-interval): Variable deleted.
Karl Heuer <kwzh@gnu.org>
parents:
23124
diff
changeset
|
426 ;; If the string now has a notification, |
e23cdc314c10
(appt-interval): Variable deleted.
Karl Heuer <kwzh@gnu.org>
parents:
23124
diff
changeset
|
427 ;; redisplay right now. |
e23cdc314c10
(appt-interval): Variable deleted.
Karl Heuer <kwzh@gnu.org>
parents:
23124
diff
changeset
|
428 (if appt-mode-string |
e23cdc314c10
(appt-interval): Variable deleted.
Karl Heuer <kwzh@gnu.org>
parents:
23124
diff
changeset
|
429 (sit-for 0))))))))) |
179 | 430 |
431 | |
432 (defun appt-disp-window (min-to-app new-time appt-msg) | |
88155 | 433 "Display appointment message APPT-MSG in a separate buffer. |
434 The appointment is due in MIN-TO-APP (a string) minutes. | |
435 NEW-TIME is a string giving the date." | |
179 | 436 (require 'electric) |
437 | |
5659
32a02ab40d58
(appt-check): Use the new variables
Richard M. Stallman <rms@gnu.org>
parents:
5034
diff
changeset
|
438 ;; Make sure we're not in the minibuffer |
32a02ab40d58
(appt-check): Use the new variables
Richard M. Stallman <rms@gnu.org>
parents:
5034
diff
changeset
|
439 ;; before splitting the window. |
179 | 440 |
5659
32a02ab40d58
(appt-check): Use the new variables
Richard M. Stallman <rms@gnu.org>
parents:
5034
diff
changeset
|
441 (if (equal (selected-window) (minibuffer-window)) |
49598
0d8b17d428b5
Trailing whitepace deleted.
Juanma Barranquero <lekktu@gmail.com>
parents:
46909
diff
changeset
|
442 (if (other-window 1) |
5659
32a02ab40d58
(appt-check): Use the new variables
Richard M. Stallman <rms@gnu.org>
parents:
5034
diff
changeset
|
443 (select-window (other-window 1)) |
30538
c44ca494d993
(appt-disp-window): Use display-multi-frame-p
Eli Zaretskii <eliz@gnu.org>
parents:
30001
diff
changeset
|
444 (if (display-multi-frame-p) |
5659
32a02ab40d58
(appt-check): Use the new variables
Richard M. Stallman <rms@gnu.org>
parents:
5034
diff
changeset
|
445 (select-frame (other-frame 1))))) |
49598
0d8b17d428b5
Trailing whitepace deleted.
Juanma Barranquero <lekktu@gmail.com>
parents:
46909
diff
changeset
|
446 |
88155 | 447 (let ((this-window (selected-window)) |
448 (appt-disp-buf (set-buffer (get-buffer-create appt-buffer-name)))) | |
179 | 449 |
9413
e54eede71446
(appt-delete-window): Look on all frames for the window.
Richard M. Stallman <rms@gnu.org>
parents:
8500
diff
changeset
|
450 (if (cdr (assq 'unsplittable (frame-parameters))) |
e54eede71446
(appt-delete-window): Look on all frames for the window.
Richard M. Stallman <rms@gnu.org>
parents:
8500
diff
changeset
|
451 ;; In an unsplittable frame, use something somewhere else. |
e54eede71446
(appt-delete-window): Look on all frames for the window.
Richard M. Stallman <rms@gnu.org>
parents:
8500
diff
changeset
|
452 (display-buffer appt-disp-buf) |
23777
5d10105c2906
(appt-disp-window): Use pop-to-buffer,
Richard M. Stallman <rms@gnu.org>
parents:
23297
diff
changeset
|
453 (unless (or (special-display-p (buffer-name appt-disp-buf)) |
5d10105c2906
(appt-disp-window): Use pop-to-buffer,
Richard M. Stallman <rms@gnu.org>
parents:
23297
diff
changeset
|
454 (same-window-p (buffer-name appt-disp-buf))) |
5d10105c2906
(appt-disp-window): Use pop-to-buffer,
Richard M. Stallman <rms@gnu.org>
parents:
23297
diff
changeset
|
455 ;; By default, split the bottom window and use the lower part. |
5d10105c2906
(appt-disp-window): Use pop-to-buffer,
Richard M. Stallman <rms@gnu.org>
parents:
23297
diff
changeset
|
456 (appt-select-lowest-window) |
88155 | 457 (select-window (split-window))) |
458 (switch-to-buffer appt-disp-buf)) | |
459 (calendar-set-mode-line | |
460 (format " Appointment in %s minutes. %s " min-to-app new-time)) | |
23112
81052242dbce
(appt-mode-string): New variable.
Richard M. Stallman <rms@gnu.org>
parents:
17624
diff
changeset
|
461 (erase-buffer) |
41565
6ecdf9c3fd25
(appt-disp-window): Use insert instead of insert-string.
Pavel Janík <Pavel@Janik.cz>
parents:
38412
diff
changeset
|
462 (insert appt-msg) |
9413
e54eede71446
(appt-delete-window): Look on all frames for the window.
Richard M. Stallman <rms@gnu.org>
parents:
8500
diff
changeset
|
463 (shrink-window-if-larger-than-buffer (get-buffer-window appt-disp-buf t)) |
5659
32a02ab40d58
(appt-check): Use the new variables
Richard M. Stallman <rms@gnu.org>
parents:
5034
diff
changeset
|
464 (set-buffer-modified-p nil) |
13125
731ef06c5677
(appt-disp-window): Call raise-frame.
Richard M. Stallman <rms@gnu.org>
parents:
12549
diff
changeset
|
465 (raise-frame (selected-frame)) |
88155 | 466 (select-window this-window))) |
49598
0d8b17d428b5
Trailing whitepace deleted.
Juanma Barranquero <lekktu@gmail.com>
parents:
46909
diff
changeset
|
467 |
5659
32a02ab40d58
(appt-check): Use the new variables
Richard M. Stallman <rms@gnu.org>
parents:
5034
diff
changeset
|
468 (defun appt-delete-window () |
32a02ab40d58
(appt-check): Use the new variables
Richard M. Stallman <rms@gnu.org>
parents:
5034
diff
changeset
|
469 "Function called to undisplay appointment messages. |
32a02ab40d58
(appt-check): Use the new variables
Richard M. Stallman <rms@gnu.org>
parents:
5034
diff
changeset
|
470 Usually just deletes the appointment buffer." |
9551
ac21ac5e8c69
(appt-select-lowest-window): Locally bind lowest-window.
Richard M. Stallman <rms@gnu.org>
parents:
9413
diff
changeset
|
471 (let ((window (get-buffer-window appt-buffer-name t))) |
ac21ac5e8c69
(appt-select-lowest-window): Locally bind lowest-window.
Richard M. Stallman <rms@gnu.org>
parents:
9413
diff
changeset
|
472 (and window |
28404 | 473 (or (eq window (frame-root-window (window-frame window))) |
9551
ac21ac5e8c69
(appt-select-lowest-window): Locally bind lowest-window.
Richard M. Stallman <rms@gnu.org>
parents:
9413
diff
changeset
|
474 (delete-window window)))) |
5659
32a02ab40d58
(appt-check): Use the new variables
Richard M. Stallman <rms@gnu.org>
parents:
5034
diff
changeset
|
475 (kill-buffer appt-buffer-name) |
32a02ab40d58
(appt-check): Use the new variables
Richard M. Stallman <rms@gnu.org>
parents:
5034
diff
changeset
|
476 (if appt-audible |
32a02ab40d58
(appt-check): Use the new variables
Richard M. Stallman <rms@gnu.org>
parents:
5034
diff
changeset
|
477 (beep 1))) |
179 | 478 |
479 (defun appt-select-lowest-window () | |
28404 | 480 "Select the lowest window on the frame." |
30001
55656f797f82
(appt-select-lowest-window): Use walk-windows
Gerd Moellmann <gerd@gnu.org>
parents:
28968
diff
changeset
|
481 (let ((lowest-window (selected-window)) |
55656f797f82
(appt-select-lowest-window): Use walk-windows
Gerd Moellmann <gerd@gnu.org>
parents:
28968
diff
changeset
|
482 (bottom-edge (nth 3 (window-edges)))) |
55656f797f82
(appt-select-lowest-window): Use walk-windows
Gerd Moellmann <gerd@gnu.org>
parents:
28968
diff
changeset
|
483 (walk-windows (lambda (w) |
55656f797f82
(appt-select-lowest-window): Use walk-windows
Gerd Moellmann <gerd@gnu.org>
parents:
28968
diff
changeset
|
484 (let ((next-bottom-edge (nth 3 (window-edges w)))) |
55656f797f82
(appt-select-lowest-window): Use walk-windows
Gerd Moellmann <gerd@gnu.org>
parents:
28968
diff
changeset
|
485 (when (< bottom-edge next-bottom-edge) |
55656f797f82
(appt-select-lowest-window): Use walk-windows
Gerd Moellmann <gerd@gnu.org>
parents:
28968
diff
changeset
|
486 (setq bottom-edge next-bottom-edge |
55656f797f82
(appt-select-lowest-window): Use walk-windows
Gerd Moellmann <gerd@gnu.org>
parents:
28968
diff
changeset
|
487 lowest-window w))))) |
55656f797f82
(appt-select-lowest-window): Use walk-windows
Gerd Moellmann <gerd@gnu.org>
parents:
28968
diff
changeset
|
488 (select-window lowest-window))) |
179 | 489 |
88155 | 490 (defconst appt-time-regexp |
491 "[0-9]?[0-9]\\(h\\([0-9][0-9]\\)?\\|[:.][0-9][0-9]\\)\\(am\\|pm\\)?") | |
492 | |
23297
e23cdc314c10
(appt-interval): Variable deleted.
Karl Heuer <kwzh@gnu.org>
parents:
23124
diff
changeset
|
493 ;;;###autoload |
179 | 494 (defun appt-add (new-appt-time new-appt-msg) |
88155 | 495 "Add an appointment for today at NEW-APPT-TIME with message NEW-APPT-MSG. |
179 | 496 The time should be in either 24 hour format or am/pm format." |
497 (interactive "sTime (hh:mm[am/pm]): \nsMessage: ") | |
88155 | 498 (unless (string-match appt-time-regexp new-appt-time) |
179 | 499 (error "Unacceptable time-string")) |
500 (let* ((appt-time-string (concat new-appt-time " " new-appt-msg)) | |
501 (appt-time (list (appt-convert-time new-appt-time))) | |
88155 | 502 (time-msg (list appt-time appt-time-string t))) |
28404 | 503 (setq appt-time-msg-list (nconc appt-time-msg-list (list time-msg))) |
49598
0d8b17d428b5
Trailing whitepace deleted.
Juanma Barranquero <lekktu@gmail.com>
parents:
46909
diff
changeset
|
504 (setq appt-time-msg-list (appt-sort-list appt-time-msg-list)))) |
179 | 505 |
23297
e23cdc314c10
(appt-interval): Variable deleted.
Karl Heuer <kwzh@gnu.org>
parents:
23124
diff
changeset
|
506 ;;;###autoload |
179 | 507 (defun appt-delete () |
508 "Delete an appointment from the list of appointments." | |
509 (interactive) | |
88155 | 510 (let ((tmp-msg-list appt-time-msg-list)) |
179 | 511 (while tmp-msg-list |
512 (let* ((element (car tmp-msg-list)) | |
49598
0d8b17d428b5
Trailing whitepace deleted.
Juanma Barranquero <lekktu@gmail.com>
parents:
46909
diff
changeset
|
513 (prompt-string (concat "Delete " |
46909
eb47511f3556
(appt-delete): Use substring-no-properties.
Richard M. Stallman <rms@gnu.org>
parents:
46861
diff
changeset
|
514 ;; We want to quote any doublequotes |
eb47511f3556
(appt-delete): Use substring-no-properties.
Richard M. Stallman <rms@gnu.org>
parents:
46861
diff
changeset
|
515 ;; in the string, as well as put |
eb47511f3556
(appt-delete): Use substring-no-properties.
Richard M. Stallman <rms@gnu.org>
parents:
46861
diff
changeset
|
516 ;; doublequotes around it. |
eb47511f3556
(appt-delete): Use substring-no-properties.
Richard M. Stallman <rms@gnu.org>
parents:
46861
diff
changeset
|
517 (prin1-to-string |
eb47511f3556
(appt-delete): Use substring-no-properties.
Richard M. Stallman <rms@gnu.org>
parents:
46861
diff
changeset
|
518 (substring-no-properties |
49598
0d8b17d428b5
Trailing whitepace deleted.
Juanma Barranquero <lekktu@gmail.com>
parents:
46909
diff
changeset
|
519 (car (cdr element)) 0)) |
179 | 520 " from list? ")) |
521 (test-input (y-or-n-p prompt-string))) | |
522 (setq tmp-msg-list (cdr tmp-msg-list)) | |
523 (if test-input | |
9551
ac21ac5e8c69
(appt-select-lowest-window): Locally bind lowest-window.
Richard M. Stallman <rms@gnu.org>
parents:
9413
diff
changeset
|
524 (setq appt-time-msg-list (delq element appt-time-msg-list))))) |
26677
b6b1fe18ecf5
(appt-convert-time): Handle "12:MMam",
Gerd Moellmann <gerd@gnu.org>
parents:
24493
diff
changeset
|
525 (appt-check) |
179 | 526 (message ""))) |
49598
0d8b17d428b5
Trailing whitepace deleted.
Juanma Barranquero <lekktu@gmail.com>
parents:
46909
diff
changeset
|
527 |
179 | 528 |
26935
9e0b4a6b5ad2
Bind free variables when compiling.
Dave Love <fx@gnu.org>
parents:
26677
diff
changeset
|
529 (eval-when-compile (defvar number) |
9e0b4a6b5ad2
Bind free variables when compiling.
Dave Love <fx@gnu.org>
parents:
26677
diff
changeset
|
530 (defvar original-date) |
9e0b4a6b5ad2
Bind free variables when compiling.
Dave Love <fx@gnu.org>
parents:
26677
diff
changeset
|
531 (defvar diary-entries-list)) |
927 | 532 ;;;###autoload |
179 | 533 (defun appt-make-list () |
88155 | 534 "Update the appointments list from today's diary buffer. |
28404 | 535 The time must be at the beginning of a line for it to be |
88155 | 536 put in the appointments list (see examples in documentation of |
537 the function `appt-check'). We assume that the variables DATE and | |
538 NUMBER hold the arguments that `list-diary-entries' received. | |
539 They specify the range of dates that the diary is being processed for. | |
540 | |
541 Any appointments made with `appt-add' are not affected by this | |
542 function. | |
28404 | 543 |
88155 | 544 For backwards compatibility, this function activates the |
545 appointment package (if it is not already active)." | |
546 ;; See comments above appt-activate defun. | |
547 (if (not appt-timer) | |
548 (appt-activate 1) | |
549 ;; We have something to do if the range of dates that the diary is | |
550 ;; considering includes the current date. | |
551 (if (and (not (calendar-date-compare | |
552 (list (calendar-current-date)) | |
553 (list original-date))) | |
554 (calendar-date-compare | |
555 (list (calendar-current-date)) | |
556 (list (calendar-gregorian-from-absolute | |
557 (+ (calendar-absolute-from-gregorian original-date) | |
558 number))))) | |
559 (save-excursion | |
560 ;; Clear the appointments list, then fill it in from the diary. | |
561 (dolist (elt appt-time-msg-list) | |
562 ;; Delete any entries that were not made with appt-add. | |
563 (unless (nth 2 elt) | |
564 (setq appt-time-msg-list | |
565 (delq elt appt-time-msg-list)))) | |
566 (if diary-entries-list | |
179 | 567 |
88155 | 568 ;; Cycle through the entry-list (diary-entries-list) |
569 ;; looking for entries beginning with a time. If | |
570 ;; the entry begins with a time, add it to the | |
571 ;; appt-time-msg-list. Then sort the list. | |
8440
863e05092c58
(appt-make-list): Do nothing unless range being processed
Richard M. Stallman <rms@gnu.org>
parents:
7298
diff
changeset
|
572 |
88155 | 573 (let ((entry-list diary-entries-list) |
574 (new-time-string "")) | |
575 ;; Skip diary entries for dates before today. | |
576 (while (and entry-list | |
577 (calendar-date-compare | |
578 (car entry-list) (list (calendar-current-date)))) | |
579 (setq entry-list (cdr entry-list))) | |
580 ;; Parse the entries for today. | |
581 (while (and entry-list | |
582 (calendar-date-equal | |
583 (calendar-current-date) (car (car entry-list)))) | |
584 (let ((time-string (cadr (car entry-list)))) | |
585 (while (string-match appt-time-regexp time-string) | |
586 (let* ((beg (match-beginning 0)) | |
587 ;; Get just the time for this appointment. | |
588 (only-time (match-string 0 time-string)) | |
589 ;; Find the end of this appointment | |
590 ;; (the start of the next). | |
591 (end (string-match | |
592 (concat "\n[ \t]*" appt-time-regexp) | |
593 time-string | |
594 (match-end 0))) | |
595 ;; Get the whole string for this appointment. | |
596 (appt-time-string | |
597 (substring time-string beg (if end (1- end))))) | |
8440
863e05092c58
(appt-make-list): Do nothing unless range being processed
Richard M. Stallman <rms@gnu.org>
parents:
7298
diff
changeset
|
598 |
88155 | 599 ;; Add this appointment to appt-time-msg-list. |
600 (let* ((appt-time (list (appt-convert-time only-time))) | |
601 (time-msg (list appt-time appt-time-string))) | |
602 (setq appt-time-msg-list | |
603 (nconc appt-time-msg-list (list time-msg)))) | |
179 | 604 |
88155 | 605 ;; Discard this appointment from the string. |
606 (setq time-string | |
607 (if end (substring time-string end) ""))))) | |
608 (setq entry-list (cdr entry-list))))) | |
609 (setq appt-time-msg-list (appt-sort-list appt-time-msg-list)) | |
179 | 610 |
88155 | 611 ;; Get the current time and convert it to minutes |
612 ;; from midnight. ie. 12:01am = 1, midnight = 0, | |
613 ;; so that the elements in the list | |
614 ;; that are earlier than the present time can | |
615 ;; be removed. | |
8440
863e05092c58
(appt-make-list): Do nothing unless range being processed
Richard M. Stallman <rms@gnu.org>
parents:
7298
diff
changeset
|
616 |
88155 | 617 (let* ((now (decode-time)) |
618 (cur-hour (nth 2 now)) | |
619 (cur-min (nth 1 now)) | |
620 (cur-comp-time (+ (* cur-hour 60) cur-min)) | |
621 (appt-comp-time (car (caar appt-time-msg-list)))) | |
8440
863e05092c58
(appt-make-list): Do nothing unless range being processed
Richard M. Stallman <rms@gnu.org>
parents:
7298
diff
changeset
|
622 |
88155 | 623 (while (and appt-time-msg-list (< appt-comp-time cur-comp-time)) |
624 (setq appt-time-msg-list (cdr appt-time-msg-list)) | |
625 (if appt-time-msg-list | |
626 (setq appt-comp-time (car (caar appt-time-msg-list)))))))))) | |
49598
0d8b17d428b5
Trailing whitepace deleted.
Juanma Barranquero <lekktu@gmail.com>
parents:
46909
diff
changeset
|
627 |
179 | 628 |
629 (defun appt-sort-list (appt-list) | |
88155 | 630 "Sort an appointment list, putting earlier items at the front. |
631 APPT-LIST is a list of the same format as `appt-time-msg-list'." | |
632 (sort appt-list (lambda (e1 e2) (< (caar e1) (caar e2))))) | |
179 | 633 |
634 | |
635 (defun appt-convert-time (time2conv) | |
88155 | 636 "Convert hour:min[am/pm] format to minutes from midnight. |
637 A period (.) can be used instead of a colon (:) to separate the | |
638 hour and minute parts." | |
639 ;; Formats that should be accepted: | |
640 ;; 10:00 10.00 10h00 10h 10am 10:00am 10.00am | |
641 (let ((min (if (string-match "[h:.]\\([0-9][0-9]\\)" time2conv) | |
642 (string-to-number (match-string 1 time2conv)) | |
643 0)) | |
644 (hr (if (string-match "[0-9]*[0-9]" time2conv) | |
645 (string-to-number (match-string 0 time2conv)) | |
646 0))) | |
49598
0d8b17d428b5
Trailing whitepace deleted.
Juanma Barranquero <lekktu@gmail.com>
parents:
46909
diff
changeset
|
647 |
179 | 648 ;; convert the time appointment time into 24 hour time |
26677
b6b1fe18ecf5
(appt-convert-time): Handle "12:MMam",
Gerd Moellmann <gerd@gnu.org>
parents:
24493
diff
changeset
|
649 (cond ((and (string-match "pm" time2conv) (< hr 12)) |
b6b1fe18ecf5
(appt-convert-time): Handle "12:MMam",
Gerd Moellmann <gerd@gnu.org>
parents:
24493
diff
changeset
|
650 (setq hr (+ 12 hr))) |
b6b1fe18ecf5
(appt-convert-time): Handle "12:MMam",
Gerd Moellmann <gerd@gnu.org>
parents:
24493
diff
changeset
|
651 ((and (string-match "am" time2conv) (= hr 12)) |
b6b1fe18ecf5
(appt-convert-time): Handle "12:MMam",
Gerd Moellmann <gerd@gnu.org>
parents:
24493
diff
changeset
|
652 (setq hr 0))) |
49598
0d8b17d428b5
Trailing whitepace deleted.
Juanma Barranquero <lekktu@gmail.com>
parents:
46909
diff
changeset
|
653 |
88155 | 654 ;; convert the actual time into minutes. |
655 (+ (* hr 60) min))) | |
656 | |
49598
0d8b17d428b5
Trailing whitepace deleted.
Juanma Barranquero <lekktu@gmail.com>
parents:
46909
diff
changeset
|
657 |
88155 | 658 (defun appt-update-list () |
659 "If the current buffer is visiting the diary, update appointments. | |
660 This function is intended for use with `write-file-functions'." | |
661 (and (string-equal buffer-file-name (expand-file-name diary-file)) | |
662 appt-timer | |
663 (let ((appt-display-diary nil)) | |
664 (appt-check t))) | |
665 nil) | |
179 | 666 |
23112
81052242dbce
(appt-mode-string): New variable.
Richard M. Stallman <rms@gnu.org>
parents:
17624
diff
changeset
|
667 |
88155 | 668 ;; In Emacs-21.3, the manual documented the following procedure to |
669 ;; activate this package: | |
670 ;; (display-time) | |
671 ;; (add-hook 'diary-hook 'appt-make-list) | |
672 ;; (diary 0) | |
673 ;; The display-time call was not necessary, AFAICS. | |
674 ;; What was really needed was to add the hook and load this file. | |
675 ;; Calling (diary 0) once the hook had been added was in some sense a | |
676 ;; roundabout way of loading this file. This file used to have code at | |
677 ;; the top-level that set up the appt-timer and global-mode-string. | |
678 ;; One way to maintain backwards compatibility would be to call | |
679 ;; (appt-activate 1) at top-level. However, this goes against the | |
680 ;; convention that just loading an Emacs package should not activate | |
681 ;; it. Instead, we make appt-make-list activate the package (after a | |
682 ;; suggestion from rms). This means that one has to call diary in | |
683 ;; order to get it to work, but that is in line with the old (weird, | |
684 ;; IMO) documented behavior for activating the package. | |
685 ;; Actually, since (diary 0) does not run diary-hook, I don't think | |
686 ;; the documented behavior in Emacs-21.3 would ever have worked. | |
687 ;; Oh well, at least with the changes to appt-make-list it will now | |
688 ;; work as well as it ever did. | |
689 ;; The new method is just to use (appt-activate 1). | |
690 ;; -- gmorris | |
23112
81052242dbce
(appt-mode-string): New variable.
Richard M. Stallman <rms@gnu.org>
parents:
17624
diff
changeset
|
691 |
88155 | 692 ;;;###autoload |
693 (defun appt-activate (&optional arg) | |
694 "Toggle checking of appointments. | |
695 With optional numeric argument ARG, turn appointment checking on if | |
696 ARG is positive, otherwise off." | |
697 (interactive "P") | |
698 (let ((appt-active appt-timer)) | |
699 (setq appt-active (if arg (> (prefix-numeric-value arg) 0) | |
700 (not appt-active))) | |
701 (remove-hook 'write-file-functions 'appt-update-list) | |
702 (or global-mode-string (setq global-mode-string '(""))) | |
703 (delq 'appt-mode-string global-mode-string) | |
704 (when appt-timer | |
705 (cancel-timer appt-timer) | |
706 (setq appt-timer nil)) | |
707 (when appt-active | |
708 (add-hook 'write-file-functions 'appt-update-list) | |
709 (setq appt-timer (run-at-time t 60 'appt-check) | |
710 global-mode-string | |
711 (append global-mode-string '(appt-mode-string))) | |
712 (appt-check t)))) | |
179 | 713 |
88155 | 714 |
715 (provide 'appt) | |
716 | |
717 ;; arch-tag: bf5791c4-8921-499e-a26f-772b1788d347 | |
662
8a533acedb77
*** empty log message ***
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
179
diff
changeset
|
718 ;;; appt.el ends here |