@@ -59,7 +59,7 @@ def partial_to_complete_sha_hex(self, partial_hexsha: str) -> bytes:
         :raise gitdb.exc.BadObject:
 
         :note:
-            Currently we only raise :class:`~gitdb.exc.BadObject` as git does not
+            Currently we only raise :exc:`~gitdb.exc.BadObject` as git does not
             communicate ambiguous objects separately.
         """
         try:
 
@@ -550,8 +550,8 @@ def resolve_blobs(self, iter_blobs: Iterator[Blob]) -> "IndexFile":
         This will effectively remove the index entries of the respective path at all
         non-null stages and add the given blob as new stage null blob.
 
-        For each path there may only be one blob, otherwise a :class:`ValueError` will
-        be raised claiming the path is already at stage 0.
+        For each path there may only be one blob, otherwise a :exc:`ValueError` will be
+        raised claiming the path is already at stage 0.
 
         :raise ValueError:
             If one of the blobs already existed at stage 0.
@@ -644,8 +644,8 @@ def _process_diff_args(
     def _to_relative_path(self, path: PathLike) -> PathLike:
         """
         :return:
-            Version of path relative to our git directory or raise :class:`ValueError`
-            if it is not within our git directory.
+            Version of path relative to our git directory or raise :exc:`ValueError` if
+            it is not within our git directory.
 
         :raise ValueError:
         """
@@ -1215,7 +1215,7 @@ def checkout(
         :param force:
             If ``True``, existing files will be overwritten even if they contain local
             modifications.
-            If ``False``, these will trigger a :class:`~git.exc.CheckoutError`.
+            If ``False``, these will trigger a :exc:`~git.exc.CheckoutError`.
 
         :param fprogress:
             See :meth:`IndexFile.add` for signature and explanation.
 
@@ -52,7 +52,7 @@ def mkhead(repo: "Repo", path: PathLike) -> "Head":
 
 def find_first_remote_branch(remotes: Sequence["Remote"], branch_name: str) -> "RemoteReference":
     """Find the remote branch matching the name of the given branch or raise
-    :class:`~git.exc.InvalidGitRepositoryError`."""
+    :exc:`~git.exc.InvalidGitRepositoryError`."""
     for remote in remotes:
         try:
             return remote.refs[branch_name]
 
@@ -100,8 +100,8 @@ def add(self, sha: bytes, mode: int, name: str, force: bool = False) -> "TreeMod
         """Add the given item to the tree.
 
         If an item with the given name already exists, nothing will be done, but a
-        :class:`ValueError` will be raised if the sha and mode of the existing item do
-        not match the one you add, unless `force` is ``True``.
+        :exc:`ValueError` will be raised if the sha and mode of the existing item do not
+        match the one you add, unless `force` is ``True``.
 
         :param sha:
             The 20 or 40 byte sha of the item to add.
 
@@ -247,7 +247,7 @@ def checkout(self, force: bool = False, **kwargs: Any) -> Union["HEAD", "Head"]:
 
         :param force:
             If ``True``, changes to the index and the working tree will be discarded.
-            If ``False``, :class:`~git.exc.GitCommandError` will be raised in that
+            If ``False``, :exc:`~git.exc.GitCommandError` will be raised in that
             situation.
 
         :param kwargs:
 
@@ -21,7 +21,7 @@
 
 
 def require_remote_ref_path(func: Callable[..., _T]) -> Callable[..., _T]:
-    """A decorator raising :class:`ValueError` if we are not a valid remote, based on the
+    """A decorator raising :exc:`ValueError` if we are not a valid remote, based on the
     path."""
 
     def wrapper(self: T_References, *args: Any) -> _T:
 
@@ -76,5 +76,5 @@ def delete(cls, repo: "Repo", *refs: "RemoteReference", **kwargs: Any) -> None:
 
     @classmethod
     def create(cls, *args: Any, **kwargs: Any) -> NoReturn:
-        """Raise :class:`TypeError`. Defined so the ``create`` method is disabled."""
+        """Raise :exc:`TypeError`. Defined so the ``create`` method is disabled."""
         raise TypeError("Cannot explicitly create remote references")
@@ -738,7 +738,7 @@ def create(
 
         :param force:
             If ``True``, force creation even if a symbolic reference with that name
-            already exists. Raise :class:`OSError` otherwise.
+            already exists. Raise :exc:`OSError` otherwise.
 
         :param logmsg:
             If not ``None``, the message to append to the reflog.
 
@@ -153,8 +153,8 @@ def name_to_object(repo: "Repo", name: str, return_ref: bool = False) -> Union[A
 
     :param return_ref:
         If ``True``, and name specifies a reference, we will return the reference
-        instead of the object. Otherwise it will raise :class:`~gitdb.exc.BadObject` or
-        :class:`~gitdb.exc.BadName`.
+        instead of the object. Otherwise it will raise :exc:`~gitdb.exc.BadObject` or
+        :exc:`~gitdb.exc.BadName`.
     """
     hexsha: Union[None, str, bytes] = None
 
 
@@ -190,7 +190,7 @@ def assert_never(inp: NoReturn, raise_error: bool = True, exc: Union[Exception,
         mismatch and cause a mypy error.
 
     :param raise_error:
-        If ``True``, will also raise :class:`ValueError` with a general "unhandled
+        If ``True``, will also raise :exc:`ValueError` with a general "unhandled
         literal" message, or the exception object passed as `exc`.
 
     :param exc: