Doc #79273 [Asn->Csd]: DOMNode: Class synopsis lacks info about nullable properties

From: Date: Fri, 30 Oct 2020 11:06:11 +0000
Subject: Doc #79273 [Asn->Csd]: DOMNode: Class synopsis lacks info about nullable properties
References: 1  Groups: php.doc.bugs 
Request: Send a blank email to doc-bugs+get-18055@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
 Updated by:         phpdocbot@php.net
 Reported by:        ca at lsp dot net
 Summary:            DOMNode: Class synopsis lacks info about nullable
                     properties
-Status:             Assigned
+Status:             Closed
 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:

Automatic comment on behalf of cmb
Revision: http://git.php.net/?p=doc/en.git;a=commit;h=24219de95d129309f248f1e0874dcddc015bfbff
Log: Fix #79273: Correctly document nullable properties on DOMDocument and DOMNode


Previous Comments:
------------------------------------------------------------------------
[2020-02-28 23:23:34] beberlei@php.net

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

------------------------------------------------------------------------
[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


Thread (3 messages)

« previous php.doc.bugs (#18055) next »