Thanks to visit codestin.com
Credit goes to github.com

Skip to content

Commit e4a90a7

Browse files
committed
Deploying to gh-pages from @ 69ca160 🚀
1 parent 8881a92 commit e4a90a7

File tree

536 files changed

+3912
-3809
lines changed

Some content is hidden

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

536 files changed

+3912
-3809
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: dc633053b47cf567650a3dcb5abc6525
3+
config: 6505f3266534c7efd7548e5471a468ac
44
tags: 645f666f9bcd5a90fca523b33c5a78b7

_sources/c-api/typeobj.rst.txt

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1584,7 +1584,7 @@ and :c:data:`PyType_Type` effectively act as defaults.)
15841584
weak references to the type object itself.
15851585

15861586
It is an error to set both the :c:macro:`Py_TPFLAGS_MANAGED_WEAKREF` bit and
1587-
:c:member:`~PyTypeObject.tp_weaklist`.
1587+
:c:member:`~PyTypeObject.tp_weaklistoffset`.
15881588

15891589
**Inheritance:**
15901590

@@ -1596,7 +1596,7 @@ and :c:data:`PyType_Type` effectively act as defaults.)
15961596
**Default:**
15971597

15981598
If the :c:macro:`Py_TPFLAGS_MANAGED_WEAKREF` bit is set in the
1599-
:c:member:`~PyTypeObject.tp_dict` field, then
1599+
:c:member:`~PyTypeObject.tp_flags` field, then
16001600
:c:member:`~PyTypeObject.tp_weaklistoffset` will be set to a negative value,
16011601
to indicate that it is unsafe to use this field.
16021602

_sources/howto/logging.rst.txt

Lines changed: 40 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -384,6 +384,46 @@ following diagram.
384384
.. raw:: html
385385
:file: logging_flow.svg
386386

387+
.. raw:: html
388+
389+
<script>
390+
/*
391+
* This snippet is needed to handle the case where a light or dark theme is
392+
* chosen via the theme is selected in the page. We call the existing handler
393+
* and then add a dark-theme class to the body when the dark theme is selected.
394+
* The SVG styling (above) then does the rest.
395+
*
396+
* If the pydoc theme is updated to set the dark-theme class, this snippet
397+
* won't be needed any more.
398+
*/
399+
(function() {
400+
var oldActivateTheme = activateTheme;
401+
402+
function updateBody(theme) {
403+
let elem = document.body;
404+
405+
elem.classList.remove('dark-theme');
406+
elem.classList.remove('light-theme');
407+
if (theme === 'dark') {
408+
elem.classList.add('dark-theme');
409+
}
410+
else if (theme === 'light') {
411+
elem.classList.add('light-theme');
412+
}
413+
}
414+
415+
activateTheme = function(theme) {
416+
oldActivateTheme(theme);
417+
updateBody(theme);
418+
};
419+
/*
420+
* If the page is refreshed, make sure we update the body - the overriding
421+
* of activateTheme won't have taken effect yet.
422+
*/
423+
updateBody(localStorage.getItem('currentTheme') || 'auto');
424+
})();
425+
</script>
426+
387427
Loggers
388428
^^^^^^^
389429

_sources/library/__main__.rst.txt

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -251,9 +251,9 @@ attribute will include the package's path if imported::
251251
>>> asyncio.__main__.__name__
252252
'asyncio.__main__'
253253

254-
This won't work for ``__main__.py`` files in the root directory of a .zip file
255-
though. Hence, for consistency, minimal ``__main__.py`` like the :mod:`venv`
256-
one mentioned below are preferred.
254+
This won't work for ``__main__.py`` files in the root directory of a
255+
``.zip`` file though. Hence, for consistency, a minimal ``__main__.py``
256+
without a ``__name__`` check is preferred.
257257

258258
.. seealso::
259259

_sources/library/os.path.rst.txt

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -359,7 +359,7 @@ the :mod:`glob` module.)
359359
that contains symbolic links. On Windows, it converts forward slashes to
360360
backward slashes. To normalize case, use :func:`normcase`.
361361

