Commit Graph

21956 Commits

Author SHA1 Message Date
Miss Islington (bot) d3666945d7
bpo-38260: Add Docs on asyncio.run (GH-16337)
Add docs about return and raise exception on asyncio.run

https://bugs.python.org/issue38260

Automerge-Triggered-By: @asvetlov
(cherry picked from commit 17deb16883)

Co-authored-by: Emmanuel Arias <emmanuelarias30@gmail.com>
2019-09-25 02:13:00 -07:00
Miss Islington (bot) fd4f28d894
bpo-37937: Mention frame.f_trace in sys.settrace docs (GH-15439)
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 9c2682efc6)

Co-authored-by: Ram Rachum <ram@rachum.com>
2019-09-20 08:25:12 -07:00
Miss Islington (bot) 2552e27b75
bpo-37353: Updated parser note about source code compatibility(GH-14277)
(cherry picked from commit 062cfe3b11)

Co-authored-by: Prateek Nayak <45075669+Kriyszig@users.noreply.github.com>
2019-09-20 07:02:00 -07:00
Miss Islington (bot) 50ecedc103
Doc: Clarify dict equality irrespective of ordering. (GH-16266)
(cherry picked from commit 3171d67a6a)

Co-authored-by: toonarmycaptain <toonarmycaptain@hotmail.com>
2019-09-18 22:57:32 -07:00
Miss Islington (bot) 20d3bce3ef [3.7] bpo-38218: Doc: Corrected syntax for return annotation (GH-16265) (GH-16275)
Signed-off-by: Jason Plurad <pluradj@us.ibm.com>
(cherry picked from commit 9ab6038fe8)

Co-authored-by: Jason Plurad <pluradj@us.ibm.com>
2019-09-19 07:37:38 +02:00
Miss Islington (bot) 1a3a48ddaf
bpo-38203: faulthandler.dump_traceback_later() is always available (GH-16260)
dump_traceback_later() and cancel_dump_traceback_later() functions of
the faulthandler module are always available since Python 3.7.
(cherry picked from commit 064e1e3841)

Co-authored-by: Victor Stinner <vstinner@redhat.com>
2019-09-18 05:43:17 -07:00
Miss Islington (bot) 8b907a8875 bpo-37904: Edition on python tutorial - section 4 (GH-16169) (GH-16235)
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 b57481318e)

Co-authored-by: Diego Alberto Barriga Martínez <diegobarriga@protonmail.com>
2019-09-18 06:36:35 -04:00
Miss Islington (bot) 6422392f34
Doc: Fix grammar/spelling in ssl.VERIFY_CRL_CHECK_LEAF docs (GH-16221)
(cherry picked from commit 219fb9d65e)

Co-authored-by: Jörn Heissler <joernheissler@users.noreply.github.com>
2019-09-17 03:49:08 -07:00
Miss Islington (bot) facbd316b4
bpo-38192: Fix remaining passing of "loop" in the protocol examples (GH-16202)
See https://bugs.python.org/issue38192 .

https://bugs.python.org/issue38192
(cherry picked from commit 5d359cc62e)

Co-authored-by: Hrvoje Nikšić <hniksic@gmail.com>
2019-09-17 00:22:48 -07:00
Miss Islington (bot) 89f132a328 Doc: Add list(dict) in stdtypes library (GH-16209) (GH-16211)
(cherry picked from commit 63dedef48b)

Co-authored-by: Adorilson Bezerra <adorilson@gmail.com>
2019-09-17 07:04:19 +02:00
Miss Islington (bot) 733193d050
bpo-28556: Update the opening note in typing docs (GH-16204)
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 81528ba2e8)

Co-authored-by: Ivan Levkivskyi <levkivskyi@gmail.com>
2019-09-16 15:10:11 -07:00
Miss Islington (bot) ad4ce9edf3 Doc: Add link of GNU Readline library to interpreter tutorial (GH-16152) (GH-16188)
(cherry picked from commit f18242be16)

