Clarify cache pruning
- SHA
c1d105c1e30c466733f2005da3b8526d73cbd3ee- Parents
-
52c34f0 - Tree
3cab8ea
c1d105c
c1d105c1e30c466733f2005da3b8526d73cbd3ee52c34f0
3cab8ea| Status | File | + | - |
|---|---|---|---|
| M |
README.md
|
2 | 1 |
README.mdmodified@@ -103,7 +103,8 @@ Current semantics: | ||
| 103 | 103 | - `read_cache_text()` and `remove_cache_entry()` do not create missing cache roots as a side effect |
| 104 | 104 | - `remove_cache_entry()` removes stored cache files by key while leaving the cache root in place |
| 105 | 105 | - successful removals clear cached metadata on the returned entry |
| 106 | -- `prune_stale_cache()` prunes only the resolved namespace root, treats missing roots as a no-op, and removes emptied shard directories as it goes | |
| 106 | +- non-file entry paths are rejected instead of being treated as normal cache files | |
| 107 | +- `prune_stale_cache()` prunes only the resolved namespace root, requires `namespace` when pruning an explicit `root_dir`, treats missing roots as a no-op, and removes emptied shard directories as it goes | |
| 107 | 108 | |
| 108 | 109 | ## Build And Test |
| 109 | 110 | |