362-
.. note::
362+
.. note::
363363
On POSIX systems, in accordance with `IEEE Std 1003.1 2013 Edition; 4.13
364364
Pathname Resolution <https://pubs.opengroup.org/onlinepubs/9699919799/basedefs/V1_chap04.html#tag_04_13>`_,
365365
if a pathname begins with exactly two slashes, the first component

_sources/library/stdtypes.rst.txt

Lines changed: 10 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -2092,8 +2092,9 @@ expression support in the :mod:`re` module).
20922092
If *sep* is given, consecutive delimiters are not grouped together and are
20932093
deemed to delimit empty strings (for example, ``'1,,2'.split(',')`` returns
20942094
``['1', '', '2']``). The *sep* argument may consist of multiple characters
2095-
(for example, ``'1<>2<>3'.split('<>')`` returns ``['1', '2', '3']``).
2096-
Splitting an empty string with a specified separator returns ``['']``.
2095+
as a single delimiter (to split with multiple delimiters, use
2096+
:func:`re.split`). Splitting an empty string with a specified separator
2097+
returns ``['']``.
20972098

20982099
For example::
20992100

@@ -2103,6 +2104,8 @@ expression support in the :mod:`re` module).
21032104
['1', '2,3']
21042105
>>> '1,2,,3,'.split(',')
21052106
['1', '2', '', '3', '']
2107+
>>> '1<>2<>3<4'.split('<>')
2108+
['1', '2', '3<4']
21062109

21072110
If *sep* is not specified or is ``None``, a different splitting algorithm is
21082111
applied: runs of consecutive whitespace are regarded as a single separator,
@@ -3140,10 +3143,9 @@ produce new objects.
31403143
If *sep* is given, consecutive delimiters are not grouped together and are
31413144
deemed to delimit empty subsequences (for example, ``b'1,,2'.split(b',')``
31423145
returns ``[b'1', b'', b'2']``). The *sep* argument may consist of a
3143-
multibyte sequence (for example, ``b'1<>2<>3'.split(b'<>')`` returns
3144-
``[b'1', b'2', b'3']``). Splitting an empty sequence with a specified
3145-
separator returns ``[b'']`` or ``[bytearray(b'')]`` depending on the type
3146-
of object being split. The *sep* argument may be any
3146+
multibyte sequence as a single delimiter. Splitting an empty sequence with
3147+
a specified separator returns ``[b'']`` or ``[bytearray(b'')]`` depending
3148+
on the type of object being split. The *sep* argument may be any
31473149
:term:`bytes-like object`.
31483150

31493151
For example::
@@ -3154,6 +3156,8 @@ produce new objects.
31543156
[b'1', b'2,3']
31553157
>>> b'1,2,,3,'.split(b',')
31563158
[b'1', b'2', b'', b'3', b'']
3159+
>>> b'1<>2<>3<4'.split(b'<>')
3160+
[b'1', b'2', b'3<4']
31573161

31583162
If *sep* is not specified or is ``None``, a different splitting algorithm
31593163
is applied: runs of consecutive ASCII whitespace are regarded as a single

_sources/reference/simple_stmts.rst.txt

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -293,7 +293,7 @@ statements, cannot be an unpacking) and the expression list, performs the binary
293293
operation specific to the type of assignment on the two operands, and assigns
294294
the result to the original target. The target is only evaluated once.
295295

296-
An augmented assignment expression like ``x += 1`` can be rewritten as ``x = x +
296+
An augmented assignment statement like ``x += 1`` can be rewritten as ``x = x +
297297
1`` to achieve a similar, but not exactly equal effect. In the augmented
298298
version, ``x`` is only evaluated once. Also, when possible, the actual operation
299299
is performed *in-place*, meaning that rather than creating a new object and

about.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -319,7 +319,7 @@ <h3>瀏覽</h3>
319319
<a href="https://www.python.org/psf/donations/">Please donate.</a>
320320
<br />
321321
<br />
322-
最後更新於 Jul 03, 2024 (03:49 UTC)。
322+
最後更新於 Jul 09, 2024 (06:56 UTC)。
323323

324324
<a href="/bugs.html">Found a bug</a>?
325325