Co-authored-by: Adorilson Bezerra <adorilson@gmail.com>
2019-09-16 18:29:50 +02:00
Julien Palard 210dc3bb37
[3.7] bpo-33095: Add reference to isolated mode in -m and script option (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 bdd6945d4d)

Co-authored-by: Xtreak <tir.karthi@gmail.com>
2019-09-16 14:30:33 +02:00
Miss Islington (bot) 701c4886bb
bpo-38178: Don't explicitly pass "loop" to EchoClientProtocol. (GH-16159)
https://bugs.python.org/issue38178
(cherry picked from commit c717c73fa3)

Co-authored-by: Hrvoje Nikšić <hniksic@gmail.com>
2019-09-15 10:12:13 -07:00
Miss Islington (bot) b9f932f9e2
bpo-37635: Update arg name for seek() in IO tutorial (GH-16147)
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 ff603f6c3d)

Co-authored-by: Kyle Stanley <aeros167@gmail.com>
2019-09-14 13:47:39 -07:00
Miss Islington (bot) 4fac58165b
Doc: Fix link to window.getch in curses documentation (GH-16132)
(cherry picked from commit a26ace19bd)

Co-authored-by: Anthony Sottile <asottile@umich.edu>
2019-09-13 23:23:20 -07:00
Miss Islington (bot) 77878cadc5
bpo-32790: Add info about alt format using GH- for 'g' in chart (GH-6624)
(cherry picked from commit d44542f9a2)

Co-authored-by: bchhabra2490 <bchhabra2490@gmail.com>
2019-09-13 10:26:51 -07:00
Miss Islington (bot) 6e0c066f89
Emphasize the need to always call PySequence_Fast. (GH-11140)
(cherry picked from commit 57b7dbc46e)

Co-authored-by: Matti Picus <matti.picus@gmail.com>
2019-09-12 09:25:55 -07:00
Miss Islington (bot) e3c25fc902 bpo-38096: Complete the "structseq" and "named tuple" cleanup (GH-16010) (GH-16063)
(cherry picked from commit 4210ad5ebd)

Co-authored-by: Raymond Hettinger <rhettinger@users.noreply.github.com>
2019-09-12 08:20:07 -07:00
Miss Islington (bot) c8d1338441
bpo-26868: Fix example usage of PyModule_AddObject. (GH-15725)
* 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 224b8aaa7e)

Co-authored-by: Brandt Bucher <brandtbucher@gmail.com>
2019-09-12 05:29:09 -07:00
Miss Islington (bot) 01b47c94ca
bpo-35325: Doc: imp.find_module() return value documentation discrepancy (GH-11040)
(cherry picked from commit 967b84c913)

Co-authored-by: Windson yang <wiwindson@outlook.com>
2019-09-12 05:24:56 -07:00
Miss Islington (bot) 07b4148f39 bpo-32008: Prefer client or TLSv1_2 in examples (GH-5797) (GH-16026)
Prefer client or TLSv1_2 in examples

Signed-off-by: Christian Heimes <christian@python.org>
(cherry picked from commit 894d0f7d55)

Co-authored-by: Christian Heimes <christian@python.org>
2019-09-12 12:20:41 +01:00
Miss Islington (bot) ff2a5c0204 Doc: Update pickle.rst (GH-14128) (GH-16015)
* Edits for readability and grammar
(cherry picked from commit 362f5350eb)

Co-authored-by: Géry Ogam <gery.ogam@gmail.com>
2019-09-12 09:19:33 +01:00
Paul Ganssle b7a310d865 bpo-38096: Clean up the "struct sequence" / "named tuple" docs (GH-15895) (GH-15962) 2019-09-11 19:50:51 -07:00
Miss Islington (bot) bf0c76cdf6 Doc: Fix missing negation. (GH-14640) (GH-15985)
Reported by Hug Capella on docs@.

Automerge-Triggered-By: @matrixise
(cherry picked from commit 1fae844451)

Co-authored-by: Julien Palard <julien@palard.fr>
2019-09-11 19:53:56 +02:00
Miss Islington (bot) e4be7c8ba1 Improve clarity of try-return-finally-return (GH-15677) (GH-15982)
Clarify execution in try-return-finally-return case.
(cherry picked from commit 0cc27417f2)

