Req #43770 [Opn->Wfx]: docblock templates with getDocComment()

From: 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

« previous php.bugs (#217288) next »