aboutsummaryrefslogtreecommitdiff
path: root/docs/design.md
diff options
context:
space:
mode:
Diffstat (limited to 'docs/design.md')
-rw-r--r--docs/design.md4
1 files changed, 3 insertions, 1 deletions
diff --git a/docs/design.md b/docs/design.md
index ca8d550..43a6975 100644
--- a/docs/design.md
+++ b/docs/design.md
@@ -475,7 +475,9 @@ finds a target another step of the same plan has already claimed, it takes the
next free name instead, because that path will hold the other step's output by
the time either runs, and displacing it would destroy that step's result. A
real run applies each directory before planning the next, so a later
-directory sees the earlier one's result on disk and its claims end with it.
+directory sees the earlier one's result on disk; of its claims only the paths
+it actually put files at carry over, so a later `overwrite` never displaces
+this run's own result.
A dry run (`-n`) applies nothing: its claim set spans every directory, so two
configured directories cannot show the same final name, but each directory is
otherwise planned as if no earlier one had been applied (a file the first