Title: Source code has not always been forward-compatible
Type: Stage: resolved
Components: Documentation Versions: Python 3.9, Python 3.8, Python 3.7
Status: closed Resolution: fixed
Dependencies: Superseder:
Assigned To: docs@python Nosy List: docs@python, mdk, miss-islington, willingc, zach.ware
Priority: normal Keywords: easy, patch

Created on 2019-06-20 17:22 by mdk, last changed 2019-09-20 14:03 by miss-islington. This issue is now closed.

Pull Requests
URL Status Linked Edit
PR 14277 merged Kriyszig, 2019-06-20 19:55
PR 16294 merged miss-islington, 2019-09-20 13:56
PR 16295 merged miss-islington, 2019-09-20 13:56
Messages (6)
msg346142 - (view) Author: Julien Palard (mdk) * (Python committer) Date: 2019-06-20 17:22
In Doc/library/parser.rst I can read:

The parse trees are not typically compatible from one version to another, whereas source code has always been forward-compatible.

But I don't think this is right, I think of print for example.

Maybe just remove ", whereas source code has always been forward-compatible" or rewrite it so say source is just more stable than parse trees?
msg346146 - (view) Author: Zachary Ware (zach.ware) * (Python committer) Date: 2019-06-20 17:34
Perhaps just adding "within a major release series" after "forward-compatible" would be sufficient?
msg346159 - (view) Author: Carol Willing (willingc) * (Python committer) Date: 2019-06-20 19:01
"...though source code has usually been forward-compatible within a major release series."

Agree with your thoughts Julien and Zach. Perhaps remove "whereas" as well.
msg352848 - (view) Author: Zachary Ware (zach.ware) * (Python committer) Date: 2019-09-20 13:55
New changeset 062cfe3b11c61d03ccc2915e360f9b0d80e23642 by Zachary Ware (Prateek Nayak) in branch 'master':
bpo-37353: Updated parser note about source code compatibility(GH-14277)
msg352849 - (view) Author: miss-islington (miss-islington) Date: 2019-09-20 14:02
New changeset 2552e27b752f449b1d7046b384b14db0a69f46ad by Miss Islington (bot) in branch '3.7':
bpo-37353: Updated parser note about source code compatibility(GH-14277)
msg352851 - (view) Author: miss-islington (miss-islington) Date: 2019-09-20 14:03
New changeset 0ab6b01820afef44beea8158ba08b6469bf264a0 by Miss Islington (bot) in branch '3.8':
bpo-37353: Updated parser note about source code compatibility(GH-14277)
Date User Action Args
2019-09-20 14:03:24miss-islingtonsetmessages: + msg352851
2019-09-20 14:02:04miss-islingtonsetnosy: + miss-islington
messages: + msg352849
2019-09-20 13:57:52zach.waresetstatus: open -> closed
stage: patch review -> resolved
resolution: fixed
versions: + Python 3.7, Python 3.8, Python 3.9
2019-09-20 13:56:19miss-islingtonsetpull_requests: + pull_request15881
2019-09-20 13:56:11miss-islingtonsetpull_requests: + pull_request15880
2019-09-20 13:55:38zach.waresetmessages: + msg352848
2019-06-20 19:55:35Kriyszigsetkeywords: + patch
stage: patch review
pull_requests: + pull_request14101
2019-06-20 19:01:27willingcsetnosy: + willingc
messages: + msg346159
2019-06-20 17:34:59zach.waresetnosy: + zach.ware
messages: + msg346146
2019-06-20 17:22:26mdkcreate