]> git.hungrycats.org Git - bees/commitdiff
bees-config-v1: trim [path] home comment to option reference
authorZygo Blaxell <bees@furryterror.org>
Tue, 9 Jun 2026 00:00:28 +0000 (20:00 -0400)
committerZygo Blaxell <bees@furryterror.org>
Sat, 5 Sep 2026 04:03:58 +0000 (00:03 -0400)
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>
src/bees-config-v1.cc

index 6d33929d3f6e008b89351ed6b56f1aa848e31c54..a06d65fdb11569ef4e2ef290377fec82abf74108 100644 (file)
@@ -100,14 +100,10 @@ static const char bees_config_v1[] = R"--v1-config--(
 
 [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.