gh-134082: Modernize docstrings in ArgumentParser.parse_known_intermixed_args

Author: donBarbos

Lib/argparse.py

@@ -2562,13 +2562,13 @@ def parse_intermixed_args(self, args=None, namespace=None):
         return args
 
     def parse_known_intermixed_args(self, args=None, namespace=None):
-        # returns a namespace and list of extras
-        #
-        # positional can be freely intermixed with optionals.  optionals are
-        # first parsed with all positional arguments deactivated.  The 'extras'
-        # are then parsed.  If the parser definition is incompatible with the
-        # intermixed assumptions (e.g. use of REMAINDER, subparsers) a
-        # TypeError is raised.
+        """
+        Return a namespace and list of extras positional can be freely
+        intermixed with optionals.  optionals are first parsed with all
+        positional arguments deactivated.  The 'extras' are then parsed.
+        If the parser definition is incompatible with the intermixed
+        assumptions (e.g. use of REMAINDER, subparsers) a TypeError is raised.
+        """
 
         positionals = self._get_positional_actions()
         a = [action for action in positionals