![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Return to view.el CVS log ![[TXT]](/cvsweb/icons/text.gif){kind=icon}
![[DIR]](/cvsweb/icons/dir.gif){kind=icon}
Up to [CSRG BSD Unix] / 43BSDReno / contrib / emacs-18.55 / lisp|
Return to view.el CVS log | Up to [CSRG BSD Unix] / 43BSDReno / contrib / emacs-18.55 / lisp |
1.1 root 1: ;; View: Peruse file or buffer without editing.
2: ;; Copyright (C) 1985 Free Software Foundation, Inc.
3: ;; Principal author K. Shane Hartman
4:
5: ;; This file is part of GNU Emacs.
6:
7: ;; GNU Emacs is distributed in the hope that it will be useful,
8: ;; but WITHOUT ANY WARRANTY. No author or distributor
9: ;; accepts responsibility to anyone for the consequences of using it
10: ;; or for whether it serves any particular purpose or works at all,
11: ;; unless he says so in writing. Refer to the GNU Emacs General Public
12: ;; License for full details.
13:
14: ;; Everyone is granted permission to copy, modify and redistribute
15: ;; GNU Emacs, but only under the conditions described in the
16: ;; GNU Emacs General Public License. A copy of this license is
17: ;; supposed to have been given to you along with GNU Emacs so you
18: ;; can know your rights and responsibilities. It should be in a
19: ;; file named COPYING. Among other things, the copyright notice
20: ;; and this notice must be preserved on all copies.
21:
22:
23: (provide 'view)
24:
25: (defvar view-mode-map nil)
26: (if view-mode-map
27: nil
28: (setq view-mode-map (make-keymap))
29: (fillarray view-mode-map 'View-undefined)
30: (define-key view-mode-map "\C-c" 'exit-recursive-edit)
31: (define-key view-mode-map "\C-z" 'suspend-emacs)
32: (define-key view-mode-map "q" 'exit-recursive-edit)
33: (define-key view-mode-map "-" 'negative-argument)
34: (define-key view-mode-map "0" 'digit-argument)
35: (define-key view-mode-map "1" 'digit-argument)
36: (define-key view-mode-map "2" 'digit-argument)
37: (define-key view-mode-map "3" 'digit-argument)
38: (define-key view-mode-map "4" 'digit-argument)
39: (define-key view-mode-map "5" 'digit-argument)
40: (define-key view-mode-map "6" 'digit-argument)
41: (define-key view-mode-map "7" 'digit-argument)
42: (define-key view-mode-map "8" 'digit-argument)
43: (define-key view-mode-map "9" 'digit-argument)
44: (define-key view-mode-map "\C-u" 'universal-argument)
45: (define-key view-mode-map "\e" nil)
46: (define-key view-mode-map "\C-x" 'Control-X-prefix)
47: (define-key view-mode-map "\e-" 'negative-argument)
48: (define-key view-mode-map "\e0" 'digit-argument)
49: (define-key view-mode-map "\e1" 'digit-argument)
50: (define-key view-mode-map "\e2" 'digit-argument)
51: (define-key view-mode-map "\e3" 'digit-argument)
52: (define-key view-mode-map "\e4" 'digit-argument)
53: (define-key view-mode-map "\e5" 'digit-argument)
54: (define-key view-mode-map "\e6" 'digit-argument)
55: (define-key view-mode-map "\e7" 'digit-argument)
56: (define-key view-mode-map "\e8" 'digit-argument)
57: (define-key view-mode-map "\e9" 'digit-argument)
58: (define-key view-mode-map "<" 'beginning-of-buffer)
59: (define-key view-mode-map ">" 'end-of-buffer)
60: (define-key view-mode-map "\ev" 'View-scroll-lines-backward)
61: (define-key view-mode-map "\C-v" 'View-scroll-lines-forward)
62: (define-key view-mode-map " " 'View-scroll-lines-forward)
63: (define-key view-mode-map "\177" 'View-scroll-lines-backward)
64: (define-key view-mode-map "\n" 'View-scroll-one-more-line)
65: (define-key view-mode-map "\r" 'View-scroll-one-more-line)
66: (define-key view-mode-map "\C-l" 'recenter)
67: (define-key view-mode-map "z" 'View-scroll-lines-forward-set-scroll-size)
68: (define-key view-mode-map "g" 'View-goto-line)
69: (define-key view-mode-map "=" 'what-line)
70: (define-key view-mode-map "." 'set-mark-command)
71: (define-key view-mode-map "\C-@" 'set-mark-command)
72: (define-key view-mode-map "'" 'View-back-to-mark)
73: (define-key view-mode-map "@" 'View-back-to-mark)
74: (define-key view-mode-map "x" 'exchange-point-and-mark)
75: (define-key view-mode-map "h" 'Helper-describe-bindings)
76: (define-key view-mode-map "?" 'Helper-describe-bindings)
77: (define-key view-mode-map "\C-h" 'Helper-help)
78: (define-key view-mode-map "\C-n" 'next-line)
79: (define-key view-mode-map "\C-p" 'previous-line)
80: (define-key view-mode-map "\C-s" 'isearch-forward)
81: (define-key view-mode-map "\C-r" 'isearch-backward)
82: (define-key view-mode-map "s" 'isearch-forward)
83: (define-key view-mode-map "r" 'isearch-backward)
84: (define-key view-mode-map "/" 'View-search-regexp-forward)
85: (define-key view-mode-map "\\" 'View-search-regexp-backward)
86: ;; This conflicts with the standard binding of isearch-regexp-forward
87: (define-key view-mode-map "\e\C-s" 'View-search-regexp-forward)
88: (define-key view-mode-map "\e\C-r" 'View-search-regexp-backward)
89: (define-key view-mode-map "n" 'View-search-last-regexp-forward)
90: (define-key view-mode-map "p" 'View-search-last-regexp-backward)
91: )
92:
93:
94: (defun view-file (file-name)
95: "View FILE in View mode, returning to previous buffer when done.
96: The usual Emacs commands are not available; instead,
97: a special set of commands (mostly letters and punctuation)
98: are defined for moving around in the buffer.
99: Space scrolls forward, Delete scrolls backward.
100: For list of all View commands, type ? or h while viewing.
101:
102: Calls the value of view-hook if that is non-nil."
103: (interactive "fView file: ")
104: (let ((had-a-buf (get-file-buffer file-name))
105: (buf-to-view nil))
106: (unwind-protect
107: (view-mode (prog1 (current-buffer)
108: (switch-to-buffer
109: (setq buf-to-view (find-file-noselect file-name)) t)))
110: (and (not had-a-buf) buf-to-view (not (buffer-modified-p buf-to-view))
111: (kill-buffer buf-to-view)))))
112:
113: (defun view-buffer (buffer-name)
114: "View BUFFER in View mode, returning to previous buffer when done.
115: The usual Emacs commands are not available; instead,
116: a special set of commands (mostly letters and punctuation)
117: are defined for moving around in the buffer.
118: Space scrolls forward, Delete scrolls backward.
119: For list of all View commands, type ? or h while viewing.
120:
121: Calls the value of view-hook if that is non-nil."
122: (interactive "bView buffer: ")
123: (view-mode (prog1 (current-buffer) (switch-to-buffer buffer-name))))
124:
125: (defun view-mode (&optional view-return-to-buffer)
126: "Major mode for viewing text but not editing it.
127: Letters do not insert themselves. Instead these commands are provided.
128: Most commands take prefix arguments. Commands dealing with lines
129: default to \"scroll size\" lines (initially size of window).
130: Search commands default to a repeat count of one.
131: M-< or < move to beginning of buffer.
132: M-> or > move to end of buffer.
133: C-v or Space scroll forward lines.
134: M-v or DEL scroll backward lines.
135: CR or LF scroll forward one line (backward with prefix argument).
136: z like Space except set number of lines for further
137: scrolling commands to scroll by.
138: C-u and Digits provide prefix arguments. `-' denotes negative argument.
139: = prints the current line number.
140: g goes to line given by prefix argument.
141: / or M-C-s searches forward for regular expression
142: \\ or M-C-r searches backward for regular expression.
143: n searches forward for last regular expression.
144: p searches backward for last regular expression.
145: C-@ or . set the mark.
146: x exchanges point and mark.
147: C-s or s do forward incremental search.
148: C-r or r do reverse incremental search.
149: @ or ' return to mark and pops mark ring.
150: Mark ring is pushed at start of every
151: successful search and when jump to line to occurs.
152: The mark is set on jump to buffer start or end.
153: ? or h provide help message (list of commands).
154: C-h provides help (list of commands or description of a command).
155: C-n moves down lines vertically.
156: C-p moves upward lines vertically.
157: C-l recenters the screen.
158: q or C-c exit view-mode and return to previous buffer.
159:
160: Entry to this mode calls the value of view-hook if non-nil.
161: \\{view-mode-map}"
162: ; Not interactive because dangerous things happen
163: ; if you call it without passing a buffer as argument
164: ; and they are not easy to fix.
165: ; (interactive)
166: (let* ((view-buffer-window (selected-window))
167: (view-scroll-size nil))
168: (unwind-protect
169: (let ((buffer-read-only t)
170: (mode-line-buffer-identification
171: (list
172: (if (buffer-file-name)
173: "Viewing %f"
174: "Viewing %b")))
175: (mode-name "View"))
176: (beginning-of-line)
177: (catch 'view-mode-exit (view-mode-command-loop)))
178: (if view-return-to-buffer
179: (switch-to-buffer view-return-to-buffer)))))
180:
181: (defun view-helpful-message ()
182: (message
183: (if (and (eq (key-binding "\C-h") 'Helper-help)
184: (eq (key-binding "?") 'Helper-describe-bindings)
185: (eq (key-binding "\C-c") 'exit-recursive-edit))
186: "Type C-h for help, ? for commands, C-c to quit"
187: (substitute-command-keys
188: "Type \\[Helper-help] for help, \\[Helper-describe-bindings] for commands, \\[exit-recursive-edit] to quit."))))
189:
190: (defun View-undefined ()
191: (interactive)
192: (ding)
193: (view-helpful-message))
194:
195: (defun view-window-size () (1- (window-height view-buffer-window)))
196:
197: (defun view-scroll-size ()
198: (min (view-window-size) (or view-scroll-size (view-window-size))))
199:
200: (defvar view-hook nil
201: "If non-nil, its value is called when viewing buffer or file.")
202:
203: (defun view-mode-command-loop ()
204: (push-mark)
205: (let ((old-local-map (current-local-map))
206: (mark-ring)
207: ; (view-last-command)
208: ; (view-last-command-entry)
209: ; (view-last-command-argument)
210: (view-last-regexp)
211: (Helper-return-blurb
212: (format "continue viewing %s"
213: (if (buffer-file-name)
214: (file-name-nondirectory (buffer-file-name))
215: (buffer-name))))
216: (goal-column 0)
217: (view-buffer (buffer-name)))
218: (unwind-protect
219: (progn
220: (use-local-map view-mode-map)
221: (run-hooks 'view-hook)
222: (view-helpful-message)
223: (recursive-edit))
224: (save-excursion
225: (set-buffer view-buffer)
226: (use-local-map old-local-map))))
227: (pop-mark))
228:
229: ;(defun view-last-command (&optional who what)
230: ; (setq view-last-command-entry this-command)
231: ; (setq view-last-command who)
232: ; (setq view-last-command-argument what))
233:
234: ;(defun View-repeat-last-command ()
235: ; "Repeat last command issued in View mode."
236: ; (interactive)
237: ; (if (and view-last-command
238: ; (eq view-last-command-entry last-command))
239: ; (funcall view-last-command view-last-command-argument))
240: ; (setq this-command view-last-command-entry))
241:
242: (defun View-goto-line (&optional line)
243: "Move to LINE in View mode.
244: Display is centered at LINE. Sets mark at starting position and pushes
245: mark ring."
246: (interactive "p")
247: (push-mark)
248: (goto-line (or line 1))
249: (recenter (/ (view-window-size) 2)))
250:
251: (defun View-scroll-lines-forward (&optional lines)
252: "Scroll forward in View mode, or exit if end of text is visible.
253: No arg means whole window full, or number of lines set by \\[View-scroll-lines-forward-set-scroll-size].
254: Arg is number of lines to scroll."
255: (interactive "P")
256: (if (pos-visible-in-window-p (point-max))
257: (exit-recursive-edit))
258: (setq lines
259: (if lines (prefix-numeric-value lines)
260: (view-scroll-size)))
261: ; (view-last-command 'View-scroll-lines-forward lines)
262: (if (>= lines (view-window-size))
263: (scroll-up nil)
264: (if (>= (- lines) (view-window-size))
265: (scroll-down nil)
266: (scroll-up lines)))
267: (cond ((pos-visible-in-window-p (point-max))
268: (goto-char (point-max))
269: (recenter -1)
270: (message (substitute-command-keys
271: "End. Type \\[exit-recursive-edit] to quit viewing."))))
272: (move-to-window-line -1)
273: (beginning-of-line))
274:
275: (defun View-scroll-lines-forward-set-scroll-size (&optional lines)
276: "Scroll forward LINES lines in View mode, setting the \"scroll size\".
277: This is the number of lines which \\[View-scroll-lines-forward] and \\[View-scroll-lines-backward] scroll by default.
278: The absolute value of LINES is used, so this command can be used to scroll
279: backwards (but \"scroll size\" is always positive). If LINES is greater than
280: window height or omitted, then window height is assumed. If LINES is less
281: than window height then scrolling context is provided from previous screen."
282: (interactive "P")
283: (if (not lines)
284: (setq view-scroll-size (view-window-size))
285: (setq lines (prefix-numeric-value lines))
286: (setq view-scroll-size
287: (min (if (> lines 0) lines (- lines)) (view-window-size))))
288: (View-scroll-lines-forward lines))
289:
290: (defun View-scroll-one-more-line (&optional arg)
291: "Scroll one more line up in View mode.
292: With ARG scroll one line down."
293: (interactive "P")
294: (View-scroll-lines-forward (if (not arg) 1 -1)))
295:
296: (defun View-scroll-lines-backward (&optional lines)
297: "Scroll backward in View mode.
298: No arg means whole window full, or number of lines set by \\[View-scroll-lines-forward-set-scroll-size].
299: Arg is number of lines to scroll."
300: (interactive "P")
301: (View-scroll-lines-forward (if lines
302: (- (prefix-numeric-value lines))
303: (- (view-scroll-size)))))
304:
305: (defun View-search-regexp-forward (times regexp)
306: "Search forward for NTH occurrence of REGEXP in View mode.
307: Displays line found at center of window. REGEXP is remembered for
308: searching with \\[View-search-last-regexp-forward] and \\[View-search-last-regexp-backward]. Sets mark at starting position and pushes mark ring."
309: (interactive "p\nsSearch forward (regexp): ")
310: (if (> (length regexp) 0)
311: (progn
312: ;(view-last-command 'View-search-last-regexp-forward times)
313: (view-search times regexp))))
314:
315: (defun View-search-regexp-backward (times regexp)
316: "Search backward from window start for NTH instance of REGEXP in View mode.
317: Displays line found at center of window. REGEXP is remembered for
318: searching with \\[View-search-last-regexp-forward] and \\[View-search-last-regexp-backward]. Sets mark at starting position and pushes mark ring."
319: (interactive "p\nsSearch backward (regexp): ")
320: (View-search-regexp-forward (- times) regexp))
321:
322: (defun View-search-last-regexp-forward (times)
323: "Search forward from window end for NTH instance of last regexp in View mode.
324: Displays line found at center of window. Sets mark at starting position
325: and pushes mark ring."
326: (interactive "p")
327: (View-search-regexp-forward times view-last-regexp))
328:
329: (defun View-search-last-regexp-backward (times)
330: "Search backward from window start for NTH instance of last regexp in View mode.
331: Displays line found at center of window. Sets mark at starting position and
332: pushes mark ring."
333: (interactive "p")
334: (View-search-regexp-backward times view-last-regexp))
335:
336: (defun View-back-to-mark (&optional ignore)
337: "Return to last mark set in View mode, else beginning of file.
338: Displays line at center of window. Pops mark ring so successive
339: invocations return to earlier marks."
340: (interactive)
341: (goto-char (or (mark) (point-min)))
342: (pop-mark)
343: (recenter (/ (view-window-size) 2)))
344:
345: (defun view-search (times regexp)
346: (setq view-last-regexp regexp)
347: (let (where)
348: (save-excursion
349: (move-to-window-line (if (< times 0) 0 -1))
350: (if (re-search-forward regexp nil t times)
351: (setq where (point))))
352: (if where
353: (progn
354: (push-mark)
355: (goto-char where)
356: (beginning-of-line)
357: (recenter (/ (view-window-size) 2)))
358: (message "Can't find occurrence %d of %s" times regexp)
359: (sit-for 4))))
360:
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.