update name and type from function to callable

Author: HH-MWB

pandas/util/_decorators.py

@@ -245,7 +245,7 @@ def wrapper(*args, **kwargs) -> Callable[..., Any]:
     return decorate
 
 
-def doc(*args: Union[str, Callable], **kwargs: str) -> Callable[[F], F]:
+def doc(*args: Union[str, Callable], **kwargs: str) -> Callable[[Callable], Callable]:
     """
     A decorator take docstring templates, concatenate them and perform string
     substitution on it.
@@ -265,11 +265,11 @@ def doc(*args: Union[str, Callable], **kwargs: str) -> Callable[[F], F]:
         The string which would be used to format docstring template.
     """
 
-    def decorator(func: F) -> F:
+    def decorator(call: Callable) -> Callable:
         # collecting docstring and docstring templates
         docstring_components: List[Union[str, Callable]] = []
-        if func.__doc__:
-            docstring_components.append(dedent(func.__doc__))
+        if call.__doc__:
+            docstring_components.append(dedent(call.__doc__))
 
         for appender in args:
             if hasattr(appender, "_docstring_components"):
@@ -280,7 +280,7 @@ def decorator(func: F) -> F:
                 docstring_components.append(appender)
 
         # formatting templates and concatenating docstring
-        func.__doc__ = "".join(
+        call.__doc__ = "".join(
             [
                 component.format(**kwargs)
                 if isinstance(component, str)
@@ -290,7 +290,7 @@ def decorator(func: F) -> F:
         )
 
         func._docstring_components = docstring_components  # type: ignore
-        return func
+        return call
 
     return decorator