From 32ca2e8eddb0823c0cdc371e7371917f1f9cbfb2 Mon Sep 17 00:00:00 2001 From: Gina Peter Banyard Date: Tue, 7 Nov 2023 16:52:59 +0000 Subject: [PATCH 01/45] dom: Add stubs generated from php-src stubs --- reference/dom/domcharacterdata/after.xml | 134 ++++++++++++++++ reference/dom/domcharacterdata/before.xml | 134 ++++++++++++++++ reference/dom/domcharacterdata/remove.xml | 122 +++++++++++++++ .../dom/domcharacterdata/replacewith.xml | 134 ++++++++++++++++ reference/dom/domdocument/adoptnode.xml | 134 ++++++++++++++++ reference/dom/domdocument/append.xml | 134 ++++++++++++++++ reference/dom/domdocument/prepend.xml | 134 ++++++++++++++++ reference/dom/domdocument/replacechildren.xml | 134 ++++++++++++++++ reference/dom/domdocumentfragment/append.xml | 134 ++++++++++++++++ reference/dom/domdocumentfragment/prepend.xml | 134 ++++++++++++++++ .../domdocumentfragment/replacechildren.xml | 134 ++++++++++++++++ reference/dom/domelement/after.xml | 134 ++++++++++++++++ reference/dom/domelement/append.xml | 134 ++++++++++++++++ reference/dom/domelement/before.xml | 134 ++++++++++++++++ reference/dom/domelement/prepend.xml | 134 ++++++++++++++++ reference/dom/domelement/remove.xml | 122 +++++++++++++++ reference/dom/domelement/replacechildren.xml | 134 ++++++++++++++++ reference/dom/domelement/replacewith.xml | 134 ++++++++++++++++ .../dom/domimplementation/getfeature.xml | 143 ++++++++++++++++++ reference/dom/domnamednodemap/getiterator.xml | 122 +++++++++++++++ reference/dom/domnodelist/getiterator.xml | 122 +++++++++++++++ 21 files changed, 2775 insertions(+) create mode 100644 reference/dom/domcharacterdata/after.xml create mode 100644 reference/dom/domcharacterdata/before.xml create mode 100644 reference/dom/domcharacterdata/remove.xml create mode 100644 reference/dom/domcharacterdata/replacewith.xml create mode 100644 reference/dom/domdocument/adoptnode.xml create mode 100644 reference/dom/domdocument/append.xml create mode 100644 reference/dom/domdocument/prepend.xml create mode 100644 reference/dom/domdocument/replacechildren.xml create mode 100644 reference/dom/domdocumentfragment/append.xml create mode 100644 reference/dom/domdocumentfragment/prepend.xml create mode 100644 reference/dom/domdocumentfragment/replacechildren.xml create mode 100644 reference/dom/domelement/after.xml create mode 100644 reference/dom/domelement/append.xml create mode 100644 reference/dom/domelement/before.xml create mode 100644 reference/dom/domelement/prepend.xml create mode 100644 reference/dom/domelement/remove.xml create mode 100644 reference/dom/domelement/replacechildren.xml create mode 100644 reference/dom/domelement/replacewith.xml create mode 100644 reference/dom/domimplementation/getfeature.xml create mode 100644 reference/dom/domnamednodemap/getiterator.xml create mode 100644 reference/dom/domnodelist/getiterator.xml diff --git a/reference/dom/domcharacterdata/after.xml b/reference/dom/domcharacterdata/after.xml new file mode 100644 index 000000000000..7f764dbf8b78 --- /dev/null +++ b/reference/dom/domcharacterdata/after.xml @@ -0,0 +1,134 @@ + + + + DOMCharacterData::after + Description + + + + &reftitle.description; + + public voidDOMCharacterData::after + DOMNodestringnodes + + &warn.undocumented.func; + + Description. + + + + + &reftitle.parameters; + + + + nodes + + + Description. + + + + + + + + + &reftitle.returnvalues; + + &return.void; + + + + + &reftitle.errors; + + When does this function issue E_* level errors, + and/or throw Exceptions. + + + + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + + 8.X.0 + + Description + + + + + + + + + &reftitle.examples; + + <methodname>DOMCharacterData::after</methodname> example + + Description. + + + +]]> + + &example.outputs; + + + + + + + + &reftitle.notes; + + + Any notes that don't fit anywhere else should go here. + + + + + + &reftitle.seealso; + + ClassName::otherMethodName + some_function + something appendix + + + + + diff --git a/reference/dom/domcharacterdata/before.xml b/reference/dom/domcharacterdata/before.xml new file mode 100644 index 000000000000..ff2e8d07f0fb --- /dev/null +++ b/reference/dom/domcharacterdata/before.xml @@ -0,0 +1,134 @@ + + + + DOMCharacterData::before + Description + + + + &reftitle.description; + + public voidDOMCharacterData::before + DOMNodestringnodes + + &warn.undocumented.func; + + Description. + + + + + &reftitle.parameters; + + + + nodes + + + Description. + + + + + + + + + &reftitle.returnvalues; + + &return.void; + + + + + &reftitle.errors; + + When does this function issue E_* level errors, + and/or throw Exceptions. + + + + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + + 8.X.0 + + Description + + + + + + + + + &reftitle.examples; + + <methodname>DOMCharacterData::before</methodname> example + + Description. + + + +]]> + + &example.outputs; + + + + + + + + &reftitle.notes; + + + Any notes that don't fit anywhere else should go here. + + + + + + &reftitle.seealso; + + ClassName::otherMethodName + some_function + something appendix + + + + + diff --git a/reference/dom/domcharacterdata/remove.xml b/reference/dom/domcharacterdata/remove.xml new file mode 100644 index 000000000000..1111270b411f --- /dev/null +++ b/reference/dom/domcharacterdata/remove.xml @@ -0,0 +1,122 @@ + + + + DOMCharacterData::remove + Description + + + + &reftitle.description; + + public voidDOMCharacterData::remove + + + &warn.undocumented.func; + + Description. + + + + + &reftitle.parameters; + &no.function.parameters; + + + &reftitle.returnvalues; + + &return.void; + + + + + &reftitle.errors; + + When does this function issue E_* level errors, + and/or throw Exceptions. + + + + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + + 8.X.0 + + Description + + + + + + + + + &reftitle.examples; + + <methodname>DOMCharacterData::remove</methodname> example + + Description. + + + +]]> + + &example.outputs; + + + + + + + + &reftitle.notes; + + + Any notes that don't fit anywhere else should go here. + + + + + + &reftitle.seealso; + + ClassName::otherMethodName + some_function + something appendix + + + + + diff --git a/reference/dom/domcharacterdata/replacewith.xml b/reference/dom/domcharacterdata/replacewith.xml new file mode 100644 index 000000000000..b2535e13b92a --- /dev/null +++ b/reference/dom/domcharacterdata/replacewith.xml @@ -0,0 +1,134 @@ + + + + DOMCharacterData::replaceWith + Description + + + + &reftitle.description; + + public voidDOMCharacterData::replaceWith + DOMNodestringnodes + + &warn.undocumented.func; + + Description. + + + + + &reftitle.parameters; + + + + nodes + + + Description. + + + + + + + + + &reftitle.returnvalues; + + &return.void; + + + + + &reftitle.errors; + + When does this function issue E_* level errors, + and/or throw Exceptions. + + + + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + + 8.X.0 + + Description + + + + + + + + + &reftitle.examples; + + <methodname>DOMCharacterData::replaceWith</methodname> example + + Description. + + + +]]> + + &example.outputs; + + + + + + + + &reftitle.notes; + + + Any notes that don't fit anywhere else should go here. + + + + + + &reftitle.seealso; + + ClassName::otherMethodName + some_function + something appendix + + + + + diff --git a/reference/dom/domdocument/adoptnode.xml b/reference/dom/domdocument/adoptnode.xml new file mode 100644 index 000000000000..6c7f3a43f157 --- /dev/null +++ b/reference/dom/domdocument/adoptnode.xml @@ -0,0 +1,134 @@ + + + + DOMDocument::adoptNode + Description + + + + &reftitle.description; + + public DOMNodefalseDOMDocument::adoptNode + DOMNodenode + + &warn.undocumented.func; + + Description. + + + + + &reftitle.parameters; + + + + node + + + Description. + + + + + + + + + &reftitle.returnvalues; + + Description. + + + + + &reftitle.errors; + + When does this function issue E_* level errors, + and/or throw Exceptions. + + + + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + + 8.X.0 + + Description + + + + + + + + + &reftitle.examples; + + <methodname>DOMDocument::adoptNode</methodname> example + + Description. + + + +]]> + + &example.outputs; + + + + + + + + &reftitle.notes; + + + Any notes that don't fit anywhere else should go here. + + + + + + &reftitle.seealso; + + ClassName::otherMethodName + some_function + something appendix + + + + + diff --git a/reference/dom/domdocument/append.xml b/reference/dom/domdocument/append.xml new file mode 100644 index 000000000000..f3fff766a663 --- /dev/null +++ b/reference/dom/domdocument/append.xml @@ -0,0 +1,134 @@ + + + + DOMDocument::append + Description + + + + &reftitle.description; + + public voidDOMDocument::append + DOMNodestringnodes + + &warn.undocumented.func; + + Description. + + + + + &reftitle.parameters; + + + + nodes + + + Description. + + + + + + + + + &reftitle.returnvalues; + + &return.void; + + + + + &reftitle.errors; + + When does this function issue E_* level errors, + and/or throw Exceptions. + + + + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + + 8.X.0 + + Description + + + + + + + + + &reftitle.examples; + + <methodname>DOMDocument::append</methodname> example + + Description. + + + +]]> + + &example.outputs; + + + + + + + + &reftitle.notes; + + + Any notes that don't fit anywhere else should go here. + + + + + + &reftitle.seealso; + + ClassName::otherMethodName + some_function + something appendix + + + + + diff --git a/reference/dom/domdocument/prepend.xml b/reference/dom/domdocument/prepend.xml new file mode 100644 index 000000000000..ae94a3a1066f --- /dev/null +++ b/reference/dom/domdocument/prepend.xml @@ -0,0 +1,134 @@ + + + + DOMDocument::prepend + Description + + + + &reftitle.description; + + public voidDOMDocument::prepend + DOMNodestringnodes + + &warn.undocumented.func; + + Description. + + + + + &reftitle.parameters; + + + + nodes + + + Description. + + + + + + + + + &reftitle.returnvalues; + + &return.void; + + + + + &reftitle.errors; + + When does this function issue E_* level errors, + and/or throw Exceptions. + + + + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + + 8.X.0 + + Description + + + + + + + + + &reftitle.examples; + + <methodname>DOMDocument::prepend</methodname> example + + Description. + + + +]]> + + &example.outputs; + + + + + + + + &reftitle.notes; + + + Any notes that don't fit anywhere else should go here. + + + + + + &reftitle.seealso; + + ClassName::otherMethodName + some_function + something appendix + + + + + diff --git a/reference/dom/domdocument/replacechildren.xml b/reference/dom/domdocument/replacechildren.xml new file mode 100644 index 000000000000..415268bf69c5 --- /dev/null +++ b/reference/dom/domdocument/replacechildren.xml @@ -0,0 +1,134 @@ + + + + DOMDocument::replaceChildren + Description + + + + &reftitle.description; + + public voidDOMDocument::replaceChildren + DOMNodestringnodes + + &warn.undocumented.func; + + Description. + + + + + &reftitle.parameters; + + + + nodes + + + Description. + + + + + + + + + &reftitle.returnvalues; + + &return.void; + + + + + &reftitle.errors; + + When does this function issue E_* level errors, + and/or throw Exceptions. + + + + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + + 8.X.0 + + Description + + + + + + + + + &reftitle.examples; + + <methodname>DOMDocument::replaceChildren</methodname> example + + Description. + + + +]]> + + &example.outputs; + + + + + + + + &reftitle.notes; + + + Any notes that don't fit anywhere else should go here. + + + + + + &reftitle.seealso; + + ClassName::otherMethodName + some_function + something appendix + + + + + diff --git a/reference/dom/domdocumentfragment/append.xml b/reference/dom/domdocumentfragment/append.xml new file mode 100644 index 000000000000..2cd09afb0267 --- /dev/null +++ b/reference/dom/domdocumentfragment/append.xml @@ -0,0 +1,134 @@ + + + + DOMDocumentFragment::append + Description + + + + &reftitle.description; + + public voidDOMDocumentFragment::append + DOMNodestringnodes + + &warn.undocumented.func; + + Description. + + + + + &reftitle.parameters; + + + + nodes + + + Description. + + + + + + + + + &reftitle.returnvalues; + + &return.void; + + + + + &reftitle.errors; + + When does this function issue E_* level errors, + and/or throw Exceptions. + + + + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + + 8.X.0 + + Description + + + + + + + + + &reftitle.examples; + + <methodname>DOMDocumentFragment::append</methodname> example + + Description. + + + +]]> + + &example.outputs; + + + + + + + + &reftitle.notes; + + + Any notes that don't fit anywhere else should go here. + + + + + + &reftitle.seealso; + + ClassName::otherMethodName + some_function + something appendix + + + + + diff --git a/reference/dom/domdocumentfragment/prepend.xml b/reference/dom/domdocumentfragment/prepend.xml new file mode 100644 index 000000000000..427578c70d6f --- /dev/null +++ b/reference/dom/domdocumentfragment/prepend.xml @@ -0,0 +1,134 @@ + + + + DOMDocumentFragment::prepend + Description + + + + &reftitle.description; + + public voidDOMDocumentFragment::prepend + DOMNodestringnodes + + &warn.undocumented.func; + + Description. + + + + + &reftitle.parameters; + + + + nodes + + + Description. + + + + + + + + + &reftitle.returnvalues; + + &return.void; + + + + + &reftitle.errors; + + When does this function issue E_* level errors, + and/or throw Exceptions. + + + + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + + 8.X.0 + + Description + + + + + + + + + &reftitle.examples; + + <methodname>DOMDocumentFragment::prepend</methodname> example + + Description. + + + +]]> + + &example.outputs; + + + + + + + + &reftitle.notes; + + + Any notes that don't fit anywhere else should go here. + + + + + + &reftitle.seealso; + + ClassName::otherMethodName + some_function + something appendix + + + + + diff --git a/reference/dom/domdocumentfragment/replacechildren.xml b/reference/dom/domdocumentfragment/replacechildren.xml new file mode 100644 index 000000000000..b7dee4fbacec --- /dev/null +++ b/reference/dom/domdocumentfragment/replacechildren.xml @@ -0,0 +1,134 @@ + + + + DOMDocumentFragment::replaceChildren + Description + + + + &reftitle.description; + + public voidDOMDocumentFragment::replaceChildren + DOMNodestringnodes + + &warn.undocumented.func; + + Description. + + + + + &reftitle.parameters; + + + + nodes + + + Description. + + + + + + + + + &reftitle.returnvalues; + + &return.void; + + + + + &reftitle.errors; + + When does this function issue E_* level errors, + and/or throw Exceptions. + + + + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + + 8.X.0 + + Description + + + + + + + + + &reftitle.examples; + + <methodname>DOMDocumentFragment::replaceChildren</methodname> example + + Description. + + + +]]> + + &example.outputs; + + + + + + + + &reftitle.notes; + + + Any notes that don't fit anywhere else should go here. + + + + + + &reftitle.seealso; + + ClassName::otherMethodName + some_function + something appendix + + + + + diff --git a/reference/dom/domelement/after.xml b/reference/dom/domelement/after.xml new file mode 100644 index 000000000000..9f12f49d232f --- /dev/null +++ b/reference/dom/domelement/after.xml @@ -0,0 +1,134 @@ + + + + DOMElement::after + Description + + + + &reftitle.description; + + public voidDOMElement::after + DOMNodestringnodes + + &warn.undocumented.func; + + Description. + + + + + &reftitle.parameters; + + + + nodes + + + Description. + + + + + + + + + &reftitle.returnvalues; + + &return.void; + + + + + &reftitle.errors; + + When does this function issue E_* level errors, + and/or throw Exceptions. + + + + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + + 8.X.0 + + Description + + + + + + + + + &reftitle.examples; + + <methodname>DOMElement::after</methodname> example + + Description. + + + +]]> + + &example.outputs; + + + + + + + + &reftitle.notes; + + + Any notes that don't fit anywhere else should go here. + + + + + + &reftitle.seealso; + + ClassName::otherMethodName + some_function + something appendix + + + + + diff --git a/reference/dom/domelement/append.xml b/reference/dom/domelement/append.xml new file mode 100644 index 000000000000..dd05d95b1ca3 --- /dev/null +++ b/reference/dom/domelement/append.xml @@ -0,0 +1,134 @@ + + + + DOMElement::append + Description + + + + &reftitle.description; + + public voidDOMElement::append + DOMNodestringnodes + + &warn.undocumented.func; + + Description. + + + + + &reftitle.parameters; + + + + nodes + + + Description. + + + + + + + + + &reftitle.returnvalues; + + &return.void; + + + + + &reftitle.errors; + + When does this function issue E_* level errors, + and/or throw Exceptions. + + + + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + + 8.X.0 + + Description + + + + + + + + + &reftitle.examples; + + <methodname>DOMElement::append</methodname> example + + Description. + + + +]]> + + &example.outputs; + + + + + + + + &reftitle.notes; + + + Any notes that don't fit anywhere else should go here. + + + + + + &reftitle.seealso; + + ClassName::otherMethodName + some_function + something appendix + + + + + diff --git a/reference/dom/domelement/before.xml b/reference/dom/domelement/before.xml new file mode 100644 index 000000000000..eb304bc8899d --- /dev/null +++ b/reference/dom/domelement/before.xml @@ -0,0 +1,134 @@ + + + + DOMElement::before + Description + + + + &reftitle.description; + + public voidDOMElement::before + DOMNodestringnodes + + &warn.undocumented.func; + + Description. + + + + + &reftitle.parameters; + + + + nodes + + + Description. + + + + + + + + + &reftitle.returnvalues; + + &return.void; + + + + + &reftitle.errors; + + When does this function issue E_* level errors, + and/or throw Exceptions. + + + + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + + 8.X.0 + + Description + + + + + + + + + &reftitle.examples; + + <methodname>DOMElement::before</methodname> example + + Description. + + + +]]> + + &example.outputs; + + + + + + + + &reftitle.notes; + + + Any notes that don't fit anywhere else should go here. + + + + + + &reftitle.seealso; + + ClassName::otherMethodName + some_function + something appendix + + + + + diff --git a/reference/dom/domelement/prepend.xml b/reference/dom/domelement/prepend.xml new file mode 100644 index 000000000000..3e494d2342bd --- /dev/null +++ b/reference/dom/domelement/prepend.xml @@ -0,0 +1,134 @@ + + + + DOMElement::prepend + Description + + + + &reftitle.description; + + public voidDOMElement::prepend + DOMNodestringnodes + + &warn.undocumented.func; + + Description. + + + + + &reftitle.parameters; + + + + nodes + + + Description. + + + + + + + + + &reftitle.returnvalues; + + &return.void; + + + + + &reftitle.errors; + + When does this function issue E_* level errors, + and/or throw Exceptions. + + + + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + + 8.X.0 + + Description + + + + + + + + + &reftitle.examples; + + <methodname>DOMElement::prepend</methodname> example + + Description. + + + +]]> + + &example.outputs; + + + + + + + + &reftitle.notes; + + + Any notes that don't fit anywhere else should go here. + + + + + + &reftitle.seealso; + + ClassName::otherMethodName + some_function + something appendix + + + + + diff --git a/reference/dom/domelement/remove.xml b/reference/dom/domelement/remove.xml new file mode 100644 index 000000000000..59d6dcfaf64c --- /dev/null +++ b/reference/dom/domelement/remove.xml @@ -0,0 +1,122 @@ + + + + DOMElement::remove + Description + + + + &reftitle.description; + + public voidDOMElement::remove + + + &warn.undocumented.func; + + Description. + + + + + &reftitle.parameters; + &no.function.parameters; + + + &reftitle.returnvalues; + + &return.void; + + + + + &reftitle.errors; + + When does this function issue E_* level errors, + and/or throw Exceptions. + + + + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + + 8.X.0 + + Description + + + + + + + + + &reftitle.examples; + + <methodname>DOMElement::remove</methodname> example + + Description. + + + +]]> + + &example.outputs; + + + + + + + + &reftitle.notes; + + + Any notes that don't fit anywhere else should go here. + + + + + + &reftitle.seealso; + + ClassName::otherMethodName + some_function + something appendix + + + + + diff --git a/reference/dom/domelement/replacechildren.xml b/reference/dom/domelement/replacechildren.xml new file mode 100644 index 000000000000..9c2ff3fb7a91 --- /dev/null +++ b/reference/dom/domelement/replacechildren.xml @@ -0,0 +1,134 @@ + + + + DOMElement::replaceChildren + Description + + + + &reftitle.description; + + public voidDOMElement::replaceChildren + DOMNodestringnodes + + &warn.undocumented.func; + + Description. + + + + + &reftitle.parameters; + + + + nodes + + + Description. + + + + + + + + + &reftitle.returnvalues; + + &return.void; + + + + + &reftitle.errors; + + When does this function issue E_* level errors, + and/or throw Exceptions. + + + + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + + 8.X.0 + + Description + + + + + + + + + &reftitle.examples; + + <methodname>DOMElement::replaceChildren</methodname> example + + Description. + + + +]]> + + &example.outputs; + + + + + + + + &reftitle.notes; + + + Any notes that don't fit anywhere else should go here. + + + + + + &reftitle.seealso; + + ClassName::otherMethodName + some_function + something appendix + + + + + diff --git a/reference/dom/domelement/replacewith.xml b/reference/dom/domelement/replacewith.xml new file mode 100644 index 000000000000..9baca304509e --- /dev/null +++ b/reference/dom/domelement/replacewith.xml @@ -0,0 +1,134 @@ + + + + DOMElement::replaceWith + Description + + + + &reftitle.description; + + public voidDOMElement::replaceWith + DOMNodestringnodes + + &warn.undocumented.func; + + Description. + + + + + &reftitle.parameters; + + + + nodes + + + Description. + + + + + + + + + &reftitle.returnvalues; + + &return.void; + + + + + &reftitle.errors; + + When does this function issue E_* level errors, + and/or throw Exceptions. + + + + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + + 8.X.0 + + Description + + + + + + + + + &reftitle.examples; + + <methodname>DOMElement::replaceWith</methodname> example + + Description. + + + +]]> + + &example.outputs; + + + + + + + + &reftitle.notes; + + + Any notes that don't fit anywhere else should go here. + + + + + + &reftitle.seealso; + + ClassName::otherMethodName + some_function + something appendix + + + + + diff --git a/reference/dom/domimplementation/getfeature.xml b/reference/dom/domimplementation/getfeature.xml new file mode 100644 index 000000000000..b0cfb3ba1b15 --- /dev/null +++ b/reference/dom/domimplementation/getfeature.xml @@ -0,0 +1,143 @@ + + + + DOMImplementation::getFeature + Description + + + + &reftitle.description; + + public neverDOMImplementation::getFeature + stringfeature + stringversion + + &warn.undocumented.func; + + Description. + + + + + &reftitle.parameters; + + + + feature + + + Description. + + + + + version + + + Description. + + + + + + + + + &reftitle.returnvalues; + + Description. + + + + + &reftitle.errors; + + When does this function issue E_* level errors, + and/or throw Exceptions. + + + + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + + 8.X.0 + + Description + + + + + + + + + &reftitle.examples; + + <methodname>DOMImplementation::getFeature</methodname> example + + Description. + + + +]]> + + &example.outputs; + + + + + + + + &reftitle.notes; + + + Any notes that don't fit anywhere else should go here. + + + + + + &reftitle.seealso; + + ClassName::otherMethodName + some_function + something appendix + + + + + diff --git a/reference/dom/domnamednodemap/getiterator.xml b/reference/dom/domnamednodemap/getiterator.xml new file mode 100644 index 000000000000..54ccfd72c0a5 --- /dev/null +++ b/reference/dom/domnamednodemap/getiterator.xml @@ -0,0 +1,122 @@ + + + + DOMNamedNodeMap::getIterator + Description + + + + &reftitle.description; + + public IteratorDOMNamedNodeMap::getIterator + + + &warn.undocumented.func; + + Description. + + + + + &reftitle.parameters; + &no.function.parameters; + + + &reftitle.returnvalues; + + Description. + + + + + &reftitle.errors; + + When does this function issue E_* level errors, + and/or throw Exceptions. + + + + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + + 8.X.0 + + Description + + + + + + + + + &reftitle.examples; + + <methodname>DOMNamedNodeMap::getIterator</methodname> example + + Description. + + + +]]> + + &example.outputs; + + + + + + + + &reftitle.notes; + + + Any notes that don't fit anywhere else should go here. + + + + + + &reftitle.seealso; + + ClassName::otherMethodName + some_function + something appendix + + + + + diff --git a/reference/dom/domnodelist/getiterator.xml b/reference/dom/domnodelist/getiterator.xml new file mode 100644 index 000000000000..cb0e5583f678 --- /dev/null +++ b/reference/dom/domnodelist/getiterator.xml @@ -0,0 +1,122 @@ + + + + DOMNodeList::getIterator + Description + + + + &reftitle.description; + + public IteratorDOMNodeList::getIterator + + + &warn.undocumented.func; + + Description. + + + + + &reftitle.parameters; + &no.function.parameters; + + + &reftitle.returnvalues; + + Description. + + + + + &reftitle.errors; + + When does this function issue E_* level errors, + and/or throw Exceptions. + + + + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + + 8.X.0 + + Description + + + + + + + + + &reftitle.examples; + + <methodname>DOMNodeList::getIterator</methodname> example + + Description. + + + +]]> + + &example.outputs; + + + + + + + + &reftitle.notes; + + + Any notes that don't fit anywhere else should go here. + + + + + + &reftitle.seealso; + + ClassName::otherMethodName + some_function + something appendix + + + + + From df5dc75ff260c93a21a405cb9857df1dda4d61ec Mon Sep 17 00:00:00 2001 From: Niels Dossche <7771979+nielsdos@users.noreply.github.com> Date: Tue, 7 Nov 2023 21:36:30 +0100 Subject: [PATCH 02/45] Clarify string behaviour --- reference/dom/domchildnode/after.xml | 1 + reference/dom/domchildnode/before.xml | 1 + reference/dom/domchildnode/replacewith.xml | 1 + reference/dom/domparentnode/append.xml | 1 + reference/dom/domparentnode/prepend.xml | 1 + reference/dom/domparentnode/replacechildren.xml | 1 + 6 files changed, 6 insertions(+) diff --git a/reference/dom/domchildnode/after.xml b/reference/dom/domchildnode/after.xml index b87abd96e7c5..1330f1e8784c 100644 --- a/reference/dom/domchildnode/after.xml +++ b/reference/dom/domchildnode/after.xml @@ -25,6 +25,7 @@ Nodes to be added after the node. + Strings are automatically converted to text nodes. diff --git a/reference/dom/domchildnode/before.xml b/reference/dom/domchildnode/before.xml index 368c530d2430..c134f97cf1fd 100644 --- a/reference/dom/domchildnode/before.xml +++ b/reference/dom/domchildnode/before.xml @@ -25,6 +25,7 @@ Nodes to be added before the node. + Strings are automatically converted to text nodes. diff --git a/reference/dom/domchildnode/replacewith.xml b/reference/dom/domchildnode/replacewith.xml index bbadba4332d4..7cfa11c9a97f 100644 --- a/reference/dom/domchildnode/replacewith.xml +++ b/reference/dom/domchildnode/replacewith.xml @@ -26,6 +26,7 @@ The replacement nodes. + Strings are automatically converted to text nodes. diff --git a/reference/dom/domparentnode/append.xml b/reference/dom/domparentnode/append.xml index 2495efb19045..9ea634be1a9a 100644 --- a/reference/dom/domparentnode/append.xml +++ b/reference/dom/domparentnode/append.xml @@ -25,6 +25,7 @@ The nodes to append. + Strings are automatically converted to text nodes. diff --git a/reference/dom/domparentnode/prepend.xml b/reference/dom/domparentnode/prepend.xml index c886b6b89253..b4f033c4e4ae 100644 --- a/reference/dom/domparentnode/prepend.xml +++ b/reference/dom/domparentnode/prepend.xml @@ -25,6 +25,7 @@ The nodes to prepend. + Strings are automatically converted to text nodes. diff --git a/reference/dom/domparentnode/replacechildren.xml b/reference/dom/domparentnode/replacechildren.xml index fe4ac9962dd0..b07568d9f1cb 100644 --- a/reference/dom/domparentnode/replacechildren.xml +++ b/reference/dom/domparentnode/replacechildren.xml @@ -25,6 +25,7 @@ The nodes replacing the children. + Strings are automatically converted to text nodes. From c0f51dc89e6cfdb5f251f56cd7c1a344038b2904 Mon Sep 17 00:00:00 2001 From: Niels Dossche <7771979+nielsdos@users.noreply.github.com> Date: Tue, 7 Nov 2023 22:04:30 +0100 Subject: [PATCH 03/45] Update DOMChildNode::after docs --- reference/dom/domchildnode/after.xml | 27 +++++++++++++++++++++++++++ 1 file changed, 27 insertions(+) diff --git a/reference/dom/domchildnode/after.xml b/reference/dom/domchildnode/after.xml index 1330f1e8784c..bdc408c8c45b 100644 --- a/reference/dom/domchildnode/after.xml +++ b/reference/dom/domchildnode/after.xml @@ -40,6 +40,33 @@ + + &reftitle.errors; + + + + DOM_HIERARCHY_REQUEST_ERR + + + Raised if this node is of a type that does not allow children of the + type of the node node, or if the node to + put in is one of this node's ancestors or this node itself. + + + + + DOM_WRONG_DOCUMENT_ERR + + + Raised if node was created from a different + document than the one that created this node. + + + + + + + &reftitle.seealso; From 27076c7611e6563eed48b2af9fda65641f64e71a Mon Sep 17 00:00:00 2001 From: Niels Dossche <7771979+nielsdos@users.noreply.github.com> Date: Tue, 7 Nov 2023 22:11:20 +0100 Subject: [PATCH 04/45] Add docs for DOMElement::after --- reference/dom/domelement/after.xml | 91 +++++++----------------------- 1 file changed, 20 insertions(+), 71 deletions(-) diff --git a/reference/dom/domelement/after.xml b/reference/dom/domelement/after.xml index 9f12f49d232f..ebfd48a15688 100644 --- a/reference/dom/domelement/after.xml +++ b/reference/dom/domelement/after.xml @@ -1,8 +1,8 @@ - + DOMElement::after - Description + Adds nodes after the element @@ -11,64 +11,14 @@ public voidDOMElement::after DOMNodestringnodes - &warn.undocumented.func; - Description. + Adds the passed nodes after the element. - - - &reftitle.parameters; - - - - nodes - - - Description. - - - - - - - - - &reftitle.returnvalues; - - &return.void; - - - - - &reftitle.errors; - - When does this function issue E_* level errors, - and/or throw Exceptions. - - - - - &reftitle.changelog; - - - - - &Version; - &Description; - - - - - 8.X.0 - - Description - - - - - - + + + + &reftitle.examples; @@ -80,34 +30,33 @@ loadXML(""); +$container = $doc->documentElement; + +$container->after("beautiful", $doc->createElement("world")); + +echo $doc->saveXML(); ?> ]]> &example.outputs; + +beautiful + ]]> - - &reftitle.notes; - - - Any notes that don't fit anywhere else should go here. - - - - &reftitle.seealso; - ClassName::otherMethodName - some_function - something appendix + DOMChildNode::after + DOMElement::before From 4f14d0768f0f5508b52f39c4dc65c7c8e4ddad80 Mon Sep 17 00:00:00 2001 From: Niels Dossche <7771979+nielsdos@users.noreply.github.com> Date: Tue, 7 Nov 2023 22:12:10 +0100 Subject: [PATCH 05/45] Remove doc file for unimplemented, to-be-deprecated method --- .../dom/domimplementation/getfeature.xml | 143 ------------------ 1 file changed, 143 deletions(-) delete mode 100644 reference/dom/domimplementation/getfeature.xml diff --git a/reference/dom/domimplementation/getfeature.xml b/reference/dom/domimplementation/getfeature.xml deleted file mode 100644 index b0cfb3ba1b15..000000000000 --- a/reference/dom/domimplementation/getfeature.xml +++ /dev/null @@ -1,143 +0,0 @@ - - - - DOMImplementation::getFeature - Description - - - - &reftitle.description; - - public neverDOMImplementation::getFeature - stringfeature - stringversion - - &warn.undocumented.func; - - Description. - - - - - &reftitle.parameters; - - - - feature - - - Description. - - - - - version - - - Description. - - - - - - - - - &reftitle.returnvalues; - - Description. - - - - - &reftitle.errors; - - When does this function issue E_* level errors, - and/or throw Exceptions. - - - - - &reftitle.changelog; - - - - - &Version; - &Description; - - - - - 8.X.0 - - Description - - - - - - - - - &reftitle.examples; - - <methodname>DOMImplementation::getFeature</methodname> example - - Description. - - - -]]> - - &example.outputs; - - - - - - - - &reftitle.notes; - - - Any notes that don't fit anywhere else should go here. - - - - - - &reftitle.seealso; - - ClassName::otherMethodName - some_function - something appendix - - - - - From 158b1577071fc34a8f1971233a95a06b3bcff22a Mon Sep 17 00:00:00 2001 From: Niels Dossche <7771979+nielsdos@users.noreply.github.com> Date: Tue, 7 Nov 2023 22:18:17 +0100 Subject: [PATCH 06/45] Add docs for DOMCharacterData::after --- reference/dom/domcharacterdata/after.xml | 87 +++++------------------- 1 file changed, 17 insertions(+), 70 deletions(-) diff --git a/reference/dom/domcharacterdata/after.xml b/reference/dom/domcharacterdata/after.xml index 7f764dbf8b78..181cbb541da8 100644 --- a/reference/dom/domcharacterdata/after.xml +++ b/reference/dom/domcharacterdata/after.xml @@ -1,8 +1,8 @@ - + DOMCharacterData::after - Description + Adds nodes after the node @@ -11,64 +11,14 @@ public voidDOMCharacterData::after DOMNodestringnodes - &warn.undocumented.func; - Description. + Adds the passed nodes after the element. - - &reftitle.parameters; - - - - nodes - - - Description. - - - - - - - - - &reftitle.returnvalues; - - &return.void; - - - - - &reftitle.errors; - - When does this function issue E_* level errors, - and/or throw Exceptions. - - - - - &reftitle.changelog; - - - - - &Version; - &Description; - - - - - 8.X.0 - - Description - - - - - - + + + &reftitle.examples; @@ -80,34 +30,31 @@ loadXML(""); +$cdata = $doc->documentElement->firstChild; + +$cdata->after("beautiful", $doc->createElement("world")); + +echo $doc->saveXML(); ?> ]]> &example.outputs; +beautiful ]]> - - &reftitle.notes; - - - Any notes that don't fit anywhere else should go here. - - - - &reftitle.seealso; - ClassName::otherMethodName - some_function - something appendix + DOMChildNode::after + DOMCharacterData::before From 2e12f03923bb8c3477421d1c16913c12fabcc4c1 Mon Sep 17 00:00:00 2001 From: Niels Dossche <7771979+nielsdos@users.noreply.github.com> Date: Tue, 7 Nov 2023 22:21:03 +0100 Subject: [PATCH 07/45] Error section for DOMChildNode::before --- reference/dom/domchildnode/before.xml | 27 +++++++++++++++++++++++++++ 1 file changed, 27 insertions(+) diff --git a/reference/dom/domchildnode/before.xml b/reference/dom/domchildnode/before.xml index c134f97cf1fd..484ab5986cae 100644 --- a/reference/dom/domchildnode/before.xml +++ b/reference/dom/domchildnode/before.xml @@ -40,6 +40,33 @@ + + &reftitle.errors; + + + + DOM_HIERARCHY_REQUEST_ERR + + + Raised if this node is of a type that does not allow children of the + type of the node node, or if the node to + put in is one of this node's ancestors or this node itself. + + + + + DOM_WRONG_DOCUMENT_ERR + + + Raised if node was created from a different + document than the one that created this node. + + + + + + + &reftitle.seealso; From 757cbe05afe96043bedd4bb2956c2424af2c5e38 Mon Sep 17 00:00:00 2001 From: Niels Dossche <7771979+nielsdos@users.noreply.github.com> Date: Tue, 7 Nov 2023 22:25:24 +0100 Subject: [PATCH 08/45] Add docs for DOMCharacterData::before --- reference/dom/domcharacterdata/before.xml | 85 +++++------------------ 1 file changed, 16 insertions(+), 69 deletions(-) diff --git a/reference/dom/domcharacterdata/before.xml b/reference/dom/domcharacterdata/before.xml index ff2e8d07f0fb..21e33ca36d0d 100644 --- a/reference/dom/domcharacterdata/before.xml +++ b/reference/dom/domcharacterdata/before.xml @@ -1,5 +1,5 @@ - + DOMCharacterData::before Description @@ -11,64 +11,14 @@ public voidDOMCharacterData::before DOMNodestringnodes - &warn.undocumented.func; - Description. + Adds the passed nodes before the node. - - &reftitle.parameters; - - - - nodes - - - Description. - - - - - - - - - &reftitle.returnvalues; - - &return.void; - - - - - &reftitle.errors; - - When does this function issue E_* level errors, - and/or throw Exceptions. - - - - - &reftitle.changelog; - - - - - &Version; - &Description; - - - - - 8.X.0 - - Description - - - - - - + + + &reftitle.examples; @@ -80,34 +30,31 @@ loadXML(""); +$cdata = $doc->documentElement->firstChild; + +$cdata->before("hello", $doc->createElement("beautiful")); + +echo $doc->saveXML(); ?> ]]> &example.outputs; +hello ]]> - - &reftitle.notes; - - - Any notes that don't fit anywhere else should go here. - - - - &reftitle.seealso; - ClassName::otherMethodName - some_function - something appendix + DOMChildNode::before + DOMCharacterData::after From 60809e9e1cd3ebac3d8109c061c6d2b5dc70c3d5 Mon Sep 17 00:00:00 2001 From: Niels Dossche <7771979+nielsdos@users.noreply.github.com> Date: Tue, 7 Nov 2023 22:26:23 +0100 Subject: [PATCH 09/45] ws fixes --- reference/dom/domchildnode/after.xml | 6 +++--- reference/dom/domelement/after.xml | 2 +- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/reference/dom/domchildnode/after.xml b/reference/dom/domchildnode/after.xml index bdc408c8c45b..d6a9406ca75c 100644 --- a/reference/dom/domchildnode/after.xml +++ b/reference/dom/domchildnode/after.xml @@ -48,8 +48,8 @@ DOM_HIERARCHY_REQUEST_ERR - Raised if this node is of a type that does not allow children of the - type of the node node, or if the node to + Raised if this node is of a type that does not allow children of the + type of the node node, or if the node to put in is one of this node's ancestors or this node itself. @@ -58,7 +58,7 @@ DOM_WRONG_DOCUMENT_ERR - Raised if node was created from a different + Raised if node was created from a different document than the one that created this node. diff --git a/reference/dom/domelement/after.xml b/reference/dom/domelement/after.xml index ebfd48a15688..0d75b60ba2bf 100644 --- a/reference/dom/domelement/after.xml +++ b/reference/dom/domelement/after.xml @@ -15,7 +15,7 @@ Adds the passed nodes after the element. - + From 560d0a82a22e76b65d827c1b56a20e2f348f209f Mon Sep 17 00:00:00 2001 From: Niels Dossche <7771979+nielsdos@users.noreply.github.com> Date: Tue, 7 Nov 2023 22:27:12 +0100 Subject: [PATCH 10/45] fixup: add description for DOMCharacterData::before --- reference/dom/domcharacterdata/before.xml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/reference/dom/domcharacterdata/before.xml b/reference/dom/domcharacterdata/before.xml index 21e33ca36d0d..12a8a503a25a 100644 --- a/reference/dom/domcharacterdata/before.xml +++ b/reference/dom/domcharacterdata/before.xml @@ -2,7 +2,7 @@ DOMCharacterData::before - Description + Adds nodes before the node From 74e9965ffcf0c3ee75d2221119930f34ff954cf0 Mon Sep 17 00:00:00 2001 From: Niels Dossche <7771979+nielsdos@users.noreply.github.com> Date: Tue, 7 Nov 2023 22:30:05 +0100 Subject: [PATCH 11/45] Add docs for DOMElement::before --- reference/dom/domelement/before.xml | 85 ++++++----------------------- 1 file changed, 17 insertions(+), 68 deletions(-) diff --git a/reference/dom/domelement/before.xml b/reference/dom/domelement/before.xml index eb304bc8899d..a4d7d7976200 100644 --- a/reference/dom/domelement/before.xml +++ b/reference/dom/domelement/before.xml @@ -1,8 +1,8 @@ - + DOMElement::before - Description + Adds nodes before the element @@ -11,64 +11,14 @@ public voidDOMElement::before DOMNodestringnodes - &warn.undocumented.func; - Description. + Adds the passed nodes before the element. - - &reftitle.parameters; - - - - nodes - - - Description. - - - - - - - - - &reftitle.returnvalues; - - &return.void; - - - - - &reftitle.errors; - - When does this function issue E_* level errors, - and/or throw Exceptions. - - - - - &reftitle.changelog; - - - - - &Version; - &Description; - - - - - 8.X.0 - - Description - - - - - - + + + &reftitle.examples; @@ -80,34 +30,33 @@ loadXML(""); +$world = $doc->documentElement; + +$world->before("hello", $doc->createElement("beautiful")); + +echo $doc->saveXML(); ?> ]]> &example.outputs; + ]]> - - &reftitle.notes; - - - Any notes that don't fit anywhere else should go here. - - - - &reftitle.seealso; ClassName::otherMethodName some_function - something appendix + From 0ff00a11d32b14312ee455227d2a05ac30fd0ad8 Mon Sep 17 00:00:00 2001 From: Niels Dossche <7771979+nielsdos@users.noreply.github.com> Date: Tue, 7 Nov 2023 22:32:01 +0100 Subject: [PATCH 12/45] ws fixes --- reference/dom/domchildnode/before.xml | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/reference/dom/domchildnode/before.xml b/reference/dom/domchildnode/before.xml index 484ab5986cae..d13b71216c2e 100644 --- a/reference/dom/domchildnode/before.xml +++ b/reference/dom/domchildnode/before.xml @@ -48,8 +48,8 @@ DOM_HIERARCHY_REQUEST_ERR - Raised if this node is of a type that does not allow children of the - type of the node node, or if the node to + Raised if this node is of a type that does not allow children of the + type of the node node, or if the node to put in is one of this node's ancestors or this node itself. @@ -58,7 +58,7 @@ DOM_WRONG_DOCUMENT_ERR - Raised if node was created from a different + Raised if node was created from a different document than the one that created this node. From 96725051bcbf3058493012407f5a01b7f91fc40e Mon Sep 17 00:00:00 2001 From: Niels Dossche <7771979+nielsdos@users.noreply.github.com> Date: Tue, 7 Nov 2023 22:34:53 +0100 Subject: [PATCH 13/45] Fix description --- reference/dom/domchildnode/after.xml | 6 +++--- reference/dom/domchildnode/before.xml | 4 ++-- 2 files changed, 5 insertions(+), 5 deletions(-) diff --git a/reference/dom/domchildnode/after.xml b/reference/dom/domchildnode/after.xml index d6a9406ca75c..b346574ddf22 100644 --- a/reference/dom/domchildnode/after.xml +++ b/reference/dom/domchildnode/after.xml @@ -49,7 +49,7 @@ Raised if this node is of a type that does not allow children of the - type of the node node, or if the node to + type of one of the passed nodes, or if the node to put in is one of this node's ancestors or this node itself. @@ -58,7 +58,7 @@ DOM_WRONG_DOCUMENT_ERR - Raised if node was created from a different + Raised if one of the passed nodes was created from a different document than the one that created this node. @@ -66,7 +66,7 @@ - + &reftitle.seealso; diff --git a/reference/dom/domchildnode/before.xml b/reference/dom/domchildnode/before.xml index d13b71216c2e..9f6a1ca3c672 100644 --- a/reference/dom/domchildnode/before.xml +++ b/reference/dom/domchildnode/before.xml @@ -49,7 +49,7 @@ Raised if this node is of a type that does not allow children of the - type of the node node, or if the node to + type of one of the passed nodes, or if the node to put in is one of this node's ancestors or this node itself. @@ -58,7 +58,7 @@ DOM_WRONG_DOCUMENT_ERR - Raised if node was created from a different + Raised if one of the passed nodes was created from a different document than the one that created this node. From 1da363c6f1c4556b688f619a65b802badc1c7045 Mon Sep 17 00:00:00 2001 From: Niels Dossche <7771979+nielsdos@users.noreply.github.com> Date: Tue, 7 Nov 2023 22:35:29 +0100 Subject: [PATCH 14/45] Fix description --- reference/dom/domchildnode/after.xml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/reference/dom/domchildnode/after.xml b/reference/dom/domchildnode/after.xml index b346574ddf22..ac87e957ca62 100644 --- a/reference/dom/domchildnode/after.xml +++ b/reference/dom/domchildnode/after.xml @@ -66,7 +66,7 @@ - + &reftitle.seealso; From 51515bf41002c9cce022469174a666da8d18cf72 Mon Sep 17 00:00:00 2001 From: Niels Dossche <7771979+nielsdos@users.noreply.github.com> Date: Tue, 7 Nov 2023 22:37:36 +0100 Subject: [PATCH 15/45] Update errors of DOMParentNode::append --- reference/dom/domparentnode/append.xml | 27 ++++++++++++++++++++++++++ 1 file changed, 27 insertions(+) diff --git a/reference/dom/domparentnode/append.xml b/reference/dom/domparentnode/append.xml index 9ea634be1a9a..41e449da6aca 100644 --- a/reference/dom/domparentnode/append.xml +++ b/reference/dom/domparentnode/append.xml @@ -40,6 +40,33 @@ + + &reftitle.errors; + + + + DOM_HIERARCHY_REQUEST_ERR + + + Raised if this node is of a type that does not allow children of the + type of one of the passed nodes, or if the node to + put in is one of this node's ancestors or this node itself. + + + + + DOM_WRONG_DOCUMENT_ERR + + + Raised if one of the passed nodes was created from a different + document than the one that created this node. + + + + + + + &reftitle.seealso; From f4087ae709ee3645e03e56d00b3e346defb1d4e4 Mon Sep 17 00:00:00 2001 From: Niels Dossche <7771979+nielsdos@users.noreply.github.com> Date: Tue, 7 Nov 2023 22:46:00 +0100 Subject: [PATCH 16/45] Add some stuff for examples I forgot --- reference/dom/domcharacterdata/after.xml | 4 ++-- reference/dom/domcharacterdata/before.xml | 2 +- reference/dom/domelement/after.xml | 2 +- reference/dom/domelement/before.xml | 2 +- 4 files changed, 5 insertions(+), 5 deletions(-) diff --git a/reference/dom/domcharacterdata/after.xml b/reference/dom/domcharacterdata/after.xml index 181cbb541da8..81ec1448e49a 100644 --- a/reference/dom/domcharacterdata/after.xml +++ b/reference/dom/domcharacterdata/after.xml @@ -2,7 +2,7 @@ DOMCharacterData::after - Adds nodes after the node + Adds nodes after the character data @@ -25,7 +25,7 @@ <methodname>DOMCharacterData::after</methodname> example - Description. + Adds nodes after the character data. <methodname>DOMCharacterData::before</methodname> example - Description. + Adds nodes before the character data. <methodname>DOMElement::after</methodname> example - Description. + Adds nodes after the hello element. <methodname>DOMElement::before</methodname> example - Description. + Adds nodes before the hello element. Date: Tue, 7 Nov 2023 22:46:15 +0100 Subject: [PATCH 17/45] Document DOMElement::append --- reference/dom/domelement/append.xml | 89 ++++++----------------------- 1 file changed, 18 insertions(+), 71 deletions(-) diff --git a/reference/dom/domelement/append.xml b/reference/dom/domelement/append.xml index dd05d95b1ca3..e74d8fc2af6b 100644 --- a/reference/dom/domelement/append.xml +++ b/reference/dom/domelement/append.xml @@ -1,8 +1,8 @@ - + DOMElement::append - Description + Appends nodes after the last child node @@ -11,103 +11,50 @@ public voidDOMElement::append DOMNodestringnodes - &warn.undocumented.func; - Description. + Appends one or many nodes to the list of children after the last child node. - - &reftitle.parameters; - - - - nodes - - - Description. - - - - - - - - - &reftitle.returnvalues; - - &return.void; - - - - - &reftitle.errors; - - When does this function issue E_* level errors, - and/or throw Exceptions. - - - - - &reftitle.changelog; - - - - - &Version; - &Description; - - - - - 8.X.0 - - Description - - - - - - + + + &reftitle.examples; <methodname>DOMElement::append</methodname> example - Description. + Appends nodes in the container element. loadXML("hello "); +$world = $doc->documentElement; + +$world->append("beautiful", $doc->createElement("world")); + +echo $doc->saveXML(); ?> ]]> &example.outputs; +hello beautiful ]]> - - &reftitle.notes; - - - Any notes that don't fit anywhere else should go here. - - - - &reftitle.seealso; - ClassName::otherMethodName - some_function - something appendix + DOMParentNode::append + DOMElement::prepend From b03f08b9003779f5f90e90db55685de1e3b1ca2b Mon Sep 17 00:00:00 2001 From: Niels Dossche <7771979+nielsdos@users.noreply.github.com> Date: Tue, 7 Nov 2023 22:52:50 +0100 Subject: [PATCH 18/45] Add docs for DOMDocument::append --- reference/dom/domdocument/append.xml | 87 ++++++---------------------- 1 file changed, 17 insertions(+), 70 deletions(-) diff --git a/reference/dom/domdocument/append.xml b/reference/dom/domdocument/append.xml index f3fff766a663..639c3cc0e72a 100644 --- a/reference/dom/domdocument/append.xml +++ b/reference/dom/domdocument/append.xml @@ -1,8 +1,8 @@ - + DOMDocument::append - Description + Appends nodes after the last child node @@ -11,64 +11,14 @@ public voidDOMDocument::append DOMNodestringnodes - &warn.undocumented.func; - Description. + Appends one or many nodes to the list of children after the last child node. - - &reftitle.parameters; - - - - nodes - - - Description. - - - - - - - - - &reftitle.returnvalues; - - &return.void; - - - - - &reftitle.errors; - - When does this function issue E_* level errors, - and/or throw Exceptions. - - - - - &reftitle.changelog; - - - - - &Version; - &Description; - - - - - 8.X.0 - - Description - - - - - - + + + &reftitle.examples; @@ -80,34 +30,31 @@ loadXML(""); + +$doc->append("beautiful", $doc->createElement("world")); + +echo $doc->saveXML(); ?> ]]> &example.outputs; +beautiful + ]]> - - &reftitle.notes; - - - Any notes that don't fit anywhere else should go here. - - - - &reftitle.seealso; - ClassName::otherMethodName - some_function - something appendix + DOMParentNode::append + DOMDocument::prepend From 0a2dadf3b77e16ba2b993553634bdd9134e3da56 Mon Sep 17 00:00:00 2001 From: Niels Dossche <7771979+nielsdos@users.noreply.github.com> Date: Tue, 7 Nov 2023 23:04:32 +0100 Subject: [PATCH 19/45] Fix description --- reference/dom/domdocument/append.xml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/reference/dom/domdocument/append.xml b/reference/dom/domdocument/append.xml index 639c3cc0e72a..0dd51019e952 100644 --- a/reference/dom/domdocument/append.xml +++ b/reference/dom/domdocument/append.xml @@ -25,7 +25,7 @@ <methodname>DOMDocument::append</methodname> example - Description. + Appends nodes in the document. Date: Tue, 7 Nov 2023 23:06:25 +0100 Subject: [PATCH 20/45] DOMParentNode::prepend errors --- reference/dom/domparentnode/prepend.xml | 27 +++++++++++++++++++++++++ 1 file changed, 27 insertions(+) diff --git a/reference/dom/domparentnode/prepend.xml b/reference/dom/domparentnode/prepend.xml index b4f033c4e4ae..3598bc1e73dd 100644 --- a/reference/dom/domparentnode/prepend.xml +++ b/reference/dom/domparentnode/prepend.xml @@ -40,6 +40,33 @@ + + &reftitle.errors; + + + + DOM_HIERARCHY_REQUEST_ERR + + + Raised if this node is of a type that does not allow children of the + type of one of the passed nodes, or if the node to + put in is one of this node's ancestors or this node itself. + + + + + DOM_WRONG_DOCUMENT_ERR + + + Raised if one of the passed nodes was created from a different + document than the one that created this node. + + + + + + + &reftitle.seealso; From c6abae245f1b3fdb4a5e312634f4f34518542f4c Mon Sep 17 00:00:00 2001 From: Niels Dossche <7771979+nielsdos@users.noreply.github.com> Date: Tue, 7 Nov 2023 23:09:33 +0100 Subject: [PATCH 21/45] Add docs for DOMDocument::prepend --- reference/dom/domdocument/prepend.xml | 90 ++++++--------------------- 1 file changed, 19 insertions(+), 71 deletions(-) diff --git a/reference/dom/domdocument/prepend.xml b/reference/dom/domdocument/prepend.xml index ae94a3a1066f..6ee8bbfab7fe 100644 --- a/reference/dom/domdocument/prepend.xml +++ b/reference/dom/domdocument/prepend.xml @@ -1,8 +1,8 @@ - + DOMDocument::prepend - Description + Prepends nodes before the first child node @@ -11,103 +11,51 @@ public voidDOMDocument::prepend DOMNodestringnodes - &warn.undocumented.func; - Description. + Prepends one or many nodes to the list of children before the first child node. - - &reftitle.parameters; - - - - nodes - - - Description. - - - - - - - - - &reftitle.returnvalues; - - &return.void; - - - - - &reftitle.errors; - - When does this function issue E_* level errors, - and/or throw Exceptions. - - - - - &reftitle.changelog; - - - - - &Version; - &Description; - - - - - 8.X.0 - - Description - - - - - - + + + &reftitle.examples; <methodname>DOMDocument::prepend</methodname> example - Description. + Prepends nodes before the document root. loadXML(""); + +$doc->prepend($doc->createElement("hello"), "beautiful"); + +echo $doc->saveXML(); ?> ]]> &example.outputs; + +beautiful + ]]> - - &reftitle.notes; - - - Any notes that don't fit anywhere else should go here. - - - - &reftitle.seealso; - ClassName::otherMethodName - some_function - something appendix + DOMParentNode::prepend + DOMDocument::append From 8283b8454c46cefabf7568bcc2b1ec76748260fd Mon Sep 17 00:00:00 2001 From: Niels Dossche <7771979+nielsdos@users.noreply.github.com> Date: Tue, 7 Nov 2023 23:15:44 +0100 Subject: [PATCH 22/45] Document DOMDocumentFragment::prepend --- reference/dom/domdocumentfragment/prepend.xml | 88 ++++--------------- 1 file changed, 17 insertions(+), 71 deletions(-) diff --git a/reference/dom/domdocumentfragment/prepend.xml b/reference/dom/domdocumentfragment/prepend.xml index 427578c70d6f..626edf014f6a 100644 --- a/reference/dom/domdocumentfragment/prepend.xml +++ b/reference/dom/domdocumentfragment/prepend.xml @@ -1,8 +1,8 @@ - + DOMDocumentFragment::prepend - Description + Prepends nodes before the first child node @@ -11,103 +11,49 @@ public voidDOMDocumentFragment::prepend DOMNodestringnodes - &warn.undocumented.func; - Description. + Prepends one or many nodes to the list of children before the first child node. - - &reftitle.parameters; - - - - nodes - - - Description. - - - - - - - - - &reftitle.returnvalues; - - &return.void; - - - - - &reftitle.errors; - - When does this function issue E_* level errors, - and/or throw Exceptions. - - - - - &reftitle.changelog; - - - - - &Version; - &Description; - - - - - 8.X.0 - - Description - - - - - - + + + &reftitle.examples; <methodname>DOMDocumentFragment::prepend</methodname> example - Description. + Prepends nodes before the fragment root. createDocumentFragment(); +$fragment->appendChild($doc->createElement("world")); + +$fragment->prepend($doc->createElement("hello"), "beautiful"); + +echo $doc->saveXML($fragment); ?> ]]> &example.outputs; beautiful ]]> - - &reftitle.notes; - - - Any notes that don't fit anywhere else should go here. - - - - &reftitle.seealso; - ClassName::otherMethodName - some_function - something appendix + DOMParentNode::prepend + DOMDocumentFragment::append From 7b254c74ac5011255d0501f20a6a89cfa0354b59 Mon Sep 17 00:00:00 2001 From: Niels Dossche <7771979+nielsdos@users.noreply.github.com> Date: Tue, 7 Nov 2023 23:18:12 +0100 Subject: [PATCH 23/45] Better description for DOMDocument::{append,prepend} docs --- reference/dom/domdocument/append.xml | 2 +- reference/dom/domdocument/prepend.xml | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/reference/dom/domdocument/append.xml b/reference/dom/domdocument/append.xml index 0dd51019e952..2a621b801c45 100644 --- a/reference/dom/domdocument/append.xml +++ b/reference/dom/domdocument/append.xml @@ -25,7 +25,7 @@ <methodname>DOMDocument::append</methodname> example - Appends nodes in the document. + Adds nodes after the document root. <methodname>DOMDocument::prepend</methodname> example - Prepends nodes before the document root. + Adds nodes before the document root. Date: Tue, 7 Nov 2023 23:20:46 +0100 Subject: [PATCH 24/45] Add docs for DOMElement::prepend --- reference/dom/domelement/prepend.xml | 89 ++++++---------------------- 1 file changed, 18 insertions(+), 71 deletions(-) diff --git a/reference/dom/domelement/prepend.xml b/reference/dom/domelement/prepend.xml index 3e494d2342bd..790a45e183a7 100644 --- a/reference/dom/domelement/prepend.xml +++ b/reference/dom/domelement/prepend.xml @@ -1,8 +1,8 @@ - + DOMElement::prepend - Description + Prepends nodes before the first child node @@ -11,103 +11,50 @@ public voidDOMElement::prepend DOMNodestringnodes - &warn.undocumented.func; - Description. + Prepends one or many nodes to the list of children before the first child node. - - &reftitle.parameters; - - - - nodes - - - Description. - - - - - - - - - &reftitle.returnvalues; - - &return.void; - - - - - &reftitle.errors; - - When does this function issue E_* level errors, - and/or throw Exceptions. - - - - - &reftitle.changelog; - - - - - &Version; - &Description; - - - - - 8.X.0 - - Description - - - - - - + + + &reftitle.examples; <methodname>DOMElement::prepend</methodname> example - Description. + Prepends nodes in the container element. loadXML(" world"); +$world = $doc->documentElement; + +$world->prepend($doc->createElement("hello"), "beautiful"); + +echo $doc->saveXML(); ?> ]]> &example.outputs; +beautiful world ]]> - - &reftitle.notes; - - - Any notes that don't fit anywhere else should go here. - - - - &reftitle.seealso; - ClassName::otherMethodName - some_function - something appendix + DOMParentNode::prepend + DOMElement::append From afcbb48781cf2e1a7b0b386896b802d179487583 Mon Sep 17 00:00:00 2001 From: Niels Dossche <7771979+nielsdos@users.noreply.github.com> Date: Tue, 7 Nov 2023 23:23:37 +0100 Subject: [PATCH 25/45] Add docs for DOMDocumentFragment::append --- reference/dom/domdocumentfragment/append.xml | 86 ++++---------------- 1 file changed, 16 insertions(+), 70 deletions(-) diff --git a/reference/dom/domdocumentfragment/append.xml b/reference/dom/domdocumentfragment/append.xml index 2cd09afb0267..b5145a67f922 100644 --- a/reference/dom/domdocumentfragment/append.xml +++ b/reference/dom/domdocumentfragment/append.xml @@ -1,8 +1,8 @@ - + DOMDocumentFragment::append - Description + Appends nodes after the last child node @@ -11,64 +11,14 @@ public voidDOMDocumentFragment::append DOMNodestringnodes - &warn.undocumented.func; - Description. + Appends one or many nodes to the list of children after the last child node. - - &reftitle.parameters; - - - - nodes - - - Description. - - - - - - - - - &reftitle.returnvalues; - - &return.void; - - - - - &reftitle.errors; - - When does this function issue E_* level errors, - and/or throw Exceptions. - - - - - &reftitle.changelog; - - - - - &Version; - &Description; - - - - - 8.X.0 - - Description - - - - - - + + + &reftitle.examples; @@ -80,34 +30,30 @@ createDocumentFragment(); +$fragment->appendChild($doc->createElement("hello")); + +$fragment->append("beautiful", $doc->createElement("world")); + +echo $doc->saveXML($fragment); ?> ]]> &example.outputs; beautiful ]]> - - &reftitle.notes; - - - Any notes that don't fit anywhere else should go here. - - - - &reftitle.seealso; - ClassName::otherMethodName - some_function - something appendix + DOMParentNode::append + DOMDocumentFragment::prepend From 0396cb4f263d6a7195f70a00fab0687312ef969d Mon Sep 17 00:00:00 2001 From: Niels Dossche <7771979+nielsdos@users.noreply.github.com> Date: Tue, 7 Nov 2023 23:35:24 +0100 Subject: [PATCH 26/45] Add docs for DOMCharacterData::remove --- reference/dom/domcharacterdata/remove.xml | 78 ++++++----------------- 1 file changed, 19 insertions(+), 59 deletions(-) diff --git a/reference/dom/domcharacterdata/remove.xml b/reference/dom/domcharacterdata/remove.xml index 1111270b411f..f1c09a27dfad 100644 --- a/reference/dom/domcharacterdata/remove.xml +++ b/reference/dom/domcharacterdata/remove.xml @@ -1,8 +1,8 @@ - + DOMCharacterData::remove - Description + Removes the character data @@ -11,91 +11,51 @@ public voidDOMCharacterData::remove - &warn.undocumented.func; - Description. + Removes the character data. - - &reftitle.parameters; - &no.function.parameters; - - - &reftitle.returnvalues; - - &return.void; - - - - - &reftitle.errors; - - When does this function issue E_* level errors, - and/or throw Exceptions. - - - - - &reftitle.changelog; - - - - - &Version; - &Description; - - - - - 8.X.0 - - Description - - - - - - + + &reftitle.examples; <methodname>DOMCharacterData::remove</methodname> example - Description. + Removes the character data. loadXML(""); +$cdata = $doc->documentElement->firstChild; + +$cdata->remove(); + +echo $doc->saveXML(); ?> ]]> &example.outputs; + ]]> - - &reftitle.notes; - - - Any notes that don't fit anywhere else should go here. - - - - &reftitle.seealso; - ClassName::otherMethodName - some_function - something appendix + DOMCharacterData::after + DOMCharacterData::before + DOMCharacterData::replaceWith + DOMNode::removeChild From 6e8d2860ea25e936db19bc5bce9b77cbc40afff7 Mon Sep 17 00:00:00 2001 From: Niels Dossche <7771979+nielsdos@users.noreply.github.com> Date: Tue, 7 Nov 2023 23:37:49 +0100 Subject: [PATCH 27/45] Document DOMElement::remove --- reference/dom/domelement/remove.xml | 78 +++++++---------------------- 1 file changed, 19 insertions(+), 59 deletions(-) diff --git a/reference/dom/domelement/remove.xml b/reference/dom/domelement/remove.xml index 59d6dcfaf64c..1914f8f6815c 100644 --- a/reference/dom/domelement/remove.xml +++ b/reference/dom/domelement/remove.xml @@ -1,8 +1,8 @@ - + DOMElement::remove - Description + Removes the character element @@ -11,91 +11,51 @@ public voidDOMElement::remove - &warn.undocumented.func; - Description. + Removes the element. - - &reftitle.parameters; - &no.function.parameters; - - - &reftitle.returnvalues; - - &return.void; - - - - - &reftitle.errors; - - When does this function issue E_* level errors, - and/or throw Exceptions. - - - - - &reftitle.changelog; - - - - - &Version; - &Description; - - - - - 8.X.0 - - Description - - - - - - + + &reftitle.examples; <methodname>DOMElement::remove</methodname> example - Description. + Removes the element. loadXML(""); +$hello = $doc->documentElement->firstChild; + +$hello->remove(); + +echo $doc->saveXML(); ?> ]]> &example.outputs; + ]]> - - &reftitle.notes; - - - Any notes that don't fit anywhere else should go here. - - - - &reftitle.seealso; - ClassName::otherMethodName - some_function - something appendix + DOMElement::after + DOMElement::before + DOMElement::replaceWith + DOMNode::removeChild From 8c0eeb257bac87c5f0bc9c950171abc26df23410 Mon Sep 17 00:00:00 2001 From: Niels Dossche <7771979+nielsdos@users.noreply.github.com> Date: Tue, 7 Nov 2023 23:47:51 +0100 Subject: [PATCH 28/45] Add docs for DOMDocument::adoptNode --- reference/dom/domdocument/adoptnode.xml | 85 +++++++++++-------------- 1 file changed, 36 insertions(+), 49 deletions(-) diff --git a/reference/dom/domdocument/adoptnode.xml b/reference/dom/domdocument/adoptnode.xml index 6c7f3a43f157..5a289078b2d3 100644 --- a/reference/dom/domdocument/adoptnode.xml +++ b/reference/dom/domdocument/adoptnode.xml @@ -2,7 +2,7 @@ DOMDocument::adoptNode - Description + Transfer a node from another document @@ -11,9 +11,8 @@ public DOMNodefalseDOMDocument::adoptNode DOMNodenode - &warn.undocumented.func; - Description. + Transfer a node from another document into current document. @@ -25,7 +24,7 @@ node - Description. + The node to transfer. @@ -36,78 +35,66 @@ &reftitle.returnvalues; - Description. + The node that was transfered, or &false; on error. - &reftitle.errors; - - When does this function issue E_* level errors, - and/or throw Exceptions. - - - - - &reftitle.changelog; - - - - - &Version; - &Description; - - - - - 8.X.0 - - Description - - - - - - - + &reftitle.errors; + + + + DOM_NOT_SUPPORTED_ERR + + + Raised if the node type is not supported for document transfers. + + + + + + + &reftitle.examples; <methodname>DOMDocument::adoptNode</methodname> example - Description. + Transfers the hello element from the first document to the second one. loadXML(""); +$hello = $doc1->documentElement->firstChild; + +$doc2 = new DOMDocument; +$doc2->loadXML(""); +$doc2->documentElement->appendChild($doc2->adoptNode($hello)); + +echo $doc1->saveXML() . PHP_EOL; +echo $doc2->saveXML(); ?> ]]> &example.outputs; + + + + ]]> - - &reftitle.notes; - - - Any notes that don't fit anywhere else should go here. - - - - &reftitle.seealso; - ClassName::otherMethodName - some_function - something appendix + DOMDocument::importNode From dd3b576a5c232c5338666f2c7ea8ad648a2a7aeb Mon Sep 17 00:00:00 2001 From: Niels Dossche <7771979+nielsdos@users.noreply.github.com> Date: Tue, 7 Nov 2023 23:49:50 +0100 Subject: [PATCH 29/45] fix ws --- reference/dom/domdocument/adoptnode.xml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/reference/dom/domdocument/adoptnode.xml b/reference/dom/domdocument/adoptnode.xml index 5a289078b2d3..c02b150c69e1 100644 --- a/reference/dom/domdocument/adoptnode.xml +++ b/reference/dom/domdocument/adoptnode.xml @@ -54,7 +54,7 @@ - + &reftitle.examples; From 079aa77867835bd55b6038d6542a4f368e21942f Mon Sep 17 00:00:00 2001 From: Niels Dossche <7771979+nielsdos@users.noreply.github.com> Date: Wed, 8 Nov 2023 21:15:49 +0100 Subject: [PATCH 30/45] Add errors for DOMChildNode::replaceWith --- reference/dom/domchildnode/replacewith.xml | 27 ++++++++++++++++++++++ 1 file changed, 27 insertions(+) diff --git a/reference/dom/domchildnode/replacewith.xml b/reference/dom/domchildnode/replacewith.xml index 7cfa11c9a97f..21845478c57e 100644 --- a/reference/dom/domchildnode/replacewith.xml +++ b/reference/dom/domchildnode/replacewith.xml @@ -41,6 +41,33 @@ + + &reftitle.errors; + + + + DOM_HIERARCHY_REQUEST_ERR + + + Raised if this node's parent is of a type that does not allow children of the + type of one of the passed nodes, or if the node to + put in is one of this node's ancestors or this node itself. + + + + + DOM_WRONG_DOCUMENT_ERR + + + Raised if one of the passed nodes was created from a different + document than the one that created this node. + + + + + + + &reftitle.seealso; From 1e409d1ca9a35cd5f5d93dbf9ac94bb90e1da3bb Mon Sep 17 00:00:00 2001 From: Niels Dossche <7771979+nielsdos@users.noreply.github.com> Date: Wed, 8 Nov 2023 21:16:02 +0100 Subject: [PATCH 31/45] Remove misleading statement --- reference/dom/domchildnode/replacewith.xml | 1 - 1 file changed, 1 deletion(-) diff --git a/reference/dom/domchildnode/replacewith.xml b/reference/dom/domchildnode/replacewith.xml index 21845478c57e..9b4f32468818 100644 --- a/reference/dom/domchildnode/replacewith.xml +++ b/reference/dom/domchildnode/replacewith.xml @@ -13,7 +13,6 @@ Replaces the node with new nodes. - A combination of DOMChildNode::remove and DOMChildNode::append. From 9c2ecdc698afb94bb0a24c35f3dad8b480ee3d67 Mon Sep 17 00:00:00 2001 From: Niels Dossche <7771979+nielsdos@users.noreply.github.com> Date: Fri, 10 Nov 2023 00:38:38 +0100 Subject: [PATCH 32/45] Update reference/dom/domelement/before.xml Co-authored-by: Gina Peter Banyard --- reference/dom/domelement/before.xml | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/reference/dom/domelement/before.xml b/reference/dom/domelement/before.xml index 2f42df0daff1..51509481ea8d 100644 --- a/reference/dom/domelement/before.xml +++ b/reference/dom/domelement/before.xml @@ -54,9 +54,8 @@ hello &reftitle.seealso; - ClassName::otherMethodName - some_function - + DOMChildNode::before + DOMElement::after From 794093aaa5adfdb5f638c6fce7f5caed78a90f5a Mon Sep 17 00:00:00 2001 From: Niels Dossche <7771979+nielsdos@users.noreply.github.com> Date: Fri, 10 Nov 2023 00:39:43 +0100 Subject: [PATCH 33/45] Fix description of DOMDocumentFragment::append example --- reference/dom/domdocumentfragment/append.xml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/reference/dom/domdocumentfragment/append.xml b/reference/dom/domdocumentfragment/append.xml index b5145a67f922..262ec46fa946 100644 --- a/reference/dom/domdocumentfragment/append.xml +++ b/reference/dom/domdocumentfragment/append.xml @@ -25,7 +25,7 @@ <methodname>DOMDocumentFragment::append</methodname> example - Description. + Appends nodes in the fragment. Date: Fri, 10 Nov 2023 00:40:36 +0100 Subject: [PATCH 34/45] Fix ws --- reference/dom/domchildnode/replacewith.xml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/reference/dom/domchildnode/replacewith.xml b/reference/dom/domchildnode/replacewith.xml index 9b4f32468818..d92a46d5db4d 100644 --- a/reference/dom/domchildnode/replacewith.xml +++ b/reference/dom/domchildnode/replacewith.xml @@ -66,7 +66,7 @@ - + &reftitle.seealso; From eddb1b4ae06634c43fa9268fb3fb008509233186 Mon Sep 17 00:00:00 2001 From: Niels Dossche <7771979+nielsdos@users.noreply.github.com> Date: Sat, 11 Nov 2023 00:36:43 +0100 Subject: [PATCH 35/45] Fix DOMElement::remove description --- reference/dom/domelement/remove.xml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/reference/dom/domelement/remove.xml b/reference/dom/domelement/remove.xml index 1914f8f6815c..986237b0e0f6 100644 --- a/reference/dom/domelement/remove.xml +++ b/reference/dom/domelement/remove.xml @@ -2,7 +2,7 @@ DOMElement::remove - Removes the character element + Removes the element From e343dfb6d0e96cce63bf8985939ad1a4393a6f0c Mon Sep 17 00:00:00 2001 From: Niels Dossche <7771979+nielsdos@users.noreply.github.com> Date: Sat, 11 Nov 2023 00:36:52 +0100 Subject: [PATCH 36/45] Add replaceWith docs --- .../dom/domcharacterdata/replacewith.xml | 91 ++++--------------- reference/dom/domelement/replacewith.xml | 91 ++++--------------- 2 files changed, 40 insertions(+), 142 deletions(-) diff --git a/reference/dom/domcharacterdata/replacewith.xml b/reference/dom/domcharacterdata/replacewith.xml index b2535e13b92a..be2d2e9b8f92 100644 --- a/reference/dom/domcharacterdata/replacewith.xml +++ b/reference/dom/domcharacterdata/replacewith.xml @@ -1,8 +1,8 @@ - + DOMCharacterData::replaceWith - Description + Replaces the character data with new nodes @@ -11,103 +11,52 @@ public voidDOMCharacterData::replaceWith DOMNodestringnodes - &warn.undocumented.func; - Description. + Replaces the character data with new nodes. - - &reftitle.parameters; - - - - nodes - - - Description. - - - - - - - - - &reftitle.returnvalues; - - &return.void; - - - - - &reftitle.errors; - - When does this function issue E_* level errors, - and/or throw Exceptions. - - - - - &reftitle.changelog; - - - - - &Version; - &Description; - - - - - 8.X.0 - - Description - - - - - - + + + &reftitle.examples; <methodname>DOMCharacterData::replaceWith</methodname> example - Description. + Replaces the character data with new nodes. loadXML(""); +$cdata = $doc->documentElement->firstChild; + +$cdata->replaceWith("beautiful", $doc->createElement("world")); + +echo $doc->saveXML(); ?> ]]> &example.outputs; +beautiful ]]> - - &reftitle.notes; - - - Any notes that don't fit anywhere else should go here. - - - - &reftitle.seealso; - ClassName::otherMethodName - some_function - something appendix + DOMChildNode::replaceWith + DOMCharacterData::after + DOMCharacterData::before + DOMCharacterData::remove diff --git a/reference/dom/domelement/replacewith.xml b/reference/dom/domelement/replacewith.xml index 9baca304509e..fd6c8724ac1b 100644 --- a/reference/dom/domelement/replacewith.xml +++ b/reference/dom/domelement/replacewith.xml @@ -1,8 +1,8 @@ - + DOMElement::replaceWith - Description + Replaces the element with new nodes @@ -11,103 +11,52 @@ public voidDOMElement::replaceWith DOMNodestringnodes - &warn.undocumented.func; - Description. + Replaces the element with new nodes. - - &reftitle.parameters; - - - - nodes - - - Description. - - - - - - - - - &reftitle.returnvalues; - - &return.void; - - - - - &reftitle.errors; - - When does this function issue E_* level errors, - and/or throw Exceptions. - - - - - &reftitle.changelog; - - - - - &Version; - &Description; - - - - - 8.X.0 - - Description - - - - - - + + + &reftitle.examples; <methodname>DOMElement::replaceWith</methodname> example - Description. + Replaces the element with new nodes. loadXML(""); +$cdata = $doc->documentElement->firstChild; + +$cdata->replaceWith("beautiful", $doc->createElement("world")); + +echo $doc->saveXML(); ?> ]]> &example.outputs; +beautiful ]]> - - &reftitle.notes; - - - Any notes that don't fit anywhere else should go here. - - - - &reftitle.seealso; - ClassName::otherMethodName - some_function - something appendix + DOMChildNode::replaceWith + DOMElement::after + DOMElement::before + DOMElement::remove From fe645c07231ef6a693a74140076293465ab3882a Mon Sep 17 00:00:00 2001 From: Niels Dossche <7771979+nielsdos@users.noreply.github.com> Date: Sat, 11 Nov 2023 00:43:36 +0100 Subject: [PATCH 37/45] Add version data --- reference/dom/versions.xml | 21 ++++++++++++++++++++- 1 file changed, 20 insertions(+), 1 deletion(-) diff --git a/reference/dom/versions.xml b/reference/dom/versions.xml index e75393343dcd..2c95ca18305e 100644 --- a/reference/dom/versions.xml +++ b/reference/dom/versions.xml @@ -12,10 +12,14 @@ + + + + @@ -30,7 +34,8 @@ - + + @@ -50,9 +55,11 @@ + + @@ -65,11 +72,17 @@ + + + + + + @@ -81,9 +94,13 @@ + + + + @@ -112,6 +129,7 @@ + @@ -148,6 +166,7 @@ + From 7f1a00fd5b3ba5c47e0d13f54f33e29d23581ad3 Mon Sep 17 00:00:00 2001 From: Niels Dossche <7771979+nielsdos@users.noreply.github.com> Date: Sat, 11 Nov 2023 00:52:54 +0100 Subject: [PATCH 38/45] Add docs for DOMElement::replaceChildren --- reference/dom/domelement/replacechildren.xml | 93 +++++--------------- reference/dom/domelement/replacewith.xml | 1 + 2 files changed, 23 insertions(+), 71 deletions(-) diff --git a/reference/dom/domelement/replacechildren.xml b/reference/dom/domelement/replacechildren.xml index 9c2ff3fb7a91..facdf5944b08 100644 --- a/reference/dom/domelement/replacechildren.xml +++ b/reference/dom/domelement/replacechildren.xml @@ -1,8 +1,8 @@ - + DOMElement::replaceChildren - Description + Replace children in element @@ -11,103 +11,54 @@ public voidDOMElement::replaceChildren DOMNodestringnodes - &warn.undocumented.func; - Description. + Replaces the children in the element with new nodes. - - &reftitle.parameters; - - - - nodes - - - Description. - - - - - - - - - &reftitle.returnvalues; - - &return.void; - - - - - &reftitle.errors; - - When does this function issue E_* level errors, - and/or throw Exceptions. - - - - - &reftitle.changelog; - - - - - &Version; - &Description; - - - - - 8.X.0 - - Description - - - - - - + + + &reftitle.examples; <methodname>DOMElement::replaceChildren</methodname> example - Description. + Replaces the children with new nodes. loadXML(""); +$container = $doc->documentElement; + +$container->replaceWith("beautiful", $doc->createElement("world")); + +echo $doc->saveXML(); ?> ]]> &example.outputs; +beautiful + ]]> - - &reftitle.notes; - - - Any notes that don't fit anywhere else should go here. - - - - &reftitle.seealso; - ClassName::otherMethodName - some_function - something appendix + DOMParentNode::replaceChildren + DOMElement::replaceWith + DOMElement::after + DOMElement::before + DOMElement::remove diff --git a/reference/dom/domelement/replacewith.xml b/reference/dom/domelement/replacewith.xml index fd6c8724ac1b..7ce4ee0d6f55 100644 --- a/reference/dom/domelement/replacewith.xml +++ b/reference/dom/domelement/replacewith.xml @@ -54,6 +54,7 @@ echo $doc->saveXML(); &reftitle.seealso; DOMChildNode::replaceWith + DOMElement::replaceChildren DOMElement::after DOMElement::before DOMElement::remove From eb12597eb67cc0df120e96e2fc8306360bfda69c Mon Sep 17 00:00:00 2001 From: Niels Dossche <7771979+nielsdos@users.noreply.github.com> Date: Sat, 11 Nov 2023 00:58:08 +0100 Subject: [PATCH 39/45] Add DOMDocument::replaceChildren docs --- reference/dom/domdocument/replacechildren.xml | 88 ++++--------------- 1 file changed, 17 insertions(+), 71 deletions(-) diff --git a/reference/dom/domdocument/replacechildren.xml b/reference/dom/domdocument/replacechildren.xml index 415268bf69c5..9e3850b699ca 100644 --- a/reference/dom/domdocument/replacechildren.xml +++ b/reference/dom/domdocument/replacechildren.xml @@ -1,8 +1,8 @@ - + DOMDocument::replaceChildren - Description + Replace children in document @@ -11,103 +11,49 @@ public voidDOMDocument::replaceChildren DOMNodestringnodes - &warn.undocumented.func; - Description. + Replaces the children in the document with new nodes. - - &reftitle.parameters; - - - - nodes - - - Description. - - - - - - - - - &reftitle.returnvalues; - - &return.void; - - - - - &reftitle.errors; - - When does this function issue E_* level errors, - and/or throw Exceptions. - - - - - &reftitle.changelog; - - - - - &Version; - &Description; - - - - - 8.X.0 - - Description - - - - - - + + + &reftitle.examples; <methodname>DOMDocument::replaceChildren</methodname> example - Description. + Replaces the children with new nodes. loadXML(""); + +$doc->replaceWith("beautiful", $doc->createElement("world")); + +echo $doc->saveXML(); ?> ]]> &example.outputs; +beautiful + ]]> - - &reftitle.notes; - - - Any notes that don't fit anywhere else should go here. - - - - &reftitle.seealso; - ClassName::otherMethodName - some_function - something appendix + DOMParentNode::replaceChildren From 83d8560132d016351ca2d53988826f6a7625217d Mon Sep 17 00:00:00 2001 From: Niels Dossche <7771979+nielsdos@users.noreply.github.com> Date: Sat, 11 Nov 2023 00:58:22 +0100 Subject: [PATCH 40/45] Add errors for DOMParentNode::replaceChildren --- .../dom/domparentnode/replacechildren.xml | 27 +++++++++++++++++++ 1 file changed, 27 insertions(+) diff --git a/reference/dom/domparentnode/replacechildren.xml b/reference/dom/domparentnode/replacechildren.xml index b07568d9f1cb..e0f313dff826 100644 --- a/reference/dom/domparentnode/replacechildren.xml +++ b/reference/dom/domparentnode/replacechildren.xml @@ -40,6 +40,33 @@ + + &reftitle.errors; + + + + DOM_HIERARCHY_REQUEST_ERR + + + Raised if this node's parent is of a type that does not allow children of the + type of one of the passed nodes, or if the node to + put in is one of this node's ancestors or this node itself. + + + + + DOM_WRONG_DOCUMENT_ERR + + + Raised if one of the passed nodes was created from a different + document than the one that created this node. + + + + + + + &reftitle.examples; From 3efce362f61b567fb2f759005dc072c7543fee51 Mon Sep 17 00:00:00 2001 From: Niels Dossche <7771979+nielsdos@users.noreply.github.com> Date: Sat, 11 Nov 2023 01:02:19 +0100 Subject: [PATCH 41/45] Update references for DOMDocument::replaceChildren --- reference/dom/domdocument/replacechildren.xml | 2 ++ 1 file changed, 2 insertions(+) diff --git a/reference/dom/domdocument/replacechildren.xml b/reference/dom/domdocument/replacechildren.xml index 9e3850b699ca..a31a0d002656 100644 --- a/reference/dom/domdocument/replacechildren.xml +++ b/reference/dom/domdocument/replacechildren.xml @@ -54,6 +54,8 @@ beautiful &reftitle.seealso; DOMParentNode::replaceChildren + DOMDocument::append + DOMDocument::prepend From bfa4f422640f0176026afcf6a8cc871f3a69e0bd Mon Sep 17 00:00:00 2001 From: Niels Dossche <7771979+nielsdos@users.noreply.github.com> Date: Sat, 11 Nov 2023 01:02:35 +0100 Subject: [PATCH 42/45] Add docs for DOMDocumentFragment::replaceChildren --- .../domdocumentfragment/replacechildren.xml | 91 ++++--------------- 1 file changed, 20 insertions(+), 71 deletions(-) diff --git a/reference/dom/domdocumentfragment/replacechildren.xml b/reference/dom/domdocumentfragment/replacechildren.xml index b7dee4fbacec..455be627111e 100644 --- a/reference/dom/domdocumentfragment/replacechildren.xml +++ b/reference/dom/domdocumentfragment/replacechildren.xml @@ -1,8 +1,8 @@ - + DOMDocumentFragment::replaceChildren - Description + Replace children in fragment @@ -11,103 +11,52 @@ public voidDOMDocumentFragment::replaceChildren DOMNodestringnodes - &warn.undocumented.func; - Description. + Replaces the children in the document fragment with new nodes. - - &reftitle.parameters; - - - - nodes - - - Description. - - - - - - - - - &reftitle.returnvalues; - - &return.void; - - - - - &reftitle.errors; - - When does this function issue E_* level errors, - and/or throw Exceptions. - - - - - &reftitle.changelog; - - - - - &Version; - &Description; - - - - - 8.X.0 - - Description - - - - - - + + + &reftitle.examples; <methodname>DOMDocumentFragment::replaceChildren</methodname> example - Description. + Replaces the children with new nodes. loadXML(""); +$fragment = $doc->createDocumentFragment(); +$fragment->append("hello"); + +$fragment->replaceWith("beautiful", $doc->createElement("world")); + +echo $doc->saveXML($fragment); ?> ]]> &example.outputs; ]]> - - &reftitle.notes; - - - Any notes that don't fit anywhere else should go here. - - - - &reftitle.seealso; - ClassName::otherMethodName - some_function - something appendix + DOMParentNode::replaceChildren + DOMDocumentFragment::append + DOMDocumentFragment::prepend From 1b8c2892409f7796f13b710c29f3d37d10ab35cd Mon Sep 17 00:00:00 2001 From: Niels Dossche <7771979+nielsdos@users.noreply.github.com> Date: Sat, 11 Nov 2023 01:09:13 +0100 Subject: [PATCH 43/45] Iterator docs --- reference/dom/domnamednodemap/getiterator.xml | 86 ++----------------- reference/dom/domnodelist/getiterator.xml | 86 ++----------------- 2 files changed, 14 insertions(+), 158 deletions(-) diff --git a/reference/dom/domnamednodemap/getiterator.xml b/reference/dom/domnamednodemap/getiterator.xml index 54ccfd72c0a5..11fde4142bcf 100644 --- a/reference/dom/domnamednodemap/getiterator.xml +++ b/reference/dom/domnamednodemap/getiterator.xml @@ -1,8 +1,8 @@ - + DOMNamedNodeMap::getIterator - Description + Retrieve an external iterator @@ -11,91 +11,19 @@ public IteratorDOMNamedNodeMap::getIterator - &warn.undocumented.func; - Description. + Returns an external iterator for the named ode map. - - &reftitle.parameters; - &no.function.parameters; - - - &reftitle.returnvalues; - - Description. - - - - - &reftitle.errors; - - When does this function issue E_* level errors, - and/or throw Exceptions. - - - - - &reftitle.changelog; - - - - - &Version; - &Description; - - - - - 8.X.0 - - Description - - - - - - - - - &reftitle.examples; - - <methodname>DOMNamedNodeMap::getIterator</methodname> example - - Description. - - - -]]> - - &example.outputs; - - - - - - - - &reftitle.notes; - - - Any notes that don't fit anywhere else should go here. - - - + + + &reftitle.seealso; - ClassName::otherMethodName - some_function - something appendix + IteratorAggregate::getIterator diff --git a/reference/dom/domnodelist/getiterator.xml b/reference/dom/domnodelist/getiterator.xml index cb0e5583f678..c96b742d0b95 100644 --- a/reference/dom/domnodelist/getiterator.xml +++ b/reference/dom/domnodelist/getiterator.xml @@ -1,8 +1,8 @@ - + DOMNodeList::getIterator - Description + Retrieve an external iterator @@ -11,91 +11,19 @@ public IteratorDOMNodeList::getIterator - &warn.undocumented.func; - Description. + Returns an external iterator for the node list. - - &reftitle.parameters; - &no.function.parameters; - - - &reftitle.returnvalues; - - Description. - - - - - &reftitle.errors; - - When does this function issue E_* level errors, - and/or throw Exceptions. - - - - - &reftitle.changelog; - - - - - &Version; - &Description; - - - - - 8.X.0 - - Description - - - - - - - - - &reftitle.examples; - - <methodname>DOMNodeList::getIterator</methodname> example - - Description. - - - -]]> - - &example.outputs; - - - - - - - - &reftitle.notes; - - - Any notes that don't fit anywhere else should go here. - - - + + + &reftitle.seealso; - ClassName::otherMethodName - some_function - something appendix + IteratorAggregate::getIterator From 92b8c13b3ef56e10ebde19cc78ef0f43557df313 Mon Sep 17 00:00:00 2001 From: Niels Dossche <7771979+nielsdos@users.noreply.github.com> Date: Sat, 11 Nov 2023 17:00:31 +0100 Subject: [PATCH 44/45] Fix mistakes --- reference/dom/domcharacterdata/remove.xml | 1 + reference/dom/domchildnode/after.xml | 2 +- reference/dom/domchildnode/before.xml | 2 +- reference/dom/domchildnode/replacewith.xml | 2 +- reference/dom/domdocument/adoptnode.xml | 2 +- reference/dom/domnamednodemap/getiterator.xml | 2 +- 6 files changed, 6 insertions(+), 5 deletions(-) diff --git a/reference/dom/domcharacterdata/remove.xml b/reference/dom/domcharacterdata/remove.xml index f1c09a27dfad..9c178b2bc7d1 100644 --- a/reference/dom/domcharacterdata/remove.xml +++ b/reference/dom/domcharacterdata/remove.xml @@ -52,6 +52,7 @@ echo $doc->saveXML(); &reftitle.seealso; + DOMChildNode::remove DOMCharacterData::after DOMCharacterData::before DOMCharacterData::replaceWith diff --git a/reference/dom/domchildnode/after.xml b/reference/dom/domchildnode/after.xml index ac87e957ca62..41f7e7b945dc 100644 --- a/reference/dom/domchildnode/after.xml +++ b/reference/dom/domchildnode/after.xml @@ -48,7 +48,7 @@ DOM_HIERARCHY_REQUEST_ERR - Raised if this node is of a type that does not allow children of the + Raised if the parent is of a type that does not allow children of the type of one of the passed nodes, or if the node to put in is one of this node's ancestors or this node itself. diff --git a/reference/dom/domchildnode/before.xml b/reference/dom/domchildnode/before.xml index 9f6a1ca3c672..c815f1ca77d2 100644 --- a/reference/dom/domchildnode/before.xml +++ b/reference/dom/domchildnode/before.xml @@ -48,7 +48,7 @@ DOM_HIERARCHY_REQUEST_ERR - Raised if this node is of a type that does not allow children of the + Raised if the parent is of a type that does not allow children of the type of one of the passed nodes, or if the node to put in is one of this node's ancestors or this node itself. diff --git a/reference/dom/domchildnode/replacewith.xml b/reference/dom/domchildnode/replacewith.xml index d92a46d5db4d..4eb8a1ef7874 100644 --- a/reference/dom/domchildnode/replacewith.xml +++ b/reference/dom/domchildnode/replacewith.xml @@ -48,7 +48,7 @@ DOM_HIERARCHY_REQUEST_ERR - Raised if this node's parent is of a type that does not allow children of the + Raised if the parent is of a type that does not allow children of the type of one of the passed nodes, or if the node to put in is one of this node's ancestors or this node itself. diff --git a/reference/dom/domdocument/adoptnode.xml b/reference/dom/domdocument/adoptnode.xml index c02b150c69e1..f6a1a9115959 100644 --- a/reference/dom/domdocument/adoptnode.xml +++ b/reference/dom/domdocument/adoptnode.xml @@ -12,7 +12,7 @@ DOMNodenode - Transfer a node from another document into current document. + Transfer a node from another document into the current document. diff --git a/reference/dom/domnamednodemap/getiterator.xml b/reference/dom/domnamednodemap/getiterator.xml index 11fde4142bcf..3ba7508fd8ce 100644 --- a/reference/dom/domnamednodemap/getiterator.xml +++ b/reference/dom/domnamednodemap/getiterator.xml @@ -12,7 +12,7 @@ - Returns an external iterator for the named ode map. + Returns an external iterator for the named node map. From 68a65dc121fd514433637ada6f0a92d978fd3b4d Mon Sep 17 00:00:00 2001 From: Niels Dossche <7771979+nielsdos@users.noreply.github.com> Date: Sat, 11 Nov 2023 20:07:03 +0100 Subject: [PATCH 45/45] Review fixes --- language-snippets.ent | 32 +++++++++++++++++++ reference/dom/domchildnode/after.xml | 27 +++------------- reference/dom/domchildnode/before.xml | 27 +++------------- reference/dom/domchildnode/replacewith.xml | 27 +++------------- reference/dom/domdocument/adoptnode.xml | 22 ++++++------- reference/dom/domparentnode/append.xml | 27 +++------------- reference/dom/domparentnode/prepend.xml | 27 +++------------- .../dom/domparentnode/replacechildren.xml | 27 +++------------- 8 files changed, 66 insertions(+), 150 deletions(-) diff --git a/language-snippets.ent b/language-snippets.ent index a9d17708997c..b3ec9e106c7a 100644 --- a/language-snippets.ent +++ b/language-snippets.ent @@ -1587,6 +1587,38 @@ it is inserted with (e.g.) DOMNo of the libxml option constants. '> + + DOM_HIERARCHY_REQUEST_ERR + + + Raised if the parent is of a type that does not allow children of the + type of one of the passed nodes, or if the node to + put in is one of this node's ancestors or this node itself. + + +'> + + + DOM_HIERARCHY_REQUEST_ERR + + + Raised if this node is of a type that does not allow children of the + type of one of the passed nodes, or if the node to + put in is one of this node's ancestors or this node itself. + + +'> + + + DOM_WRONG_DOCUMENT_ERR + + + Raised if one of the passed nodes was created from a different + document than the one that created this node. + + +'> + Upon failure, an E_WARNING is emitted. diff --git a/reference/dom/domchildnode/after.xml b/reference/dom/domchildnode/after.xml index 41f7e7b945dc..1844c0a95244 100644 --- a/reference/dom/domchildnode/after.xml +++ b/reference/dom/domchildnode/after.xml @@ -42,29 +42,10 @@ &reftitle.errors; - - - - DOM_HIERARCHY_REQUEST_ERR - - - Raised if the parent is of a type that does not allow children of the - type of one of the passed nodes, or if the node to - put in is one of this node's ancestors or this node itself. - - - - - DOM_WRONG_DOCUMENT_ERR - - - Raised if one of the passed nodes was created from a different - document than the one that created this node. - - - - - + + &dom.errors.hierarchy.parent; + &dom.errors.wrong_document; + diff --git a/reference/dom/domchildnode/before.xml b/reference/dom/domchildnode/before.xml index c815f1ca77d2..236f14014471 100644 --- a/reference/dom/domchildnode/before.xml +++ b/reference/dom/domchildnode/before.xml @@ -42,29 +42,10 @@ &reftitle.errors; - - - - DOM_HIERARCHY_REQUEST_ERR - - - Raised if the parent is of a type that does not allow children of the - type of one of the passed nodes, or if the node to - put in is one of this node's ancestors or this node itself. - - - - - DOM_WRONG_DOCUMENT_ERR - - - Raised if one of the passed nodes was created from a different - document than the one that created this node. - - - - - + + &dom.errors.hierarchy.parent; + &dom.errors.wrong_document; + diff --git a/reference/dom/domchildnode/replacewith.xml b/reference/dom/domchildnode/replacewith.xml index 4eb8a1ef7874..f94e40826a33 100644 --- a/reference/dom/domchildnode/replacewith.xml +++ b/reference/dom/domchildnode/replacewith.xml @@ -42,29 +42,10 @@ &reftitle.errors; - - - - DOM_HIERARCHY_REQUEST_ERR - - - Raised if the parent is of a type that does not allow children of the - type of one of the passed nodes, or if the node to - put in is one of this node's ancestors or this node itself. - - - - - DOM_WRONG_DOCUMENT_ERR - - - Raised if one of the passed nodes was created from a different - document than the one that created this node. - - - - - + + &dom.errors.hierarchy.parent; + &dom.errors.wrong_document; + diff --git a/reference/dom/domdocument/adoptnode.xml b/reference/dom/domdocument/adoptnode.xml index f6a1a9115959..1e97a51aa7b1 100644 --- a/reference/dom/domdocument/adoptnode.xml +++ b/reference/dom/domdocument/adoptnode.xml @@ -41,18 +41,16 @@ &reftitle.errors; - - - - DOM_NOT_SUPPORTED_ERR - - - Raised if the node type is not supported for document transfers. - - - - - + + + DOM_NOT_SUPPORTED_ERR + + + Raised if the node type is not supported for document transfers. + + + + diff --git a/reference/dom/domparentnode/append.xml b/reference/dom/domparentnode/append.xml index 41e449da6aca..b0e27831b9f9 100644 --- a/reference/dom/domparentnode/append.xml +++ b/reference/dom/domparentnode/append.xml @@ -42,29 +42,10 @@ &reftitle.errors; - - - - DOM_HIERARCHY_REQUEST_ERR - - - Raised if this node is of a type that does not allow children of the - type of one of the passed nodes, or if the node to - put in is one of this node's ancestors or this node itself. - - - - - DOM_WRONG_DOCUMENT_ERR - - - Raised if one of the passed nodes was created from a different - document than the one that created this node. - - - - - + + &dom.errors.hierarchy.self; + &dom.errors.wrong_document; + diff --git a/reference/dom/domparentnode/prepend.xml b/reference/dom/domparentnode/prepend.xml index 3598bc1e73dd..8f3a66ad76ca 100644 --- a/reference/dom/domparentnode/prepend.xml +++ b/reference/dom/domparentnode/prepend.xml @@ -42,29 +42,10 @@ &reftitle.errors; - - - - DOM_HIERARCHY_REQUEST_ERR - - - Raised if this node is of a type that does not allow children of the - type of one of the passed nodes, or if the node to - put in is one of this node's ancestors or this node itself. - - - - - DOM_WRONG_DOCUMENT_ERR - - - Raised if one of the passed nodes was created from a different - document than the one that created this node. - - - - - + + &dom.errors.hierarchy.self; + &dom.errors.wrong_document; + diff --git a/reference/dom/domparentnode/replacechildren.xml b/reference/dom/domparentnode/replacechildren.xml index e0f313dff826..bfd21197e07f 100644 --- a/reference/dom/domparentnode/replacechildren.xml +++ b/reference/dom/domparentnode/replacechildren.xml @@ -42,29 +42,10 @@ &reftitle.errors; - - - - DOM_HIERARCHY_REQUEST_ERR - - - Raised if this node's parent is of a type that does not allow children of the - type of one of the passed nodes, or if the node to - put in is one of this node's ancestors or this node itself. - - - - - DOM_WRONG_DOCUMENT_ERR - - - Raised if one of the passed nodes was created from a different - document than the one that created this node. - - - - - + + &dom.errors.hierarchy.self; + &dom.errors.wrong_document; +