summaryrefslogtreecommitdiffstats
path: root/Doc
Commit message (Collapse)AuthorAgeFilesLines
* 3.7.5v3.7.5Ned Deily2019-10-141-1/+1
|
* bpo-28556: Remove another mention of metaclass of Generic in typing docs ↵Miss Islington (bot)2019-10-141-2/+2
| | | | | | | | | | (GH-16743) Metaclass was removed in Python 3.7 (there is already a `versionchanged` item about this). https://bugs.python.org/issue28556 (cherry picked from commit 8144095707f87bdee6f3e1bbb15283ea61381be6) Co-authored-by: Ivan Levkivskyi <levkivskyi@gmail.com>
* Fix typo: equivalent code of `async with cond` (GH-11681) (GH-16720)Miss Islington (bot)2019-10-141-2/+2
|
* bpo-32996: Documentation fix-up. (GH-16646)Miss Islington (bot)2019-10-141-3/+4
| | | | | | | | | PR GH-4906 changed the typing.Generic class hierarchy, leaving an outdated comment in the library reference. User-defined Generic ABCs now must get a abc.ABCMeta metaclass from something other than typing.Generic inheritance. (cherry picked from commit d47f0dd2e85ce032aebfedbde18cdb2e728fa79f) Co-authored-by: M. Eric Irrgang <mei2n@virginia.edu>
* bpo-36953: Delay removal of ABCs from collections. (GH-13409)Miss Islington (bot)2019-10-141-2/+2
| | | | | | | | | Bump the removal to 3.9, indicate collections.abc available since 3.3, replace version-changed directive to deprecated-removed. https://bugs.python.org/issue36953 (cherry picked from commit eea47e09394dfb64d3a59a601d947d25bb1bdc96) Co-authored-by: Matthias Bussonnier <mbussonnier@ucmerced.edu>
* [3.7] bpo-38294: Add list of no-longer-escaped chars to re.escape ↵Ricardo Bánffy2019-10-142-3/+6
| | | | | | | | | | documentation. (GH-16442) (GH-16647) Prior to 3.7, re.escape escaped many characters that don't have special meaning in Python, but that use to require escaping in other tools and languages. This commit aims to make it clear which characters were, but are no longer escaped. (cherry picked from commit 15ae75d660befe643ed42eb2707a557cea97256c)
* bpo-38391: Fixing a typo for Py_DECREF (GH-16616)Miss Islington (bot)2019-10-141-1/+1
| | | | | (cherry picked from commit 038503e08ac5b10601b95d5adc2c2cab7be10163) Co-authored-by: Krishna Oza <krishoza15sep@gmail.com>
* bpo-26510: Add versionchanged for required arg of add_subparsers (GH-16588)Miss Islington (bot)2019-10-142-1/+8
| | | | | | | | | | The `required` argument to `argparse.add_subparsers` was added in GH-3027. This PR specifies the earliest version of Python where it is available. https://bugs.python.org/issue26510 Automerge-Triggered-By: @merwok (cherry picked from commit 9e71917e0290972f65711f75510078f799cf0b59) Co-authored-by: Adam J. Stewart <ajstewart426@gmail.com>
* bpo-38235: Correct some arguments names in logging documentation (GH-16571) ↵Miss Islington (bot)2019-10-141-17/+17
| | | | | | | (GH-16577) (cherry picked from commit 3142c667b50254daaa28f22c79bdda177136bd03) Co-authored-by: Ashley Whetter <AWhetter@users.noreply.github.com>
* Correct typos in the codecs module documentation (GH-15135)Miss Islington (bot)2019-10-011-60/+61
| | | | | (cherry picked from commit 891e9e3b44c99d643dc309a4e63082451271b136) Co-authored-by: Géry Ogam <gery.ogam@gmail.com>
* Fix and improve `asyncio.run()` docs (GH-16403) (GH-16505)Miss Islington (bot)2019-10-012-5/+3
| | | | | (cherry picked from commit e407013089259e4c0b271703e1975bbcd578a2d5) Co-authored-by: Kyle Stanley <aeros167@gmail.com>
* bpo-38130: Fix error in explaining when an exception is re-raised (GH-16016) ↵Miss Islington (bot)2019-09-261-1/+1
| | | | | | | | (GH-16416) Co-Authored-By: Ashwin Ramaswami <aramaswamis@gmail.com> (cherry picked from commit 1ad7be2f16cc9955f271f57a5089602bb41eee85) Co-authored-by: Mohammad Dehghan <md.unicorn@gmail.com>
* Doc: Use the `with` statement in the first example of the ftplib doc. ↵Miss Islington (bot)2019-09-261-1/+2
| | | | | | | (GH-16271) (GH-16413) (cherry picked from commit 5d326abf2cb4891b78d9319a81bffb3974b5b745) Co-authored-by: Stéphane Wirtel <stephane@wirtel.be>
* bpo-38255: super() can search attributes as well as methods (GH-16368) ↵Miss Islington (bot)2019-09-251-0/+4
| | | | | | | | (GH-16392) Improvement suggested by Géry Ogam. (cherry picked from commit 15ccc4fac09b866d61b069c6c136aabfe4bac09c) Co-authored-by: Raymond Hettinger <rhettinger@users.noreply.github.com>
* bpo-38260: Add Docs on asyncio.run (GH-16337)Miss Islington (bot)2019-09-251-0/+12
| | | | | | | | | | Add docs about return and raise exception on asyncio.run https://bugs.python.org/issue38260 Automerge-Triggered-By: @asvetlov (cherry picked from commit 17deb16883fa574a86e42551cc37f044182347ad) Co-authored-by: Emmanuel Arias <emmanuelarias30@gmail.com>
* bpo-37937: Mention frame.f_trace in sys.settrace docs (GH-15439)Miss Islington (bot)2019-09-201-0/+11
| | | | | | | | Mention frame.f_trace in sys.settrace docs, as well as the fact you still need to call `sys.settrace` to enable the tracing machinery before setting `frame.f_trace` will have any effect. (cherry picked from commit 9c2682efc69568e1b42a0c1759489d6f2e3b30ea) Co-authored-by: Ram Rachum <ram@rachum.com>
* bpo-37353: Updated parser note about source code compatibility(GH-14277)Miss Islington (bot)2019-09-201-1/+2
| | | | | (cherry picked from commit 062cfe3b11c61d03ccc2915e360f9b0d80e23642) Co-authored-by: Prateek Nayak <45075669+Kriyszig@users.noreply.github.com>
* Doc: Clarify dict equality irrespective of ordering. (GH-16266)Miss Islington (bot)2019-09-191-1/+1
| | | | | (cherry picked from commit 3171d67a6aaf7fe88685b3a80644f0284686ef63) Co-authored-by: toonarmycaptain <toonarmycaptain@hotmail.com>
* [3.7] bpo-38218: Doc: Corrected syntax for return annotation (GH-16265) ↵Miss Islington (bot)2019-09-191-1/+1
| | | | | | | | (GH-16275) Signed-off-by: Jason Plurad <pluradj@us.ibm.com> (cherry picked from commit 9ab6038fe843e1193d795eb58fd5931b44be5a96) Co-authored-by: Jason Plurad <pluradj@us.ibm.com>
* bpo-38203: faulthandler.dump_traceback_later() is always available (GH-16260)Miss Islington (bot)2019-09-181-2/+4
| | | | | | | dump_traceback_later() and cancel_dump_traceback_later() functions of the faulthandler module are always available since Python 3.7. (cherry picked from commit 064e1e384120635330493abf300b1113eadd904c) Co-authored-by: Victor Stinner <vstinner@redhat.com>
* bpo-37904: Edition on python tutorial - section 4 (GH-16169) (GH-16235)Miss Islington (bot)2019-09-181-2/+2
| | | | | | | | | | A little change on first paragraph of python tutorial to be more clearly https://bugs.python.org/issue37904 Automerge-Triggered-By: @ericvsmith (cherry picked from commit b57481318e3e3cbacd398b898f9849ec8f2d7eec) Co-authored-by: Diego Alberto Barriga Martínez <diegobarriga@protonmail.com>
* Doc: Fix grammar/spelling in ssl.VERIFY_CRL_CHECK_LEAF docs (GH-16221)Miss Islington (bot)2019-09-171-2/+2
| | | | | (cherry picked from commit 219fb9d65ef7e5363eccc9dde0988bb085db1c86) Co-authored-by: Jörn Heissler <joernheissler@users.noreply.github.com>
* bpo-38192: Fix remaining passing of "loop" in the protocol examples (GH-16202)Miss Islington (bot)2019-09-171-5/+6
| | | | | | | | See https://bugs.python.org/issue38192 . https://bugs.python.org/issue38192 (cherry picked from commit 5d359cc62e0244e1fd8d17146a4135079d6843bf) Co-authored-by: Hrvoje Nikšić <hniksic@gmail.com>
* Doc: Add list(dict) in stdtypes library (GH-16209) (GH-16211)Miss Islington (bot)2019-09-171-0/+4
| | | | | (cherry picked from commit 63dedef48bba9d54f13b958237696505fa665796) Co-authored-by: Adorilson Bezerra <adorilson@gmail.com>
* bpo-28556: Update the opening note in typing docs (GH-16204)Miss Islington (bot)2019-09-161-4/+3
| | | | | | This PR replaces the old note mentioning that `typing` is a provisional module with a new one mentioning types are not enforced at runtime. I am not sure if there was any official announcement about making `typing` non-provisional, but _de-facto_ no new features were added during Python 3.7, and no backwards incompatible changes were made except for few small things that were considered bugs. (cherry picked from commit 81528ba2e81c39f4d6bca5b785e818c7d08b8501) Co-authored-by: Ivan Levkivskyi <levkivskyi@gmail.com>
* Doc: Add link of GNU Readline library to interpreter tutorial (GH-16152) ↵Miss Islington (bot)2019-09-161-7/+8
| | | | | | | (GH-16188) (cherry picked from commit f18242be16714da2cfe013dbadfaf2e31d971562) Co-authored-by: Adorilson Bezerra <adorilson@gmail.com>
* [3.7] bpo-33095: Add reference to isolated mode in -m and script option ↵Julien Palard2019-09-161-0/+13
| | | | | | | | | | (GH-7764) (GH-16181) Attempt to make isolated mode easier to discover via additional inline documentation. Co-Authored-By: Julien Palard <julien@palard.fr>. (cherry picked from commit bdd6945d4dbd1fe6a7fcff95f7d6908db7d791a1) Co-authored-by: Xtreak <tir.karthi@gmail.com>
* bpo-38178: Don't explicitly pass "loop" to EchoClientProtocol. (GH-16159)Miss Islington (bot)2019-09-151-7/+7
| | | | | | https://bugs.python.org/issue38178 (cherry picked from commit c717c73fa33a2f3591442059eaf6e7a673e2c725) Co-authored-by: Hrvoje Nikšić <hniksic@gmail.com>
* bpo-37635: Update arg name for seek() in IO tutorial (GH-16147)Miss Islington (bot)2019-09-141-3/+3
| | | | | | | | | | | | | | | | | | | | | Typically, the second positional argument for ``seek()`` is *whence*. That is the POSIX standard name (http://man7.org/linux/man-pages/man3/lseek.3p.html) and the name listed in the documentation for ``io`` module (https://docs.python.org/3/library/io.htmlGH-io.IOBase.seek). The tutorial for IO is the only location where the second positional argument for ``seek()`` is referred to as *from_what*. I suspect this was created at an early point in Python's history, and was never updated (as this section predates the GitHub repository): ``` $ git grep "from_what" Doc/tutorial/inputoutput.rst:To change the file object's position, use ``f.seek(offset, from_what)``. The position is computed Doc/tutorial/inputoutput.rst:the *from_what* argument. A *from_what* value of 0 measures from the beginning Doc/tutorial/inputoutput.rst:the reference point. *from_what* can be omitted and defaults to 0, using the ``` For consistency, I am suggesting that the tutorial be updated to use the same argument name as the IO documentation and POSIX standard for ``seek()``, particularly since this is the only location where *from_what* is being used. Note: In the POSIX standard, *whence* is technically the third positional argument, but the first argument *fildes* (file descriptor) is implicit in Python. https://bugs.python.org/issue37635 (cherry picked from commit ff603f6c3d3dc0e9ea8c1c51ce907c4821f42c54) Co-authored-by: Kyle Stanley <aeros167@gmail.com>
* Doc: Fix link to window.getch in curses documentation (GH-16132)Miss Islington (bot)2019-09-141-1/+1
| | | | | (cherry picked from commit a26ace19bddea2d7a999a6de8286b3f27b132f35) Co-authored-by: Anthony Sottile <asottile@umich.edu>
* bpo-32790: Add info about alt format using GH- for 'g' in chart (GH-6624)Miss Islington (bot)2019-09-131-1/+2
| | | | | (cherry picked from commit d44542f9a231bf725ecd82eb640a672c759a8227) Co-authored-by: bchhabra2490 <bchhabra2490@gmail.com>
* Emphasize the need to always call PySequence_Fast. (GH-11140)Miss Islington (bot)2019-09-121-7/+14
| | | | | (cherry picked from commit 57b7dbc46e71269d855e644d30826d33eedee2a1) Co-authored-by: Matti Picus <matti.picus@gmail.com>
* bpo-38096: Complete the "structseq" and "named tuple" cleanup (GH-16010) ↵Miss Islington (bot)2019-09-121-1/+1
| | | | | | | (GH-16063) (cherry picked from commit 4210ad5ebd5769f585035e022876e161cd0e9a3e) Co-authored-by: Raymond Hettinger <rhettinger@users.noreply.github.com>
* bpo-26868: Fix example usage of PyModule_AddObject. (GH-15725)Miss Islington (bot)2019-09-128-13/+73
| | | | | | | | | | | | | | | | | | * Add a note to the PyModule_AddObject docs. * Correct example usages of PyModule_AddObject. * Whitespace. * Clean up wording. * 📜🤖 Added by blurb_it. * First code review. * Add < 0 in the tests with PyModule_AddObject (cherry picked from commit 224b8aaa7e8f67f748e8b7b6a4a77a25f6554651) Co-authored-by: Brandt Bucher <brandtbucher@gmail.com>
* bpo-35325: Doc: imp.find_module() return value documentation discrepancy ↵Miss Islington (bot)2019-09-121-6/+5
| | | | | | | (GH-11040) (cherry picked from commit 967b84c913c7b09ae2fc86272cb9373415e2beaf) Co-authored-by: Windson yang <wiwindson@outlook.com>
* bpo-32008: Prefer client or TLSv1_2 in examples (GH-5797) (GH-16026)Miss Islington (bot)2019-09-121-8/+14
| | | | | | | | Prefer client or TLSv1_2 in examples Signed-off-by: Christian Heimes <christian@python.org> (cherry picked from commit 894d0f7d5542ee04556ec1bee8c58506f7c916d4) Co-authored-by: Christian Heimes <christian@python.org>
* Doc: Update pickle.rst (GH-14128) (GH-16015)Miss Islington (bot)2019-09-121-17/+19
| | | | | | * Edits for readability and grammar (cherry picked from commit 362f5350eb5e2c7bfb0b0a8c306a2e128c3aee93) Co-authored-by: Géry Ogam <gery.ogam@gmail.com>
* bpo-38096: Clean up the "struct sequence" / "named tuple" docs (GH-15895) ↵Paul Ganssle2019-09-124-28/+31
| | | | (GH-15962)
* Doc: Fix missing negation. (GH-14640) (GH-15985)Miss Islington (bot)2019-09-111-2/+2
| | | | | | | | Reported by Hug Capella on docs@. Automerge-Triggered-By: @matrixise (cherry picked from commit 1fae844451b120b93880d9360f288c70e125520c) Co-authored-by: Julien Palard <julien@palard.fr>
* Improve clarity of try-return-finally-return (GH-15677) (GH-15982)Miss Islington (bot)2019-09-111-9/+22
| | | | | | Clarify execution in try-return-finally-return case. (cherry picked from commit 0cc27417f2cd399c432d7dda9aeca1d81af76936) Co-authored-by: toonarmycaptain <toonarmycaptain@hotmail.com>
* bpo-37698: Update doc of PyBuffer_ToContiguous (GH-14992) (GH-15998)Miss Islington (bot)2019-09-111-2/+2
| | | | | | https://bugs.python.org/issue37698 (cherry picked from commit 15f5a7527b87e11fcf23069c147fd4cb7d42cfb0) Co-authored-by: Hai Shi <shihai1992@gmail.com>
* Doc: recursive glob ** follows symlinks to directories (GH-12918)Miss Islington (bot)2019-09-111-2/+3
| | | | | (cherry picked from commit e24594bfe75aff3e654665cb940ddc4d4acffd2f) Co-authored-by: Marc <Marc.Herbert+github@gmail.com>
* bpo-37750: Add doc of PyBuffer_FromContiguous (GH-15988) (GH-15991)Miss Islington (bot)2019-09-111-0/+7
| | | | | | | | https://bugs.python.org/issue37750 Automerge-Triggered-By: @matrixise (cherry picked from commit 5a56ce4a0e820fefcd598b94715a7ff7e199858d) Co-authored-by: Hai Shi <shihai1992@gmail.com>
* bpo-33187: Document ElementInclude (XInclude) support in ElementTree ↵Miss Islington (bot)2019-09-112-0/+92
| | | | | | | (GH-8861) (GH-15972) (cherry picked from commit 97b817eae34b77be1ced382e15098a112f547848) Co-authored-by: Anjali Bansal <anjali.mca17.du@gmail.com>
* bpo-33459: Fix "tuple displays" term in Expressions.rst (GH-6760) (GH-15939)Miss Islington (bot)2019-09-111-4/+4
| | | | | | | | https://bugs.python.org/issue33459 Automerge-Triggered-By: @matrixise (cherry picked from commit dc269971091710563a0d730a0d4b084901826c15) Co-authored-by: Andre Delfino <adelfino@gmail.com>
* bpo-35649: update http client example (GH-11441) (GH-15931)Miss Islington (bot)2019-09-111-2/+5
| | | | | (cherry picked from commit 62cf6981425c6a6b136c5e2abef853364f535e9d) Co-authored-by: Ashwin Ramaswami <aramaswamis@gmail.com>
* [3.7] bpo-35168: Make shlex.punctuation_chars read-only (GH-11631) (GH-15926)Vinay Sajip2019-09-111-3/+5
| | | | | (cherry picked from commit 972cf5c06a5ba16ad243a442dbb9c15307fbed95) Co-authored-by: Alex <a.v.shkop@gmail.com>
* bpo-25810: Clarify eval() docs, it does not keywords (GH-15173)Miss Islington (bot)2019-09-111-1/+1
| | | | | (cherry picked from commit 7a0023e8d17566eb32c836b65c33663303a2224f) Co-authored-by: smokephil <smokephil@gmail.com>
* bpo-37585: Add clarification regarding comparing dict.values() (GH-14954)Miss Islington (bot)2019-09-111-0/+8
| | | | | (cherry picked from commit 6472ece5a0fe82809d3aa0ffb281796fcd252d76) Co-authored-by: Kyle Stanley <aeros167@gmail.com>
* bpo-16438: Doc: confusing text regarding numeric precedence corrected (GH-10521)Miss Islington (bot)2019-09-111-3/+2
| | | | | (cherry picked from commit 4576b5431bd597df7581fe3c852b315e47e4b230) Co-authored-by: Anjali <anjali30malik@gmail.com>