summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
Diffstat (limited to 'docs')
-rw-r--r--docs/markdown/snippets/executable-suffixes.md14
-rw-r--r--docs/yaml/functions/executable.yaml3
2 files changed, 17 insertions, 0 deletions
diff --git a/docs/markdown/snippets/executable-suffixes.md b/docs/markdown/snippets/executable-suffixes.md
new file mode 100644
index 000000000..44471e9dd
--- /dev/null
+++ b/docs/markdown/snippets/executable-suffixes.md
@@ -0,0 +1,14 @@
+## Target names for executables now take into account suffixes.
+
+In previous versions of meson, a `meson.build` file like this:
+
+```
+exectuable('foo', 'main.c')
+exectuable('foo', 'main.c', name_suffix: 'bar')
+```
+
+would result in a configure error because meson internally used
+the same id for both executables. This build file is now allowed
+since meson takes into account the `bar` suffix when generating the
+second executable. This allows for executables with the same basename
+but different suffixes to be built in the same subdirectory.
diff --git a/docs/yaml/functions/executable.yaml b/docs/yaml/functions/executable.yaml
index 380759457..abbc5feee 100644
--- a/docs/yaml/functions/executable.yaml
+++ b/docs/yaml/functions/executable.yaml
@@ -10,6 +10,9 @@ description: |
The returned object also has methods that are documented in [[@exe]].
+ *Since 1.3.0* executable names can be the same across multiple targets as
+ long as they each have a different `name_suffix`.
+
warnings:
- The `link_language` kwarg was broken until 0.55.0