DocBlox

PHP 5.3 compatible API Documentation generator aimed at projects of all sizes and Continuous Integration

Release of v0.12.0

Posted on | July 17, 2011 | 2 Comments

As announced last month is release 0.12.0 of DocBlox here. I had intended to finish restructuring the application and then implement the Plugin architecture but this is taking more effort then I could manage in one month of work combined with working on existing feature requests. Despite this, DocBlox has an great set of new features and changes!

So. What got in this month? Let’s show some highlights:

  • DocBlox can document the contents of a phar package without the need of unpacking its contents first.
  • Support for the behaviour of new tags was added: @ignore and @internal. @link was improved to also link internally.
  • The @return tag now understands ‘self’ and ‘$this’; it will create a link to the current class and add a tag @fluent to indicate that this method provides a fluent interface.
  • The inheritance diagram has been improved three-fold:
    • Classes are now grouped by namespace, making it easier to see which class is represented and to see what belongs together
    • ‘Implements’ relations between classes (or interfaces) and interfaces are now shown
    • Image_Graphviz has been dropped and replaced by a custom Graphviz Library; thus dropping the requirement of having PEAR installed
  • PHP internal classes now have links to the PHP Manual pages.
For a complete list of changes you can view the CHANGELOG in the docs folder.
Upcoming month will be quite interesting; aside from wanting to finish the restructuring of DocBlox and implementing aforementioned plugin architecture have I asked users and contributors what their top 3 of requested features is and put those on the roadmap for version 0.13.0; which is planned for release in the weekend of 6/7 August. The goal is ambitious but if met should result in a very nice advance towards version 1.0.
Should you have your own top 3 of requests or have found a bug; do not hesitate and let me know! I am always fond of feedback and intend to fix any bugs found as fast as possible.
See you soon!
Fork me on GitHub

Comments

2 Responses to “Release of v0.12.0”

  1. Lars Johansson
    August 4th, 2011 @ 2:58 pm

    Hey, thanks for a very promising product. I’m not a fan of OO programming so I’m more interested of support for functions, programs, namespaces, packages etc. Also docBook support a la PHPDocumentor would be great.

  2. mvriel
    August 5th, 2011 @ 7:42 am

    Hey Lars, thanks for the compliment!
    You refer to not being much of an OO man but prefer procedural programming; do you miss anything that helps you gain understanding of the code, documentation-wise?

Leave a Reply





  • Time to release 0.17

    Loading...
  • About DocBlox

    DocBlox is a Documentation Generation Application (DGA) for use with PHP applications.

    It is capable of transforming the comments in your source code into a full API reference document.

    DocBlox is build to be PHP 5.3 compatible, fast, having a low memory consumption and easily integratable into Continuous Integration.


  • Admin