Commit 431b78c9 authored by Richard M. Stallman's avatar Richard M. Stallman
Browse files

(Window Start): Mention the feature of moving

window-start to start of line.
parent 27c33569
2008-02-07 Richard Stallman <rms@gnu.org>
* windows.texi (Window Start): Mention the feature of moving
window-start to start of line.
2008-01-19 Martin Rudalics <rudalics@gmx.at> 2008-01-19 Martin Rudalics <rudalics@gmx.at>
* buffers.texi (Buffer Modification): Fix typo. * buffers.texi (Buffer Modification): Fix typo.
......
...@@ -1229,6 +1229,15 @@ is called the @dfn{display-start} position of the window (or just the ...@@ -1229,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 at the upper left corner of the window. It is usually, but not
inevitably, at the beginning of a text line. 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 @defun window-start &optional window
@cindex window top line @cindex window top line
This function returns the display-start position of window This function returns the display-start position of window
...@@ -1296,10 +1305,10 @@ However, if you specify the start position with this function using ...@@ -1296,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 screen. If this does place point off screen, the display routines move
point to the left margin on the middle line in the window. 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 For example, if point @w{is 1} and you set the start of the window
2}, then point would be ``above'' the top of the window. The display @w{to 37}, the start of the next line, point will be ``above'' the top
routines will automatically move point if it is still 1 when redisplay of the window. The display routines will automatically move point if
occurs. Here is an example: it is still 1 when redisplay occurs. Here is an example:
@example @example
@group @group
...@@ -1321,15 +1330,17 @@ occurs. Here is an example: ...@@ -1321,15 +1330,17 @@ occurs. Here is an example:
@group @group
(set-window-start (set-window-start
(selected-window) (selected-window)
(1+ (window-start))) (save-excursion
@result{} 2 (goto-char 1)
(forward-line 1)
(point)))
@result{} 37
@end group @end group
@group @group
;; @r{Here is what @samp{foo} looks like after executing} ;; @r{Here is what @samp{foo} looks like after executing}
;; @r{the @code{set-window-start} expression.} ;; @r{the @code{set-window-start} expression.}
---------- Buffer: foo ---------- ---------- Buffer: foo ----------
his is the contents of buffer foo.
2 2
3 3
@point{}4 @point{}4
......
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment