[PEAR-BUG] Bug #11540 [Ver]: inline @static tag renders wrong result with XML:DocBook/peardoc2:default

Edit report at https://pear.php.net/bugs/bug.php?id=11540&edit=1

ID: 11540
Updated by: demon.gene@gmail.com
Reported By: pear at laurent-laville dot org
Summary: inline @static tag renders wrong result with
XML:DocBook/peardoc2:default
Status: Verified
Type: Bug
Package: PhpDocumentor
Operating System: Windows XP
Package Version: 1.4.0RC1
PHP Version: 5.2.3
-Roadmap Versions: 1.4.4
+Roadmap Versions: 1.4.5
New Comment:

-Roadmap Versions: 1.4.4
+Roadmap Versions: 1.4.5



Previous Comments:
------------------------------------------------------------------------

[2007-12-18 22:48:04] ashnazg

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...

------------------------------------------------------------------------

[2007-12-18 10:39:58] ashnazg

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.

------------------------------------------------------------------------

[2007-12-08 21:00:13] ashnazg

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

------------------------------------------------------------------------

[2007-07-06 03:52:15] farell

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>

------------------------------------------------------------------------