Skip to content

Commit 4e3775d

Browse files
mattwang44mattwang44
committed
Deploying to gh-pages from @ 78c5069 🚀
1 parent 3e2ca74 commit 4e3775d

File tree

530 files changed

+906
-594
lines changed

Some content is hidden

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

530 files changed

+906
-594
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: 0da807992aa4fcb3e9c7a38ef4aff6b3
3+
config: ea1dff499fc8e995abc2adf43ef4b04f
44
tags: 645f666f9bcd5a90fca523b33c5a78b7

‎_sources/howto/isolating-extensions.rst.txt

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -337,7 +337,7 @@ That is, heap types should:
337337

338338
- Have the :c:macro:`Py_TPFLAGS_HAVE_GC` flag.
339339
- Define a traverse function using ``Py_tp_traverse``, which
340-
visits the type (e.g. using :c:expr:`Py_VISIT(Py_TYPE(self))`).
340+
visits the type (e.g. using ``Py_VISIT(Py_TYPE(self))``).
341341

342342
Please refer to the the documentation of
343343
:c:macro:`Py_TPFLAGS_HAVE_GC` and :c:member:`~PyTypeObject.tp_traverse`
@@ -482,7 +482,7 @@ The largest roadblock is getting *the class a method was defined in*, or
482482
that method's "defining class" for short. The defining class can have a
483483
reference to the module it is part of.
484484

485-
Do not confuse the defining class with :c:expr:`Py_TYPE(self)`. If the method
485+
Do not confuse the defining class with ``Py_TYPE(self)``. If the method
486486
is called on a *subclass* of your type, ``Py_TYPE(self)`` will refer to
487487
that subclass, which may be defined in different module than yours.
488488

‎_sources/library/bisect.rst.txt

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -19,9 +19,9 @@ linear searches or frequent resorting.
1919
The module is called :mod:`bisect` because it uses a basic bisection
2020
algorithm to do its work. Unlike other bisection tools that search for a
2121
specific value, the functions in this module are designed to locate an
22-
insertion point. Accordingly, the functions never call an :meth:`__eq__`
22+
insertion point. Accordingly, the functions never call an :meth:`~object.__eq__`
2323
method to determine whether a value has been found. Instead, the
24-
functions only call the :meth:`__lt__` method and will return an insertion
24+
functions only call the :meth:`~object.__lt__` method and will return an insertion
2525
point between values in an array.
2626

2727
.. _bisect functions:
@@ -73,7 +73,7 @@ The following functions are provided:
7373
Insert *x* in *a* in sorted order.
7474

7575
This function first runs :py:func:`~bisect.bisect_left` to locate an insertion point.
76-
Next, it runs the :meth:`insert` method on *a* to insert *x* at the
76+
Next, it runs the :meth:`!insert` method on *a* to insert *x* at the
7777
appropriate position to maintain sort order.
7878

7979
To support inserting records in a table, the *key* function (if any) is
@@ -93,7 +93,7 @@ The following functions are provided:
9393
entries of *x*.
9494

9595
This function first runs :py:func:`~bisect.bisect_right` to locate an insertion point.
96-
Next, it runs the :meth:`insert` method on *a* to insert *x* at the
96+
Next, it runs the :meth:`!insert` method on *a* to insert *x* at the
9797
appropriate position to maintain sort order.
9898

9999
To support inserting records in a table, the *key* function (if any) is

‎_sources/library/calendar.rst.txt

Lines changed: 10 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -196,6 +196,13 @@ interpreted as prescribed by the ISO 8601 standard. Year 0 is 1 BC, year -1 is
196196
output (defaulting to the system default encoding).
197197

198198

199+
.. method:: formatmonthname(theyear, themonth, withyear=True)
200+
201+
Return a month name as an HTML table row. If *withyear* is true the year
202+
will be included in the row, otherwise just the month name will be
203+
used.
204+
205+
199206
:class:`!HTMLCalendar` has the following attributes you can override to
200207
customize the CSS classes used by the calendar:
201208

@@ -289,7 +296,7 @@ interpreted as prescribed by the ISO 8601 standard. Year 0 is 1 BC, year -1 is
289296

290297
.. note::
291298

