Commit Graph

21346 Commits

Author SHA1 Message Date
Miss Islington (bot) 5f165851b9
bpo-33892: Doc: Use gender neutral words (GH-7770)
(cherry picked from commit 5092439c2c)

Co-authored-by: Andrés Delfino <adelfino@gmail.com>
2018-06-17 21:49:43 -07:00
Miss Islington (bot) 416e488415
bpo-33859: Fix spelling mistakes in docs. (GH-7691)
(cherry picked from commit c151f7846d)

Co-authored-by: Xtreak <tirkarthi@users.noreply.github.com>
2018-06-15 22:26:34 -07:00
Miss Islington (bot) 380a2b09e8
bpo-33571: Improve the glossary description for '...' prompt (GH-6971)
Mention that it can be triggered by triple quotes and after specifying decorators.
(cherry picked from commit 6868003514)

Co-authored-by: Andrés Delfino <adelfino@gmail.com>
2018-06-15 21:03:20 -07:00
Miss Islington (bot) 5a0bf74d4e
bpo-33836: Recommend keyword-only param for memoization in FAQ (GH-7687)
Update the the signature in the code example to make `_cache` a keyword-only parameter.
(cherry picked from commit 2707e41a5c)

Co-authored-by: Noah Haasis <haasis_noah@yahoo.de>
2018-06-15 20:46:30 -07:00
Miss Islington (bot) 18793e1f60 Improve the grammar in the glossary item for `list`
" ... access to elements is O(1)."

(cherry picked from commit 7469ff5017)

