Skip to content

Commit 710cf58

Browse files
committed
doc: fix #445, make it clear how task_dep works and suggest alternative.
1 parent bb9b2ed commit 710cf58

File tree

1 file changed

+7
-0
lines changed

1 file changed

+7
-0
lines changed

doc/dependencies.rst

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -252,6 +252,13 @@ task name (whatever comes after ``task_`` on the function name) in the
252252
*task-dependencies* are **not** used to determine if a task is up-to-date or
253253
not. If a task defines only *task-dependency* it will always be executed.
254254

255+
.. tip::
256+
257+
If you want a task to be considered not up-to-date when a dependency task's
258+
result changes, use :ref:`result_dep <result_dep>` instead.
259+
``result_dep`` implies a ``task_dep`` (execution order)
260+
and also checks if the dependency's result has changed.
261+
255262

256263
This example we make sure we include a file with the latest revision number of
257264
the mercurial repository on the tar file.

0 commit comments

Comments
 (0)