diff options
author | Martin Rudalics <rudalics@gmx.at> | 2021-10-18 09:58:48 +0200 |
---|---|---|
committer | Martin Rudalics <rudalics@gmx.at> | 2021-10-18 09:58:48 +0200 |
commit | e74e17c1f020b4570f7e63b3703c12a406985479 (patch) | |
tree | 531205ef11a856025d20e12b51f40d6e55da9063 /doc/lispref/buffers.texi | |
parent | 3b138917b792695cc015a4a6786e171e768dc708 (diff) | |
download | emacs-e74e17c1f020b4570f7e63b3703c12a406985479.tar.gz |
Rewrites of Elisp manual including tab-bar and tab-line changes
* doc/lispref/buffers.texi (Current Buffer, Buffer List): Update
references to 'selected-window'.
* doc/lispref/elisp.texi (Top): Move up Selecting Windows section
in front of Window Sizes section.
* doc/lispref/frames.texi (Creating Frames): Say window system
instead of windowing system.
(Frame Layout): Add Tab Bar to layout.
(Layout Parameters): Add 'tab-bar-lines'.
(Input Focus): Say window system window instead of window
manager window. Fix reference to 'selected-window'.
* doc/lispref/objects.texi (Window Type): Minor rewrite.
* doc/lispref/windows.texi (Basic Windows): Rewrite. Settle on
term 'window system window' for disambiguation with our windows.
Move 'selected-window' description to Selecting Windows section.
Move schematic of window structure here. Use 'decorations' for
objects outside the window body. Say that the areas reserved
for continuation and truncation glyphs, vertical dividers and
line numbers are part of the window body.
(Windows and Frames): Minor rewrite, adding and fixing some
cross references. Move live window schematic to 'Basic Windows'
section.
(Selecting Windows): Move section in front of Window Sizes
section. Move description of 'selected-window' here. Move up
description of 'frame-selected-window' and
'set-frame-selected-window'. Update and move description of
'window-bump-use-time' here.
(Window Sizes): Throughout use the term 'decorations' instead of
enumerating them individually. Add 'window-tab-line-height'
description.
(Resizing Windows): Again use the term 'decorations' instead of
enumerating them individually.
(Splitting Windows): Minor fix.
(Cyclic Window Ordering): Improve descriptions of 'get-lru-window'
and 'get-mru-window'. Move 'window-bump-use-time' to Selecting
Windows section.
(Coordinates and Windows, Window Configurations): Once more use
the term 'decorations' instead of enumerating them individually.
* src/window.c (Fwindow_bump_use_time): Move after
'window-use-time'. Make it work for live windows only. Make
WINDOW argument optional. Update doc-string.
Diffstat (limited to 'doc/lispref/buffers.texi')
-rw-r--r-- | doc/lispref/buffers.texi | 44 |
1 files changed, 23 insertions, 21 deletions
diff --git a/doc/lispref/buffers.texi b/doc/lispref/buffers.texi index 55e9d00d8bf..6a0095dca97 100644 --- a/doc/lispref/buffers.texi +++ b/doc/lispref/buffers.texi @@ -89,11 +89,12 @@ in which most editing takes place. Most of the primitives for examining or changing text operate implicitly on the current buffer (@pxref{Text}). - Normally, the buffer displayed in the selected window is the current -buffer, but this is not always so: a Lisp program can temporarily -designate any buffer as current in order to operate on its contents, -without changing what is displayed on the screen. The most basic -function for designating a current buffer is @code{set-buffer}. + Normally, the buffer displayed in the selected window +(@pxref{Selecting Windows}) is the current buffer, but this is not +always so: a Lisp program can temporarily designate any buffer as +current in order to operate on its contents, without changing what is +displayed on the screen. The most basic function for designating a +current buffer is @code{set-buffer}. @defun current-buffer This function returns the current buffer. @@ -118,12 +119,12 @@ on it. When an editing command returns to the editor command loop, Emacs automatically calls @code{set-buffer} on the buffer shown in the -selected window. This is to prevent confusion: it ensures that the -buffer that the cursor is in, when Emacs reads a command, is the -buffer to which that command applies (@pxref{Command Loop}). Thus, -you should not use @code{set-buffer} to switch visibly to a different -buffer; for that, use the functions described in @ref{Switching -Buffers}. +selected window (@pxref{Selecting Windows}). This is to prevent +confusion: it ensures that the buffer that the cursor is in, when Emacs +reads a command, is the buffer to which that command applies +(@pxref{Command Loop}). Thus, you should not use @code{set-buffer} to +switch visibly to a different buffer; for that, use the functions +described in @ref{Switching Buffers}. When writing a Lisp function, do @emph{not} rely on this behavior of the command loop to restore the current buffer after an operation. @@ -912,16 +913,17 @@ History}) provided it is shown in that window. If @var{buffer-or-name} is @code{nil} or omitted, this means to bury the current buffer. In addition, if the current buffer is displayed in the -selected window, this makes sure that the window is either deleted or -another buffer is shown in it. More precisely, if the selected window -is dedicated (@pxref{Dedicated Windows}) and there are other windows on -its frame, the window is deleted. If it is the only window on its frame -and that frame is not the only frame on its terminal, the frame is -dismissed by calling the function specified by -@code{frame-auto-hide-function} (@pxref{Quitting Windows}). Otherwise, -it calls @code{switch-to-prev-buffer} (@pxref{Window History}) to show -another buffer in that window. If @var{buffer-or-name} is displayed in -some other window, it remains displayed there. +selected window (@pxref{Selecting Windows}), this makes sure that the +window is either deleted or another buffer is shown in it. More +precisely, if the selected window is dedicated (@pxref{Dedicated +Windows}) and there are other windows on its frame, the window is +deleted. If it is the only window on its frame and that frame is not +the only frame on its terminal, the frame is dismissed by calling the +function specified by @code{frame-auto-hide-function} (@pxref{Quitting +Windows}). Otherwise, it calls @code{switch-to-prev-buffer} +(@pxref{Window History}) to show another buffer in that window. If +@var{buffer-or-name} is displayed in some other window, it remains +displayed there. To replace a buffer in all the windows that display it, use @code{replace-buffer-in-windows}, @xref{Buffers and Windows}. |