diff --git a/docs/markdown/Machine-files.md b/docs/markdown/Machine-files.md
index 631408240..c77c7dca0 100644
--- a/docs/markdown/Machine-files.md
+++ b/docs/markdown/Machine-files.md
@@ -297,6 +297,8 @@ build-tests = false
 
 ### Meson built-in options
 
+*Before 0.56.0, `<lang>_args` and `<lang>_link_args` must be put in the `properties` section instead, else they will be ignored.*
+
 Meson built-in options can be set the same way:
 
 ```ini