From 7f7a78b5e1bce606c89bf984c4390863293e6818 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?M=C3=A1t=C3=A9=20Kocsis?= Date: Sat, 30 Nov 2024 10:55:56 +0100 Subject: [PATCH 1/5] Synchronize manual with stubs for PHP 8.4 - part 5 --- reference/dom/domattr.xml | 7 +++++-- reference/dom/domcdatasection.xml | 5 +++++ reference/dom/domcharacterdata.xml | 5 +++++ reference/dom/domcomment.xml | 5 +++++ reference/dom/domdocument.xml | 5 +++++ reference/dom/domdocumentfragment.xml | 5 +++++ reference/dom/domdocumenttype.xml | 5 +++++ reference/dom/domelement.xml | 6 +++++- reference/dom/domentity.xml | 8 +++++--- reference/dom/domentityreference.xml | 5 +++++ reference/dom/domnode.xml | 12 ++++++------ reference/dom/domnotation.xml | 5 +++++ reference/dom/domprocessinginstruction.xml | 5 +++++ reference/dom/domtext.xml | 5 +++++ reference/dom/versions.xml | 4 ++++ 15 files changed, 75 insertions(+), 12 deletions(-) diff --git a/reference/dom/domattr.xml b/reference/dom/domattr.xml index 2b10a1bbd304..5bcb57ed420d 100644 --- a/reference/dom/domattr.xml +++ b/reference/dom/domattr.xml @@ -30,6 +30,11 @@ DOMNode + &InheritedConstants; + + + + &Properties; public @@ -42,7 +47,6 @@ readonly bool specified - true public @@ -60,7 +64,6 @@ readonly mixed schemaTypeInfo - null &InheritedProperties; diff --git a/reference/dom/domcdatasection.xml b/reference/dom/domcdatasection.xml index 35b39bab447f..e70756d6c84d 100644 --- a/reference/dom/domcdatasection.xml +++ b/reference/dom/domcdatasection.xml @@ -32,6 +32,11 @@ DOMText + &InheritedConstants; + + + + &InheritedProperties; diff --git a/reference/dom/domcharacterdata.xml b/reference/dom/domcharacterdata.xml index 58f64b081d44..138ab244687e 100644 --- a/reference/dom/domcharacterdata.xml +++ b/reference/dom/domcharacterdata.xml @@ -35,6 +35,11 @@ DOMChildNode + &InheritedConstants; + + + + &Properties; public diff --git a/reference/dom/domcomment.xml b/reference/dom/domcomment.xml index 9f58ecd39cc2..5304bf98a2da 100644 --- a/reference/dom/domcomment.xml +++ b/reference/dom/domcomment.xml @@ -30,6 +30,11 @@ DOMCharacterData + &InheritedConstants; + + + + &InheritedProperties; diff --git a/reference/dom/domdocument.xml b/reference/dom/domdocument.xml index 715e1a810dcd..5ac9907eafb8 100644 --- a/reference/dom/domdocument.xml +++ b/reference/dom/domdocument.xml @@ -35,6 +35,11 @@ DOMParentNode + &InheritedConstants; + + + + &Properties; public diff --git a/reference/dom/domdocumentfragment.xml b/reference/dom/domdocumentfragment.xml index 977a8276313c..ddce214841af 100644 --- a/reference/dom/domdocumentfragment.xml +++ b/reference/dom/domdocumentfragment.xml @@ -36,6 +36,11 @@ DOMParentNode + &InheritedConstants; + + + + &Properties; public diff --git a/reference/dom/domdocumenttype.xml b/reference/dom/domdocumenttype.xml index 389397f6a228..b24121830dfd 100644 --- a/reference/dom/domdocumenttype.xml +++ b/reference/dom/domdocumenttype.xml @@ -30,6 +30,11 @@ DOMNode + &InheritedConstants; + + + + &Properties; public diff --git a/reference/dom/domelement.xml b/reference/dom/domelement.xml index 860cd4979f6a..15ad52fc4d07 100644 --- a/reference/dom/domelement.xml +++ b/reference/dom/domelement.xml @@ -40,6 +40,11 @@ DOMChildNode + &InheritedConstants; + + + + &Properties; public @@ -62,7 +67,6 @@ readonly mixed schemaTypeInfo - null public diff --git a/reference/dom/domentity.xml b/reference/dom/domentity.xml index 9b9dc2bb5e3d..c19077ebac7d 100644 --- a/reference/dom/domentity.xml +++ b/reference/dom/domentity.xml @@ -29,6 +29,11 @@ DOMNode + &InheritedConstants; + + + + &Properties; public @@ -53,21 +58,18 @@ readonly stringnull actualEncoding - null public readonly stringnull encoding - null public readonly stringnull version - null &InheritedProperties; diff --git a/reference/dom/domentityreference.xml b/reference/dom/domentityreference.xml index 7b53fdad5e9d..141a3b74c9a5 100644 --- a/reference/dom/domentityreference.xml +++ b/reference/dom/domentityreference.xml @@ -39,6 +39,11 @@ Remove me once you perform substitutions DOMNode + &InheritedConstants; + + + + &InheritedProperties; diff --git a/reference/dom/domnode.xml b/reference/dom/domnode.xml index 059c1b92b442..cf005c0f2c92 100644 --- a/reference/dom/domnode.xml +++ b/reference/dom/domnode.xml @@ -30,42 +30,42 @@ const int DOMNode::DOCUMENT_POSITION_DISCONNECTED - 1 + 0x1 public const int DOMNode::DOCUMENT_POSITION_PRECEDING - 2 + 0x2 public const int DOMNode::DOCUMENT_POSITION_FOLLOWING - 4 + 0x4 public const int DOMNode::DOCUMENT_POSITION_CONTAINS - 8 + 0x8 public const int DOMNode::DOCUMENT_POSITION_CONTAINED_BY - 16 + 0x10 public const int DOMNode::DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC - 32 + 0x20 &Properties; diff --git a/reference/dom/domnotation.xml b/reference/dom/domnotation.xml index ee7bc7aba91e..1fea3eb76fa5 100644 --- a/reference/dom/domnotation.xml +++ b/reference/dom/domnotation.xml @@ -40,6 +40,11 @@ Remove me once you perform substitutions DOMNode + &InheritedConstants; + + + + &Properties; public diff --git a/reference/dom/domprocessinginstruction.xml b/reference/dom/domprocessinginstruction.xml index 84ce7cc640f8..310b877b7fc4 100644 --- a/reference/dom/domprocessinginstruction.xml +++ b/reference/dom/domprocessinginstruction.xml @@ -31,6 +31,11 @@ DOMNode + &InheritedConstants; + + + + &Properties; public diff --git a/reference/dom/domtext.xml b/reference/dom/domtext.xml index 08f5a80cd4fa..c17aa74ce952 100644 --- a/reference/dom/domtext.xml +++ b/reference/dom/domtext.xml @@ -32,6 +32,11 @@ DOMCharacterData + &InheritedConstants; + + + + &Properties; public diff --git a/reference/dom/versions.xml b/reference/dom/versions.xml index 6244affd03ec..07e7da48ef54 100644 --- a/reference/dom/versions.xml +++ b/reference/dom/versions.xml @@ -139,6 +139,8 @@ + + @@ -165,6 +167,8 @@ + + From 9c70c73e5a99f8af48b773526cb16fa0d11208e2 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?M=C3=A1t=C3=A9=20Kocsis?= Date: Sat, 30 Nov 2024 11:08:35 +0100 Subject: [PATCH 2/5] Document DOMNode serialization methods --- reference/dom/domnamespacenode.xml | 5 ++ reference/dom/domnamespacenode/sleep.xml | 57 +++++++++++++++++++++++ reference/dom/domnamespacenode/wakeup.xml | 57 +++++++++++++++++++++++ reference/dom/domnode/sleep.xml | 57 +++++++++++++++++++++++ reference/dom/domnode/wakeup.xml | 57 +++++++++++++++++++++++ 5 files changed, 233 insertions(+) create mode 100644 reference/dom/domnamespacenode/sleep.xml create mode 100644 reference/dom/domnamespacenode/wakeup.xml create mode 100644 reference/dom/domnode/sleep.xml create mode 100644 reference/dom/domnode/wakeup.xml diff --git a/reference/dom/domnamespacenode.xml b/reference/dom/domnamespacenode.xml index b162add6e46a..6119a1fea5cf 100644 --- a/reference/dom/domnamespacenode.xml +++ b/reference/dom/domnamespacenode.xml @@ -84,6 +84,11 @@ DOMElementnull parentElement + + &Methods; + + + diff --git a/reference/dom/domnamespacenode/sleep.xml b/reference/dom/domnamespacenode/sleep.xml new file mode 100644 index 000000000000..fcf70e92bf56 --- /dev/null +++ b/reference/dom/domnamespacenode/sleep.xml @@ -0,0 +1,57 @@ + + + + DOMNameSpaceNode::__sleep + Forbids serialization unless serialization methods are implemented in a subclass + + + + &reftitle.description; + + public arrayDOMNameSpaceNode::__sleep + + + + Forbids serialization unless serialization methods are implemented in a subclass. + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + The method always throws an exception. + + + + + &reftitle.errors; + + Throws an Error exception when called. + + + + diff --git a/reference/dom/domnamespacenode/wakeup.xml b/reference/dom/domnamespacenode/wakeup.xml new file mode 100644 index 000000000000..6524a938755d --- /dev/null +++ b/reference/dom/domnamespacenode/wakeup.xml @@ -0,0 +1,57 @@ + + + + DOMNode::__wakeup + Forbids serialization unless serialization methods are implemented in a subclass + + + + &reftitle.description; + + public voidDOMNameSpaceNode::__wakeup + + + + Forbids serialization unless serialization methods are implemented in a subclass. + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + The method always throws an exception. + + + + + &reftitle.errors; + + Throws an Error exception when called. + + + + diff --git a/reference/dom/domnode/sleep.xml b/reference/dom/domnode/sleep.xml new file mode 100644 index 000000000000..fbaf4a441649 --- /dev/null +++ b/reference/dom/domnode/sleep.xml @@ -0,0 +1,57 @@ + + + + DOMNode::__sleep + Forbids serialization unless serialization methods are implemented in a subclass + + + + &reftitle.description; + + public arrayDOMNode::__sleep + + + + Forbids serialization unless serialization methods are implemented in a subclass. + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + The method always throws an exception. + + + + + &reftitle.errors; + + Throws an Error exception when called. + + + + diff --git a/reference/dom/domnode/wakeup.xml b/reference/dom/domnode/wakeup.xml new file mode 100644 index 000000000000..f804421a8aa2 --- /dev/null +++ b/reference/dom/domnode/wakeup.xml @@ -0,0 +1,57 @@ + + + + DOMNode::__wakeup + Forbids serialization unless serialization methods are implemented in a subclass + + + + &reftitle.description; + + public voidDOMNode::__wakeup + + + + Forbids serialization unless serialization methods are implemented in a subclass. + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + The method always throws an exception. + + + + + &reftitle.errors; + + Throws an Error exception when called. + + + + From 5767013e301e8216d2e85fa77998d253c9de862c Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?M=C3=A1t=C3=A9=20Kocsis?= Date: Sat, 30 Nov 2024 20:14:46 +0100 Subject: [PATCH 3/5] Apply suggestions from code review Co-authored-by: Niels Dossche <7771979+nielsdos@users.noreply.github.com> --- reference/dom/domnamespacenode/wakeup.xml | 4 ++-- reference/dom/domnode/wakeup.xml | 4 ++-- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/reference/dom/domnamespacenode/wakeup.xml b/reference/dom/domnamespacenode/wakeup.xml index 6524a938755d..9d5f6cc3005e 100644 --- a/reference/dom/domnamespacenode/wakeup.xml +++ b/reference/dom/domnamespacenode/wakeup.xml @@ -2,7 +2,7 @@ DOMNode::__wakeup - Forbids serialization unless serialization methods are implemented in a subclass + Forbids unserialization unless unserialization methods are implemented in a subclass @@ -12,7 +12,7 @@ - Forbids serialization unless serialization methods are implemented in a subclass. + Forbids unserialization unless unserialization methods are implemented in a subclass. diff --git a/reference/dom/domnode/wakeup.xml b/reference/dom/domnode/wakeup.xml index f804421a8aa2..f80f5683bd5f 100644 --- a/reference/dom/domnode/wakeup.xml +++ b/reference/dom/domnode/wakeup.xml @@ -2,7 +2,7 @@ DOMNode::__wakeup - Forbids serialization unless serialization methods are implemented in a subclass + Forbids unserialization unless unserialization methods are implemented in a subclass @@ -12,7 +12,7 @@ - Forbids serialization unless serialization methods are implemented in a subclass. + Forbids unserialization unless unserialization methods are implemented in a subclass. From 2e0e4ed6e37fd92ebe8982e0f6e9454ae6751ad5 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?M=C3=A1t=C3=A9=20Kocsis?= Date: Sat, 30 Nov 2024 20:32:45 +0100 Subject: [PATCH 4/5] Fix versions + class name in refentry --- reference/dom/domnamespacenode/wakeup.xml | 2 +- reference/dom/versions.xml | 8 ++++---- 2 files changed, 5 insertions(+), 5 deletions(-) diff --git a/reference/dom/domnamespacenode/wakeup.xml b/reference/dom/domnamespacenode/wakeup.xml index 9d5f6cc3005e..bb209c286697 100644 --- a/reference/dom/domnamespacenode/wakeup.xml +++ b/reference/dom/domnamespacenode/wakeup.xml @@ -1,7 +1,7 @@ - DOMNode::__wakeup + DOMNameSpaceNode::__wakeup Forbids unserialization unless unserialization methods are implemented in a subclass diff --git a/reference/dom/versions.xml b/reference/dom/versions.xml index 07e7da48ef54..33075c62c4ff 100644 --- a/reference/dom/versions.xml +++ b/reference/dom/versions.xml @@ -139,8 +139,8 @@ - - + + @@ -167,8 +167,8 @@ - - + + From 6fe84b0cd29af7d5264157dd1f5577652c6bfb5d Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?M=C3=A1t=C3=A9=20Kocsis?= Date: Sat, 30 Nov 2024 20:41:48 +0100 Subject: [PATCH 5/5] Add missing entity --- reference/dom/domnamespacenode.xml | 2 ++ 1 file changed, 2 insertions(+) diff --git a/reference/dom/domnamespacenode.xml b/reference/dom/domnamespacenode.xml index 6119a1fea5cf..14bc01d0f440 100644 --- a/reference/dom/domnamespacenode.xml +++ b/reference/dom/domnamespacenode.xml @@ -213,6 +213,8 @@ + &reference.dom.entities.domnamespacenode; +