Deploy preview for PR 1231 🛫

Author: pydoc-zh-tw[bot]

pr-preview/pr-1231/_sources/c-api/arg.rst.txt

@@ -392,13 +392,18 @@ inside nested parentheses.  They are:
    their default value --- when an optional argument is not specified,
    :c:func:`PyArg_ParseTuple` does not touch the contents of the corresponding C
    variable(s).
+   For example, the format string ``"OO|OO"`` corresponds to the Python
+   signature ``f(a, b, c=None, d=None)``.
 
 ``$``
    :c:func:`PyArg_ParseTupleAndKeywords` only:
    Indicates that the remaining arguments in the Python argument list are
-   keyword-only.  Currently, all keyword-only arguments must also be optional
-   arguments, so ``|`` must always be specified before ``$`` in the format
-   string.
+   keyword-only.
+   They are optional if ``|`` was specified before ``$``, and required otherwise.
+   ``|`` cannot be specified after ``$``.
+   For example, the format string ``"O|O$O"`` corresponds to the Python
+   signature ``f(a, b=None, *, c=None)``,
+   and the format string ``"OO$OO"`` corresponds to ``f(a, b, *, c, d)``.
 
    .. versionadded:: 3.3
 

pr-preview/pr-1231/_sources/library/argparse.rst.txt

@@ -1541,12 +1541,12 @@ it exits and prints the error along with a usage message::
    >>> # invalid option
    >>> parser.parse_args(['--bar'])
    usage: PROG [-h] [--foo FOO] [bar]
-   PROG: error: no such option: --bar
+   PROG: error: unrecognized arguments: --bar
 
    >>> # wrong number of arguments
    >>> parser.parse_args(['spam', 'badger'])
    usage: PROG [-h] [--foo FOO] [bar]
-   PROG: error: extra arguments found: badger
+   PROG: error: unrecognized arguments: badger
 
 
 Arguments containing ``-``
@@ -1583,7 +1583,7 @@ there are no options in the parser that look like negative numbers::
    >>> # negative number options present, so -2 is an option
    >>> parser.parse_args(['-2'])
    usage: PROG [-h] [-1 ONE] [foo]
-   PROG: error: no such option: -2
+   PROG: error: unrecognized arguments: -2
 
    >>> # negative number options present, so both -1s are options
    >>> parser.parse_args(['-1', '-1'])

pr-preview/pr-1231/_sources/library/asyncio-task.rst.txt

@@ -288,6 +288,17 @@ Creating tasks
               # completion:
               task.add_done_callback(background_tasks.discard)
 
+      Note that this approach never awaits the tasks, so if a task
+      fails, its exception is never retrieved and asyncio logs a
+      "Task exception was never retrieved" message when the task is
+      garbage collected.  To avoid this, use :class:`asyncio.TaskGroup`
+      which keeps a strong reference to each task, awaits them and
+      propagates their exceptions::
+
+          async with asyncio.TaskGroup() as tg:
+              for i in range(10):
+                  tg.create_task(some_coro(param=i))
+
    .. versionadded:: 3.7
 
    .. versionchanged:: 3.8

pr-preview/pr-1231/about.html

@@ -356,7 +356,7 @@ <h3>導航</h3>
 <a href="https://www.python.org/psf/donations/">敬請捐贈。</a>
 <br>
     <br>
-      最後更新於 8月 07, 2026 (01:19 UTC)。
+      最後更新於 8月 08, 2026 (00:21 UTC)。
 
       <a href="/bugs.html">發現 bug</a>？
 

pr-preview/pr-1231/bugs.html

@@ -393,7 +393,7 @@ <h3>導航</h3>
 <a href="https://www.python.org/psf/donations/">敬請捐贈。</a>
 <br>
     <br>
-      最後更新於 8月 07, 2026 (01:19 UTC)。
+      最後更新於 8月 08, 2026 (00:21 UTC)。
 
       <a href="/bugs.html">發現 bug</a>？
 

pr-preview/pr-1231/c-api/abstract.html

@@ -365,7 +365,7 @@ <h3>導航</h3>
 <a href="https://www.python.org/psf/donations/">敬請捐贈。</a>
 <br>
     <br>
-      最後更新於 8月 07, 2026 (01:19 UTC)。
+      最後更新於 8月 08, 2026 (00:21 UTC)。
 
       <a href="/bugs.html">發現 bug</a>？
 

