Re: svn: /phpdoc/en/trunk/reference/array/functions/ array-product.xml

On Feb 25, 2013, at 2:03 PM, Ferenc Kovacs <tyra3l@gmail.com> wrote: > On Mon, Feb 25, 2013 at 9:50 PM, Hannes Magnusson < > hannes.magnusson@gmail.com> wrote: > >> We don't document bugs, and that bug you are linking to seems totally >> unrelated. >> >> -Hannes >> >> > I suppose the commit was in response to > https://bugs.php.net/bug.php?id=61078 which points to > http://svn.php.net/viewvc?view=revision&revision=306288 > which in turn > points to https://bugs.php.net/bug.php?id=48484 > But I agree that we shouldn't document bugs, as for example, the current > behavior was the original until 5.1.0 when it was changed in response to > http://bugs.php.net/35014 I'm not sure if you guys mean we don't document bugs, or if we don't link to bug reports for changes in behavior, but if this is a change in behavior/functionality then it deserves a changelog entry. Not for a single version but these changes cover several years. Are you saying that PHP versions 5.1.0 and 5.3.6 both changed the behavior of this function? If so, I think they both deserve a changelog entry. Something like: 5.1.0: Doing foo now returns bar, instead of baz 5.3.6: Doing foo now returns baz, instead of bar The second entry might also refer to pre-5.1.0 behavior. Regards, Philip