python: add embed to the python dependency function

2 files changed, 9 insertions, 1 deletions

diff --git a/docs/markdown/Python-module.md b/docs/markdown/Python-module.md
index 6f9a764..152aa5c 100644
--- a/docs/markdown/Python-module.md
+++ b/docs/markdown/Python-module.md
@@ -103,7 +103,11 @@ need to add `dependencies : py_installation.dependency()`, see [][`dependency()`
 python_dependency py_installation.dependency(...)
 ```
 
-This method accepts the same arguments as the standard [dependency] function.
+This method accepts the same arguments as the standard [dependency] function and
+the following additional keyword arguments:
+
+- `embed`: *(since 0.53.0)* If true, meson will try to find a python dependency
+  that can be used for embedding python into an application.
 
 **Returns**: a [python dependency][`python_dependency` object]
 
diff --git a/docs/markdown/snippets/python_embed.md b/docs/markdown/snippets/python_embed.md
new file mode 100644
index 0000000..f50002c
--- /dev/null
+++ b/docs/markdown/snippets/python_embed.md
@@ -0,0 +1,4 @@
+## python.dependency() embed kwarg
+
+Added the `embed` kwarg to the python module dependency function to select
+the python library that can be used to embed python into an application.