DocBlox

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

Release of v0.16.0

Posted on | November 14, 2011 | No Comments

After the great news that SugarCRM has started using DocBlox I am happy to announce the immediate availability of DocBlox 0.16.0; this release revolves around fixing bugs, making minor improvements and improving general code quality. A week later then scheduled because I did not deem that version stable enough; well-tested enough and I lacked the time to fix and test that in time.

Read more

Fork me on GitHub

Release of v0.15.1

Posted on | October 6, 2011 | 1 Comment

It appears that the PEAR repository on which DocBlox depends for the markdown integration is down or moved (and I haven’t found it yet). So we have to do a release to remove the dependency and include the Markdown component with a PEAR installation.

Read more

Release of v0.15.0

Posted on | October 2, 2011 | 2 Comments

Here we are again! First weekend of October and time for the launch of 0.15.0. The most prominent new features are Plugins and more validations!
Read more

Release of v0.14.1

Posted on | September 18, 2011 | 8 Comments

I just had a blast presenting ‘DocBlox: your source matters’ at pfCongres 2011; especially exciting was that the new Plugin feature in 0.15.0 was announced here.
Read more

Release of v0.14.0

Posted on | September 4, 2011 | 6 Comments

Wow! Past month has been quite a ride. During this time we managed to add quite some features and improvements to DocBlox. Most notably we added support for Doctrine Annotations. They are parsed, displayed nicely and a link is provided to the Doctrine Documentation. But there is more!

Read more

Release of v0.13.3

Posted on | August 21, 2011 | 1 Comment

It would appear I have forgotten to write a blog post after the release of v0.13.2 and v0.13.1. Bit of a shame.. So together with v0.13.3 I am posting the fixes and enhancements of the past two bug fix releases as well!
Read more

Release of v0.13.0

Posted on | August 8, 2011 | No Comments

One day later than planned but this is an awesome release to do! 0.13.0 brings several improvements related to inheritance of items (thus seeing your parent’s method in a child class) and not to say the least an overhaul of the Class view!

Read more

Release of v0.12.3

Posted on | August 5, 2011 | No Comments

Starting with this revision I will also be writing a change summary for every minor that is released. This will mean shorter summaries as they will be spread out but I hope that you will forgive me for that ;)

Read more

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!

Read more

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.

keep looking »
  • 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