[PATCH 0/4] RFC: Add Meson build

[Pekka Paalanen]

On Mon, 23 Apr 2018 14:29:14 +0100
Emmanuele Bassi <ebassi at gmail.com> wrote:

> From: Emmanuele Bassi <ebassi at gnome.org>
> 
> This is an RFC/work-in-progress patch series for adding a Meson build to
> Wayland.
> 
> It's not ready for merge, as it has a couple of issues:

Awesome!

>  - the Doxygen-generated man pages are installed under $datadir/man,
>    instead of $mandir, because of Doxygen peculiarities, like forcing
>    the creation of a `man3` directory for no reason; additionally, Meson
>    doesn't really like it when custom targets start having
>    sub-directories. The current system is the least terrible I could
>    come up with, but the only way I figure it can be solved appropriately
>    is to write a Doxygen module for Meson. Sadly, I don't have the time
>    to work on it.

For a while I've been wondering if we should ditch doxygen and
everything we have and use, say, hotdoc[1] with the C extension[2] that
uses Clang to parse the code.

I haven't said that out loud before, because I think effort should be
spent on writing new docs, not a doc build system or converting docs
from one format to another. But since we are on the build system topic
now...

[1] https://hotdoc.github.io/
[2] https://github.com/hotdoc/hotdoc_c_extension


>  - no Publican support; I've asked on the #wayland IRC channel, and it
>    seems it's mostly a relic of the initial documentation effort; it's
>    a lot easier to just dump the Doxygen-generated HTML, though it's
>    probably worth spending some time making the CSS nicer, given the
>    default Doxygen style being less than stellar.

Yeah, Publican was ripped out years ago, I would not expect it even
could run. Just the doc build system was left unsimplified AFAIU.

Our XSL transforming scripts are missing bits and pieces as well, I
believe.

>  - I haven't thoroughly tested this build. I've diff'd the installed
>    trees, and checked the exported symbols; I've also rebuilt GTK+ (both
>    stable and development branches) on top of it, but it *definitely*
>    needs some more testing.
> 
> I wanted to drop this on the mailing list before I accidentaly leave it
> to rot on my repo.

I very much hope someone continues this effort.


Thanks,
pq

> Emmanuele Bassi (4):
>   Support running tests from different build directories
>   Add Meson build to Wayland
>   meson: Run Doxygen on the Meson build
>   meson: Generate man pages
> 
>  cursor/meson.build          |  30 ++++++
>  doc/doxygen/.gitignore      |   1 +
>  doc/doxygen/gen-doxygen.py  |  90 ++++++++++++++++
>  doc/doxygen/meson.build     | 112 ++++++++++++++++++++
>  doc/doxygen/xml/meson.build |  18 ++++
>  doc/man/meson.build         |  64 ++++++++++++
>  doc/meson.build             |   2 +
>  egl/meson.build             |  43 ++++++++
>  meson.build                 | 106 +++++++++++++++++++
>  meson_options.txt           |  20 ++++
>  src/meson.build             | 203 ++++++++++++++++++++++++++++++++++++
>  tests/meson.build           | 134 ++++++++++++++++++++++++
>  tests/test-helpers.c        |  13 ++-
>  13 files changed, 834 insertions(+), 2 deletions(-)
>  create mode 100644 cursor/meson.build
>  create mode 100755 doc/doxygen/gen-doxygen.py
>  create mode 100644 doc/doxygen/meson.build
>  create mode 100644 doc/doxygen/xml/meson.build
>  create mode 100644 doc/man/meson.build
>  create mode 100644 doc/meson.build
>  create mode 100644 egl/meson.build
>  create mode 100644 meson.build
>  create mode 100644 meson_options.txt
>  create mode 100644 src/meson.build
>  create mode 100644 tests/meson.build
> 

-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 833 bytes
Desc: OpenPGP digital signature
URL: <https://lists.freedesktop.org/archives/wayland-devel/attachments/20180423/cefcfb7a/attachment.sig>