Merge remote-tracking branch 'origin/master' into for-steve
[sxemacs] / lisp / buffer.el
1 ;;; buffer.el --- buffer routines taken from C
2
3 ;; Copyright (C) 1985-1989, 1992-1995, 1997 Free Software Foundation, Inc.
4 ;; Copyright (C) 1995 Sun Microsystems.
5 ;; Copyright (C) 1995, 1996 Ben Wing.
6
7 ;; Maintainer: SXEmacs Development Team
8 ;; Keywords: internal, dumped
9
10 ;; This file is part of SXEmacs.
11
12 ;; SXEmacs is free software: you can redistribute it and/or modify
13 ;; it under the terms of the GNU General Public License as published by
14 ;; the Free Software Foundation, either version 3 of the License, or
15 ;; (at your option) any later version.
16
17 ;; SXEmacs is distributed in the hope that it will be useful,
18 ;; but WITHOUT ANY WARRANTY; without even the implied warranty of
19 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
20 ;; GNU General Public License for more details.
21
22 ;; You should have received a copy of the GNU General Public License
23 ;; along with this program.  If not, see <http://www.gnu.org/licenses/>.
24
25 ;;; Synched up with: FSF 19.30 buffer.c.
26
27 ;;; Commentary:
28
29 ;; This file is dumped with SXEmacs.
30
31 ;;; Code:
32
33 (defun switch-to-buffer (bufname &optional norecord)
34   "Select buffer BUFNAME in the current window.
35 BUFNAME may be a buffer or a buffer name and is created if it did not exist.
36 Optional second arg NORECORD non-nil means do not put this buffer at the
37 front of the list of recently selected ones.
38
39 WARNING: This is NOT the way to work on another buffer temporarily
40 within a Lisp program!  Use `set-buffer' instead.  That avoids messing with
41 the window-buffer correspondences."
42   (interactive "BSwitch to buffer: ")
43   ;; #ifdef I18N3
44   ;; #### Doc string should indicate that the buffer name will get
45   ;; translated.
46   ;; #endif
47   (if (eq (minibuffer-window) (selected-window))
48       (error "Cannot switch buffers in minibuffer window"))
49   (if (window-dedicated-p (selected-window))
50       (error "Cannot switch buffers in a dedicated window"))
51   (let (buf)
52     (if (null bufname)
53         (setq buf (other-buffer (current-buffer)))
54       (setq buf (get-buffer bufname))
55       (if (null buf)
56           (progn
57             (setq buf (get-buffer-create bufname))
58             (set-buffer-major-mode buf))))
59     (push-window-configuration)
60     (set-buffer buf)
61     (set-window-buffer (last-nonminibuf-window) buf norecord)
62     buf))
63
64 (defun pop-to-buffer (bufname &optional not-this-window-p on-frame)
65   "Select buffer BUFNAME in some window, preferably a different one.
66 If BUFNAME is nil, then some other buffer is chosen.
67 If `pop-up-windows' is non-nil, windows can be split to do this.
68 If optional second arg NOT-THIS-WINDOW-P is non-nil, insist on finding
69 another window even if BUFNAME is already visible in the selected window.
70 If optional third arg is non-nil, it is the frame to pop to this
71 buffer on.
72 If `focus-follows-mouse' is non-nil, keyboard focus is left unchanged.
73
74 Buffers with names that are members of the `same-window-buffer-names'
75 list, or that match an element of the `same-window-regexps' list are
76 treated specially by this function--they are always selected in the
77 same window rather than in a different one."
78   ;; #ifdef I18N3
79   ;; #### Doc string should indicate that the buffer name will get
80   ;; translated.
81   ;; #endif
82   ;; This is twisted.  It is evil to throw the keyboard focus around
83   ;; willy-nilly if the user wants focus-follows-mouse.
84   (let ((oldbuf (current-buffer))
85         buf window frame)
86     (if (null bufname)
87         (setq buf (other-buffer (current-buffer)))
88       (setq buf (get-buffer bufname))
89       (if (null buf)
90           (progn
91             (setq buf (get-buffer-create bufname))
92             (set-buffer-major-mode buf))))
93     (push-window-configuration)
94     (set-buffer buf)
95     (setq window (display-buffer buf not-this-window-p on-frame))
96     (setq frame (window-frame window))
97     ;; if the display-buffer hook decided to show this buffer in another
98     ;; frame, then select that frame, (unless obeying focus-follows-mouse -sb).
99     (if (and (not focus-follows-mouse)
100              (not (eq frame (selected-frame))))
101         (select-frame frame))
102     (record-buffer buf)
103     (if (and focus-follows-mouse
104              on-frame
105              (not (eq on-frame (selected-frame))))
106         (set-buffer oldbuf)
107       ;; select-window will modify the internal keyboard focus of XEmacs
108       (select-window window))
109     buf))
110
111 ;;; buffer.el ends here