summaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authorUlrich Ölmann <u.oelmann@pengutronix.de>2019-06-05 01:16:54 +0200
committerMichael Olbrich <m.olbrich@pengutronix.de>2019-06-05 19:04:45 +0200
commit91749a01cd22dc2a7d72e841568a2dddb16200f7 (patch)
tree6d758efd4d9ffdb823c2cea1d7566f25c68bfd8c /doc
parent61b944306746fb44dcda3824d5b9f1ca61d90b85 (diff)
downloadptxdist-91749a01cd22dc2a7d72e841568a2dddb16200f7.tar.gz
ptxdist-91749a01cd22dc2a7d72e841568a2dddb16200f7.tar.xz
templates: add src-meson-prog template
Signed-off-by: Ulrich Ölmann <u.oelmann@pengutronix.de> Signed-off-by: Michael Olbrich <m.olbrich@pengutronix.de>
Diffstat (limited to 'doc')
-rw-r--r--doc/dev_manual.rst36
1 files changed, 29 insertions, 7 deletions
diff --git a/doc/dev_manual.rst b/doc/dev_manual.rst
index e17aa9b1b..dfadcb241 100644
--- a/doc/dev_manual.rst
+++ b/doc/dev_manual.rst
@@ -206,6 +206,14 @@ handle:
and their settings. Creating such a package will also create a simple
template project to be used as a starting point for development.
+- **src-meson-prog**: This kind of package is built for the target.
+ It’s intended for developments based on the *meson* buildsystem.
+ Various projects are using *meson* today and can be built
+ with this package type. PTXdist will prepare it to compile sources in
+ accordance to the target libraries and their settings. Creating such
+ a package will also create a simple template project to be used as a
+ starting point for development.
+
- **font**: This package is a helper to add X font files to the root
filesystem. This package does not create an additional IPKG, instead
it adds the font to the existing font IPKG. This includes the
@@ -1156,12 +1164,12 @@ So, in the rule file only the two variables ``FOO_MAKE_ENV`` and
package’s buildsystem. If the package cannot be built in parallel, we
can also add the ``FOO_MAKE_PAR := NO``. ``YES`` is the default.
-Managing CMake / QMake Packages
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+Managing CMake/QMake/Meson Packages
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-Building packages that use ``cmake`` or ``qmake`` is much like building
-packages with an autotools based buildsystem. We need to specify the
-configuration tool:
+Building packages that use ``cmake``, ``qmake`` or ``meson`` is much like
+building packages with an autotools based buildsystem. We need to specify
+the configuration tool:
.. code-block:: make
@@ -1173,6 +1181,12 @@ or
FOO_CONF_TOOL := qmake
+or respectively
+
+.. code-block:: make
+
+ FOO_CONF_TOOL := meson
+
And provide the correct configuration options. The syntax is different so
PTXdist provides additional macros to simplify configurable features.
For ``cmake`` the configuration options typically look like this:
@@ -1192,8 +1206,16 @@ For ``qmake`` the configuration options typically look like this:
$(CROSS_QMAKE_OPT) \
PREFIX=/usr
-Please note that currently only host and target ``cmake`` packages and only
-target ``qmake`` packages are supported.
+And for ``meson`` the configuration options typically look like this:
+
+.. code-block:: make
+
+ FOO_CONF_OPT := \
+ $(CROSS_MESON_USR) \
+ -Dbar=$(call ptx/truefalse,PTXCONF_FOO_BAR)
+
+Please note that currently only host and target ``cmake``\/``meson`` packages
+and only target ``qmake`` packages are supported.
Managing Python Packages
^^^^^^^^^^^^^^^^^^^^^^^^