diff options
| -rw-r--r-- | doc/lispref/windows.texi | 20 |
1 files changed, 10 insertions, 10 deletions
diff --git a/doc/lispref/windows.texi b/doc/lispref/windows.texi index af1e3285489..9f1026bd1f5 100644 --- a/doc/lispref/windows.texi +++ b/doc/lispref/windows.texi | |||
| @@ -51,7 +51,7 @@ buffer is displayed. The term is also used to refer to a Lisp object that | |||
| 51 | represents that screen area in Emacs Lisp. It should be | 51 | represents that screen area in Emacs Lisp. It should be |
| 52 | clear from the context which is meant. | 52 | clear from the context which is meant. |
| 53 | 53 | ||
| 54 | Emacs groups windows into frames, see @ref{Frames}. A frame | 54 | Emacs groups windows into frames; see @ref{Frames}. A frame |
| 55 | represents an area of screen available for Emacs to use. Each frame | 55 | represents an area of screen available for Emacs to use. Each frame |
| 56 | always contains at least one window, but you can subdivide it | 56 | always contains at least one window, but you can subdivide it |
| 57 | vertically or horizontally into multiple, nonoverlapping Emacs | 57 | vertically or horizontally into multiple, nonoverlapping Emacs |
| @@ -64,14 +64,14 @@ less visible. (@xref{Cursor Parameters}, for customizing this.) At | |||
| 64 | any time, one frame is the selected frame; and the window selected | 64 | any time, one frame is the selected frame; and the window selected |
| 65 | within that frame is @dfn{the selected window}. The selected window's | 65 | within that frame is @dfn{the selected window}. The selected window's |
| 66 | buffer is usually the current buffer (except when @code{set-buffer} has | 66 | buffer is usually the current buffer (except when @code{set-buffer} has |
| 67 | been used), see @ref{Current Buffer}. | 67 | been used); see @ref{Current Buffer}. |
| 68 | 68 | ||
| 69 | For practical purposes, a window exists only while it is displayed in | 69 | For practical purposes, a window exists only while it is displayed in |
| 70 | a frame. Once removed from the frame, the window is effectively deleted | 70 | a frame. Once removed from the frame, the window is effectively deleted |
| 71 | and should not be used, @emph{even though there may still be references | 71 | and should not be used, @emph{even though there may still be references |
| 72 | to it} from other Lisp objects, see @ref{Deleting Windows}. Restoring a | 72 | to it} from other Lisp objects; see @ref{Deleting Windows}. Restoring a |
| 73 | saved window configuration is the only way for a window no longer on the | 73 | saved window configuration is the only way for a window no longer on the |
| 74 | screen to come back to life, see @ref{Window Configurations}. | 74 | screen to come back to life; see @ref{Window Configurations}. |
| 75 | 75 | ||
| 76 | @cindex multiple windows | 76 | @cindex multiple windows |
| 77 | Users create multiple windows so they can look at several buffers at | 77 | Users create multiple windows so they can look at several buffers at |
| @@ -538,7 +538,7 @@ The value of the argument @var{minibuf} specifies whether the minibuffer | |||
| 538 | is included in the window order. Normally, when @var{minibuf} is | 538 | is included in the window order. Normally, when @var{minibuf} is |
| 539 | @code{nil}, the minibuffer is included only if it is currently | 539 | @code{nil}, the minibuffer is included only if it is currently |
| 540 | ``active''; this matches the behavior of @kbd{C-x o}. (The minibuffer | 540 | ``active''; this matches the behavior of @kbd{C-x o}. (The minibuffer |
| 541 | window is active while the minibuffer is in use, see @ref{Minibuffers}.) | 541 | window is active while the minibuffer is in use; see @ref{Minibuffers}.) |
| 542 | 542 | ||
| 543 | If @var{minibuf} is @code{t}, the cyclic ordering includes the | 543 | If @var{minibuf} is @code{t}, the cyclic ordering includes the |
| 544 | minibuffer window even if it is not active. If @var{minibuf} is neither | 544 | minibuffer window even if it is not active. If @var{minibuf} is neither |
| @@ -790,7 +790,7 @@ If @var{buffer-or-name} is @code{nil}, @code{switch-to-buffer} chooses a | |||
| 790 | buffer using @code{other-buffer}. If @var{buffer-or-name} is a string | 790 | buffer using @code{other-buffer}. If @var{buffer-or-name} is a string |
| 791 | that does not identify an existing buffer, then a new buffer by that | 791 | that does not identify an existing buffer, then a new buffer by that |
| 792 | name is created. The major mode for the new buffer is set according to | 792 | name is created. The major mode for the new buffer is set according to |
| 793 | the variable @code{default-major-mode}, see @ref{Auto Major Mode}. | 793 | the variable @code{default-major-mode}; see @ref{Auto Major Mode}. |
| 794 | 794 | ||
| 795 | When @code{enable-recursive-minibuffers} is non-@code{nil} and the | 795 | When @code{enable-recursive-minibuffers} is non-@code{nil} and the |
| 796 | selected window is either the minibuffer window or is dedicated to its | 796 | selected window is either the minibuffer window or is dedicated to its |
| @@ -831,7 +831,7 @@ unless @var{norecord} is non-@code{nil}. | |||
| 831 | This command makes @var{buffer-or-name} the current buffer and switches | 831 | This command makes @var{buffer-or-name} the current buffer and switches |
| 832 | to it in some window, preferably not the window previously selected. | 832 | to it in some window, preferably not the window previously selected. |
| 833 | The ``popped-to'' window becomes the selected window. Its frame is | 833 | The ``popped-to'' window becomes the selected window. Its frame is |
| 834 | given the X server's focus, if possible, see @ref{Input Focus}. The return | 834 | given the X server's focus, if possible; see @ref{Input Focus}. The return |
| 835 | value is the buffer that was switched to. | 835 | value is the buffer that was switched to. |
| 836 | 836 | ||
| 837 | If @var{buffer-or-name} is @code{nil}, that means to choose some other | 837 | If @var{buffer-or-name} is @code{nil}, that means to choose some other |
| @@ -2248,7 +2248,7 @@ specifies a frame, it balances all windows on that frame. If | |||
| 2248 | @var{window-or-frame} specifies a window, it balances this window and | 2248 | @var{window-or-frame} specifies a window, it balances this window and |
| 2249 | its ``siblings'' only. Think of a sibling as the other (original or | 2249 | its ``siblings'' only. Think of a sibling as the other (original or |
| 2250 | new) window with respect to the present one, involved in the process of | 2250 | new) window with respect to the present one, involved in the process of |
| 2251 | splitting, see @ref{Splitting Windows}. Since a sibling may have been | 2251 | splitting; see @ref{Splitting Windows}. Since a sibling may have been |
| 2252 | split again, a window can have more than one sibling. | 2252 | split again, a window can have more than one sibling. |
| 2253 | @end deffn | 2253 | @end deffn |
| 2254 | 2254 | ||
| @@ -2358,12 +2358,12 @@ fringes, margins, and scroll bar settings. It also includes the value | |||
| 2358 | of @code{minibuffer-scroll-window}. As a special exception, the window | 2358 | of @code{minibuffer-scroll-window}. As a special exception, the window |
| 2359 | configuration does not record the value of point in the selected window | 2359 | configuration does not record the value of point in the selected window |
| 2360 | for the current buffer. Also, the window configuration does not record | 2360 | for the current buffer. Also, the window configuration does not record |
| 2361 | the values of window parameters, see @ref{Window Parameters}. | 2361 | the values of window parameters; see @ref{Window Parameters}. |
| 2362 | 2362 | ||
| 2363 | You can bring back an entire frame layout by restoring a previously | 2363 | You can bring back an entire frame layout by restoring a previously |
| 2364 | saved window configuration. If you want to record the layout of all | 2364 | saved window configuration. If you want to record the layout of all |
| 2365 | frames instead of just one, use a frame configuration instead of a | 2365 | frames instead of just one, use a frame configuration instead of a |
| 2366 | window configuration, see @ref{Frame Configurations}. | 2366 | window configuration; see @ref{Frame Configurations}. |
| 2367 | 2367 | ||
| 2368 | @defun current-window-configuration &optional frame | 2368 | @defun current-window-configuration &optional frame |
| 2369 | This function returns a new object representing @var{frame}'s current | 2369 | This function returns a new object representing @var{frame}'s current |