bugs.html

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -230,7 +230,7 @@ <h2>說明文件的錯誤<a class="headerlink" href="#documentation-bugs" title=
230230
</section>
231231
<section id="getting-started-contributing-to-python-yourself">
232232
<span id="contributing-to-python"></span><h2>開始讓自己貢獻 Python<a class="headerlink" href="#getting-started-contributing-to-python-yourself" title="連結到這個標頭"></a></h2>
233-
<p>除了只是回報您所發現的錯誤之外,同樣也歡迎您提交修正它們的修補程式 (patch)。您可以在 <a class="reference external" href="https://devguide.python.org/">Python 開發者指南</a>中找到如何開始修補 Python 的更多資訊。如果您有任何問題,<a class="reference external" href="https://mail.python.org/mailman3/lists/core-mentorship.python.org/">核心導師郵寄清單</a>是一個友善的地方,您可以在那裡得到,關於 Python 修正錯誤的過程中,所有問題的答案。</p>
233+
<p>除了只是回報您所發現的錯誤之外,同樣也歡迎您提交修正它們的修補程式 (patch)。您可以在 <a class="reference external" href="https://mail.python.org/mailman3/lists/core-mentorship.python.org/">Python 開發者指南</a>中找到如何開始修補 Python 的更多資訊。如果您有任何問題,<a class="reference external" href="https://devguide.python.org/">核心導師郵寄清單</a>是一個友善的地方,您可以在那裡得到,關於 Python 修正錯誤的過程中,所有問題的答案。</p>
234234
</section>
235235
</section>
236236

@@ -358,7 +358,7 @@ <h3>瀏覽</h3>
358358
<a href="https://www.python.org/psf/donations/">Please donate.</a>
359359
<br />
360360
<br />
361-
最後更新於 Jul 03, 2024 (03:49 UTC)。
361+
最後更新於 Jul 09, 2024 (06:56 UTC)。
362362

363363
<a href="/bugs.html">Found a bug</a>?
364364

c-api/abstract.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -329,7 +329,7 @@ <h3>瀏覽</h3>
329329
<a href="https://www.python.org/psf/donations/">Please donate.</a>
330330
<br />
331331
<br />
332-
最後更新於 Jul 03, 2024 (03:49 UTC)。
332+
最後更新於 Jul 09, 2024 (06:56 UTC)。
333333

334334
<a href="/bugs.html">Found a bug</a>?
335335

c-api/allocation.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -343,7 +343,7 @@ <h3>瀏覽</h3>
343343
<a href="https://www.python.org/psf/donations/">Please donate.</a>
344344
<br />
345345
<br />
346-
最後更新於 Jul 03, 2024 (03:49 UTC)。
346+
最後更新於 Jul 09, 2024 (06:56 UTC)。
347347

348348
<a href="/bugs.html">Found a bug</a>?
349349

c-api/apiabiversion.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -375,7 +375,7 @@ <h3>瀏覽</h3>
375375
<a href="https://www.python.org/psf/donations/">Please donate.</a>
376376
<br />
377377
<br />
378-
最後更新於 Jul 03, 2024 (03:49 UTC)。
378+
最後更新於 Jul 09, 2024 (06:56 UTC)。
379379

380380
<a href="/bugs.html">Found a bug</a>?
381381

c-api/arg.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -886,7 +886,7 @@ <h3>瀏覽</h3>
886886
<a href="https://www.python.org/psf/donations/">Please donate.</a>
887887
<br />
888888
<br />
889-
最後更新於 Jul 03, 2024 (03:49 UTC)。
889+
最後更新於 Jul 09, 2024 (06:56 UTC)。
890890

891891
<a href="/bugs.html">Found a bug</a>?
892892

c-api/bool.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -340,7 +340,7 @@ <h3>瀏覽</h3>
340340
<a href="https://www.python.org/psf/donations/">Please donate.</a>
341341
<br />
342342
<br />
343-
最後更新於 Jul 03, 2024 (03:49 UTC)。
343+
最後更新於 Jul 09, 2024 (06:56 UTC)。
344344

345345
<a href="/bugs.html">Found a bug</a>?
346346

c-api/buffer.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1013,7 +1013,7 @@ <h3>瀏覽</h3>
10131013
<a href="https://www.python.org/psf/donations/">Please donate.</a>
10141014
<br />
10151015
<br />
1016-
最後更新於 Jul 03, 2024 (03:49 UTC)。
1016+
最後更新於 Jul 09, 2024 (06:56 UTC)。
10171017

