From 754bbf7a25a8dda49b5d08ef0d0443bbf5af0e36 Mon Sep 17 00:00:00 2001 From: Craig Jennings Date: Sun, 7 Apr 2024 13:41:34 -0500 Subject: new repository --- devdocs/elisp/displaying-buffers.html | 36 +++++++++++++++++++++++++++++++++++ 1 file changed, 36 insertions(+) create mode 100644 devdocs/elisp/displaying-buffers.html (limited to 'devdocs/elisp/displaying-buffers.html') diff --git a/devdocs/elisp/displaying-buffers.html b/devdocs/elisp/displaying-buffers.html new file mode 100644 index 00000000..b0d161f7 --- /dev/null +++ b/devdocs/elisp/displaying-buffers.html @@ -0,0 +1,36 @@ +

Displaying a Buffer in a Suitable Window

This section describes lower-level functions Emacs uses to find or create a window for displaying a specified buffer. The common workhorse of these functions is display-buffer which eventually handles all incoming requests for buffer display (see Choosing Window).

display-buffer delegates the task of finding a suitable window to so-called action functions (see Buffer Display Action Functions). First, display-buffer compiles a so-called action alist—a special association list that action functions can use to fine-tune their behavior. Then it passes that alist on to each action function it calls (see Buffer Display Action Alists).

The behavior of display-buffer is highly customizable. To understand how customizations are used in practice, you may wish to study examples illustrating the order of precedence which display-buffer uses to call action functions (see Precedence of Action Functions). To avoid conflicts between Lisp programs calling display-buffer and user customizations of its behavior, it may make sense to follow a number of guidelines which are sketched in the final part of this section (see The Zen of Buffer Display).

+ + + + + + + + + + + + + + + + + + + + + + + +
• Choosing Window + How to choose a window for displaying a buffer.
• Buffer Display Action Functions + Support functions for buffer display.
• Buffer Display Action Alists + Alists for fine-tuning buffer display.
• Choosing Window Options + Extra options affecting how buffers are displayed.
• Precedence of Action Functions + Examples to explain the precedence of action functions.
• The Zen of Buffer Display + How to avoid that buffers get lost in between windows.
+

+ Copyright © 1990-1996, 1998-2022 Free Software Foundation, Inc.
Licensed under the GNU GPL license.
+ https://www.gnu.org/software/emacs/manual/html_node/elisp/Displaying-Buffers.html +

+
-- cgit v1.2.3