Edward K. Ream
e3c971ccfa
Add links to asttokens, leoAst, LibCST and parso to ast docs (GH-21773)
2020-08-11 07:07:49 -07:00
Victor Stinner
fabd7bb8e0
bpo-41521: Replace whitelist/blacklist with allowlist/denylist (GH-21822)
...
Automerge-Triggered-By: @tiran
2020-08-11 06:26:59 -07:00
Filipe Laíns
4ce6faa6c9
bpo-16995: add support for base32 extended hex (base32hex) (GH-20441)
...
cc @pganssle
Automerge-Triggered-By: @pganssle
2020-08-10 07:48:20 -07:00
Stefan Krah
39042e00ab
bpo-41324 Add a minimal decimal capsule API ( #21519 )
2020-08-10 16:32:21 +02:00
Zackery Spytz
e28b8c9387
bpo-35018: Sax parser should provide user access to lexical handlers (GH-20958)
...
Co-Authored-By: Jonathan Gossage <jgossage@gmail.com>
2020-08-09 12:50:53 +02:00
Jiajie Zhong
67acf74c4e
Doc: Add output to example code in programming FAQ (GH-21346)
...
Add output hint to document, part faq/programming, section [How do I write a function with output parameters (call by reference)?](https://docs.python.org/3/faq/programming.html#how-do-i-write-a-function-with-output-parameters-call-by-reference ).
This patch make the output hint just like prefix code block.
2020-08-08 12:29:03 -07:00
Yaroslav Pankovych
82ca8fada1
bpo-41455: Provide a link to how the third generation is collected in the GC docs (GH-21703)
...
Co-authored-by: Pablo Galindo <Pablogsal@gmail.com>
2020-08-08 19:48:21 +01:00
Benjamin Kane
705f145565
Doc: Add a link to tutorial page from `open()` doc (GH-21737)
...
Adds a link to the "Reading and Writing Files" page so users can
more easily discover how file handles are handled with the `with`
context manager vs without it.
2020-08-08 11:57:03 +09:00
Inada Naoki
46e19b61d3
bpo-41098: Doc: Add missing deprecated directives (GH-21162)
...
PyUnicodeEncodeError_Create has been deprecated with
`Py_DEPRECATED` macro. But it was not documented.
2020-08-07 16:31:53 +09:00
pxinwr
3405e05428
bpo-41440: add os.cpu_count() support for VxWorks RTOS (GH-21685)
2020-08-07 14:21:52 +09:00
Inada Naoki
270b4ad4df
bpo-36346: Doc: Update removal schedule of legacy Unicode (GH-21479)
...
See PEP 623 for detail.
2020-08-05 10:48:51 +09:00
Hans Petter Jansson
da4e09fff6
bpo-36982: Add support for extended color functions in ncurses 6.1 (GH-17536)
...
Co-authored-by: Jeffrey Kintscher <websurfer@surf2c.net>
2020-08-03 23:51:33 -04:00
Ankit Chandawala
c36dbac588
bpo-41425: Make tkinter doc example runnable (GH-21706)
...
Co-authored-by: Ankit Chandawala <achandaw@amazon.com>
Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu>
2020-08-03 00:03:48 -04:00
Nathan M
ecaf949cc4
bpo-41424: Remove extra words in Tkinter-Packer documentation (GH-21707)
2020-08-02 22:13:03 -04:00
Luciano Ramalho
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
Sebastien Williams-Wynn
ba18c0b13b
bpo-41426 Fix grammar in curses.getmouse() documentation (GH-21677)
...
Automerge-Triggered-By: @brettcannon
2020-07-29 11:36:46 -07:00
Yonatan Goldschmidt
f6a16e8a82
Remove incorrect mention of method.__class__ in descriptor docs (GH-21665)
2020-07-28 16:56:26 -07:00
Xiang Zhang
34cd3e9f6a
Fix `List_Append` description, list is extracted at TOS1[-i] (GH-21465)
2020-07-29 00:51:33 +08:00
Dmytro Litvinov
5e3826785d
bpo-41328: Replace mention of Hudson CI with Travis CI and AppVeyor (GH-21653)
2020-07-28 07:48:32 -07:00
amaajemyfren
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
Pablo Galindo
72cabb2aa6
bpo-40939: Use the new grammar for the grammar specification documentation (GH-19969)
...
(We censor the heck out of actions and some other stuff using a custom "highlighter".)
Co-authored-by: Guido van Rossum <guido@python.org>
2020-07-27 11:20:36 -07:00
Guido van Rossum
508ed2d912
Delete remaining references to Grammar/Grammar from docs ( #21624 )
...
(Ironically, the file itself remains, see https://github.com/we-like-parsers/cpython/issues/135 .)
2020-07-26 08:27:52 -07:00
Shankar Jha
f117cef25b
bpo-39868: Add documentation for Assignment Expressions (walrus, PEP 572) ( #18851 )
2020-07-25 16:33:48 -07:00
YoSTEALTH
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
Gregory Schevchenko
daff39070e
bpo-38731: Add --quiet option to py_compile CLI (GH-17134)
2020-07-25 22:58:45 +03:00
Andre Delfino
b9f6ac9d46
Stick with the phrase "default parameter value" (GH-21590)
2020-07-22 20:58:19 -03:00
Ammar Askar
5241e189e7
bpo-41283: Fix mismatched argument name for imghdr.what (GH-21501)
2020-07-20 21:22:01 -03:00
Serhiy Storchaka
12f433411b
bpo-41334: Convert constructors of str, bytes and bytearray to Argument Clinic (GH-21535)
2020-07-20 15:53:55 +03:00
Volker-Weissmann
f9bf015799
Simple Documentation fix: Missing link to return type class. (GH-21291)
...
Just a simple documentation fix: apply_async and map_async return a "multiprocessing.pool.AsyncResult Object", not a "result object".
2020-07-20 04:26:32 -07:00
Vinay Sharma
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
Julien Palard
7f03445d01
Doc: fix import of asdl.py when called from outside Doc/. (GH-21529)
2020-07-20 09:48:40 +02:00
Srinivas Reddy Thatiparthy (శ్రీనివాస్ రెడ్డి తాటిపర్తి)
10e466448f
bpo-41205: Document Decimal power 0 to the 0 (GH-21386)
...
Co-authored-by: Mark Dickinson <dickinsm@gmail.com>
2020-07-19 13:03:43 +02:00
Jordan Speicher
9b01c598ca
bpo-41325: Add version note for args and kwargs property in call object (GH-21525)
2020-07-18 18:35:44 +05:30
matthewhughes934
8e836bb21c
bpo-41195: Add getter for Openssl security level (GH-21282)
...
Add an accessor under SSLContext.security_level as a wrapper around
SSL_CTX_get_security_level, see:
https://www.openssl.org/docs/manmaster/man3/SSL_CTX_get_security_level.html
------
This is my first time contributing, so please pull me up on all the things I missed or did incorrectly.
Automerge-Triggered-By: @tiran
2020-07-17 01:59:15 -07:00
Christopher Yeh
5e5c0f9866
Remove unnecessary spaces in code blocks in urllib.parse.rst (GH-21500)
...
This should also fix the syntax highlighting for these code blocks
Automerge-Triggered-By: @csabella
2020-07-16 04:22:32 -07:00
Berker Peksag
d4d127f1c6
bpo-31844: Move whatsnew note to 3.10.rst (GH-21504)
2020-07-16 09:38:58 +03:00
Berker Peksag
e34bbfd61f
bpo-31844: Remove _markupbase.ParserBase.error() (GH-8562)
2020-07-16 09:13:05 +03:00
JustAnotherArchivist
2a5181829a
bpo-32528: Document the change in inheritance of asyncio.CancelledError (GH-21474)
...
#msg373510
[bpo-32528]()/#13528 changed `asyncio.CancelledError` such that it no longer inherits from `concurrent.futures.CancelledError`. As this affects existing code, specifically when catching the latter instead of the former in exception handling, it should be documented in the "What's new in 3.8?" document.
Automerge-Triggered-By: @1st1
2020-07-14 10:22:43 -07:00
Paul McMillan
4f28f75dee
Fix repeated words in Classes tutorial (GH-21455)
...
The phrase "At any time during execution," was repeated twice.
Automerge-Triggered-By: @Mariatta
2020-07-13 18:26:23 -07:00
Joannah Nanjekye
8dd32fe645
bpo-32192: A basic lazy importer example (GH-21330)
...
* Add example on lazy imports
* Use four spaces for indentation
* change to console
2020-07-13 18:31:02 -03:00
Nima Dini
344dce312a
bpo-41228: Fix /a/are/ in monthcalendar() descripton (GH-21372)
2020-07-10 21:54:53 -04:00
marload
6fc732a211
Fix typo in docs: 'created by th' -> 'created by the' (GH-21384)
2020-07-10 21:13:31 +05:30
Joannah Nanjekye
3cbade7d30
bpo-23802: patch: __deepcopy__ memo dict argument usage (GH-21326)
...
* Clarify __deepcopy__ memo dict argument usage
* Add full stop
2020-07-09 21:36:35 -03:00
Terry Jan Reedy
bce2eb4646
bpo-37765: Add keywords to IDLE tab completions (GH-15138)
...
Keywords are present in the main module tab completion lists generated by rlcompleter, which is used by REPLs on *nix. Add all keywords to IDLE's main module name list except those already added from builtins (True, False, and None) . This list may also be used by Show Completions on the Edit menu, and its hot key.
Rewrite Completions doc.
Co-authored-by: Cheryl Sabella <cheryl.sabella@gmail.com>
2020-07-09 18:08:33 -04:00
E-Paine
1ee5dc1586
Remove trailing >>> in enum docs (GH-21358)
...
The >>> as the last line serve no purpose and are not colored correctly by Sphinx.
2020-07-09 12:18:34 -07:00
marload
61bb24a270
bpo-41199: Docstring convention not followed for dataclasses documentation page (GH-21413)
...
Automerge-Triggered-By: @ericvsmith
2020-07-09 05:13:47 -07:00
Julien Palard
a908bc4dd8
Doc: Builtins functions: faster jump table (GH-21376)
2020-07-09 11:38:41 +02:00
Joannah Nanjekye
a95ac779e6
bpo-41224: Document is_annotated() in symtable module and update doc strings (GH-21369)
...
* Document is_annotate() and update doc strings
* Move quotes to the next line.
Co-authored-by: Pablo Galindo <Pablogsal@gmail.com>
Co-authored-by: Pablo Galindo <Pablogsal@gmail.com>
2020-07-07 20:09:56 -03:00
Julien Palard
a103e73ce8
bpo-40742: Doc: fix parallel build. (GH-21237)
2020-07-06 22:28:15 +02:00
Dong-hee Na
b4a9263708
bpo-37207: Update whatsnews for 3.9 (GH-21337)
2020-07-06 13:22:04 +02:00
Joannah Nanjekye
d12af71047
bpo-28681: Clarify multiple function names in the tutorial (GH-21340)
...
* improve control flow docs
* Add also
Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu>
Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu>
2020-07-05 22:47:15 -03:00
Joannah Nanjekye
9ed3cd8ba0
bpo-26205: Specify the number of nested scopes (GH-21324)
...
* Clarify number of scopes
* Indicate 3 or 4
Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu>
Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu>
2020-07-05 22:42:24 -03:00
Inada Naoki
9c84417122
bpo-41211: Doc: Fix PyLong_FromUnicodeObject (GH-21325)
...
It doesn't use PyUnicode_EncodeDecimal. It uses a private API instead.
2020-07-05 13:01:48 +09:00
Zackery Spytz
b40e434386
bpo-33864: Clarify the docs for typing.ByteString (GH-21311)
2020-07-03 20:58:21 -07:00
Pablo Galindo
67673b08ea
Remove extraneous file from the Docs folder (GH-21286)
2020-07-02 23:08:36 +01:00
Rémi Lapeyre
004e64e805
bpo-40967: Remove deprecated asyncio.Task.current_task() and asyncio.Task.all_tasks() (GH-20874)
2020-07-01 20:41:21 -07:00
Kit Choi
6b34d7b51e
bpo-39385: Add an assertNoLogs context manager to unittest.TestCase (GH-18067)
...
Co-authored-by: Rémi Lapeyre <remi.lapeyre@henki.fr>
2020-07-01 22:08:38 +01:00
tomerv
741008a57b
Doc: Minor fix to init config C API documentation (GH-21198)
...
Co-authored-by: Tomer Vromen <tomer.vromen@intel.com>
2020-07-01 11:32:54 +02:00
E-Paine
3fa4799c3f
Update FAQ release schedule and estimated users (GH-21180)
...
Update FAQ to include:
* The new yearly release schedule from PEP 602
* Estimated users from "tens of thousands" to "millions"
2020-06-30 05:42:43 -04:00
Inada Naoki
038dd0f79d
bpo-36346: Raise DeprecationWarning when creating legacy Unicode (GH-20933)
2020-06-30 15:26:56 +09:00
Inada Naoki
b3332660ad
bpo-41123: Remove PyUnicode_AsUnicodeCopy (GH-21209)
2020-06-30 12:23:07 +09:00
Victor Stinner
dd8a93e23b
bpo-23427: Add sys.orig_argv attribute (GH-20729)
...
Add sys.orig_argv attribute: the list of the original command line
arguments passed to the Python executable.
Rename also PyConfig._orig_argv to PyConfig.orig_argv and
document it.
2020-06-30 00:49:03 +02:00
Stefan Krah
a3ad95dd21
Update libmpdec license dates (GH-21216)
2020-06-29 14:03:01 +02:00
Inada Naoki
e4f1fe6edb
bpo-41123: Remove PyLong_FromUnicode() (GH-21204)
2020-06-29 13:00:43 +09:00
Inada Naoki
d9f2a13106
bpo-41123: Remove PyUnicode_GetMax() (GH-21192)
2020-06-29 10:46:51 +09:00
Batuhan Taskaya
8df1016e2e
bpo-38870: Extend subject of ast.unparse warnings (GH-21053)
...
- Mention that some compiler optimizations might not roundtrip
exactly (such as constant tuples and frozensets).
- Add a warning about it might raise RecursionError on very
complex expressions due to recursive unparsing aspect of ast.unparse
2020-06-28 02:11:43 +01:00
Pablo Galindo
89e82c4a62
Add soft keywords to the documentation (GH-21185)
2020-06-27 20:00:29 +01:00
Inada Naoki
20a7902175
bpo-41123: Remove Py_UNICODE_str* functions (GH-21164)
...
They are undocumented and deprecated since Python 3.3.
2020-06-27 18:22:09 +09:00
Inada Naoki
6f8a6ee59c
bpo-41103: Remove old buffer protocol support ( #21117 )
...
They are deprecated since Python 3.0.
2020-06-26 08:07:22 +09:00
Ram Rachum
77ed29b2c2
Fix typo in functions.rst (GH-21131)
2020-06-25 14:50:37 -07:00
Ned Deily
589e8fe079
bpo-40204: Pin Sphinx version to 2.3.1 in ``Doc/Makefile``. (GH-21141)
2020-06-25 07:22:10 -04:00
Arisaka97
cf18c9e9d4
bpo-40773: Fix rendering for 'retval' on the pdb page (GH-21081)
...
Automerge-Triggered-By: @merwok
2020-06-24 14:50:49 -07:00
Gareth Rees
bf2e515fa4
bpo-40707: Document that Popen.communicate sets the returncode attribute (GH-20283)
2020-06-23 23:12:10 -04:00
Roger Iyengar
a16d697049
Improve asyncio.loop.call_soon() documentation (GH-20883)
...
* Add a glossary entry for the term "callback"
* Link to it in loop.call_soon() and in the "Concurrency and Multithreading" section
Co-authored-by: Kyle Stanley <aeros167@gmail.com>
2020-06-22 22:16:00 -04:00
Brian Rutledge
af157fad28
Add link to .pypirc specification (GH-20680)
...
Related to https://github.com/pypa/twine/issues/638 and https://github.com/pypa/packaging.python.org/issues/730 , I wrote a spec based on the one that was removed in https://github.com/python/cpython/pull/13087 . However, a Google search for "pypirc" turned up at least one [blog post](https://truveris.github.io/articles/configuring-pypirc/ ) that links to https://docs.python.org/3/distutils/packageindex.html#the-pypirc-file , which now just links to this document. So, I thought a link to the spec would be handy.
Automerge-Triggered-By: @jaraco
2020-06-20 10:10:25 -07:00
Vincent Férotin
344c2a75c1
bpo-41024: doc: Explicitly mention use of 'enum.Enum' as a valid container for '… (GH-20964)
...
…choices' argument of 'argparse.ArgumentParser.add_argument'.
Here's a short first proposal of doc. enhancement addressing [bpo-41024]().
Automerge-Triggered-By: @csabella
2020-06-20 05:55:05 -07:00
Ram Rachum
59cf853332
bpo-40636: Documentation for zip-strict ( #20961 )
2020-06-19 13:39:22 -07:00
Victor Stinner
37bb289556
bpo-40943: PY_SSIZE_T_CLEAN required for '#' formats (GH-20784)
...
The PY_SSIZE_T_CLEAN macro must now be defined to use
PyArg_ParseTuple() and Py_BuildValue() "#" formats: "es#", "et#",
"s#", "u#", "y#", "z#", "U#" and "Z#". See the PEP 353.
Update _testcapi.test_buildvalue_issue38913().
2020-06-19 11:45:31 +02:00
Serhiy Storchaka
8a64ceaf98
bpo-38144: Add the root_dir and dir_fd parameters in glob.glob(). (GH-16075)
2020-06-18 22:08:27 +03:00
Bar Harel
8f192d12af
bpo-40884: Added defaults parameter for logging.Formatter (GH-20668)
...
Docs and tests are underway.
Automerge-Triggered-By: @vsajip
2020-06-18 07:18:58 -07:00
Victor Stinner
ddbeb2f3e0
bpo-38377: Add support.skip_if_broken_multiprocessing_synchronize() (GH-20944)
...
On Linux, skip tests using multiprocessing if the current user cannot
create a file in /dev/shm/ directory. Add the
skip_if_broken_multiprocessing_synchronize() function to the
test.support module.
2020-06-18 14:53:19 +02:00
Victor Stinner
2c2a4f3d85
bpo-41006: What's New: less => fewer modules (GH-20955)
...
Typo spotted by Eric V. Smith ;-)
2020-06-18 01:20:51 +02:00
Victor Stinner
4c18fc8f1d
bpo-41006: Document the runpy optimization (GH-20953)
2020-06-17 23:58:58 +02:00
Inada Naoki
2c4928d37e
bpo-36346: Add Py_DEPRECATED to deprecated unicode APIs (GH-20878)
...
Co-authored-by: Kyle Stanley <aeros167@gmail.com>
Co-authored-by: Victor Stinner <vstinner@python.org>
2020-06-17 20:09:44 +09:00
Victor Stinner
7ab92d54b5
bpo-36020: Require vsnprintf() to build Python (GH-20899)
...
The C99 functions snprintf() and vsnprintf() are now required
to build Python.
PyOS_snprintf() and PyOS_vsnprintf() no longer call Py_FatalError().
Previously, they called Py_FatalError() on a buffer overflow on platforms
which don't provide vsnprintf().
2020-06-16 00:54:44 +02:00
kevin seelbach
714217f956
Fixes dead links to Django's logging config docs (GH-20823)
...
Fixes two outdated URLs to point at the current "stable" version of Django's logging documentation.
Automerge-Triggered-By: @vsajip
2020-06-14 10:23:47 -07:00
Zackery Spytz
dea3223740
bpo-37674: Tweak imp module deprecation note in the docs (GH-20480)
2020-06-13 10:35:08 -07:00
Antoine
a6ac239162
Minor change on threading.Thread.native_id documentation. (GH-18129)
...
Remove duplication in `threading.Thread.native_id` documentation, so resulting documentation is more consistent with the `threading.Thread.ident`.
Issue initially raised [here](https://github.com/python/python-docs-fr/pull/1122#discussion_r369236634 ) (in French).
No issue associated to this PR.
Automerge-Triggered-By: @csabella
2020-06-12 15:50:18 -07:00
Dennis Sweeney
3ee0e48b03
bpo-40890: Add `mapping` property to dict views (GH-20749)
2020-06-12 10:19:25 -07:00
Géry Ogam
e2fb8a2c42
Update lexical_analysis.rst (GH-17508)
...
Use Sphinx role markup for `str.format`.
Automerge-Triggered-By: @csabella
2020-06-12 05:54:29 -07:00
native-api
2145c8c972
bpo-33944: site: Add site-packages tracing in verbose mode (GH-12110)
2020-06-12 15:20:11 +09:00
Pablo Galindo
1ed83adb0e
bpo-40939: Remove the old parser (GH-20768)
...
This commit removes the old parser, the deprecated parser module, the old parser compatibility flags and environment variables and all associated support code and documentation.
2020-06-11 17:30:46 +01:00
Victor Stinner
311110abcd
bpo-40275: Move TransientResource to test_urllib2net (GH-20812)
...
Move TransientResource, time_out, socket_peer_reset and
ioerror_peer_reset from test.support to test_urllib2net.
Remove "import errno" from test.support.
2020-06-11 18:26:23 +02:00
Hai Shi
10e6506aa8
bpo-40275: Add warnings_helper submodule in test.support (GH-20797)
2020-06-11 17:36:06 +02:00
Hai Shi
7f888c7ef9
bpo-40275: Add import_helper submodule in test.support (GH-20794)
2020-06-11 01:51:18 +02:00
Daniel Fortunov
1642c0ef75
bpo-40895: Update weakref documentation to remove old warnings (GH-20687)
...
The doccumentation at https://docs.python.org/3.10/library/weakref.html cautions that the `WeakKeyDictionary` and `WeakValueDictionary` are susceptible to the problem of dictionary mutation during iteration.
These notes present the user with a problem that has no easy solution.
I dug into the implementation and found that fortunately, Antoine Pitrou already addressed this challenge (10 years ago!) by introducing an `_IterationGuard` context manager to the implementation, which delays mutation while an iteration is in progress.
I asked for confirmation and @pitrou agreed that these notes could be removed:
c1baa601e2 (commitcomment-39514438)
2020-06-10 13:26:49 -07:00
Serhiy Storchaka
ec88e1bca8
bpo-36543: Revert "bpo-36543: Remove the xml.etree.cElementTree module." (GH-20117)
...
* Revert "bpo-36543: Remove the xml.etree.cElementTree module. (GH-19108)"
This reverts commit b33e52511a
.
2020-06-10 17:39:12 +02:00
Hai Shi
0d00b2a5d7
bpo-40275: Add os_helper submodule in test.support (GH-20765)
2020-06-10 14:29:02 +02:00
Éric Araujo
7aed0524d4
bpo-34003: Re-add versionchanged entry in csv docs (GH-20657)
...
Follow-up to GH-8014
2020-06-09 18:02:11 -07:00
Stefan Krah
323188360d
Remove reference to 3.7 and 3.8 backports. (GH-20754)
2020-06-09 10:27:45 +02:00