Doc #79273 [PATCH]: DOMNode: Class synopsis lacks info about nullable properties
| From: | beberlei@php.net | Date: | Fri, 28 Feb 2020 23:23:35 +0000 |
| Subject: | Doc #79273 [PATCH]: DOMNode: Class synopsis lacks info about nullable properties | ||
| References: | 1 | Groups: | php.doc.bugs |
| Request: | Send a blank email to doc-bugs+get-17344@lists.php.net to get a copy of this message | ||
Edit report at https://bugs.php.net/bug.php?id=79273&edit=1
ID: 79273
Patch added by: beberlei@php.net
Reported by: ca at lsp dot net
Summary: DOMNode: Class synopsis lacks info about nullable
properties
Status: Assigned
Type: Documentation Problem
Package: DOM XML related
Operating System: Irrelevant
PHP Version: Irrelevant
Assigned To: beberlei
Block user comment: N
Private report: N
New Comment:
The following pull request has been associated:
Patch Name: #79273: Document nullable properties on DOMDocument and DOMNode
On GitHub: https://github.com/php/doc-en/pull/52
Patch: https://github.com/php/doc-en/pull/52.patch
Previous Comments:
------------------------------------------------------------------------
[2020-02-13 20:09:16] ca at lsp dot net
Description:
------------
---
From manual page: https://php.net/class.domnode
---
DOMNode has several properties that can be NULL:
* nodeValue
* parentNode
* firstChild
* lastChild
* previousSibling
* nextSibling
* attributes
* ownerDocument
The class synopsis, however, doesn't provide this important information.
Expected result:
----------------
public ?string $nodeValue ;
public readonly int $nodeType ;
public readonly ?DOMNode $parentNode ;
public readonly DOMNodeList $childNodes ;
public readonly ?DOMNode $firstChild ;
public readonly ?DOMNode $lastChild ;
public readonly ?DOMNode $previousSibling ;
public readonly ?DOMNode $nextSibling ;
public readonly ?DOMNamedNodeMap $attributes ;
public readonly ?DOMDocument $ownerDocument ;
Actual result:
--------------
public string $nodeValue ;
public readonly int $nodeType ;
public readonly DOMNode $parentNode ;
public readonly DOMNodeList $childNodes ;
public readonly DOMNode $firstChild ;
public readonly DOMNode $lastChild ;
public readonly DOMNode $previousSibling ;
public readonly DOMNode $nextSibling ;
public readonly DOMNamedNodeMap $attributes ;
public readonly DOMDocument $ownerDocument ;
------------------------------------------------------------------------
--
Edit this bug report at https://bugs.php.net/bug.php?id=79273&edit=1