diff --git a/doc/bitbake-user-manual/bitbake-user-manual-metadata.rst b/doc/bitbake-user-manual/bitbake-user-manual-metadata.rst
index d802a8d3..181c0997 100644
--- a/doc/bitbake-user-manual/bitbake-user-manual-metadata.rst
+++ b/doc/bitbake-user-manual/bitbake-user-manual-metadata.rst
@@ -1689,6 +1689,14 @@ This section describes several ways to declare dependencies. Remember,
 even though dependencies are declared in different ways, they are all
 simply dependencies between tasks.
 
+.. note::
+
+   Override style operators do not work for declaring task dependencies.
+   See
+   :ref:`bitbake-user-manual/bitbake-user-manual-metadata:Inter-Task Dependencies`
+   for details.
+
+
 .. _dependencies-internal-to-the-bb-file:
 
 Dependencies Internal to the ``.bb`` File
@@ -1813,6 +1821,17 @@ must have completed before the ``do_patch`` task can execute.
 The ``[rdepends]`` flag works in a similar way but takes targets in the
 runtime namespace instead of the build-time dependency namespace.
 
+Note that dependencies are specified via
+:ref:`bitbake-user-manual/bitbake-user-manual-metadata:Variable Flag Syntax`
+and thus override style operators do not work for declaring task
+dependencies. You can add a task dependency for a specific override
+(e.g. a specific machine) by declaring an intermediary variable and using
+overrides for setting that variable::
+
+   # Does not work: do_compile:machine[depends] += "another_target:do_task"
+   EXTRA_DO_COMPILE_DEPENDS:machine = "another_target:do_task"
+   do_compile[depends] += "${EXTRA_DO_COMPILE_DEPENDS}"
+
 Functions You Can Call From Within Python
 =========================================