On Feb 5, 2008 8:46 AM, Will Stephenson <[EMAIL PROTECTED]> wrote: <snip> > I haven't actually added any api documentation yet. I'm working on supporting > NM 0.7 in KDE 4 and would do so as I grok 0.7. The patch just replicates the > status quo with the ability to add api docs. The system can also add a make > check target to assure the docu generation is working but I haven't > adapted/copied that yet. > > Another question is, are you interested in async glib binding support? The > system can apparently generate separate async introspection xml but I haven't > adapted that either yet as I'm not familiar with the glib bindings. > > I've tested this locally. Dan, Tambet: what do you think about integrating > it? It would make NM client developement much easier.
While I'd like to have always up to date documentation, I'm not sure I like this. The patch you sent only removes the introspection XML we currently have and adds some XSLT which I can't read (and thus maintain). It'll make development easier only if someone actually writes that documentation, just converting to more magic makes things harder to understand. And again, I like having documentation as much as anyone, but since we have two developers in total (who are busy with maintenance work for a lot of time), I personally would rather write code. So if anyone wants to help with documentation, it could live in a text file for now. When it has enough information, and if Dan feels comfortable maintaining XSLT, I wouldn't have anything against the proposed solution. Tambet _______________________________________________ NetworkManager-list mailing list NetworkManager-list@gnome.org http://mail.gnome.org/mailman/listinfo/networkmanager-list