summaryrefslogtreecommitdiff
path: root/docs/yaml
diff options
context:
space:
mode:
authorEli Schwartz <eschwartz93@gmail.com>2025-10-15 21:49:10 -0400
committerEli Schwartz <eschwartz93@gmail.com>2025-10-15 23:01:36 -0400
commit5c0aad57f92d2a6bebc1cb17655dd8a56f4bcd3f (patch)
tree69a228a10f425b33392df576f79bd8b7c5402104 /docs/yaml
parent1177e77c2893891cb35144b8033786cb8f75c7cd (diff)
downloadmeson-5c0aad57f92d2a6bebc1cb17655dd8a56f4bcd3f.tar.gz
revert local_program()
This reverts https://github.com/mesonbuild/meson/pull/15107 Explicit objections regarding the design were raised and not answered, so it shouldn't have been merged. It needs to be discussed and revisited.
Diffstat (limited to 'docs/yaml')
-rw-r--r--docs/yaml/functions/local_program.yaml43
1 files changed, 0 insertions, 43 deletions
diff --git a/docs/yaml/functions/local_program.yaml b/docs/yaml/functions/local_program.yaml
deleted file mode 100644
index 07fafcf3a..000000000
--- a/docs/yaml/functions/local_program.yaml
+++ /dev/null
@@ -1,43 +0,0 @@
-name: local_program
-returns: external_program
-since: 1.10.0
-description: |
- Similar to [[find_program]], but only work with a program that exists in
- source tree, or a built target. Meson will not look for the program in the
- system or in a subproject.
-
- In addition, `depends` keyword argument can be specified in case the program
- depends on built targets, for example a Python script could require a compiled
- C module. If any such dependency is present, the program can only be used in
- build-time commands (e.g. [[custom_target]]).
-
- The program can be passed to [[meson.override_find_program]] and used in
- subprojects.
-
-posargs:
- program:
- type: str | file | exe | custom_tgt | custom_idx
- description: |
- A [[@file]] object or the name of a program in the current source directory.
-
-kwargs:
- depend_files:
- type: array[str | file]
- description: |
- files ([[@str]],
- [[@file]], or the return value of [[configure_file]] that
- this target depends on. Useful for adding regen dependencies.
-
- depends:
- type: array[build_tgt | custom_tgt | custom_idx]
- description: |
- Specifies that this target depends on the specified
- target(s). If specified, this program can only be used at build time,
- after those targets have been built.
-
- interpreter:
- type: external_program
- description: |
- When the program is a [[@custom_tgt]], Meson cannot derive the interpreter
- from the file's "shebang" (`#!`) line before it's built. If needed, this
- argument allows specifying an interpreter for the script.