Re: PHPDocumentor 1.4.2 and XML DocBook renderer

From: Date: Mon, 07 Jul 2008 20:39:19 +0000
Subject: Re: PHPDocumentor 1.4.2 and XML DocBook renderer
References: 1  Groups: php.pear.dev 
Request: Send a blank email to pear-dev+get-50356@lists.php.net to get a copy of this message
Laurent Laville a écrit :
Hi all, For all of PHPDoc users who have already used the XML:DocBook/peardoc2:default renderer. Did you noticed that all functions that have only a @return with type and no comment, does not exist in xml result ? Example :
     * @param array $options An array of parser options.
     *
     * @access public
     * @return array
     * @since  version 1.8.0b2 (2008-06-03)
And I'm expected to find a <refsect1 id="package.php.php-compatinfo.php-compatinfo-parser.getdirlist.returns"> &title.returns; <para> <emphasis>returns</emphasis> void </para> </refsect1> But none ! When there is a content after type, for example :
     * @return array    An array of php function/constant names history
The Returns group is here . <refsect1 id="package.php.php-compatinfo.php-compatinfo-parser.loadversion.returns"> &title.returns; <para> <emphasis>returns</emphasis> An array of php function/constant names history </para> </refsect1> Chuck is it a normal behavior or just a bug ? Am I only to noticed it ? Laurent
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

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