10181018
<a href="/bugs.html">Found a bug</a>?
10191019

c-api/bytearray.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -396,7 +396,7 @@ <h3>瀏覽</h3>
396396
<a href="https://www.python.org/psf/donations/">Please donate.</a>
397397
<br />
398398
<br />
399-
最後更新於 Jul 03, 2024 (03:49 UTC)。
399+
最後更新於 Jul 09, 2024 (06:56 UTC)。
400400

401401
<a href="/bugs.html">Found a bug</a>?
402402

c-api/bytes.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -520,7 +520,7 @@ <h3>瀏覽</h3>
520520
<a href="https://www.python.org/psf/donations/">Please donate.</a>
521521
<br />
522522
<br />
523-
最後更新於 Jul 03, 2024 (03:49 UTC)。
523+
最後更新於 Jul 09, 2024 (06:56 UTC)。
524524

525525
<a href="/bugs.html">Found a bug</a>?
526526

c-api/call.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -655,7 +655,7 @@ <h3>瀏覽</h3>
655655
<a href="https://www.python.org/psf/donations/">Please donate.</a>
656656
<br />
657657
<br />
658-
最後更新於 Jul 03, 2024 (03:49 UTC)。
658+
最後更新於 Jul 09, 2024 (06:56 UTC)。
659659

660660
<a href="/bugs.html">Found a bug</a>?
661661

c-api/capsule.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -440,7 +440,7 @@ <h3>瀏覽</h3>
440440
<a href="https://www.python.org/psf/donations/">Please donate.</a>
441441
<br />
442442
<br />
443-
最後更新於 Jul 03, 2024 (03:49 UTC)。
443+
最後更新於 Jul 09, 2024 (06:56 UTC)。
444444

445445
<a href="/bugs.html">Found a bug</a>?
446446

c-api/cell.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -339,7 +339,7 @@ <h3>瀏覽</h3>
339339
<a href="https://www.python.org/psf/donations/">Please donate.</a>
340340
<br />
341341
<br />
342-
最後更新於 Jul 03, 2024 (03:49 UTC)。
342+
最後更新於 Jul 09, 2024 (06:56 UTC)。
343343

344344
<a href="/bugs.html">Found a bug</a>?
345345

c-api/code.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -595,7 +595,7 @@ <h3>瀏覽</h3>
595595
<a href="https://www.python.org/psf/donations/">Please donate.</a>
596596
<br />
597597
<br />
598-
最後更新於 Jul 03, 2024 (03:49 UTC)。
598+
最後更新於 Jul 09, 2024 (06:56 UTC)。
599599

600600
<a href="/bugs.html">Found a bug</a>?
601601

c-api/codec.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -444,7 +444,7 @@ <h3>瀏覽</h3>
444444
<a href="https://www.python.org/psf/donations/">Please donate.</a>
445445
<br />
446446
<br />
447-
最後更新於 Jul 03, 2024 (03:49 UTC)。
447+
最後更新於 Jul 09, 2024 (06:56 UTC)。
448448

449449
<a href="/bugs.html">Found a bug</a>?
450450

c-api/complex.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -428,7 +428,7 @@ <h3>瀏覽</h3>
428428
<a href="https://www.python.org/psf/donations/">Please donate.</a>
429429
<br />
430430
<br />
431-
最後更新於 Jul 03, 2024 (03:49 UTC)。
431+
最後更新於 Jul 09, 2024 (06:56 UTC)。
432432

433433
<a href="/bugs.html">Found a bug</a>?
434434

c-api/concrete.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -463,7 +463,7 @@ <h3>瀏覽</h3>
463463
<a href="https://www.python.org/psf/donations/">Please donate.</a>
464464
<br />
465465
<br />
466-
最後更新於 Jul 03, 2024 (03:49 UTC)。
466+
最後更新於 Jul 09, 2024 (06:56 UTC)。
467467

468468
<a href="/bugs.html">Found a bug</a>?
469469