Co-authored-by: Andrés Delfino <adelfino@gmail.com>
2018-06-15 20:00:36 -07:00
Miss Islington (bot) ce1bda774e bpo-33854: Add PEP 461 title to 'See also' note (GH-7688) (#7719)
(cherry picked from commit a9d0b34a5c)

Co-authored-by: Andrés Delfino <adelfino@gmail.com>
2018-06-15 16:14:32 -04:00
Miss Islington (bot) c05c0e045c
bpo-33847: Add '@' operator entry to index (GH-7669)
(cherry picked from commit 695118600f)

Co-authored-by: Andrés Delfino <adelfino@gmail.com>
2018-06-15 12:42:30 -07:00
Miss Islington (bot) 0113391e3f
bpo-33852: Remove misplaced parentheses around 'list'. (GH-7672)
'expresson list' refers to the grammar term 'expression_list' in the subscription production.
(cherry picked from commit 4fddd4e406)

Co-authored-by: Andrés Delfino <adelfino@gmail.com>
2018-06-15 11:45:37 -07:00
Miss Islington (bot) eea4f14971
bpo-31378: Document sqlite3.OperationalError exception (GH-7677)
(cherry picked from commit 71ede00f14)

Co-authored-by: Zackery Spytz <zspytz@gmail.com>
2018-06-13 02:28:48 -07:00
Miss Islington (bot) 29fdea5ec2
bpo-33828: Add missing versionchanged note for string.Formatter. (GH-7668)
string.Formatter auto-numbering feature was added in 3.4 and there
is no versionchanged note in its documentation, making the documentation
ambiguous about which version the feature is available.
(cherry picked from commit b9d8ad5130)

Co-authored-by: Xiang Zhang <angwerzx@126.com>
2018-06-12 19:10:51 -07:00
Miss Islington (bot) 7b82281c80 bpo-27397: Make email module properly handle invalid-length base64 strings (GH-7583) (GH-7664)
When attempting to base64-decode a payload of invalid length (1 mod 4),
properly recognize and handle it.  The given data will be returned as-is,
i.e. not decoded, along with a new defect, InvalidBase64LengthDefect.
(cherry picked from commit c3f55be7dd)

Co-authored-by: Tal Einat <taleinat+github@gmail.com>
2018-06-12 16:46:11 +03:00
Miss Islington (bot) 66cea5cb1b Fix nested list in 3.7 What's New (GH-7659) (GH-7660)
(cherry picked from commit 5a98209180)

Co-authored-by: Ned Deily <nad@python.org>
2018-06-12 05:02:53 -04:00
Miss Islington (bot) ef5f4ba96e bpo-25612: Add minimal What's New in 3.7 entry (GH-7656) (GH-7658)
(cherry picked from commit 04290cb994)

Co-authored-by: Ned Deily <nad@python.org>
2018-06-12 00:26:30 -04:00
Miss Islington (bot) a5db479ac4 bpo-31432: Clarify ssl CERT_NONE/OPTIONAL/REQUIRED docs. (GH-3530) (GH-7649)
The documentation for CERT_NONE, CERT_OPTIONAL, and CERT_REQUIRED were
misleading and partly wrong. It fails to explain that OpenSSL behaves
differently in client and server mode. Also OpenSSL does validate the
cert chain everytime. With SSL_VERIFY_NONE a validation error is not
fatal in client mode and does not request a client cert in server mode.
Also discourage people from using CERT_OPTIONAL in client mode.
(cherry picked from commit ef24b6c54d)

Co-authored-by: Christian Heimes <christian@python.org>
2018-06-11 19:20:24 -04:00
Miss Islington (bot) 60c699374c
bpo-33656: Add entry to What's New 3.7. (GH-7638)
This is a separate PR because this does not backport to 3.6.
(cherry picked from commit 8a05f559ce)

Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu>
2018-06-11 11:45:49 -07:00
Miss Islington (bot) 144a8670f2
bpo-33656: On Windows, add API call saying that tk scales for DPI (GH-7137)
On Windows 8.1+ or 10, with DPI compatibility properties of the Python binary
unchanged, and a monitor resolution greater than 96 DPI, this should
make text and lines sharper. It should otherwise have no effect.

Using a magnifier, I determined that the improvement comes from horizontal and
lines being better lined up with the monitor pixels. I checked that this call causes
no problem on any Windows buildbot, including the Win7 buildbots. Unlike most
IDLE patches, this one can be easily reverted by users by removing a few lines,
at the top of idlelib/pyshell.py.
(cherry picked from commit 800415e3df)

Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu>
2018-06-11 11:35:13 -07:00
Miss Islington (bot) 904cdbaa9b
bpo-33831: Make htmlview run again (GH-7628)
(cherry picked from commit 0e5f901508)

Co-authored-by: Andrés Delfino <adelfino@gmail.com>
2018-06-11 10:16:03 -07:00
Miss Islington (bot) b06fc2d244 bpo-30820: Remove incorrect docs for email.contentmanager.raw_data_manager (GH-7631) (#7633)
The docs claimed that a list of EmailMessage objects could be
passed to set_content(), but this was never implemented.
(cherry picked from commit 2c071cebe6)

Co-authored-by: Zackery Spytz <zspytz@gmail.com>
2018-06-11 12:11:22 -04:00
Miss Islington (bot) 144493dd7f bpo-23404: Update/sync What's New files for 3.6/3.5/2.7 (GH-7620) (GH-7621)
(cherry picked from commit 9d6171ded5)

Co-authored-by: Ned Deily <nad@python.org>
2018-06-11 04:18:49 -04:00
Miss Islington (bot) 14a190c882
bpo-33745: Add What's New for empty function docstring change. (GH-7611)
(cherry picked from commit 12c6cdf4d1)

Co-authored-by: Ned Deily <nad@python.org>
2018-06-10 20:00:17 -07:00
Miss Islington (bot) a73399d596 bpo-33109: Remove now-obsolete What's New entry for bpo-26510. (GH-7609) (GH-7610)
(cherry picked from commit ef057bfb06)

Co-authored-by: Ned Deily <nad@python.org>
2018-06-10 22:30:57 -04:00
Miss Islington (bot) 037e912552 bpo-33812: Corrected astimezone for naive datetimes. (GH-7578) (GH-7600)
A datetime object d is aware if d.tzinfo is not None and
d.tzinfo.utcoffset(d) does  not return None. If d.tzinfo is None,
or if d.tzinfo is not None but d.tzinfo.utcoffset(d) returns None,
 d is naive.

This commit ensures that instances with non-None d.tzinfo, but
d.tzinfo.utcoffset(d) returning None are treated as naive.

In addition, C acceleration code will raise TypeError if
d.tzinfo.utcoffset(d) returns an object with the type other than
timedelta.

* Updated the documentation.

Assume that the term "naive" is defined elsewhere and remove the
not entirely correct clarification.  Thanks, Tim.
(cherry picked from commit 877b23202b)

Co-authored-by: Alexander Belopolsky <abalkin@users.noreply.github.com>
2018-06-10 18:02:24 -04:00
Miss Islington (bot) 2adfeef185
bpo-33610: Update IDLE Code Context doc entry (GH-7597)
Users can now click on context lines.
(cherry picked from commit af4b0130d4)

Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu>
2018-06-10 13:07:24 -07:00
Miss Islington (bot) 3da01813c8
bpo-33820: Fix IDLE What's New typo (GH-7594)
(cherry picked from commit 820c53ac61)

Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu>
2018-06-10 12:26:44 -07:00
Miss Islington (bot) 1ed8294924
bpo-33821: Update idlelib subsection of What's New 3.7 (GH-7590)
(cherry picked from commit 222f7f4033)

Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu>
2018-06-10 11:35:22 -07:00
Miss Islington (bot) 953d300ffa
bpo-33820: Update idlelib subsection of What's New 3.6 (GH-7589)
(cherry picked from commit e226eb7157)

Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu>
2018-06-10 11:30:28 -07:00
Miss Islington (bot) 082920026a
Remove hyphens from phrase "picks up where it left off" (GH-7410)
(cherry picked from commit d689f97619)

Co-authored-by: Andrés Delfino <adelfino@gmail.com>
2018-06-09 19:00:36 -07:00
Miss Islington (bot) 92a58417b3
Fix typo in object.__getnewargs__() documentation (GH-7554)
(cherry picked from commit 0e0534c402)

Co-authored-by: Andrés Delfino <adelfino@gmail.com>
2018-06-09 18:01:36 -07:00
Miss Islington (bot) 0cf58f494c
bpo-33766: Document that end of file or string is a newline (GH-7383)
(cherry picked from commit 0aa17ee6a7)

Co-authored-by: Ammar Askar <ammar_askar@hotmail.com>
2018-06-09 17:05:49 -07:00
Miss Islington (bot) 055bd80fd9
doc: Fix typo in asyncio-eventloop.rst (GH-7345)
This is a fixup to 19a44f63c7
(cherry picked from commit 7e0d882a98)

Co-authored-by: MarcoFalke <falke.marco@gmail.com>
2018-06-09 16:30:16 -07:00
Miss Islington (bot) dd613cf335
bpo-33409: Clarify PEP 538/540 relationship (GH-7534)
While locale coercion and UTF-8 mode turned out to
be complementary ideas rather than competing ones,
it isn't immediately obvious why it's useful to
have both, or how they interact at runtime.

This updates both the Python 3.7 What's New doc
and the PYTHONCOERCECLOCALE and PYTHONUTF8
documentation in an attempt to clarify that
relationship:

- in the respective What's New sections, add a closing paragraph
  explaining which problem each one solves, and pointing to the
  other PEP's section for the specific aspects it relies on the other
  PEP to solve
- use "locale-aware mode" as a more descriptive term for the
  default non-UTF-8 mode
- improve wording conistenccy between the PYTHONCOERCECLOCALE
  and PYTHONUTF8 docs when they cover the same thing (mostly
  related to legacy locale detection and setting the standard
  stream error handler)
- improve the description of the locale coercion trigger conditions
  (including pointing out that setting LC_ALL turns off locale coercion)
- port the full description of the UTF-8 mode behaviour changes
  from PEP 540 into the PYTHONUTF8 documentation
- be explicit that PYTHONIOENCODING still overrides the settings
  for the standard streams
- mention concrete examples of things that do and don't get their
  text encoding assumptions adjusted by the two text encoding
  assumption override techniques
(cherry picked from commit 1bcb8a6368)

Co-authored-by: Nick Coghlan <ncoghlan@gmail.com>
2018-06-09 00:13:53 -07:00
Miss Islington (bot) 416fbe41b7 bpo-33801: Remove non-ordered dict comment from plistlib doc (GH-7495) (GH-7546)
(cherry picked from commit 1cbdb2208a)

Co-authored-by: Andrés Delfino <adelfino@gmail.com>
2018-06-08 17:57:43 -04:00
Miss Islington (bot) dc20d9d102 bpo-33800: Fix default argument for parameter dict_type of ConfigParser/RawConfigParser (GH-7494) (GH-7542)
(cherry picked from commit 3b0b90c8c3)

Co-authored-by: Andrés Delfino <adelfino@gmail.com>
2018-06-08 15:26:07 -04:00
Miss Islington (bot) 5c7f22c2a3 bpo-33799: Remove non-ordered dicts comments from FAQ (GH-7520)
(cherry picked from commit 396ecb9c3e)

Co-authored-by: Andrés Delfino <adelfino@gmail.com>
2018-06-08 14:43:14 -04:00
Miss Islington (bot) f4dcf49159
bpo-33736: Improve the documentation of asyncio stream APIs (GH-7326)
(cherry picked from commit c0d062f523)

Co-authored-by: Elvis Pranskevichus <elvis@magic.io>
2018-06-08 08:54:31 -07:00
Miss Islington (bot) 9f56a93e89
bpo-33798: Update csv document about dict order (GH-7490)
(cherry picked from commit 6860629d87)

Co-authored-by: Andrés Delfino <adelfino@gmail.com>
2018-06-08 06:33:32 -07:00
Miss Islington (bot) d16d72f555
bpo-31215: Add version changed notes for OpenSSL 1.1.0 compatibility (GH-7346)
(cherry picked from commit 9ef1b0690b)

Co-authored-by: Mayank Singhal <17mayank.singhal@gmail.com>
2018-06-08 03:22:40 -07:00
Miss Islington (bot) 0738443a5b
bpo-33792: Add selector and proactor windows policies (GH-7487)
(cherry picked from commit 8f4042964d)

Co-authored-by: Yury Selivanov <yury@magic.io>
2018-06-07 18:31:50 -07:00
Miss Islington (bot) 9b0d4d04a1 bpo-33609: small wording fixes to dict ordering docs (#7497)
A few wording improvements to dict ordering documentation.
(cherry picked from commit d3ed67d14e)

Co-authored-by: Neil Schemenauer <nas-github@arctrix.com>
2018-06-07 20:38:22 -04:00
Miss Islington (bot) 942b7ff11a
update 3.7 whatsnew entry about Unicode version (GH-7480)
Followup to 4705ea38c9 and bpo-33778.
(cherry picked from commit 34b734699b)

Co-authored-by: Benjamin Peterson <benjamin@python.org>
2018-06-07 07:50:33 -07:00
Miss Islington (bot) f38ace61a3
bpo-17909: Document that json.load can accept a binary IO (GH-7366)
(cherry picked from commit bb6366bd75)

Co-authored-by: Anthony Sottile <asottile@umich.edu>
2018-06-07 03:17:15 -07:00
Miss Islington (bot) 4705ea38c9 update to Unicode 11.0.0 (closes bpo-33778) (GH-7439) (GH-7470)
Also, standardize indentation of generated tables.
(cherry picked from commit 7c69c1c0fb)

Co-authored-by: Benjamin Peterson <benjamin@python.org>
2018-06-07 03:36:22 -04:00
Miss Islington (bot) cebd4b009a bpo-28240: timeit: Update repeat() doc (GH-7419) (GH-7457)
Document that the default value of repeat changed from 3 to 5 in
Python 3.7.
(cherry picked from commit 3ef769fcd3)

Co-authored-by: Victor Stinner <vstinner@redhat.com>
2018-06-06 19:05:46 +02:00
Miss Islington (bot) 23b7ee2052
bpo-32392: Document env keyword argument of subprocess.run() (GH-7289)
(cherry picked from commit af1ec97a6d)

Co-authored-by: Tobias Kunze <r@rixx.de>
2018-06-05 05:03:02 -07:00
Miss Islington (bot) 8585ec9b76
bpo-33609: Document dict insertion order guarantee as of 3.7 (GH-7093)
(cherry picked from commit f822549653)

Co-authored-by: INADA Naoki <methane@users.noreply.github.com>
2018-06-04 15:25:12 -07:00
Miss Islington (bot) 7548a93274
bpo-27902: Add compatibility note to Profile docs (GH-7295)
(cherry picked from commit f7745e1dcb)

Co-authored-by: Tobias Kunze <r@rixx.de>
2018-06-04 10:25:37 -07:00
Miss Islington (bot) 1cdd0e71ec
bpo-33640, uuid.UUID doc: document endian of bytes parameter (GH-7263)
The bytes parameter uses big endian.
(cherry picked from commit b75ec08567)

Co-authored-by: Farhaan Bukhsh <farhaan.bukhsh@gmail.com>
2018-06-04 10:17:28 -07:00
Miss Islington (bot) 87936d03cb bpo-33734: asyncio/ssl: a bunch of bugfixes (GH-7321) (GH-7396)
* Fix AttributeError (not all SSL exceptions have 'errno' attribute)

* Increase default handshake timeout from 10 to 60 seconds
* Make sure start_tls can be cancelled correctly
* Make sure any error in SSLProtocol gets propagated (instead of just being logged)
(cherry picked from commit 9602643120)

Co-authored-by: Yury Selivanov <yury@magic.io>
2018-06-04 12:05:46 -04:00
Miss Islington (bot) 949da9e44b
bpo-23495: Correct the documentation for writerows() of csv Writer objects (GH-6316)
`writerows()` takes an iterable.
(cherry picked from commit a801cf164b)

Co-authored-by: Zackery Spytz <zspytz@gmail.com>
2018-06-02 08:40:00 -07:00
Miss Islington (bot) 57f1f5b91b
Fix typo in datamodel.rst (GH-6964)
This is a simple grammatical fix correcting "...object whose `__self__` attributes is ..." to "...object whose `__self__` attribute is ...".
(cherry picked from commit 00818c8ffd)

Co-authored-by: Zach Mitchell <zmitchell@users.noreply.github.com>
2018-06-02 07:53:30 -07:00