So, as of telepathy-spec 0.7.22, we have made available a new pure-Python parser for processing D-Bus API specifications written using the Telepathy XML namespace. This parser turns the XML into nice pretty Python data structures that you can do things with. One such thing is to generate HTML documentation using a templating system (we're using Cheetah); which looks something like this. At some point in the future, it will also be used to generate language bindings.

I mention this because those of us at Telepathy HQ think that our XML format is a pretty damned nifty way to specify D-Bus APIs, and we'd love to see other people getting on board. I know at least one other project is using our format, but I've forgotten who. If you want to give the new parser and HTML doc generator a whirl against your own spec, you can grab them from the telepathy-spec GIT repo. Bugs on a postcard.