<?xml version="1.0"?>
<?xml-stylesheet
href="http://www.w3.org/2000/08/w3c-synd/style.css" type="text/css"
?>
<rdf:RDF xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#" xmlns="http://purl.org/rss/1.0/" xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:sy="http://purl.org/rss/1.0/modules/syndication/" xmlns:admin="http://webns.net/mvcb/" xmlns:content="http://purl.org/rss/1.0/modules/content/">
    <channel rdf:about="http://pear.php.net/bugs/search.php">
    <title>PEAR Bug Search Results</title>
    <link>http://pear.php.net/bugs/search.php?cmd=display&amp;package_name%5B0%5D=PHP_DocBlockGenerator</link>
    <description>Search Results</description>
    <dc:language>en-us</dc:language>
    <dc:creator>pear-webmaster@lists.php.net</dc:creator>
    <dc:publisher>pear-webmaster@lists.php.net</dc:publisher>
    <admin:generatorAgent rdf:resource="http://pear.php.net/bugs"/>
    <sy:updatePeriod>hourly</sy:updatePeriod>
    <sy:updateFrequency>1</sy:updateFrequency>
    <sy:updateBase>2000-01-01T12:00+00:00</sy:updateBase>
    <items>
     <rdf:Seq>
      <rdf:li rdf:resource="http://pear.php.net/bug/16193" />
      <rdf:li rdf:resource="http://pear.php.net/bug/16186" />
      <rdf:li rdf:resource="http://pear.php.net/bug/16184" />
      <rdf:li rdf:resource="http://pear.php.net/bug/16181" />
      <rdf:li rdf:resource="http://pear.php.net/bug/15490" />
      <rdf:li rdf:resource="http://pear.php.net/bug/14222" />
      <rdf:li rdf:resource="http://pear.php.net/bug/14162" />

     </rdf:Seq>
    </items>
  </channel>

  <image rdf:about="http://pear.php.net/gifs/pearsmall.gif">
    <title>PEAR Bugs</title>
    <url>http://pear.php.net/gifs/pearsmall.gif</url>
    <link>http://pear.php.net/bugs</link>
  </image>

    <item rdf:about="http://pear.php.net/bug/16193">
      <title>PHP_DocBlockGenerator: Bug 16193 [Assigned] Expected 1 space before variable type</title>
      <link>http://pear.php.net/bugs/16193</link>
      <content:encoded><![CDATA[<pre>PHP_DocBlockGenerator Bug
Reported by hm2k
2009-05-07T00:04:48+00:00
PHP: 5.2.9 OS:  Package Version: 1.1.1

Description:
------------
This is my line:

 * @param string $path

docblockgen turns that into:

 * @param  string $path

phpcs gives:

Expected 1 space before variable type</pre>]]></content:encoded>
      <description><![CDATA[<pre>PHP_DocBlockGenerator Bug
Reported by hm2k
2009-05-07T00:04:48+00:00
PHP: 5.2.9 OS:  Package Version: 1.1.1

Description:
------------
This is my line:

 * @param string $path

docblockgen turns that into:

 * @param  string $path

phpcs gives:

Expected 1 space before variable type</pre>]]></description>
      <dc:date>2009-05-23T18:07:38+00:00</dc:date>
      <dc:creator>hm2k &amp;#x61;&amp;#116; php &amp;#x64;&amp;#111;&amp;#x74; net</dc:creator>
      <dc:subject>PHP_DocBlockGenerator Bug</dc:subject>
    </item>
    <item rdf:about="http://pear.php.net/bug/16186">
      <title>PHP_DocBlockGenerator: Feature/Change Request 16186 [Open] Recursion</title>
      <link>http://pear.php.net/bugs/16186</link>
      <content:encoded><![CDATA[<pre>PHP_DocBlockGenerator Feature/Change Request
Reported by hm2k
2009-05-05T13:22:59+00:00
PHP: 5.2.9 OS:  Package Version: 1.1.1

Description:
------------
It would be handy if blockdocgen could do recursion like PHP_Beautifier can.

I'd find it very useful to issue a blockdocgen on an entire directory, and output it accordingly.

My suggestion would be to take a look how PHP_Beautifier does it, and borrow their method as it seems to work pretty well.</pre>]]></content:encoded>
      <description><![CDATA[<pre>PHP_DocBlockGenerator Feature/Change Request
Reported by hm2k
2009-05-05T13:22:59+00:00
PHP: 5.2.9 OS:  Package Version: 1.1.1

Description:
------------
It would be handy if blockdocgen could do recursion like PHP_Beautifier can.

I'd find it very useful to issue a blockdocgen on an entire directory, and output it accordingly.

My suggestion would be to take a look how PHP_Beautifier does it, and borrow their method as it seems to work pretty well.</pre>]]></description>
      <dc:date>2009-05-05T13:22:59+00:00</dc:date>
      <dc:creator>hm2k &amp;#x61;&amp;#116; php &amp;#x64;&amp;#111;&amp;#x74; net</dc:creator>
      <dc:subject>PHP_DocBlockGenerator Feature/Change Request</dc:subject>
    </item>
    <item rdf:about="http://pear.php.net/bug/16184">
      <title>PHP_DocBlockGenerator: Feature/Change Request 16184 [Open] Make use of PHP_Parser_DocblockParser</title>
      <link>http://pear.php.net/bugs/16184</link>
      <content:encoded><![CDATA[<pre>PHP_DocBlockGenerator Feature/Change Request
Reported by hm2k
2009-05-05T12:55:41+00:00
PHP: 5.2.9 OS:  Package Version: 

Description:
------------
If this package made use of PHP_Parser_DocblockParser, it could streamline development of both packages.

It would benefit both packages.</pre>]]></content:encoded>
      <description><![CDATA[<pre>PHP_DocBlockGenerator Feature/Change Request
Reported by hm2k
2009-05-05T12:55:41+00:00
PHP: 5.2.9 OS:  Package Version: 

Description:
------------
If this package made use of PHP_Parser_DocblockParser, it could streamline development of both packages.

It would benefit both packages.</pre>]]></description>
      <dc:date>2009-05-05T12:55:41+00:00</dc:date>
      <dc:creator>hm2k &amp;#x61;&amp;#116; php &amp;#x64;&amp;#111;&amp;#x74; net</dc:creator>
      <dc:subject>PHP_DocBlockGenerator Feature/Change Request</dc:subject>
    </item>
    <item rdf:about="http://pear.php.net/bug/16181">
      <title>PHP_DocBlockGenerator: Bug 16181 [Open] Ordering issues</title>
      <link>http://pear.php.net/bugs/16181</link>
      <content:encoded><![CDATA[<pre>PHP_DocBlockGenerator Bug
Reported by hm2k
2009-05-05T12:31:07+00:00
PHP: 5.2.9 OS:  Package Version: 1.1.1

Description:
------------
After running docblockgen, even though it sorts out the spacing, it doesn't fix the ordering outlined by PHP_CodeSniffer.

eg:

The @license tag is in the wrong order; the tag follows @copyright (if used) or @author

The @copyright tag is in the wrong order; the tag follows @author

The @link tag is in the wrong order; the tag follows @version

...</pre>]]></content:encoded>
      <description><![CDATA[<pre>PHP_DocBlockGenerator Bug
Reported by hm2k
2009-05-05T12:31:07+00:00
PHP: 5.2.9 OS:  Package Version: 1.1.1

Description:
------------
After running docblockgen, even though it sorts out the spacing, it doesn't fix the ordering outlined by PHP_CodeSniffer.

eg:

The @license tag is in the wrong order; the tag follows @copyright (if used) or @author

The @copyright tag is in the wrong order; the tag follows @author

The @link tag is in the wrong order; the tag follows @version

...</pre>]]></description>
      <dc:date>2009-05-05T12:31:07+00:00</dc:date>
      <dc:creator>hm2k &amp;#x61;&amp;#116; php &amp;#x64;&amp;#111;&amp;#x74; net</dc:creator>
      <dc:subject>PHP_DocBlockGenerator Bug</dc:subject>
    </item>
    <item rdf:about="http://pear.php.net/bug/15490">
      <title>PHP_DocBlockGenerator: Feature/Change Request 15490 [Open] Messages from PHP_CompatInfo</title>
      <link>http://pear.php.net/bugs/15490</link>
      <content:encoded><![CDATA[<pre>PHP_DocBlockGenerator Feature/Change Request
Reported by hshimooka
2009-01-03T07:26:37+00:00
PHP: 5.2.8 OS: CentOS 5.2 Package Version: 1.1.1

Description:
------------
I use PHP_DocBlockGenerator-1.1.1 with PHP_CompatInfo-1.8.1 .

I ran docblockgen, then displayed messages like 'print_r'. I read source codes both of PHP_DocBlockGenerator and PHP_CompatInfo, and found that the constructor of PHP_CompatInfo added PHP_CompatInfo_Renderer_Array to its listener by default.

If you can, toggle thats messages with some option, or not display it.
In the latter case, I think ok to pass 'null' string to the constructor of PHP_CompatInfo in  PHP_DocBlockGenerator_Tokens's constructor .

-=-=-=-=-

$ diff /usr/local/lib/php5/pear/PHP/DocBlockGenerator/Tokens.php.org /usr/local/lib/php5/pear/PHP/DocBlockGenerator/Tokens.php
150c150
&lt;         $this-&gt;info = new PHP_CompatInfo();
---
&gt;         $this-&gt;info = new PHP_CompatInfo(&quot;null&quot;);
$ 


Test script:
---------------
$ docblockgen /path/to/sample.php /path/to/commented.php


Expected result:
----------------
$ docblockgen /path/to/sample.php /path/to/commented.php
$ 

Actual result:
--------------
$ docblockgen /path/to/sample.php /path/to/commented.php
array (
  'ignored_files' =&gt;
  array (
  ),
  'ignored_functions' =&gt;
  array (
  ),
  'ignored_extensions' =&gt;
  array (
  ),
  'ignored_constants' =&gt;
  array (
  ),
  'max_version' =&gt; '',
  'version' =&gt; '5.0.0',
  'extensions' =&gt;
  array (
  ),
  'constants' =&gt;
  array (
    0 =&gt; 'PHP_EOL',
  ),
  'tokens' =&gt;
  array (
    0 =&gt; 'public',
  ),
  'cond_code' =&gt;
  array (
    0 =&gt; 0,
  ),
)$</pre>]]></content:encoded>
      <description><![CDATA[<pre>PHP_DocBlockGenerator Feature/Change Request
Reported by hshimooka
2009-01-03T07:26:37+00:00
PHP: 5.2.8 OS: CentOS 5.2 Package Version: 1.1.1

Description:
------------
I use PHP_DocBlockGenerator-1.1.1 with PHP_CompatInfo-1.8.1 .

I ran docblockgen, then displayed messages like 'print_r'. I read source codes both of PHP_DocBlockGenerator and PHP_CompatInfo, and found that the constructor of PHP_CompatInfo added PHP_CompatInfo_Renderer_Array to its listener by default.

If you can, toggle thats messages with some option, or not display it.
In the latter case, I think ok to pass 'null' string to the constructor of PHP_CompatInfo in  PHP_DocBlockGenerator_Tokens's constructor .

-=-=-=-=-

$ diff /usr/local/lib/php5/pear/PHP/DocBlockGenerator/Tokens.php.org /usr/local/lib/php5/pear/PHP/DocBlockGenerator/Tokens.php
150c150
&lt;         $this-&gt;info = new PHP_CompatInfo();
---
&gt;         $this-&gt;info = new PHP_CompatInfo(&quot;null&quot;);
$ 


Test script:
---------------
$ docblockgen /path/to/sample.php /path/to/commented.php


Expected result:
----------------
$ docblockgen /path/to/sample.php /path/to/commented.php
$ 

Actual result:
--------------
$ docblockgen /path/to/sample.php /path/to/commented.php
array (
  'ignored_files' =&gt;
  array (
  ),
  'ignored_functions' =&gt;
  array (
  ),
  'ignored_extensions' =&gt;
  array (
  ),
  'ignored_constants' =&gt;
  array (
  ),
  'max_version' =&gt; '',
  'version' =&gt; '5.0.0',
  'extensions' =&gt;
  array (
  ),
  'constants' =&gt;
  array (
    0 =&gt; 'PHP_EOL',
  ),
  'tokens' =&gt;
  array (
    0 =&gt; 'public',
  ),
  'cond_code' =&gt;
  array (
    0 =&gt; 0,
  ),
)$</pre>]]></description>
      <dc:date>2009-01-03T07:26:37+00:00</dc:date>
      <dc:creator>shimooka &amp;#x61;&amp;#116; doyouphp &amp;#x64;&amp;#111;&amp;#x74; jp</dc:creator>
      <dc:subject>PHP_DocBlockGenerator Feature/Change Request</dc:subject>
    </item>
    <item rdf:about="http://pear.php.net/bug/14222">
      <title>PHP_DocBlockGenerator: Bug 14222 [Open] Undefined index / offset problem in Type.php</title>
      <link>http://pear.php.net/bugs/14222</link>
      <content:encoded><![CDATA[<pre>PHP_DocBlockGenerator Bug
Reported by unomi
2008-06-24T05:38:37+00:00
PHP: 5.2.6 OS: CentOS 4.6 Final Package Version: 1.1.1

Description:
------------
When running docblockgen on one of our files, it suddenly prompted (via Xdebug), that an index is undefined. It all happens in the guessReturn function, where $var['value'] sometimes is not defined, so a Undefined index: 'value' occurs.

Another one is in the function isAVar where the $id gets incremented during the if-statements. But if all the statements fail, the 'else' false back at the end has to deal with an $id that has been incremented. But then a Undefined offset: 1 occurs.

Expected result:
----------------
Sorry, I can't provide you with an example, but the description should be explainatory. The only thing I can give you that type 319 (T_ENDWHILE) of the tokens didn't had a 'value' index.

Actual result:
--------------
Sorry, I can't provide an actual result either. The functions mentioned are flawed and should be fixed. That's all that I can say. An extra check on the 'value' index should be sufficient and in the function isAVar there should be a default current value for $tokens[$id]. After that the $id gets incremented, but the 'else' fallback statement depends on what was current before the if statements. Like:

$cur = $tokens[$id];

if (++$id stuff etc.) {
elseif (++$id stuff etc.) {
elseif (++$id stuff etc.) {
else {
$var = $cur;
}</pre>]]></content:encoded>
      <description><![CDATA[<pre>PHP_DocBlockGenerator Bug
Reported by unomi
2008-06-24T05:38:37+00:00
PHP: 5.2.6 OS: CentOS 4.6 Final Package Version: 1.1.1

Description:
------------
When running docblockgen on one of our files, it suddenly prompted (via Xdebug), that an index is undefined. It all happens in the guessReturn function, where $var['value'] sometimes is not defined, so a Undefined index: 'value' occurs.

Another one is in the function isAVar where the $id gets incremented during the if-statements. But if all the statements fail, the 'else' false back at the end has to deal with an $id that has been incremented. But then a Undefined offset: 1 occurs.

Expected result:
----------------
Sorry, I can't provide you with an example, but the description should be explainatory. The only thing I can give you that type 319 (T_ENDWHILE) of the tokens didn't had a 'value' index.

Actual result:
--------------
Sorry, I can't provide an actual result either. The functions mentioned are flawed and should be fixed. That's all that I can say. An extra check on the 'value' index should be sufficient and in the function isAVar there should be a default current value for $tokens[$id]. After that the $id gets incremented, but the 'else' fallback statement depends on what was current before the if statements. Like:

$cur = $tokens[$id];

if (++$id stuff etc.) {
elseif (++$id stuff etc.) {
elseif (++$id stuff etc.) {
else {
$var = $cur;
}</pre>]]></description>
      <dc:date>2008-06-24T05:38:37+00:00</dc:date>
      <dc:creator>aschwin &amp;#x61;&amp;#116; hotelspecials &amp;#x64;&amp;#111;&amp;#x74; nl</dc:creator>
      <dc:subject>PHP_DocBlockGenerator Bug</dc:subject>
    </item>
    <item rdf:about="http://pear.php.net/bug/14162">
      <title>PHP_DocBlockGenerator: Feature/Change Request 14162 [Open] want to use other licenses</title>
      <link>http://pear.php.net/bugs/14162</link>
      <content:encoded><![CDATA[<pre>PHP_DocBlockGenerator Feature/Change Request
Reported by hshimooka
2008-06-17T04:26:43+00:00
PHP: 5.2.6 OS:  Package Version: 1.1.1

Description:
------------
If I want to use 'MY' license, perhaps I must not use '--license' option and write that licese per script file. 

So I made a patch against License.php:
http://coderepos.org/share/browser/lang/php/PHP_DocBlockGenerator/PHP/DocBlockGenerator/License.php.patch?rev=14166&amp;format=raw

and modified License.php is:
http://coderepos.org/share/browser/lang/php/PHP_DocBlockGenerator/PHP/DocBlockGenerator/License.php?rev=14166


The license files will be located in PEAR_INSTALL_DIR/data/PHP_DocBlockGenerator/:
http://coderepos.org/share/browser/lang/php/PHP_DocBlockGenerator/data/PHP_DocBlockGenerator?rev=14166

In a license file, the 1st line is 'full_name', the 2nd is 'url' and 'text' is follwing.</pre>]]></content:encoded>
      <description><![CDATA[<pre>PHP_DocBlockGenerator Feature/Change Request
Reported by hshimooka
2008-06-17T04:26:43+00:00
PHP: 5.2.6 OS:  Package Version: 1.1.1

Description:
------------
If I want to use 'MY' license, perhaps I must not use '--license' option and write that licese per script file. 

So I made a patch against License.php:
http://coderepos.org/share/browser/lang/php/PHP_DocBlockGenerator/PHP/DocBlockGenerator/License.php.patch?rev=14166&amp;format=raw

and modified License.php is:
http://coderepos.org/share/browser/lang/php/PHP_DocBlockGenerator/PHP/DocBlockGenerator/License.php?rev=14166


The license files will be located in PEAR_INSTALL_DIR/data/PHP_DocBlockGenerator/:
http://coderepos.org/share/browser/lang/php/PHP_DocBlockGenerator/data/PHP_DocBlockGenerator?rev=14166

In a license file, the 1st line is 'full_name', the 2nd is 'url' and 'text' is follwing.</pre>]]></description>
      <dc:date>2008-06-17T04:26:43+00:00</dc:date>
      <dc:creator>shimooka &amp;#x61;&amp;#116; doyouphp &amp;#x64;&amp;#111;&amp;#x74; jp</dc:creator>
      <dc:subject>PHP_DocBlockGenerator Feature/Change Request</dc:subject>
    </item>
</rdf:RDF>
