How to document 'not implemented, sorta' stuff?
| From: | Philip Olson | Date: | Mon, 07 Jun 2010 14:47:45 +0000 |
| Subject: | How to document 'not implemented, sorta' stuff? | ||
| Groups: | php.doc | ||
| Request: | Send a blank email to phpdoc+get-969381936@lists.php.net to get a copy of this message | ||
There are several features in PHP that are "not implemented [yet]", including roughly 13
DOM classes. Well, they are sorta (but not really) implemented.
How should we deal with this?
Two types of "not implemented":
1. New things, like classes, methods and functions. Easier, and more straight forward
2. Changes, like new/different function parameters
Considering some of this stuff is several years old, I'm guessing much of it will _never_ be
implemented (e.g., these bogus DOM classes exist as of PHP 5.0.0) so instead they confuse people.
But unfortunately these bogus classes are defined, so I suppose they technically exist.
Some of this stuff is difficult to find but I imagine an exhaustive list would give people something
TODO, but personally I see most of these as bugs in php-src. Thoughts?
Here are real world examples:
------------
<?php
$a = new DomConfiguration();
$a->getParameter();
?>
------------
PHP Warning: DOMConfiguration::getParameter(): Not yet implemented
------------
------------
<?php
$a = new DomLocator();
echo $a->lineNumber, PHP_EOL;
echo $a->relatedNode;
?>
------------
TEST
TEST
------------
------------
<?php
$a = substr_replace('foo', 'foo bar', array(1,3), array(2,4));
$a = substr_replace('foo', 'foo bar', 0, array(0));
?>
------------
PHP Warning: substr_replace(): Functionality of 'from' and 'len' as arrays is
not implemented
PHP Warning: substr_replace(): 'from' and 'len' should be of same type -
numerical or array
------------
------------
<?php
$a = filter_has_var(INPUT_REQUEST, 'foo');
?>
------------
PHP Warning: filter_has_var(): INPUT_REQUEST is not yet implemented
------------
Regards,
Philip