Update docs.

serhiy-storchaka · Jun 5, 2019 · Mar 29, 2019 · Apr 1, 2019 · Apr 1, 2019 · May 31, 2019
commit 7ae4f3990212a06c3fc16f4674070795a8bd3829
diff --git a/Doc/library/bdb.rst b/Doc/library/bdb.rst
@@ -343,7 +343,7 @@ The :mod:`bdb` module also defines two classes:
 
       For backwards compatibility.  Calls the :meth:`run` method.
 
-   .. method:: runcall(func, *args, **kwds)
+   .. method:: runcall(func, /, *args, **kwds)
 
       Debug a single function call, and return its result.
 

diff --git a/Doc/library/concurrent.futures.rst b/Doc/library/concurrent.futures.rst
@@ -28,7 +28,7 @@ Executor Objects
    An abstract class that provides methods to execute calls asynchronously.  It
    should not be used directly, but through its concrete subclasses.
 
-    .. method:: submit(fn, *args, **kwargs)
+    .. method:: submit(fn, /, *args, **kwargs)
 
        Schedules the callable, *fn*, to be executed as ``fn(*args **kwargs)``
        and returns a :class:`Future` object representing the execution of the

diff --git a/Doc/library/contextlib.rst b/Doc/library/contextlib.rst
@@ -416,7 +416,7 @@ Functions and classes provided:
       The passed in object is returned from the function, allowing this
       method to be used as a function decorator.
 
-   .. method:: callback(callback, *args, **kwds)
+   .. method:: callback(callback, /, *args, **kwds)
 
       Accepts an arbitrary callback function and arguments and adds it to
       the callback stack.
@@ -473,7 +473,7 @@ Functions and classes provided:
       Similar to :meth:`push` but expects either an asynchronous context manager
       or a coroutine function.
 
-   .. method:: push_async_callback(callback, *args, **kwds)
+   .. method:: push_async_callback(callback, /, *args, **kwds)
 
       Similar to :meth:`callback` but expects a coroutine function.
 

diff --git a/Doc/library/curses.rst b/Doc/library/curses.rst
@@ -656,7 +656,7 @@ The module :mod:`curses` defines the following functions:
    foreground color on the default background.
 
 
-.. function:: wrapper(func, ...)
+.. function:: wrapper(func, /, *args, **kwargs)
 
    Initialize curses and call another callable object, *func*, which should be the
    rest of your curses-using application.  If the application raises an exception,

diff --git a/Doc/library/functools.rst b/Doc/library/functools.rst
@@ -252,7 +252,7 @@ The :mod:`functools` module defines the following functions:
       18
 
 
-.. class:: partialmethod(func, *args, **keywords)
+.. class:: partialmethod(func, /, *args, **keywords)
 
    Return a new :class:`partialmethod` descriptor which behaves
    like :class:`partial` except that it is designed to be used as a method

diff --git a/Doc/library/profile.rst b/Doc/library/profile.rst
@@ -309,7 +309,7 @@ functions:
       Profile the cmd via :func:`exec` with the specified global and
       local environment.
 
-   .. method:: runcall(func, *args, **kwargs)
+   .. method:: runcall(func, /, *args, **kwargs)
 
       Profile ``func(*args, **kwargs)``
 

diff --git a/Doc/library/trace.rst b/Doc/library/trace.rst
@@ -166,7 +166,7 @@ Programmatic Interface
        environments.  If not defined, *globals* and *locals* default to empty
        dictionaries.
 
-    .. method:: runfunc(func, *args, **kwds)
+    .. method:: runfunc(func, /, *args, **kwds)
 
        Call *func* with the given arguments under control of the :class:`Trace`
        object with the current tracing parameters.

diff --git a/Doc/library/unittest.rst b/Doc/library/unittest.rst
@@ -1427,7 +1427,7 @@ Test cases
          :class:`TextTestResult` in Python 3.2.
 
 
-   .. method:: addCleanup(function, *args, **kwargs)
+   .. method:: addCleanup(function, /, *args, **kwargs)
 
       Add a function to be called after :meth:`tearDown` to cleanup resources
       used during the test. Functions will be called in reverse order to the

diff --git a/Doc/library/weakref.rst b/Doc/library/weakref.rst
@@ -240,7 +240,7 @@ objects.
 
    .. versionadded:: 3.4
 
-.. class:: finalize(obj, func, *args, **kwargs)
+.. class:: finalize(obj, func, /, *args, **kwargs)
 
    Return a callable finalizer object which will be called when *obj*
    is garbage collected. Unlike an ordinary weak reference, a finalizer