summaryrefslogtreecommitdiff
path: root/docs/yaml/objects/file.yaml
diff options
context:
space:
mode:
Diffstat (limited to 'docs/yaml/objects/file.yaml')
-rw-r--r--docs/yaml/objects/file.yaml12
1 files changed, 11 insertions, 1 deletions
diff --git a/docs/yaml/objects/file.yaml b/docs/yaml/objects/file.yaml
index 6aa0b85ce..5d2ad3053 100644
--- a/docs/yaml/objects/file.yaml
+++ b/docs/yaml/objects/file.yaml
@@ -1,3 +1,13 @@
name: file
long_name: File
-description: Opaque object that stores the path to an existing file
+description: Object that stores the path to an existing file
+
+methods:
+- name: full_path
+ returns: str
+ since: 1.4.0
+ description: |
+ Returns a full path pointing to the file. This is useful for printing the
+ path with e.g [[message]] function for debugging purpose.
+ **NOTE:** In most cases using the object itself will do the same job
+ as this and will also allow Meson to setup dependencies correctly.