summaryrefslogtreecommitdiff
path: root/docs/yaml/objects
diff options
context:
space:
mode:
authorDaniel Mensinger <daniel@mensinger-ka.de>2021-10-04 19:39:36 +0200
committerDaniel Mensinger <daniel@mensinger-ka.de>2021-10-04 19:39:36 +0200
commitb672ebca886dd6dc9b0f775eb769764750fd302c (patch)
tree342bc608e79ed7a248ca849b77d52ff63dbdab8b /docs/yaml/objects
parent0b9c7b74bef2dd5913cc8d96de0fc016d682ead1 (diff)
downloadmeson-b672ebca886dd6dc9b0f775eb769764750fd302c.tar.gz
Minor fixups
Diffstat (limited to 'docs/yaml/objects')
-rw-r--r--docs/yaml/objects/build_tgt.yaml2
-rw-r--r--docs/yaml/objects/external_program.yaml39
2 files changed, 38 insertions, 3 deletions
diff --git a/docs/yaml/objects/build_tgt.yaml b/docs/yaml/objects/build_tgt.yaml
index e1c8a8002..97c0c5d3e 100644
--- a/docs/yaml/objects/build_tgt.yaml
+++ b/docs/yaml/objects/build_tgt.yaml
@@ -5,8 +5,6 @@ description: |
A build target is either an executable, shared library, static library,
both shared and static library or shared module.
- TODO: Missing methods, links
-
methods:
- name: full_path
returns: str
diff --git a/docs/yaml/objects/external_program.yaml b/docs/yaml/objects/external_program.yaml
index d0e476f5d..02bf48f6b 100644
--- a/docs/yaml/objects/external_program.yaml
+++ b/docs/yaml/objects/external_program.yaml
@@ -1,3 +1,40 @@
name: external_program
long_name: External program
-description: TODO
+description: Opaque object representing an external program
+
+methods:
+- name: found
+ returns: bool
+ description: Returns whether the executable was found.
+
+- name: path
+ returns: str
+ deprecated: 0.55.0
+ description: |
+ *Deprecated:* Use [[external_program.full_path]] instead.
+
+ Returns a string pointing to the script or executable.
+
+ **NOTE:** You should not need to use this method. Passing the object itself
+ should work in all cases.
+
+ For example:
+
+ ```meson
+ run_command(find_program('foo'), 'arg1', 'arg2')
+ ```
+
+- name: full_path
+ returns: str
+ since: 0.55.0
+ description: |
+ Returns a string pointing to the script or executable.
+
+ **NOTE:** You should not need to use this method. Passing the object itself
+ should work in all cases.
+
+ For example:
+
+ ```meson
+ run_command(find_program('foo'), 'arg1', 'arg2')
+ ```