Deprecate passing ``doc`` to ``PartialFunction`` (#1456)

Co-authored-by: Marc Mueller <30130371+cdce8p@users.noreply.github.com>

1 files changed, 5 insertions, 2 deletions

diff --git a/astroid/objects.py b/astroid/objects.py
index 4b387c28..37ab87d3 100644
--- a/astroid/objects.py
+++ b/astroid/objects.py
@@ -25,7 +25,7 @@ leads to an inferred FrozenSet:
 import sys
 from typing import TYPE_CHECKING
 
-from astroid import bases, util
+from astroid import bases, decorators, util
 from astroid.exceptions import (
     AttributeInferenceError,
     InferenceError,
@@ -266,11 +266,14 @@ class DictValues(bases.Proxy):
 class PartialFunction(scoped_nodes.FunctionDef):
     """A class representing partial function obtained via functools.partial"""
 
+    @decorators.deprecate_arguments(doc="Use the postinit arg 'doc_node' instead")
     def __init__(
         self, call, name=None, doc=None, lineno=None, col_offset=None, parent=None
     ):
         # TODO: Pass end_lineno and end_col_offset as well
-        super().__init__(name, doc, lineno, col_offset, parent=None)
+        super().__init__(name, lineno=lineno, col_offset=col_offset, parent=None)
+        # Assigned directly to prevent triggering the DeprecationWarning.
+        self._doc = doc
         # A typical FunctionDef automatically adds its name to the parent scope,
         # but a partial should not, so defer setting parent until after init
         self.parent = parent