Skip to content

Commit d505463

Browse files
committed
Deploying to gh-pages from @ cbc3bcf 🚀
1 parent a73f0c5 commit d505463

File tree

574 files changed

+71090
-25827
lines changed

Some content is hidden

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

574 files changed

+71090
-25827
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: 8ee66d40318e6c3bf3df9f7a32850b53
3+
config: b4de732a1adc31e490cff63dd5fff1f8
44
tags: 645f666f9bcd5a90fca523b33c5a78b7

_sources/bugs.rst.txt

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -22,6 +22,10 @@ have a suggestion on how to fix it, include that as well.
2222
You can also open a discussion item on our
2323
`Documentation Discourse forum <https://discuss.python.org/c/documentation/26>`_.
2424

25+
If you find a bug in the theme (HTML / CSS / JavaScript) of the
26+
documentation, please submit a bug report on the `python-doc-theme bug
27+
tracker <https://github.com/python/python-docs-theme>`_.
28+
2529
If you're short on time, you can also email documentation bug reports to
2630
docs@python.org (behavioral bugs can be sent to python-list@python.org).
2731
'docs@' is a mailing list run by volunteers; your request will be noticed,

_sources/c-api/exceptions.rst.txt

Lines changed: 5 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -208,13 +208,14 @@ For convenience, some of these functions will always return a
208208
209209
.. c:function:: PyObject* PyErr_SetFromWindowsErr(int ierr)
210210
211-
This is a convenience function to raise :exc:`WindowsError`. If called with
211+
This is a convenience function to raise :exc:`OSError`. If called with
212212
*ierr* of ``0``, the error code returned by a call to :c:func:`!GetLastError`
213213
is used instead. It calls the Win32 function :c:func:`!FormatMessage` to retrieve
214214
the Windows description of error code given by *ierr* or :c:func:`!GetLastError`,
215-
then it constructs a tuple object whose first item is the *ierr* value and whose
216-
second item is the corresponding error message (gotten from
217-
:c:func:`!FormatMessage`), and then calls ``PyErr_SetObject(PyExc_WindowsError,
215+
then it constructs a :exc:`OSError` object with the :attr:`~OSError.winerror`
216+
attribute set to the error code, the :attr:`~OSError.strerror` attribute
217+
set to the corresponding error message (gotten from
218+
:c:func:`!FormatMessage`), and then calls ``PyErr_SetObject(PyExc_OSError,
218219
object)``. This function always returns ``NULL``.
219220
220221
.. availability:: Windows.

_sources/c-api/init.rst.txt

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -760,7 +760,7 @@ Process-wide parameters
760760
It is recommended that applications embedding the Python interpreter
761761
for purposes other than executing a single script pass ``0`` as *updatepath*,
762762
and update :data:`sys.path` themselves if desired.
763-
See `CVE-2008-5983 <https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2008-5983>`_.
763+
See :cve:`2008-5983`.
764764

765765
On versions before 3.1.3, you can achieve the same effect by manually
766766
popping the first :data:`sys.path` element after having called

_sources/faq/library.rst.txt

Lines changed: 2 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -610,16 +610,15 @@ use ``p.read(n)``.
610610
("ptys") instead of pipes. Or you can use a Python interface to Don Libes'
611611
"expect" library. A Python extension that interfaces to expect is called
612612
"expy" and available from https://expectpy.sourceforge.net. A pure Python
613-
solution that works like expect is `pexpect
614-
<https://pypi.org/project/pexpect/>`_.
613+
solution that works like expect is :pypi:`pexpect`.
615614
616615
617616
How do I access the serial (RS232) port?
618617
----------------------------------------
619618
620619
For Win32, OSX, Linux, BSD, Jython, IronPython:
621620
622-
https://pypi.org/project/pyserial/
621+
:pypi:`pyserial`
623622
624623
For Unix, see a Usenet post by Mitch Chapman:
625624

_sources/howto/curses.rst.txt

Lines changed: 3 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -43,7 +43,7 @@ appearance---and the curses library will figure out what control codes
4343
need to be sent to the terminal to produce the right output. curses
4444
doesn't provide many user-interface concepts such as buttons, checkboxes,
4545
or dialogs; if you need such features, consider a user interface library such as
46-
`Urwid <https://pypi.org/project/urwid/>`_.
46+
:pypi:`Urwid`.
4747

4848
The curses library was originally written for BSD Unix; the later System V
4949
versions of Unix from AT&T added many enhancements and new functions. BSD curses
@@ -56,8 +56,7 @@ versions of curses carried by some proprietary Unixes may not support
5656
everything, though.
5757

5858
The Windows version of Python doesn't include the :mod:`curses`
59-
module. A ported version called `UniCurses
60-
<https://pypi.org/project/UniCurses>`_ is available.
59+
module. A ported version called :pypi:`UniCurses` is available.
6160

6261

6362
The Python curses module
@@ -429,8 +428,7 @@ User Input
429428

430429
The C curses library offers only very simple input mechanisms. Python's
431430
:mod:`curses` module adds a basic text-input widget. (Other libraries
432-
such as `Urwid <https://pypi.org/project/urwid/>`_ have more extensive
433-
collections of widgets.)
431+
such as :pypi:`Urwid` have more extensive collections of widgets.)
434432

