annotate lisp/modes/auto-show.el @ 2:ac2d302a0011 r19-15b2

Import from CVS: tag r19-15b2
author cvs
date Mon, 13 Aug 2007 08:46:35 +0200
parents 376386a54a3c
children 43dd3413c7c7
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
0
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1 ;;; auto-show.el --- perform automatic horizontal scrolling as point moves
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2 ;;; This file is in the public domain.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
3
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
4 ;;; Keywords: scroll display minor-mode
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
5 ;;; Author: Pete Ware <ware@cis.ohio-state.edu>
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
6 ;;; Modified by: Ben Wing <wing@666.com>
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
7 ;;; Maintainer: FSF
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
8
2
ac2d302a0011 Import from CVS: tag r19-15b2
cvs
parents: 0
diff changeset
9 ;; This file is part of XEmacs.
ac2d302a0011 Import from CVS: tag r19-15b2
cvs
parents: 0
diff changeset
10
ac2d302a0011 Import from CVS: tag r19-15b2
cvs
parents: 0
diff changeset
11 ;; XEmacs is free software; you can redistribute it and/or modify it
ac2d302a0011 Import from CVS: tag r19-15b2
cvs
parents: 0
diff changeset
12 ;; under the terms of the GNU General Public License as published by
ac2d302a0011 Import from CVS: tag r19-15b2
cvs
parents: 0
diff changeset
13 ;; the Free Software Foundation; either version 2, or (at your option)
ac2d302a0011 Import from CVS: tag r19-15b2
cvs
parents: 0
diff changeset
14 ;; any later version.
ac2d302a0011 Import from CVS: tag r19-15b2
cvs
parents: 0
diff changeset
15
ac2d302a0011 Import from CVS: tag r19-15b2
cvs
parents: 0
diff changeset
16 ;; XEmacs is distributed in the hope that it will be useful, but
ac2d302a0011 Import from CVS: tag r19-15b2
cvs
parents: 0
diff changeset
17 ;; WITHOUT ANY WARRANTY; without even the implied warranty of
ac2d302a0011 Import from CVS: tag r19-15b2
cvs
parents: 0
diff changeset
18 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
ac2d302a0011 Import from CVS: tag r19-15b2
cvs
parents: 0
diff changeset
19 ;; General Public License for more details.
ac2d302a0011 Import from CVS: tag r19-15b2
cvs
parents: 0
diff changeset
20
ac2d302a0011 Import from CVS: tag r19-15b2
cvs
parents: 0
diff changeset
21 ;; You should have received a copy of the GNU General Public License
ac2d302a0011 Import from CVS: tag r19-15b2
cvs
parents: 0
diff changeset
22 ;; along with XEmacs; see the file COPYING. If not, write to the Free
ac2d302a0011 Import from CVS: tag r19-15b2
cvs
parents: 0
diff changeset
23 ;; Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA
ac2d302a0011 Import from CVS: tag r19-15b2
cvs
parents: 0
diff changeset
24 ;; 02111-1307, USA.
ac2d302a0011 Import from CVS: tag r19-15b2
cvs
parents: 0
diff changeset
25
ac2d302a0011 Import from CVS: tag r19-15b2
cvs
parents: 0
diff changeset
26 ;;; Synched up with: FSF 19.34 (But starting to deviate).
0
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
27
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
28 ;;; Commentary:
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
29
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
30 ;;; This file provides functions that
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
31 ;;; automatically scroll the window horizontally when the point moves
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
32 ;;; off the left or right side of the window.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
33
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
34 ;;; Once this library is loaded, automatic horizontal scrolling
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
35 ;;; occurs whenever long lines are being truncated.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
36 ;;; To request truncation of long lines, set the variable
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
37 ;;; Setting the variable `truncate-lines' to non-nil.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
38 ;;; You can do this for all buffers as follows:
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
39 ;;;
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
40 ;;; (set-default 'truncate-lines t)
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
41
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
42 ;;; Here is how to do it for C mode only:
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
43 ;;;
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
44 ;;; (set-default 'truncate-lines nil) ; this is the original value
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
45 ;;; (defun my-c-mode-hook ()
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
46 ;;; "Run when C-mode starts up. Changes ..."
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
47 ;;; ... set various personal preferences ...
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
48 ;;; (setq truncate-lines t))
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
49 ;;; (add-hook 'c-mode-hook 'my-c-mode-hook)
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
50 ;;;
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
51 ;;;
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
52 ;;; As a finer level of control, you can still have truncated lines but
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
53 ;;; without the automatic horizontal scrolling by setting the buffer
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
54 ;;; local variable `auto-show-mode' to nil. The default value is t.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
55 ;;; The command `auto-show-mode' toggles the value of the variable
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
56 ;;; `auto-show-mode'.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
57
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
58 ;;; Code:
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
59
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
60 (defvar auto-show-mode t
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
61 "*Non-nil enables automatic horizontal scrolling, when lines are truncated.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
62 The default value is t. To change the default, do this:
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
63 (set-default 'auto-show-mode nil)
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
64 See also command `auto-show-mode'.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
65 This variable has no effect when lines are not being truncated.")
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
66
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
67 (make-variable-buffer-local 'auto-show-mode)
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
68
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
69 (defvar auto-show-shift-amount 8
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
70 "*Extra columns to scroll. for automatic horizontal scrolling.")
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
71
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
72 (defvar auto-show-show-left-margin-threshold 50
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
73 "*Threshold column for automatic horizontal scrolling to the right.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
74 If point is before this column, we try to scroll to make the left margin
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
75 visible. Setting this to 0 disables this feature.")
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
76
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
77 (defun auto-show-truncationp ()
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
78 "True if line truncation is enabled for the selected window."
2
ac2d302a0011 Import from CVS: tag r19-15b2
cvs
parents: 0
diff changeset
79 ;; XEmacs change (use specifiers)
0
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
80 ;; ### There should be a more straightforward way to do this from elisp.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
81 (or truncate-lines
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
82 (and truncate-partial-width-windows
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
83 (< (+ (window-width)
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
84 (specifier-instance left-margin-width)
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
85 (specifier-instance right-margin-width))
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
86 (frame-width)))))
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
87
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
88 (defun auto-show-mode (arg)
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
89 "Turn automatic horizontal scroll mode on or off.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
90 With arg, turn auto scrolling on if arg is positive, off otherwise."
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
91 (interactive "P")
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
92 (setq auto-show-mode
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
93 (if (null arg)
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
94 (not auto-show-mode)
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
95 (> (prefix-numeric-value arg) 0))))
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
96
2
ac2d302a0011 Import from CVS: tag r19-15b2
cvs
parents: 0
diff changeset
97 ;; XEmacs addition:
0
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
98 (defvar auto-show-inhibiting-commands
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
99 '(scrollbar-char-left
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
100 scrollbar-char-right
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
101 scrollbar-page-left
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
102 scrollbar-page-right
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
103 scrollbar-to-left
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
104 scrollbar-to-right
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
105 scrollbar-horizontal-drag)
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
106 "Commands that inhibit auto-show behavior.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
107 This normally includes the horizontal scrollbar commands.")
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
108
2
ac2d302a0011 Import from CVS: tag r19-15b2
cvs
parents: 0
diff changeset
109 ;; XEmacs addition:
0
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
110 (defun auto-show-should-take-action-p ()
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
111 (and auto-show-mode (auto-show-truncationp)
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
112 (equal (window-buffer) (current-buffer))
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
113 (not (memq this-command auto-show-inhibiting-commands))))
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
114
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
115 ;; XEmacs addition:
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
116 (defun auto-show-make-region-visible (start end)
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
117 "Move point in such a way that the region (START, END) is visible.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
118 This only does anything if auto-show-mode is enabled, and it doesn't
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
119 actually do any horizontal scrolling; rather, it just sets things up so
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
120 that the region will be visible when `auto-show-make-point-visible'
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
121 is next called (this happens after every command)."
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
122 (if (auto-show-should-take-action-p)
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
123 (let* ((col (current-column)) ;column on line point is at
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
124 (scroll (window-hscroll));how far window is scrolled
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
125 (w-width (- (window-width)
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
126 (if (> scroll 0)
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
127 2 1))) ;how wide window is on the screen
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
128 (right-col (+ scroll w-width))
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
129 (start-col (save-excursion (goto-char start) (current-column)))
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
130 (end-col (save-excursion (goto-char end) (current-column))))
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
131 (cond ((and (>= start-col scroll)
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
132 (<= end-col right-col))
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
133 ;; already completely visible
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
134 nil)
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
135 ((< start-col scroll)
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
136 (scroll-right (- scroll start-col)))
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
137 (t
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
138 (scroll-left (- end-col right-col)))))))
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
139
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
140 (defun auto-show-make-point-visible (&optional ignore-arg)
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
141 "Scroll horizontally to make point visible, if that is enabled.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
142 This function only does something if `auto-show-mode' is non-nil
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
143 and longlines are being truncated in the selected window.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
144 See also the command `auto-show-toggle'."
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
145 (interactive)
2
ac2d302a0011 Import from CVS: tag r19-15b2
cvs
parents: 0
diff changeset
146 ;; XEmacs change
0
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
147 (if (auto-show-should-take-action-p)
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
148 (let* ((col (current-column)) ;column on line point is at
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
149 (scroll (window-hscroll)) ;how far window is scrolled
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
150 (w-width (- (window-width)
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
151 (if (> scroll 0)
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
152 2 1))) ;how wide window is on the screen
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
153 (right-col (+ scroll w-width)))
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
154 (if (and (< col auto-show-show-left-margin-threshold)
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
155 (< col (window-width))
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
156 (> scroll 0))
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
157 (scroll-right scroll)
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
158 (if (< col scroll) ;to the left of the screen
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
159 (scroll-right (+ (- scroll col) auto-show-shift-amount))
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
160 (if (or (> col right-col) ;to the right of the screen
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
161 (and (= col right-col)
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
162 (not (eolp))))
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
163 (scroll-left (+ auto-show-shift-amount
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
164 (- col (+ scroll w-width))))
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
165 )
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
166 )
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
167 )
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
168 )
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
169 )
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
170 )
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
171
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
172 ;; XEmacs change:
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
173 ;; #### instead of this, we kludgily call it from the C code, to make sure
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
174 ;; that it's done after any other things on post-command-hook (which might
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
175 ;; move point).
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
176 ;; Do auto-scrolling after commands.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
177 ;;(add-hook 'post-command-hook 'auto-show-make-point-visible)
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
178
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
179 ;; If being dumped, turn it on right away.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
180 (and (noninteractive) (auto-show-mode 1))
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
181
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
182 ;; Do auto-scrolling in comint buffers after process output also.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
183 ; XEmacs -- don't do this now, it messes up comint.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
184 ;(add-hook 'comint-output-filter-functions 'auto-show-make-point-visible t)
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
185
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
186 (provide 'auto-show)
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
187
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
188 ;; auto-show.el ends here
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
189