changeset 105512:7104b717bbb5

(Text Lines): Remove goto-line, since it shouldn't be used from Lisp.
author Stefan Monnier <monnier@iro.umontreal.ca>
date Wed, 07 Oct 2009 14:32:08 +0000
parents cd2feab44ab1
children 1bfde4a3bd05
files doc/lispref/ChangeLog doc/lispref/positions.texi
diffstat 2 files changed, 7 insertions(+), 29 deletions(-) [+]
line wrap: on
line diff
--- a/doc/lispref/ChangeLog	Wed Oct 07 11:31:21 2009 +0000
+++ b/doc/lispref/ChangeLog	Wed Oct 07 14:32:08 2009 +0000
@@ -1,7 +1,12 @@
+2009-10-07  Stefan Monnier  <monnier@iro.umontreal.ca>
+
+	* positions.texi (Text Lines): Remove goto-line, since it shouldn't be
+	used from Lisp.
+
 2009-10-07  Eli Zaretskii  <eliz@gnu.org>
 
-	* files.texi (Directory Names) <abbreviate-file-name>: Document
-	that root home directories are not replaced with "~".
+	* files.texi (Directory Names) <abbreviate-file-name>:
+	Document that root home directories are not replaced with "~".
 
 2009-10-06  Eli Zaretskii  <eliz@gnu.org>
 
--- a/doc/lispref/positions.texi	Wed Oct 07 11:31:21 2009 +0000
+++ b/doc/lispref/positions.texi	Wed Oct 07 14:32:08 2009 +0000
@@ -299,33 +299,6 @@
 of the window, by line continuation in display, or by how tabs and
 control characters are displayed.
 
-@deffn 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, 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
-portion.  So @code{goto-line} moves point to the beginning or end of the
-accessible portion, if the line number specifies an inaccessible
-position.
-
-The return value of @code{goto-line} is the difference between
-@var{line} and the line number of the line to which point actually was
-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.
-
-If you provide the optional argument @var{buffer}, @code{goto-line} uses
-@var{buffer} 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
 This function moves point to the beginning of the current line.  With an
 argument @var{count} not @code{nil} or 1, it moves forward