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