branch: master
commit 91955926a420f62394af56d9264341e344abfcdf
Author: Stephen Leake <stephen_le...@stephe-leake.org>
Commit: Stephen Leake <stephen_le...@stephe-leake.org>

    Package other-frame-window; improve description
    
    * packages/other-frame-window/other-frame-window.el: Improve description
    in Commentary, for list-packages. Mention display-buffer-alist, not
    display-buffer-overriding-action.
---
 packages/other-frame-window/other-frame-window.el | 40 +++++++++++------------
 1 file changed, 20 insertions(+), 20 deletions(-)

diff --git a/packages/other-frame-window/other-frame-window.el 
b/packages/other-frame-window/other-frame-window.el
index dfa40e6..9c1f9ba 100644
--- a/packages/other-frame-window/other-frame-window.el
+++ b/packages/other-frame-window/other-frame-window.el
@@ -25,17 +25,33 @@
 ;;
 ;;; Commentary:
 ;;
-;; C-x 7 <command> causes a buffer displayed by <command>
-;; to appear in another window in the same frame; a window
+;; other-frame-window provides prefix key sequences to control where a
+;; new buffer is created by a subsequent command. With no prefix, the
+;; buffer is created where the command decides (nominally the currently
+;; selected window). Prefix C-x 7 causes the buffer to appear in
+;; another window in the same frame; a window is created if necessary.
+;; Prefix C-x 9 causes the buffer to appear in another frame; a frame
 ;; is created if necessary.
 ;;
-;; C-x 9 <command> causes a buffer displayed by <command>
-;; to appear in another frame; a frame is created if necessary.
+;; Some commands display new buffers in other than the currently
+;; selected window, which defeats the purpose of ‘other-frame-window’ in
+;; the absense of a prefix. To override that, customize
+;; ‘display-buffer-alist’ for those commands. For example, to override
+;; ‘gud-gdb’:
+;;
+;; (add-to-list
+;;  'display-buffer-alist
+;;  (cons "\\*gud"
+;;      (cons 'display-buffer-same-window nil)))
+;; )
+;;
+;; Other key bindings provided by other-frame-window:
 ;;
 ;; C-x W moves the current buffer to another window in the same frame.
 ;;
 ;; C-x F moves the current buffer to another frame.
 ;;
+;;
 ;; In addition, C-x 7 and C-x 9 can be followed by these keys:
 ;;
 ;; 0 - deletes the current window.
@@ -62,13 +78,6 @@
 ;;
 ;; To extend this list, add key bindings to ‘ofw-transient-map’.
 ;;
-;; Some code in Emacs uses an explicit list of actions in a call to
-;; display-buffer, which can defeat the purpose of
-;; other-frame-window. To override that, add:
-;;
-;; (setq display-buffer-overriding-action (cons (list 
'display-buffer-same-window) nil))
-;;
-;; to your Emacs init file.
 
 ;;;; Usage:
 ;;
@@ -308,15 +317,6 @@ m - compose mail in another window/frame.
 o - select another window/frame.
 
 r - find-file-read-only in another window/frame.
-
-To extend this list, add key bindings to ‘ofw-transient-map’.
-
-To override default Emacs behavior in the absence of a prefix, do:
-
-\(setq display-buffer-overriding-action
-  (cons (list 'display-buffer-same-window) nil))
-
-in your init file.
 "
   :global t
 

Reply via email to