Req #43770 [Opn->Wfx]: docblock templates with getDocComment()
| From: | nikic@php.net | Date: | Sat, 29 Sep 2018 17:08:31 +0000 |
| Subject: | Req #43770 [Opn->Wfx]: docblock templates with getDocComment() | ||
| References: | 1 | Groups: | php.bugs |
| Request: | Send a blank email to php-bugs+get-217288@lists.php.net to get a copy of this message | ||
Edit report at https://bugs.php.net/bug.php?id=43770&edit=1
ID: 43770
Updated by: nikic@php.net
Reported by: maikelvm at hotmail dot com
Summary: docblock templates with getDocComment()
-Status: Open
+Status: Wont fix
Type: Feature/Change Request
Package: Reflection related
Operating System: *
PHP Version: *
Block user comment: N
Private report: N
New Comment:
Phpdoc templates are rarely used, not widely supported by tooling, and absent from contemporary
phpdoc specifications. Supporting this feature as described would require us to implement partial
phpdoc processing inside PHP core (while currently we just return the doc comment as given). With
that in mind, I think I can safely say that we will not support this.
Previous Comments:
------------------------------------------------------------------------
[2008-01-06 15:51:26] maikelvm at hotmail dot com
Description:
------------
Can the use of docBlock templates be included when the getDocComment() is called?
Reproduce code:
---------------
class SomeClass {
/**#@+
* @access public
*/
/**
* @return string
*/
public function someMethod() { return "" }
/**#@-*/
}
$o = new ReflectionMethod("SomeClass","someMethod");
echo $o->getDocComment();
Expected result:
----------------
/**
* Comments...
* @access public
* @return string
*/
Actual result:
--------------
/**
* Comments...
* @return string
*/
------------------------------------------------------------------------
--
Edit this bug report at https://bugs.php.net/bug.php?id=43770&edit=1