435433
There are two methods for getting input from a window:
436434

_sources/howto/logging-cookbook.rst.txt

Lines changed: 3 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1912,7 +1912,7 @@ Subclassing QueueHandler and QueueListener- a ``pynng`` example
19121912
---------------------------------------------------------------
19131913

19141914
In a similar way to the above section, we can implement a listener and handler
1915-
using `pynng <https://pypi.org/project/pynng/>`_, which is a Python binding to
1915+
using :pypi:`pynng`, which is a Python binding to
19161916
`NNG <https://nng.nanomsg.org/>`_, billed as a spiritual successor to ZeroMQ.
19171917
The following snippets illustrate -- you can test them in an environment which has
19181918
``pynng`` installed. Just for variety, we present the listener first.
@@ -3575,9 +3575,8 @@ A Qt GUI for logging
35753575

35763576
A question that comes up from time to time is about how to log to a GUI
35773577
application. The `Qt <https://www.qt.io/>`_ framework is a popular
3578-
cross-platform UI framework with Python bindings using `PySide2
3579-
<https://pypi.org/project/PySide2/>`_ or `PyQt5
3580-
<https://pypi.org/project/PyQt5/>`_ libraries.
3578+
cross-platform UI framework with Python bindings using :pypi:`PySide2`
3579+
or :pypi:`PyQt5` libraries.
35813580

35823581
The following example shows how to log to a Qt GUI. This introduces a simple
35833582
``QtHandler`` class which takes a callable, which should be a slot in the main

_sources/library/cgi.rst.txt

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -22,7 +22,7 @@
2222
The :class:`FieldStorage` class can typically be replaced with
2323
:func:`urllib.parse.parse_qsl` for ``GET`` and ``HEAD`` requests,
2424
and the :mod:`email.message` module or
25-
`multipart <https://pypi.org/project/multipart/>`_ for ``POST`` and ``PUT``.
25+
:pypi:`multipart` for ``POST`` and ``PUT``.
2626
Most :ref:`utility functions <functions-in-cgi-module>` have replacements.
2727

2828
--------------
@@ -334,7 +334,7 @@ algorithms implemented in this module in other circumstances.
334334
It can be replaced with the functionality in the :mod:`email` package
335335
(e.g. :class:`email.message.EmailMessage`/:class:`email.message.Message`)
336336
which implements the same MIME RFCs, or with the
337-
`multipart <https://pypi.org/project/multipart/>`__ PyPI project.
337+
:pypi:`multipart` PyPI project.
338338

339339

340340
.. function:: parse_header(string)

_sources/library/codecs.rst.txt

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1479,7 +1479,7 @@ Internationalized Domain Names (IDN)). It builds upon the ``punycode`` encoding
14791479
and :mod:`stringprep`.
14801480

14811481
If you need the IDNA 2008 standard from :rfc:`5891` and :rfc:`5895`, use the
1482-
third-party `idna module <https://pypi.org/project/idna/>`_.
1482+
third-party :pypi:`idna` module.
14831483

14841484
These RFCs together define a protocol to support non-ASCII characters in domain
14851485
names. A domain name containing non-ASCII characters (such as

_sources/library/crypt.rst.txt

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -20,7 +20,7 @@
2020
The :mod:`crypt` module is deprecated
2121
(see :pep:`PEP 594 <594#crypt>` for details and alternatives).
2222
The :mod:`hashlib` module is a potential replacement for certain use cases.
23-
The `passlib <https://pypi.org/project/passlib/>`_ package can replace all use cases of this module.
23+
The :pypi:`passlib` package can replace all use cases of this module.
2424

2525
--------------
2626

0 commit comments

Comments
 (0)