]> code.delx.au - gnu-emacs/commitdiff
* simple.el (goto-line): Doc fix.
authorChong Yidong <cyd@gnu.org>
Sun, 11 Mar 2012 16:57:04 +0000 (00:57 +0800)
committerChong Yidong <cyd@gnu.org>
Sun, 11 Mar 2012 16:57:04 +0000 (00:57 +0800)
Fixes: debbugs:9938
lisp/ChangeLog
lisp/simple.el

index b1afb03340446a2ee7631c29b787867b06d0d98e..55e6dfb0f5029ce9948ac38a23d7aebfb459c867 100644 (file)
@@ -1,5 +1,7 @@
 2012-03-11  Chong Yidong  <cyd@gnu.org>
 
+       * simple.el (goto-line): Doc fix (Bug#9938).
+
        * subr.el (save-window-excursion): Doc fix (Bug#9979).
 
        * dabbrev.el (dabbrev--find-expansion): Update progress reporter
index 45daf99f6147c0ca1d4de3948e4fb4721a6c316c..f42ea3e7a50b84b3f8d1868e6be9059a6dd9bfdc 100644 (file)
@@ -893,16 +893,23 @@ that uses or sets the mark."
 ;; Counting lines, one way or another.
 
 (defun goto-line (line &optional buffer)
-  "Goto LINE, counting from line 1 at beginning of buffer.
-Normally, move point in the current buffer, and leave mark at the
-previous position.  With just \\[universal-argument] as argument,
-move point in the most recently selected other buffer, and switch to it.
+  "Go to LINE, counting from line 1 at beginning of buffer.
+If called interactively, a numeric prefix argument specifies
+LINE; without a numeric prefix argument, read LINE from the
+minibuffer.
+
+If optional argument BUFFER is non-nil, switch to that buffer and
+move to line LINE there.  If called interactively with \\[universal-argument]
+as argument, BUFFER is the most recently selected other buffer.
 
-If there's a number in the buffer at point, it is the default for LINE.
+Prior to moving point, this function sets the mark (without
+activating it), unless Transient Mark mode is enabled and the
+mark is already active.
 
 This function is usually the wrong thing to use in a Lisp program.
 What you probably want instead is something like:
-  (goto-char (point-min)) (forward-line (1- N))
+  (goto-char (point-min))
+  (forward-line (1- N))
 If at all possible, an even better solution is to use char counts
 rather than line counts."
   (interactive