This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

classification
Title: some RFC references could be updated
Type: enhancement Stage: resolved
Components: Documentation Versions: Python 3.7, Python 3.6
process
Status: closed Resolution: fixed
Dependencies: Superseder:
Assigned To: docs@python Nosy List: chkumar246, christian.heimes, docs@python, georg.brandl, matrixise, ncoghlan, serhiy.storchaka, tshepang
Priority: normal Keywords:

Created on 2013-10-06 11:07 by georg.brandl, last changed 2022-04-11 14:57 by admin. This issue is now closed.

Pull Requests
URL Status Linked Edit
PR 148 merged python-dev, 2017-02-18 08:57
PR 2023 merged ncoghlan, 2017-06-09 11:58
PR 2073 merged serhiy.storchaka, 2017-06-10 08:10
PR 2077 merged serhiy.storchaka, 2017-06-10 10:17
Messages (10)
msg199069 - (view) Author: Georg Brandl (georg.brandl) * (Python committer) Date: 2013-10-06 11:07
-------- Original-Nachricht --------
Betreff: [docs] some RFC references could be updated
Datum: Mon, 20 May 2013 22:37:53 -0400
Von: Sean Turner <turners@ieca.com>
An: docs@python.org

Hi,

Just starting to learn python and have noted that at the bottom of this
page:

http://docs.python.org/3/library/ssl.html

There's a couple of out of date references:

0) RFC 1750 has been been obsoleted by RFC 4086 so maybe this is a
better reference (and I prefer the datatracker view as opposed to the
tools view):

http://datatracker.ietf.org/doc/rfc4086/

Same could be done on this link:

http://docs.python.org/3.4/library/ssl.html

1) RFC 3280 has been obsoleted by RFC 5280 so maybe:

http://datatracker.ietf.org/doc/rfc5280/

Same could be done on this link:

http://docs.python.org/3.4/library/ssl.html

2) RFC 4366 has been obsoleted by RFC 6066 so maybe:

http://datatracker.ietf.org/doc/rfc6066/

On http://docs.python.org/3.4/library/ssl.html you could probably just
drop the reference and change in the ssl.HAS_SNI section.

3) The link to TLS seems broken maybe just point to:

TLS 1.0 http://datatracker.ietf.org/doc/rfc2246/
TLS 1.1 http://datatracker.ietf.org/doc/rfc4346/
TLS 1.2 http://datatracker.ietf.org/doc/rfc5246/
SSL 3.0 http://datatracker.ietf.org/doc/rfc6101/

Actually the same link is broken on:

http://docs.python.org/3.4/library/ssl.html

4) (this is a shameless plug) Might be worth adding a reference in the
ssl.PROTOCOL_SSLv2 section that points to:

http://datatracker.ietf.org/doc/rfc6146/
msg199490 - (view) Author: Serhiy Storchaka (serhiy.storchaka) * (Python committer) Date: 2013-10-11 16:37
See also http://comments.gmane.org/gmane.comp.python.devel/139953 .
msg288067 - (view) Author: Chandan kumar (chkumar246) * Date: 2017-02-18 09:15
I have updated the RFC references from [0] to [2]. I am not able to find out the TLS links mentioned in the https://docs.python.org/3.4/library/ssl.html. I have attached the pull request.
msg295493 - (view) Author: Stéphane Wirtel (matrixise) * (Python committer) Date: 2017-06-09 07:38
The associated PR has been reviewed and could be merged.
msg295510 - (view) Author: Nick Coghlan (ncoghlan) * (Python committer) Date: 2017-06-09 09:44
New changeset 63c2c8ac17750ba2be2cfc4e339cae1f4edee54f by Nick Coghlan (Chandan Kumar) in branch 'master':
bpo-19180: Updated references for RFC 1750, RFC 3280 & RFC 4366 (GH-148)
https://github.com/python/cpython/commit/63c2c8ac17750ba2be2cfc4e339cae1f4edee54f
msg295522 - (view) Author: Nick Coghlan (ncoghlan) * (Python committer) Date: 2017-06-09 12:37
New changeset c422959daca0598fabbefa5de4417ebce3b1da06 by Nick Coghlan in branch '3.6':
[3.6] bpo-19180: Updated references for RFC 1750, RFC 3280 & RFC 4366
https://github.com/python/cpython/commit/c422959daca0598fabbefa5de4417ebce3b1da06
msg295524 - (view) Author: Nick Coghlan (ncoghlan) * (Python committer) Date: 2017-06-09 12:39
And merged. Thanks Chandan for the update, and everyone else for the comments and triage :)
msg295613 - (view) Author: Serhiy Storchaka (serhiy.storchaka) * (Python committer) Date: 2017-06-10 05:31
Needed to regenerate Argument Clinic code.
msg295629 - (view) Author: Serhiy Storchaka (serhiy.storchaka) * (Python committer) Date: 2017-06-10 10:13
New changeset 5f31d5cf6efa8c304d352e34f9f2a1ed0074298e by Serhiy Storchaka in branch 'master':
Regenerate Argument Clinic code for bpo-19180. (#2073)
https://github.com/python/cpython/commit/5f31d5cf6efa8c304d352e34f9f2a1ed0074298e
msg295630 - (view) Author: Serhiy Storchaka (serhiy.storchaka) * (Python committer) Date: 2017-06-10 10:48
New changeset 911068e250ee2b0847ca78d9ff527e0d6bf94551 by Serhiy Storchaka in branch '3.6':
[3.6] Regenerate Argument Clinic code for bpo-19180. (GH-2073). (#2077)
https://github.com/python/cpython/commit/911068e250ee2b0847ca78d9ff527e0d6bf94551
History
Date User Action Args
2022-04-11 14:57:51adminsetgithub: 63379
2017-06-10 10:50:15serhiy.storchakasetstatus: open -> closed
2017-06-10 10:48:55serhiy.storchakasetmessages: + msg295630
2017-06-10 10:17:18serhiy.storchakasetpull_requests: + pull_request2141
2017-06-10 10:13:53serhiy.storchakasetmessages: + msg295629
2017-06-10 08:10:13serhiy.storchakasetpull_requests: + pull_request2137
2017-06-10 05:31:14serhiy.storchakasetstatus: closed -> open

messages: + msg295613
2017-06-09 12:39:24ncoghlansetstatus: open -> closed
resolution: fixed
messages: + msg295524

stage: backport needed -> resolved
2017-06-09 12:37:55ncoghlansetmessages: + msg295522
2017-06-09 11:58:30ncoghlansetpull_requests: + pull_request2089
2017-06-09 10:13:35Mariattasetstage: patch review -> backport needed
2017-06-09 09:44:01ncoghlansetmessages: + msg295510
2017-06-09 07:38:24matrixisesetnosy: + matrixise
messages: + msg295493
2017-05-27 05:35:41ncoghlansetnosy: + ncoghlan
2017-04-04 06:30:34serhiy.storchakasetnosy: + christian.heimes

stage: needs patch -> patch review
2017-02-18 09:15:45chkumar246setnosy: + chkumar246
messages: + msg288067
2017-02-18 08:57:43python-devsetpull_requests: + pull_request109
2016-09-08 22:46:32christian.heimessetstage: needs patch
type: enhancement
versions: + Python 3.6, Python 3.7
2013-10-11 16:37:15serhiy.storchakasetnosy: + serhiy.storchaka
messages: + msg199490
2013-10-11 16:26:12tshepangsetnosy: + tshepang
2013-10-06 11:07:47georg.brandlcreate