summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorDylan Baker <dylan@pnwbakers.com>2025-06-16 08:46:14 -0700
committerDylan Baker <dylan@pnwbakers.com>2025-10-08 10:42:41 -0700
commit6c05dabc47389f471c435394c13981d92f288d9b (patch)
tree64ac07e72bd78247b6984f4e9d73b8e9fecb459b /docs
parenta5094a134aa8b2a971153ed8446f27d986f476e7 (diff)
downloadmeson-6c05dabc47389f471c435394c13981d92f288d9b.tar.gz
vala: Add method to build_target to get generated vapi file
Same as the previous, but for VAPI
Diffstat (limited to 'docs')
-rw-r--r--docs/markdown/Vala.md11
-rw-r--r--docs/markdown/snippets/vala-target-extra-methods.md4
-rw-r--r--docs/yaml/objects/build_tgt.yaml8
3 files changed, 22 insertions, 1 deletions
diff --git a/docs/markdown/Vala.md b/docs/markdown/Vala.md
index 23ff57018..af9426352 100644
--- a/docs/markdown/Vala.md
+++ b/docs/markdown/Vala.md
@@ -318,6 +318,17 @@ foo_h = foo_lib.vala_header()
This header can now be used like any other generated header to create an
order-only dependency.
+### Depending on VAPI header
+
+*(since 1.10.0)*
+
+Given the previous example,
+
+```meson
+foo_lib = shared_library(...)
+foo_vapi = foo_lib.vala_vapi()
+```
+
### GObject Introspection and language bindings
A 'binding' allows another programming language to use a library
diff --git a/docs/markdown/snippets/vala-target-extra-methods.md b/docs/markdown/snippets/vala-target-extra-methods.md
index 1c7867e4f..72d89e56e 100644
--- a/docs/markdown/snippets/vala-target-extra-methods.md
+++ b/docs/markdown/snippets/vala-target-extra-methods.md
@@ -1,12 +1,14 @@
## Vala BuildTarget dependency enhancements
A BuildTarget that has Vala sources can now get a File dependency for its
-generated header.
+generated header and generated vapi.
```meson
lib = library('foo', 'foo.vala')
lib_h = lib.vala_header()
lib_s = static_lib('static', 'static.c', lib_h)
+
+lib_vapi = lib.vala_vapi()
```
`static.c` will not start compilation until `lib.h` is generated.
diff --git a/docs/yaml/objects/build_tgt.yaml b/docs/yaml/objects/build_tgt.yaml
index 7229de590..da64a469e 100644
--- a/docs/yaml/objects/build_tgt.yaml
+++ b/docs/yaml/objects/build_tgt.yaml
@@ -85,3 +85,11 @@ methods:
Returns a [[@file]] object pointing to a C compatible header generated by
the vala compiler, if this target does not generate a vala header then it is
an error to call this method.
+
+- name: vala_vapi
+ returns: file
+ since: 1.10.0
+ description: |
+ Returns a [[@file]] object pointing to a VAPI header generated by the vala
+ compiler, if this target does not generate a VAPI file then it is an error
+ to call this method.