Document missing classes

[kocsismate]

Currently, the following internal classes are not yet documented:

• SensitiveParameterValue (Add SensitiveParameterValue documentation #2165)
• ClosedGeneratorException (Add ClosedGeneratorException to docs #3065/Document ClosedGeneratorException #2997)
• com_safearray_proxy (Add com_safearray_proxy to docs #3066)
• DOMNameSpaceNode (Add DOMNameSpaceNode class to docs #3060)
• LibXMLError (Fix LibXMLError class name #3063)
• PDORow (Add PDORow class to docs #3059)
• Random\IntervalBoundary enum is not documented #3074
• SQLite3Exception (Add SQLite3Exception documentation #3079)

The following internal classes are going to be undocumented as soon as PHP 8.4 is released:

• Dom\AdjacentPosition
• Dom\DocumentType
• Dom\CDATASection
• Dom\Comment
• Dom\ParentNode
• Dom\ChildNode
• Dom\Node
• Dom\NameSpaceInfo
• Dom\DocumentFragment
• Dom\NodeList
• Dom\CharacterData
• Dom\Attr
• Dom\Element
• Dom\DOMException
• Dom\Text
• Dom\NamedNodeMap
• Dom\Entity
• Dom\EntityReference
• Dom\Notation
• Dom\ProcessingInstruction
• Dom\XPath
• Dom\Document
• Dom\HTMLDocument
• Dom\XMLDocument
• ReflectionConstant

[cmb69]

Yay, com_safearray_proxy! I'll try to figure out its details.

Maybe @TimWolla wants to tackle SensitiveParameterValue?

[TimWolla]

Maybe @TimWolla wants to tackle SensitiveParameterValue?

I can write the description, but I need someone more experienced to bootstrap the docs for me. I've tried php doc-base/scripts/docgen/docgen.php -c SensitiveParameterValue, but that result is vastly incomplete (missing final on the class, missing properties, …).

[kocsismate]

@TimWolla as soon aa docgen created the file, you can run gen_stub.php on it (with --replace-classsynopses) and it will fix the signature.

[TimWolla]

I've tried php build/gen_stub.php --replace-classsynopses ../phpdoc/en/language/predefined/, but that did not do anything. Am I holding it wrong?

The docgen results are:

$ g d HEAD^..HEAD --stat
 language/predefined/interfaces.xml                        |  1 +
 language/predefined/sensitiveparametervalue.xml           | 65 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 language/predefined/sensitiveparametervalue/construct.xml | 69 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 language/predefined/sensitiveparametervalue/debuginfo.xml | 55 +++++++++++++++++++++++++++++++++++++++++++++++++++++++
 language/predefined/sensitiveparametervalue/getvalue.xml  | 55 +++++++++++++++++++++++++++++++++++++++++++++++++++++++
 language/predefined/versions.xml                          |  4 ++++
 6 files changed, 249 insertions(+)

[kocsismate]

@TimWolla yes, you are missing a parameter: after the --replace.... You need the stub path(s) in php-src. And the very last parameter is for the doc-en path.

[TimWolla]

Thanks, that did something.

[haszi]

Currently, the following internal classes are not yet documented:

• LibXMLError

LibXMLError is already documented as libXMLError. Is that OK or should one of those be changed to match the spelling of the other?

[Girgias]

Currently, the following internal classes are not yet documented:

• LibXMLError

LibXMLError is already documented as libXMLError. Is that OK or should one of those be changed to match the spelling of the other?

We should fix the name in the docs to match what the stubs is, which is LibXMLError

[kocsismate]

LibXMLError is already documented as libXMLError.

Thanks for the finding! I've just filed #3063 to fix the issue with the spelling.

[Girgias]

All missing classes have been documented 🎆

[kocsismate]

Sorry, I have to reopen the issue as in the meanwhile (since PHP 8.2) a few other newly added classes became undocumented.

[TimWolla]

few other newly added classes became undocumented.

I would write the docs for IntervalBoundary, but that has the problem that it's the first native enum and I believe PHD cannot yet do enums.

[kocsismate]

I would write the docs for IntervalBoundary, but that has the problem that it's the first native enum and I believe PHD cannot yet do enums.

Uhh, that's a problem indeed. Then I'll try to implement it both at gen_stub.php's and phd's side...

[Girgias]

I would write the docs for IntervalBoundary, but that has the problem that it's the first native enum and I believe PHD cannot yet do enums.

Uhh, that's a problem indeed. Then I'll try to implement it both at gen_stub.php's and phd's side...

The issue is that we are using an outdated version of DocBooks, and the new enum synopsis tag is only available in the newest prerelease of Docbook 5.2.

When I get back to the UK next week I will try to finalize the migrations for the markup of classes in the current documentations so that one can update the DocBook version.

[kocsismate]

When I get back to the UK next week I will try to finalize the migrations for the markup of classes in the current documentations so that one can update the DocBook version.

Ah, I completely forgot that you have already been working on this topic. Then I'll leave it up to you to fix phd. :) And I can provide a PR for gen_stub.php if needed.

[TimWolla]

What's the status with enum rendering?

[Girgias]

I'm going to work on this again now, as I've given up on trying to not give huge amount of work to already über outdated translations.