Lennart: >> Are the docs for writing a backend plugin API somewhere else? Or do >> you just have to figure it out from the existing plugin code? > > The backend "API" is considered internal -- not public; it might be > changed at any time. If you write a backend make sure to submit it > upstream so it is easy to keep up to date if the backend API > changes. I don't see any changes coming, but I want the freedom that I > can change it. Please note that we don't install any header files > related to the backend API for precisely this reason. Backends should > be developed in-tree.
Even if the API is private, some docs would be helpful since people do need to write backends. An ASCII doc in the source directory would be a reasonable place to keep such helpful volatile API docs, I'd think. > OTOH the official API for applications is considered stable. After all > it's an "Application Programmers Interface", not a "Backend > Programmers Interface". ;-) > > The gtk-docs API only includes documentation for the C API. We > probably should add a man page for c-g-p though. The glib and GTK+ gtk-docs contain information about programs like glib-genmarshal and gtk-query-immodules-2.0, etc. So there is precedent for describing non C API in gtk-docs. But, as you say, a manpage would be sufficient. >>> Consider working with >>> Marc-Andre to get it ready quickly. >> Okay. That sounds reasonable. I do not remember you sharing >> Marc-Andre's contact information. If you could share that with me, >> I will get in touch with him. > > The patch I linked contains Marc-Andre's address, AFAIR. Sorry, I missed that. > marcandre dot lureau at gmail dot com, elmarco on IRC. He's a Nokia > employee. He's also the gnome-multimedia maintainer if I am correctly > informed. i.e. someone to know for people interested in audio on free > desktops. ;-) > > And he is also on this ML. So you might as well keep discussions about > the gst patch on-list. > > Marc-Andre, say something! Thanks for the pointer. I'm trying to juggle about 20 different things as we are about to integrate GNOME 2.24 into Solaris. I'm not sure how quickly I will be able to get working with Marc-Andre, but I will as soon as I have some breathing room. I promised Jon McCann I would write some GDM docs this week, so I have to do that first. Brian _______________________________________________ libcanberra-discuss mailing list [email protected] https://tango.0pointer.de/mailman/listinfo/libcanberra-discuss
