Commit | Line | Data |
---|---|---|
20908596 CD |
1 | ;;; org-clock.el --- The time clocking code for Org-mode |
2 | ||
ba318903 | 3 | ;; Copyright (C) 2004-2014 Free Software Foundation, Inc. |
20908596 CD |
4 | |
5 | ;; Author: Carsten Dominik <carsten at orgmode dot org> | |
6 | ;; Keywords: outlines, hypermedia, calendar, wp | |
7 | ;; Homepage: http://orgmode.org | |
20908596 CD |
8 | ;; |
9 | ;; This file is part of GNU Emacs. | |
10 | ;; | |
b1fc2b50 | 11 | ;; GNU Emacs is free software: you can redistribute it and/or modify |
20908596 | 12 | ;; it under the terms of the GNU General Public License as published by |
b1fc2b50 GM |
13 | ;; the Free Software Foundation, either version 3 of the License, or |
14 | ;; (at your option) any later version. | |
20908596 CD |
15 | |
16 | ;; GNU Emacs is distributed in the hope that it will be useful, | |
17 | ;; but WITHOUT ANY WARRANTY; without even the implied warranty of | |
18 | ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | |
19 | ;; GNU General Public License for more details. | |
20 | ||
21 | ;; You should have received a copy of the GNU General Public License | |
b1fc2b50 | 22 | ;; along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>. |
20908596 CD |
23 | ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;; |
24 | ;; | |
25 | ;;; Commentary: | |
26 | ||
27 | ;; This file contains the time clocking code for Org-mode | |
28 | ||
86fbb8ca CD |
29 | ;;; Code: |
30 | ||
20908596 | 31 | (eval-when-compile |
86fbb8ca | 32 | (require 'cl)) |
271672fa | 33 | (require 'org) |
20908596 | 34 | |
acedf35c | 35 | (declare-function calendar-absolute-from-iso "cal-iso" (&optional date)) |
afe98dfa | 36 | (declare-function notifications-notify "notifications" (&rest params)) |
e66ba1df | 37 | (declare-function org-pop-to-buffer-same-window "org-compat" (&optional buffer-or-name norecord label)) |
c7cf0ebc | 38 | (declare-function org-refresh-properties "org" (dprop tprop)) |
93b62de8 | 39 | (defvar org-time-stamp-formats) |
3ab2c837 | 40 | (defvar org-ts-what) |
8223b1d2 | 41 | (defvar org-frame-title-format-backup frame-title-format) |
20908596 CD |
42 | |
43 | (defgroup org-clock nil | |
44 | "Options concerning clocking working time in Org-mode." | |
45 | :tag "Org Clock" | |
46 | :group 'org-progress) | |
47 | ||
c8d0cf5c | 48 | (defcustom org-clock-into-drawer org-log-into-drawer |
20908596 | 49 | "Should clocking info be wrapped into a drawer? |
c8d0cf5c | 50 | When t, clocking info will always be inserted into a :LOGBOOK: drawer. |
20908596 CD |
51 | If necessary, the drawer will be created. |
52 | When nil, the drawer will not be created, but used when present. | |
53 | When an integer and the number of clocking entries in an item | |
c8d0cf5c CD |
54 | reaches or exceeds this number, a drawer will be created. |
55 | When a string, it names the drawer to be used. | |
56 | ||
57 | The default for this variable is the value of `org-log-into-drawer', | |
58 | which see." | |
20908596 CD |
59 | :group 'org-todo |
60 | :group 'org-clock | |
61 | :type '(choice | |
62 | (const :tag "Always" t) | |
63 | (const :tag "Only when drawer exists" nil) | |
c8d0cf5c CD |
64 | (integer :tag "When at least N clock entries") |
65 | (const :tag "Into LOGBOOK drawer" "LOGBOOK") | |
66 | (string :tag "Into Drawer named..."))) | |
20908596 | 67 | |
3ab2c837 BG |
68 | (defun org-clock-into-drawer () |
69 | "Return the value of `org-clock-into-drawer', but let properties overrule. | |
70 | If the current entry has or inherits a CLOCK_INTO_DRAWER | |
71 | property, it will be used instead of the default value; otherwise | |
72 | if the current entry has or inherits a LOG_INTO_DRAWER property, | |
73 | it will be used instead of the default value. | |
74 | The default is the value of the customizable variable `org-clock-into-drawer', | |
75 | which see." | |
76 | (let ((p (org-entry-get nil "CLOCK_INTO_DRAWER" 'inherit)) | |
77 | (q (org-entry-get nil "LOG_INTO_DRAWER" 'inherit))) | |
78 | (cond | |
79 | ((or (not (or p q)) (equal p "nil") (equal q "nil")) org-clock-into-drawer) | |
80 | ((or (equal p "t") (equal q "t")) "LOGBOOK") | |
81 | ((not p) q) | |
82 | (t p)))) | |
83 | ||
20908596 | 84 | (defcustom org-clock-out-when-done t |
c8d0cf5c | 85 | "When non-nil, clock will be stopped when the clocked entry is marked DONE. |
ed21c5c8 CD |
86 | DONE here means any DONE-like state. |
87 | A nil value means clock will keep running until stopped explicitly with | |
88 | `C-c C-x C-o', or until the clock is started in a different item. | |
89 | Instead of t, this can also be a list of TODO states that should trigger | |
90 | clocking out." | |
20908596 | 91 | :group 'org-clock |
ed21c5c8 CD |
92 | :type '(choice |
93 | (const :tag "No" nil) | |
94 | (const :tag "Yes, when done" t) | |
95 | (repeat :tag "State list" | |
96 | (string :tag "TODO keyword")))) | |
20908596 | 97 | |
271672fa BG |
98 | (defcustom org-clock-rounding-minutes 0 |
99 | "Rounding minutes when clocking in or out. | |
100 | The default value is 0 so that no rounding is done. | |
101 | When set to a non-integer value, use the car of | |
102 | `org-time-stamp-rounding-minutes', like for setting a time-stamp. | |
103 | ||
104 | E.g. if `org-clock-rounding-minutes' is set to 5, time is 14:47 | |
105 | and you clock in: then the clock starts at 14:45. If you clock | |
106 | out within the next 5 minutes, the clock line will be removed; | |
107 | if you clock out 8 minutes after your clocked in, the clock | |
108 | out time will be 14:50." | |
109 | :group 'org-clock | |
110 | :version "24.4" | |
111 | :package-version '(Org . "8.0") | |
112 | :type '(choice | |
113 | (integer :tag "Minutes (0 for no rounding)") | |
114 | (symbol :tag "Use `org-time-stamp-rounding-minutes'" 'same-as-time-stamp))) | |
115 | ||
20908596 | 116 | (defcustom org-clock-out-remove-zero-time-clocks nil |
ed21c5c8 | 117 | "Non-nil means remove the clock line when the resulting time is zero." |
20908596 CD |
118 | :group 'org-clock |
119 | :type 'boolean) | |
120 | ||
121 | (defcustom org-clock-in-switch-to-state nil | |
122 | "Set task to a special todo state while clocking it. | |
71d35b24 | 123 | The value should be the state to which the entry should be |
86fbb8ca | 124 | switched. If the value is a function, it must take one |
71d35b24 CD |
125 | parameter (the current TODO state of the item) and return the |
126 | state to switch it to." | |
20908596 CD |
127 | :group 'org-clock |
128 | :group 'org-todo | |
129 | :type '(choice | |
130 | (const :tag "Don't force a state" nil) | |
71d35b24 CD |
131 | (string :tag "State") |
132 | (symbol :tag "Function"))) | |
20908596 | 133 | |
c8d0cf5c CD |
134 | (defcustom org-clock-out-switch-to-state nil |
135 | "Set task to a special todo state after clocking out. | |
136 | The value should be the state to which the entry should be | |
86fbb8ca | 137 | switched. If the value is a function, it must take one |
c8d0cf5c CD |
138 | parameter (the current TODO state of the item) and return the |
139 | state to switch it to." | |
140 | :group 'org-clock | |
141 | :group 'org-todo | |
142 | :type '(choice | |
143 | (const :tag "Don't force a state" nil) | |
144 | (string :tag "State") | |
145 | (symbol :tag "Function"))) | |
146 | ||
20908596 CD |
147 | (defcustom org-clock-history-length 5 |
148 | "Number of clock tasks to remember in history." | |
149 | :group 'org-clock | |
150 | :type 'integer) | |
151 | ||
c8d0cf5c | 152 | (defcustom org-clock-goto-may-find-recent-task t |
ed21c5c8 | 153 | "Non-nil means `org-clock-goto' can go to recent task if no active clock." |
c8d0cf5c CD |
154 | :group 'org-clock |
155 | :type 'boolean) | |
156 | ||
20908596 CD |
157 | (defcustom org-clock-heading-function nil |
158 | "When non-nil, should be a function to create `org-clock-heading'. | |
159 | This is the string shown in the mode line when a clock is running. | |
160 | The function is called with point at the beginning of the headline." | |
161 | :group 'org-clock | |
271672fa | 162 | :type '(choice (const nil) (function))) |
20908596 | 163 | |
621f83e4 | 164 | (defcustom org-clock-string-limit 0 |
37269466 | 165 | "Maximum length of clock strings in the mode line. 0 means no limit." |
621f83e4 CD |
166 | :group 'org-clock |
167 | :type 'integer) | |
20908596 | 168 | |
93b62de8 | 169 | (defcustom org-clock-in-resume nil |
c8d0cf5c CD |
170 | "If non-nil, resume clock when clocking into task with open clock. |
171 | When clocking into a task with a clock entry which has not been closed, | |
172 | the clock can be resumed from that point." | |
93b62de8 CD |
173 | :group 'org-clock |
174 | :type 'boolean) | |
175 | ||
176 | (defcustom org-clock-persist nil | |
86fbb8ca CD |
177 | "When non-nil, save the running clock when Emacs is closed. |
178 | The clock is resumed when Emacs restarts. | |
ce4fdcb9 CD |
179 | When this is t, both the running clock, and the entire clock |
180 | history are saved. When this is the symbol `clock', only the | |
c7cf0ebc BG |
181 | running clock is saved. When this is the symbol `history', only |
182 | the clock history is saved. | |
ce4fdcb9 | 183 | |
c7cf0ebc BG |
184 | When Emacs restarts with saved clock information, the file containing |
185 | the running clock as well as all files mentioned in the clock history | |
186 | will be visited. | |
187 | ||
188 | All this depends on running `org-clock-persistence-insinuate' in your | |
189 | Emacs initialization file." | |
93b62de8 | 190 | :group 'org-clock |
ce4fdcb9 CD |
191 | :type '(choice |
192 | (const :tag "Just the running clock" clock) | |
8bfe682a | 193 | (const :tag "Just the history" history) |
ce4fdcb9 CD |
194 | (const :tag "Clock and history" t) |
195 | (const :tag "No persistence" nil))) | |
93b62de8 | 196 | |
db55f368 | 197 | (defcustom org-clock-persist-file (convert-standard-filename |
271672fa | 198 | (concat user-emacs-directory "org-clock-save.el")) |
c8d0cf5c | 199 | "File to save clock data to." |
93b62de8 CD |
200 | :group 'org-clock |
201 | :type 'string) | |
202 | ||
203 | (defcustom org-clock-persist-query-save nil | |
c8d0cf5c | 204 | "When non-nil, ask before saving the current clock on exit." |
93b62de8 CD |
205 | :group 'org-clock |
206 | :type 'boolean) | |
207 | ||
208 | (defcustom org-clock-persist-query-resume t | |
c8d0cf5c | 209 | "When non-nil, ask before resuming any stored clock during load." |
93b62de8 CD |
210 | :group 'org-clock |
211 | :type 'boolean) | |
212 | ||
c8d0cf5c | 213 | (defcustom org-clock-sound nil |
271672fa BG |
214 | "Sound to use for notifications. |
215 | Possible values are: | |
c8d0cf5c | 216 | |
271672fa BG |
217 | nil No sound played |
218 | t Standard Emacs beep | |
219 | file name Play this sound file, fall back to beep" | |
c8d0cf5c CD |
220 | :group 'org-clock |
221 | :type '(choice | |
222 | (const :tag "No sound" nil) | |
223 | (const :tag "Standard beep" t) | |
271672fa | 224 | (file :tag "Play sound file"))) |
c8d0cf5c | 225 | |
a89c8ef0 | 226 | (define-obsolete-variable-alias 'org-clock-modeline-total |
bdebdb64 BG |
227 | 'org-clock-mode-line-total "24.3") |
228 | ||
229 | (defcustom org-clock-mode-line-total 'auto | |
37269466 | 230 | "Default setting for the time included for the mode line clock. |
c8d0cf5c CD |
231 | This can be overruled locally using the CLOCK_MODELINE_TOTAL property. |
232 | Allowed values are: | |
233 | ||
234 | current Only the time in the current instance of the clock | |
8bfe682a | 235 | today All time clocked into this task today |
c8d0cf5c CD |
236 | repeat All time clocked into this task since last repeat |
237 | all All time ever recorded for this task | |
8bfe682a | 238 | auto Automatically, either `all', or `repeat' for repeating tasks" |
c8d0cf5c CD |
239 | :group 'org-clock |
240 | :type '(choice | |
241 | (const :tag "Current clock" current) | |
242 | (const :tag "Today's task time" today) | |
243 | (const :tag "Since last repeat" repeat) | |
244 | (const :tag "All task time" all) | |
245 | (const :tag "Automatically, `all' or since `repeat'" auto))) | |
246 | ||
271672fa | 247 | (org-defvaralias 'org-task-overrun-text 'org-clock-task-overrun-text) |
801a68c8 | 248 | (defcustom org-clock-task-overrun-text nil |
37269466 | 249 | "Extra mode line text to indicate that the clock is overrun. |
ed21c5c8 CD |
250 | The can be nil to indicate that instead of adding text, the clock time |
251 | should get a different face (`org-mode-line-clock-overrun'). | |
252 | When this is a string, it is prepended to the clock string as an indication, | |
253 | also using the face `org-mode-line-clock-overrun'." | |
254 | :group 'org-clock | |
372d7b21 | 255 | :version "24.1" |
ed21c5c8 CD |
256 | :type '(choice |
257 | (const :tag "Just mark the time string" nil) | |
258 | (string :tag "Text to prepend"))) | |
259 | ||
c8d0cf5c CD |
260 | (defcustom org-show-notification-handler nil |
261 | "Function or program to send notification with. | |
262 | The function or program will be called with the notification | |
263 | string as argument." | |
264 | :group 'org-clock | |
265 | :type '(choice | |
271672fa | 266 | (const nil) |
c8d0cf5c CD |
267 | (string :tag "Program") |
268 | (function :tag "Function"))) | |
269 | ||
acedf35c CD |
270 | (defgroup org-clocktable nil |
271 | "Options concerning the clock table in Org-mode." | |
272 | :tag "Org Clock Table" | |
273 | :group 'org-clock) | |
274 | ||
275 | (defcustom org-clocktable-defaults | |
8223b1d2 BG |
276 | (list |
277 | :maxlevel 2 | |
271672fa | 278 | :lang (or (org-bound-and-true-p org-export-default-language) "en") |
8223b1d2 BG |
279 | :scope 'file |
280 | :block nil | |
271672fa BG |
281 | :wstart 1 |
282 | :mstart 1 | |
8223b1d2 BG |
283 | :tstart nil |
284 | :tend nil | |
285 | :step nil | |
286 | :stepskip0 nil | |
287 | :fileskip0 nil | |
288 | :tags nil | |
289 | :emphasize nil | |
290 | :link nil | |
291 | :narrow '40! | |
292 | :indent t | |
293 | :formula nil | |
294 | :timestamp nil | |
295 | :level nil | |
296 | :tcolumns nil | |
297 | :formatter nil) | |
acedf35c | 298 | "Default properties for clock tables." |
8d642074 | 299 | :group 'org-clock |
372d7b21 | 300 | :version "24.1" |
8d642074 CD |
301 | :type 'plist) |
302 | ||
acedf35c CD |
303 | (defcustom org-clock-clocktable-formatter 'org-clocktable-write-default |
304 | "Function to turn clocking data into a table. | |
305 | For more information, see `org-clocktable-write-default'." | |
306 | :group 'org-clocktable | |
372d7b21 | 307 | :version "24.1" |
acedf35c CD |
308 | :type 'function) |
309 | ||
3ab2c837 BG |
310 | ;; FIXME: translate es and nl last string "Clock summary at" |
311 | (defcustom org-clock-clocktable-language-setup | |
312 | '(("en" "File" "L" "Timestamp" "Headline" "Time" "ALL" "Total time" "File time" "Clock summary at") | |
313 | ("es" "Archivo" "N" "Fecha y hora" "Tarea" "Tiempo" "TODO" "Tiempo total" "Tiempo archivo" "Clock summary at") | |
314 | ("fr" "Fichier" "N" "Horodatage" "En-tête" "Durée" "TOUT" "Durée totale" "Durée fichier" "Horodatage sommaire à ") | |
315 | ("nl" "Bestand" "N" "Tijdstip" "Hoofding" "Duur" "ALLES" "Totale duur" "Bestandstijd" "Clock summary at")) | |
316 | "Terms used in clocktable, translated to different languages." | |
317 | :group 'org-clocktable | |
372d7b21 | 318 | :version "24.1" |
3ab2c837 BG |
319 | :type 'alist) |
320 | ||
acedf35c CD |
321 | (defcustom org-clock-clocktable-default-properties '(:maxlevel 2 :scope file) |
322 | "Default properties for new clocktables. | |
323 | These will be inserted into the BEGIN line, to make it easy for users to | |
324 | play with them." | |
325 | :group 'org-clocktable | |
326 | :type 'plist) | |
327 | ||
8bfe682a CD |
328 | (defcustom org-clock-idle-time nil |
329 | "When non-nil, resolve open clocks if the user is idle more than X minutes." | |
330 | :group 'org-clock | |
331 | :type '(choice | |
332 | (const :tag "Never" nil) | |
333 | (integer :tag "After N minutes"))) | |
334 | ||
335 | (defcustom org-clock-auto-clock-resolution 'when-no-clock-is-running | |
336 | "When to automatically resolve open clocks found in Org buffers." | |
337 | :group 'org-clock | |
338 | :type '(choice | |
339 | (const :tag "Never" nil) | |
340 | (const :tag "Always" t) | |
341 | (const :tag "When no clock is running" when-no-clock-is-running))) | |
8d642074 | 342 | |
ed21c5c8 CD |
343 | (defcustom org-clock-report-include-clocking-task nil |
344 | "When non-nil, include the current clocking task time in clock reports." | |
345 | :group 'org-clock | |
372d7b21 | 346 | :version "24.1" |
ed21c5c8 CD |
347 | :type 'boolean) |
348 | ||
86fbb8ca CD |
349 | (defcustom org-clock-resolve-expert nil |
350 | "Non-nil means do not show the splash buffer with the clock resolver." | |
351 | :group 'org-clock | |
372d7b21 | 352 | :version "24.1" |
86fbb8ca CD |
353 | :type 'boolean) |
354 | ||
8223b1d2 BG |
355 | (defcustom org-clock-continuously nil |
356 | "Non-nil means to start clocking from the last clock-out time, if any." | |
357 | :type 'boolean | |
358 | :version "24.1" | |
359 | :group 'org-clock) | |
360 | ||
361 | (defcustom org-clock-total-time-cell-format "*%s*" | |
362 | "Format string for the total time cells." | |
363 | :group 'org-clock | |
364 | :version "24.1" | |
271672fa | 365 | :type 'string) |
8223b1d2 BG |
366 | |
367 | (defcustom org-clock-file-time-cell-format "*%s*" | |
368 | "Format string for the file time cells." | |
369 | :group 'org-clock | |
370 | :version "24.1" | |
271672fa | 371 | :type 'string) |
8223b1d2 BG |
372 | |
373 | (defcustom org-clock-clocked-in-display 'mode-line | |
374 | "When clocked in for a task, org-mode can display the current | |
375 | task and accumulated time in the mode line and/or frame title. | |
376 | Allowed values are: | |
377 | ||
378 | both displays in both mode line and frame title | |
379 | mode-line displays only in mode line (default) | |
380 | frame-title displays only in frame title | |
381 | nil current clock is not displayed" | |
382 | :group 'org-clock | |
383 | :type '(choice | |
384 | (const :tag "Mode line" mode-line) | |
385 | (const :tag "Frame title" frame-title) | |
386 | (const :tag "Both" both) | |
387 | (const :tag "None" nil))) | |
388 | ||
389 | (defcustom org-clock-frame-title-format '(t org-mode-line-string) | |
390 | "The value for `frame-title-format' when clocking in. | |
391 | ||
392 | When `org-clock-clocked-in-display' is set to 'frame-title | |
393 | or 'both, clocking in will replace `frame-title-format' with | |
394 | this value. Clocking out will restore `frame-title-format'. | |
395 | ||
396 | `org-frame-title-string' is a format string using the same | |
397 | specifications than `frame-title-format', which see." | |
398 | :version "24.1" | |
399 | :group 'org-clock | |
400 | :type 'sexp) | |
401 | ||
271672fa BG |
402 | (defcustom org-clock-x11idle-program-name "x11idle" |
403 | "Name of the program which prints X11 idle time in milliseconds. | |
404 | ||
405 | You can find x11idle.c in the contrib/scripts directory of the | |
406 | Org git distribution. Or, you can do: | |
407 | ||
408 | sudo apt-get install xprintidle | |
409 | ||
410 | if you are using Debian." | |
411 | :group 'org-clock | |
412 | :version "24.4" | |
413 | :package-version '(Org . "8.0") | |
414 | :type 'string) | |
415 | ||
c8d0cf5c CD |
416 | (defvar org-clock-in-prepare-hook nil |
417 | "Hook run when preparing the clock. | |
418 | This hook is run before anything happens to the task that | |
419 | you want to clock in. For example, you can use this hook | |
420 | to add an effort property.") | |
421 | (defvar org-clock-in-hook nil | |
422 | "Hook run when starting the clock.") | |
423 | (defvar org-clock-out-hook nil | |
424 | "Hook run when stopping the current clock.") | |
425 | ||
426 | (defvar org-clock-cancel-hook nil | |
d5081c1e | 427 | "Hook run when canceling the current clock.") |
c8d0cf5c CD |
428 | (defvar org-clock-goto-hook nil |
429 | "Hook run when selecting the currently clocked-in entry.") | |
8bfe682a CD |
430 | (defvar org-clock-has-been-used nil |
431 | "Has the clock been used during the current Emacs session?") | |
c8d0cf5c | 432 | |
20908596 CD |
433 | ;;; The clock for measuring work time. |
434 | ||
435 | (defvar org-mode-line-string "") | |
436 | (put 'org-mode-line-string 'risky-local-variable t) | |
437 | ||
0bd48b37 | 438 | (defvar org-clock-mode-line-timer nil) |
8bfe682a CD |
439 | (defvar org-clock-idle-timer nil) |
440 | (defvar org-clock-heading) ; defined in org.el | |
20908596 CD |
441 | (defvar org-clock-start-time "") |
442 | ||
ed21c5c8 | 443 | (defvar org-clock-leftover-time nil |
d5081c1e | 444 | "If non-nil, user canceled a clock; this is when leftover time started.") |
8bfe682a | 445 | |
c8d0cf5c | 446 | (defvar org-clock-effort "" |
86fbb8ca | 447 | "Effort estimate of the currently clocking task.") |
c8d0cf5c CD |
448 | |
449 | (defvar org-clock-total-time nil | |
450 | "Holds total time, spent previously on currently clocked item. | |
451 | This does not include the time in the currently running clock.") | |
452 | ||
20908596 | 453 | (defvar org-clock-history nil |
b349f79f | 454 | "List of marker pointing to recent clocked tasks.") |
20908596 CD |
455 | |
456 | (defvar org-clock-default-task (make-marker) | |
457 | "Marker pointing to the default task that should clock time. | |
458 | The clock can be made to switch to this task after clocking out | |
459 | of a different task.") | |
460 | ||
461 | (defvar org-clock-interrupted-task (make-marker) | |
b349f79f | 462 | "Marker pointing to the task that has been interrupted by the current clock.") |
20908596 | 463 | |
0bd48b37 CD |
464 | (defvar org-clock-mode-line-map (make-sparse-keymap)) |
465 | (define-key org-clock-mode-line-map [mode-line mouse-2] 'org-clock-goto) | |
c8d0cf5c CD |
466 | (define-key org-clock-mode-line-map [mode-line mouse-1] 'org-clock-menu) |
467 | ||
468 | (defun org-clock-menu () | |
469 | (interactive) | |
470 | (popup-menu | |
471 | '("Clock" | |
472 | ["Clock out" org-clock-out t] | |
473 | ["Change effort estimate" org-clock-modify-effort-estimate t] | |
474 | ["Go to clock entry" org-clock-goto t] | |
475 | ["Switch task" (lambda () (interactive) (org-clock-in '(4))) :active t :keys "C-u C-c C-x C-i"]))) | |
621f83e4 | 476 | |
20908596 CD |
477 | (defun org-clock-history-push (&optional pos buffer) |
478 | "Push a marker to the clock history." | |
b349f79f | 479 | (setq org-clock-history-length (max 1 (min 35 org-clock-history-length))) |
86fbb8ca CD |
480 | (let ((m (move-marker (make-marker) |
481 | (or pos (point)) (org-base-buffer | |
482 | (or buffer (current-buffer))))) | |
483 | n l) | |
20908596 CD |
484 | (while (setq n (member m org-clock-history)) |
485 | (move-marker (car n) nil)) | |
486 | (setq org-clock-history | |
487 | (delq nil | |
488 | (mapcar (lambda (x) (if (marker-buffer x) x nil)) | |
489 | org-clock-history))) | |
490 | (when (>= (setq l (length org-clock-history)) org-clock-history-length) | |
491 | (setq org-clock-history | |
492 | (nreverse | |
493 | (nthcdr (- l org-clock-history-length -1) | |
494 | (nreverse org-clock-history))))) | |
495 | (push m org-clock-history))) | |
496 | ||
b349f79f CD |
497 | (defun org-clock-save-markers-for-cut-and-paste (beg end) |
498 | "Save relative positions of markers in region." | |
499 | (org-check-and-save-marker org-clock-marker beg end) | |
54a0dee5 | 500 | (org-check-and-save-marker org-clock-hd-marker beg end) |
b349f79f CD |
501 | (org-check-and-save-marker org-clock-default-task beg end) |
502 | (org-check-and-save-marker org-clock-interrupted-task beg end) | |
503 | (mapc (lambda (m) (org-check-and-save-marker m beg end)) | |
504 | org-clock-history)) | |
505 | ||
ed21c5c8 | 506 | (defun org-clocking-buffer () |
86fbb8ca | 507 | "Return the clocking buffer if we are currently clocking a task or nil." |
ed21c5c8 CD |
508 | (marker-buffer org-clock-marker)) |
509 | ||
510 | (defun org-clocking-p () | |
86fbb8ca | 511 | "Return t when clocking a task." |
ed21c5c8 CD |
512 | (not (equal (org-clocking-buffer) nil))) |
513 | ||
3ab2c837 BG |
514 | (defvar org-clock-before-select-task-hook nil |
515 | "Hook called in task selection just before prompting the user.") | |
516 | ||
20908596 | 517 | (defun org-clock-select-task (&optional prompt) |
271672fa | 518 | "Select a task that was recently associated with clocking." |
20908596 | 519 | (interactive) |
271672fa BG |
520 | (let (och chl sel-list rpl (i 0) s) |
521 | ;; Remove successive dups from the clock history to consider | |
522 | (mapc (lambda (c) (if (not (equal c (car och))) (push c och))) | |
523 | org-clock-history) | |
524 | (setq och (reverse och) chl (length och)) | |
525 | (if (zerop chl) | |
526 | (user-error "No recent clock") | |
527 | (save-window-excursion | |
528 | (org-switch-to-buffer-other-window | |
529 | (get-buffer-create "*Clock Task Select*")) | |
530 | (erase-buffer) | |
531 | (when (marker-buffer org-clock-default-task) | |
532 | (insert (org-add-props "Default Task\n" nil 'face 'bold)) | |
533 | (setq s (org-clock-insert-selection-line ?d org-clock-default-task)) | |
534 | (push s sel-list)) | |
535 | (when (marker-buffer org-clock-interrupted-task) | |
536 | (insert (org-add-props "The task interrupted by starting the last one\n" nil 'face 'bold)) | |
537 | (setq s (org-clock-insert-selection-line ?i org-clock-interrupted-task)) | |
538 | (push s sel-list)) | |
539 | (when (org-clocking-p) | |
540 | (insert (org-add-props "Current Clocking Task\n" nil 'face 'bold)) | |
541 | (setq s (org-clock-insert-selection-line ?c org-clock-marker)) | |
542 | (push s sel-list)) | |
543 | (insert (org-add-props "Recent Tasks\n" nil 'face 'bold)) | |
544 | (mapc | |
545 | (lambda (m) | |
546 | (when (marker-buffer m) | |
547 | (setq i (1+ i) | |
548 | s (org-clock-insert-selection-line | |
549 | (if (< i 10) | |
550 | (+ i ?0) | |
551 | (+ i (- ?A 10))) m)) | |
552 | (if (fboundp 'int-to-char) (setf (car s) (int-to-char (car s)))) | |
553 | (push s sel-list))) | |
554 | och) | |
555 | (run-hooks 'org-clock-before-select-task-hook) | |
556 | (goto-char (point-min)) | |
557 | ;; Set min-height relatively to circumvent a possible but in | |
558 | ;; `fit-window-to-buffer' | |
559 | (fit-window-to-buffer nil nil (if (< chl 10) chl (+ 5 chl))) | |
560 | (message (or prompt "Select task for clocking:")) | |
561 | (setq cursor-type nil rpl (read-char-exclusive)) | |
562 | (cond | |
563 | ((eq rpl ?q) nil) | |
564 | ((eq rpl ?x) nil) | |
565 | ((assoc rpl sel-list) (cdr (assoc rpl sel-list))) | |
566 | (t (user-error "Invalid task choice %c" rpl))))))) | |
20908596 CD |
567 | |
568 | (defun org-clock-insert-selection-line (i marker) | |
c8d0cf5c CD |
569 | "Insert a line for the clock selection menu. |
570 | And return a cons cell with the selection character integer and the marker | |
571 | pointing to it." | |
20908596 | 572 | (when (marker-buffer marker) |
c8d0cf5c | 573 | (let (file cat task heading prefix) |
b349f79f | 574 | (with-current-buffer (org-base-buffer (marker-buffer marker)) |
20908596 | 575 | (save-excursion |
b349f79f CD |
576 | (save-restriction |
577 | (widen) | |
ed21c5c8 CD |
578 | (ignore-errors |
579 | (goto-char marker) | |
580 | (setq file (buffer-file-name (marker-buffer marker)) | |
3ab2c837 | 581 | cat (org-get-category) |
ed21c5c8 CD |
582 | heading (org-get-heading 'notags) |
583 | prefix (save-excursion | |
584 | (org-back-to-heading t) | |
3ab2c837 | 585 | (looking-at org-outline-regexp) |
ed21c5c8 CD |
586 | (match-string 0)) |
587 | task (substring | |
588 | (org-fontify-like-in-org-mode | |
589 | (concat prefix heading) | |
590 | org-odd-levels-only) | |
591 | (length prefix))))))) | |
20908596 | 592 | (when (and cat task) |
271672fa | 593 | (insert (format "[%c] %-12s %s\n" i cat task)) |
20908596 | 594 | (cons i marker))))) |
621f83e4 | 595 | |
801a68c8 | 596 | (defvar org-clock-task-overrun nil |
ed21c5c8 CD |
597 | "Internal flag indicating if the clock has overrun the planned time.") |
598 | (defvar org-clock-update-period 60 | |
599 | "Number of seconds between mode line clock string updates.") | |
600 | ||
c8d0cf5c | 601 | (defun org-clock-get-clock-string () |
ed21c5c8 CD |
602 | "Form a clock-string, that will be shown in the mode line. |
603 | If an effort estimate was defined for the current item, use | |
c8d0cf5c CD |
604 | 01:30/01:50 format (clocked/estimated). |
605 | If not, show simply the clocked time like 01:50." | |
271672fa | 606 | (let ((clocked-time (org-clock-get-clocked-time))) |
ed21c5c8 CD |
607 | (if org-clock-effort |
608 | (let* ((effort-in-minutes | |
3ab2c837 | 609 | (org-duration-string-to-minutes org-clock-effort)) |
ed21c5c8 CD |
610 | (work-done-str |
611 | (org-propertize | |
271672fa | 612 | (org-minutes-to-clocksum-string clocked-time) |
801a68c8 | 613 | 'face (if (and org-clock-task-overrun (not org-clock-task-overrun-text)) |
ed21c5c8 | 614 | 'org-mode-line-clock-overrun 'org-mode-line-clock))) |
271672fa | 615 | (effort-str (org-minutes-to-clocksum-string effort-in-minutes)) |
ed21c5c8 | 616 | (clockstr (org-propertize |
8223b1d2 | 617 | (concat " [%s/" effort-str |
ed21c5c8 CD |
618 | "] (" (replace-regexp-in-string "%" "%%" org-clock-heading) ")") |
619 | 'face 'org-mode-line-clock))) | |
620 | (format clockstr work-done-str)) | |
271672fa BG |
621 | (org-propertize (concat "[" (org-minutes-to-clocksum-string clocked-time) |
622 | (format " (%s)" org-clock-heading) "]") | |
ed21c5c8 | 623 | 'face 'org-mode-line-clock)))) |
c8d0cf5c | 624 | |
271672fa BG |
625 | (defun org-clock-get-last-clock-out-time () |
626 | "Get the last clock-out time for the current subtree." | |
627 | (save-excursion | |
628 | (let ((end (save-excursion (org-end-of-subtree)))) | |
629 | (when (re-search-forward (concat org-clock-string | |
630 | ".*\\]--\\(\\[[^]]+\\]\\)") end t) | |
631 | (org-time-string-to-time (match-string 1)))))) | |
632 | ||
0bd48b37 | 633 | (defun org-clock-update-mode-line () |
ed21c5c8 CD |
634 | (if org-clock-effort |
635 | (org-clock-notify-once-if-expired) | |
801a68c8 | 636 | (setq org-clock-task-overrun nil)) |
c8d0cf5c CD |
637 | (setq org-mode-line-string |
638 | (org-propertize | |
639 | (let ((clock-string (org-clock-get-clock-string)) | |
640 | (help-text "Org-mode clock is running.\nmouse-1 shows a menu\nmouse-2 will jump to task")) | |
641 | (if (and (> org-clock-string-limit 0) | |
642 | (> (length clock-string) org-clock-string-limit)) | |
ed21c5c8 CD |
643 | (org-propertize |
644 | (substring clock-string 0 org-clock-string-limit) | |
645 | 'help-echo (concat help-text ": " org-clock-heading)) | |
c8d0cf5c CD |
646 | (org-propertize clock-string 'help-echo help-text))) |
647 | 'local-map org-clock-mode-line-map | |
8223b1d2 | 648 | 'mouse-face (if (featurep 'xemacs) 'highlight 'mode-line-highlight))) |
801a68c8 | 649 | (if (and org-clock-task-overrun org-clock-task-overrun-text) |
ed21c5c8 CD |
650 | (setq org-mode-line-string |
651 | (concat (org-propertize | |
801a68c8 | 652 | org-clock-task-overrun-text |
ed21c5c8 | 653 | 'face 'org-mode-line-clock-overrun) org-mode-line-string))) |
c8d0cf5c CD |
654 | (force-mode-line-update)) |
655 | ||
656 | (defun org-clock-get-clocked-time () | |
657 | "Get the clocked time for the current item in minutes. | |
04e65fdb | 658 | The time returned includes the time spent on this task in |
c8d0cf5c CD |
659 | previous clocking intervals." |
660 | (let ((currently-clocked-time | |
54a0dee5 CD |
661 | (floor (- (org-float-time) |
662 | (org-float-time org-clock-start-time)) 60))) | |
c8d0cf5c CD |
663 | (+ currently-clocked-time (or org-clock-total-time 0)))) |
664 | ||
665 | (defun org-clock-modify-effort-estimate (&optional value) | |
8223b1d2 | 666 | "Add to or set the effort estimate of the item currently being clocked. |
8bfe682a CD |
667 | VALUE can be a number of minutes, or a string with format hh:mm or mm. |
668 | When the string starts with a + or a - sign, the current value of the effort | |
271672fa | 669 | property will be changed by that amount. If the effort value is expressed |
d1389828 | 670 | as an `org-effort-durations' (e.g. \"3h\"), the modified value will be |
271672fa BG |
671 | converted to a hh:mm duration. |
672 | ||
673 | This command will update the \"Effort\" property of the currently | |
674 | clocked item, and the value displayed in the mode line." | |
8223b1d2 BG |
675 | (interactive) |
676 | (if (org-clock-is-active) | |
677 | (let ((current org-clock-effort) sign) | |
678 | (unless value | |
679 | ;; Prompt user for a value or a change | |
680 | (setq value | |
681 | (read-string | |
682 | (format "Set effort (hh:mm or mm%s): " | |
683 | (if current | |
684 | (format ", prefix + to add to %s" org-clock-effort) | |
685 | ""))))) | |
686 | (when (stringp value) | |
687 | ;; A string. See if it is a delta | |
688 | (setq sign (string-to-char value)) | |
689 | (if (member sign '(?- ?+)) | |
690 | (setq current (org-duration-string-to-minutes current) | |
691 | value (substring value 1)) | |
692 | (setq current 0)) | |
693 | (setq value (org-duration-string-to-minutes value)) | |
694 | (if (equal ?- sign) | |
695 | (setq value (- current value)) | |
696 | (if (equal ?+ sign) (setq value (+ current value))))) | |
697 | (setq value (max 0 value) | |
271672fa | 698 | org-clock-effort (org-minutes-to-clocksum-string value)) |
8223b1d2 BG |
699 | (org-entry-put org-clock-marker "Effort" org-clock-effort) |
700 | (org-clock-update-mode-line) | |
701 | (message "Effort is now %s" org-clock-effort)) | |
702 | (message "Clock is not currently active"))) | |
c8d0cf5c CD |
703 | |
704 | (defvar org-clock-notification-was-shown nil | |
705 | "Shows if we have shown notification already.") | |
706 | ||
707 | (defun org-clock-notify-once-if-expired () | |
708 | "Show notification if we spent more time than we estimated before. | |
709 | Notification is shown only once." | |
ed21c5c8 | 710 | (when (org-clocking-p) |
3ab2c837 | 711 | (let ((effort-in-minutes (org-duration-string-to-minutes org-clock-effort)) |
c8d0cf5c | 712 | (clocked-time (org-clock-get-clocked-time))) |
801a68c8 | 713 | (if (setq org-clock-task-overrun |
ed21c5c8 CD |
714 | (if (or (null effort-in-minutes) (zerop effort-in-minutes)) |
715 | nil | |
716 | (>= clocked-time effort-in-minutes))) | |
c8d0cf5c CD |
717 | (unless org-clock-notification-was-shown |
718 | (setq org-clock-notification-was-shown t) | |
54a0dee5 | 719 | (org-notify |
c8d0cf5c | 720 | (format "Task '%s' should be finished by now. (%s)" |
271672fa | 721 | org-clock-heading org-clock-effort) org-clock-sound)) |
c8d0cf5c CD |
722 | (setq org-clock-notification-was-shown nil))))) |
723 | ||
54a0dee5 | 724 | (defun org-notify (notification &optional play-sound) |
271672fa BG |
725 | "Send a NOTIFICATION and maybe PLAY-SOUND. |
726 | If PLAY-SOUND is non-nil, it overrides `org-clock-sound'." | |
54a0dee5 | 727 | (org-show-notification notification) |
271672fa | 728 | (if play-sound (org-clock-play-sound play-sound))) |
54a0dee5 | 729 | |
c8d0cf5c CD |
730 | (defun org-show-notification (notification) |
731 | "Show notification. | |
732 | Use `org-show-notification-handler' if defined, | |
733 | use libnotify if available, or fall back on a message." | |
734 | (cond ((functionp org-show-notification-handler) | |
735 | (funcall org-show-notification-handler notification)) | |
736 | ((stringp org-show-notification-handler) | |
737 | (start-process "emacs-timer-notification" nil | |
738 | org-show-notification-handler notification)) | |
8223b1d2 | 739 | ((fboundp 'notifications-notify) |
afe98dfa CD |
740 | (notifications-notify |
741 | :title "Org-mode message" | |
742 | :body notification | |
743 | ;; FIXME how to link to the Org icon? | |
744 | ;; :app-icon "~/.emacs.d/icons/mail.png" | |
745 | :urgency 'low)) | |
8223b1d2 | 746 | ((executable-find "notify-send") |
c8d0cf5c CD |
747 | (start-process "emacs-timer-notification" nil |
748 | "notify-send" notification)) | |
749 | ;; Maybe the handler will send a message, so only use message as | |
750 | ;; a fall back option | |
8bfe682a | 751 | (t (message "%s" notification)))) |
c8d0cf5c | 752 | |
271672fa | 753 | (defun org-clock-play-sound (&optional clock-sound) |
c8d0cf5c | 754 | "Play sound as configured by `org-clock-sound'. |
271672fa BG |
755 | Use alsa's aplay tool if available. |
756 | If CLOCK-SOUND is non-nil, it overrides `org-clock-sound'." | |
757 | (let ((org-clock-sound (or clock-sound org-clock-sound))) | |
758 | (cond | |
759 | ((not org-clock-sound)) | |
760 | ((eq org-clock-sound t) (beep t) (beep t)) | |
761 | ((stringp org-clock-sound) | |
762 | (let ((file (expand-file-name org-clock-sound))) | |
763 | (if (file-exists-p file) | |
764 | (if (executable-find "aplay") | |
765 | (start-process "org-clock-play-notification" nil | |
766 | "aplay" file) | |
767 | (condition-case nil | |
768 | (play-sound-file file) | |
769 | (error (beep t) (beep t)))))))))) | |
c8d0cf5c | 770 | |
20908596 | 771 | (defvar org-clock-mode-line-entry nil |
37269466 | 772 | "Information for the mode line about the running clock.") |
20908596 | 773 | |
8bfe682a CD |
774 | (defun org-find-open-clocks (file) |
775 | "Search through the given file and find all open clocks." | |
776 | (let ((buf (or (get-file-buffer file) | |
777 | (find-file-noselect file))) | |
778 | clocks) | |
779 | (with-current-buffer buf | |
780 | (save-excursion | |
781 | (goto-char (point-min)) | |
782 | (while (re-search-forward "CLOCK: \\(\\[.*?\\]\\)$" nil t) | |
86fbb8ca | 783 | (push (cons (copy-marker (match-end 1) t) |
8bfe682a CD |
784 | (org-time-string-to-time (match-string 1))) clocks)))) |
785 | clocks)) | |
786 | ||
787 | (defsubst org-is-active-clock (clock) | |
788 | "Return t if CLOCK is the currently active clock." | |
789 | (and (org-clock-is-active) | |
790 | (= org-clock-marker (car clock)))) | |
791 | ||
792 | (defmacro org-with-clock-position (clock &rest forms) | |
793 | "Evaluate FORMS with CLOCK as the current active clock." | |
794 | `(with-current-buffer (marker-buffer (car ,clock)) | |
795 | (save-excursion | |
796 | (save-restriction | |
797 | (widen) | |
798 | (goto-char (car ,clock)) | |
799 | (beginning-of-line) | |
800 | ,@forms)))) | |
e66ba1df | 801 | (def-edebug-spec org-with-clock-position (form body)) |
8bfe682a CD |
802 | (put 'org-with-clock-position 'lisp-indent-function 1) |
803 | ||
804 | (defmacro org-with-clock (clock &rest forms) | |
805 | "Evaluate FORMS with CLOCK as the current active clock. | |
806 | This macro also protects the current active clock from being altered." | |
807 | `(org-with-clock-position ,clock | |
808 | (let ((org-clock-start-time (cdr ,clock)) | |
809 | (org-clock-total-time) | |
810 | (org-clock-history) | |
811 | (org-clock-effort) | |
812 | (org-clock-marker (car ,clock)) | |
813 | (org-clock-hd-marker (save-excursion | |
814 | (outline-back-to-heading t) | |
815 | (point-marker)))) | |
816 | ,@forms))) | |
e66ba1df | 817 | (def-edebug-spec org-with-clock (form body)) |
8bfe682a CD |
818 | (put 'org-with-clock 'lisp-indent-function 1) |
819 | ||
86fbb8ca | 820 | (defsubst org-clock-clock-in (clock &optional resume start-time) |
8bfe682a CD |
821 | "Clock in to the clock located by CLOCK. |
822 | If necessary, clock-out of the currently active clock." | |
823 | (org-with-clock-position clock | |
824 | (let ((org-clock-in-resume (or resume org-clock-in-resume))) | |
86fbb8ca | 825 | (org-clock-in nil start-time)))) |
8bfe682a CD |
826 | |
827 | (defsubst org-clock-clock-out (clock &optional fail-quietly at-time) | |
828 | "Clock out of the clock located by CLOCK." | |
829 | (let ((temp (copy-marker (car clock) | |
830 | (marker-insertion-type (car clock))))) | |
831 | (if (org-is-active-clock clock) | |
8223b1d2 | 832 | (org-clock-out nil fail-quietly at-time) |
8bfe682a | 833 | (org-with-clock clock |
8223b1d2 | 834 | (org-clock-out nil fail-quietly at-time))) |
8bfe682a CD |
835 | (setcar clock temp))) |
836 | ||
837 | (defsubst org-clock-clock-cancel (clock) | |
838 | "Cancel the clock located by CLOCK." | |
839 | (let ((temp (copy-marker (car clock) | |
840 | (marker-insertion-type (car clock))))) | |
841 | (if (org-is-active-clock clock) | |
842 | (org-clock-cancel) | |
843 | (org-with-clock clock | |
844 | (org-clock-cancel))) | |
845 | (setcar clock temp))) | |
846 | ||
847 | (defvar org-clock-clocking-in nil) | |
848 | (defvar org-clock-resolving-clocks nil) | |
849 | (defvar org-clock-resolving-clocks-due-to-idleness nil) | |
850 | ||
86fbb8ca CD |
851 | (defun org-clock-resolve-clock (clock resolve-to clock-out-time |
852 | &optional close-p restart-p fail-quietly) | |
8bfe682a | 853 | "Resolve `CLOCK' given the time `RESOLVE-TO', and the present. |
86fbb8ca | 854 | `CLOCK' is a cons cell of the form (MARKER START-TIME)." |
8bfe682a CD |
855 | (let ((org-clock-resolving-clocks t)) |
856 | (cond | |
857 | ((null resolve-to) | |
858 | (org-clock-clock-cancel clock) | |
859 | (if (and restart-p (not org-clock-clocking-in)) | |
860 | (org-clock-clock-in clock))) | |
861 | ||
862 | ((eq resolve-to 'now) | |
863 | (if restart-p | |
864 | (error "RESTART-P is not valid here")) | |
865 | (if (or close-p org-clock-clocking-in) | |
866 | (org-clock-clock-out clock fail-quietly) | |
867 | (unless (org-is-active-clock clock) | |
868 | (org-clock-clock-in clock t)))) | |
869 | ||
870 | ((not (time-less-p resolve-to (current-time))) | |
871 | (error "RESOLVE-TO must refer to a time in the past")) | |
872 | ||
873 | (t | |
874 | (if restart-p | |
875 | (error "RESTART-P is not valid here")) | |
86fbb8ca CD |
876 | (org-clock-clock-out clock fail-quietly (or clock-out-time |
877 | resolve-to)) | |
8bfe682a CD |
878 | (unless org-clock-clocking-in |
879 | (if close-p | |
86fbb8ca CD |
880 | (setq org-clock-leftover-time (and (null clock-out-time) |
881 | resolve-to)) | |
882 | (org-clock-clock-in clock nil (and clock-out-time | |
883 | resolve-to)))))))) | |
884 | ||
885 | (defun org-clock-jump-to-current-clock (&optional effective-clock) | |
886 | (interactive) | |
3ab2c837 BG |
887 | (let ((org-clock-into-drawer (org-clock-into-drawer)) |
888 | (clock (or effective-clock (cons org-clock-marker | |
86fbb8ca CD |
889 | org-clock-start-time)))) |
890 | (unless (marker-buffer (car clock)) | |
891 | (error "No clock is currently running")) | |
892 | (org-with-clock clock (org-clock-goto)) | |
893 | (with-current-buffer (marker-buffer (car clock)) | |
894 | (goto-char (car clock)) | |
895 | (if org-clock-into-drawer | |
896 | (let ((logbook | |
897 | (if (stringp org-clock-into-drawer) | |
898 | (concat ":" org-clock-into-drawer ":") | |
899 | ":LOGBOOK:"))) | |
900 | (ignore-errors | |
901 | (outline-flag-region | |
902 | (save-excursion | |
903 | (outline-back-to-heading t) | |
904 | (search-forward logbook) | |
905 | (goto-char (match-beginning 0))) | |
906 | (save-excursion | |
907 | (outline-back-to-heading t) | |
908 | (search-forward logbook) | |
909 | (search-forward ":END:") | |
910 | (goto-char (match-end 0))) | |
911 | nil))))))) | |
8bfe682a CD |
912 | |
913 | (defun org-clock-resolve (clock &optional prompt-fn last-valid fail-quietly) | |
914 | "Resolve an open org-mode clock. | |
915 | An open clock was found, with `dangling' possibly being non-nil. | |
916 | If this function was invoked with a prefix argument, non-dangling | |
917 | open clocks are ignored. The given clock requires some sort of | |
918 | user intervention to resolve it, either because a clock was left | |
919 | dangling or due to an idle timeout. The clock resolution can | |
920 | either be: | |
921 | ||
922 | (a) deleted, the user doesn't care about the clock | |
923 | (b) restarted from the current time (if no other clock is open) | |
924 | (c) closed, giving the clock X minutes | |
925 | (d) closed and then restarted | |
926 | (e) resumed, as if the user had never left | |
927 | ||
928 | The format of clock is (CONS MARKER START-TIME), where MARKER | |
929 | identifies the buffer and position the clock is open at (and | |
930 | thus, the heading it's under), and START-TIME is when the clock | |
931 | was started." | |
932 | (assert clock) | |
933 | (let* ((ch | |
934 | (save-window-excursion | |
935 | (save-excursion | |
936 | (unless org-clock-resolving-clocks-due-to-idleness | |
86fbb8ca CD |
937 | (org-clock-jump-to-current-clock clock)) |
938 | (unless org-clock-resolve-expert | |
939 | (with-output-to-temp-buffer "*Org Clock*" | |
940 | (princ "Select a Clock Resolution Command: | |
941 | ||
271672fa | 942 | i/q Ignore this question; the same as keeping all the idle time. |
86fbb8ca CD |
943 | |
944 | k/K Keep X minutes of the idle time (default is all). If this | |
945 | amount is less than the default, you will be clocked out | |
946 | that many minutes after the time that idling began, and then | |
947 | clocked back in at the present time. | |
271672fa | 948 | |
86fbb8ca CD |
949 | g/G Indicate that you \"got back\" X minutes ago. This is quite |
950 | different from 'k': it clocks you out from the beginning of | |
951 | the idle period and clock you back in X minutes ago. | |
271672fa | 952 | |
86fbb8ca CD |
953 | s/S Subtract the idle time from the current clock. This is the |
954 | same as keeping 0 minutes. | |
271672fa | 955 | |
86fbb8ca CD |
956 | C Cancel the open timer altogether. It will be as though you |
957 | never clocked in. | |
271672fa | 958 | |
86fbb8ca CD |
959 | j/J Jump to the current clock, to make manual adjustments. |
960 | ||
961 | For all these options, using uppercase makes your final state | |
962 | to be CLOCKED OUT."))) | |
963 | (org-fit-window-to-buffer (get-buffer-window "*Org Clock*")) | |
8bfe682a | 964 | (let (char-pressed) |
86fbb8ca CD |
965 | (when (featurep 'xemacs) |
966 | (message (concat (funcall prompt-fn clock) | |
967 | " [jkKgGsScCiq]? ")) | |
968 | (setq char-pressed (read-char-exclusive))) | |
ed21c5c8 | 969 | (while (or (null char-pressed) |
86fbb8ca CD |
970 | (and (not (memq char-pressed |
971 | '(?k ?K ?g ?G ?s ?S ?C | |
972 | ?j ?J ?i ?q))) | |
ed21c5c8 | 973 | (or (ding) t))) |
8bfe682a CD |
974 | (setq char-pressed |
975 | (read-char (concat (funcall prompt-fn clock) | |
86fbb8ca | 976 | " [jkKgGSscCiq]? ") |
8bfe682a | 977 | nil 45))) |
86fbb8ca CD |
978 | (and (not (memq char-pressed '(?i ?q))) char-pressed))))) |
979 | (default | |
980 | (floor (/ (org-float-time | |
981 | (time-subtract (current-time) last-valid)) 60))) | |
982 | (keep | |
983 | (and (memq ch '(?k ?K)) | |
984 | (read-number "Keep how many minutes? " default))) | |
985 | (gotback | |
986 | (and (memq ch '(?g ?G)) | |
987 | (read-number "Got back how many minutes ago? " default))) | |
8bfe682a CD |
988 | (subtractp (memq ch '(?s ?S))) |
989 | (barely-started-p (< (- (org-float-time last-valid) | |
990 | (org-float-time (cdr clock))) 45)) | |
991 | (start-over (and subtractp barely-started-p))) | |
86fbb8ca CD |
992 | (cond |
993 | ((memq ch '(?j ?J)) | |
994 | (if (eq ch ?J) | |
995 | (org-clock-resolve-clock clock 'now nil t nil fail-quietly)) | |
996 | (org-clock-jump-to-current-clock clock)) | |
997 | ((or (null ch) | |
998 | (not (memq ch '(?k ?K ?g ?G ?s ?S ?C)))) | |
999 | (message "")) | |
1000 | (t | |
8bfe682a CD |
1001 | (org-clock-resolve-clock |
1002 | clock (cond | |
1003 | ((or (eq ch ?C) | |
1004 | ;; If the time on the clock was less than a minute before | |
1005 | ;; the user went away, and they've ask to subtract all the | |
1006 | ;; time... | |
1007 | start-over) | |
1008 | nil) | |
86fbb8ca CD |
1009 | ((or subtractp |
1010 | (and gotback (= gotback 0))) | |
8bfe682a | 1011 | last-valid) |
86fbb8ca CD |
1012 | ((or (and keep (= keep default)) |
1013 | (and gotback (= gotback default))) | |
8bfe682a | 1014 | 'now) |
86fbb8ca CD |
1015 | (keep |
1016 | (time-add last-valid (seconds-to-time (* 60 keep)))) | |
1017 | (gotback | |
1018 | (time-subtract (current-time) | |
1019 | (seconds-to-time (* 60 gotback)))) | |
8bfe682a | 1020 | (t |
86fbb8ca CD |
1021 | (error "Unexpected, please report this as a bug"))) |
1022 | (and gotback last-valid) | |
1023 | (memq ch '(?K ?G ?S)) | |
8bfe682a | 1024 | (and start-over |
86fbb8ca CD |
1025 | (not (memq ch '(?K ?G ?S ?C)))) |
1026 | fail-quietly))))) | |
8bfe682a | 1027 | |
bdebdb64 | 1028 | ;;;###autoload |
86fbb8ca | 1029 | (defun org-resolve-clocks (&optional only-dangling-p prompt-fn last-valid) |
8bfe682a | 1030 | "Resolve all currently open org-mode clocks. |
86fbb8ca CD |
1031 | If `only-dangling-p' is non-nil, only ask to resolve dangling |
1032 | \(i.e., not currently open and valid) clocks." | |
8bfe682a CD |
1033 | (interactive "P") |
1034 | (unless org-clock-resolving-clocks | |
1035 | (let ((org-clock-resolving-clocks t)) | |
1036 | (dolist (file (org-files-list)) | |
1037 | (let ((clocks (org-find-open-clocks file))) | |
1038 | (dolist (clock clocks) | |
1039 | (let ((dangling (or (not (org-clock-is-active)) | |
1040 | (/= (car clock) org-clock-marker)))) | |
86fbb8ca | 1041 | (if (or (not only-dangling-p) dangling) |
8223b1d2 BG |
1042 | (org-clock-resolve |
1043 | clock | |
1044 | (or prompt-fn | |
1045 | (function | |
1046 | (lambda (clock) | |
1047 | (format | |
1048 | "Dangling clock started %d mins ago" | |
1049 | (floor | |
1050 | (/ (- (org-float-time (current-time)) | |
1051 | (org-float-time (cdr clock))) 60)))))) | |
1052 | (or last-valid | |
1053 | (cdr clock))))))))))) | |
8bfe682a CD |
1054 | |
1055 | (defun org-emacs-idle-seconds () | |
1056 | "Return the current Emacs idle time in seconds, or nil if not idle." | |
1057 | (let ((idle-time (current-idle-time))) | |
1058 | (if idle-time | |
1059 | (org-float-time idle-time) | |
1060 | 0))) | |
1061 | ||
1062 | (defun org-mac-idle-seconds () | |
86fbb8ca | 1063 | "Return the current Mac idle time in seconds." |
8bfe682a CD |
1064 | (string-to-number (shell-command-to-string "ioreg -c IOHIDSystem | perl -ane 'if (/Idle/) {$idle=(pop @F)/1000000000; print $idle; last}'"))) |
1065 | ||
8223b1d2 BG |
1066 | (defvar org-x11idle-exists-p |
1067 | ;; Check that x11idle exists | |
1068 | (and (eq window-system 'x) | |
271672fa | 1069 | (eq (call-process-shell-command "command" nil nil nil "-v" org-clock-x11idle-program-name) 0) |
8223b1d2 | 1070 | ;; Check that x11idle can retrieve the idle time |
271672fa | 1071 | (eq (call-process-shell-command org-clock-x11idle-program-name nil nil nil) 0))) |
8223b1d2 | 1072 | |
8bfe682a | 1073 | (defun org-x11-idle-seconds () |
86fbb8ca | 1074 | "Return the current X11 idle time in seconds." |
271672fa | 1075 | (/ (string-to-number (shell-command-to-string org-clock-x11idle-program-name)) 1000)) |
8bfe682a CD |
1076 | |
1077 | (defun org-user-idle-seconds () | |
1078 | "Return the number of seconds the user has been idle for. | |
1079 | This routine returns a floating point number." | |
ed21c5c8 CD |
1080 | (cond |
1081 | ((eq system-type 'darwin) | |
1082 | (org-mac-idle-seconds)) | |
8223b1d2 | 1083 | ((and (eq window-system 'x) org-x11idle-exists-p) |
ed21c5c8 CD |
1084 | (org-x11-idle-seconds)) |
1085 | (t | |
1086 | (org-emacs-idle-seconds)))) | |
8bfe682a CD |
1087 | |
1088 | (defvar org-clock-user-idle-seconds) | |
1089 | ||
1090 | (defun org-resolve-clocks-if-idle () | |
1091 | "Resolve all currently open org-mode clocks. | |
1092 | This is performed after `org-clock-idle-time' minutes, to check | |
1093 | if the user really wants to stay clocked in after being idle for | |
1094 | so long." | |
1095 | (when (and org-clock-idle-time (not org-clock-resolving-clocks) | |
271672fa | 1096 | org-clock-marker (marker-buffer org-clock-marker)) |
ed21c5c8 CD |
1097 | (let* ((org-clock-user-idle-seconds (org-user-idle-seconds)) |
1098 | (org-clock-user-idle-start | |
1099 | (time-subtract (current-time) | |
1100 | (seconds-to-time org-clock-user-idle-seconds))) | |
1101 | (org-clock-resolving-clocks-due-to-idleness t)) | |
8bfe682a CD |
1102 | (if (> org-clock-user-idle-seconds (* 60 org-clock-idle-time)) |
1103 | (org-clock-resolve | |
1104 | (cons org-clock-marker | |
1105 | org-clock-start-time) | |
1106 | (function | |
1107 | (lambda (clock) | |
1108 | (format "Clocked in & idle for %.1f mins" | |
1109 | (/ (org-float-time | |
1110 | (time-subtract (current-time) | |
1111 | org-clock-user-idle-start)) | |
1112 | 60.0)))) | |
1113 | org-clock-user-idle-start))))) | |
1114 | ||
271672fa | 1115 | (defvar org-clock-current-task nil "Task currently clocked in.") |
8223b1d2 | 1116 | (defvar org-clock-out-time nil) ; store the time of the last clock-out |
666ffc7e | 1117 | (defvar org--msg-extra) |
bdebdb64 BG |
1118 | |
1119 | ;;;###autoload | |
86fbb8ca | 1120 | (defun org-clock-in (&optional select start-time) |
20908596 CD |
1121 | "Start the clock on the current item. |
1122 | If necessary, clock-out of the currently active clock. | |
8223b1d2 BG |
1123 | With a prefix argument SELECT (\\[universal-argument]), offer a list of recently clocked |
1124 | tasks to clock into. When SELECT is \\[universal-argument] \\[universal-argument], clock into the current task | |
1125 | and mark it as the default task, a special task that will always be offered | |
1126 | in the clocking selection, associated with the letter `d'. | |
1127 | When SELECT is \\[universal-argument] \\[universal-argument] \\[universal-argument], \ | |
1128 | clock in by using the last clock-out | |
1129 | time as the start time \(see `org-clock-continuously' to | |
1130 | make this the default behavior.)" | |
20908596 | 1131 | (interactive "P") |
c8d0cf5c | 1132 | (setq org-clock-notification-was-shown nil) |
c7cf0ebc | 1133 | (org-refresh-properties org-effort-property 'org-effort) |
ce4fdcb9 | 1134 | (catch 'abort |
8bfe682a | 1135 | (let ((interrupting (and (not org-clock-resolving-clocks-due-to-idleness) |
ed21c5c8 | 1136 | (org-clocking-p))) |
666ffc7e | 1137 | ts selected-task target-pos (org--msg-extra "") |
ed21c5c8 | 1138 | (leftover (and (not org-clock-resolving-clocks) |
8223b1d2 | 1139 | org-clock-leftover-time))) |
3ab2c837 | 1140 | |
8bfe682a CD |
1141 | (when (and org-clock-auto-clock-resolution |
1142 | (or (not interrupting) | |
1143 | (eq t org-clock-auto-clock-resolution)) | |
1144 | (not org-clock-clocking-in) | |
1145 | (not org-clock-resolving-clocks)) | |
ed21c5c8 | 1146 | (setq org-clock-leftover-time nil) |
8bfe682a CD |
1147 | (let ((org-clock-clocking-in t)) |
1148 | (org-resolve-clocks))) ; check if any clocks are dangling | |
3ab2c837 | 1149 | |
8223b1d2 BG |
1150 | (when (equal select '(64)) |
1151 | ;; Set start-time to `org-clock-out-time' | |
1152 | (let ((org-clock-continuously t)) | |
1153 | (org-clock-in nil org-clock-out-time))) | |
1154 | ||
ce4fdcb9 CD |
1155 | (when (equal select '(4)) |
1156 | (setq selected-task (org-clock-select-task "Clock-in on task: ")) | |
1157 | (if selected-task | |
1158 | (setq selected-task (copy-marker selected-task)) | |
1159 | (error "Abort"))) | |
3ab2c837 BG |
1160 | |
1161 | (when (equal select '(16)) | |
1162 | ;; Mark as default clocking task | |
1163 | (org-clock-mark-default-task)) | |
1164 | ||
ce4fdcb9 | 1165 | (when interrupting |
33306645 | 1166 | ;; We are interrupting the clocking of a different task. |
ce4fdcb9 | 1167 | ;; Save a marker to this task, so that we can go back. |
ed21c5c8 | 1168 | ;; First check if we are trying to clock into the same task! |
afe98dfa | 1169 | (when (save-excursion |
ed21c5c8 CD |
1170 | (unless selected-task |
1171 | (org-back-to-heading t)) | |
1172 | (and (equal (marker-buffer org-clock-hd-marker) | |
1173 | (if selected-task | |
1174 | (marker-buffer selected-task) | |
1175 | (current-buffer))) | |
1176 | (= (marker-position org-clock-hd-marker) | |
1177 | (if selected-task | |
1178 | (marker-position selected-task) | |
3ab2c837 BG |
1179 | (point))) |
1180 | (equal org-clock-current-task (nth 4 (org-heading-components))))) | |
afe98dfa CD |
1181 | (message "Clock continues in \"%s\"" org-clock-heading) |
1182 | (throw 'abort nil)) | |
1183 | (move-marker org-clock-interrupted-task | |
1184 | (marker-position org-clock-marker) | |
1185 | (marker-buffer org-clock-marker)) | |
1186 | (let ((org-clock-clocking-in t)) | |
8223b1d2 | 1187 | (org-clock-out nil t))) |
ed21c5c8 | 1188 | |
8bfe682a CD |
1189 | ;; Clock in at which position? |
1190 | (setq target-pos | |
e66ba1df | 1191 | (if (and (eobp) (not (org-at-heading-p))) |
8bfe682a CD |
1192 | (point-at-bol 0) |
1193 | (point))) | |
ce4fdcb9 CD |
1194 | (save-excursion |
1195 | (when (and selected-task (marker-buffer selected-task)) | |
1196 | ;; There is a selected task, move to the correct buffer | |
1197 | ;; and set the new target position. | |
1198 | (set-buffer (org-base-buffer (marker-buffer selected-task))) | |
1199 | (setq target-pos (marker-position selected-task)) | |
1200 | (move-marker selected-task nil)) | |
1201 | (save-excursion | |
1202 | (save-restriction | |
1203 | (widen) | |
1204 | (goto-char target-pos) | |
1205 | (org-back-to-heading t) | |
1206 | (or interrupting (move-marker org-clock-interrupted-task nil)) | |
271672fa BG |
1207 | (run-hooks 'org-clock-in-prepare-hook) |
1208 | (org-clock-history-push) | |
1209 | (setq org-clock-current-task (nth 4 (org-heading-components))) | |
ce4fdcb9 CD |
1210 | (cond ((functionp org-clock-in-switch-to-state) |
1211 | (looking-at org-complex-heading-regexp) | |
1212 | (let ((newstate (funcall org-clock-in-switch-to-state | |
1213 | (match-string 2)))) | |
1214 | (if newstate (org-todo newstate)))) | |
1215 | ((and org-clock-in-switch-to-state | |
3ab2c837 | 1216 | (not (looking-at (concat org-outline-regexp "[ \t]*" |
ce4fdcb9 CD |
1217 | org-clock-in-switch-to-state |
1218 | "\\>")))) | |
1219 | (org-todo org-clock-in-switch-to-state))) | |
ce4fdcb9 CD |
1220 | (setq org-clock-heading |
1221 | (cond ((and org-clock-heading-function | |
1222 | (functionp org-clock-heading-function)) | |
1223 | (funcall org-clock-heading-function)) | |
271672fa | 1224 | ((nth 4 (org-heading-components)) |
ed21c5c8 CD |
1225 | (replace-regexp-in-string |
1226 | "\\[\\[.*?\\]\\[\\(.*?\\)\\]\\]" "\\1" | |
271672fa | 1227 | (match-string-no-properties 4))) |
ce4fdcb9 | 1228 | (t "???"))) |
c8d0cf5c | 1229 | (org-clock-find-position org-clock-in-resume) |
ce4fdcb9 CD |
1230 | (cond |
1231 | ((and org-clock-in-resume | |
1232 | (looking-at | |
e66ba1df | 1233 | (concat "^[ \t]*" org-clock-string |
ce4fdcb9 | 1234 | " \\[\\([0-9]\\{4\\}-[0-9]\\{2\\}-[0-9]\\{2\\}" |
e66ba1df | 1235 | " *\\sw+\.? +[012][0-9]:[0-5][0-9]\\)\\][ \t]*$"))) |
ce4fdcb9 CD |
1236 | (message "Matched %s" (match-string 1)) |
1237 | (setq ts (concat "[" (match-string 1) "]")) | |
1238 | (goto-char (match-end 1)) | |
1239 | (setq org-clock-start-time | |
1240 | (apply 'encode-time | |
c8d0cf5c | 1241 | (org-parse-time-string (match-string 1)))) |
d3517077 | 1242 | (setq org-clock-effort (org-entry-get (point) org-effort-property)) |
c8d0cf5c CD |
1243 | (setq org-clock-total-time (org-clock-sum-current-item |
1244 | (org-clock-get-sum-start)))) | |
ce4fdcb9 CD |
1245 | ((eq org-clock-in-resume 'auto-restart) |
1246 | ;; called from org-clock-load during startup, | |
1247 | ;; do not interrupt, but warn! | |
1248 | (message "Cannot restart clock because task does not contain unfinished clock") | |
1249 | (ding) | |
1250 | (sit-for 2) | |
1251 | (throw 'abort nil)) | |
1252 | (t | |
c8d0cf5c CD |
1253 | (insert-before-markers "\n") |
1254 | (backward-char 1) | |
8223b1d2 | 1255 | (org-indent-line) |
c8d0cf5c CD |
1256 | (when (and (save-excursion |
1257 | (end-of-line 0) | |
1258 | (org-in-item-p))) | |
1259 | (beginning-of-line 1) | |
1260 | (org-indent-line-to (- (org-get-indentation) 2))) | |
93b62de8 | 1261 | (insert org-clock-string " ") |
d3517077 | 1262 | (setq org-clock-effort (org-entry-get (point) org-effort-property)) |
c8d0cf5c CD |
1263 | (setq org-clock-total-time (org-clock-sum-current-item |
1264 | (org-clock-get-sum-start))) | |
8bfe682a | 1265 | (setq org-clock-start-time |
8223b1d2 BG |
1266 | (or (and org-clock-continuously org-clock-out-time) |
1267 | (and leftover | |
8bfe682a CD |
1268 | (y-or-n-p |
1269 | (format | |
1270 | "You stopped another clock %d mins ago; start this one from then? " | |
271672fa BG |
1271 | (/ (- (org-float-time |
1272 | (org-current-time org-clock-rounding-minutes t)) | |
ed21c5c8 CD |
1273 | (org-float-time leftover)) 60))) |
1274 | leftover) | |
86fbb8ca | 1275 | start-time |
271672fa | 1276 | (org-current-time org-clock-rounding-minutes t))) |
c8d0cf5c CD |
1277 | (setq ts (org-insert-time-stamp org-clock-start-time |
1278 | 'with-hm 'inactive)))) | |
ce4fdcb9 | 1279 | (move-marker org-clock-marker (point) (buffer-base-buffer)) |
54a0dee5 CD |
1280 | (move-marker org-clock-hd-marker |
1281 | (save-excursion (org-back-to-heading t) (point)) | |
1282 | (buffer-base-buffer)) | |
8bfe682a | 1283 | (setq org-clock-has-been-used t) |
8223b1d2 BG |
1284 | ;; add to mode line |
1285 | (when (or (eq org-clock-clocked-in-display 'mode-line) | |
1286 | (eq org-clock-clocked-in-display 'both)) | |
1287 | (or global-mode-string (setq global-mode-string '(""))) | |
1288 | (or (memq 'org-mode-line-string global-mode-string) | |
1289 | (setq global-mode-string | |
1290 | (append global-mode-string '(org-mode-line-string))))) | |
1291 | ;; add to frame title | |
1292 | (when (or (eq org-clock-clocked-in-display 'frame-title) | |
1293 | (eq org-clock-clocked-in-display 'both)) | |
1294 | (setq frame-title-format org-clock-frame-title-format)) | |
0bd48b37 | 1295 | (org-clock-update-mode-line) |
8bfe682a CD |
1296 | (when org-clock-mode-line-timer |
1297 | (cancel-timer org-clock-mode-line-timer) | |
1298 | (setq org-clock-mode-line-timer nil)) | |
8223b1d2 BG |
1299 | (when org-clock-clocked-in-display |
1300 | (setq org-clock-mode-line-timer | |
1301 | (run-with-timer org-clock-update-period | |
1302 | org-clock-update-period | |
1303 | 'org-clock-update-mode-line))) | |
8bfe682a CD |
1304 | (when org-clock-idle-timer |
1305 | (cancel-timer org-clock-idle-timer) | |
1306 | (setq org-clock-idle-timer nil)) | |
1307 | (setq org-clock-idle-timer | |
1308 | (run-with-timer 60 60 'org-resolve-clocks-if-idle)) | |
666ffc7e | 1309 | (message "Clock starts at %s - %s" ts org--msg-extra) |
c8d0cf5c | 1310 | (run-hooks 'org-clock-in-hook))))))) |
20908596 | 1311 | |
8223b1d2 BG |
1312 | ;;;###autoload |
1313 | (defun org-clock-in-last (&optional arg) | |
1314 | "Clock in the last closed clocked item. | |
1315 | When already clocking in, send an warning. | |
1316 | With a universal prefix argument, select the task you want to | |
1317 | clock in from the last clocked in tasks. | |
1318 | With two universal prefix arguments, start clocking using the | |
1319 | last clock-out time, if any. | |
1320 | With three universal prefix arguments, interactively prompt | |
1321 | for a todo state to switch to, overriding the existing value | |
1322 | `org-clock-in-switch-to-state'." | |
1323 | (interactive "P") | |
1324 | (if (equal arg '(4)) | |
1325 | (org-clock-in (org-clock-select-task)) | |
1326 | (let ((start-time (if (or org-clock-continuously (equal arg '(16))) | |
271672fa BG |
1327 | (or org-clock-out-time |
1328 | (org-current-time org-clock-rounding-minutes t)) | |
1329 | (org-current-time org-clock-rounding-minutes t)))) | |
8223b1d2 BG |
1330 | (if (null org-clock-history) |
1331 | (message "No last clock") | |
1332 | (let ((org-clock-in-switch-to-state | |
1333 | (if (and (not org-clock-current-task) (equal arg '(64))) | |
1334 | (completing-read "Switch to state: " | |
1335 | (and org-clock-history | |
1336 | (with-current-buffer | |
1337 | (marker-buffer (car org-clock-history)) | |
1338 | org-todo-keywords-1))) | |
1339 | org-clock-in-switch-to-state)) | |
1340 | (already-clocking org-clock-current-task)) | |
1341 | (org-clock-clock-in (list (car org-clock-history)) nil start-time) | |
1342 | (or already-clocking | |
1343 | ;; Don't display a message if we are already clocking in | |
1344 | (message "Clocking back: %s (in %s)" | |
1345 | org-clock-current-task | |
1346 | (buffer-name (marker-buffer org-clock-marker))))))))) | |
1347 | ||
c8d0cf5c CD |
1348 | (defun org-clock-mark-default-task () |
1349 | "Mark current task as default task." | |
1350 | (interactive) | |
1351 | (save-excursion | |
1352 | (org-back-to-heading t) | |
1353 | (move-marker org-clock-default-task (point)))) | |
1354 | ||
c8d0cf5c CD |
1355 | (defun org-clock-get-sum-start () |
1356 | "Return the time from which clock times should be counted. | |
1357 | This is for the currently running clock as it is displayed | |
1358 | in the mode line. This function looks at the properties | |
1359 | LAST_REPEAT and in particular CLOCK_MODELINE_TOTAL and the | |
bdebdb64 | 1360 | corresponding variable `org-clock-mode-line-total' and then |
c8d0cf5c CD |
1361 | decides which time to use." |
1362 | (let ((cmt (or (org-entry-get nil "CLOCK_MODELINE_TOTAL") | |
bdebdb64 | 1363 | (symbol-name org-clock-mode-line-total))) |
c8d0cf5c CD |
1364 | (lr (org-entry-get nil "LAST_REPEAT"))) |
1365 | (cond | |
1366 | ((equal cmt "current") | |
666ffc7e | 1367 | (setq org--msg-extra "showing time in current clock instance") |
c8d0cf5c CD |
1368 | (current-time)) |
1369 | ((equal cmt "today") | |
666ffc7e | 1370 | (setq org--msg-extra "showing today's task time.") |
c8d0cf5c CD |
1371 | (let* ((dt (decode-time (current-time)))) |
1372 | (setq dt (append (list 0 0 0) (nthcdr 3 dt))) | |
1373 | (if org-extend-today-until | |
1374 | (setf (nth 2 dt) org-extend-today-until)) | |
1375 | (apply 'encode-time dt))) | |
1376 | ((or (equal cmt "all") | |
1377 | (and (or (not cmt) (equal cmt "auto")) | |
1378 | (not lr))) | |
666ffc7e | 1379 | (setq org--msg-extra "showing entire task time.") |
c8d0cf5c CD |
1380 | nil) |
1381 | ((or (equal cmt "repeat") | |
1382 | (and (or (not cmt) (equal cmt "auto")) | |
1383 | lr)) | |
666ffc7e | 1384 | (setq org--msg-extra "showing task time since last repeat.") |
c8d0cf5c CD |
1385 | (if (not lr) |
1386 | nil | |
1387 | (org-time-string-to-time lr))) | |
1388 | (t nil)))) | |
1389 | ||
1390 | (defun org-clock-find-position (find-unclosed) | |
1391 | "Find the location where the next clock line should be inserted. | |
1392 | When FIND-UNCLOSED is non-nil, first check if there is an unclosed clock | |
1393 | line and position cursor in that line." | |
20908596 CD |
1394 | (org-back-to-heading t) |
1395 | (catch 'exit | |
3ab2c837 BG |
1396 | (let* ((org-clock-into-drawer (org-clock-into-drawer)) |
1397 | (beg (save-excursion | |
1398 | (beginning-of-line 2) | |
1399 | (or (bolp) (newline)) | |
1400 | (point))) | |
1401 | (end (progn (outline-next-heading) (point))) | |
1402 | (re (concat "^[ \t]*" org-clock-string)) | |
1403 | (cnt 0) | |
1404 | (drawer (if (stringp org-clock-into-drawer) | |
1405 | org-clock-into-drawer "LOGBOOK")) | |
1406 | first last ind-last) | |
20908596 | 1407 | (goto-char beg) |
c8d0cf5c CD |
1408 | (when (and find-unclosed |
1409 | (re-search-forward | |
e66ba1df | 1410 | (concat "^[ \t]*" org-clock-string |
c8d0cf5c | 1411 | " \\[\\([0-9]\\{4\\}-[0-9]\\{2\\}-[0-9]\\{2\\}" |
e66ba1df | 1412 | " *\\sw+ +[012][0-9]:[0-5][0-9]\\)\\][ \t]*$") |
c8d0cf5c CD |
1413 | end t)) |
1414 | (beginning-of-line 1) | |
1415 | (throw 'exit t)) | |
20908596 | 1416 | (when (eobp) (newline) (setq end (max (point) end))) |
c8d0cf5c | 1417 | (when (re-search-forward (concat "^[ \t]*:" drawer ":") end t) |
20908596 CD |
1418 | ;; we seem to have a CLOCK drawer, so go there. |
1419 | (beginning-of-line 2) | |
c8d0cf5c CD |
1420 | (or org-log-states-order-reversed |
1421 | (and (re-search-forward org-property-end-re nil t) | |
1422 | (goto-char (match-beginning 0)))) | |
20908596 | 1423 | (throw 'exit t)) |
e66ba1df | 1424 | ;; Lets count the CLOCK lines |
20908596 CD |
1425 | (goto-char beg) |
1426 | (while (re-search-forward re end t) | |
1427 | (setq first (or first (match-beginning 0)) | |
1428 | last (match-beginning 0) | |
1429 | cnt (1+ cnt))) | |
1430 | (when (and (integerp org-clock-into-drawer) | |
c8d0cf5c | 1431 | last |
20908596 CD |
1432 | (>= (1+ cnt) org-clock-into-drawer)) |
1433 | ;; Wrap current entries into a new drawer | |
1434 | (goto-char last) | |
c8d0cf5c | 1435 | (setq ind-last (org-get-indentation)) |
20908596 | 1436 | (beginning-of-line 2) |
c8d0cf5c CD |
1437 | (if (and (>= (org-get-indentation) ind-last) |
1438 | (org-at-item-p)) | |
3ab2c837 | 1439 | (when (and (>= (org-get-indentation) ind-last) |
8223b1d2 | 1440 | (org-at-item-p)) |
3ab2c837 BG |
1441 | (let ((struct (org-list-struct))) |
1442 | (goto-char (org-list-get-bottom-point struct))))) | |
20908596 CD |
1443 | (insert ":END:\n") |
1444 | (beginning-of-line 0) | |
c8d0cf5c | 1445 | (org-indent-line-to ind-last) |
20908596 | 1446 | (goto-char first) |
c8d0cf5c | 1447 | (insert ":" drawer ":\n") |
20908596 | 1448 | (beginning-of-line 0) |
8223b1d2 | 1449 | (org-indent-line) |
20908596 CD |
1450 | (org-flag-drawer t) |
1451 | (beginning-of-line 2) | |
c8d0cf5c CD |
1452 | (or org-log-states-order-reversed |
1453 | (and (re-search-forward org-property-end-re nil t) | |
1454 | (goto-char (match-beginning 0)))) | |
20908596 CD |
1455 | (throw 'exit nil)) |
1456 | ||
1457 | (goto-char beg) | |
1458 | (while (and (looking-at (concat "[ \t]*" org-keyword-time-regexp)) | |
1459 | (not (equal (match-string 1) org-clock-string))) | |
1460 | ;; Planning info, skip to after it | |
1461 | (beginning-of-line 2) | |
1462 | (or (bolp) (newline))) | |
c8d0cf5c CD |
1463 | (when (or (eq org-clock-into-drawer t) |
1464 | (stringp org-clock-into-drawer) | |
1465 | (and (integerp org-clock-into-drawer) | |
1466 | (< org-clock-into-drawer 2))) | |
1467 | (insert ":" drawer ":\n:END:\n") | |
1468 | (beginning-of-line -1) | |
8223b1d2 | 1469 | (org-indent-line) |
20908596 | 1470 | (org-flag-drawer t) |
c8d0cf5c | 1471 | (beginning-of-line 2) |
8223b1d2 | 1472 | (org-indent-line) |
c8d0cf5c CD |
1473 | (beginning-of-line) |
1474 | (or org-log-states-order-reversed | |
1475 | (and (re-search-forward org-property-end-re nil t) | |
1476 | (goto-char (match-beginning 0)))))))) | |
20908596 | 1477 | |
bdebdb64 | 1478 | ;;;###autoload |
8223b1d2 | 1479 | (defun org-clock-out (&optional switch-to-state fail-quietly at-time) |
20908596 | 1480 | "Stop the currently running clock. |
8223b1d2 BG |
1481 | Throw an error if there is no running clock and FAIL-QUIETLY is nil. |
1482 | With a universal prefix, prompt for a state to switch the clocked out task | |
1483 | to, overriding the existing value of `org-clock-out-switch-to-state'." | |
1484 | (interactive "P") | |
20908596 | 1485 | (catch 'exit |
86fbb8ca CD |
1486 | (when (not (org-clocking-p)) |
1487 | (setq global-mode-string | |
1488 | (delq 'org-mode-line-string global-mode-string)) | |
8223b1d2 | 1489 | (setq frame-title-format org-frame-title-format-backup) |
86fbb8ca | 1490 | (force-mode-line-update) |
63aa0982 | 1491 | (if fail-quietly (throw 'exit t) (user-error "No active clock"))) |
8223b1d2 BG |
1492 | (let ((org-clock-out-switch-to-state |
1493 | (if switch-to-state | |
1494 | (completing-read "Switch to state: " | |
1495 | (with-current-buffer | |
1496 | (marker-buffer org-clock-marker) | |
1497 | org-todo-keywords-1) | |
1498 | nil t "DONE") | |
1499 | org-clock-out-switch-to-state)) | |
271672fa | 1500 | (now (org-current-time org-clock-rounding-minutes)) |
8223b1d2 BG |
1501 | ts te s h m remove) |
1502 | (setq org-clock-out-time now) | |
86fbb8ca | 1503 | (save-excursion ; Do not replace this with `with-current-buffer'. |
8223b1d2 | 1504 | (org-no-warnings (set-buffer (org-clocking-buffer))) |
c8d0cf5c CD |
1505 | (save-restriction |
1506 | (widen) | |
1507 | (goto-char org-clock-marker) | |
20908596 | 1508 | (beginning-of-line 1) |
c8d0cf5c CD |
1509 | (if (and (looking-at (concat "[ \t]*" org-keyword-time-regexp)) |
1510 | (equal (match-string 1) org-clock-string)) | |
1511 | (setq ts (match-string 2)) | |
1512 | (if fail-quietly (throw 'exit nil) (error "Clock start time is gone"))) | |
1513 | (goto-char (match-end 0)) | |
20908596 | 1514 | (delete-region (point) (point-at-eol)) |
c8d0cf5c | 1515 | (insert "--") |
8223b1d2 | 1516 | (setq te (org-insert-time-stamp (or at-time now) 'with-hm 'inactive)) |
54a0dee5 CD |
1517 | (setq s (- (org-float-time (apply 'encode-time (org-parse-time-string te))) |
1518 | (org-float-time (apply 'encode-time (org-parse-time-string ts)))) | |
c8d0cf5c CD |
1519 | h (floor (/ s 3600)) |
1520 | s (- s (* 3600 h)) | |
1521 | m (floor (/ s 60)) | |
1522 | s (- s (* 60 s))) | |
1523 | (insert " => " (format "%2d:%02d" h m)) | |
1524 | (when (setq remove (and org-clock-out-remove-zero-time-clocks | |
1525 | (= (+ h m) 0))) | |
1526 | (beginning-of-line 1) | |
1527 | (delete-region (point) (point-at-eol)) | |
1528 | (and (looking-at "\n") (> (point-max) (1+ (point))) | |
1529 | (delete-char 1))) | |
1530 | (move-marker org-clock-marker nil) | |
54a0dee5 | 1531 | (move-marker org-clock-hd-marker nil) |
c8d0cf5c CD |
1532 | (when org-log-note-clock-out |
1533 | (org-add-log-setup 'clock-out nil nil nil nil | |
1534 | (concat "# Task: " (org-get-heading t) "\n\n"))) | |
1535 | (when org-clock-mode-line-timer | |
1536 | (cancel-timer org-clock-mode-line-timer) | |
1537 | (setq org-clock-mode-line-timer nil)) | |
8bfe682a CD |
1538 | (when org-clock-idle-timer |
1539 | (cancel-timer org-clock-idle-timer) | |
1540 | (setq org-clock-idle-timer nil)) | |
c8d0cf5c CD |
1541 | (setq global-mode-string |
1542 | (delq 'org-mode-line-string global-mode-string)) | |
8223b1d2 | 1543 | (setq frame-title-format org-frame-title-format-backup) |
c8d0cf5c CD |
1544 | (when org-clock-out-switch-to-state |
1545 | (save-excursion | |
1546 | (org-back-to-heading t) | |
ed21c5c8 CD |
1547 | (let ((org-inhibit-logging t) |
1548 | (org-clock-out-when-done nil)) | |
c8d0cf5c CD |
1549 | (cond |
1550 | ((functionp org-clock-out-switch-to-state) | |
1551 | (looking-at org-complex-heading-regexp) | |
1552 | (let ((newstate (funcall org-clock-out-switch-to-state | |
1553 | (match-string 2)))) | |
1554 | (if newstate (org-todo newstate)))) | |
1555 | ((and org-clock-out-switch-to-state | |
3ab2c837 | 1556 | (not (looking-at (concat org-outline-regexp "[ \t]*" |
c8d0cf5c CD |
1557 | org-clock-out-switch-to-state |
1558 | "\\>")))) | |
1559 | (org-todo org-clock-out-switch-to-state)))))) | |
1560 | (force-mode-line-update) | |
271672fa BG |
1561 | (message (concat "Clock stopped at %s after " |
1562 | (org-minutes-to-clocksum-string (+ (* 60 h) m)) "%s") | |
1563 | te (if remove " => LINE REMOVED" "")) | |
1564 | (let ((h org-clock-out-hook)) | |
1565 | ;; If a closing note needs to be stored in the drawer | |
1566 | ;; where clocks are stored, let's temporarily disable | |
1567 | ;; `org-clock-remove-empty-clock-drawer' | |
1568 | (if (and (equal org-clock-into-drawer org-log-into-drawer) | |
1569 | (eq org-log-done 'note) | |
1570 | org-clock-out-when-done) | |
1571 | (setq h (delq 'org-clock-remove-empty-clock-drawer h))) | |
1572 | (mapc (lambda (f) (funcall f)) h)) | |
8223b1d2 | 1573 | (unless (org-clocking-p) |
271672fa | 1574 | (setq org-clock-current-task nil))))))) |
20908596 | 1575 | |
3ab2c837 BG |
1576 | (add-hook 'org-clock-out-hook 'org-clock-remove-empty-clock-drawer) |
1577 | ||
1578 | (defun org-clock-remove-empty-clock-drawer nil | |
1579 | "Remove empty clock drawer in the current subtree." | |
1580 | (let* ((olid (or (org-entry-get (point) "LOG_INTO_DRAWER") | |
1581 | org-log-into-drawer)) | |
1582 | (clock-drawer (if (eq t olid) "LOGBOOK" olid)) | |
1583 | (end (save-excursion (org-end-of-subtree t t)))) | |
1584 | (when clock-drawer | |
1585 | (save-excursion | |
1586 | (org-back-to-heading t) | |
8223b1d2 BG |
1587 | (while (and (< (point) end) |
1588 | (search-forward clock-drawer end t)) | |
3ab2c837 BG |
1589 | (goto-char (match-beginning 0)) |
1590 | (org-remove-empty-drawer-at clock-drawer (point)) | |
1591 | (forward-line 1)))))) | |
1592 | ||
271672fa BG |
1593 | (defun org-clock-timestamps-up (&optional n) |
1594 | "Increase CLOCK timestamps at cursor. | |
1595 | Optional argument N tells to change by that many units." | |
1596 | (interactive "P") | |
1597 | (org-clock-timestamps-change 'up n)) | |
3ab2c837 | 1598 | |
271672fa BG |
1599 | (defun org-clock-timestamps-down (&optional n) |
1600 | "Increase CLOCK timestamps at cursor. | |
1601 | Optional argument N tells to change by that many units." | |
1602 | (interactive "P") | |
1603 | (org-clock-timestamps-change 'down n)) | |
3ab2c837 | 1604 | |
271672fa | 1605 | (defun org-clock-timestamps-change (updown &optional n) |
3ab2c837 | 1606 | "Change CLOCK timestamps synchronously at cursor. |
271672fa BG |
1607 | UPDOWN tells whether to change 'up or 'down. |
1608 | Optional argument N tells to change by that many units." | |
3ab2c837 BG |
1609 | (setq org-ts-what nil) |
1610 | (when (org-at-timestamp-p t) | |
1611 | (let ((tschange (if (eq updown 'up) 'org-timestamp-up | |
1612 | 'org-timestamp-down)) | |
1613 | ts1 begts1 ts2 begts2 updatets1 tdiff) | |
1614 | (save-excursion | |
1615 | (move-beginning-of-line 1) | |
1616 | (re-search-forward org-ts-regexp3 nil t) | |
1617 | (setq ts1 (match-string 0) begts1 (match-beginning 0)) | |
1618 | (when (re-search-forward org-ts-regexp3 nil t) | |
1619 | (setq ts2 (match-string 0) begts2 (match-beginning 0)))) | |
1620 | ;; Are we on the second timestamp? | |
1621 | (if (<= begts2 (point)) (setq updatets1 t)) | |
1622 | (if (not ts2) | |
1623 | ;; fall back on org-timestamp-up if there is only one | |
271672fa | 1624 | (funcall tschange n) |
3ab2c837 | 1625 | ;; setq this so that (boundp 'org-ts-what is non-nil) |
271672fa | 1626 | (funcall tschange n) |
3ab2c837 BG |
1627 | (let ((ts (if updatets1 ts2 ts1)) |
1628 | (begts (if updatets1 begts1 begts2))) | |
1629 | (setq tdiff | |
1630 | (subtract-time | |
1631 | (org-time-string-to-time org-last-changed-timestamp) | |
1632 | (org-time-string-to-time ts))) | |
1633 | (save-excursion | |
1634 | (goto-char begts) | |
1635 | (org-timestamp-change | |
1636 | (round (/ (org-float-time tdiff) | |
1637 | (cond ((eq org-ts-what 'minute) 60) | |
1638 | ((eq org-ts-what 'hour) 3600) | |
1639 | ((eq org-ts-what 'day) (* 24 3600)) | |
1640 | ((eq org-ts-what 'month) (* 24 3600 31)) | |
1641 | ((eq org-ts-what 'year) (* 24 3600 365.2))))) | |
1642 | org-ts-what 'updown))))))) | |
1643 | ||
bdebdb64 | 1644 | ;;;###autoload |
20908596 | 1645 | (defun org-clock-cancel () |
86fbb8ca | 1646 | "Cancel the running clock by removing the start timestamp." |
20908596 | 1647 | (interactive) |
86fbb8ca CD |
1648 | (when (not (org-clocking-p)) |
1649 | (setq global-mode-string | |
8223b1d2 BG |
1650 | (delq 'org-mode-line-string global-mode-string)) |
1651 | (setq frame-title-format org-frame-title-format-backup) | |
86fbb8ca CD |
1652 | (force-mode-line-update) |
1653 | (error "No active clock")) | |
1654 | (save-excursion ; Do not replace this with `with-current-buffer'. | |
8223b1d2 | 1655 | (org-no-warnings (set-buffer (org-clocking-buffer))) |
20908596 | 1656 | (goto-char org-clock-marker) |
8223b1d2 BG |
1657 | (if (org-looking-back (concat "^[ \t]*" org-clock-string ".*")) |
1658 | (progn (delete-region (1- (point-at-bol)) (point-at-eol)) | |
1659 | (org-remove-empty-drawer-at "LOGBOOK" (point))) | |
1660 | (message "Clock gone, cancel the timer anyway") | |
1661 | (sit-for 2))) | |
8bfe682a CD |
1662 | (move-marker org-clock-marker nil) |
1663 | (move-marker org-clock-hd-marker nil) | |
20908596 CD |
1664 | (setq global-mode-string |
1665 | (delq 'org-mode-line-string global-mode-string)) | |
8223b1d2 | 1666 | (setq frame-title-format org-frame-title-format-backup) |
20908596 | 1667 | (force-mode-line-update) |
c8d0cf5c CD |
1668 | (message "Clock canceled") |
1669 | (run-hooks 'org-clock-cancel-hook)) | |
20908596 | 1670 | |
271672fa BG |
1671 | (defcustom org-clock-goto-before-context 2 |
1672 | "Number of lines of context to display before currently clocked-in entry. | |
1673 | This applies when using `org-clock-goto'." | |
1674 | :group 'org-clock | |
1675 | :type 'integer) | |
1676 | ||
bdebdb64 | 1677 | ;;;###autoload |
20908596 | 1678 | (defun org-clock-goto (&optional select) |
c8d0cf5c CD |
1679 | "Go to the currently clocked-in entry, or to the most recently clocked one. |
1680 | With prefix arg SELECT, offer recently clocked tasks for selection." | |
1681 | (interactive "@P") | |
1682 | (let* ((recent nil) | |
1683 | (m (cond | |
1684 | (select | |
1685 | (or (org-clock-select-task "Select task to go to: ") | |
1686 | (error "No task selected"))) | |
ed21c5c8 | 1687 | ((org-clocking-p) org-clock-marker) |
c8d0cf5c CD |
1688 | ((and org-clock-goto-may-find-recent-task |
1689 | (car org-clock-history) | |
1690 | (marker-buffer (car org-clock-history))) | |
1691 | (setq recent t) | |
1692 | (car org-clock-history)) | |
1693 | (t (error "No active or recent clock task"))))) | |
e66ba1df | 1694 | (org-pop-to-buffer-same-window (marker-buffer m)) |
b349f79f | 1695 | (if (or (< m (point-min)) (> m (point-max))) (widen)) |
20908596 CD |
1696 | (goto-char m) |
1697 | (org-show-entry) | |
c8d0cf5c | 1698 | (org-back-to-heading t) |
20908596 | 1699 | (org-cycle-hide-drawers 'children) |
271672fa | 1700 | (recenter org-clock-goto-before-context) |
ed21c5c8 | 1701 | (org-reveal) |
c8d0cf5c CD |
1702 | (if recent |
1703 | (message "No running clock, this is the most recently clocked task")) | |
1704 | (run-hooks 'org-clock-goto-hook))) | |
20908596 CD |
1705 | |
1706 | (defvar org-clock-file-total-minutes nil | |
1707 | "Holds the file total time in minutes, after a call to `org-clock-sum'.") | |
c8d0cf5c | 1708 | (make-variable-buffer-local 'org-clock-file-total-minutes) |
20908596 | 1709 | |
8223b1d2 BG |
1710 | (defun org-clock-sum-today (&optional headline-filter) |
1711 | "Sum the times for each subtree for today." | |
1712 | (interactive) | |
1713 | (let ((range (org-clock-special-range 'today))) | |
1714 | (org-clock-sum (car range) (cadr range) nil :org-clock-minutes-today))) | |
1715 | ||
bdebdb64 | 1716 | ;;;###autoload |
8223b1d2 | 1717 | (defun org-clock-sum (&optional tstart tend headline-filter propname) |
20908596 | 1718 | "Sum the times for each subtree. |
c8d0cf5c | 1719 | Puts the resulting times in minutes as a text property on each headline. |
8223b1d2 BG |
1720 | TSTART and TEND can mark a time range to be considered. |
1721 | HEADLINE-FILTER is a zero-arg function that, if specified, is called for | |
1722 | each headline in the time range with point at the headline. Headlines for | |
1723 | which HEADLINE-FILTER returns nil are excluded from the clock summation. | |
1724 | PROPNAME lets you set a custom text property instead of :org-clock-minutes." | |
20908596 | 1725 | (interactive) |
271672fa | 1726 | (org-with-silent-modifications |
d3517077 BG |
1727 | (let* ((re (concat "^\\(\\*+\\)[ \t]\\|^[ \t]*" |
1728 | org-clock-string | |
1729 | "[ \t]*\\(?:\\(\\[.*?\\]\\)-+\\(\\[.*?\\]\\)\\|=>[ \t]+\\([0-9]+\\):\\([0-9]+\\)\\)")) | |
1730 | (lmax 30) | |
1731 | (ltimes (make-vector lmax 0)) | |
1732 | (t1 0) | |
1733 | (level 0) | |
1734 | ts te dt | |
1735 | time) | |
1736 | (if (stringp tstart) (setq tstart (org-time-string-to-seconds tstart))) | |
1737 | (if (stringp tend) (setq tend (org-time-string-to-seconds tend))) | |
1738 | (if (consp tstart) (setq tstart (org-float-time tstart))) | |
1739 | (if (consp tend) (setq tend (org-float-time tend))) | |
1740 | (remove-text-properties (point-min) (point-max) | |
1741 | `(,(or propname :org-clock-minutes) t | |
1742 | :org-clock-force-headline-inclusion t)) | |
1743 | (save-excursion | |
1744 | (goto-char (point-max)) | |
1745 | (while (re-search-backward re nil t) | |
1746 | (cond | |
1747 | ((match-end 2) | |
1748 | ;; Two time stamps | |
1749 | (setq ts (match-string 2) | |
1750 | te (match-string 3) | |
1751 | ts (org-float-time | |
1752 | (apply 'encode-time (org-parse-time-string ts))) | |
1753 | te (org-float-time | |
1754 | (apply 'encode-time (org-parse-time-string te))) | |
1755 | ts (if tstart (max ts tstart) ts) | |
1756 | te (if tend (min te tend) te) | |
1757 | dt (- te ts) | |
1758 | t1 (if (> dt 0) (+ t1 (floor (/ dt 60))) t1))) | |
1759 | ((match-end 4) | |
1760 | ;; A naked time | |
1761 | (setq t1 (+ t1 (string-to-number (match-string 5)) | |
1762 | (* 60 (string-to-number (match-string 4)))))) | |
1763 | (t ;; A headline | |
1764 | ;; Add the currently clocking item time to the total | |
1765 | (when (and org-clock-report-include-clocking-task | |
1766 | (equal (org-clocking-buffer) (current-buffer)) | |
1767 | (equal (marker-position org-clock-hd-marker) (point)) | |
1768 | tstart | |
1769 | tend | |
1770 | (>= (org-float-time org-clock-start-time) tstart) | |
1771 | (<= (org-float-time org-clock-start-time) tend)) | |
1772 | (let ((time (floor (- (org-float-time) | |
1773 | (org-float-time org-clock-start-time)) 60))) | |
1774 | (setq t1 (+ t1 time)))) | |
1775 | (let* ((headline-forced | |
1776 | (get-text-property (point) | |
1777 | :org-clock-force-headline-inclusion)) | |
1778 | (headline-included | |
1779 | (or (null headline-filter) | |
1780 | (save-excursion | |
1781 | (save-match-data (funcall headline-filter)))))) | |
1782 | (setq level (- (match-end 1) (match-beginning 1))) | |
1783 | (when (or (> t1 0) (> (aref ltimes level) 0)) | |
1784 | (when (or headline-included headline-forced) | |
1785 | (if headline-included | |
1786 | (loop for l from 0 to level do | |
1787 | (aset ltimes l (+ (aref ltimes l) t1)))) | |
1788 | (setq time (aref ltimes level)) | |
1789 | (goto-char (match-beginning 0)) | |
1790 | (put-text-property (point) (point-at-eol) | |
1791 | (or propname :org-clock-minutes) time) | |
1792 | (if headline-filter | |
1793 | (save-excursion | |
1794 | (save-match-data | |
1795 | (while | |
1796 | (> (funcall outline-level) 1) | |
1797 | (outline-up-heading 1 t) | |
1798 | (put-text-property | |
1799 | (point) (point-at-eol) | |
1800 | :org-clock-force-headline-inclusion t)))))) | |
1801 | (setq t1 0) | |
1802 | (loop for l from level to (1- lmax) do | |
1803 | (aset ltimes l 0))))))) | |
1804 | (setq org-clock-file-total-minutes (aref ltimes 0)))))) | |
20908596 | 1805 | |
c8d0cf5c | 1806 | (defun org-clock-sum-current-item (&optional tstart) |
86fbb8ca | 1807 | "Return time, clocked on current item in total." |
c8d0cf5c CD |
1808 | (save-excursion |
1809 | (save-restriction | |
1810 | (org-narrow-to-subtree) | |
1811 | (org-clock-sum tstart) | |
1812 | org-clock-file-total-minutes))) | |
1813 | ||
bdebdb64 | 1814 | ;;;###autoload |
20908596 CD |
1815 | (defun org-clock-display (&optional total-only) |
1816 | "Show subtree times in the entire buffer. | |
1817 | If TOTAL-ONLY is non-nil, only show the total time for the entire file | |
3ab2c837 BG |
1818 | in the echo area. |
1819 | ||
1820 | Use \\[org-clock-remove-overlays] to remove the subtree times." | |
20908596 | 1821 | (interactive) |
0bd48b37 | 1822 | (org-clock-remove-overlays) |
20908596 CD |
1823 | (let (time h m p) |
1824 | (org-clock-sum) | |
1825 | (unless total-only | |
1826 | (save-excursion | |
1827 | (goto-char (point-min)) | |
1828 | (while (or (and (equal (setq p (point)) (point-min)) | |
1829 | (get-text-property p :org-clock-minutes)) | |
1830 | (setq p (next-single-property-change | |
1831 | (point) :org-clock-minutes))) | |
1832 | (goto-char p) | |
1833 | (when (setq time (get-text-property p :org-clock-minutes)) | |
0bd48b37 | 1834 | (org-clock-put-overlay time (funcall outline-level)))) |
20908596 CD |
1835 | (setq h (/ org-clock-file-total-minutes 60) |
1836 | m (- org-clock-file-total-minutes (* 60 h))) | |
1837 | ;; Arrange to remove the overlays upon next change. | |
1838 | (when org-remove-highlights-with-change | |
0bd48b37 | 1839 | (org-add-hook 'before-change-functions 'org-clock-remove-overlays |
20908596 | 1840 | nil 'local)))) |
30cb51f1 BG |
1841 | (message (concat "Total file time: " |
1842 | (org-minutes-to-clocksum-string org-clock-file-total-minutes) | |
1843 | " (%d hours and %d minutes)") h m))) | |
20908596 CD |
1844 | |
1845 | (defvar org-clock-overlays nil) | |
1846 | (make-variable-buffer-local 'org-clock-overlays) | |
1847 | ||
0bd48b37 | 1848 | (defun org-clock-put-overlay (time &optional level) |
20908596 CD |
1849 | "Put an overlays on the current line, displaying TIME. |
1850 | If LEVEL is given, prefix time with a corresponding number of stars. | |
1851 | This creates a new overlay and stores it in `org-clock-overlays', so that it | |
1852 | will be easy to remove." | |
30cb51f1 | 1853 | (let* ((l (if level (org-get-valid-level level 0) 0)) |
20908596 | 1854 | ov tx) |
30cb51f1 BG |
1855 | (beginning-of-line) |
1856 | (when (looking-at org-complex-heading-regexp) | |
1857 | (goto-char (match-beginning 4))) | |
1858 | (setq ov (make-overlay (point) (point-at-eol)) | |
1859 | tx (concat (buffer-substring-no-properties (point) (match-end 4)) | |
1860 | (make-string | |
1861 | (max 0 (- (- 60 (current-column)) | |
1862 | (- (match-end 4) (match-beginning 4)) | |
1863 | (length (org-get-at-bol 'line-prefix)))) ?.) | |
271672fa BG |
1864 | (org-add-props (concat (make-string l ?*) " " |
1865 | (org-minutes-to-clocksum-string time) | |
1866 | (make-string (- 16 l) ?\ )) | |
0bd48b37 | 1867 | (list 'face 'org-clock-overlay)) |
20908596 CD |
1868 | "")) |
1869 | (if (not (featurep 'xemacs)) | |
86fbb8ca CD |
1870 | (overlay-put ov 'display tx) |
1871 | (overlay-put ov 'invisible t) | |
1872 | (overlay-put ov 'end-glyph (make-glyph tx))) | |
20908596 CD |
1873 | (push ov org-clock-overlays))) |
1874 | ||
73d3db82 | 1875 | ;;;###autoload |
0bd48b37 | 1876 | (defun org-clock-remove-overlays (&optional beg end noremove) |
20908596 CD |
1877 | "Remove the occur highlights from the buffer. |
1878 | BEG and END are ignored. If NOREMOVE is nil, remove this function | |
1879 | from the `before-change-functions' in the current buffer." | |
1880 | (interactive) | |
1881 | (unless org-inhibit-highlight-removal | |
86fbb8ca | 1882 | (mapc 'delete-overlay org-clock-overlays) |
20908596 CD |
1883 | (setq org-clock-overlays nil) |
1884 | (unless noremove | |
1885 | (remove-hook 'before-change-functions | |
0bd48b37 | 1886 | 'org-clock-remove-overlays 'local)))) |
20908596 | 1887 | |
23f6720e | 1888 | (defvar org-state) ;; dynamically scoped into this function |
20908596 CD |
1889 | (defun org-clock-out-if-current () |
1890 | "Clock out if the current entry contains the running clock. | |
1891 | This is used to stop the clock after a TODO entry is marked DONE, | |
1892 | and is only done if the variable `org-clock-out-when-done' is not nil." | |
e66ba1df BG |
1893 | (when (and (org-clocking-p) |
1894 | org-clock-out-when-done | |
1895 | (marker-buffer org-clock-marker) | |
ed21c5c8 | 1896 | (or (and (eq t org-clock-out-when-done) |
23f6720e | 1897 | (member org-state org-done-keywords)) |
ed21c5c8 | 1898 | (and (listp org-clock-out-when-done) |
23f6720e | 1899 | (member org-state org-clock-out-when-done))) |
ed21c5c8 CD |
1900 | (equal (or (buffer-base-buffer (org-clocking-buffer)) |
1901 | (org-clocking-buffer)) | |
c8d0cf5c CD |
1902 | (or (buffer-base-buffer (current-buffer)) |
1903 | (current-buffer))) | |
20908596 CD |
1904 | (< (point) org-clock-marker) |
1905 | (> (save-excursion (outline-next-heading) (point)) | |
1906 | org-clock-marker)) | |
1907 | ;; Clock out, but don't accept a logging message for this. | |
ed21c5c8 CD |
1908 | (let ((org-log-note-clock-out nil) |
1909 | (org-clock-out-switch-to-state nil)) | |
20908596 CD |
1910 | (org-clock-out)))) |
1911 | ||
1912 | (add-hook 'org-after-todo-state-change-hook | |
1913 | 'org-clock-out-if-current) | |
1914 | ||
1915 | ;;;###autoload | |
bdebdb64 | 1916 | (defun org-clock-get-clocktable (&rest props) |
20908596 CD |
1917 | "Get a formatted clocktable with parameters according to PROPS. |
1918 | The table is created in a temporary buffer, fully formatted and | |
1919 | fontified, and then returned." | |
1920 | ;; Set the defaults | |
1921 | (setq props (plist-put props :name "clocktable")) | |
1922 | (unless (plist-member props :maxlevel) | |
1923 | (setq props (plist-put props :maxlevel 2))) | |
1924 | (unless (plist-member props :scope) | |
1925 | (setq props (plist-put props :scope 'agenda))) | |
1926 | (with-temp-buffer | |
1927 | (org-mode) | |
1928 | (org-create-dblock props) | |
1929 | (org-update-dblock) | |
6711a21f | 1930 | (org-font-lock-ensure) |
20908596 CD |
1931 | (forward-line 2) |
1932 | (buffer-substring (point) (progn | |
acedf35c | 1933 | (re-search-forward "^[ \t]*#\\+END" nil t) |
20908596 CD |
1934 | (point-at-bol))))) |
1935 | ||
bdebdb64 | 1936 | ;;;###autoload |
20908596 CD |
1937 | (defun org-clock-report (&optional arg) |
1938 | "Create a table containing a report about clocked time. | |
1939 | If the cursor is inside an existing clocktable block, then the table | |
3ab2c837 BG |
1940 | will be updated. If not, a new clocktable will be inserted. The scope |
1941 | of the new clock will be subtree when called from within a subtree, and | |
1942 | file elsewhere. | |
1943 | ||
20908596 CD |
1944 | When called with a prefix argument, move to the first clock table in the |
1945 | buffer and update it." | |
1946 | (interactive "P") | |
0bd48b37 | 1947 | (org-clock-remove-overlays) |
20908596 CD |
1948 | (when arg |
1949 | (org-find-dblock "clocktable") | |
1950 | (org-show-entry)) | |
1951 | (if (org-in-clocktable-p) | |
1952 | (goto-char (org-in-clocktable-p)) | |
3ab2c837 BG |
1953 | (let ((props (if (ignore-errors |
1954 | (save-excursion (org-back-to-heading))) | |
1955 | (list :name "clocktable" :scope 'subtree) | |
1956 | (list :name "clocktable")))) | |
1957 | (org-create-dblock | |
1958 | (org-combine-plists org-clock-clocktable-default-properties props)))) | |
20908596 CD |
1959 | (org-update-dblock)) |
1960 | ||
acedf35c CD |
1961 | (defun org-day-of-week (day month year) |
1962 | "Returns the day of the week as an integer." | |
1963 | (nth 6 | |
1964 | (decode-time | |
1965 | (date-to-time | |
1966 | (format "%d-%02d-%02dT00:00:00" year month day))))) | |
1967 | ||
1968 | (defun org-quarter-to-date (quarter year) | |
1969 | "Get the date (week day year) of the first day of a given quarter." | |
1970 | (let (startday) | |
1971 | (cond | |
1972 | ((= quarter 1) | |
1973 | (setq startday (org-day-of-week 1 1 year)) | |
1974 | (cond | |
1975 | ((= startday 0) | |
1976 | (list 52 7 (- year 1))) | |
1977 | ((= startday 6) | |
1978 | (list 52 6 (- year 1))) | |
1979 | ((<= startday 4) | |
1980 | (list 1 startday year)) | |
1981 | ((> startday 4) | |
1982 | (list 53 startday (- year 1))) | |
1983 | ) | |
1984 | ) | |
1985 | ((= quarter 2) | |
1986 | (setq startday (org-day-of-week 1 4 year)) | |
1987 | (cond | |
1988 | ((= startday 0) | |
1989 | (list 13 startday year)) | |
1990 | ((< startday 4) | |
1991 | (list 14 startday year)) | |
1992 | ((>= startday 4) | |
1993 | (list 13 startday year)) | |
1994 | ) | |
1995 | ) | |
1996 | ((= quarter 3) | |
1997 | (setq startday (org-day-of-week 1 7 year)) | |
1998 | (cond | |
1999 | ((= startday 0) | |
2000 | (list 26 startday year)) | |
2001 | ((< startday 4) | |
2002 | (list 27 startday year)) | |
2003 | ((>= startday 4) | |
2004 | (list 26 startday year)) | |
2005 | ) | |
2006 | ) | |
2007 | ((= quarter 4) | |
2008 | (setq startday (org-day-of-week 1 10 year)) | |
2009 | (cond | |
2010 | ((= startday 0) | |
2011 | (list 39 startday year)) | |
2012 | ((<= startday 4) | |
2013 | (list 40 startday year)) | |
2014 | ((> startday 4) | |
2015 | (list 39 startday year))))))) | |
2016 | ||
271672fa | 2017 | (defun org-clock-special-range (key &optional time as-strings wstart mstart) |
20908596 CD |
2018 | "Return two times bordering a special time range. |
2019 | Key is a symbol specifying the range and can be one of `today', `yesterday', | |
2020 | `thisweek', `lastweek', `thismonth', `lastmonth', `thisyear', `lastyear'. | |
271672fa BG |
2021 | By default, a week starts Monday 0:00 and ends Sunday 24:00. |
2022 | The range is determined relative to TIME, which defaults to current time. | |
20908596 | 2023 | The return value is a cons cell with two internal times like the ones |
271672fa BG |
2024 | returned by `current time' or `encode-time'. |
2025 | If AS-STRINGS is non-nil, the returned times will be formatted strings. | |
2026 | If WSTART is non-nil, use this number to specify the starting day of a | |
2027 | week (monday is 1). | |
2028 | If MSTART is non-nil, use this number to specify the starting day of a | |
2029 | month (1 is the first day of the month). | |
2030 | If you can combine both, the month starting day will have priority." | |
20908596 CD |
2031 | (if (integerp key) (setq key (intern (number-to-string key)))) |
2032 | (let* ((tm (decode-time (or time (current-time)))) | |
2033 | (s 0) (m (nth 1 tm)) (h (nth 2 tm)) | |
2034 | (d (nth 3 tm)) (month (nth 4 tm)) (y (nth 5 tm)) | |
2035 | (dow (nth 6 tm)) | |
271672fa BG |
2036 | (ws (or wstart 1)) |
2037 | (ms (or mstart 1)) | |
20908596 CD |
2038 | (skey (symbol-name key)) |
2039 | (shift 0) | |
acedf35c CD |
2040 | (q (cond ((>= (nth 4 tm) 10) 4) |
2041 | ((>= (nth 4 tm) 7) 3) | |
2042 | ((>= (nth 4 tm) 4) 2) | |
2043 | ((>= (nth 4 tm) 1) 1))) | |
2044 | s1 m1 h1 d1 month1 y1 diff ts te fm txt w date | |
2045 | interval tmp shiftedy shiftedm shiftedq) | |
20908596 CD |
2046 | (cond |
2047 | ((string-match "^[0-9]+$" skey) | |
2048 | (setq y (string-to-number skey) m 1 d 1 key 'year)) | |
2049 | ((string-match "^\\([0-9]+\\)-\\([0-9]\\{1,2\\}\\)$" skey) | |
2050 | (setq y (string-to-number (match-string 1 skey)) | |
2051 | month (string-to-number (match-string 2 skey)) | |
2052 | d 1 key 'month)) | |
2053 | ((string-match "^\\([0-9]+\\)-[wW]\\([0-9]\\{1,2\\}\\)$" skey) | |
2054 | (require 'cal-iso) | |
2055 | (setq y (string-to-number (match-string 1 skey)) | |
2056 | w (string-to-number (match-string 2 skey))) | |
2057 | (setq date (calendar-gregorian-from-absolute | |
2058 | (calendar-absolute-from-iso (list w 1 y)))) | |
2059 | (setq d (nth 1 date) month (car date) y (nth 2 date) | |
d6685abc | 2060 | dow 1 |
20908596 | 2061 | key 'week)) |
8223b1d2 BG |
2062 | ((string-match "^\\([0-9]+\\)-[qQ]\\([1-4]\\)$" skey) |
2063 | (require 'cal-iso) | |
2064 | (setq y (string-to-number (match-string 1 skey))) | |
2065 | (setq q (string-to-number (match-string 2 skey))) | |
2066 | (setq date (calendar-gregorian-from-absolute | |
2067 | (calendar-absolute-from-iso (org-quarter-to-date q y)))) | |
2068 | (setq d (nth 1 date) month (car date) y (nth 2 date) | |
acedf35c CD |
2069 | dow 1 |
2070 | key 'quarter)) | |
20908596 CD |
2071 | ((string-match "^\\([0-9]+\\)-\\([0-9]\\{1,2\\}\\)-\\([0-9]\\{1,2\\}\\)$" skey) |
2072 | (setq y (string-to-number (match-string 1 skey)) | |
2073 | month (string-to-number (match-string 2 skey)) | |
2074 | d (string-to-number (match-string 3 skey)) | |
2075 | key 'day)) | |
2076 | ((string-match "\\([-+][0-9]+\\)$" skey) | |
2077 | (setq shift (string-to-number (match-string 1 skey)) | |
acedf35c | 2078 | key (intern (substring skey 0 (match-beginning 1)))) |
8223b1d2 BG |
2079 | (if (and (memq key '(quarter thisq)) (> shift 0)) |
2080 | (error "Looking forward with quarters isn't implemented")))) | |
acedf35c | 2081 | |
2c3ad40d | 2082 | (when (= shift 0) |
8223b1d2 | 2083 | (cond ((eq key 'yesterday) (setq key 'today shift -1)) |
acedf35c CD |
2084 | ((eq key 'lastweek) (setq key 'week shift -1)) |
2085 | ((eq key 'lastmonth) (setq key 'month shift -1)) | |
2086 | ((eq key 'lastyear) (setq key 'year shift -1)) | |
2087 | ((eq key 'lastq) (setq key 'quarter shift -1)))) | |
20908596 CD |
2088 | (cond |
2089 | ((memq key '(day today)) | |
2090 | (setq d (+ d shift) h 0 m 0 h1 24 m1 0)) | |
2091 | ((memq key '(week thisweek)) | |
271672fa | 2092 | (setq diff (+ (* -7 shift) (if (= dow 0) (- 7 ws) (- dow ws))) |
20908596 CD |
2093 | m 0 h 0 d (- d diff) d1 (+ 7 d))) |
2094 | ((memq key '(month thismonth)) | |
271672fa BG |
2095 | (setq d (or ms 1) h 0 m 0 d1 (or ms 1) |
2096 | month (+ month shift) month1 (1+ month) h1 0 m1 0)) | |
acedf35c | 2097 | ((memq key '(quarter thisq)) |
271672fa BG |
2098 | ;; Compute if this shift remains in this year. If not, compute |
2099 | ;; how many years and quarters we have to shift (via floor*) and | |
2100 | ;; compute the shifted years, months and quarters. | |
acedf35c CD |
2101 | (cond |
2102 | ((< (+ (- q 1) shift) 0) ; shift not in this year | |
8223b1d2 | 2103 | (setq interval (* -1 (+ (- q 1) shift))) |
271672fa | 2104 | ;; Set tmp to ((years to shift) (quarters to shift)). |
8223b1d2 | 2105 | (setq tmp (org-floor* interval 4)) |
271672fa | 2106 | ;; Due to the use of floor, 0 quarters actually means 4. |
8223b1d2 BG |
2107 | (if (= 0 (nth 1 tmp)) |
2108 | (setq shiftedy (- y (nth 0 tmp)) | |
2109 | shiftedm 1 | |
2110 | shiftedq 1) | |
2111 | (setq shiftedy (- y (+ 1 (nth 0 tmp))) | |
2112 | shiftedm (- 13 (* 3 (nth 1 tmp))) | |
2113 | shiftedq (- 5 (nth 1 tmp)))) | |
2114 | (setq d 1 h 0 m 0 d1 1 month shiftedm month1 (+ 3 shiftedm) h1 0 m1 0 y shiftedy)) | |
ee7683eb | 2115 | ((> (+ q shift) 0) ; shift is within this year |
8223b1d2 BG |
2116 | (setq shiftedq (+ q shift)) |
2117 | (setq shiftedy y) | |
2118 | (setq d 1 h 0 m 0 d1 1 month (+ 1 (* 3 (- (+ q shift) 1))) month1 (+ 4 (* 3 (- (+ q shift) 1))) h1 0 m1 0)))) | |
20908596 CD |
2119 | ((memq key '(year thisyear)) |
2120 | (setq m 0 h 0 d 1 month 1 y (+ y shift) y1 (1+ y))) | |
2121 | (t (error "No such time block %s" key))) | |
2122 | (setq ts (encode-time s m h d month y) | |
2123 | te (encode-time (or s1 s) (or m1 m) (or h1 h) | |
2124 | (or d1 d) (or month1 month) (or y1 y))) | |
2125 | (setq fm (cdr org-time-stamp-formats)) | |
2126 | (cond | |
2127 | ((memq key '(day today)) | |
2128 | (setq txt (format-time-string "%A, %B %d, %Y" ts))) | |
2129 | ((memq key '(week thisweek)) | |
2130 | (setq txt (format-time-string "week %G-W%V" ts))) | |
2131 | ((memq key '(month thismonth)) | |
2132 | (setq txt (format-time-string "%B %Y" ts))) | |
2133 | ((memq key '(year thisyear)) | |
acedf35c CD |
2134 | (setq txt (format-time-string "the year %Y" ts))) |
2135 | ((memq key '(quarter thisq)) | |
271672fa | 2136 | (setq txt (concat (org-count-quarter shiftedq) " quarter of " (number-to-string shiftedy))))) |
20908596 CD |
2137 | (if as-strings |
2138 | (list (format-time-string fm ts) (format-time-string fm te) txt) | |
2139 | (list ts te txt)))) | |
2140 | ||
acedf35c CD |
2141 | (defun org-count-quarter (n) |
2142 | (cond | |
2143 | ((= n 1) "1st") | |
2144 | ((= n 2) "2nd") | |
2145 | ((= n 3) "3rd") | |
2146 | ((= n 4) "4th"))) | |
2147 | ||
73d3db82 | 2148 | ;;;###autoload |
20908596 CD |
2149 | (defun org-clocktable-shift (dir n) |
2150 | "Try to shift the :block date of the clocktable at point. | |
2151 | Point must be in the #+BEGIN: line of a clocktable, or this function | |
2152 | will throw an error. | |
2153 | DIR is a direction, a symbol `left', `right', `up', or `down'. | |
2154 | Both `left' and `down' shift the block toward the past, `up' and `right' | |
2155 | push it toward the future. | |
2156 | N is the number of shift steps to take. The size of the step depends on | |
2157 | the currently selected interval size." | |
2158 | (setq n (prefix-numeric-value n)) | |
2159 | (and (memq dir '(left down)) (setq n (- n))) | |
2160 | (save-excursion | |
2161 | (goto-char (point-at-bol)) | |
acedf35c | 2162 | (if (not (looking-at "^[ \t]*#\\+BEGIN:[ \t]+clocktable\\>.*?:block[ \t]+\\(\\S-+\\)")) |
20908596 CD |
2163 | (error "Line needs a :block definition before this command works") |
2164 | (let* ((b (match-beginning 1)) (e (match-end 1)) | |
2165 | (s (match-string 1)) | |
2166 | block shift ins y mw d date wp m) | |
2c3ad40d CD |
2167 | (cond |
2168 | ((equal s "yesterday") (setq s "today-1")) | |
2169 | ((equal s "lastweek") (setq s "thisweek-1")) | |
2170 | ((equal s "lastmonth") (setq s "thismonth-1")) | |
acedf35c CD |
2171 | ((equal s "lastyear") (setq s "thisyear-1")) |
2172 | ((equal s "lastq") (setq s "thisq-1"))) | |
2173 | ||
8223b1d2 BG |
2174 | (cond |
2175 | ((string-match "^\\(today\\|thisweek\\|thismonth\\|thisyear\\|thisq\\)\\([-+][0-9]+\\)?$" s) | |
2176 | (setq block (match-string 1 s) | |
2177 | shift (if (match-end 2) | |
2178 | (string-to-number (match-string 2 s)) | |
2179 | 0)) | |
2180 | (setq shift (+ shift n)) | |
2181 | (setq ins (if (= shift 0) block (format "%s%+d" block shift)))) | |
2182 | ((string-match "\\([0-9]+\\)\\(-\\([wWqQ]?\\)\\([0-9]\\{1,2\\}\\)\\(-\\([0-9]\\{1,2\\}\\)\\)?\\)?" s) | |
2183 | ;; 1 1 2 3 3 4 4 5 6 6 5 2 | |
2184 | (setq y (string-to-number (match-string 1 s)) | |
2185 | wp (and (match-end 3) (match-string 3 s)) | |
2186 | mw (and (match-end 4) (string-to-number (match-string 4 s))) | |
2187 | d (and (match-end 6) (string-to-number (match-string 6 s)))) | |
2188 | (cond | |
2189 | (d (setq ins (format-time-string | |
2190 | "%Y-%m-%d" | |
2191 | (encode-time 0 0 0 (+ d n) m y)))) | |
2192 | ((and wp (string-match "w\\|W" wp) mw (> (length wp) 0)) | |
2193 | (require 'cal-iso) | |
2194 | (setq date (calendar-gregorian-from-absolute | |
2195 | (calendar-absolute-from-iso (list (+ mw n) 1 y)))) | |
2196 | (setq ins (format-time-string | |
2197 | "%G-W%V" | |
2198 | (encode-time 0 0 0 (nth 1 date) (car date) (nth 2 date))))) | |
2199 | ((and wp (string-match "q\\|Q" wp) mw (> (length wp) 0)) | |
2200 | (require 'cal-iso) | |
2201 | ; if the 4th + 1 quarter is requested we flip to the 1st quarter of the next year | |
2202 | (if (> (+ mw n) 4) | |
2203 | (setq mw 0 | |
2204 | y (+ 1 y)) | |
2205 | ()) | |
2206 | ; if the 1st - 1 quarter is requested we flip to the 4th quarter of the previous year | |
2207 | (if (= (+ mw n) 0) | |
2208 | (setq mw 5 | |
2209 | y (- y 1)) | |
2210 | ()) | |
2211 | (setq date (calendar-gregorian-from-absolute | |
2212 | (calendar-absolute-from-iso (org-quarter-to-date (+ mw n) y)))) | |
2213 | (setq ins (format-time-string | |
2214 | (concat (number-to-string y) "-Q" (number-to-string (+ mw n))) | |
2215 | (encode-time 0 0 0 (nth 1 date) (car date) (nth 2 date))))) | |
2216 | (mw | |
2217 | (setq ins (format-time-string | |
2218 | "%Y-%m" | |
2219 | (encode-time 0 0 0 1 (+ mw n) y)))) | |
2220 | (y | |
2221 | (setq ins (number-to-string (+ y n)))))) | |
2222 | (t (error "Cannot shift clocktable block"))) | |
2223 | (when ins | |
2224 | (goto-char b) | |
2225 | (insert ins) | |
2226 | (delete-region (point) (+ (point) (- e b))) | |
2227 | (beginning-of-line 1) | |
2228 | (org-update-dblock) | |
2229 | t))))) | |
20908596 | 2230 | |
bdebdb64 | 2231 | ;;;###autoload |
20908596 CD |
2232 | (defun org-dblock-write:clocktable (params) |
2233 | "Write the standard clocktable." | |
acedf35c | 2234 | (setq params (org-combine-plists org-clocktable-defaults params)) |
20908596 | 2235 | (catch 'exit |
acedf35c CD |
2236 | (let* ((scope (plist-get params :scope)) |
2237 | (block (plist-get params :block)) | |
20908596 CD |
2238 | (ts (plist-get params :tstart)) |
2239 | (te (plist-get params :tend)) | |
20908596 | 2240 | (link (plist-get params :link)) |
acedf35c | 2241 | (maxlevel (or (plist-get params :maxlevel) 3)) |
271672fa BG |
2242 | (ws (plist-get params :wstart)) |
2243 | (ms (plist-get params :mstart)) | |
acedf35c CD |
2244 | (step (plist-get params :step)) |
2245 | (timestamp (plist-get params :timestamp)) | |
2246 | (formatter (or (plist-get params :formatter) | |
2247 | org-clock-clocktable-formatter | |
2248 | 'org-clocktable-write-default)) | |
2249 | cc range-text ipos pos one-file-with-archives | |
2250 | scope-is-list tbls level) | |
acedf35c CD |
2251 | ;; Check if we need to do steps |
2252 | (when block | |
2253 | ;; Get the range text for the header | |
271672fa | 2254 | (setq cc (org-clock-special-range block nil t ws ms) |
acedf35c | 2255 | ts (car cc) te (nth 1 cc) range-text (nth 2 cc))) |
20908596 | 2256 | (when step |
acedf35c | 2257 | ;; Write many tables, in steps |
20908596 CD |
2258 | (unless (or block (and ts te)) |
2259 | (error "Clocktable `:step' can only be used with `:block' or `:tstart,:end'")) | |
2260 | (org-clocktable-steps params) | |
2261 | (throw 'exit nil)) | |
acedf35c CD |
2262 | |
2263 | (setq ipos (point)) ; remember the insertion position | |
20908596 CD |
2264 | |
2265 | ;; Get the right scope | |
2266 | (setq pos (point)) | |
2267 | (cond | |
2268 | ((and scope (listp scope) (symbolp (car scope))) | |
2269 | (setq scope (eval scope))) | |
2270 | ((eq scope 'agenda) | |
2271 | (setq scope (org-agenda-files t))) | |
2272 | ((eq scope 'agenda-with-archives) | |
2273 | (setq scope (org-agenda-files t)) | |
2274 | (setq scope (org-add-archive-files scope))) | |
2275 | ((eq scope 'file-with-archives) | |
2276 | (setq scope (org-add-archive-files (list (buffer-file-name))) | |
acedf35c | 2277 | one-file-with-archives t))) |
20908596 | 2278 | (setq scope-is-list (and scope (listp scope))) |
acedf35c CD |
2279 | (if scope-is-list |
2280 | ;; we collect from several files | |
20908596 | 2281 | (let* ((files scope) |
20908596 | 2282 | file) |
8223b1d2 | 2283 | (org-agenda-prepare-buffers files) |
20908596 CD |
2284 | (while (setq file (pop files)) |
2285 | (with-current-buffer (find-buffer-visiting file) | |
acedf35c CD |
2286 | (save-excursion |
2287 | (save-restriction | |
2288 | (push (org-clock-get-table-data file params) tbls)))))) | |
2289 | ;; Just from the current file | |
2290 | (save-restriction | |
2291 | ;; get the right range into the restriction | |
8223b1d2 | 2292 | (org-agenda-prepare-buffers (list (buffer-file-name))) |
acedf35c CD |
2293 | (cond |
2294 | ((not scope)) ; use the restriction as it is now | |
2295 | ((eq scope 'file) (widen)) | |
2296 | ((eq scope 'subtree) (org-narrow-to-subtree)) | |
2297 | ((eq scope 'tree) | |
2298 | (while (org-up-heading-safe)) | |
2299 | (org-narrow-to-subtree)) | |
2300 | ((and (symbolp scope) (string-match "^tree\\([0-9]+\\)$" | |
2301 | (symbol-name scope))) | |
2302 | (setq level (string-to-number (match-string 1 (symbol-name scope)))) | |
2303 | (catch 'exit | |
2304 | (while (org-up-heading-safe) | |
3ab2c837 | 2305 | (looking-at org-outline-regexp) |
acedf35c CD |
2306 | (if (<= (org-reduced-level (funcall outline-level)) level) |
2307 | (throw 'exit nil)))) | |
2308 | (org-narrow-to-subtree))) | |
2309 | ;; do the table, with no file name. | |
2310 | (push (org-clock-get-table-data nil params) tbls))) | |
2311 | ||
2312 | ;; OK, at this point we tbls as a list of tables, one per file | |
2313 | (setq tbls (nreverse tbls)) | |
2314 | ||
2315 | (setq params (plist-put params :multifile scope-is-list)) | |
2316 | (setq params (plist-put params :one-file-with-archives | |
2317 | one-file-with-archives)) | |
2318 | ||
2319 | (funcall formatter ipos tbls params)))) | |
2320 | ||
2321 | (defun org-clocktable-write-default (ipos tables params) | |
2322 | "Write out a clock table at position IPOS in the current buffer. | |
2323 | TABLES is a list of tables with clocking data as produced by | |
2324 | `org-clock-get-table-data'. PARAMS is the parameter property list obtained | |
27e428e7 | 2325 | from the dynamic block definition." |
3ab2c837 BG |
2326 | ;; This function looks quite complicated, mainly because there are a |
2327 | ;; lot of options which can add or remove columns. I have massively | |
2328 | ;; commented this function, the I hope it is understandable. If | |
2329 | ;; someone wants to write their own special formatter, this maybe | |
2330 | ;; much easier because there can be a fixed format with a | |
2331 | ;; well-defined number of columns... | |
acedf35c | 2332 | (let* ((hlchars '((1 . "*") (2 . "/"))) |
3ab2c837 | 2333 | (lwords (assoc (or (plist-get params :lang) |
271672fa BG |
2334 | (org-bound-and-true-p org-export-default-language) |
2335 | "en") | |
3ab2c837 | 2336 | org-clock-clocktable-language-setup)) |
acedf35c CD |
2337 | (multifile (plist-get params :multifile)) |
2338 | (block (plist-get params :block)) | |
2339 | (ts (plist-get params :tstart)) | |
2340 | (te (plist-get params :tend)) | |
2341 | (header (plist-get params :header)) | |
2342 | (narrow (plist-get params :narrow)) | |
271672fa BG |
2343 | (ws (or (plist-get params :wstart) 1)) |
2344 | (ms (or (plist-get params :mstart) 1)) | |
acedf35c CD |
2345 | (link (plist-get params :link)) |
2346 | (maxlevel (or (plist-get params :maxlevel) 3)) | |
2347 | (emph (plist-get params :emphasize)) | |
2348 | (level-p (plist-get params :level)) | |
271672fa BG |
2349 | (org-time-clocksum-use-effort-durations |
2350 | (plist-get params :effort-durations)) | |
acedf35c | 2351 | (timestamp (plist-get params :timestamp)) |
3ab2c837 | 2352 | (properties (plist-get params :properties)) |
acedf35c CD |
2353 | (ntcol (max 1 (or (plist-get params :tcolumns) 100))) |
2354 | (rm-file-column (plist-get params :one-file-with-archives)) | |
2355 | (indent (plist-get params :indent)) | |
8223b1d2 | 2356 | (case-fold-search t) |
acedf35c CD |
2357 | range-text total-time tbl level hlc formula pcol |
2358 | file-time entries entry headline | |
2359 | recalc content narrow-cut-p tcol) | |
2360 | ||
2361 | ;; Implement abbreviations | |
2362 | (when (plist-get params :compact) | |
2363 | (setq level nil indent t narrow (or narrow '40!) ntcol 1)) | |
2364 | ||
2365 | ;; Some consistency test for parameters | |
8223b1d2 BG |
2366 | (unless (integerp ntcol) |
2367 | (setq params (plist-put params :tcolumns (setq ntcol 100)))) | |
acedf35c | 2368 | |
8223b1d2 BG |
2369 | (when (and narrow (integerp narrow) link) |
2370 | ;; We cannot have both integer narrow and link | |
2371 | (message | |
2372 | "Using hard narrowing in clocktable to allow for links") | |
2373 | (setq narrow (intern (format "%d!" narrow)))) | |
acedf35c | 2374 | |
8223b1d2 BG |
2375 | (when narrow |
2376 | (cond | |
2377 | ((integerp narrow)) | |
2378 | ((and (symbolp narrow) | |
2379 | (string-match "\\`[0-9]+!\\'" (symbol-name narrow))) | |
2380 | (setq narrow-cut-p t | |
2381 | narrow (string-to-number (substring (symbol-name narrow) | |
2382 | 0 -1)))) | |
2383 | (t | |
2384 | (error "Invalid value %s of :narrow property in clock table" | |
2385 | narrow)))) | |
acedf35c | 2386 | |
8223b1d2 BG |
2387 | (when block |
2388 | ;; Get the range text for the header | |
271672fa | 2389 | (setq range-text (nth 2 (org-clock-special-range block nil t ws ms)))) |
8223b1d2 BG |
2390 | |
2391 | ;; Compute the total time | |
2392 | (setq total-time (apply '+ (mapcar 'cadr tables))) | |
2393 | ||
2394 | ;; Now we need to output this tsuff | |
2395 | (goto-char ipos) | |
2396 | ||
2397 | ;; Insert the text *before* the actual table | |
2398 | (insert-before-markers | |
2399 | (or header | |
2400 | ;; Format the standard header | |
2401 | (concat | |
271672fa | 2402 | "#+CAPTION: " |
8223b1d2 BG |
2403 | (nth 9 lwords) " [" |
2404 | (substring | |
2405 | (format-time-string (cdr org-time-stamp-formats)) | |
2406 | 1 -1) | |
2407 | "]" | |
2408 | (if block (concat ", for " range-text ".") "") | |
271672fa | 2409 | "\n"))) |
8223b1d2 BG |
2410 | |
2411 | ;; Insert the narrowing line | |
2412 | (when (and narrow (integerp narrow) (not narrow-cut-p)) | |
acedf35c | 2413 | (insert-before-markers |
8223b1d2 BG |
2414 | "|" ; table line starter |
2415 | (if multifile "|" "") ; file column, maybe | |
2416 | (if level-p "|" "") ; level column, maybe | |
2417 | (if timestamp "|" "") ; timestamp column, maybe | |
3ab2c837 | 2418 | (if properties (make-string (length properties) ?|) "") ;properties columns, maybe |
8223b1d2 BG |
2419 | (format "<%d>| |\n" narrow))) ; headline and time columns |
2420 | ||
2421 | ;; Insert the table header line | |
2422 | (insert-before-markers | |
2423 | "|" ; table line starter | |
2424 | (if multifile (concat (nth 1 lwords) "|") "") ; file column, maybe | |
2425 | (if level-p (concat (nth 2 lwords) "|") "") ; level column, maybe | |
2426 | (if timestamp (concat (nth 3 lwords) "|") "") ; timestamp column, maybe | |
2427 | (if properties (concat (mapconcat 'identity properties "|") "|") "") ;properties columns, maybe | |
2428 | (concat (nth 4 lwords) "|" | |
2429 | (nth 5 lwords) "|\n")) ; headline and time columns | |
2430 | ||
2431 | ;; Insert the total time in the table | |
2432 | (insert-before-markers | |
2433 | "|-\n" ; a hline | |
2434 | "|" ; table line starter | |
2435 | (if multifile (concat "| " (nth 6 lwords) " ") "") | |
2436 | ; file column, maybe | |
2437 | (if level-p "|" "") ; level column, maybe | |
2438 | (if timestamp "|" "") ; timestamp column, maybe | |
2439 | (if properties (make-string (length properties) ?|) "") ; properties columns, maybe | |
2440 | (concat (format org-clock-total-time-cell-format (nth 7 lwords)) "| ") ; instead of a headline | |
2441 | (format org-clock-total-time-cell-format | |
271672fa | 2442 | (org-minutes-to-clocksum-string (or total-time 0))) ; the time |
8223b1d2 BG |
2443 | "|\n") ; close line |
2444 | ||
2445 | ;; Now iterate over the tables and insert the data | |
2446 | ;; but only if any time has been collected | |
2447 | (when (and total-time (> total-time 0)) | |
2448 | ||
2449 | (while (setq tbl (pop tables)) | |
2450 | ;; now tbl is the table resulting from one file. | |
2451 | (setq file-time (nth 1 tbl)) | |
2452 | (when (or (and file-time (> file-time 0)) | |
2453 | (not (plist-get params :fileskip0))) | |
2454 | (insert-before-markers "|-\n") ; a hline because a new file starts | |
2455 | ;; First the file time, if we have multiple files | |
2456 | (when multifile | |
2457 | ;; Summarize the time collected from this file | |
2458 | (insert-before-markers | |
2459 | (format (concat "| %s %s | %s%s" | |
2460 | (format org-clock-file-time-cell-format (nth 8 lwords)) | |
2461 | " | *%s*|\n") | |
2462 | (file-name-nondirectory (car tbl)) | |
2463 | (if level-p "| " "") ; level column, maybe | |
2464 | (if timestamp "| " "") ; timestamp column, maybe | |
2465 | (if properties (make-string (length properties) ?|) "") ;properties columns, maybe | |
271672fa | 2466 | (org-minutes-to-clocksum-string (nth 1 tbl))))) ; the time |
8223b1d2 BG |
2467 | |
2468 | ;; Get the list of node entries and iterate over it | |
2469 | (setq entries (nth 2 tbl)) | |
2470 | (while (setq entry (pop entries)) | |
2471 | (setq level (car entry) | |
2472 | headline (nth 1 entry) | |
2473 | hlc (if emph (or (cdr (assoc level hlchars)) "") "")) | |
2474 | (when narrow-cut-p | |
2475 | (if (and (string-match (concat "\\`" org-bracket-link-regexp | |
2476 | "\\'") | |
2477 | headline) | |
2478 | (match-end 3)) | |
2479 | (setq headline | |
2480 | (format "[[%s][%s]]" | |
2481 | (match-string 1 headline) | |
2482 | (org-shorten-string (match-string 3 headline) | |
2483 | narrow))) | |
2484 | (setq headline (org-shorten-string headline narrow)))) | |
2485 | (insert-before-markers | |
2486 | "|" ; start the table line | |
2487 | (if multifile "|" "") ; free space for file name column? | |
2488 | (if level-p (format "%d|" (car entry)) "") ; level, maybe | |
2489 | (if timestamp (concat (nth 2 entry) "|") "") ; timestamp, maybe | |
2490 | (if properties | |
2491 | (concat | |
2492 | (mapconcat | |
2493 | (lambda (p) (or (cdr (assoc p (nth 4 entry))) "")) | |
2494 | properties "|") "|") "") ;properties columns, maybe | |
2495 | (if indent (org-clocktable-indent-string level) "") ; indentation | |
2496 | hlc headline hlc "|" ; headline | |
2497 | (make-string (min (1- ntcol) (or (- level 1))) ?|) | |
acedf35c | 2498 | ; empty fields for higher levels |
271672fa | 2499 | hlc (org-minutes-to-clocksum-string (nth 3 entry)) hlc ; time |
8223b1d2 BG |
2500 | "|\n" ; close line |
2501 | ))))) | |
2502 | ;; When exporting subtrees or regions the region might be | |
2503 | ;; activated, so let's disable ̀delete-active-region' | |
2504 | (let ((delete-active-region nil)) (backward-delete-char 1)) | |
2505 | (if (setq formula (plist-get params :formula)) | |
2506 | (cond | |
2507 | ((eq formula '%) | |
2508 | ;; compute the column where the % numbers need to go | |
2509 | (setq pcol (+ 2 | |
2510 | (if multifile 1 0) | |
2511 | (if level-p 1 0) | |
2512 | (if timestamp 1 0) | |
2513 | (min maxlevel (or ntcol 100)))) | |
2514 | ;; compute the column where the total time is | |
2515 | (setq tcol (+ 2 | |
2516 | (if multifile 1 0) | |
2517 | (if level-p 1 0) | |
2518 | (if timestamp 1 0))) | |
2519 | (insert | |
2520 | (format | |
2521 | "\n#+TBLFM: $%d='(org-clock-time%% @%d$%d $%d..$%d);%%.1f" | |
2522 | pcol ; the column where the % numbers should go | |
2523 | (if (and narrow (not narrow-cut-p)) 3 2) ; row of the total time | |
2524 | tcol ; column of the total time | |
2525 | tcol (1- pcol) ; range of columns where times can be found | |
2526 | )) | |
2527 | (setq recalc t)) | |
2528 | ((stringp formula) | |
2529 | (insert "\n#+TBLFM: " formula) | |
2530 | (setq recalc t)) | |
2531 | (t (error "Invalid formula in clocktable"))) | |
2532 | ;; Should we rescue an old formula? | |
2533 | (when (stringp (setq content (plist-get params :content))) | |
2534 | (when (string-match "^\\([ \t]*#\\+tblfm:.*\\)" content) | |
2535 | (setq recalc t) | |
2536 | (insert "\n" (match-string 1 (plist-get params :content))) | |
2537 | (beginning-of-line 0)))) | |
2538 | ;; Back to beginning, align the table, recalculate if necessary | |
2539 | (goto-char ipos) | |
2540 | (skip-chars-forward "^|") | |
2541 | (org-table-align) | |
2542 | (when org-hide-emphasis-markers | |
2543 | ;; we need to align a second time | |
2544 | (org-table-align)) | |
2545 | (when recalc | |
2546 | (if (eq formula '%) | |
2547 | (save-excursion | |
2548 | (if (and narrow (not narrow-cut-p)) (beginning-of-line 2)) | |
2549 | (org-table-goto-column pcol nil 'force) | |
2550 | (insert "%"))) | |
2551 | (org-table-recalculate 'all)) | |
2552 | (when rm-file-column | |
2553 | ;; The file column is actually not wanted | |
2554 | (forward-char 1) | |
2555 | (org-table-delete-column)) | |
2556 | total-time)) | |
acedf35c CD |
2557 | |
2558 | (defun org-clocktable-indent-string (level) | |
2559 | (if (= level 1) | |
2560 | "" | |
2561 | (let ((str "\\__")) | |
2562 | (while (> level 2) | |
2563 | (setq level (1- level) | |
2564 | str (concat str "___"))) | |
2565 | (concat str " ")))) | |
20908596 CD |
2566 | |
2567 | (defun org-clocktable-steps (params) | |
acedf35c | 2568 | "Step through the range to make a number of clock tables." |
20908596 CD |
2569 | (let* ((p1 (copy-sequence params)) |
2570 | (ts (plist-get p1 :tstart)) | |
2571 | (te (plist-get p1 :tend)) | |
271672fa BG |
2572 | (ws (plist-get p1 :wstart)) |
2573 | (ms (plist-get p1 :mstart)) | |
20908596 CD |
2574 | (step0 (plist-get p1 :step)) |
2575 | (step (cdr (assoc step0 '((day . 86400) (week . 604800))))) | |
86fbb8ca | 2576 | (stepskip0 (plist-get p1 :stepskip0)) |
20908596 | 2577 | (block (plist-get p1 :block)) |
271672fa | 2578 | cc range-text step-time tsb) |
20908596 | 2579 | (when block |
271672fa | 2580 | (setq cc (org-clock-special-range block nil t ws ms) |
20908596 | 2581 | ts (car cc) te (nth 1 cc) range-text (nth 2 cc))) |
afe98dfa CD |
2582 | (cond |
2583 | ((numberp ts) | |
2584 | ;; If ts is a number, it's an absolute day number from org-agenda. | |
2585 | (destructuring-bind (month day year) (calendar-gregorian-from-absolute ts) | |
2586 | (setq ts (org-float-time (encode-time 0 0 0 day month year))))) | |
2587 | (ts | |
2588 | (setq ts (org-float-time | |
2589 | (apply 'encode-time (org-parse-time-string ts)))))) | |
2590 | (cond | |
2591 | ((numberp te) | |
2592 | ;; Likewise for te. | |
2593 | (destructuring-bind (month day year) (calendar-gregorian-from-absolute te) | |
2594 | (setq te (org-float-time (encode-time 0 0 0 day month year))))) | |
2595 | (te | |
2596 | (setq te (org-float-time | |
2597 | (apply 'encode-time (org-parse-time-string te)))))) | |
271672fa BG |
2598 | (setq tsb |
2599 | (if (eq step0 'week) | |
2600 | (- ts (* 86400 (- (nth 6 (decode-time (seconds-to-time ts))) ws))) | |
2601 | ts)) | |
20908596 CD |
2602 | (setq p1 (plist-put p1 :header "")) |
2603 | (setq p1 (plist-put p1 :step nil)) | |
2604 | (setq p1 (plist-put p1 :block nil)) | |
271672fa | 2605 | (while (< tsb te) |
20908596 CD |
2606 | (or (bolp) (insert "\n")) |
2607 | (setq p1 (plist-put p1 :tstart (format-time-string | |
c8d0cf5c | 2608 | (org-time-stamp-format nil t) |
271672fa | 2609 | (seconds-to-time (max tsb ts))))) |
20908596 | 2610 | (setq p1 (plist-put p1 :tend (format-time-string |
c8d0cf5c | 2611 | (org-time-stamp-format nil t) |
271672fa | 2612 | (seconds-to-time (min te (setq tsb (+ tsb step))))))) |
acedf35c CD |
2613 | (insert "\n" (if (eq step0 'day) "Daily report: " |
2614 | "Weekly report starting on: ") | |
20908596 | 2615 | (plist-get p1 :tstart) "\n") |
86fbb8ca | 2616 | (setq step-time (org-dblock-write:clocktable p1)) |
acedf35c | 2617 | (re-search-forward "^[ \t]*#\\+END:") |
86fbb8ca CD |
2618 | (when (and (equal step-time 0) stepskip0) |
2619 | ;; Remove the empty table | |
2620 | (delete-region (point-at-bol) | |
2621 | (save-excursion | |
acedf35c CD |
2622 | (re-search-backward "^\\(Daily\\|Weekly\\) report" |
2623 | nil t) | |
86fbb8ca | 2624 | (point)))) |
20908596 CD |
2625 | (end-of-line 0)))) |
2626 | ||
acedf35c CD |
2627 | (defun org-clock-get-table-data (file params) |
2628 | "Get the clocktable data for file FILE, with parameters PARAMS. | |
2629 | FILE is only for identification - this function assumes that | |
2630 | the correct buffer is current, and that the wanted restriction is | |
2631 | in place. | |
2632 | The return value will be a list with the file name and the total | |
2633 | file time (in minutes) as 1st and 2nd elements. The third element | |
2634 | of this list will be a list of headline entries. Each entry has the | |
2635 | following structure: | |
2636 | ||
2637 | (LEVEL HEADLINE TIMESTAMP TIME) | |
2638 | ||
2639 | LEVEL: The level of the headline, as an integer. This will be | |
2640 | the reduced leve, so 1,2,3,... even if only odd levels | |
2641 | are being used. | |
2642 | HEADLINE: The text of the headline. Depending on PARAMS, this may | |
2643 | already be formatted like a link. | |
2644 | TIMESTAMP: If PARAMS require it, this will be a time stamp found in the | |
2645 | entry, any of SCHEDULED, DEADLINE, NORMAL, or first inactive, | |
2646 | in this sequence. | |
2647 | TIME: The sum of all time spend in this tree, in minutes. This time | |
2648 | will of cause be restricted to the time block and tags match | |
2649 | specified in PARAMS." | |
2650 | (let* ((maxlevel (or (plist-get params :maxlevel) 3)) | |
2651 | (timestamp (plist-get params :timestamp)) | |
2652 | (ts (plist-get params :tstart)) | |
2653 | (te (plist-get params :tend)) | |
271672fa BG |
2654 | (ws (plist-get params :wstart)) |
2655 | (ms (plist-get params :mstart)) | |
acedf35c CD |
2656 | (block (plist-get params :block)) |
2657 | (link (plist-get params :link)) | |
2658 | (tags (plist-get params :tags)) | |
3ab2c837 BG |
2659 | (properties (plist-get params :properties)) |
2660 | (inherit-property-p (plist-get params :inherit-props)) | |
153ae947 | 2661 | todo-only |
acedf35c CD |
2662 | (matcher (if tags (cdr (org-make-tags-matcher tags)))) |
2663 | cc range-text st p time level hdl props tsp tbl) | |
2664 | ||
2665 | (setq org-clock-file-total-minutes nil) | |
2666 | (when block | |
271672fa | 2667 | (setq cc (org-clock-special-range block nil t ws ms) |
acedf35c CD |
2668 | ts (car cc) te (nth 1 cc) range-text (nth 2 cc))) |
2669 | (when (integerp ts) (setq ts (calendar-gregorian-from-absolute ts))) | |
2670 | (when (integerp te) (setq te (calendar-gregorian-from-absolute te))) | |
2671 | (when (and ts (listp ts)) | |
2672 | (setq ts (format "%4d-%02d-%02d" (nth 2 ts) (car ts) (nth 1 ts)))) | |
2673 | (when (and te (listp te)) | |
2674 | (setq te (format "%4d-%02d-%02d" (nth 2 te) (car te) (nth 1 te)))) | |
2675 | ;; Now the times are strings we can parse. | |
2676 | (if ts (setq ts (org-float-time | |
271672fa | 2677 | (seconds-to-time (org-matcher-time ts))))) |
acedf35c | 2678 | (if te (setq te (org-float-time |
271672fa | 2679 | (seconds-to-time (org-matcher-time te))))) |
acedf35c CD |
2680 | (save-excursion |
2681 | (org-clock-sum ts te | |
2682 | (unless (null matcher) | |
2683 | (lambda () | |
8223b1d2 BG |
2684 | (let* ((tags-list (org-get-tags-at)) |
2685 | (org-scanner-tags tags-list) | |
2686 | (org-trust-scanner-tags t)) | |
acedf35c CD |
2687 | (eval matcher))))) |
2688 | (goto-char (point-min)) | |
2689 | (setq st t) | |
2690 | (while (or (and (bobp) (prog1 st (setq st nil)) | |
2691 | (get-text-property (point) :org-clock-minutes) | |
2692 | (setq p (point-min))) | |
2693 | (setq p (next-single-property-change | |
2694 | (point) :org-clock-minutes))) | |
2695 | (goto-char p) | |
2696 | (when (setq time (get-text-property p :org-clock-minutes)) | |
2697 | (save-excursion | |
2698 | (beginning-of-line 1) | |
2699 | (when (and (looking-at (org-re "\\(\\*+\\)[ \t]+\\(.*?\\)\\([ \t]+:[[:alnum:]_@#%:]+:\\)?[ \t]*$")) | |
2700 | (setq level (org-reduced-level | |
2701 | (- (match-end 1) (match-beginning 1)))) | |
2702 | (<= level maxlevel)) | |
2703 | (setq hdl (if (not link) | |
2704 | (match-string 2) | |
2705 | (org-make-link-string | |
2706 | (format "file:%s::%s" | |
2707 | (buffer-file-name) | |
2708 | (save-match-data | |
30cb51f1 BG |
2709 | (match-string 2))) |
2710 | (org-make-org-heading-search-string | |
2711 | (replace-regexp-in-string | |
2712 | org-bracket-link-regexp | |
2713 | (lambda (m) (or (match-string 3 m) | |
2714 | (match-string 1 m))) | |
2715 | (match-string 2))))) | |
acedf35c CD |
2716 | tsp (when timestamp |
2717 | (setq props (org-entry-properties (point))) | |
2718 | (or (cdr (assoc "SCHEDULED" props)) | |
2719 | (cdr (assoc "DEADLINE" props)) | |
2720 | (cdr (assoc "TIMESTAMP" props)) | |
3ab2c837 | 2721 | (cdr (assoc "TIMESTAMP_IA" props)))) |
8223b1d2 BG |
2722 | props (when properties |
2723 | (remove nil | |
2724 | (mapcar | |
2725 | (lambda (p) | |
2726 | (when (org-entry-get (point) p inherit-property-p) | |
2727 | (cons p (org-entry-get (point) p inherit-property-p)))) | |
2728 | properties)))) | |
3ab2c837 | 2729 | (when (> time 0) (push (list level hdl tsp time props) tbl)))))) |
acedf35c CD |
2730 | (setq tbl (nreverse tbl)) |
2731 | (list file org-clock-file-total-minutes tbl)))) | |
20908596 | 2732 | |
93b62de8 CD |
2733 | (defun org-clock-time% (total &rest strings) |
2734 | "Compute a time fraction in percent. | |
2735 | TOTAL s a time string like 10:21 specifying the total times. | |
2736 | STRINGS is a list of strings that should be checked for a time. | |
2737 | The first string that does have a time will be used. | |
2738 | This function is made for clock tables." | |
2739 | (let ((re "\\([0-9]+\\):\\([0-9]+\\)") | |
2740 | tot s) | |
2741 | (save-match-data | |
2742 | (catch 'exit | |
2743 | (if (not (string-match re total)) | |
2744 | (throw 'exit 0.) | |
2745 | (setq tot (+ (string-to-number (match-string 2 total)) | |
2746 | (* 60 (string-to-number (match-string 1 total))))) | |
2747 | (if (= tot 0.) (throw 'exit 0.))) | |
2748 | (while (setq s (pop strings)) | |
2749 | (if (string-match "\\([0-9]+\\):\\([0-9]+\\)" s) | |
2750 | (throw 'exit | |
2751 | (/ (* 100.0 (+ (string-to-number (match-string 2 s)) | |
acedf35c CD |
2752 | (* 60 (string-to-number |
2753 | (match-string 1 s))))) | |
93b62de8 CD |
2754 | tot)))) |
2755 | 0)))) | |
2756 | ||
3ab2c837 BG |
2757 | ;; Saving and loading the clock |
2758 | ||
8bfe682a CD |
2759 | (defvar org-clock-loaded nil |
2760 | "Was the clock file loaded?") | |
2761 | ||
73d3db82 | 2762 | ;;;###autoload |
bdebdb64 BG |
2763 | (defun org-clock-update-time-maybe () |
2764 | "If this is a CLOCK line, update it and return t. | |
2765 | Otherwise, return nil." | |
2766 | (interactive) | |
2767 | (save-excursion | |
2768 | (beginning-of-line 1) | |
2769 | (skip-chars-forward " \t") | |
2770 | (when (looking-at org-clock-string) | |
2771 | (let ((re (concat "[ \t]*" org-clock-string | |
2772 | " *[[<]\\([^]>]+\\)[]>]\\(-+[[<]\\([^]>]+\\)[]>]" | |
2773 | "\\([ \t]*=>.*\\)?\\)?")) | |
2774 | ts te h m s neg) | |
2775 | (cond | |
2776 | ((not (looking-at re)) | |
2777 | nil) | |
2778 | ((not (match-end 2)) | |
2779 | (when (and (equal (marker-buffer org-clock-marker) (current-buffer)) | |
2780 | (> org-clock-marker (point)) | |
2781 | (<= org-clock-marker (point-at-eol))) | |
2782 | ;; The clock is running here | |
2783 | (setq org-clock-start-time | |
2784 | (apply 'encode-time | |
2785 | (org-parse-time-string (match-string 1)))) | |
2786 | (org-clock-update-mode-line))) | |
2787 | (t | |
2788 | (and (match-end 4) (delete-region (match-beginning 4) (match-end 4))) | |
2789 | (end-of-line 1) | |
2790 | (setq ts (match-string 1) | |
2791 | te (match-string 3)) | |
2792 | (setq s (- (org-float-time | |
2793 | (apply 'encode-time (org-parse-time-string te))) | |
2794 | (org-float-time | |
2795 | (apply 'encode-time (org-parse-time-string ts)))) | |
2796 | neg (< s 0) | |
2797 | s (abs s) | |
2798 | h (floor (/ s 3600)) | |
2799 | s (- s (* 3600 h)) | |
2800 | m (floor (/ s 60)) | |
2801 | s (- s (* 60 s))) | |
2802 | (insert " => " (format (if neg "-%d:%02d" "%2d:%02d") h m)) | |
2803 | t)))))) | |
2804 | ||
93b62de8 | 2805 | (defun org-clock-save () |
ce4fdcb9 CD |
2806 | "Persist various clock-related data to disk. |
2807 | The details of what will be saved are regulated by the variable | |
2808 | `org-clock-persist'." | |
8bfe682a CD |
2809 | (when (and org-clock-persist |
2810 | (or org-clock-loaded | |
2811 | org-clock-has-been-used | |
2812 | (not (file-exists-p org-clock-persist-file)))) | |
ce4fdcb9 CD |
2813 | (let (b) |
2814 | (with-current-buffer (find-file (expand-file-name org-clock-persist-file)) | |
2815 | (progn | |
2816 | (delete-region (point-min) (point-max)) | |
2817 | ;;Store clock | |
2818 | (insert (format ";; org-persist.el - %s at %s\n" | |
2819 | system-name (format-time-string | |
2820 | (cdr org-time-stamp-formats)))) | |
8bfe682a | 2821 | (if (and (memq org-clock-persist '(t clock)) |
ed21c5c8 | 2822 | (setq b (org-clocking-buffer)) |
ce4fdcb9 CD |
2823 | (setq b (or (buffer-base-buffer b) b)) |
2824 | (buffer-live-p b) | |
2825 | (buffer-file-name b) | |
2826 | (or (not org-clock-persist-query-save) | |
2827 | (y-or-n-p (concat "Save current clock (" | |
271672fa | 2828 | org-clock-heading ") ")))) |
ce4fdcb9 | 2829 | (insert "(setq resume-clock '(\"" |
ed21c5c8 | 2830 | (buffer-file-name (org-clocking-buffer)) |
ce4fdcb9 CD |
2831 | "\" . " (int-to-string (marker-position org-clock-marker)) |
2832 | "))\n")) | |
8223b1d2 | 2833 | ;; Store clocked task history. Tasks are stored reversed to make |
ce4fdcb9 | 2834 | ;; reading simpler |
8bfe682a CD |
2835 | (when (and (memq org-clock-persist '(t history)) |
2836 | org-clock-history) | |
ce4fdcb9 CD |
2837 | (insert |
2838 | "(setq stored-clock-history '(" | |
2839 | (mapconcat | |
2840 | (lambda (m) | |
2841 | (when (and (setq b (marker-buffer m)) | |
2842 | (setq b (or (buffer-base-buffer b) b)) | |
2843 | (buffer-live-p b) | |
2844 | (buffer-file-name b)) | |
2845 | (concat "(\"" (buffer-file-name b) | |
2846 | "\" . " (int-to-string (marker-position m)) | |
2847 | ")"))) | |
2848 | (reverse org-clock-history) " ") "))\n")) | |
2849 | (save-buffer) | |
2850 | (kill-buffer (current-buffer))))))) | |
2851 | ||
93b62de8 | 2852 | (defun org-clock-load () |
c8d0cf5c | 2853 | "Load clock-related data from disk, maybe resuming a stored clock." |
ce4fdcb9 CD |
2854 | (when (and org-clock-persist (not org-clock-loaded)) |
2855 | (let ((filename (expand-file-name org-clock-persist-file)) | |
2856 | (org-clock-in-resume 'auto-restart) | |
2857 | resume-clock stored-clock-history) | |
2858 | (if (not (file-readable-p filename)) | |
93b62de8 | 2859 | (message "Not restoring clock data; %s not found" |
ce4fdcb9 CD |
2860 | org-clock-persist-file) |
2861 | (message "%s" "Restoring clock data") | |
2862 | (setq org-clock-loaded t) | |
2863 | (load-file filename) | |
2864 | ;; load history | |
2865 | (when stored-clock-history | |
2866 | (save-window-excursion | |
2867 | (mapc (lambda (task) | |
2868 | (if (file-exists-p (car task)) | |
2869 | (org-clock-history-push (cdr task) | |
2870 | (find-file (car task))))) | |
2871 | stored-clock-history))) | |
2872 | ;; resume clock | |
2873 | (when (and resume-clock org-clock-persist | |
2874 | (file-exists-p (car resume-clock)) | |
2875 | (or (not org-clock-persist-query-resume) | |
ff4be292 | 2876 | (y-or-n-p |
ce4fdcb9 CD |
2877 | (concat |
2878 | "Resume clock (" | |
2879 | (with-current-buffer (find-file (car resume-clock)) | |
2880 | (save-excursion | |
2881 | (goto-char (cdr resume-clock)) | |
2882 | (org-back-to-heading t) | |
2883 | (and (looking-at org-complex-heading-regexp) | |
2884 | (match-string 4)))) | |
2885 | ") ")))) | |
2886 | (when (file-exists-p (car resume-clock)) | |
2887 | (with-current-buffer (find-file (car resume-clock)) | |
2888 | (goto-char (cdr resume-clock)) | |
8bfe682a CD |
2889 | (let ((org-clock-auto-clock-resolution nil)) |
2890 | (org-clock-in) | |
3ab2c837 | 2891 | (if (outline-invisible-p) |
8bfe682a | 2892 | (org-show-context)))))))))) |
93b62de8 | 2893 | |
c8d0cf5c CD |
2894 | ;; Suggested bindings |
2895 | (org-defkey org-mode-map "\C-c\C-x\C-e" 'org-clock-modify-effort-estimate) | |
2896 | ||
20908596 CD |
2897 | (provide 'org-clock) |
2898 | ||
bdebdb64 BG |
2899 | ;; Local variables: |
2900 | ;; generated-autoload-file: "org-loaddefs.el" | |
2901 | ;; End: | |
2902 | ||
b349f79f | 2903 | ;;; org-clock.el ends here |