Re: Re: PHPDocumentor 1.4.2 and XML DocBook renderer

From: Date: Tue, 08 Jul 2008 20:44:04 +0000
Subject: Re: Re: PHPDocumentor 1.4.2 and XML DocBook renderer
References: 1 2 3  Groups: php.pear.dev 
Request: Send a blank email to pear-dev+get-50367@lists.php.net to get a copy of this message
Helgi Þormar Þorbjörnsson a écrit :
On Mon, Jul 7, 2008 at 8:39 PM, Laurent Laville <pear@laurent-laville.org> wrote:
Probably a bug, because I found another strange case : <refsect1 id="package.php.php-compatinfo.php-compatinfo-parser.getignoredfiles.returns"> &title.returns; <para> <emphasis>returns</emphasis> or false on error </para> </refsect1> Was produced with this source code :
    * @return array or false on error
Did you noticed that "array" term is missing in xml docbook output
    
I no wizard on this matter but have you tried @return array|false or even @return array|boolean this could solve the issue partially - tho it is weird it cuts of the array part if a sentence follows it. Regards Helgi Yes, of course Helgi, but ... it will not solve the problem of @return not generated when we have
    * @return void
This is why I've opened a bug report: just to keep in mind this strange behavior. BTW I'll continue to copy/paste a XML docbook / return bloc as I've already done since some days ! Regards Laurent

« previous php.pear.dev (#50367) next »