292-
The constructor, :meth:`formatweekday` and :meth:`formatmonthname` methods
299+
The constructor, :meth:`!formatweekday` and :meth:`!formatmonthname` methods
293300
of these two classes temporarily change the ``LC_TIME`` locale to the given
294301
*locale*. Because the current locale is a process-wide setting, they are
295302
not thread-safe.
@@ -358,7 +365,7 @@ For simple text calendars this module provides the following functions.
358365

359366
.. function:: month(theyear, themonth, w=0, l=0)
360367

361-
Returns a month's calendar in a multi-line string using the :meth:`formatmonth`
368+
Returns a month's calendar in a multi-line string using the :meth:`~TextCalendar.formatmonth`
362369
of the :class:`TextCalendar` class.
363370

364371

@@ -370,7 +377,7 @@ For simple text calendars this module provides the following functions.
370377
.. function:: calendar(year, w=2, l=1, c=6, m=3)
371378

372379
Returns a 3-column calendar for an entire year as a multi-line string using
373-
the :meth:`formatyear` of the :class:`TextCalendar` class.
380+
the :meth:`~TextCalendar.formatyear` of the :class:`TextCalendar` class.
374381

375382

376383
.. function:: timegm(tuple)

‎_sources/library/cmd.rst.txt

Lines changed: 14 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -66,27 +66,30 @@ A :class:`Cmd` instance has the following methods:
6666
single: ! (exclamation); in a command interpreter
6767

6868
An interpreter instance will recognize a command name ``foo`` if and only if it
69-
has a method :meth:`do_foo`. As a special case, a line beginning with the
69+
has a method :meth:`!do_foo`. As a special case, a line beginning with the
7070
character ``'?'`` is dispatched to the method :meth:`do_help`. As another
7171
special case, a line beginning with the character ``'!'`` is dispatched to the
72-
method :meth:`do_shell` (if such a method is defined).
72+
method :meth:`!do_shell` (if such a method is defined).
7373

7474
This method will return when the :meth:`postcmd` method returns a true value.
7575
The *stop* argument to :meth:`postcmd` is the return value from the command's
7676
corresponding :meth:`!do_\*` method.
7777

7878
If completion is enabled, completing commands will be done automatically, and
79-
completing of commands args is done by calling :meth:`complete_foo` with
79+
completing of commands args is done by calling :meth:`!complete_foo` with
8080
arguments *text*, *line*, *begidx*, and *endidx*. *text* is the string prefix
8181
we are attempting to match: all returned matches must begin with it. *line* is
8282
the current input line with leading whitespace removed, *begidx* and *endidx*
8383
are the beginning and ending indexes of the prefix text, which could be used to
8484
provide different completion depending upon which position the argument is in.
8585

86-
All subclasses of :class:`Cmd` inherit a predefined :meth:`do_help`. This
86+
87+
.. method:: Cmd.do_help(arg)
88+
89+
All subclasses of :class:`Cmd` inherit a predefined :meth:`!do_help`. This
8790
method, called with an argument ``'bar'``, invokes the corresponding method
88-
:meth:`help_bar`, and if that is not present, prints the docstring of
89-
:meth:`do_bar`, if available. With no argument, :meth:`do_help` lists all
91+
:meth:`!help_bar`, and if that is not present, prints the docstring of
92+
:meth:`!do_bar`, if available. With no argument, :meth:`!do_help` lists all
9093
available help topics (that is, all commands with corresponding
9194
:meth:`!help_\*` methods or commands that have docstrings), and also lists any
9295
undocumented commands.
@@ -219,8 +222,8 @@ Instances of :class:`Cmd` subclasses have some public instance variables:
219222
.. attribute:: Cmd.use_rawinput
220223

