todo-mode.el 18.7 KB
Newer Older
1 2
;;; todomode.el -- Major mode for editing TODO list files
;;; Copyright (C) 1997 by Oliver Seidel
Oliver Seidel's avatar
Oliver Seidel committed
3 4 5

;; ---------------------------------------------------------------------------

6 7 8 9 10 11 12
;;
;; Author:       Oliver.Seidel@cl.cam.ac.uk (was valid on Aug 2, 1997)
;; Created:      August 2, 1997
;; Version:      $Id: todomode.el,v 1.11 1997/08/06 09:14:25 os10000 Exp os10000 $
;; Keywords:     Categorised TODO list editor, todo-mode
;; Availability: newsgroup "gnu.emacs.sources" and archives thereof
;;
Oliver Seidel's avatar
Oliver Seidel committed
13

14
;; ---------------------------------------------------------------------------
15

16 17 18 19
;;
;; This program is intended for use with GNU Emacs.
;;
;; This program is free software; you can redistribute it and/or modify
20 21 22
;; it under the terms of the GNU General Public License as published by
;; the Free Software Foundation; either version 2, or (at your option)
;; any later version.
23 24
;;
;; This program is distributed in the hope that it will be useful,
25 26 27
;; but WITHOUT ANY WARRANTY; without even the implied warranty of
;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
;; GNU General Public License for more details.
28
;;
29 30 31 32
;; You should have received a copy of the GNU General Public License
;; along with GNU Emacs; see the file COPYING.  If not, write to the
;; Free Software Foundation, Inc., 59 Temple Place - Suite 330,
;; Boston, MA 02111-1307, USA.
33
;;
34 35 36

;; ---------------------------------------------------------------------------

