FAQ
Edit report at http://pear.php.net/bugs/bug.php?id=16178&edit=1

ID: 16178
Updated by: hm2k@php.net
Reported By: hm2k at php dot net
-Summary: Header Comment Blocks aren't fixed or made pretty
+Summary: Header Comment Blocks (Docblocks) aren't fixed or
made pretty
Status: Open
Type: Bug
Package: PHP_Beautifier
Package Version: 0.1.14
PHP Version: 5.2.9
Roadmap Versions:
New Comment:

-Summary: Header Comment Blocks aren't fixed or made pretty
+Summary: Header Comment Blocks (Docblocks) aren't fixed or
made pretty

This exact issue is mentioned in an article entitled: Proposal for
"Amendment of Docblock Comment Standards":

http://pear.php.net/pepr/pepr-proposal-show.php?id=580

Perhaps it can utilise the following packages:
http://pear.php.net/package/PHP_DocBlockGenerator/
http://pear.php.net/package/PHP_Parser_DocblockParser/

I will direct my attention to these until somebody gets back to me
here.


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

[2009-05-04 15:14:59] hm2k

Description:
------------
Regarding bug #15139 (https://pear.php.net/bugs/bug.php?id=15139)

Using PHP_CodeSniffer I generated a report, then passed the files
through PHP_Beautifier, and created another report.

I found that PHP_Beautifier didn't prettify the "Header Comment Blocks"
as per this proposal:

http://pear.php.net/pepr/pepr-proposal-show.php?id=128

Many of the issues raised by PHP_CodeSniffer are simply spacing
issues.

Are the "Header Comment Blocks" going something that is covered by
PHP_Beautifier?

Thanks.

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

