cpython: e4aa34a7ca53 (original) (raw)

Mercurial > cpython

changeset 104565:e4aa34a7ca53 3.5

Issue #19795: Improved more markups of True/False. [#19795]

Serhiy Storchaka storchaka@gmail.com
date	Wed, 19 Oct 2016 18:30:05 +0300
parents	9ef78351d2e9
children	7b143d6834cf c445746d0846
files	Doc/c-api/number.rst Doc/library/asyncio-eventloop.rst Doc/library/asyncio-task.rst Doc/library/ctypes.rst Doc/library/functools.rst Doc/library/io.rst Doc/library/logging.rst Doc/library/quopri.rst Doc/library/ssl.rst Doc/library/subprocess.rst Doc/library/sysconfig.rst Doc/library/threading.rst Doc/whatsnew/2.7.rst Doc/whatsnew/3.3.rst
diffstat	14 files changed, 23 insertions(+), 23 deletions(-)[+] [-] Doc/c-api/number.rst 4 Doc/library/asyncio-eventloop.rst 4 Doc/library/asyncio-task.rst 4 Doc/library/ctypes.rst 6 Doc/library/functools.rst 2 Doc/library/io.rst 2 Doc/library/logging.rst 2 Doc/library/quopri.rst 2 Doc/library/ssl.rst 2 Doc/library/subprocess.rst 2 Doc/library/sysconfig.rst 2 Doc/library/threading.rst 2 Doc/whatsnew/2.7.rst 10 Doc/whatsnew/3.3.rst 2

line wrap: on

line diff

--- a/Doc/c-api/number.rst +++ b/Doc/c-api/number.rst @@ -278,5 +278,5 @@ Number Protocol .. c:function:: int PyIndex_Check(PyObject *o)

Returns True if o is an index integer (has the nb_index slot of the
tp_as_number structure filled in).

Returns 1 if o is an index integer (has the nb_index slot of the
tp_as_number structure filled in), and 0 otherwise.

--- a/Doc/library/asyncio-eventloop.rst +++ b/Doc/library/asyncio-eventloop.rst @@ -346,7 +346,7 @@ Creating connections * reuse_address tells the kernel to reuse a local socket in TIME_WAIT state, without waiting for its natural timeout to

