ocaml · Alizter · Jul 2, 2025 · Jul 1, 2025 · Jul 2, 2025
diff --git a/doc/changes/11956.md b/doc/changes/11956.md
@@ -0,0 +1,2 @@
+- Added 'empty' alias which contains no targets. (#11556 #11952 #11955 #11956,
+  grants #4161, @Alizter and @rgrinberg)
diff --git a/doc/reference/aliases.rst b/doc/reference/aliases.rst
@@ -70,6 +70,7 @@ Some aliases are defined and managed by Dune itself:
        aliases/default
        aliases/install
        aliases/pkg-install
+       aliases/empty
 
   .. grid-item::
 

diff --git a/doc/reference/aliases/empty.rst b/doc/reference/aliases/empty.rst
@@ -0,0 +1,9 @@
+@empty
+======
+
+The `empty` alias contains no targets.
+
+As of Dune language version 3.20, user-defined :doc:`rule <../dune/rule>` and
+:doc:`alias <../dune/alias>` stanzas are no longer permitted to extend the
+`empty` alias.
+
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1,2 @@
		- Added 'empty' alias which contains no targets. (#11556 #11952 #11955 #11956,
		grants #4161, @Alizter and @rgrinberg)