Re: Keep shipping also generated gtk-doc html/ folder?

[Frederic Peters <fpeters gnome org>]

Milan Crha wrote:

> On Thu, 2016-06-23 at 09:55 +0100, Philip Withnall wrote:
> > If I remember correctly, it’s so that the tarballs can be unpacked to
> > give documentation on developer.gnome.org without having to build
> > anything.

Actually gtk-doc did ship the generated files in the tarballs before
developer.gnome.org existed, so when I did that part I reused the
files that already existed.

> I know there had been quite much buzz about the infrastructure
> recently, I hope they won't dislike me, but maybe it would worth to
> reconsider this and do build the devel-doc for the developer.gnome.org
> site (easier to say, than to do, but maybe it could be extracted from
> the Continuous builds?).

developer.gnome.org can certainly be changed to grab generated HTML
files from any place that would have them.

> Also, it seem to me that it's the gtk-doc adding to the tarball that
> folder and couple files, thus the place to focus any changes on might
> be gtk-doc itself.

Also there has been several efforts to build on gobject-introspection
and expand the documentation to more languages, Mathieu Duponchelle is
working on this; if there's interest we can certainly organize a
session on API docs during the GUADEC.



        Fred