expire. If not specified will automatically be set to True on[](#l2.7)

expire. If not specified will automatically be set to ``True`` on[](#l2.8)
UNIX.[](#l2.9)

* reuse_port tells the kernel to allow this endpoint to be bound to the @@ -424,7 +424,7 @@ Creating listening connections * reuse_address tells the kernel to reuse a local socket in TIME_WAIT state, without waiting for its natural timeout to

expire. If not specified will automatically be set to True on[](#l2.16)

expire. If not specified will automatically be set to ``True`` on[](#l2.17)
UNIX.[](#l2.18)

* reuse_port tells the kernel to allow this endpoint to be bound to the

--- a/Doc/library/asyncio-task.rst +++ b/Doc/library/asyncio-task.rst @@ -245,7 +245,7 @@ Future .. method:: done()

 Return True if the future is done.[](#l3.7)

 Return ``True`` if the future is done.[](#l3.8)

Done means either that a result / exception are available, or that the future was cancelled. @@ -562,7 +562,7 @@ Task functions All futures must share the same event loop. If all the tasks are done successfully, the returned future's result is the list of results (in the order of the original sequence, not necessarily the order of results

arrival). If return_exceptions is True, exceptions in the tasks are

arrival). If return_exceptions is true, exceptions in the tasks are treated the same as successful results, and gathered in the result list; otherwise, the first raised exception will be immediately propagated to the returned future.

--- a/Doc/library/ctypes.rst +++ b/Doc/library/ctypes.rst @@ -1358,7 +1358,7 @@ details, consult the :manpage:dlopen(3)[](#l4.3) ignored. On posix systems, RTLD_NOW is always added, and is not[](#l4.4) configurable.[](#l4.5) [](#l4.6) -The *use_errno* parameter, when set to True, enables a ctypes mechanism that[](#l4.7) +The *use_errno* parameter, when set to true, enables a ctypes mechanism that[](#l4.8) allows accessing the system :data:errno error number in a safe way.[](#l4.9) :mod:ctypes maintains a thread-local copy of the systems :data:errno[](#l4.10) variable; if you call foreign functions created with ``use_errno=True`` then the[](#l4.11) @@ -1369,7 +1369,7 @@ The function :func:ctypes.get_errno re[](#l4.12) copy, and the function :func:ctypes.set_errno changes the ctypes private copy[](#l4.13) to a new value and returns the former value.[](#l4.14) [](#l4.15) -The *use_last_error* parameter, when set to True, enables the same mechanism for[](#l4.16) +The *use_last_error* parameter, when set to true, enables the same mechanism for[](#l4.17) the Windows error code which is managed by the :func:GetLastError and[](#l4.18) :func:SetLastError Windows API functions; :func:ctypes.get_last_error and[](#l4.19) :func:ctypes.set_last_error` are used to request and change the ctypes private @@ -1579,7 +1579,7 @@ type and the argument types of the funct The returned function prototype creates functions that use the standard C calling convention. The function will release the GIL during the call. If

use_errno is set to True, the ctypes private copy of the system

use_errno is set to true, the ctypes private copy of the system :data:errno variable is exchanged with the real :data:errno value before and after the call; use_last_error does the same for the Windows error code.

--- a/Doc/library/functools.rst +++ b/Doc/library/functools.rst @@ -56,7 +56,7 @@ The :mod:functools module defines the grow without bound. The LRU feature performs best when maxsize is a power-of-two.

If typed is set to True, function arguments of different types will be

If typed is set to true, function arguments of different types will be cached separately. For example, f(3) and f(3.0) will be treated as distinct calls with distinct results.

--- a/Doc/library/io.rst +++ b/Doc/library/io.rst @@ -537,7 +537,7 @@ Raw File I/O The name can be one of two things: * a character string or :class:bytes object representing the path to the

file which will be opened. In this case closefd must be True (the default)[](#l6.7)

```
file which will be opened. In this case closefd must be ``True`` (the default)[](#l6.8)
otherwise an error will be raised.[](#l6.9)
```
- an integer representing the number of an existing OS-level file descriptor to which the resulting :class:FileIO object will give access. When the

--- a/Doc/library/logging.rst +++ b/Doc/library/logging.rst @@ -318,7 +318,7 @@ is the module's name in the Python packa looking for handlers in this logger and its parents in the logger hierarchy. Returns True if a handler was found, else False. The method stops searching up the hierarchy whenever a logger with the 'propagate' attribute set to

False is found - that will be the last logger which is checked for the

false is found - that will be the last logger which is checked for the existence of handlers. .. versionadded:: 3.2

--- a/Doc/library/quopri.rst +++ b/Doc/library/quopri.rst @@ -52,7 +52,7 @@ sending a graphics file. Like :func:encode, except that it accepts a source :class:bytes and returns the corresponding encoded :class:bytes. By default, it sends a

False value to quotetabs parameter of the :func:encode function.

False value to quotetabs parameter of the :func:encode function.

--- a/Doc/library/ssl.rst +++ b/Doc/library/ssl.rst @@ -1387,7 +1387,7 @@ to speed up repeated connections from th This setting doesn't apply to client sockets. You can also use the :data:OP_SINGLE_ECDH_USE option to further improve security.

This method is not available if :data:HAS_ECDH is False.

This method is not available if :data:HAS_ECDH is False. .. versionadded:: 3.3

--- a/Doc/library/subprocess.rst +++ b/Doc/library/subprocess.rst @@ -64,7 +64,7 @@ compatibility with older versions, see t is automatically created with stdin=PIPE, and the stdin argument may not be used as well.

If check is True, and the process exits with a non-zero exit code, a

If check is true, and the process exits with a non-zero exit code, a :exc:CalledProcessError exception will be raised. Attributes of that exception hold the arguments, the exit code, and stdout and stderr if they were captured.

--- a/Doc/library/sysconfig.rst +++ b/Doc/library/sysconfig.rst @@ -152,7 +152,7 @@ identifier. Python currently uses eight If vars is provided, it must be a dictionary of variables that will update the dictionary used to expand the paths.

If expand is set to False, the paths will not be expanded.

If expand is set to false, the paths will not be expanded. If scheme is not an existing scheme, :func:get_paths will raise a :exc:KeyError.

--- a/Doc/library/threading.rst +++ b/Doc/library/threading.rst @@ -615,7 +615,7 @@ item to the buffer only needs to wake up .. method:: wait_for(predicate, timeout=None)

 Wait until a condition evaluates to True.  *predicate* should be a[](#l12.7)

 Wait until a condition evaluates to true.  *predicate* should be a[](#l12.8)
 callable which result will be interpreted as a boolean value.[](#l12.9)
 A *timeout* may be provided giving the maximum time to wait.[](#l12.10)

--- a/Doc/whatsnew/2.7.rst +++ b/Doc/whatsnew/2.7.rst @@ -245,8 +245,8 @@ Deleting an entry and reinserting it wil [('first', 1), ('third', 3), ('second', 5)] The :meth:~collections.OrderedDict.popitem method has an optional last -argument that defaults to True. If last is True, the most recently -added key is returned and removed; if it's False, the +argument that defaults to True. If last is true, the most recently +added key is returned and removed; if it's false, the oldest key is selected:: >>> od = OrderedDict([(x,0) for x in range(20)]) @@ -1518,7 +1518,7 @@ changes, or look through the Subversion

The :mod:SocketServer module's :class:~SocketServer.TCPServer class now supports socket timeouts and disabling the Nagle algorithm. The :attr:~SocketServer.TCPServer.disable_nagle_algorithm class attribute

defaults to False; if overridden to be True,

defaults to False; if overridden to be true, new request connections will have the TCP_NODELAY option set to prevent buffering many small sends into a single TCP packet. The :attr:~SocketServer.BaseServer.timeout class attribute can hold @@ -1879,7 +1879,7 @@ The error messages for :meth:~unittest.[](#l13.23) :meth:~~unittest.TestCase.assertTrue, and :meth:~~unittest.TestCase.assertFalse[](#l13.24) failures now provide more information. If you set the[](#l13.25) :attr:~~unittest.TestCase.longMessage attribute of your :class:~~unittest.TestCase classes to[](#l13.26) -True, both the standard error message and any additional message you[](#l13.27) +true, both the standard error message and any additional message you[](#l13.28) provide will be printed for failures. (Added by Michael Foord; :issue:5663.)[](#l13.29) [](#l13.30) The :meth:unittest.TestCase.assertRaises method now[](#l13.31) @@ -1986,7 +1986,7 @@ GvR worked on merging them into Python's[](#l13.32) sequence comparison methods do.[](#l13.33) [](#l13.34) :func:unittest.main now takes an optional ``exit`` argument. If[](#l13.35) -False, :func:unittest.main doesn't call :func:sys.exit, allowing[](#l13.36) +false, :func:~~unittest.main doesn't call :func:sys.exit, allowing[](#l13.37) :func:~~unittest.main to be used from the interactive interpreter.[](#l13.38) (Contributed by J. Pablo Fernández; :issue:3379`.)

--- a/Doc/whatsnew/3.3.rst +++ b/Doc/whatsnew/3.3.rst @@ -1742,7 +1742,7 @@ sched -----

:meth:~sched.scheduler.run now accepts a blocking parameter which when

set to False makes the method execute the scheduled events due to expire

set to false makes the method execute the scheduled events due to expire soonest (if any) and then return immediately. This is useful in case you want to use the :class:~sched.scheduler in non-blocking applications. (Contributed by Giampaolo Rodolà in :issue:13449.)