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