comparison lisp/frame.el @ 3061:fd1acd2f457a

[xemacs-hg @ 2005-11-13 07:39:26 by ben] fix 'foo -> `foo', `foo.' -> `foo'. derived.el, frame.el, toolbar.el, glyphs.el, hyper-apropos.el, mouse.el, files.el, specifier.el: Fix uses of `foo'; change 'foo -> `foo', and put punctuation outside of quotes. Add comments in specifier.el about needing better and new convenience functions.
author ben
date Sun, 13 Nov 2005 07:39:29 +0000
parents 491f8cf78a9c
children dd935ef485d2
comparison
equal deleted inserted replaced
3060:7679bfa253c2 3061:fd1acd2f457a
1772 ;; changes to the selected frame. 1772 ;; changes to the selected frame.
1773 (defun get-frame-for-buffer (buffer &optional not-this-window-p on-frame 1773 (defun get-frame-for-buffer (buffer &optional not-this-window-p on-frame
1774 shrink-to-fit) 1774 shrink-to-fit)
1775 "Select and return a frame in which to display BUFFER. 1775 "Select and return a frame in which to display BUFFER.
1776 Normally, the buffer will simply be displayed in the selected frame. 1776 Normally, the buffer will simply be displayed in the selected frame.
1777 But if the symbol naming the major-mode of the buffer has a 'frame-name 1777 But if the symbol naming the major-mode of the buffer has a `frame-name'
1778 property (which should be a symbol), then the buffer will be displayed in 1778 property (which should be a symbol), then the buffer will be displayed in
1779 a frame of that name. If there is no frame of that name, then one is 1779 a frame of that name. If there is no frame of that name, then one is
1780 created. 1780 created.
1781 1781
1782 If the major-mode doesn't have a 'frame-name property, then the frame 1782 If the major-mode doesn't have a `frame-name' property, then the frame
1783 named by `get-frame-for-buffer-default-frame-name' will be used. If 1783 named by `get-frame-for-buffer-default-frame-name' will be used. If
1784 that is nil (the default) then the currently selected frame will used. 1784 that is nil (the default) then the currently selected frame will used.
1785 1785
1786 If the frame-name symbol has an 'instance-limit property (an integer) 1786 If the frame-name symbol has an `instance-limit' property (an integer)
1787 then each time a buffer of the mode in question is displayed, a new frame 1787 then each time a buffer of the mode in question is displayed, a new frame
1788 with that name will be created, until there are `instance-limit' of them. 1788 with that name will be created, until there are `instance-limit' of them.
1789 If instance-limit is 0, then a new frame will be created each time. 1789 If instance-limit is 0, then a new frame will be created each time.
1790 1790
1791 If a buffer is already displayed in a frame, then `instance-limit' is 1791 If a buffer is already displayed in a frame, then `instance-limit' is
1792 ignored, and that frame is used. 1792 ignored, and that frame is used.
1793 1793
1794 If the frame-name symbol has a 'frame-defaults property, then that is 1794 If the frame-name symbol has a `frame-defaults' property, then that is
1795 prepended to the `default-frame-plist' when creating a frame for the 1795 prepended to the `default-frame-plist' when creating a frame for the
1796 first time. 1796 first time.
1797 1797
1798 This function may be used as the value of `pre-display-buffer-function', 1798 This function may be used as the value of `pre-display-buffer-function',
1799 to cause the `display-buffer' function and its callers to exhibit the 1799 to cause the `display-buffer' function and its callers to exhibit the