The path.home comment spelled out the relative-path resolution
mechanism (subvolid=5, openat2 with RESOLVE_BENEATH | RESOLVE_NO_SYMLINKS,
Linux 5.6+ fallback to openat). docs/config-file.md already documents
the symlink-walk and openat2 behaviour in full.
Keep the absolute-vs-relative semantics and the default inline; defer
the resolution mechanics to the doc. path.reports is left as-is: its
comment is hard constraints, not background.
Assisted-by: Claude-Code:claude-opus-4-8
Signed-off-by: Zygo Blaxell <bees@furryterror.org>
[path]
- # Directory for hash table and crawl checkpoints (legacy `$BEESHOME`
- # environment variable).
- #
- # Absolute paths (beginning with '/') are opened directly.
- # Relative paths are resolved from the root of the target filesystem
- # (subvolid=5) using openat2(RESOLVE_BENEATH | RESOLVE_NO_SYMLINKS)
- # on kernels that support it (Linux 5.6+), falling back to openat on
- # older kernels.
+ # Directory for hash table and crawl checkpoints (legacy `$BEESHOME`).
+ # Absolute paths open directly; relative paths resolve from the target
+ # filesystem root (subvolid=5). See docs/config-file.md for the
+ # symlink / openat2 resolution rules.
home = .beeshome
# Base directory for relative report filenames.