From: Lars Ingebrigtsen <larsi@gnus.org>
Date: Wed, 30 Sep 2020 18:29:16 +0000 (+0200)
Subject: Further doc fixes for dotimes about RESULT
X-Git-Tag: emacs-27.1.90~47
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=9d02e6c5ff2a8af78ca8a2c934970f8a46dcef55;p=emacs.git

Further doc fixes for dotimes about RESULT

* lisp/subr.el (dotimes): Be even more explicit about RESULT
(bug#16206).

(cherry picked from commit 5b0d8d0f288fd505ca90bd30df709a5e7ab540d6)
---

diff --git a/lisp/subr.el b/lisp/subr.el
index fcbd06a449f..d5cf7fb0031 100644
--- a/lisp/subr.el
+++ b/lisp/subr.el
@@ -280,8 +280,11 @@ Then evaluate RESULT to get return value, default nil.
 (defmacro dotimes (spec &rest body)
   "Loop a certain number of times.
 Evaluate BODY with VAR bound to successive integers running from 0,
-inclusive, to COUNT, exclusive.  Then evaluate RESULT to get
-the return value (nil if RESULT is omitted).  Its use is deprecated.
+inclusive, to COUNT, exclusive.
+
+Finally RESULT is evaluated to get the return value (nil if
+RESULT is omitted).  Using RESULT is deprecated, and may result
+in compilation warnings about unused variables.
 
 \(fn (VAR COUNT [RESULT]) BODY...)"
   (declare (indent 1) (debug dolist))