From 3c24764e0b7ac47a06b6e6a7ff1277a6f3d22a3c Mon Sep 17 00:00:00 2001
From: Isaac Corbrey <icorbrey@gmail.com>
Date: Wed, 9 Jul 2025 09:10:21 -0400
Subject: [PATCH] jj-absorb: clarify move semantics (#17165)

---
 pages/common/jj-absorb.md | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/pages/common/jj-absorb.md b/pages/common/jj-absorb.md
index 9fad7bd6ed..337b6ee02e 100644
--- a/pages/common/jj-absorb.md
+++ b/pages/common/jj-absorb.md
@@ -1,9 +1,10 @@
 # jj absorb
 
 > Split changes in the source revision and move each change to the closest mutable ancestor where the corresponding lines were modified last.
+> Changes that have zero or multiple matching regions in ancestral revisions won't be moved.
 > More information: <https://jj-vcs.github.io/jj/latest/cli-reference/#jj-absorb>.
 
-- Move all changes from a revision to other revisions automatically:
+- Move all eligible and unambiguous changes from a revision to other revisions automatically:
 
 `jj absorb {{[-f|--from]}} {{revset}} {{[-t|--into]}} {{revsets}}`