Skip to content

Commit bbbca89

Browse files
committed
Deploying to gh-pages from @ c07ea72 🚀
1 parent bb0df45 commit bbbca89

File tree

547 files changed

+5880
-5319
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

547 files changed

+5880
-5319
lines changed

.buildinfo

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
11
# Sphinx build info version 1
22
# This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done.
3-
config: af2eae3e2ebaf3cd5e3156f81a342668
3+
config: c1095522e9f73f1efe558ee151e1aca8
44
tags: 645f666f9bcd5a90fca523b33c5a78b7

_sources/c-api/code.rst.txt

Lines changed: 6 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -30,9 +30,13 @@ bound into a function.
3030
Return true if *co* is a :ref:`code object <code-objects>`.
3131
This function always succeeds.
3232
33-
.. c:function:: int PyCode_GetNumFree(PyCodeObject *co)
33+
.. c:function:: Py_ssize_t PyCode_GetNumFree(PyCodeObject *co)
3434
35-
Return the number of free variables in *co*.
35+
Return the number of free variables in a code object.
36+
37+
.. c:function:: int PyCode_GetFirstFree(PyCodeObject *co)
38+
39+
Return the position of the first free variable in a code object.
3640
3741
.. c:function:: PyCodeObject* PyUnstable_Code_New(int argcount, int kwonlyargcount, int nlocals, int stacksize, int flags, PyObject *code, PyObject *consts, PyObject *names, PyObject *varnames, PyObject *freevars, PyObject *cellvars, PyObject *filename, PyObject *name, PyObject *qualname, int firstlineno, PyObject *linetable, PyObject *exceptiontable)
3842

_sources/howto/gdb_helpers.rst.txt

Lines changed: 449 additions & 0 deletions
Large diffs are not rendered by default.

_sources/howto/index.rst.txt

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -13,10 +13,10 @@ Currently, the HOWTOs are:
1313
.. toctree::
1414
:maxdepth: 1
1515

16-
pyporting.rst
1716
cporting.rst
1817
curses.rst
1918
descriptor.rst
19+
gdb_helpers.rst
2020
enum.rst
2121
functional.rst
2222
logging.rst

_sources/howto/pyporting.rst.txt

Lines changed: 19 additions & 410 deletions
Large diffs are not rendered by default.

_sources/library/array.rst.txt

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -273,4 +273,3 @@ Examples::
273273

274274
`NumPy <https://numpy.org/>`_
275275
The NumPy package defines another array type.
276-

_sources/library/ctypes.rst.txt

Lines changed: 0 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1113,10 +1113,6 @@ api::
11131113
>>> print(hex(version.value))
11141114
0x30c00a0
11151115

1116-
If the interpreter would have been started with :option:`-O`, the sample would
1117-
have printed ``c_long(1)``, or ``c_long(2)`` if :option:`-OO` would have been
1118-
specified.
1119-
11201116
An extended example which also demonstrates the use of pointers accesses the
11211117
:c:data:`PyImport_FrozenModules` pointer exported by Python.
11221118

_sources/library/fcntl.rst.txt

Lines changed: 26 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -13,10 +13,10 @@
1313

1414
----------------
1515

16-
This module performs file control and I/O control on file descriptors. It is an
17-
interface to the :c:func:`fcntl` and :c:func:`ioctl` Unix routines. For a
18-
complete description of these calls, see :manpage:`fcntl(2)` and
19-
:manpage:`ioctl(2)` Unix manual pages.
16+
This module performs file and I/O control on file descriptors. It is an
17+
interface to the :c:func:`fcntl` and :c:func:`ioctl` Unix routines.
18+
See the :manpage:`fcntl(2)` and :manpage:`ioctl(2)` Unix manual pages
19+
for full details.
2020

2121
.. availability:: Unix, not Emscripten, not WASI.
2222

@@ -80,7 +80,7 @@ The module defines the following functions:
8080
most likely to result in a segmentation violation or a more subtle data
8181
corruption.
8282

83-
If the :c:func:`fcntl` fails, an :exc:`OSError` is raised.
83+
If the :c:func:`fcntl` call fails, an :exc:`OSError` is raised.
8484

8585
.. audit-event:: fcntl.fcntl fd,cmd,arg fcntl.fcntl
8686

@@ -118,7 +118,7 @@ The module defines the following functions:
118118
buffer 1024 bytes long which is then passed to :func:`ioctl` and copied back
119119
into the supplied buffer.
120120

121-
If the :c:func:`ioctl` fails, an :exc:`OSError` exception is raised.
121+
If the :c:func:`ioctl` call fails, an :exc:`OSError` exception is raised.
122122

123123
An example::
124124

@@ -143,7 +143,7 @@ The module defines the following functions:
143143
:manpage:`flock(2)` for details. (On some systems, this function is emulated
144144
using :c:func:`fcntl`.)
145145

146-
If the :c:func:`flock` fails, an :exc:`OSError` exception is raised.
146+
If the :c:func:`flock` call fails, an :exc:`OSError` exception is raised.
147147

148148
.. audit-event:: fcntl.flock fd,operation fcntl.flock
149149

@@ -155,17 +155,28 @@ The module defines the following functions:
155155
method are accepted as well) of the file to lock or unlock, and *cmd*
156156
is one of the following values:
157157

158-
* :const:`LOCK_UN` -- unlock
159-
* :const:`LOCK_SH` -- acquire a shared lock
160-
* :const:`LOCK_EX` -- acquire an exclusive lock
158+
.. data:: LOCK_UN
161159

162-
When *cmd* is :const:`LOCK_SH` or :const:`LOCK_EX`, it can also be
163-
bitwise ORed with :const:`LOCK_NB` to avoid blocking on lock acquisition.
164-
If :const:`LOCK_NB` is used and the lock cannot be acquired, an
160+
Release an existing lock.
161+
162+
.. data:: LOCK_SH
163+
164+
Acquire a shared lock.
165+
166+
.. data:: LOCK_EX
167+
168+
Acquire an exclusive lock.
169+
170+
.. data:: LOCK_NB
171+
172+
Bitwise OR with any of the other three ``LOCK_*`` constants to make
173+
the request non-blocking.
174+
175+
If :const:`!LOCK_NB` is used and the lock cannot be acquired, an
165176
:exc:`OSError` will be raised and the exception will have an *errno*
166-
attribute set to :const:`EACCES` or :const:`EAGAIN` (depending on the
177+
attribute set to :const:`~errno.EACCES` or :const:`~errno.EAGAIN` (depending on the
167178
operating system; for portability, check for both values). On at least some
168-
systems, :const:`LOCK_EX` can only be used if the file descriptor refers to a
179+
systems, :const:`!LOCK_EX` can only be used if the file descriptor refers to a
169180
file opened for writing.
170181

171182
*len* is the number of bytes to lock, *start* is the byte offset at

_sources/library/functions.rst.txt

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1569,6 +1569,16 @@ are always available. They are listed here in alphabetical order.
15691569
If :func:`sys.displayhook` is not accessible, this function will raise
15701570
:exc:`RuntimeError`.
15711571

1572+
This class has a custom representation that can be evaluated::
1573+
1574+
class Person:
1575+
def __init__(self, name, age):
1576+
self.name = name
1577+
self.age = age
1578+
1579+
def __repr__(self):
1580+
return f"Person('{self.name}', {self.age})"
1581+
15721582

15731583
.. function:: reversed(seq)
15741584

_sources/library/http.cookiejar.rst.txt

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -649,6 +649,11 @@ internal consistency, so you should know what you're doing if you do that.
649649
:const:`None`.
650650

651651

652+
.. attribute:: Cookie.domain
653+
654+
Cookie domain (a string).
655+
656+
652657
.. attribute:: Cookie.path
653658

654659
Cookie path (a string, eg. ``'/acme/rocket_launchers'``).

0 commit comments

Comments
 (0)