Subject: bug#28736: 24.5; doc of `push'

From: Eli Zaretskii <[email-masked]>
Date: Sun, 08 Oct 2017 09:04:23 +0300

> Date: Sat, 7 Oct 2017 19:56:58 -0700 (PDT)
> From: Drew Adams <[email-masked]>
> 
> Both the doc string and the Elisp manual entry should say that `push'
> returns the new value of the place that it updates.  The doc says
> nothing about the return value.

That usually means we don't want to advertise the return value, and
that programs should not depend on it.  Why is that a problem in this
case?