bug#45715: 27.1; Doc string of `dotimes'

[Lars Ingebrigtsen]

Drew Adams <drew.adams@oracle.com> writes:

>   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.
>                                             ^^^
>
> In the last sentence, "its" is unclear.

Indeed, which is why it's

---
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.
---

in Emacs 28.

> Also, that sentence is missing from the doc string of `cl-dotimes',
> even though it is present in the CL Info manual.  And for `cl-dotimes'
> it should be made clear that this "deprecation" is only about the
> Emacs Lisp emulation; the RETURN arg for Common Lisp `dotimes' has not
> been deprecated.

The two are different functions, so I don't see why.  Closing.

-- 
(domestic pets only, the antidote for overdose, milk.)
   bloggy blog: http://lars.ingebrigtsen.no