Re: [PATCH] NM DBUS api documentation build system

[Will Stephenson <wstephenson kde org>]

On Tuesday 05 February 2008 17:47:06 Marcel Holtmann wrote:
> I must agree here. Something that generate the introspection is not
> helpful at all. It is hard enough to keep external introspection XML
> files in sync with the actual runtime introspection. 

Surely the glib binding generators create the runtime introspection from the 
xml files?  That's the way the Qt bindings work.

> Why should we have 
> another thing to maintain. 

This thing makes the project more accessible, and could make existing 
developers more efficient.  And I'm happy to maintain it.

> If you could generate the introspection files 
> from within the source code, that is a different story. Something in
> combination with Doxygen.

You know that's not the way IPC ever worked: you can't recover a spec from 
something as irregular as source code; you have a structured IDL (in this 
case the introspection xml) and you generate the bindings sources from that, 
saving yourself from maintaining a lot of boilerplate code by hand.

Will

-- 
Will Stephenson
IRC: Bille