Meson is project to create the best possible next-generation
build system.


Dependencies

Python   http://python.org (version 3.3 or newer)
Ninja    http://martine.github.com/ninja/


Installing from source

You can run Meson directly from a revision control checkout or an
extracted tarball.  Installing it system-wide is simple.

Configure step: None
Compile step:   None
Unit test step: ./run_tests.py
Install step:   [sudo] ./install_meson.py --prefix /your/prefix --destdir /destdir/path

The default value of prefix is /usr/local. The default value of destdir
is empty. 


Running

Meson requires that you have a source directory and a build directory
and that these two are different. In your source root must exist a file
called 'meson.build'. To generate the build system run this command:

meson <source directory> <build directory>

You can omit either of the two directories, and Meson will substitute
the current directory and autodetect what you mean. This mean that you
can do things like this:

cd source_root; mkdir build; cd build; meson.py ..
cd source_root; mkdir build; meson.py build

To compile, cd into your build directory and type 'ninja'. To run unit
tests, type 'ninja test'.

Install is the same but it can take an extra argument:

DESTDIR=/destdir/path ninja install

DESTDIR can be omitted. If you are installing to system directories,
you may need to run this command with sudo.


Contributing

We love community contributions. There are two simple ways to submit your
patches. The preferred way is to send a github pull request. You can
also send patches as emails to the Meson mailing list. Remember to add
your name to the list of contributors in authors.txt.


Further info

The home page of Meson can be found here:

https://jpakkane.github.io/meson/