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