2e91dba437
Python 3.11.0a3
2021-12-08 22:24:29 +00:00
c0521fe49f
bpo-45840: Improve cross-references in the data model documentation (GH-29633)
2021-12-05 22:49:36 +02:00
c1f93f0d37
bpo-43905: Expand dataclasses.astuple() and asdict() docs (GH-26154)
...
Expanded ``astuple()`` docs, warning about deepcopy being applied
and providing a workaround.
Automerge-Triggered-By: GH:ericvsmith
2021-11-29 10:10:32 -08:00
024209401e
bpo-42238: [doc] Announce the future removal of make suspicous. (GH-29652)
...
* bpo-42238: [doc] Announce the future removal of make suspicous.
* Add a news entry.
2021-11-22 15:17:54 -08:00
be36e06340
bpo-45250: fix docs regarding `__iter__` and iterators being inconsistently required by CPython (GH-29170)
...
It is now considered a historical accident that e.g. `for` loops and the `iter()` built-in function do not require the iterators they work with to define `__iter__`, only `__next__`.
2021-11-19 16:40:34 -08:00
4575c01b75
bpo-45788: Link sys.prefix doc to 'Installation paths' ( #29606 )
...
... To the Installation paths section of the sysconfig doc.
2021-11-18 15:08:24 -05:00
32959108f9
bpo-45640: [docs] Tokens are now clickable (GH-29260)
...
Co-authored-by: Łukasz Langa <lukasz@langa.pl>
2021-11-18 17:06:38 +01:00
ad43dc0b54
bpo-25381: Update explanation of exceptions in C. (GH-26838)
...
* bpo-25381: Update explanation of exception globals
This paragraph in extending/extending.rst was unchanged (except for
NULL markup) since committed in 2007 Aug 15 for 2.6 alpha.
* Respond to reviews and remove duplication.
* Update Doc/extending/extending.rst
Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
2021-11-15 14:38:53 -08:00
4c792f39e6
bpo-45772: socket.socket should be a class instead of a function (GH-23960)
...
* bpo-45772: socket.socket should be a class instead of a function
Currently `socket.socket` is documented as a function, but it is really
a class (and thus has function-like usage to construct an object). This
correction would ensure that Python projects that are interlinking
Python's documentation can properly locate `socket.socket` as a type.
2021-11-13 08:02:04 +02:00
9127520729
bpo-45392: Update the docstring of the 'type' built-in (GH-29439)
2021-11-06 20:08:44 +01:00
e2b4e4bab9
Python 3.11.0a2
2021-11-05 19:04:04 +00:00
71e8a3e76a
bpo-45762: Improve docs for ``@singledispatch``/``@singledispatchmethod`` (GH-29426)
2021-11-05 17:25:08 +01:00
e03e50377d
bpo-45680: ``typing`` docs: improve links to docs on ``GenericAlias``/``__class_getitem__`` (GH-29387)
2021-11-04 12:06:34 +08:00
14a4fce457
bpo-45618: Update Sphinx version used to build the documentation to 4.2.0 (GH-29256)
...
Updating version of Sphinx to most recent one, 4.2.0. Documentation builds without warnings.
Sphinx 4.2.0 release notes: https://www.sphinx-doc.org/en/master/changes.html#release-4-2-0-released-sep-12-2021 .
cc @JulienPalard
Automerge-Triggered-By: GH:JulienPalard
2021-10-31 13:51:33 -07:00
03db1bbfd2
bpo-45655: Add "relevant PEPs" section to ``typing`` documentation (GH-29280)
...
The list of PEPs at the top of the documentation for the ``typing`` module has
become too long to be readable. This PR proposes presenting this
information in a more structured and readable way by adding a new "relevant
PEPs" section to the ``typing`` docs.
Co-authored-by: Łukasz Langa <lukasz@langa.pl>
2021-10-28 21:55:50 +02:00
1fb968c07a
bpo-45604: add `level` argument to `multiprocessing.log_to_stderr` func (GH-29226)
...
Co-authored-by: blurb-it[bot] <43283697+blurb-it[bot]@users.noreply.github.com>
2021-10-28 21:38:14 +02:00
8ce20bbdd6
bpo-45516: add protocol description to the TraversableResources documentation ( #29173 )
...
Signed-off-by: Filipe Laíns <lains@riseup.net>
2021-10-23 11:47:55 -04:00
dff0b71343
bpo-45464: [doc] Explain that subclassing multiple exceptions is fragile (GH-29094)
...
Co-authored-by: Pablo Galindo Salgado <Pablogsal@gmail.com>
2021-10-20 18:54:31 +02:00
7bafa0cf58
bpo-45449: add note about PEP 585 in collections.abc's documentation (GH-29047)
...
Signed-off-by: Filipe Laíns <lains@riseup.net>
Co-authored-by: Łukasz Langa <lukasz@langa.pl>
2021-10-19 20:18:50 +02:00
4d03de3329
bpo-45516: add protocol description to the Traversable documentation ( #29039 )
...
* bpo-45516: add protocol description to the Traversable documentation
Signed-off-by: Filipe Laíns <lains@riseup.net>
* Update Doc/library/importlib.rst
Co-authored-by: Jason R. Coombs <jaraco@jaraco.com>
* Update Lib/importlib/abc.py
* Update Doc/library/importlib.rst
Co-authored-by: Jason R. Coombs <jaraco@jaraco.com>
Co-authored-by: Jason R. Coombs <jaraco@jaraco.com>
2021-10-18 18:58:13 -04:00
380c440875
bpo-20692: Add Programming FAQ entry for 1.__class__ error. (GH-28918)
...
To avoid error, add either space or parentheses.
2021-10-13 01:14:58 -04:00
7c12e4835e
Python 3.11.0a1
2021-10-05 13:44:05 +01:00
06e1773c8d
bpo-45216: Remove extraneous method docs from `difflib` (GH-28445)
2021-09-21 23:31:12 +02:00
62fa613f6a
bpo-45024 and bpo-23864: Document how interface testing works with the collections ABCs (GH-28218)
2021-09-09 21:51:07 -05:00
5246dbc2a1
bpo-44756: Remove misleading NEWS entries of a change that was reverted before release (GH-28075)
2021-08-30 23:54:47 +02:00
7cba23164c
bpo-39452: Rewrite and expand __main__.rst ( #26883 )
...
Broadened scope of the document to explicitly discuss and differentiate between ``__main__.py`` in packages versus the ``__name__ == '__main__'`` expression (and the idioms that surround it), as well as ``import __main__``.
Co-authored-by: Géry Ogam <gery.ogam@gmail.com>
Co-authored-by: Éric Araujo <merwok@netwok.org>
Co-authored-by: Łukasz Langa <lukasz@langa.pl>
2021-08-24 19:01:41 +02:00
dabb6e8ddd
bpo-44957: Promote PEP 604 syntax in typing docs (GH-27833)
...
* Use "X | Y" instead of "Union" where it makes sense.
* Mention that "X | Y" is equivalent to "Union[X, Y]" in Union section.
* Remove "Optional[X]" as shorthand for "Union[X, None]" as the new
shorthand is now "X | None".
* Mention that "Optional[X]" can be written as "X | None" in section
about "Optional".
Co-authored-by: Ken Jin <28750310+Fidget-Spinner@users.noreply.github.com>
2021-08-22 20:45:01 +02:00
6a358bb948
bpo-44903: Removed othergui.rst and list of GUI frameworks (GH-27762)
2021-08-17 11:00:58 +02:00
ad0a8a9c62
bpo-16580: [doc] Add examples to int.to_bytes and int.from_bytes (GH-27760)
...
* added code equivs. for to_bytes and from_bytes
Based on woparry's patch[1] from the relevant issue thread[2].
[1]: https://bugs.python.org/file30372/issue16580.patch
[2]: https://bugs.python.org/issue16580
Co-authored-by: Mark Dickinson <dickinsm@gmail.com>
2021-08-15 12:29:05 +01:00
e43b9bbc31
bpo-36700: [doc] Update base64 RFC references to RFC 4648 (GH-27700)
...
Co-authored-by: Łukasz Langa <lukasz@langa.pl>
2021-08-13 12:58:55 +02:00
08caf2d5d4
bpo-33479: Add architecture and threading model sections to Tkinter module docs (GH-27717)
...
Co-authored-by: Łukasz Langa <lukasz@langa.pl>
2021-08-11 18:29:15 +02:00
6b37d0d530
bpo-33479: Remove unqualified tkinter threadsafe claim. (GH-6990)
...
It has not been true for several years and likely never was.
2021-08-10 11:32:21 +02:00
c5c5326d47
bpo-39498 Start linking the security warnings in the stdlib modules (GH-18272)
...
Co-authored-by: Łukasz Langa <lukasz@langa.pl>
2021-08-10 00:35:51 +02:00
e9a6f1b78b
bpo-41576: document BaseException in favor of bare except (GH-21917)
2021-08-06 22:44:15 +02:00
0ffdced3b6
bpo-27752: improve documentation of csv.Dialect (GH-26795)
...
Co-authored-by: Łukasz Langa <lukasz@langa.pl>
2021-08-06 22:05:16 +02:00
55fa87b1ef
bpo-44756: [docs] revert automated virtual environment creation on `make html` (GH-27635)
...
It turned out to be disruptive for downstream distributors.
2021-08-06 20:13:59 +02:00
80f33f266b
bpo-41706: Fix special method invocation docs to mention using type() (GH-22084)
2021-08-04 13:43:06 -07:00
a8dc4893d2
bpo-42958: Improve description of shallow= in filecmp.cmp docs (GH-27166)
...
Co-authored-by: Łukasz Langa <lukasz@langa.pl>
Co-authored-by: Alexander Vandenbulcke <alexander.vandenbulcke95@gmail.com>
2021-08-04 21:39:45 +02:00
7c5dab4340
[doc] bpo-43066: zipfile - add note on leading slash in the filename arg (GH-26899)
...
Co-authored-by: Łukasz Langa <lukasz@langa.pl>
2021-08-04 21:34:34 +02:00
aa0894b379
bpo-35183: Add typical examples to os.path.splitext docs (GH-27286)
2021-08-02 19:01:53 +02:00
c1e39d6b11
bpo-44544: [doc] list all textwrap func kwargs (GH-26999)
2021-07-28 17:14:54 +02:00
11749e2dc2
bpo-44740: Lowercase "internet" and "web" where appropriate. ( #27378 )
...
Co-authored-by: Łukasz Langa <lukasz@langa.pl>
2021-07-27 00:11:55 +02:00
f22737abfa
The current documentation says it returns None if the name is not found, but (GH-26785)
...
the implementation uses [] and will raise KeyError instead.
Noticed by @srittau in python/typeshed@5659.
2021-07-26 18:18:19 +02:00
0363a4014d
bpo-44693: Update __future__ entry in Doc/glossary.rst (GH-27349)
...
Replace sentence with confusing "pseudo-module" with two sentences
separating future statements and the __future__ module.
Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu>
2021-07-25 21:11:12 -04:00
c05a790693
bpo-44651: delete entry of "coercion" in Doc/glossary.rst (GH-27226)
...
bpo 44651: delete entry of "coercion".
2021-07-22 13:18:07 +01:00
64f54b7ccd
bpo-30511: Add note on thread safety to shutil.make_archive() ( #26933 )
...
Co-authored-by: Łukasz Langa <lukasz@langa.pl>
2021-07-21 10:33:11 +02:00
85fa3b6b7c
bpo-44631: Make the repr() of the _Environ class more readable. ( #27128 )
...
Co-authored-by: Łukasz Langa <lukasz@langa.pl>
2021-07-20 19:15:45 +02:00
b494685b25
bpo-44561: Update hyperlinks in Doc/distributing/index.rst ( #27032 )
...
* Update hyperlinks in Doc/distributing/index.rst
Update three expired hyperlinks.
Closes bpo-44561.
2021-07-19 10:10:48 +10:00
f6954cdfc5
bpo-44613: Make importlib.metadata non-provisional ( #27101 )
...
* importlib.metadata is no longer provisional as of 3.10
* Add NEWS entry
2021-07-12 16:56:40 -07:00
6bd3ecfc27
bpo-44558: Match countOf `is`/`==` treatment to c (GH-27007)
2021-07-07 22:28:09 +09:00
12803c59d5
bpo-38062: [doc] clarify that atexit uses equality comparisons internally. (GH-26935)
2021-06-29 18:28:03 +01:00
2f49c9debc
bpo-40620: Clarify tutorial controlflow.rst ``range`` examples (GH-26919)
2021-06-27 20:27:20 +01:00
d1ae57027f
bpo-41621: Document defaultdict's default_factory parameter (GH-21945)
...
It defaults to None and is positional only.
2021-06-22 10:19:24 -04:00
51f45d085d
bpo-13814: Explain why generators are not context managers (GH-26835)
...
Put entry in Design FAQ after a question about a context manager for assignment.
Original patch by Aidan Lowe.
2021-06-21 17:23:29 -04:00
6773c3eaa7
bpo-44392: Add Py_GenericAlias to C API docs (GH-26724)
...
Also fix stable ABI type definitions
2021-06-16 07:12:25 -07:00
8a76683cfb
bpo-38291: Remove mention of typing.io and typing.re again (GH-26113)
...
They were originally removed in GH-10173 per bpo-35089, but then
readded in GH-21574. Cf. bpo-38291 for decision to remove.
2021-06-14 07:45:19 -07:00
878d7e4ee4
bpo-21760: fix __file__ description (GH-19097)
2021-06-09 14:10:20 -07:00
67dfa6f2a5
bpo-44322: Document more SyntaxError details. (GH-26562)
...
1. SyntaxError args have a tuple of other attributes.
2. Attributes are adjusted for errors in f-string field expressions.
3. Compile() can raise SyntaxErrors.
2021-06-06 21:42:31 -04:00
d8fd8c8568
bpo-42392: [docs] Add deprecated-removed loop labels for asyncio (GH-26357)
...
* Add deprecated-removed loop labels for all reelvant functions/classes in asyncio
2021-05-26 14:59:34 -07:00
7148293d96
bpo-44195: Use 'TraversableResources' in the docs to match the implementation. (GH-26317)
2021-05-24 13:08:10 -04:00
02ee819126
bpo-41963: document that ConfigParser strips off comments (GH-26197)
...
Co-authored-by: blurb-it[bot] <43283697+blurb-it[bot]@users.noreply.github.com>
Co-authored-by: Laura Gutierrez Funderburk <58710704+lgfunderburk@users.noreply.github.com>
2021-05-18 18:11:23 +02:00
4aa63d65a9
bpo-44072: fix Complex, Integral docs for `**` (GH-25986)
...
In numbers module docstrings and docs.
2021-05-14 18:01:48 -04:00
2a031723ee
bpo-43558: Add note about base class initialization to dataclasses doc (GH-25967)
2021-05-10 09:30:22 -04:00
164d6e1bb1
Add the blurbify of the 3.10.0b1 changelog to the main branch (GH-25976)
2021-05-07 22:31:01 -04:00
3b200b2aa6
bpo-44025: Clarify when '_' is a keyword. ( #25873 )
...
In match statements, in case patterns and nowhere else.
Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
2021-05-04 11:00:29 +02:00
9387fac100
bpo-43977: Document the new pattern matching type flags (GH-25734)
2021-05-02 15:35:00 -07:00
49b26fa517
bpo-43987: Add "Annotations Best Practices" HOWTO doc. ( #25746 )
...
Add "Annotations Best Practices" HOWTO doc.
2021-05-01 21:19:24 -07:00
4c49be7668
bpo-43959: clarify the documentation of the PyContextVar C-API (GH-25671)
...
Automerge-Triggered-By: GH:scoder
2021-04-28 07:03:19 -07:00
8a307e488d
bpo-43938: improve dataclasses.FrozenInstanceError documentation (GH-25603)
2021-04-26 14:53:28 -04:00
ea9b2d6319
bpo-43739: Add type declaration Doc/extending/extending.rst example
2021-04-10 08:54:32 -07:00
f32d022147
bpo-43778: Fix Sphinx glossary_search extension (GH-25286)
...
Create the _static/ directory if it doesn't exist.
Add also constants for the static directory and the JSON filename.
2021-04-09 00:07:01 +02:00
0fdf11e8e9
bpo-43755: Update docs to reflect that lambda is not allowed in `comp_if` since 3.9 (GH-25231)
2021-04-06 23:15:37 +01:00
53e55290cf
Python 3.10.0a7
2021-04-05 17:39:49 +01:00
027b669927
bpo-43354: xmlrpc: Fix type documentation for Fault.faultCode (GH-24707)
...
The type of `faultCode` has to be an `int` instead of a `str`.
cf http://xmlrpc.com/spec.md
Pinging @pganssle
2021-03-26 14:09:09 -07:00
0269ce87c9
bpo-41933: Clarify wording for s * n in Common Sequence Operations (GH-22570)
2021-03-15 23:50:49 +01:00
5e29021a5e
bpo-43199: Briefly explain why no goto (GH-24852)
...
Answer "Why is there no goto?" in the Design and History FAQ.
2021-03-14 18:12:04 -04:00
ff5f05934d
bpo-43407: Clarify comparisons of time.monotonic() et al results (GH-24757)
...
Previous wording implied that only the result of call N and N+1 could be
meaningfully compared, whereas comparing call N and N+M is fine.
2021-03-05 20:22:13 -05:00
06c245fb67
Python 3.10.0a6
2021-03-01 16:45:40 +00:00
2d6f2eed14
bpo-36346: Document removal schedule of deprecate APIs (GH-20879)
...
We will remove wstr cache in Python 3.12. See PEP 623.
2021-02-23 08:06:51 +09:00
2f9ef514fb
bpo-27646: Say that 'yield from' expression can be any iterable (GH-24595)
...
Previously, the doc at least strongly implied that it had to be an iterator.
2021-02-20 21:33:25 -05:00
22dbd9e8c0
Python 3.10.0a5
2021-02-02 20:41:05 +00:00
644d52818a
bpo-40304: Correct type(name, bases, dict) doc (GH-19553)
...
Co-authored-by: Éric Araujo <merwok@netwok.org>
Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu>
Co-authored-by: Tal Einat <532281+taleinat@users.noreply.github.com>
2021-01-22 00:47:23 -05:00
ff8458b918
bpo-42811: Update importlib.utils.resolve_name() docs to use __spec__.parent (GH-24100)
...
Automerge-Triggered-By: GH:brettcannon
2021-01-06 09:42:10 -08:00
445f7f54b1
Python 3.10.0a4
2021-01-04 17:26:00 +00:00
8c5d0347ef
bpo-34398: Allow glossary results to show up on search page (GH-8773)
2020-12-18 20:00:51 +01:00
84ebcf271a
bpo-17140: Document multiprocessing's ThreadPool (GH-23812)
...
Up until now, the `multiprocessing.pool.ThreadPool` class has gone
undocumented, despite being a public class in multiprocessing that is
included in `multiprocessing.pool.__all__`.
2020-12-18 13:05:46 +00:00
8bae2a958e
Python 3.10.0a3
2020-12-07 19:34:10 +00:00
c9c6e9f89a
bpo-42238: Doc: Remove make suspicious from the CI and docs builds. (GH-23313)
...
It probably helped a lot a while back, but may not be as usefull
today. We'll continue monitoring it before deletion, so true
positives can be migrated to rstlint.
2020-11-25 10:18:00 +01:00
aa01011003
bpo-42153 Fix link to IMAP documents in imaplib.rst (GH-23297)
...
The University of Washington stopped hosting the IMAP documents. Link to a rescued copy on GitHub.
2020-11-15 21:02:35 -08:00
ee2549c2ba
bpo-41028: Doc: Move switchers to docsbuild-scripts. (GH-20969)
2020-11-07 12:28:31 +01:00
114ee5dec0
Python 3.10.0a2
2020-11-03 00:02:08 +00:00
3317466061
bpo-42061: Document __format__ for IP addresses (GH-23018)
...
Automerge-Triggered-By: GH:ericvsmith
2020-10-29 15:17:59 -07:00
4173320920
bpo-41805: Documentation for PEP 585 (GH-22615)
2020-10-27 14:37:18 -07:00
c60394c7fc
bpo-39416: Document some restrictions on the default string representations of numeric classes (GH-18111)
...
[bpo-39416](): Document string representations of the Numeric classes
This is a change to the specification of the Python language.
The idea here is to put sane minimal limits on the Python language's default
representations of its Numeric classes. That way "Marty's Robotic Massage Parlor
and Python Interpreter" implementation of Python won't do anything too
crazy.
Some discussion in the email thread:
Subject: Documenting Python's float.__str__()
https://mail.python.org/archives/list/python-dev@python.org/thread/FV22TKT3S2Q3P7PNN6MCXI6IX3HRRNAL/
2020-10-21 10:13:50 -07:00
7cdf30fff3
bpo-42010: [docs] Clarify subscription of types (GH-22822)
2020-10-20 16:38:08 -07:00
ec42789e6e
bpo-39693: mention KeyError in tarfile extractfile documentation (GH-18639)
...
Co-authored-by: Andrey Darascheka <andrei.daraschenka@leverx.com>
2020-10-20 10:05:01 -04:00
8e9afaf822
Python 3.10.0a1
2020-10-05 18:30:18 +01:00
8e1dd55e63
bpo-41428: Documentation for PEP 604 (gh-22517)
2020-10-04 21:40:52 -07:00
5b0181d1f6
bpo-41774: Add programming FAQ entry (GH-22402)
...
In the "Sequences (Tuples/Lists)" section, add
"How do you remove multiple items from a list".
2020-09-29 01:02:44 -04:00
6595cb0af4
bpo-35293: Remove RemovedInSphinx40Warning (GH-22198)
...
* bpo-35293: Remove RemovedInSphinx40Warning
* Update Misc/NEWS.d/next/Documentation/2020-09-12-17-37-13.bpo-35293._cOwPD.rst
Co-authored-by: Victor Stinner <vstinner@python.org>
* bpo-35293: Apply Victor's review
Co-authored-by: Victor Stinner <vstinner@python.org>
2020-09-18 18:22:36 +09:00
06d0b8b67e
bpo-37149: Change Shipman tkinter link from archive.org to TkDocs (GH-22188)
...
The new link responds much faster and begins with a short explanation of the status of the doc.
2020-09-10 16:04:20 -04:00
1e2f051a61
bpo-41726: Update the refcounts info of PyType_FromModuleAndSpec in refcounts.dat (GH-22112)
...
Update refcounts info of PyType_FromModuleAndSpec in refcounts.dat
2020-09-09 11:48:44 +02:00
e223d06a8b
bpo-39883: Use BSD0 license for code in docs (GH-17635)
...
The PSF board approved this use.
2020-09-02 22:22:36 -07:00
8c58d2a216
bpo-41624: fix documentation of typing.Coroutine (GH-21952)
2020-08-27 02:42:37 +02:00
423e77d6de
bpo-40204: Allow pre-Sphinx 3 syntax in the doc (GH-21844)
...
Enable Sphinx 3.2 "c_allow_pre_v3" option and disable the
c_warn_on_allowed_pre_v3 option to make the documentation compatible
with Sphinx 2 and Sphinx 3.
2020-08-12 21:49:22 +02:00
ab72fdeb82
bpo-40979: refactored typing.rst; (mostly) same content, new sub-sections and ordering ( #21574 )
...
Also added PEP 585 deprecation notes.
2020-08-02 15:32:36 -07:00
13efaec2e0
bpo-41045: Document debug feature of f-strings ('=') (GH-21509)
...
Co-Authored-By: Rishi <rishi93dev@gmail.com>
Automerge-Triggered-By: @gvanrossum
2020-07-27 15:31:02 -07:00
0028c14073
bpo-41314: fixed annotations __future__ version (GH-21616)
...
PEP 563 was updated to change the release where `from __future__ import annotations` becomes the default (and only) behavior from 4.0 to 3.10. Update `__future__.py` and its docs to reflect this.
2020-07-25 14:42:49 -07:00
d42528a3a2
bpo-37703: improve asyncio.gather documentation regarding cancellation (GH-15312)
...
These changes updates the doc to comprehensively mention the behaviour of gather.cancel()
Automerge-Triggered-By: @asvetlov
2020-07-20 01:42:57 -07:00
6fad3e6b49
bpo-40552 Add 'users' variable in code sample (tutorial 4.2). (GH-19992)
...
* Add 'users' variable in code sample.
* 📜 🤖 Added by blurb_it.
Co-authored-by: blurb-it[bot] <43283697+blurb-it[bot]@users.noreply.github.com>
2020-05-22 21:29:34 -03:00
18cb3be41b
Consolidate 3.9.0b1 NEWS in the master branch
2020-05-19 13:33:08 +02:00
eefd4e0333
bpo-39705 : sorted() tutorial example under looping techniques improved (GH-18999)
2020-05-17 18:32:34 -07:00
de92769d47
bpo-34790: add version of removal of explicit passing of coros to `asyncio.wait`'s documentation ( #20008 )
2020-05-13 11:55:12 -07:00
ef7973a981
bpo-40561: Add docstrings for webbrowser open functions (GH-19999)
...
Co-authored-by: Brad Solomon <brsolomon@deloitte.com>
Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu>
2020-05-11 14:50:11 -04:00
9d74658f0a
bpo-40499: Mention that asyncio.wait() needs a non-empty aws set (GH-19900)
...
A similar formulation was added in bpo-21596
(db74d982d43faaa8857a
2020-05-04 14:56:00 -07:00
289842ae82
bpo-39435: Fix docs for pickle.loads (GH-18160)
2020-05-01 12:46:01 -07:00
bc1c8af8ef
Python 3.9.0a6
2020-04-27 22:44:04 +02:00
b54e46cb57
bpo-38387: Formally document PyDoc_STRVAR and PyDoc_STR macros (GH-16607)
...
Adds a short description of `PyDoc_STRVAR` and `PyDoc_STR` to "Useful macros" section of C-API docs.
Currently, there is [one lone mention](https://docs.python.org/3/c-api/module.html?highlight=pydoc_strvar#c.PyModuleDef ) in the C-API reference, despite the fact that `PyDoc_STRVAR` is ubiquitous to `Modules/`.
Additionally, this properly uses `c:macro` within `Doc/c-api/module.rst` to link.
2020-04-26 21:31:44 -05:00
482259d0dc
bpo-27635: Fix pickle documentation about `__new__` not being called. (GH-19269)
...
Automerge-Triggered-By: @pitrou
2020-04-18 11:09:09 -07:00
63e5b59c06
bpo-13743: Add some documentation strings to xml.dom.minidom (GH-16355)
2020-04-12 16:21:58 +02:00
59c644eaa7
bpo-39879: Update datamodel docs to include dict ordering (GH-19006)
...
Co-authored-by: furkanonder <furkantahaonder@gmail.com>
2020-03-26 09:54:04 -05:00
dcd4c4f9c9
Python 3.9.0a5
2020-03-23 17:19:13 +01:00
6672c16b1d
bpo-39677: dis: rename the operand of MAKE_FUNCTION from `argc` to `flags` for 3.6+ (GC-18550)
2020-03-14 16:24:06 +02:00
e59334ebc9
bpo-17422: slightly more precise language (GH-18682)
2020-03-06 10:20:48 -08:00
8bae21962b
bpo-39868: Update Language Reference for PEP 572. ( #18793 )
2020-03-05 21:19:22 -08:00
9f1cb1bb49
Fix misleading statement about mixed-type numeric comparisons (GH-18615)
2020-03-02 08:57:27 +00:00
c2f7eb254b
bpo-39718: add TYPE_IGNORE, COLONEQUAL to py38 changes in token (GH-18598)
2020-02-28 18:25:36 -05:00
916895f939
bpo-13790: Change 'string' to 'specification' in format doc (GH-18690)
2020-02-28 14:59:16 -05:00
6e02691f30
Python 3.9.0a4
2020-02-25 22:06:39 +01:00
aea045adb8
bpo-39654: Update pyclbr doc to reflect additional information returned (GH-18528)
...
Full nested function and class info makes it a module browser.
Co-authored-by: blurb-it[bot] <43283697+blurb-it[bot]@users.noreply.github.com>
Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu>
2020-02-23 21:00:40 -05:00
fbe2e0bb8a
bpo-17422: Language reference should specify restrictions on class namespace ( #18559 )
...
The language reference now specifies restrictions on class namespaces. Adapted from a patch by Ethan Furman.
2020-02-22 09:56:01 -08:00
ab6423fe2d
bpo-39572: Document ’total’ flag of TypedDict (GH-18554)
2020-02-18 20:33:05 -08:00
a4ba8a3983
Include subsections in TOC for PDF version of docs. (GH-9629)
2020-02-19 00:01:15 +01:00
6c9974e12c
bpo-39369 Doc: Update mmap readline method documentation (GH-17957)
...
* Update mmap readline method documentation
Update mmap `readline` method description. The fact that the `readline` method does update the file position should not be ignored since this might give the impression for the programmer that it doesn't update it.
* 📜 🤖 Added by blurb_it.
Co-authored-by: blurb-it[bot] <43283697+blurb-it[bot]@users.noreply.github.com>
2020-02-10 12:13:41 -08:00
e1e80002e2
bpo-39153: Clarify C API *SetItem refcounting semantics (GH-18220)
...
Some of the *SetItem methods in the C API steal a reference to the
given value. This annotates the better behaved ones to assure the
reader that these are not the ones with the inconsistent behaviour.
* 📜 🤖 Added by blurb_it.
* make docs consistent with signature
Co-authored-by: blurb-it[bot] <43283697+blurb-it[bot]@users.noreply.github.com>
2020-01-29 21:20:53 +10:00
2824c45a0a
bpo-39392: Turtle overlap fill depends on OS ( #18223 )
...
Whether or not overlap regions for self-intersecting polygons
or multiple shapes are filled depends on the operating system graphics,
typeof overlap, and number of overlaps.
2020-01-27 18:41:18 -05:00
c33378df39
Python 3.9.0a3
2020-01-24 22:05:07 +01:00
2c49becc69
Fix asyncio.get_event_loop() documentation (GH-18051)
...
Mention that the function implicitly creates new event loop only if called from the main thread.
2020-01-21 00:46:38 +02:00
6680f4a9f5
bpo-3530: Add advice on when to correctly use fix_missing_locations in the AST docs (GH-17172)
...
Co-authored-by: Pablo Galindo <Pablogsal@gmail.com>
2020-01-12 20:38:53 +00:00
f522a6ddb6
bpo-38918: Add __module__ entry for function & method type in inspect docs table (GH-17408)
...
Adds` __module__ ` entries for function & method types in inspect docs table.
https://bugs.python.org/issue38918
2019-12-20 11:18:33 -08:00
6202d856d6
Python 3.9.0a2
2019-12-18 22:09:19 +01:00
680068c288
Minor fixes to the NEWS entries (GH-17556)
2019-12-10 16:09:58 +00:00
c18b805ac6
bpo-39002: Fix simple typo: tranlation -> translation (GH-17517)
2019-12-09 09:42:17 -08:00
045d4e243d
bpo-38928: Fix versionadded for venv's upgrade_deps function (GH-17404)
2019-11-27 20:21:48 +00:00
bc441ed7c1
bpo-22377: Fixes documentation for %Z in datetime (GH-16507)
...
This fixes the issue discussed in https://bugs.python.org/issue22377
and fixes it according to the comments made by Paul Ganssle @pganssle
* It clarifies which values are acceptable in the table
* It extends the note with a clearer information on the valid values
https://bugs.python.org/issue22377
2019-11-26 08:38:41 -08:00
84b1ff6560
bpo-38899: virtual environment activation for fish should use `source` (GH-17359)
...
The previously documented use of `.` is considered deprecated (https://fishshell.com/docs/current/commands.html#source ).
https://bugs.python.org/issue38899
Automerge-Triggered-By: @brettcannon
2019-11-22 23:32:27 -08:00
fd757083df
Python 3.9.0a1
2019-11-19 12:17:21 +01:00
24555ce2f9
bpo-21767: explicitly mention abc support in functools.singledispatch docs ( #17171 )
2019-11-19 09:16:46 +01:00
73cdb0c6b2
bpo-38816: Add notes in the C-API docs about fork in subinterpreters. (GH-17176)
...
The C-API docs are a bit sparse on the interplay between C `fork()` and the CPython runtime. This change adds some more information on the subject.
https://bugs.python.org/issue38816
2019-11-15 13:28:54 -08:00
b22030073b
bpo-38778: Document that os.fork is not allowed in subinterpreters (GH-17123)
...
Small docs update for [bpo-34651](https://bugs.python.org/issue34651 ).
Other references to fork (e.g. the PyOS.*Fork functions or discussions of fork() when embedding Python) point back to os.fork, so I don't think any other updates are needed.
https://bugs.python.org/issue38778
Automerge-Triggered-By: @ericsnowcurrently
2019-11-15 08:56:03 -08:00
Pablo Galindo
Alex Waygood
andrei kulakov
Julien Palard
Brett Cannon
Terry Jan Reedy
Arthur Milchior
Hong Xu
Mark Dickinson
m-aciek
Nikita Sobolev
Filipe Laíns
Łukasz Langa
Filipe Laíns
Raymond Hettinger
Jack DeVries
Sebastian Rittau
Gautam Chaudhuri
Mark Roseman
Anthony Shaw
Thomas Grainger
William Chargin
Jake Stockwin
Mariusz Felisiak
Jelle Zijlstra
Steven Hsu
Leonardo Freua
Barry Warsaw
Rupert Tombs
Dennis Sweeney
Ken Jin
Furkan Onder
Jason R. Coombs
Jürgen Gmach
Rory Yorke
dhoekstra2000
Ned Deily
Brandt Bucher
larryhastings
scoder
Llandy Riveron Del Risco
Shreyan Avigyan
Victor Stinner
Saiyang Gou
Chavdar Yotov
Alex Willmer
Inada Naoki
Борис Верховский
Yair Frid
Ammar Askar
Matt Wozniski
Yash Shete
Teugea Ioan-Teodor
kpinc
Andrey Doroschenko
Dong-hee Na
Hai Shi
Todd
MingZhe Hu
Luciano Ramalho
amaajemyfren
YoSTEALTH
Vinay Sharma
Antoine
Rahul Kumaresan
jack1142
Brad Solomon
Joel Rosdahl
Shantanu
Alex Itkes
Lahfa Samy
Taine Zhao
Caleb Donovick
Brandt Bucher
Hakan Çelik
ananthan-123
Cheryl Sabella
Wellington Pardim
Joannah Nanjekye
Andrew Svetlov
Batuhan Taşkaya
Parth Sharma
Tim Gates
Tzu-ping Chung
Karl Dubost
Brett Cannon
Eric Snow
Phil Connell