Documentation for build system setup

Hi Gnome Devs,

I was looking at the following overview page today:
e.g. "platform-overview/3.22/"

I would like to submit the following feedback about this page. An aspect
that I am missing here is
some information about the build system setup. For example most Gnome
Modules are currently
autotools based, they ship an and follow a certain set of
best practices in their and files. It would be great to have an
additional entry on this
page that is maybe named "build automation" or "building the
application" and that contains
some information about how to setup the build system. I would suggest to
limit that
to autotools for the moment but it could be extended to mention meson or
cmake in the

I know we already have a bunch of good documentation on the wiki,
for example:

However it seems to me that none of these pages offers
a really up to date information and consistent summary
of how a typical gnome application should be setup

I guess that there probably exist other wiki pages that I have not found
I am also pretty certain that I have seen various blog posts on Planet
Gnome about
build system aspects but cant remember the links to them.

A few example questions for which I would hope to find answers in
the documentation are:

1. What are best practices when setting up, is there are
recommended template
    to start with. I know the GnomeCommon migration guide lists one, but
I did not find it useful.
    In particular because it contains calls to both glib-gettextize and
intltoolize and the page later
    mentions that exactly this should not be done.
Your file might include a call to either glib-gettextize or
intltoolize. (If it calls both, then you have done something wrong,
since they don't work properly together.) glib-gettextize is now
obsoleted by new functionality in upstream gettext, and autoreconf
will call autopoint automatically.

2. What are best practices regarding builddir!=srcdir builds? Are there
any special steps required when using jhbuild, when I want it to do
out-of-tree builds?

3. What are some recommended macros from autoconf-archive that should be

If there is already a good documentation about this, and I just missed
it, then I apologise for the noise.

Best Regards

P.S. I am cross-posting this on the desktop-devel-list, maybe other
people have some suggestions about this.

[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]