Add overloads to sphinx.pyi for better type hints

Author: mrhx01

stubs/Deprecated/deprecated/sphinx.pyi

@@ -1,5 +1,5 @@
 from collections.abc import Callable
-from typing import Any, Literal, TypeVar
+from typing import Any, Literal, TypeVar, overload
 
 from .classic import ClassicAdapter, _Actions
 
@@ -17,11 +17,26 @@ class SphinxAdapter(ClassicAdapter):
         reason: str = "",
         version: str = "",
         action: _Actions | None = None,
-        category: type[Warning] = ...,
+        category: type[Warning] = DeprecationWarning,
         extra_stacklevel: int = 0,
         line_length: int = 70,
     ) -> None: ...
+    @overload
+    def __call__(self, wrapped: _F) -> _F: ...
+    
+    @overload
     def __call__(self, wrapped: _F) -> Callable[[_F], _F]: ...
+    """
+        :param wrapped: Wrapped class or function.
+
+        :return: the decorated class or function.
+    """
+    def get_deprecated_msg(self, wrapped: _F, instance: Any) -> str: ...
+    """
+        :param wrapped: Wrapped class or function.
+        
+        :param instance: The object to which the wrapped function was bound when it was called.
+    """
 
 def versionadded(reason: str = "", version: str = "", line_length: int = 70) -> Callable[[_F], _F]: ...
 def versionchanged(reason: str = "", version: str = "", line_length: int = 70) -> Callable[[_F], _F]: ...