summaryrefslogtreecommitdiffstats
path: root/docs/USERGUIDE.md
diff options
context:
space:
mode:
authorChristophe Besson <cbesson@gmail.com>2026-10-08 01:11:38 +0200
committerChristophe Besson <cbesson@gmail.com>2026-10-08 01:11:38 +0200
commited0c680790950354f15fb5835e1d7b213efa1bf8 (patch)
tree59af376652005a0b02c95945c1df6044882a94e5 /docs/USERGUIDE.md
parent4c8e4fb8b8fcd3f78bf4e3e736a058c351aac973 (diff)
downloadmeshbay-ed0c680790950354f15fb5835e1d7b213efa1bf8.tar.gz
fix(node): name a root after its drive when its basename is taken
Two drives with a folder of the same name made the second add fail, and no screen could supply another name. add_root now names it "Name (H)" or "Name (parent)"; a name the operator typed is still refused on a clash. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Diffstat (limited to 'docs/USERGUIDE.md')
-rw-r--r--docs/USERGUIDE.md6
1 files changed, 4 insertions, 2 deletions
diff --git a/docs/USERGUIDE.md b/docs/USERGUIDE.md
index ea81c76..adca9e3 100644
--- a/docs/USERGUIDE.md
+++ b/docs/USERGUIDE.md
@@ -504,8 +504,10 @@ meshbay-node root remove Films
Rules that will bite you if you do not know them:
-- **Two roots cannot share a basename**, even on different drives. `/mnt/a/Films`
- and `/mnt/b/Films` is refused; name one of them explicitly.
+- **Two roots cannot share a name**, even on different drives. When you add
+ `/mnt/b/Films` beside `/mnt/a/Films`, the second one is called `Films (b)`
+ (on Windows, `H:\Films` beside `G:\Films` becomes `Films (H)`). A name you
+ give with `--name` that is already taken is refused.
- **No root inside another.** The same bytes would be indexed twice under two
identities.
- **Renaming a root rewrites every path under it**, so it is an explicit act,