diff --git a/docs/markdown/snippets/install_mode-extended.md b/docs/markdown/snippets/install_mode-extended.md
new file mode 100644
index 000000000..b0ee4c311
--- /dev/null
+++ b/docs/markdown/snippets/install_mode-extended.md
@@ -0,0 +1,8 @@
+## install_mode argument extended to all installable targets
+
+It is now possible to pass an install_mode argument to all installable targets,
+such as executable(), libraries, headers, man pages and custom/generated
+targets.
+
+The install_mode argument can be used to specify the file mode in symbolic
+format and optionally the owner/uid and group/gid for the installed files.