Merge pull request #8706 from dcbaker/wip/2021-04/cython-language

1st class Cython language support

1 files changed, 33 insertions, 0 deletions

diff --git a/docs/markdown/Cython.md b/docs/markdown/Cython.md
new file mode 100644
index 0000000..17302b3
--- /dev/null
+++ b/docs/markdown/Cython.md
@@ -0,0 +1,33 @@
+---
+title: Cython
+short-description: Support for Cython in Meson
+...
+
+# Cython
+
+Meson provides native support for cython programs starting with version 0.59.0.
+This means that you can include it as a normal language, and create targets like
+any other supported language:
+
+```meson
+lib = static_library(
+    'foo',
+    'foo.pyx',
+)
+```
+
+Generally Cython is most useful when combined with the python module's
+extension_module method:
+
+```meson
+project('my project', 'cython')
+
+py = import('python')
+dep_py3 = py.dependency()
+
+py.extension_module(
+    'foo',
+    'foo.pyx',
+    dependencies : dep_py,
+)
+```