Re: Let's kill gnome-common!

[Frederic Peters <fpeters gnome org>]

Milan Crha wrote:

> On Tue, 2018-02-13 at 11:19 +0000, Emmanuele Bassi wrote:
> > Work is in progress to let maintainers upload tarballs with the
> > generate API reference for developer.gnome.org
>
>       Hi,
> okay, how is that supposed to work in general? As Meson builds out of
> the source tree, is that "work in progress" meant to be Meson specific?

Developer.gnome.org still looks for "markers" in source tarballs (like
include gtk-doc.make in Makefile.am) and use those to extract the
documentation module name (ex: for gtk+ it would extract three doc
modules, gtk4, gdk4, gsk4).

What's new and in progress is the possibility to map those modules to
external documentation tarballs that will contain the generated HTML
files.

Some parts of the process are in place already, from manually
generated documentation tarballs for GTK+, published at:
  https://download.gnome.org/docs/gtk+/3.93/
we can now create https://developer.gnome.org/gtk4/3.93/

(this is very fresh, literally two days ago)

Now no maintainer would want the burden to generate those additional
tarballs and they should be automatically created and published by a
CI system (gnome continuous or buildstream or whatever).

Wrt evolution developer.gnome.org still lacks the code to find the
gtk-doc markers in CMakeLits.txt files. (some experimental code was
added for meson as used in GTK+)


        Frederic