[ci skip] Be more specific about ext-dom incompatibilities in UPGRADING (#14024)

The previous text was put there before I decided to add the new classes.
Therefore the only new feature that can affect BC is
compareDocumentPosition(). Only when the declaration is incompatible can
the user experience errors.
This commit is contained in:
Niels Dossche 2024-04-20 23:21:40 +02:00 committed by GitHub
parent 23640542dc
commit 7428a92c5b
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194

View File

@ -31,11 +31,10 @@ PHP 8.4 UPGRADE NOTES
. The type of PHP_DEBUG and PHP_ZTS constants changed to bool.
- DOM:
. New methods and constants were added to some DOM classes. If you inherit
from these and you happen to have a method or property with the same name,
you might encounter errors if the declaration is incompatible.
Consult sections 2. New Features and 6. New Functions for a list of
newly implemented methods and constants.
. Added DOMNode::compareDocumentPosition() and DOMNode::DOCUMENT_POSITION_*
constants.
If you have a method or constant with the same name, you might encounter errors
if the declaration is incompatible.
. Some DOM methods previously returned false or a PHP_ERR DOMException if a new
node could not be allocated. They consistently throw an INVALID_STATE_ERR
DOMException now. This situation is extremely unlikely though and probably