From 397a688f21317fbbd59a820fc20cccbad8cf89fd Mon Sep 17 00:00:00 2001 From: Chong Yidong Date: Mon, 12 Mar 2012 00:57:04 +0800 Subject: [PATCH] * simple.el (goto-line): Doc fix. Fixes: debbugs:9938 --- lisp/ChangeLog | 2 ++ lisp/simple.el | 19 +++++++++++++------ 2 files changed, 15 insertions(+), 6 deletions(-) diff --git a/lisp/ChangeLog b/lisp/ChangeLog index b1afb033404..55e6dfb0f50 100644 --- a/lisp/ChangeLog +++ b/lisp/ChangeLog @@ -1,5 +1,7 @@ 2012-03-11 Chong Yidong + * 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 diff --git a/lisp/simple.el b/lisp/simple.el index 45daf99f614..f42ea3e7a50 100644 --- a/lisp/simple.el +++ b/lisp/simple.el @@ -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 -- 2.11.4.GIT