Release of v0.11.0

Posted on | June 12, 2011 | 4 Comments

A lot has happened in the past month, not all of which in the code.

Unfortunately we also had to postpone this release with one week as a critical bug arose which affected any file which was larger than 50.000 lines of code (also known as 50 KLOC). Please don’t get me wrong: if you have such a file, you should sincerely consider refactoring that but reality tells us that these things happen and I am convinced that DocBlox should support it!

Dutch PHP Conference

DocBlox was also featured in the Unconference of the Dutch PHP Conference 2011 in the talks ‘Inside DocBlox’ by Mike van Riel and ‘Phing - a PHP build tool - short introduction’ by Michiel Rook (thanks!).

Improvements

The conference and planning of that talk took some of the velocity away from the Project but nonetheless I can announce some great new stuff:

• DocBlock Data Inheritance; classes, properties and methods are now able to inherit a short description, long description and a selection of tags from its parent
• A new task ‘theme:list’ to see which themes are supported by default
• A new task ‘theme:generate’ to create a theme skeleton upon which you can build your own branding
• Added argument -visibility, this allows you to limit which methods are actually included (public, protected, private, all)
• Colour coding of methods and properties to indicate whether they are public, protected or private has been added
• Improved support for different character encodings
• Improved ignore to support multiple source directories (as long as those are on the same partition)
• Parser performance is improved
• Empty PHP files caused an error; this has been fixed

The items mentioned here are only an excerpt from what was done in the past month. As always; if you want to see a full list of changes please read the CHANGELOG in the docs folder.

Plugins

What was not mentioned is that work has begun to add plugins to DocBlox. Initially they would allow you to inject custom functionality for specific tags but in a later stage this may add even more things that you can extend DocBlox with. Next month will be a new update on this.

Upcoming talks

If you’d like to have a introduction talk into DocBlox and life in or near the Netherlands then please visit pfCongres 2011 where I will be giving an introductory talk on documenting with DocBlox!

Conclusion

As you can see, lots of good stuff has been done and is still coming! Also: keep an eye out on the documentation, things might be changing there real soon?

Next release will be in the weekend of 18 and 19 July (my schedule does not permit an earlier release). After that we will return to release every first weekend of the month. Please follow the @DocBlox account on twitter to receive the latest information.

Comments