Co-authored-by: toonarmycaptain <toonarmycaptain@hotmail.com>
2019-09-11 19:42:09 +02:00
Miss Islington (bot) c62da14776 bpo-37698: Update doc of PyBuffer_ToContiguous (GH-14992) (GH-15998)
https://bugs.python.org/issue37698
(cherry picked from commit 15f5a7527b)

Co-authored-by: Hai Shi <shihai1992@gmail.com>
2019-09-11 19:34:19 +02:00
Miss Islington (bot) 9b46586124
Doc: recursive glob ** follows symlinks to directories (GH-12918)
(cherry picked from commit e24594bfe7)

Co-authored-by: Marc <Marc.Herbert+github@gmail.com>
2019-09-11 10:28:16 -07:00
Miss Islington (bot) c112faff15 bpo-37750: Add doc of PyBuffer_FromContiguous (GH-15988) (GH-15991)
https://bugs.python.org/issue37750

Automerge-Triggered-By: @matrixise
(cherry picked from commit 5a56ce4a0e)

Co-authored-by: Hai Shi <shihai1992@gmail.com>
2019-09-11 19:10:23 +02:00
Miss Islington (bot) 195dc142f8 bpo-33187: Document ElementInclude (XInclude) support in ElementTree (GH-8861) (GH-15972)
(cherry picked from commit 97b817eae3)

Co-authored-by: Anjali Bansal <anjali.mca17.du@gmail.com>
2019-09-11 16:36:41 +01:00
Miss Islington (bot) 4c2fa5c474 bpo-33459: Fix "tuple displays" term in Expressions.rst (GH-6760) (GH-15939)
https://bugs.python.org/issue33459

Automerge-Triggered-By: @matrixise
(cherry picked from commit dc26997109)

Co-authored-by: Andre Delfino <adelfino@gmail.com>
2019-09-11 15:37:49 +02:00
Miss Islington (bot) 0fd8c0560b bpo-35649: update http client example (GH-11441) (GH-15931)
(cherry picked from commit 62cf698142)

Co-authored-by: Ashwin Ramaswami <aramaswamis@gmail.com>
2019-09-11 15:13:55 +02:00
Vinay Sajip aca878ecf1
[3.7] bpo-35168: Make shlex.punctuation_chars read-only (GH-11631) (GH-15926)
(cherry picked from commit 972cf5c06a)

Co-authored-by: Alex <a.v.shkop@gmail.com>
2019-09-11 13:39:08 +01:00
Miss Islington (bot) d378fdb10a
bpo-25810: Clarify eval() docs, it does not keywords (GH-15173)
(cherry picked from commit 7a0023e8d1)

Co-authored-by: smokephil <smokephil@gmail.com>
2019-09-11 03:55:29 -07:00
Miss Islington (bot) 3cd147bf59
bpo-37585: Add clarification regarding comparing dict.values() (GH-14954)
(cherry picked from commit 6472ece5a0)

Co-authored-by: Kyle Stanley <aeros167@gmail.com>
2019-09-11 03:45:54 -07:00
Miss Islington (bot) 9210b5826f
bpo-16438: Doc: confusing text regarding numeric precedence corrected (GH-10521)
(cherry picked from commit 4576b5431b)

Co-authored-by: Anjali <anjali30malik@gmail.com>
2019-09-11 03:41:28 -07:00
Miss Islington (bot) 2a8560ae99 bpo-38034: Fix typo in logging.handlers.rst (GH-15708) (GH-15894)
(cherry picked from commit efd5741ae9)

Co-authored-by: wwuck <301402+wwuck@users.noreply.github.com>
2019-09-11 07:56:50 +01:00
Miss Islington (bot) e0a1561f93
bpo-37574: Mention helper functions for find_spec documentation (GH-14739)
(cherry picked from commit 9cbb97b29e)

