Grantlee version 0.1.7 now available

The Grantlee community is pleased to announce the release of Grantlee version 0.1.7 (Mirror). I had intended to make this release a few days ago, but the last few days have not gone 100% according to plan.

This release introduces the significant feature of generic types, but it also has many other smaller improvements. Even that was not quite right, and needed some compile fixes for STL includes on FreeBSD contributed by Raphael Kubo da Costa. Thanks for the patch! Incidentally, I had just pushed a tag and put tarballs on the download server when I noticed Raphaels contribution (apparently gitorious doesn’t email you about it. How SMRT). That means that every Grantlee release has had a contribution from someone who had not contributed before. Not bad.

The ever helpful [ade] notified me that the license text in source code header files is not exactly consistent with the COPYING file. The header text used the text ‘Library General Public License’ instead of ‘Lesser General Public License’. Additionally, the license version in the headers was identified as LGPL v2 (or later) instead of LGPL v2.1 (or later), which is what COPYING claims. In practice, nobody ever distributed Grantlee under the terms of the LGPL v2. Because of the license of Qt (LGPL 2.1), the ‘or later’ clause always kicked in, and it was distributed under a license compatible with the bundle it was distributed in (LGPL 2.1). At any rate, both issues with the license text are now fixed.

Several small issues with the documentation have now also been fixed. RenderContext was missing a doxygen command @headerfile to show the correct include path in the generated documentation (#include <grantlee/rendercontext.h> instead of just <rendercontext.h>). The RenderContext class itself now has fully documented public API, as does CachingLoaderDecorator. A slight lie in the documentation was also fixed in that it claimed dynamic properties of QObject were supported in Templates, but that didn’t work. The fix of course was to add a implementation and test for that feature.

I’ve also now made documentation generation fully automatic and part of the same release script that creates source tarballs. Now after running the unit tests the script creates Qt Assistant documentation and a web friendly documentation tarball with a link to the Qt Assistant file. The Grantlee documentation now has local links to stl documentation too so that if you have it loaded in your assistant, the links will open directly in assistant. The web version opens links to the GNU generated stl documentation on the web using familiar scripts.

Opening STL documentation in assistant linked from Grantlee

The next big challenge in Grantlee is i18n, and it is definitely a tricky issue.

Leave a Reply

Fill in your details below or click an icon to log in: Logo

You are commenting using your account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s

%d bloggers like this: