Clarify initial discussion.
[bpt/emacs.git] / lisp / scroll-all.el
1 ;;; scroll-all.el -- scroll all buffers together minor mode
2
3 ;; Copyright (C) 1997 Free Software Foundation, Inc.
4
5 ;; Author: Gary D. Foster <Gary.Foster@corp.sun.com>
6 ;; Keywords: scroll crisp brief lock
7
8 ;; This file is part of GNU Emacs.
9
10 ;; GNU Emacs is free software; you can redistribute it and/or modify
11 ;; it under the terms of the GNU General Public License as published by
12 ;; the Free Software Foundation; either version 2, or (at your option)
13 ;; any later version.
14
15 ;; GNU Emacs is distributed in the hope that it will be useful,
16 ;; but WITHOUT ANY WARRANTY; without even the implied warranty of
17 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
18 ;; GNU General Public License for more details.
19
20 ;; You should have received a copy of the GNU General Public License
21 ;; along with GNU Emacs; see the file COPYING. If not, write to the
22 ;; Free Software Foundation, Inc., 59 Temple Place - Suite 330,
23 ;; Boston, MA 02111-1307, USA.
24
25 ;; Commentary
26 ;; This mode allows multiple buffers to be 'locked' so that scrolling
27 ;; up or down lines in any buffer causes all the buffers to mirror
28 ;; the scrolling. It hooks into the post-command-hook to check for
29 ;; potential scrolling commands and if we're locked, mirrors them in all
30 ;; windows. This allows us to grab line-at-a-time scrolling as well as
31 ;; screen-at-a-time scrolling, and doesn't remap any of the keyboard
32 ;; commands to do it.
33
34 ;; You can enable and disable this mode with the 'scroll-all-mode' command.
35
36 ;; Suggestions/ideas from:
37 ;; Rick Macdonald <rickm@vsl.com>
38 ;; Anders Lindgren <andersl@csd.uu.se>
39
40 (defvar running-xemacs (string-match "XEmacs\\|Lucid" emacs-version))
41
42 ;;;###autoload
43 (defcustom scroll-all-mode nil
44 "Control/track scroll locking.
45
46 Setting this variable directly does not take effect;
47 use either M-x customize or the function `scroll-all-mode'."
48 :set (lambda (symbol value) (scroll-all-mode (if value 1 0)))
49 :initialize 'custom-initialize-default
50 :require 'scroll-all
51 :type 'boolean
52 :group 'windows)
53
54 (if running-xemacs
55 (add-minor-mode 'scroll-all-mode " *SL*")
56 (or (assq 'scroll-all-mode-mode minor-mode-alist)
57 (setq minor-mode-alist
58 (cons '(scroll-all-mode-mode " *SL*") minor-mode-alist))))
59
60 (defun scroll-all-scroll-down-all (arg)
61 "Scroll down all visible windows."
62 (interactive "P")
63 (let ((num-windows (count-windows))
64 (count 1))
65 (if (> num-windows 1)
66 ( progn (other-window 1)
67 (while (< count num-windows)
68 (if (not (eq (point) (point-max)))
69 (progn (call-interactively 'next-line)))
70 (other-window 1)
71 (setq count (1+ count)))))))
72
73 (defun scroll-all-scroll-up-all (arg)
74 "Scroll up all visible windows."
75 (interactive "P")
76 (let ((num-windows (count-windows))
77 (count 1))
78 (if (> num-windows 1)
79 ( progn (other-window 1)
80 (while (< count num-windows)
81 (if (not (eq (point) (point-min)))
82 (progn (call-interactively 'previous-line)))
83 (other-window 1)
84 (setq count (1+ count)))))))
85
86 (defun scroll-all-page-down-all (arg)
87 "Page down in all visible windows."
88 (interactive "P")
89 (let ((num-windows (count-windows))
90 (count 1))
91 (if (> num-windows 1)
92 (progn (other-window 1)
93 (while (< count num-windows)
94 (call-interactively 'fkey-scroll-up)
95 (other-window 1)
96 (setq count (1+ count)))))))
97
98 (defun scroll-all-page-up-all (arg)
99 "Page up in all visible windows."
100 (interactive "P")
101 (let ((num-windows (count-windows))
102 (count 1))
103 (if (> num-windows 1)
104 (progn (other-window 1)
105 (while (< count num-windows)
106 (call-interactively 'fkey-scroll-down)
107 (other-window 1)
108 (setq count (1+ count)))))))
109
110
111 (defun scroll-all-check-to-scroll ()
112 "Check `last-command' to see if a scroll was done."
113 (if (eq this-command 'next-line)
114 (call-interactively 'scroll-all-scroll-down-all))
115 (if (eq this-command 'previous-line)
116 (call-interactively 'scroll-all-scroll-up-all))
117 (if (eq this-command 'fkey-scroll-up)
118 (call-interactively 'scroll-all-page-down-all))
119 (if (eq this-command 'fkey-scroll-down)
120 (call-interactively 'scroll-all-page-up-all)))
121
122 ;;;###autoload
123 (defun scroll-all-mode (arg)
124 "Toggle Scroll-All minor mode."
125 (interactive "P")
126 (setq scroll-all-mode (not scroll-all-mode))
127 (cond
128 ((eq scroll-all-mode 't)
129 (add-hook 'post-command-hook 'scroll-all-check-to-scroll))
130 ((eq scroll-all-mode 'nil)
131 (remove-hook 'post-command-hook 'scroll-all-check-to-scroll))))
132
133 (provide 'scroll-all)
134
135 ;; scroll-all.el ends here