Co-authored-by: jdkandersson <51036209+jdkandersson@users.noreply.github.com>
2019-09-10 10:16:03 -07:00
Miss Islington (bot) 14514b6e71
Docs: Small tweaks to c-api/introGH-Include_Files (GH-14698)
(cherry picked from commit b6dafe5139)

Co-authored-by: Kyle Stanley <aeros167@gmail.com>
2019-09-10 09:40:32 -07:00
Miss Islington (bot) 075a441fa0
Correct info about "f.read(size)". (GH13852)
In text mode, the "size" parameter indicates the number of characters, not bytes.
(cherry picked from commit faff81c05f)

Co-authored-by: William Andrea <william.j.andrea@gmail.com>
2019-09-10 09:02:40 -07:00
Miss Islington (bot) 816825e192 bpo-33602: Doc: Remove set and queue references from Data Types (GH-7055) (GH-15876)
(cherry picked from commit 912108891d)

Co-authored-by: Andre Delfino <adelfino@gmail.com>
2019-09-10 17:43:11 +02:00
Steve Dower aa3b629a09
bpo-37913: document that __length_hint__ can return NotImplemented (GH-15383) 2019-09-10 15:41:58 +01:00
Miss Islington (bot) 122bbf7f8a bpo-21018: added missing documentation about escaping characters for configparser (GH-6137) (GH-15845)
Document how $ and % can be escaped in configparser.
(cherry picked from commit 9a94093189)

Co-authored-by: Arun Persaud <arun@nubati.net>
2019-09-10 15:32:42 +02:00
Zachary Ware 12228ce41d
[3.7] bpo-34293: Fix PDF documentation paper size (GH-8585) (GH-15817)
The "A4" pdfs were previously the wrong size due to a change in the options in Sphinx 1.5.

See also sphinx-doc/sphinxGH-5235.
(cherry picked from commit b5381f6697)

Authored-by: Jean-François B <jfbu@free.fr>
2019-09-09 23:11:34 +01:00
Miss Islington (bot) 0a86da87da
bpo-36502: Update link to UAX GH-44, the Unicode doc on the UCD. (GH-15301)
The link we have points to the version from Unicode 6.0.0, dated 2010.
There have been numerous updates to it since then:
  https://www.unicode.org/reports/tr44/GH-Modifications

Change the link to one that points to the current version. Also, use HTTPS.
(cherry picked from commit 64c6ac74e2)

Co-authored-by: Greg Price <gnprice@gmail.com>
2019-09-09 11:40:03 -07:00
Miss Islington (bot) b4591ad33a
bpo-35803: Document and test dir=PathLike for tempfile (GH-11644)
Co-Authored-By: Ammar Askar <ammar_askar@hotmail.com>
(cherry picked from commit 370138ba9c)

Co-authored-by: Anthony Sottile <asottile@umich.edu>
2019-09-09 10:33:18 -07:00
Miss Islington (bot) 5190b7193c
bpo-34410: Fix a crash in the tee iterator when re-enter it. (GH-15625)
RuntimeError is now raised in this case.
(cherry picked from commit 526a01467b)

Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
2019-09-09 02:11:22 -07:00
Miss Islington (bot) 30933d57fc
[3.8] Correct Roman-numeral example in Unicode HOWTO. (GH-15541). (GH-15728)
(cherry picked from commit 32a960f8e1)

Co-authored-by: Greg Price <gnprice@gmail.com>
(cherry picked from commit 3be4b10749)

Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
2019-09-08 03:28:40 -07:00
Miss Islington (bot) a6eac83c18
bpo-20806: Reference both times(2) and times(3) and link to MSDN. (GH-15479)
(cherry picked from commit 3ccdbc3338)

Co-authored-by: Joannah Nanjekye <33177550+nanjekyejoannah@users.noreply.github.com>
2019-09-07 00:16:27 -07:00
Miss Islington (bot) 256f03befb
Correct minor gramatical mistake in sys.settrace doc (GH-15637)
(cherry picked from commit 3038e87ba8)

Co-authored-by: Andre Delfino <adelfino@gmail.com>
2019-09-05 04:31:50 -07:00