Do not add custom target dir automatically when implicit false.implicitcustom

1 files changed, 17 insertions, 0 deletions

diff --git a/docs/markdown/snippets/customimplicit.md b/docs/markdown/snippets/customimplicit.md
new file mode 100644
index 000000000..8956c696f
--- /dev/null
+++ b/docs/markdown/snippets/customimplicit.md
@@ -0,0 +1,17 @@
+## Do not add custom target dir to header path if `implicit_include_directories` is `false`
+
+If you do the following:
+
+```meson
+# in some subdirectory
+gen_h = custom_target(...)
+# in some other directory
+executable('foo', 'foo.c', gen_h)
+```
+
+then the output directory of the custom target is automatically added
+to the header search path. This is convenient, but sometimes it can
+lead to problems. Starting with this version, the directory will no
+longer be put in the search path if the target has
+`implicit_include_directories: false`. In these cases you need to set
+up the path manually with `include_directories`.