Search Discussions

  • Cweiske at May 5, 2009 at 11:33 am
    Edit report at http://pear.php.net/bugs/bug.php?id=16178&edit=1

    ID: 16178
    Updated by: cweiske@php.net
    Reported By: hm2k at php dot net
    Summary: Header Comment Blocks (Docblocks) aren't fixed or
    made pretty
    Status: Open
    Type: Bug
    Package: PHP_Beautifier
    Package Version: 0.1.14
    PHP Version: 5.2.9
    Roadmap Versions:
    New Comment:

    I never used PHP_Beautifier for real code, I doubt that it will do
    everything.


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

    [2009-05-05 13:23:31] hm2k

    -Summary: Header Comment Blocks aren't fixed or made pretty
    +Summary: Header Comment Blocks (Docblocks) aren't fixed or
    made pretty

    This exact issue is mentioned in an article entitled: Proposal for
    "Amendment of Docblock Comment Standards":

    http://pear.php.net/pepr/pepr-proposal-show.php?id=580

    Perhaps it can utilise the following packages:
    http://pear.php.net/package/PHP_DocBlockGenerator/
    http://pear.php.net/package/PHP_Parser_DocblockParser/

    I will direct my attention to these until somebody gets back to me
    here.

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

    [2009-05-04 15:14:59] hm2k

    Description:
    ------------
    Regarding bug #15139 (https://pear.php.net/bugs/bug.php?id=15139)

    Using PHP_CodeSniffer I generated a report, then passed the files
    through PHP_Beautifier, and created another report.

    I found that PHP_Beautifier didn't prettify the "Header Comment Blocks"
    as per this proposal:

    http://pear.php.net/pepr/pepr-proposal-show.php?id=128

    Many of the issues raised by PHP_CodeSniffer are simply spacing
    issues.

    Are the "Header Comment Blocks" going something that is covered by
    PHP_Beautifier?

    Thanks.

    ------------------------------------------------------------------------
  • Cweiske at May 5, 2009 at 11:34 am
    Edit report at http://pear.php.net/bugs/bug.php?id=16178&edit=1

    ID: 16178
    Updated by: cweiske@php.net
    Reported By: hm2k at php dot net
    Summary: Header Comment Blocks (Docblocks) aren't fixed or
    made pretty
    Status: Open
    Type: Bug
    Package: PHP_Beautifier
    Package Version: 0.1.14
    PHP Version: 5.2.9
    Roadmap Versions:
    New Comment:

    The proposal has not finished yet.


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

    [2009-05-05 13:33:27] cweiske

    I never used PHP_Beautifier for real code, I doubt that it will do
    everything.

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

    [2009-05-05 13:23:31] hm2k

    -Summary: Header Comment Blocks aren't fixed or made pretty
    +Summary: Header Comment Blocks (Docblocks) aren't fixed or
    made pretty

    This exact issue is mentioned in an article entitled: Proposal for
    "Amendment of Docblock Comment Standards":

    http://pear.php.net/pepr/pepr-proposal-show.php?id=580

    Perhaps it can utilise the following packages:
    http://pear.php.net/package/PHP_DocBlockGenerator/
    http://pear.php.net/package/PHP_Parser_DocblockParser/

    I will direct my attention to these until somebody gets back to me
    here.

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

    [2009-05-04 15:14:59] hm2k

    Description:
    ------------
    Regarding bug #15139 (https://pear.php.net/bugs/bug.php?id=15139)

    Using PHP_CodeSniffer I generated a report, then passed the files
    through PHP_Beautifier, and created another report.

    I found that PHP_Beautifier didn't prettify the "Header Comment Blocks"
    as per this proposal:

    http://pear.php.net/pepr/pepr-proposal-show.php?id=128

    Many of the issues raised by PHP_CodeSniffer are simply spacing
    issues.

    Are the "Header Comment Blocks" going something that is covered by
    PHP_Beautifier?

    Thanks.

    ------------------------------------------------------------------------
  • Hm2k at May 5, 2009 at 12:17 pm
    Edit report at http://pear.php.net/bugs/bug.php?id=16178&edit=1

    ID: 16178
    Updated by: hm2k@php.net
    Reported By: hm2k at php dot net
    Summary: Header Comment Blocks (Docblocks) aren't fixed or
    made pretty
    Status: Open
    Type: Bug
    Package: PHP_Beautifier
    Package Version: 0.1.14
    PHP Version: 5.2.9
    Roadmap Versions:
    New Comment:

    What is the point of PHP_Beautifier if not for real code?

    Ah, I was under the impression that the "Proposed" status, meant that
    the proposal was final. I now realise the error of my ways!

    It should read "Finished" once voting has finished. My mistake.

    Having said this, it's a proposal worth taking note of.

    However, I noticed that voting has not started yet either, who has the
    permissions to start the voting?


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

    [2009-05-05 13:34:05] cweiske

    The proposal has not finished yet.

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

    [2009-05-05 13:33:27] cweiske

    I never used PHP_Beautifier for real code, I doubt that it will do
    everything.

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

    [2009-05-05 13:23:31] hm2k

    -Summary: Header Comment Blocks aren't fixed or made pretty
    +Summary: Header Comment Blocks (Docblocks) aren't fixed or
    made pretty

    This exact issue is mentioned in an article entitled: Proposal for
    "Amendment of Docblock Comment Standards":

    http://pear.php.net/pepr/pepr-proposal-show.php?id=580

    Perhaps it can utilise the following packages:
    http://pear.php.net/package/PHP_DocBlockGenerator/
    http://pear.php.net/package/PHP_Parser_DocblockParser/

    I will direct my attention to these until somebody gets back to me
    here.

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

    [2009-05-04 15:14:59] hm2k

    Description:
    ------------
    Regarding bug #15139 (https://pear.php.net/bugs/bug.php?id=15139)

    Using PHP_CodeSniffer I generated a report, then passed the files
    through PHP_Beautifier, and created another report.

    I found that PHP_Beautifier didn't prettify the "Header Comment Blocks"
    as per this proposal:

    http://pear.php.net/pepr/pepr-proposal-show.php?id=128

    Many of the issues raised by PHP_CodeSniffer are simply spacing
    issues.

    Are the "Header Comment Blocks" going something that is covered by
    PHP_Beautifier?

    Thanks.

    ------------------------------------------------------------------------
  • Cweiske at May 5, 2009 at 12:20 pm
    Edit report at http://pear.php.net/bugs/bug.php?id=16178&edit=1

    ID: 16178
    Updated by: cweiske@php.net
    Reported By: hm2k at php dot net
    Summary: Header Comment Blocks (Docblocks) aren't fixed or
    made pretty
    Status: Open
    Type: Bug
    Package: PHP_Beautifier
    Package Version: 0.1.14
    PHP Version: 5.2.9
    Roadmap Versions:
    New Comment:

    a bug tracker is no discussion forum. please mail to
    pear-dev@lists.php.net


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

    [2009-05-05 14:17:18] hm2k

    What is the point of PHP_Beautifier if not for real code?

    Ah, I was under the impression that the "Proposed" status, meant that
    the proposal was final. I now realise the error of my ways!

    It should read "Finished" once voting has finished. My mistake.

    Having said this, it's a proposal worth taking note of.

    However, I noticed that voting has not started yet either, who has the
    permissions to start the voting?

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

    [2009-05-05 13:34:05] cweiske

    The proposal has not finished yet.

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

    [2009-05-05 13:33:27] cweiske

    I never used PHP_Beautifier for real code, I doubt that it will do
    everything.

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

    [2009-05-05 13:23:31] hm2k

    -Summary: Header Comment Blocks aren't fixed or made pretty
    +Summary: Header Comment Blocks (Docblocks) aren't fixed or
    made pretty

    This exact issue is mentioned in an article entitled: Proposal for
    "Amendment of Docblock Comment Standards":

    http://pear.php.net/pepr/pepr-proposal-show.php?id=580

    Perhaps it can utilise the following packages:
    http://pear.php.net/package/PHP_DocBlockGenerator/
    http://pear.php.net/package/PHP_Parser_DocblockParser/

    I will direct my attention to these until somebody gets back to me
    here.

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

    [2009-05-04 15:14:59] hm2k

    Description:
    ------------
    Regarding bug #15139 (https://pear.php.net/bugs/bug.php?id=15139)

    Using PHP_CodeSniffer I generated a report, then passed the files
    through PHP_Beautifier, and created another report.

    I found that PHP_Beautifier didn't prettify the "Header Comment Blocks"
    as per this proposal:

    http://pear.php.net/pepr/pepr-proposal-show.php?id=128

    Many of the issues raised by PHP_CodeSniffer are simply spacing
    issues.

    Are the "Header Comment Blocks" going something that is covered by
    PHP_Beautifier?

    Thanks.

    ------------------------------------------------------------------------
  • Cweiske at May 5, 2009 at 12:21 pm
    Edit report at http://pear.php.net/bugs/bug.php?id=16178&edit=1

    ID: 16178
    Updated by: cweiske@php.net
    Reported By: hm2k at php dot net
    Summary: Header Comment Blocks (Docblocks) aren't fixed or
    made pretty
    -Status: Open
    +Status: Bogus
    Type: Bug
    Package: PHP_Beautifier
    Package Version: 0.1.14
    PHP Version: 5.2.9
    Roadmap Versions:
    New Comment:

    -Status: Open
    +Status: Bogus

    bogusing.


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

    [2009-05-05 14:20:17] cweiske

    a bug tracker is no discussion forum. please mail to
    pear-dev@lists.php.net

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

    [2009-05-05 14:17:18] hm2k

    What is the point of PHP_Beautifier if not for real code?

    Ah, I was under the impression that the "Proposed" status, meant that
    the proposal was final. I now realise the error of my ways!

    It should read "Finished" once voting has finished. My mistake.

    Having said this, it's a proposal worth taking note of.

    However, I noticed that voting has not started yet either, who has the
    permissions to start the voting?

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

    [2009-05-05 13:34:05] cweiske

    The proposal has not finished yet.

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

    [2009-05-05 13:33:27] cweiske

    I never used PHP_Beautifier for real code, I doubt that it will do
    everything.

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

    [2009-05-05 13:23:31] hm2k

    -Summary: Header Comment Blocks aren't fixed or made pretty
    +Summary: Header Comment Blocks (Docblocks) aren't fixed or
    made pretty

    This exact issue is mentioned in an article entitled: Proposal for
    "Amendment of Docblock Comment Standards":

    http://pear.php.net/pepr/pepr-proposal-show.php?id=580

    Perhaps it can utilise the following packages:
    http://pear.php.net/package/PHP_DocBlockGenerator/
    http://pear.php.net/package/PHP_Parser_DocblockParser/

    I will direct my attention to these until somebody gets back to me
    here.

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

    The remainder of the comments for this report are too long. To view
    the rest of the comments, please view the bug report online at
    http://pear.php.net/bugs/bug.php?id=16178
  • Hm2k at May 5, 2009 at 12:27 pm
    Edit report at http://pear.php.net/bugs/bug.php?id=16178&edit=1

    ID: 16178
    Updated by: hm2k@php.net
    Reported By: hm2k at php dot net
    Summary: Header Comment Blocks (Docblocks) aren't fixed or
    made pretty
    -Status: Bogus
    +Status: Open
    Type: Bug
    Package: PHP_Beautifier
    Package Version: 0.1.14
    PHP Version: 5.2.9
    Roadmap Versions:
    New Comment:

    -Status: Bogus
    +Status: Open

    I suspect you are right though Christian, I'm not sure this is covered
    by PHP_Beautifier.

    However PHP_Beautifier COULD easily impliment PHP_DocBlockGenerator to
    do the leg work to get the desired results.


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

    [2009-05-05 14:20:34] cweiske

    -Status: Open
    +Status: Bogus

    bogusing.

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

    [2009-05-05 14:20:17] cweiske

    a bug tracker is no discussion forum. please mail to
    pear-dev@lists.php.net

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

    [2009-05-05 14:17:18] hm2k

    What is the point of PHP_Beautifier if not for real code?

    Ah, I was under the impression that the "Proposed" status, meant that
    the proposal was final. I now realise the error of my ways!

    It should read "Finished" once voting has finished. My mistake.

    Having said this, it's a proposal worth taking note of.

    However, I noticed that voting has not started yet either, who has the
    permissions to start the voting?

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

    [2009-05-05 13:34:05] cweiske

    The proposal has not finished yet.

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

    [2009-05-05 13:33:27] cweiske

    I never used PHP_Beautifier for real code, I doubt that it will do
    everything.

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

    The remainder of the comments for this report are too long. To view
    the rest of the comments, please view the bug report online at
    http://pear.php.net/bugs/bug.php?id=16178

Related Discussions

Discussion Navigation
viewthread | post
Discussion Overview
grouppear-bugs @
categoriesphp
postedMay 5, '09 at 11:24a
activeMay 5, '09 at 12:27p
posts7
users2
websitepear.php.net

2 users in discussion

Cweiske: 4 posts Hm2k: 3 posts

People

Translate

site design / logo © 2022 Grokbase