41621
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
1 ;;; reveal.el --- Automatically reveal hidden text at point
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
2
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
3 ;; Copyright (C) 2000, 2001 Free Software Foundation, Inc.
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
4
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
5 ;; Author: Stefan Monnier <monnier@cs.yale.edu>
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
6 ;; Keywords: outlines
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
7
|
42320
|
8 ;; This file is part of GNU Emacs.
|
|
9
|
45340
|
10 ;; GNU Emacs is free software; you can redistribute it and/or modify
|
41621
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
11 ;; it under the terms of the GNU General Public License as published by
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
12 ;; the Free Software Foundation; either version 2, or (at your option)
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
13 ;; any later version.
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
14
|
45341
|
15 ;; GNU Emacs is distributed in the hope that it will be useful,
|
41621
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
16 ;; but WITHOUT ANY WARRANTY; without even the implied warranty of
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
17 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
18 ;; GNU General Public License for more details.
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
19
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
20 ;; You should have received a copy of the GNU General Public License
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
21 ;; along with GNU Emacs; see the file COPYING. If not, write to
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
22 ;; the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
23 ;; Boston, MA 02111-1307, USA.
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
24
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
25 ;;; Commentary:
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
26
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
27 ;; Reveal mode is a minor mode that makes sure that text around point
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
28 ;; is always visible. When point enters a region of hidden text,
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
29 ;; `reveal-mode' temporarily makes it visible.
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
30 ;;
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
31 ;; This is normally used in conjunction with `outline-minor-mode',
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
32 ;; `hs-minor-mode', `hide-ifdef-mode', ...
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
33 ;;
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
34 ;; It only works with packages that hide text using overlays.
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
35 ;; Packages can provide special support for it by placing
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
36 ;; a function in the `reveal-toggle-invisible' property on the symbol
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
37 ;; used as the value of the `invisible' overlay property.
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
38 ;; The function is called right after revealing (or re-hiding) the
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
39 ;; text with two arguments: the overlay and a boolean that's non-nil
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
40 ;; if we have just revealed the text. When revealing, that function
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
41 ;; may re-hide some of the text.
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
42
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
43 ;;; Todo:
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
44
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
45 ;; - find other hysteresis features.
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
46
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
47 ;;; Code:
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
48
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
49 (require 'pcvs-util)
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
50
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
51 (defgroup reveal nil
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
52 "Reveal hidden text on the fly."
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
53 :group 'editing)
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
54
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
55 (defcustom reveal-around-mark t
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
56 "Reveal text around the mark, if active."
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
57 :type 'boolean)
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
58
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
59 (defvar reveal-open-spots nil)
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
60 (make-variable-buffer-local 'reveal-open-spots)
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
61
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
62 ;; Actual code
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
63
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
64 (defun reveal-post-command ()
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
65 ;; Refresh the spots that might have changed.
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
66 ;; `Refreshing' here means to try and re-hide the corresponding text.
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
67 ;; We don't refresh everything correctly:
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
68 ;; - we only refresh spots in the current window.
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
69 ;; FIXME: do we actually know that (current-buffer) = (window-buffer) ?
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
70 (with-local-quit
|
45428
|
71 (condition-case err
|
41621
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
72 (let* ((spots (cvs-partition
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
73 (lambda (x)
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
74 ;; We refresh any spot in the current window as well
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
75 ;; as any spots associated with a dead window or a window
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
76 ;; which does not show this buffer any more.
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
77 (or (eq (car x) (selected-window))
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
78 (not (window-live-p (car x)))
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
79 (not (eq (window-buffer (car x))
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
80 (current-buffer)))))
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
81 reveal-open-spots))
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
82 (old-ols (mapcar 'cdr (car spots)))
|
45428
|
83 (repeat t))
|
41621
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
84 (setq reveal-open-spots (cdr spots))
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
85 ;; Open new overlays.
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
86 (while repeat
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
87 (setq repeat nil)
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
88 (dolist (ol (nconc (when (and reveal-around-mark mark-active)
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
89 (overlays-at (mark)))
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
90 (overlays-at (point))))
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
91 (push (cons (selected-window) ol) reveal-open-spots)
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
92 (setq old-ols (delq ol old-ols))
|
45428
|
93 (let ((open (overlay-get ol 'reveal-toggle-invisible)))
|
|
94 (when (or open
|
|
95 (let ((inv (overlay-get ol 'invisible)))
|
|
96 (and inv (symbolp inv)
|
|
97 (or (setq open (or (get inv 'reveal-toggle-invisible)
|
|
98 (get ol 'isearch-open-invisible-temporary)))
|
|
99 (overlay-get ol 'isearch-open-invisible)
|
|
100 (and (consp buffer-invisibility-spec)
|
|
101 (assq inv buffer-invisibility-spec)))
|
|
102 (overlay-put ol 'reveal-invisible inv))))
|
|
103 (if (null open)
|
|
104 (overlay-put ol 'invisible nil)
|
41621
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
105 ;; Use the provided opening function and repeat (since the
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
106 ;; opening function might have hidden a subpart around point).
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
107 (setq repeat t)
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
108 (condition-case err
|
45428
|
109 (funcall open ol nil)
|
41621
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
110 (error (message "!!Reveal-show: %s !!" err))))))))
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
111 ;; Close old overlays.
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
112 (dolist (ol old-ols)
|
45428
|
113 (when (and (eq (current-buffer) (overlay-buffer ol))
|
41621
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
114 (not (rassq ol reveal-open-spots)))
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
115 (if (and (>= (point) (save-excursion
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
116 (goto-char (overlay-start ol))
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
117 (line-beginning-position 1)))
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
118 (<= (point) (save-excursion
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
119 (goto-char (overlay-end ol))
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
120 (line-beginning-position 2))))
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
121 ;; Still near the overlay: keep it open.
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
122 (push (cons (selected-window) ol) reveal-open-spots)
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
123 ;; Really close it.
|
45428
|
124 (let ((open (overlay-get ol 'reveal-toggle-invisible)) inv)
|
|
125 (if (or open
|
|
126 (and (setq inv (overlay-get ol 'reveal-invisible))
|
|
127 (setq open (or (get inv 'reveal-toggle-invisible)
|
|
128 (get ol 'isearch-open-invisible-temporary)))))
|
|
129 (condition-case err
|
|
130 (funcall open ol t)
|
|
131 (error (message "!!Reveal-hide: %s !!" err)))
|
|
132 (overlay-put ol 'invisible inv)))))))
|
|
133 (error (message "Reveal: %s" err)))))
|
41621
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
134
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
135 ;;;###autoload
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
136 (define-minor-mode reveal-mode
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
137 "Toggle Reveal mode on or off.
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
138 Reveal mode renders invisible text around point visible again.
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
139
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
140 Interactively, with no prefix argument, toggle the mode.
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
141 With universal prefix ARG (or if ARG is nil) turn mode on.
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
142 With zero or negative ARG turn mode off."
|
41778
|
143 :lighter (global-reveal-mode nil " Reveal")
|
41621
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
144 (if reveal-mode
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
145 (progn
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
146 (set (make-local-variable 'search-invisible) t)
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
147 (add-hook 'post-command-hook 'reveal-post-command nil t))
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
148 (kill-local-variable 'search-invisible)
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
149 (remove-hook 'post-command-hook 'reveal-post-command t)))
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
150
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
151 ;;;###autoload
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
152 (define-minor-mode global-reveal-mode
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
153 "Toggle Reveal mode in all buffers on or off.
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
154 Reveal mode renders invisible text around point visible again.
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
155
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
156 Interactively, with no prefix argument, toggle the mode.
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
157 With universal prefix ARG (or if ARG is nil) turn mode on.
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
158 With zero or negative ARG turn mode off."
|
48399
|
159 :global t :group 'reveal
|
41621
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
160 (setq-default reveal-mode global-reveal-mode)
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
161 (if global-reveal-mode
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
162 (progn
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
163 (setq search-invisible t)
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
164 (add-hook 'post-command-hook 'reveal-post-command))
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
165 (setq search-invisible 'open) ;FIXME
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
166 (remove-hook 'post-command-hook 'reveal-post-command)))
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
167
|
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
168 (provide 'reveal)
|
48399
|
169
|
41621
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
diff
changeset
|
170 ;;; reveal.el ends here
|