Description: ------------ While trying to generate XML DocBook pages for PEAR_Info, I've noticed that @static tag is not well renders. Using phpdoc command line on a Windows XP dosbox See file content: language-snippets.ent http://cvs.php.net/viewvc.cgi/peardoc/en/language-snippets.ent?revision=1.15&view=markup ---------------- <!ENTITY note.shouldstatic '<simpara>This function should be called statically.</simpara>'> <!ENTITY note.notstatic '<simpara>This function can not be called statically.</simpara>'> ---------------- Test script: --------------- phpdoc -c pear_info.ini With C:\wamp\php\PEAR\data\PhpDocumentor\user\pear_info.ini content (comment stripped tags) [Parse Data] title = PEAR_Info Manual hidden = false parseprivate = off javadocdesc = off defaultcategoryname = PEAR defaultpackagename = PEAR_Info target = C:\php5\phpdoc\PEAR_Info readmeinstallchangelog = README, INSTALL, FAQ, LICENSE directory = c:/php/pear/PEAR_Info ignore = CVS/* output=XML:DocBook/peardoc2:default sourcecode = on Expected result: ---------------- <refsect1 id="package.pear.pear-info.pear-info.setproxy.note"> &title.note; &note.shouldstatic; </refsect1> Actual result: -------------- <refsect1 id="package.pear.pear-info.pear-info.setproxy.note"> &title.note; &note.notstatic; </refsect1>

I find no reference to "shouldstatic" anywhere in the XML converter codebase. I do however see "canstatic" along with "notstatic". Is it possible that "canstatic" is what you want rather than "shouldstatic"? /me is mostly clueless about DocBook :(

Or, do all _three_ of these terms exist in the DocBook spec? If both "shouldstatic" and "canstatic" are both valid DocBook tags, then perhaps I just need to add a "shouldstatic" handler to the PhpDoc converter.

Hmmm... from actually looking at that CVS link you provided, I see entries for all three static keywords (canstatic, shouldstatic, notstatic). So, I think that alone does tell me that all three should be handled by the peardoc2 converter. Now to figure out how to add "shouldstatic" to the mix...

No more feature work on phpDocumentor 1.x. Check out the new phpDocumentor 2.x (http://www.phpdoc.org/).