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

On 26/02/2013 07:15, Philip Olson wrote:

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

As Philip said it's not just a bug but a beavioral change. It's might be documented. I was investing a bug after a PHP 5.2 -> PHP 5.4 migration and I found the explaination in the changelog not in the documentation. I'll close https://bugs.php.net/bug.php?id=61078. Regards, Jean-Séb