Doc #66366 [Opn->Ver]: Undocumented breaking change, when upgrading from php 5.3

From: Date: Sun, 29 Dec 2013 04:40:34 +0000
Subject: Doc #66366 [Opn->Ver]: Undocumented breaking change, when upgrading from php 5.3
References: 1  Groups: php.doc.bugs 
Request: Send a blank email to doc-bugs+get-10749@lists.php.net to get a copy of this message 
Edit report at https://bugs.php.net/bug.php?id=66366&edit=1

 ID:                 66366
 Updated by:         bjori@php.net
 Reported by:        markuwil at gmail dot com
 Summary:            Undocumented breaking change, when upgrading from
                     php 5.3
-Status:             Open
+Status:             Verified
 Type:               Documentation Problem
 Package:            *Encryption and hash functions
 PHP Version:        Irrelevant
 Block user comment: N
 Private report:     N

 New Comment:

http://us3.php.net/manual/en/function.hash.php#refsect1-function.hash-changelog

Although, you are right, it should have been in the incompatible section too.


Previous Comments:
------------------------------------------------------------------------
[2013-12-29 04:11:44] markuwil at gmail dot com

Description:
------------
---
From manual page: http://www.php.net/migration54.incompatible
---

Re: https://bugs.php.net/bug.php?id=61291 and
fix regarding Tiger hashes.

This was never documented as a breaking change, when upgrading from 5.3. Also the only changelog
entry related to it cites big endian when the Tiger paper explicitly states little endian. I have no
insight into whether the changelog entry is correct or not but a Tiger hash is little endian whereas
php used to output it in big endian.

To actually get to the root of all of this, one has to, in the worst case, find five years old
reports and then find that they have suddenly been fixed (after first being marked as 'Not a
bug', which implies in-action) without so much as a note in documentation for hash nor mhash
(both of which have suffered from this at one time or another).

Obviously this is breaking change by proxy for anyone who does not know the Tiger specification (and
even appears a bug to anyone who reads Wikipedia, but that is irrelevant to php) or has relied on
the old behavior as correct, to generate, store or compare against hashes such hashes.



------------------------------------------------------------------------



-- 
Edit this bug report at https://bugs.php.net/bug.php?id=66366&edit=1

Thread (3 messages)

« previous php.doc.bugs (#10749) next »