Re: [PEPr] +1 for Text::Text_Highlighter
| From: | Andrey Demenev | Date: | Tue, 25 May 2004 16:26:31 +0000 |
| Subject: | Re: [PEPr] +1 for Text::Text_Highlighter | ||
| References: | 1 2 3 | Groups: | php.pear.dev |
| Request: | Send a blank email to pear-dev+get-29656@lists.php.net to get a copy of this message | ||
Greg Beaver wrote:
Hello from beautiful Rome, Your plugin description is fine, but unless your parser also provides context information, it will be completely useless to phpDocumentor. For instance: token T_STRING is passed in. Is it a constant? Is it a class member? ($this->member, or even $this->member->submember)? Is it a function/class declaration? (function functionname) The highlighting parser *must* have this information available, or there is no way to do cross-referencing (linking from the token to documentation, or to its declaration in the source).IMO, parser itself does not have to know anything about context - it is the job of syntax analyzer, and this functionality could be implemented within the plugin. Like, after recieving T_VARIABLE $this, it expects next T_STRING to be either a method name or a member name (some tricks may be neeeded here, as it is possible to have a method and a member with same name)
Greg-- Andrey Demenev aka Blindman demenev@on-line.jar.ru