[Emacs-diffs] emacs/doc/lispref ChangeLog positions.texi

[Lute Kamstra]

CVSROOT:        /sources/emacs
Module name:    emacs
Changes by:     Lute Kamstra <lute>     08/11/22 17:37:39

Modified files:
        doc/lispref    : ChangeLog positions.texi 

Log message:
        (Text Lines): Update goto-line documentation.

CVSWeb URLs:
http://cvs.savannah.gnu.org/viewcvs/emacs/doc/lispref/ChangeLog?cvsroot=emacs&r1=1.150&r2=1.151
http://cvs.savannah.gnu.org/viewcvs/emacs/doc/lispref/positions.texi?cvsroot=emacs&r1=1.6&r2=1.7

Patches:
Index: ChangeLog
===================================================================
RCS file: /sources/emacs/emacs/doc/lispref/ChangeLog,v
retrieving revision 1.150
retrieving revision 1.151
diff -u -b -r1.150 -r1.151
--- ChangeLog   21 Nov 2008 10:18:27 -0000      1.150
+++ ChangeLog   22 Nov 2008 17:37:38 -0000      1.151
@@ -1,3 +1,7 @@
+2008-11-22  Lute Kamstra  <address@hidden>
+
+       * positions.texi (Text Lines): Update goto-line documentation.
+
 2008-11-21  Martin Rudalics  <address@hidden>
 
        * frames.texi (Frames): Fix typo, add cross references, reword.

Index: positions.texi
===================================================================
RCS file: /sources/emacs/emacs/doc/lispref/positions.texi,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -b -r1.6 -r1.7
--- positions.texi      27 Oct 2008 21:30:00 -0000      1.6
+++ positions.texi      22 Nov 2008 17:37:39 -0000      1.7
@@ -299,14 +299,13 @@
 of the window, by line continuation in display, or by how tabs and
 control characters are displayed.
 
address@hidden Command goto-line line
address@hidden Command goto-line line &optional buffer
 This function moves point to the front of the @var{line}th line,
-counting from line 1 at beginning of the buffer.  If @var{line} is less
-than 1, it moves point to the beginning of the buffer.  If @var{line} is
-greater than the number of lines in the buffer, it moves point to the
-end of the buffer---that is, the @emph{end of the last line} of the
-buffer.  This is the only case in which @code{goto-line} does not
-necessarily move to the beginning of a line.
+counting from line 1 at beginning of the buffer, and leaves mark at the
+previous position.  If @var{line} is less than 1, it moves point to the
+beginning of the buffer.  If @var{line} is greater than the number of
+lines in the buffer, it moves point to the end of the buffer---that is,
+the @emph{end of the last line} of the buffer.
 
 If narrowing is in effect, then @var{line} still counts from the
 beginning of the buffer, but point cannot go outside the accessible
@@ -319,11 +318,12 @@
 able to move (in the full buffer, before taking account of narrowing).
 Thus, the value is positive if the scan encounters the real end of the
 buffer before finding the specified line.  The value is zero if scan
-encounters the end of the accessible portion but not the real end of the
-buffer.
+encounters the end of the accessible portion, but not the real end of
+the buffer.
 
-In an interactive call, @var{line} is the numeric prefix argument if
-one has been provided.  Otherwise @var{line} is read in the minibuffer.
+If you provide the optional argument @var{buffer}, @code{goto-line} uses
address@hidden instead of the current buffer and displays it in another
+window, if it was not already visible.
 @end deffn
 
 @deffn Command beginning-of-line &optional count