Further expand refresh methods' docstrings

EliahKagan · EliahKagan · commit 65657421014e · 2024-03-01T14:50:19.000-05:00
diff --git a/git/cmd.py b/git/cmd.py
@@ -389,9 +389,12 @@ def __setstate__(self, d: Dict[str, Any]) -> None:
 
     @classmethod
     def refresh(cls, path: Union[None, PathLike] = None) -> bool:
-        """This gets called by the :func:`git.refresh` function.
+        """Update information about the git executable :class:`Git` objects will use.
 
-        See the top level ``__init__.py``.
+        Called by the :func:`git.refresh` function in the top level ``__init__``.
+
+        This gets called by the :func:`git.refresh` function in the top-level
+        ``__init__``.
 
         :param path:
             Optional path to the git executable. If not absolute, it is resolved
diff --git a/git/remote.py b/git/remote.py
@@ -338,9 +338,10 @@ class FetchInfo(IterableObj):
 
     @classmethod
     def refresh(cls) -> Literal[True]:
-        """This gets called by the :func:`git.refresh` function.
+        """Update information about which ``git fetch`` flags are supported by the git
+        executable being used.
 
-        See the top level ``__init__.py``.
+        Called by the :func:`git.refresh` function in the top level ``__init__``.
         """
         # Clear the old values in _flag_map.
         with contextlib.suppress(KeyError):
