On Mon, 23 Apr 2018 14:29:14 +0100 Emmanuele Bassi <[email protected]> wrote:
> From: Emmanuele Bassi <[email protected]> > > 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 >
pgpWvenElHwE7.pgp
Description: OpenPGP digital signature
_______________________________________________ wayland-devel mailing list [email protected] https://lists.freedesktop.org/mailman/listinfo/wayland-devel
