February 22, 2009

something different

Tags: , , ,
Filed under: PHP,ZenMagick — DerManoMann @ 10:28 am

There is a reason that it has been quiet for a while around ZenMagick. I’ve got a new project:) Nothing too serious and most likely not even a real project.
I’ve tried adding some new features to PHPDoctor, the PHP documentation creator that I use to generate the ZenMagick API documentation. Since it turned out to be a lot messier and complex than expected (perhaps due to my inability to understand the code, I might add) I started re-implementing everything (but not from scratch).

The structure is more or less the same and the parser itself is still pretty much as it was before. What changed are the surrounding structures, tag and doc classes and doclets.

There is also a number of new classes and interfaces which make the code a bit over-engineered :) Still, it does pretty much the same as the original and a cople things more.

One major change is that the code required PHP5 to run and the output is more PHP5 that PHP4 (no var).
Of course, there is still a lot missing. So far the debug doclet is working to a degree, but there are still bits & bobs missing in the generated output. Also, I haven’t verified the actual doc parsing and from the comment in the code I deduct there are also still a few gaps in PHPDoctor itself.

I am not sure where this is heading right now. I do not feel great about working on another fork. I guess it all depends on whether I’ll be able to implement the features I want and need. If so, it’s probably worth returning the code to PHPDoctor and perhaps make it PHPDoctor3 or so.
Either way, still some way to go.

No Comments

No comments yet.

RSS feed for comments on this post.

Sorry, the comment form is closed at this time.