GNOME Bugzilla – Bug 468525
Include external dependencies doc?
Last modified: 2008-10-18 10:04:45 UTC
I'm wondering if it'd be interesting to also include the docs for our external dependencies. Eg, having the dbus API reference on lib.gnome.org would probably be useful for people.
There was also some discussion on IRC earlier today whenever it would be a good idea to also include freedesktop specs, like .desktop specs, icon-naming-spec, theme-spec etc. on library.gnome.org for ISV's and ISD's to bite into. People thought it sounded like a good idea, as long as the specs were up-to-date. It should also probably be stated that those documents are freedesktop standards, so no one will get pissed off :) Quote: <arc> dude, I'm afraid we're starting to look like a real development platform.....
Andreas: I love you. It makes sense. I've wanted for quite some time to have the specs in a tarball. I'll probably do it. One day. When I have time. I'll send a mail about this to xdg.
Since Vincent works so hard on his thesis that he wouldn't have time to create a tarball with specifications, I added support to download then format in library style remote documents. Relevant commits: 2007-08-23 Frederic Peters <fpeters@0d.be> * data/catalog.xml.in, data/overlay.xml.in, data/skin/docbook.css, data/skin/lgo.css, data/xslt/html2html.xsl, data/xslt/indexes.xsl, src/lgo.py: added possibility for *standalone* remote HTML documents to be published in library.gnome.org; applied that new feature to guide to GNOME lockdown and to the Desktop Entry Specification. 2007-08-23 Frederic Peters <fpeters@0d.be> * data/overlay.xml.in: added a bunch of freedesktop.org specifications to the references section.
*** Bug 525088 has been marked as a duplicate of this bug. ***
*** Bug 521674 has been marked as a duplicate of this bug. ***
525088 asks for gstreamer and cairo; gstreamer is already there, cairo is not, and should probably be added. 521674 asks for gnutls. I'll think about the best way to add all those documents while improving navigation in libgo.
Note that gstreamer is not an external dep, it's in the desktop :-) Cairo makes sense. I'm not sure about gnutls -- this might be going too far.
*** Bug 535494 has been marked as a duplicate of this bug. ***
From the duplicate, we need to add dbus-glib also, that would be really convenient.
I added cairo and dbus-glib, but I am not quite happy putting them under the "Other related libraries" title; anyone with a good suggestion to share? 2008-05-29 Frederic Peters <fpeters@0d.be> * data/extra-tarballs, data/overlay.xml.in: added cairo and dbus-glib, as requested in bug #468525.
Closing this general bug as external dependencies have been added, and are actually added on a case-by-case basis (see Vincent comment)