8.4: Document all new DOM classes and methods - part 1

[ndossche]

Very WIP, not ready for review yet.

TODO:

• Update other extensions that link into DOM
• Update constants
• Finish class skeletons (class page, properties, ...)
• Document the NO_DEFAULT_NS constant (with caution)
• Document methods (NOTE: splitting PR because this is huge already)
• Update note about encoding
• Create examples of array indexing in NamedNodeMap ? Let's do this separately
• Add a note on top of the dom book to guide users to the new classes? Do this later once the docs are completed
• Explain xpath subtleties Separate PR
• Add note to XMLDocument properties that you should rely on the LIBXML_ flags now

[ndossche]

@Girgias I've finished with some basics. Most notably the class synopses are generated and the properties etc are all filled in. I've used xinclude quite a bit. I also fixed up some of the old DOM class descriptions.
It's probably best to already review this as-is, even though it's not finished and most notably the methods are missing.
This won't compile out of the box because of the entities.whatever.xml files not being generated because I haven't filled in the method stuff yet, but here's a zip that you can extract in reference/dom/dom to make it build:
entities.dom.zip
You also need php/doc-base#193

[Girgias]

Didn't test locally but this a pass across the whole PR

[Girgias]

The issue I can see for this, is that automatic linking for <constant>Dom\STRING_SIZE_ERR</constant> is not going to work because the row has no corresponding XML ID.

Can an XML element have 2 IDs? If yes that would fix it.

[ndossche]

Can an XML element have 2 IDs? If yes that would fix it.

No, but I don't think this is ever linked to directly 🤔

[ndossche]

Thanks for the initial review. I pushed fixup commits so they can be validated individually, I'll later rebase this to merge the fixups with the original commits.