Tweak parameter names for fcntl module

[storchaka_gmail.com]

https://bugs.python.org/review/22832/diff/14034/Doc/library/fcntl.rst
File Doc/library/fcntl.rst (right):

https://bugs.python.org/review/22832/diff/14034/Doc/library/fcntl.rst#newcode37
Doc/library/fcntl.rst:37: header files.  The argument *arg* is optional, and
defaults to the integer
May be change signature to Python-compatible "fcntl(fd, cmd[, arg=0)" and remove
sentences about default values?

https://bugs.python.org/review/22832/diff/14034/Doc/library/fcntl.rst#newcode38
Doc/library/fcntl.rst:38: value ``0``.  When present, it can either be an
integer value, or a string.
This is Python 2 legacy. Should be "bytes". Strings are supported too, but we
should deprecate this.

https://bugs.python.org/review/22832/diff/14034/Doc/library/fcntl.rst#newcode41
Doc/library/fcntl.rst:41: a string it represents a binary structure, e.g.
created by :func:`struct.pack`.
bytes

https://bugs.python.org/review/22832/diff/14034/Doc/library/fcntl.rst#newcode44
Doc/library/fcntl.rst:44: of the buffer, converted to a string object.  The
length of the returned string
Return value is bytes instance.

https://bugs.python.org/review/22832/diff/14034/Doc/library/fcntl.rst#newcode58
Doc/library/fcntl.rst:58: The op parameter is limited to values that can fit in
32-bits.
"The op parameter" -- not updated.

https://bugs.python.org/review/22832/diff/14034/Doc/library/fcntl.rst#newcode63
Doc/library/fcntl.rst:63: The parameter *arg* can be one of an integer, absent
(treated identically to the
Same as above about default value.

https://bugs.python.org/review/22832/diff/14034/Doc/library/fcntl.rst#newcode64
Doc/library/fcntl.rst:64: integer ``0``), an object supporting the read-only
buffer interface (most likely
"(most likely a plain Python string)" -- incorrect. Should be "(like
:class:`bytes`)".

https://bugs.python.org/review/22832/diff/14034/Doc/library/fcntl.rst#newcode65
Doc/library/fcntl.rst:65: a plain Python string) or an object supporting the
read-write buffer interface.
May be add "(like :class:`bytearray`)".

[Martin Panter]

https://bugs.python.org/review/22832/diff/14056/Modules/fcntlmodule.c
File Modules/fcntlmodule.c (right):

https://bugs.python.org/review/22832/diff/14056/Modules/fcntlmodule.c#newcode43
Modules/fcntlmodule.c:43: arg: object = NULL
I’m not familiar with this Clinic stuff, but is there away to make the default
appear as arg=0 rather than arg=None?

https://bugs.python.org/review/22832/diff/14056/Modules/fcntlmodule.c#newcode115
Modules/fcntlmodule.c:115: arg as ob_arg: object = NULL
Would be nice to change this to arg=0 by default too

https://bugs.python.org/review/22832/diff/14056/Modules/fcntlmodule.c#newcode332
Modules/fcntlmodule.c:332: start as startobj: object = NULL
Again the comment about len and start being documented as integers

[storchaka_gmail.com]

https://bugs.python.org/review/22832/diff/14056/Modules/fcntlmodule.c
File Modules/fcntlmodule.c (right):

https://bugs.python.org/review/22832/diff/14056/Modules/fcntlmodule.c#newcode43
Modules/fcntlmodule.c:43: arg: object = NULL
On 2015/03/20 03:24:07, vadmium wrote:
> I’m not familiar with this Clinic stuff, but is there away to make the default
> appear as arg=0 rather than arg=None?

Yes, it is possible and it would be good.

[ashkop]

http://bugs.python.org/review/22832/diff/14056/Modules/fcntlmodule.c
File Modules/fcntlmodule.c (right):

http://bugs.python.org/review/22832/diff/14056/Modules/fcntlmodule.c#newcode43
Modules/fcntlmodule.c:43: arg: object = NULL
On 2015/03/20 03:24:07, vadmium wrote:
> I’m not familiar with this Clinic stuff, but is there away to make the default
> appear as arg=0 rather than arg=None?

Done.

http://bugs.python.org/review/22832/diff/14056/Modules/fcntlmodule.c#newcode115
Modules/fcntlmodule.c:115: arg as ob_arg: object = NULL
On 2015/03/20 03:24:07, vadmium wrote:
> Would be nice to change this to arg=0 by default too

Done.

http://bugs.python.org/review/22832/diff/14056/Modules/fcntlmodule.c#newcode332
Modules/fcntlmodule.c:332: start as startobj: object = NULL
On 2015/03/20 03:24:07, vadmium wrote:
> Again the comment about len and start being documented as integers

Done.

[storchaka_gmail.com]

https://bugs.python.org/review/22832/diff/14277/Doc/library/fcntl.rst
File Doc/library/fcntl.rst (right):

https://bugs.python.org/review/22832/diff/14277/Doc/library/fcntl.rst#newcode31
Doc/library/fcntl.rst:31: .. function:: fcntl(fd, cmd[, arg=0])
Brackets are not needed longer.

https://bugs.python.org/review/22832/diff/14277/Doc/library/fcntl.rst#newcode53
Doc/library/fcntl.rst:53: .. function:: ioctl(fd, request[, arg=0[,
mutate_flag=True]])
And here too.

https://bugs.python.org/review/22832/diff/14277/Doc/library/fcntl.rst#newcode108
Doc/library/fcntl.rst:108: .. function:: lockf(fd, cmd, [len=0, [start=0,
[whence=0]]])
And here too.