pr-preview/pr-1231/c-api/allocation.html

@@ -577,7 +577,7 @@ <h3>導航</h3>
 <a href="https://www.python.org/psf/donations/">敬請捐贈。</a>
 <br>
     <br>
-      最後更新於 8月 07, 2026 (01:19 UTC)。
+      最後更新於 8月 08, 2026 (00:21 UTC)。
 
       <a href="/bugs.html">發現 bug</a>？
 

pr-preview/pr-1231/c-api/apiabiversion.html

@@ -514,7 +514,7 @@ <h3>導航</h3>
 <a href="https://www.python.org/psf/donations/">敬請捐贈。</a>
 <br>
     <br>
-      最後更新於 8月 07, 2026 (01:19 UTC)。
+      最後更新於 8月 08, 2026 (00:21 UTC)。
 
       <a href="/bugs.html">發現 bug</a>？
 

pr-preview/pr-1231/c-api/arg.html

@@ -529,13 +529,18 @@ <h3>其他物件<a class="headerlink" href="#other-objects" title="連結到這
 The C variables corresponding to optional arguments should be initialized to
 their default value --- when an optional argument is not specified,
 <a class="reference internal" href="#c.PyArg_ParseTuple" title="PyArg_ParseTuple"><code class="xref c c-func docutils literal notranslate"><span class="pre">PyArg_ParseTuple()</span></code></a> does not touch the contents of the corresponding C
-variable(s).</p>
+variable(s).
+For example, the format string <code class="docutils literal notranslate"><span class="pre">&quot;OO|OO&quot;</span></code> corresponds to the Python
+signature <code class="docutils literal notranslate"><span class="pre">f(a,</span> <span class="pre">b,</span> <span class="pre">c=None,</span> <span class="pre">d=None)</span></code>.</p>
 </dd>
 <dt><code class="docutils literal notranslate"><span class="pre">$</span></code></dt><dd><p><a class="reference internal" href="#c.PyArg_ParseTupleAndKeywords" title="PyArg_ParseTupleAndKeywords"><code class="xref c c-func docutils literal notranslate"><span class="pre">PyArg_ParseTupleAndKeywords()</span></code></a> only:
 Indicates that the remaining arguments in the Python argument list are
-keyword-only.  Currently, all keyword-only arguments must also be optional
-arguments, so <code class="docutils literal notranslate"><span class="pre">|</span></code> must always be specified before <code class="docutils literal notranslate"><span class="pre">$</span></code> in the format
-string.</p>
+keyword-only.
+They are optional if <code class="docutils literal notranslate"><span class="pre">|</span></code> was specified before <code class="docutils literal notranslate"><span class="pre">$</span></code>, and required otherwise.
+<code class="docutils literal notranslate"><span class="pre">|</span></code> cannot be specified after <code class="docutils literal notranslate"><span class="pre">$</span></code>.
+For example, the format string <code class="docutils literal notranslate"><span class="pre">&quot;O|O$O&quot;</span></code> corresponds to the Python
+signature <code class="docutils literal notranslate"><span class="pre">f(a,</span> <span class="pre">b=None,</span> <span class="pre">*,</span> <span class="pre">c=None)</span></code>,
+and the format string <code class="docutils literal notranslate"><span class="pre">&quot;OO$OO&quot;</span></code> corresponds to <code class="docutils literal notranslate"><span class="pre">f(a,</span> <span class="pre">b,</span> <span class="pre">*,</span> <span class="pre">c,</span> <span class="pre">d)</span></code>.</p>
 <div class="versionadded">
 <p><span class="versionmodified added">在 3.3 版被加入.</span></p>
 </div>
@@ -996,7 +1001,7 @@ <h3>導航</h3>
 <a href="https://www.python.org/psf/donations/">敬請捐贈。</a>
 <br>
     <br>
-      最後更新於 8月 07, 2026 (01:19 UTC)。
+      最後更新於 8月 08, 2026 (00:21 UTC)。
 
       <a href="/bugs.html">發現 bug</a>？
 

pr-preview/pr-1231/c-api/bool.html

@@ -376,7 +376,7 @@ <h3>導航</h3>
 <a href="https://www.python.org/psf/donations/">敬請捐贈。</a>
 <br>
     <br>
-      最後更新於 8月 07, 2026 (01:19 UTC)。
+      最後更新於 8月 08, 2026 (00:21 UTC)。
 
       <a href="/bugs.html">發現 bug</a>？