From c6efc8c3e9b40255d7a03d20e7be18b68cf42cfb Mon Sep 17 00:00:00 2001
From: Ajay Bhalekar <bhalekarajay61@gmail.com>
Date: Sun, 1 Feb 2026 18:13:58 +0530
Subject: [PATCH] Clarify TODOs in is_hidden docstring

---
 beets/util/hidden.py | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/beets/util/hidden.py b/beets/util/hidden.py
index 0a71c91fd..d4136a74a 100644
--- a/beets/util/hidden.py
+++ b/beets/util/hidden.py
@@ -25,6 +25,9 @@ from pathlib import Path
 def is_hidden(path: bytes | Path) -> bool:
     """
     Determine whether the given path is treated as a 'hidden file' by the OS.
+
+    Note: A platform-specific check is performed on each invocation. Bytes
+    inputs are supported for backward compatibility.
     """
 
     if isinstance(path, bytes):