221224
A flag, defaulting to true. If true, :meth:`cmdloop` uses :func:`input` to
222-
display a prompt and read the next command; if false, :meth:`sys.stdout.write`
223-
and :meth:`sys.stdin.readline` are used. (This means that by importing
225+
display a prompt and read the next command; if false, :data:`sys.stdout.write() <sys.stdout>`
226+
and :data:`sys.stdin.readline() <sys.stdin>` are used. (This means that by importing
224227
:mod:`readline`, on systems that support it, the interpreter will automatically
225228
support :program:`Emacs`\ -like line editing and command-history keystrokes.)
226229

@@ -239,14 +242,14 @@ This section presents a simple example of how to build a shell around a few of
239242
the commands in the :mod:`turtle` module.
240243

241244
Basic turtle commands such as :meth:`~turtle.forward` are added to a
242-
:class:`Cmd` subclass with method named :meth:`do_forward`. The argument is
245+
:class:`Cmd` subclass with method named :meth:`!do_forward`. The argument is
243246
converted to a number and dispatched to the turtle module. The docstring is
244247
used in the help utility provided by the shell.
245248

246249
The example also includes a basic record and playback facility implemented with
247250
the :meth:`~Cmd.precmd` method which is responsible for converting the input to
248-
lowercase and writing the commands to a file. The :meth:`do_playback` method
249-
reads the file and adds the recorded commands to the :attr:`cmdqueue` for
251+
lowercase and writing the commands to a file. The :meth:`!do_playback` method
252+
reads the file and adds the recorded commands to the :attr:`~Cmd.cmdqueue` for
250253
immediate playback::
251254

252255
import cmd, sys

‎_sources/library/tarfile.rst.txt

Lines changed: 6 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -116,10 +116,12 @@ Some facts and figures:
116116
``'filemode|[compression]'``. :func:`tarfile.open` will return a :class:`TarFile`
117117
object that processes its data as a stream of blocks. No random seeking will
118118
be done on the file. If given, *fileobj* may be any object that has a
119-
:meth:`~io.TextIOBase.read` or :meth:`~io.TextIOBase.write` method (depending on the *mode*). *bufsize*
120-
specifies the blocksize and defaults to ``20 * 512`` bytes. Use this variant
121-
in combination with e.g. ``sys.stdin``, a socket :term:`file object` or a tape
122-
device. However, such a :class:`TarFile` object is limited in that it does
119+
:meth:`~io.RawIOBase.read` or :meth:`~io.RawIOBase.write` method
120+
(depending on the *mode*) that works with bytes.
121+
*bufsize* specifies the blocksize and defaults to ``20 * 512`` bytes.
122+
Use this variant in combination with e.g. ``sys.stdin.buffer``, a socket
123+
:term:`file object` or a tape device.
124+
However, such a :class:`TarFile` object is limited in that it does
123125
not allow random access, see :ref:`tar-examples`. The currently
124126
possible modes:
125127

‎about.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -308,7 +308,7 @@ <h3>瀏覽</h3>
308308
<br />
309309
<br />
310310

311-
最後更新於 Dec 26, 2023 (07:52 UTC)。
311+
最後更新於 Dec 28, 2023 (15:24 UTC)。
312312
<a href="/bugs.html">Found a bug</a>?
313313
<br />
314314

‎bugs.html

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -224,7 +224,7 @@ <h2>說明文件的錯誤<a class="headerlink" href="#documentation-bugs" title=
224224
</section>
225225
<section id="getting-started-contributing-to-python-yourself">
226226
<span id="contributing-to-python"></span><h2>開始讓自己貢獻 Python<a class="headerlink" href="#getting-started-contributing-to-python-yourself" title="Link to this heading"></a></h2>
227-
<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>
227+
<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>
228228
</section>
229229
</section>
230230

@@ -344,7 +344,7 @@ <h3>瀏覽</h3>
344344
<br />
345345
<br />
346346

347-
最後更新於 Dec 26, 2023 (07:52 UTC)。
347+
最後更新於 Dec 28, 2023 (15:24 UTC)。
348348
<a href="/bugs.html">Found a bug</a>?
349349
<br />
350350

‎c-api/abstract.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -318,7 +318,7 @@ <h3>瀏覽</h3>
318318
<br />
319319
<br />
320320

321-
最後更新於 Dec 26, 2023 (07:52 UTC)。
321+
最後更新於 Dec 28, 2023 (15:24 UTC)。
322322
<a href="/bugs.html">Found a bug</a>?
323323
<br />
324324

‎c-api/allocation.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -332,7 +332,7 @@ <h3>瀏覽</h3>
332332
<br />
333333
<br />
334334

335-
最後更新於 Dec 26, 2023 (07:52 UTC)。
335+
最後更新於 Dec 28, 2023 (15:24 UTC)。
336336
<a href="/bugs.html">Found a bug</a>?
337337
<br />
338338

0 commit comments

Comments
 (0)