2021-11-07 19:28:16 +00:00
|
|
|
# Differences Between Meson and Waf
|
|
|
|
|
|
|
|
|
|
mpv currently supports two different build systems: waf and meson. In general,
|
|
|
|
|
option names between both build systems are mostly the same. In most cases,
|
|
|
|
|
``--enable-foo`` in waf becomes ``-Dfoo=enabled`` in meson. Likewise,
|
|
|
|
|
``--disable-foo`` becomes ``-Dfoo=disabled``. For the rest of this document,
|
|
|
|
|
Waf options will be noted as ``--foo`` while meson options are noted as
|
|
|
|
|
``foo``.
|
|
|
|
|
|
|
|
|
|
## Universal Options
|
|
|
|
|
|
|
|
|
|
Meson has several [universal options](https://mesonbuild.com/Builtin-options.html#universal-options)
|
|
|
|
|
that you get for free. In some cases, these overlapped with custom waf options.
|
|
|
|
|
|
|
|
|
|
* ``--libmpv-static`` and ``--libmpv-shared`` were combined into one option:
|
|
|
|
|
``libmpv``. Use ``default_library`` to control if you want to build static or
|
|
|
|
|
shared libraries.
|
|
|
|
|
* Waf had a boolean ``--optimize`` option. In meson, this is a universal option,
|
|
|
|
|
``optimization``, which can take several different values. In mpv's meson
|
|
|
|
|
build, the default is ``2``.
|
|
|
|
|
* Instead of ``--debug-build``, meson simply calls it ``debug``. It is enabled
|
|
|
|
|
by default.
|
|
|
|
|
|
|
|
|
|
## Changed Options
|
|
|
|
|
|
|
|
|
|
* The legacy lua names (``52``, ``52deb``, etc.) for ``--lua`` are not
|
|
|
|
|
supported in the meson build. Instead, pass the generic pkg-config values
|
|
|
|
|
such as ``lua52``, ``lua5.2``, etc.
|
|
|
|
|
* ``--lgpl`` was changed to ``gpl``. If ``gpl`` is false, the build is LGPL2.1+.
|
2023-03-27 20:42:17 +00:00
|
|
|
* ``--tests`` was removed since unit tests now explicitly require meson to run
|
2021-11-07 19:28:16 +00:00
|
|
|
|
|
|
|
|
### Boolean Options
|
|
|
|
|
|
|
|
|
|
The following options are all booleans that accept ``true`` or ``false``
|
|
|
|
|
instead of ``enabled`` or ``disabled``.
|
|
|
|
|
|
|
|
|
|
* ``build-date``
|
|
|
|
|
* ``cplayer``
|
|
|
|
|
* ``gpl``
|
|
|
|
|
* ``libmpv``
|
|
|
|
|
* ``ta-leak-report``
|
|
|
|
|
* ``tests``
|
|
|
|
|
|
|
|
|
|
## Removed Options
|
|
|
|
|
|
|
|
|
|
There are options removed with no equivalent in the meson build.
|
|
|
|
|
|
|
|
|
|
* ``--asm`` was removed since it doesn't do anything.
|
|
|
|
|
* ``--android`` was removed since meson knows if the machine is android.
|
|
|
|
|
* ``--clang-compilation-database`` was removed. Meson can do this on its own
|
|
|
|
|
by invoking ninja (``ninja -t compdb``).
|
|
|
|
|
* ``--tvos`` was removed since it doesn't do anything.
|
|
|
|
|
* ``--static-build`` was removed. Use ``default_library``.
|
|
|
|
|
* ``--swift-static`` was removed. The swift library always dynamically links.
|
|
|
|
|
|
|
|
|
|
## Renamed Options
|
|
|
|
|
|
|
|
|
|
These are some other options that were renamed.
|
|
|
|
|
|
|
|
|
|
* ``--gl-wayland`` was renamed to ``egl-wayland``.
|
|
|
|
|
* ``--swift`` was renamed to ``swift-build``.
|
|
|
|
|
|
|
|
|
|
## Other
|
|
|
|
|
|
|
|
|
|
* The meson build supports passing the ``SOURCE_DATE_EPOCH`` environment variable
|
|
|
|
|
during the compilation step for those who want reproducibility without having to
|
|
|
|
|
disable the build date.
|
|
|
|
|
* The ``Configuration`` line shown by ``mpv -v`` does not show everything passed on
|
|
|
|
|
cli since meson does not have any easy way to access a user's argv. Instead, it
|
|
|
|
|
simply shows whatever the value of ``prefix`` is regardless if it was specified
|
|
|
|
|
or not.
|
