X-Git-Url: https://code.delx.au/gnu-emacs/blobdiff_plain/b3d90e4611747fe8aa17c2e3e8895b8749276712..17e5726d3b54cae3c791603ee0eebc547c8756f3:/lispref/windows.texi diff --git a/lispref/windows.texi b/lispref/windows.texi index 5f21b1977b..96f4d5af69 100644 --- a/lispref/windows.texi +++ b/lispref/windows.texi @@ -1,7 +1,7 @@ @c -*-texinfo-*- @c This is part of the GNU Emacs Lisp Reference Manual. @c Copyright (C) 1990, 1991, 1992, 1993, 1994, 1995, 1998, 1999, 2001, -@c 2002, 2003, 2004, 2005, 2006, 2007 Free Software Foundation, Inc. +@c 2002, 2003, 2004, 2005, 2006, 2007, 2008 Free Software Foundation, Inc. @c See the file elisp.texi for copying conditions. @setfilename ../info/windows @node Windows, Frames, Buffers, Top @@ -55,15 +55,11 @@ multiple nonoverlapping Emacs windows. In each frame, at any time, one and only one window is designated as @dfn{selected within the frame}. The frame's cursor appears in that window, but the other windows have ``non-selected'' cursors, normally -less visible. At any time, one frame is the selected frame; and the -window selected within that frame is @dfn{the selected window}. The -selected window's buffer is usually the current buffer (except when -@code{set-buffer} has been used). @xref{Current Buffer}. - -@defvar cursor-in-non-selected-windows -If this variable is @code{nil}, Emacs displays only one cursor, -in the selected window. Other windows have no cursor at all. -@end defvar +less visible. (@pxref{Cursor Parameters}, for customization of this.) +At any time, one frame is the selected frame; and the window selected +within that frame is @dfn{the selected window}. The selected window's +buffer is usually the current buffer (except when @code{set-buffer} +has been used). @xref{Current Buffer}. For practical purposes, a window exists only while it is displayed in a frame. Once removed from the frame, the window is effectively deleted @@ -430,7 +426,7 @@ This function always returns @code{nil}. @node Selecting Windows @section Selecting Windows -@cindex selecting windows +@cindex selecting a window When a window is selected, the buffer in the window becomes the current buffer, and the cursor will appear in it. @@ -572,7 +568,7 @@ In general, within each set of siblings at any level in the window tree, the order is left to right, or top to bottom. @defun next-window &optional window minibuf all-frames -@cindex minibuffer window +@cindex minibuffer window, and @code{next-window} This function returns the window following @var{window} in the cyclic ordering of windows. This is the window that @kbd{C-x o} would select if typed when @var{window} is selected. If @var{window} is the only @@ -1195,6 +1191,7 @@ point and the buffer's point always move together; they remain equal. @noindent @xref{Positions}, for more details on buffer positions. +@cindex cursor As far as the user is concerned, point is where the cursor is, and when the user switches to another buffer, the cursor jumps to the position of point in that buffer. @@ -1223,6 +1220,7 @@ this simply does @code{goto-char}. @node Window Start @section The Window Start Position +@cindex window start position Each window contains a marker used to keep track of a buffer position that specifies where in the buffer display should start. This position @@ -1231,6 +1229,15 @@ is called the @dfn{display-start} position of the window (or just the at the upper left corner of the window. It is usually, but not inevitably, at the beginning of a text line. + After switching windows or buffers, and in some other cases, if the +window start is in the middle of a line, Emacs adjusts the window +start to the start of a line. This prevents certain operations from +leaving the window start at a meaningless point within a line. This +feature may interfere with testing some Lisp code by executing it +using the commands of Lisp mode, because they trigger this +readjustment. To test such code, put it into a command and bind the +command to a key. + @defun window-start &optional window @cindex window top line This function returns the display-start position of window @@ -1298,10 +1305,10 @@ However, if you specify the start position with this function using screen. If this does place point off screen, the display routines move point to the left margin on the middle line in the window. -For example, if point @w{is 1} and you set the start of the window @w{to -2}, then point would be ``above'' the top of the window. The display -routines will automatically move point if it is still 1 when redisplay -occurs. Here is an example: +For example, if point @w{is 1} and you set the start of the window +@w{to 37}, the start of the next line, point will be ``above'' the top +of the window. The display routines will automatically move point if +it is still 1 when redisplay occurs. Here is an example: @example @group @@ -1323,15 +1330,17 @@ occurs. Here is an example: @group (set-window-start (selected-window) - (1+ (window-start))) -@result{} 2 + (save-excursion + (goto-char 1) + (forward-line 1) + (point))) +@result{} 37 @end group @group ;; @r{Here is what @samp{foo} looks like after executing} ;; @r{the @code{set-window-start} expression.} ---------- Buffer: foo ---------- -his is the contents of buffer foo. 2 3 @point{}4 @@ -1621,7 +1630,7 @@ Replaces three keystroke sequence C-u 0 C-l." @node Vertical Scrolling @section Vertical Fractional Scrolling -@cindex Vertical Fractional Scrolling +@cindex vertical fractional scrolling @dfn{Vertical fractional scrolling} means shifting the image in the window up or down by a specified multiple or fraction of a line. @@ -1885,6 +1894,12 @@ If @var{window} is @code{nil}, the function uses the selected window. @end example @end defun +@defun window-full-width-p &optional window +This function returns non-@code{nil} if @var{window} is as wide as +the frame that contains it; otherwise @code{nil}. +If @var{window} is @code{nil}, the function uses the selected window. +@end defun + @defun window-edges &optional window This function returns a list of the edge coordinates of @var{window}. If @var{window} is @code{nil}, the selected window is used. @@ -1985,6 +2000,7 @@ in character lines and columns. @node Resizing Windows @section Changing the Size of a Window @cindex window resizing +@cindex resize window @cindex changing window size @cindex window size, changing @@ -2237,13 +2253,13 @@ similar to the value returned by @code{window-edges}. @cindex saving window information A @dfn{window configuration} records the entire layout of one -frame---all windows, their sizes, which buffers they contain, what -part of each buffer is displayed, and the values of point and the -mark; also their fringes, margins, and scroll bar settings. It also +frame---all windows, their sizes, which buffers they contain, how +those buffers are scrolled, and their values of point and the mark; +also their fringes, margins, and scroll bar settings. It also includes the values of @code{window-min-height}, -@code{window-min-width} and @code{minibuffer-scroll-window}. An -exception is made for point in the selected window for the current -buffer; its value is not saved in the window configuration. +@code{window-min-width} and @code{minibuffer-scroll-window}. As a +special exception, the window configuration does not record the value +of point in the selected window for the current buffer. You can bring back an entire previous layout by restoring a window configuration previously saved. If you want to record all frames @@ -2355,6 +2371,7 @@ configurations. @node Window Hooks @section Hooks for Window Scrolling and Changes +@cindex hooks for window operations This section describes how a Lisp program can take action whenever a window displays a different part of its buffer or a different buffer.