Rewrite post_clear_cache note

EliahKagan · EliahKagan · commit ca2ab6137b2c · 2024-02-26T14:58:16.000-05:00
So that it just describes the current situation, rather than suggesting a future direction for IndexFile. This is for #1847.
diff --git a/git/index/util.py b/git/index/util.py
@@ -70,8 +70,8 @@ def post_clear_cache(func: Callable[..., _T]) -> Callable[..., _T]:
     to allow it to be lazily reread later.
 
     :note:
-        This decorator will not be required once all functions are implemented natively
-        which in fact is possible, but probably not feasible performance wise.
+        This decorator is required because not all functions related to
+        :class:`~git.index.base.IndexFile` are implemented natively.
     """
 
     @wraps(func)