Oliver Seidel's avatar
Oliver Seidel committed
37
;;
38 39
;; Quickstart Installation:
;; ========================
40
;;
41
;; To get this to work, make emacs execute the line
42
;;
43
;; (require 'todomode)				;; load the TODO package
44
;;
45 46
;; I would also recommend executing the following commands
;; so as to extend the bindings in your global keymap:
47
;;
48 49
;; (global-set-key "\C-ct" 'todo-show)		;; switch to TODO buffer
;; (global-set-key "\C-ci" 'todo-cmd-inst)	;; insert new item
Oliver Seidel's avatar
Oliver Seidel committed
50
;;
51
;;
Oliver Seidel's avatar
Oliver Seidel committed
52
;;
53
;; Description:
54
;; ============
55
;;
56 57 58 59 60 61
;; TODO is a major mode for EMACS which offers functionality to treat
;; most lines in one buffer as a list of items one has to do.  There
;; are facilities to add new items, which are categorised, to edit or
;; even delete items from the buffer.  The buffer contents are currently
;; compatible with the diary, so that the list of todo-items will show
;; up in the FANCY diary mode.
62
;;
63 64 65 66 67 68 69 70 71 72 73
;; Notice:  Besides the major mode, this file also exports the function
;; "todo-show" which will change to the one specific TODO file that has
;; been specified in the todo-file-do variable.  If this file does not
;; conform to the TODO mode conventions, the todo-show function will add
;; the appropriate header and footer.  I don't anticipate this to cause
;; much grief, but be warned, in case you attempt to read a plain text file.
;;
;;
;;
;; Operation:
;; ==========
74 75
;;
;; You will have the following facilities available:
76
;;
77 78
;; M-x todo-show              will enter the todo list screen, here type
;;
79 80
;; +                          to go to next category
;; -                          to go to previous category
81
;; e                          to edit the current entry
82 83
;; f                          to file the current entry, including a
;;                                                 comment and timestamp
84 85
;; i                          to insert a new entry
;; k                          to kill the current entry
86
;; l                          to lower the current entry's priority
87 88 89
;; n                          for the next entry
;; p                          for the previous entry
;; q                          to save the list and exit the buffer
90
;; r                          to raise the current entry's priority
91
;; s                          to save the list
92
;;
93 94 95 96 97 98
;; When you add a new entry, you are asked for the text and then for the
;; category.  I for example have categories for things that I want to do
;; in the office (like mail my mum), that I want to do in town (like buy
;; cornflakes) and things I want to do at home (move my suitcases).  The
;; categories can be selected with the cursor keys and if you type in the
;; name of a category which didn't exist before, an empty category of the
99
;; desired name will be added and filled with the new entry.
100
;;
101 102
;;
;;
103 104
;; Configuration:
;; ==============
105
;;
106 107 108 109 110
;; --- todo-prefix
;;
;; I would like to recommend that you use the prefix "*/*" (by
;; leaving the variable 'todo-prefix' untouched) so that the diary
;; displays each entry every day.
111
;;
112 113 114 115
;; To understand what I mean, please read the documentation that goes
;; with the calendar since that will tell you how you can set up the
;; fancy diary display and use the #include command to include your
;; todo list file as part of your diary.
116
;;
117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143
;;
;; --- todo-file-do
;;
;; This variable is fairly self-explanatory.  You have to store your TODO
;; list somewhere.  This variable tells the package where to go and find
;; this file.
;;
;;
;; --- todo-file-done
;;
;; Even when you're done, you may wish to retain the entries.  Given
;; that they're timestamped and you are offered to add a comment, this
;; can make a useful diary of past events.  It will even blend in with
;; the EMACS diary package.  So anyway, this variable holds the name
;; of the file for the filed todo-items.
;;
;;
;; --- todo-mode-hook
;;
;; Just like other modes, too, this mode offers to call your functions
;; before it goes about its business.  This variable will be inspected
;; for any functions you may wish to have called once the other TODO
;; mode preparations have been completed.
;;
;;
;; --- todo-ins-thresh
;;
144 145 146 147 148 149 150 151 152 153 154 155 156 157 158
;; Another nifty feature is the insertion accuracy.  If you have 8 items
;; in your TODO list, then you may get asked 4 questions by the binary
;; insertion algorithm.  However, you may not really have a need for such
;; accurate priorities amongst your TODO items.  If you now think about
;; the binary insertion halfing the size of the window each time, then
;; the threshhold is the window size at which it will stop.  If you set
;; the threshhold to zero, the upper and lower bound will coincide at the
;; end of the loop and you will insert your item just before that point.
;; If you set the threshhold to i.e. 8, it will stop as soon as the window
;; size drops below that amount and will insert the item in the approximate
;; centre of that window.  I got the idea for this feature after reading
;; a very helpful e-mail reply from Trey Jackson <tjackson@ichips.intel.com>
;; who corrected some of my awful coding and pointed me towards some good
;; reading.  Thanks Trey!
;;
159 160 161 162 163
;;
;;
;; History and Gossip:
;; ===================
;;
164 165 166 167
;; Many thanks to all the ones who have contributed to the evolution of this
;; package!  I hope I have listed all of you somewhere in the documentation
;; or at least in the RCS history!
;;
168 169 170 171 172 173 174 175
;; Just for the case that you are wondering about the ugly name of this
;; package: I am one of those unfortunate people who have DOS, LINUX and
;; OS/2 on one of their computers, so part of my home-filespace is shared
;; and stored on a DOS partition, which is accessible to all systems.  If
;; you wish, you can of course rename the name of the file (and the "provide"
;; command near the end of this package) to something more aisthetically
;; (please don't argue about this spelling ...) pleasing, like i.e. todo-mode.
;;
176 177
;; Enjoy this package and express your gratitude by sending nice things
;; to my parents' address!
178 179
;;
;; Oliver Seidel
180
;;
181
;; (O Seidel, Lessingstr. 8, 65760 Eschborn, Federal Republic of Germany)
182 183 184 185 186 187
;;

;; ---------------------------------------------------------------------------

;;
;; $Log: todomode.el,v $
188 189 190 191
;; Revision 1.11  1997/08/06  09:14:25  os10000
;; Applied patch from Istvan Marko <istvan@cmdmail.amd.com>
;; to make menus work anywhere.
;;
192 193 194 195
;; Revision 1.10  1997/08/06  08:56:03  os10000
;; Acted upon suggestion from Shane Holder <holder@rsn.hp.com>:
;; Cancelling the editing of an entry will not delete it any more.
;;
196 197 198 199 200
;; Revision 1.9  1997/08/06 08:12:03  os10000
;; Improved documentation.  Broke some lines to comply with
;; Richard Stallman's email to please keep in sync with the
;; rest of the Emacs distribution files.
;;
201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228
;; Revision 1.8  1997/08/05 22:39:04  os10000
;; Made todomode.el available under GPL.
;;
;; Revision 1.7  1997/08/05 22:34:14  os10000
;; Fixed insertion routine with help from Trey Jackson
;; <tjackson@ichips.intel.com>; added todo-ins-thresh;
;; fixed keyboard layout to remove unwanted keys.
;;
;; Revision 1.6  1997/08/05 16:47:01  os10000
;; Incorporated menus for XEmacs from Allan.Cochrane@soton.sc.philips.com,
;; fixed TYPO, fixed todo-file-cmd, cleaned up rcs history.
;;
;; Revision 1.5  1997/08/05  14:43:39  os10000
;; Added improvements from Ron Gut <rgut@aware.com>.
;; Added category management.
;;
;; Revision 1.4  1997/08/04  16:18:45  os10000
;; Added Raise/Lower item.
;;
;; Revision 1.3  1997/08/03  12:47:26  os10000
;; Cleaned up variables, prefix and cursor position.
;;
;; Revision 1.2  1997/08/03 12:15:28  os10000
;; It appears to work.
;;
;; Revision 1.1  1997/08/03 12:15:13  os10000
;; Initial revision
;;
229 230 231

;; ---------------------------------------------------------------------------

Oliver Seidel's avatar
Oliver Seidel committed
232 233
;; User-configurable variables:

234 235 236 237 238
(defvar todo-prefix	"*/*"		"TODO mode prefix for entries.")
(defvar todo-file-do	"~/.todo-do"	"TODO mode list file.")
(defvar todo-file-done	"~/.todo-done"	"TODO mode archive file.")
(defvar todo-mode-hook	nil		"TODO mode hooks.")
(defvar todo-ins-thresh	0		"TODO mode insertion accuracy.")
Oliver Seidel's avatar
Oliver Seidel committed
239 240 241

;; ---------------------------------------------------------------------------

242 243
;; Get some outside help ...

Oliver Seidel's avatar
Oliver Seidel committed
244
(require 'time-stamp)
245 246 247
(require 'easymenu)

;; ---------------------------------------------------------------------------
Oliver Seidel's avatar
Oliver Seidel committed
248

249 250 251 252 253 254 255 256 257 258
;; Set up some helpful context ...

(defvar todo-cats		nil	"TODO categories.")
(defvar todo-prv-lne		0	"previous line that I asked about.")
(defvar todo-prv-ans		0	"previous answer that I got.")
(defvar todo-mode-map		nil	"TODO mode keymap.")
(defvar todo-category-number	0	"TODO category number.")

;; ---------------------------------------------------------------------------

259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275
(if todo-mode-map
    nil
  (let ((map (make-keymap)))
    (suppress-keymap map t)
    (define-key map "+" 'todo-cmd-forw)
    (define-key map "-" 'todo-cmd-back)
    (define-key map "e" 'todo-cmd-edit)
    (define-key map "f" 'todo-cmd-file)
    (define-key map "i" 'todo-cmd-inst)
    (define-key map "k" 'todo-cmd-kill)
    (define-key map "l" 'todo-cmd-lowr)
    (define-key map "n" 'todo-cmd-next)
    (define-key map "p" 'todo-cmd-prev)
    (define-key map "q" 'todo-cmd-done)
    (define-key map "r" 'todo-cmd-rais)
    (define-key map "s" 'todo-cmd-save)
    (setq todo-mode-map map)))
Oliver Seidel's avatar
Oliver Seidel committed
276

277 278
(defun todo-cat-slct ()
  (let ((todo-category-name (nth todo-category-number todo-cats)))
279 280
    (setq mode-line-buffer-identification
	  (concat "Category: " todo-category-name))
281 282 283 284 285 286
    (widen)
    (goto-char (point-min))
    (search-forward (concat "--- " todo-category-name))
    (setq begin (+ (point-at-eol) 1))
    (search-forward "--- End")
    (narrow-to-region begin (point-at-bol))
287
    (goto-char (point-min))))
288 289 290 291 292 293

(defun todo-cmd-forw () "Go forward to TODO list of next category."
  (interactive)
  (let ((todo-cat-cnt (- (length todo-cats) 1)))
    (setq todo-category-number (if (< todo-category-number todo-cat-cnt)
				   (+ todo-category-number 1) 0))
294
    (todo-cat-slct)))
295 296 297 298 299 300

(defun todo-cmd-back () "Go back to TODO list of previous category."
  (interactive)
  (let ((todo-cat-cnt (- (length todo-cats) 1)))
    (setq todo-category-number (if (> todo-category-number 0)
				   (- todo-category-number 1) todo-cat-cnt))
301
    (todo-cat-slct)))
302 303

(defun todo-cmd-prev () "Select previous entry of TODO list."
Oliver Seidel's avatar
Oliver Seidel committed
304 305 306
  (interactive)
  (forward-line -1)
  (beginning-of-line nil)
307
  (message ""))
Oliver Seidel's avatar
Oliver Seidel committed
308

309
(defun todo-cmd-next () "Select next entry of TODO list."
Oliver Seidel's avatar
Oliver Seidel committed
310 311 312
  (interactive)
  (forward-line 1)
  (beginning-of-line nil)
313
  (message ""))
Oliver Seidel's avatar
Oliver Seidel committed
314

315 316
(defun todo-cmd-save () "Save the TODO list."
  (interactive)
317
  (save-buffer))
318 319

(defun todo-cmd-done () "Done with TODO list for now."
Oliver Seidel's avatar
Oliver Seidel committed
320
  (interactive)
321 322
  (widen)
  (save-buffer)
323 324
  (beginning-of-line nil)
  (message "")
325
  (bury-buffer))
Oliver Seidel's avatar
Oliver Seidel committed
326

327 328
(defun todo-line () "Find current line in buffer."
  (buffer-substring (point-at-bol) (point-at-eol)))
Oliver Seidel's avatar
Oliver Seidel committed
329

330
(defun todo-cmd-edit () "Edit current TODO list entry."
Oliver Seidel's avatar
Oliver Seidel committed
331
  (interactive)
332
  (let ((todo-entry (read-from-minibuffer "Edit: " (todo-line))))
333
    (delete-region (point-at-bol) (point-at-eol))
334
    (insert todo-entry)
335
    (beginning-of-line nil)
336
    (message "")))
Oliver Seidel's avatar
Oliver Seidel committed
337

338
(defun todo-add-category (cat) "Add a new category to the TODO list."
Oliver Seidel's avatar
Oliver Seidel committed
339 340
  (interactive)
  (save-window-excursion
341
    (setq todo-cats (cons cat todo-cats))
Oliver Seidel's avatar
Oliver Seidel committed
342
    (find-file todo-file-do)
343 344 345 346
    (widen)
    (goto-char (point-min))
    (let ((posn (search-forward "-*- mode: todo; " 17 t)))
      (if (not (null posn)) (goto-char posn))
347 348 349 350 351
      (if (equal posn nil)
	  (progn
	    (insert "-*- mode: todo; \n")
	    (forward-char -1))
	(kill-line)))
352 353
    (insert (format "todo-cats: %S; -*-" todo-cats))
    (forward-char 1)
354
    (insert (format "%s --- %s\n--- End\n%s %s\n"
355 356
		    todo-prefix cat todo-prefix (make-string 75 ?-))))
  0)
357

358 359
(defun todo-cmd-inst ()
  "Insert new TODO list entry."
360
  (interactive)
Oliver Seidel's avatar
Oliver Seidel committed
361
  (beginning-of-line nil)
362 363
  (let* ((todo-entry (concat todo-prefix " "
			     (read-from-minibuffer "New TODO entry: ")))
364 365
         (temp-catgs todo-cats)
         (todo-hstry (cons 'temp-catgs (+ todo-category-number 1))))
366 367
    (save-window-excursion
      (setq todo-category
368 369 370 371 372 373 374 375 376
            (read-from-minibuffer "Category: "
                                  (nth todo-category-number todo-cats)
                                  nil nil todo-hstry))

      (let ((cat-exists (member todo-category todo-cats)))
        (setq todo-category-number
              (if cat-exists
                  (- (length todo-cats) (length cat-exists))
                (todo-add-category todo-category))))
377 378
      (todo-show)
      (setq todo-prv-lne 0)
379 380 381 382 383

      (let ((todo-fst 1)
            (todo-lst (+ 1 (count-lines (point-min) (point-max)))))
        (while (> (- todo-lst todo-fst) todo-ins-thresh)
          (let* ((todo-cur (/ (+ todo-fst todo-lst) 2))
384 385
                 (todo-ans (if (< todo-cur todo-lst)
			       (todo-ask todo-cur) nil)))
386 387 388 389 390 391 392 393 394
            (if todo-ans
                (setq todo-lst todo-cur)
              (setq todo-fst (+ todo-cur 1)))))

	(setq todo-fst (/ (+ todo-fst todo-lst) 2))
        ;; goto-line doesn't have the desired behavior in a narrowed buffer
        (goto-char (point-min))
        (forward-line (- todo-fst 1)))
      
395
      (insert (concat todo-entry "\n"))
396
      (forward-line -1))
397
    (beginning-of-line nil)
398 399 400 401 402 403 404 405 406
    (message "")))

(defun todo-ask (lne) 
  "Ask whether entry is more important than at LNE."
  (if (not (equal todo-prv-lne lne))
      (progn
        (setq todo-prv-lne lne)
        (goto-char (point-min))
        (forward-line (- todo-prv-lne 1))
407 408 409
        (setq todo-prv-ans (y-or-n-p
			    (concat "More important than '"
				    (todo-line) "'? ")))))
410
  todo-prv-ans)
Oliver Seidel's avatar
Oliver Seidel committed
411

412
(defun todo-cmd-kill () "Delete current TODO list entry."
Oliver Seidel's avatar
Oliver Seidel committed
413 414 415
  (interactive)
  (if (> (count-lines (point-min) (point-max)) 0)
      (progn
416
	(let* ((todo-entry (todo-line))
417 418
	       (todo-answer (y-or-n-p (concat "Permanently remove '"
					      todo-entry "'? "))))
419 420 421
	  (if todo-answer
	      (progn
		(delete-region (point-at-bol) (+ 1 (point-at-eol))) 
422 423 424 425
		(forward-line -1))))
	(message ""))
    (message "No TODO list entry to delete."))
  (beginning-of-line nil))
Oliver Seidel's avatar
Oliver Seidel committed
426

Oliver Seidel's avatar
Oliver Seidel committed
427 428 429 430 431
(defun todo-cmd-rais () "Raise priority of current entry."
  (interactive)
  (if (> (count-lines (point-min) (point-max)) 0)
      (progn
	(setq todo-entry (todo-line))
432
	(delete-region (point-at-bol) (+ 1 (point-at-eol))) 
Oliver Seidel's avatar
Oliver Seidel committed
433 434
	(forward-line -1)
	(insert (concat todo-entry "\n"))
435
	(forward-line -1)
436 437 438
	(message ""))
    (message "No TODO list entry to raise."))
  (beginning-of-line nil))
Oliver Seidel's avatar
Oliver Seidel committed
439 440 441 442 443 444

(defun todo-cmd-lowr () "Lower priority of current entry."
  (interactive)
  (if (> (count-lines (point-min) (point-max)) 0)
      (progn
	(setq todo-entry (todo-line))
445
	(delete-region (point-at-bol) (+ 1 (point-at-eol))) 
Oliver Seidel's avatar
Oliver Seidel committed
446 447
	(forward-line 1)
	(insert (concat todo-entry "\n"))
448
	(forward-line -1)
449 450 451
	(message ""))
    (message "No TODO list entry to raise."))
  (beginning-of-line nil))
Oliver Seidel's avatar
Oliver Seidel committed
452

453
(defun todo-cmd-file () "File away the current TODO list entry."
Oliver Seidel's avatar
Oliver Seidel committed
454 455 456
  (interactive)
  (if (> (count-lines (point-min) (point-max)) 0)
      (progn
457 458
	(let ((time-stamp-format "%3b %2d, %y, %02I:%02M%p"))
	  (beginning-of-line nil)
459
	  (delete-region (point-at-bol) (search-forward todo-prefix))
460 461
	  (insert (time-stamp-string))
	  (end-of-line nil)
462
	  (insert (concat " (" (read-from-minibuffer "Comment: ") ")"))
463 464
	  (append-to-file (point-at-bol) (+ 1 (point-at-eol)) todo-file-done)
	  (delete-region (point-at-bol) (+ 1 (point-at-eol)))
465 466 467 468
	  (forward-line -1))
	(message ""))
    (message "No TODO list entry to delete."))
  (beginning-of-line nil))
Oliver Seidel's avatar
Oliver Seidel committed
469 470 471

;; ---------------------------------------------------------------------------

472 473 474 475 476 477 478 479 480 481 482 483 484 485 486 487
;; utility functions:  These are available in XEmacs, but not in Emacs 19.34

(if (not (fboundp 'point-at-bol))
    (defun point-at-bol ()
      (save-excursion
	(beginning-of-line)
	(point))))

(if (not (fboundp 'point-at-eol))
    (defun point-at-eol ()
      (save-excursion
	(end-of-line)
	(point))))

;; ---------------------------------------------------------------------------

488 489
(easy-menu-define todo-menu todo-mode-map "Todo Menu"
		'("Todo"
490 491 492 493 494 495 496 497 498 499 500 501 502 503 504 505 506
              ["Forward item"         todo-cmd-forw t]
              ["Backward item"        todo-cmd-back t]
              "---"
              ["Edit item"            todo-cmd-edit t]
              ["File item"            todo-cmd-file t]
              ["Insert new item"      todo-cmd-inst t]
              ["Kill item"            todo-cmd-kill t]
              "---"
              ["Lower item priority"  todo-cmd-lowr t]
              ["Raise item priority"  todo-cmd-rais t]
              "---"
              ["Next item"            todo-cmd-next t]
              ["Previous item"        todo-cmd-prev t]
              "---"
              ["Save"                 todo-cmd-save t]
              "---"
              ["Quit"                 todo-cmd-done t]
507
              ))
508

509
(defun todo-mode () "Major mode for editing TODO lists.\n\n\\{todo-mode-map}"
Oliver Seidel's avatar
Oliver Seidel committed
510 511 512 513
  (interactive)
  (setq major-mode 'todo-mode)
  (setq mode-name "TODO")
  (use-local-map todo-mode-map)
514 515
  (easy-menu-add todo-menu)
  (run-hooks 'todo-mode-hook))
516 517 518 519 520 521 522 523 524 525 526 527 528 529 530

(defun todo-show () "Show TODO list."
  (interactive)
  (find-file todo-file-do)
  (if (null todo-cats)
      (progn
	(todo-add-category "Todo")
	(goto-char (point-min))
	(goto-char (search-forward "--- End"))
	(let ((bol (point-at-bol)))
	  (forward-line 1)
	  (let* ((eol (+ (point-at-eol) 1))
		 (mrkr (buffer-substring bol eol)))
	    (delete-region bol eol)
	    (goto-char (point-max))
531
	    (insert mrkr)))
532 533
	(save-buffer)
	(kill-buffer (current-buffer))
534
	(find-file todo-file-do)))
535
  (beginning-of-line nil)
536
  (todo-cat-slct))
Oliver Seidel's avatar
Oliver Seidel committed
537 538 539 540 541

(provide 'todomode)

;; ---------------------------------------------------------------------------

542
;; todomode.el ends here
Oliver Seidel's avatar
Oliver Seidel committed
543 544

;; ---------------------------------------------------------------------------