[Python-Dev] cpython: Remove the old style [...] to denote optional args and show the defaults.

[Georg Brandl]

Am 08.11.2011 21:30, schrieb brian.curtin:
> http://hg.python.org/cpython/rev/60ae7979fec8
> changeset:   73463:60ae7979fec8
> user:        Brian Curtin <brian at python.org>
> date:        Tue Nov 08 14:30:02 2011 -0600
> summary:
>   Remove the old style [...] to denote optional args and show the defaults.
> 
> files:
>   Doc/library/os.rst |  12 ++++++------
>   1 files changed, 6 insertions(+), 6 deletions(-)
> 
> 
> diff --git a/Doc/library/os.rst b/Doc/library/os.rst
> --- a/Doc/library/os.rst
> +++ b/Doc/library/os.rst
> @@ -872,7 +872,7 @@
>     .. versionadded:: 3.3
>  
>  
> -.. function:: futimesat(dirfd, path[, (atime, mtime)])
> +.. function:: futimesat(dirfd, path, (atime, mtime)=None)
>  
>     Like :func:`utime` but if *path* is relative, it is taken as relative to *dirfd*.
>     If *path* is relative and *dirfd* is the special value :data:`AT_FDCWD`, then *path*

Hmm, while the [] are old style, they are still correct when the function
doesn't support kwargs.  Please revert.

(Also, the syntax ``(atime, mtime)=None`` would not be valid Python and at
is best confusing.)

Georg