c-api/contextvars.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -450,7 +450,7 @@ <h3>瀏覽</h3>
450450
<a href="https://www.python.org/psf/donations/">Please donate.</a>
451451
<br />
452452
<br />
453-
最後更新於 Jul 03, 2024 (03:49 UTC)。
453+
最後更新於 Jul 09, 2024 (06:56 UTC)。
454454

455455
<a href="/bugs.html">Found a bug</a>?
456456

c-api/conversion.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -389,7 +389,7 @@ <h3>瀏覽</h3>
389389
<a href="https://www.python.org/psf/donations/">Please donate.</a>
390390
<br />
391391
<br />
392-
最後更新於 Jul 03, 2024 (03:49 UTC)。
392+
最後更新於 Jul 09, 2024 (06:56 UTC)。
393393

394394
<a href="/bugs.html">Found a bug</a>?
395395

c-api/coro.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -318,7 +318,7 @@ <h3>瀏覽</h3>
318318
<a href="https://www.python.org/psf/donations/">Please donate.</a>
319319
<br />
320320
<br />
321-
最後更新於 Jul 03, 2024 (03:49 UTC)。
321+
最後更新於 Jul 09, 2024 (06:56 UTC)。
322322

323323
<a href="/bugs.html">Found a bug</a>?
324324

c-api/datetime.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -629,7 +629,7 @@ <h3>瀏覽</h3>
629629
<a href="https://www.python.org/psf/donations/">Please donate.</a>
630630
<br />
631631
<br />
632-
最後更新於 Jul 03, 2024 (03:49 UTC)。
632+
最後更新於 Jul 09, 2024 (06:56 UTC)。
633633

634634
<a href="/bugs.html">Found a bug</a>?
635635

c-api/descriptor.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -333,7 +333,7 @@ <h3>瀏覽</h3>
333333
<a href="https://www.python.org/psf/donations/">Please donate.</a>
334334
<br />
335335
<br />
336-
最後更新於 Jul 03, 2024 (03:49 UTC)。
336+
最後更新於 Jul 09, 2024 (06:56 UTC)。
337337

338338
<a href="/bugs.html">Found a bug</a>?
339339

c-api/dict.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -642,7 +642,7 @@ <h3>瀏覽</h3>
642642
<a href="https://www.python.org/psf/donations/">Please donate.</a>
643643
<br />
644644
<br />
645-
最後更新於 Jul 03, 2024 (03:49 UTC)。
645+
最後更新於 Jul 09, 2024 (06:56 UTC)。
646646

647647
<a href="/bugs.html">Found a bug</a>?
648648

c-api/exceptions.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1689,7 +1689,7 @@ <h3>瀏覽</h3>
16891689
<a href="https://www.python.org/psf/donations/">Please donate.</a>
16901690
<br />
16911691
<br />
1692-
最後更新於 Jul 03, 2024 (03:49 UTC)。
1692+
最後更新於 Jul 09, 2024 (06:56 UTC)。
16931693

16941694
<a href="/bugs.html">Found a bug</a>?
16951695

c-api/file.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -365,7 +365,7 @@ <h3>瀏覽</h3>
365365
<a href="https://www.python.org/psf/donations/">Please donate.</a>
366366
<br />
367367
<br />
368-
最後更新於 Jul 03, 2024 (03:49 UTC)。
368+
最後更新於 Jul 09, 2024 (06:56 UTC)。
369369

370370
<a href="/bugs.html">Found a bug</a>?
371371

c-api/float.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -488,7 +488,7 @@ <h3>瀏覽</h3>
488488
<a href="https://www.python.org/psf/donations/">Please donate.</a>
489489
<br />
490490
<br />
491-
最後更新於 Jul 03, 2024 (03:49 UTC)。
491+
最後更新於 Jul 09, 2024 (06:56 UTC)。
492492

493493
<a href="/bugs.html">Found a bug</a>?
494494

c-api/frame.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -499,7 +499,7 @@ <h3>瀏覽</h3>
499499
<a href="https://www.python.org/psf/donations/">Please donate.</a>
500500
<br />
501501
<br />
502-
最後更新於 Jul 03, 2024 (03:49 UTC)。
502+
最後更新於 Jul 09, 2024 (06:56 UTC)。
503503

504504
<a href="/bugs.html">Found a bug</a>?
505505

0 commit comments

Comments
 (0)