summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorEli Schwartz <eschwartz@archlinux.org>2023-02-22 23:33:51 -0500
committerEli Schwartz <eschwartz@archlinux.org>2023-03-09 15:13:46 -0500
commit62c269d08859747ba558e90bc98505e6325ef678 (patch)
treefde98d5a628c0ce9d81a2e50538dbce3f7031531 /docs
parent162ac25beb001b52d741d7b8c6f13e26c937b1e3 (diff)
downloadmeson-62c269d08859747ba558e90bc98505e6325ef678.tar.gz
dependencies: add pybind11 custom factory
This works with pkg-config and cmake without any special support. The custom factory adds further support for config-tool, via `pybind11-config`. This is useful because the config-tool will work out of the box when pybind11 is installed, but the pkg-config and cmake files are shoved into python's site-packages, which is an unfortunate distribution model and makes it impossible to use in an out of the box manner. It's possible to manually set up the PKG_CONFIG_PATH to detect it anyway, but in case that does not happen, having the config-tool fallback is extremely useful.
Diffstat (limited to 'docs')
-rw-r--r--docs/markdown/Dependencies.md6
-rw-r--r--docs/markdown/snippets/pybind11_dep.md9
2 files changed, 15 insertions, 0 deletions
diff --git a/docs/markdown/Dependencies.md b/docs/markdown/Dependencies.md
index 88a1dbd98..d95b8359d 100644
--- a/docs/markdown/Dependencies.md
+++ b/docs/markdown/Dependencies.md
@@ -659,6 +659,12 @@ The `language` keyword may used.
`method` may be `auto`, `config-tool` or `pkg-config`.
+## Pybind11
+
+*(added 1.1.0)*
+
+`method` may be `auto`, `pkg-config`, `config-tool`, or `cmake`.
+
## Python3
Python3 is handled specially by Meson:
diff --git a/docs/markdown/snippets/pybind11_dep.md b/docs/markdown/snippets/pybind11_dep.md
new file mode 100644
index 000000000..ac1970148
--- /dev/null
+++ b/docs/markdown/snippets/pybind11_dep.md
@@ -0,0 +1,9 @@
+## New pybind11 custom dependency
+
+`dependency('pybind11')` works with pkg-config and cmake without any special
+support, but did not handle the `pybind11-config` script.
+
+This is useful because the config-tool will work out of the box when pybind11
+is installed, but the pkg-config and cmake files are shoved into python's
+site-packages, which makes it impossible to use in an out of the box manner.
+