[issue41233] Missing links to errnos on Built-in Exceptions page

[Jelle Zijlstra]

Jelle Zijlstra  added the comment:

Thanks for the patch!

--
resolution:  -> fixed
stage: patch review -> resolved
status: open -> closed

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue41233] Missing links to errnos on Built-in Exceptions page

[miss-islington]

miss-islington  added the comment:


New changeset e47e6ffed36eb1dd82da3bcadf8b45b894ef4ce2 by Miss Islington (bot) 
in branch '3.9':
bpo-41233: Add links to errnos referenced in exceptions docs (GH-21380)
https://github.com/python/cpython/commit/e47e6ffed36eb1dd82da3bcadf8b45b894ef4ce2


--

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue41233] Missing links to errnos on Built-in Exceptions page

[miss-islington]

miss-islington  added the comment:


New changeset 3fa800d7a7a405f51e0e8c9b7dac2f2a75c17bb4 by Miss Islington (bot) 
in branch '3.10':
bpo-41233: Add links to errnos referenced in exceptions docs (GH-21380)
https://github.com/python/cpython/commit/3fa800d7a7a405f51e0e8c9b7dac2f2a75c17bb4


--

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue41233] Missing links to errnos on Built-in Exceptions page

[miss-islington]

Change by miss-islington :


--
pull_requests: +30378
pull_request: https://github.com/python/cpython/pull/32317

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue41233] Missing links to errnos on Built-in Exceptions page

[miss-islington]

Change by miss-islington :


--
nosy: +miss-islington
nosy_count: 8.0 -> 9.0
pull_requests: +30377
pull_request: https://github.com/python/cpython/pull/32316

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue41233] Missing links to errnos on Built-in Exceptions page

[Jelle Zijlstra]

Jelle Zijlstra  added the comment:


New changeset a74892cb2168d249d9a8c53fad605a5def9b41d4 by yyyan in branch 
'main':
bpo-41233: Add links to errnos referenced in exceptions docs (GH-21380)
https://github.com/python/cpython/commit/a74892cb2168d249d9a8c53fad605a5def9b41d4


--
nosy: +JelleZijlstra

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue41233] Missing links to errnos on Built-in Exceptions page

[yyyyyyyan]

yyyan  added the comment:

Thank you so much! :-)

--

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue41233] Missing links to errnos on Built-in Exceptions page

[Terry J. Reedy]

Terry J. Reedy  added the comment:

Near the bottom of the opening page: 
https://devguide.python.org/#status-of-python-branches
The meaning of 'status' is explained elsewhere.

--

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue41233] Missing links to errnos on Built-in Exceptions page

[yyyyyyyan]

yyyan  added the comment:

Thank you, @terry.reedy! Can you point me if this is defined in some written 
document I can check? Or is it an internal rule everyone kinda finds out by 
themselves?

--

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue41233] Missing links to errnos on Built-in Exceptions page

[Terry J. Reedy]

Terry J. Reedy  added the comment:

Only 3.8+ for bug fixes.

--
nosy: +terry.reedy
versions:  -Python 3.5, Python 3.6, Python 3.7

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue41233] Missing links to errnos on Built-in Exceptions page

[yyyyyyyan]

Change by yyyan :


--
keywords: +patch
pull_requests: +20524
stage:  -> patch review
pull_request: https://github.com/python/cpython/pull/21380

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue41233] Missing links to errnos on Built-in Exceptions page

[yyyyyyyan]

New submission from yyyan :

On the [Built-in 
Exceptions](https://docs.python.org/dev/library/exceptions.html) page, the 
exception 
[InterruptedError](https://docs.python.org/dev/library/exceptions.html#InterruptedError)
 correlates the error with the errno 
[EINTR](https://docs.python.org/dev/library/errno.html#errno.EINTR), linking 
the name `EINTR` with the errno page. This is great, since reading 
"*corresponds to errno EINTR*" is pointless if you don't know what `EINTR` 
means. The problem is `InterruptedError` is the only exception that put a link 
on the errno. All others only have the "correspondes to errno `ERRNO`", without 
any links, which makes it harder to understand.

The same thing happens on the 
[errno](https://docs.python.org/dev/library/errno.html). On the section about 
[errno.EINTR](https://docs.python.org/dev/library/errno.html#errno.EINTR) we 
have a "see also" box saying "This error is mapped to the exception 
InterruptedError", with a link to the InterruptedError section on the 
exceptions page. However, for some reason the "see also" box is only on this 
specific errno section.

The links should be added on both pages so the great pattern defined by 
`InterruptedError` and `errno.EINTR` is mantained.

--
assignee: docs@python
components: Documentation
messages: 373260
nosy: docs@python, eric.araujo, ezio.melotti, mdk, willingc, yyyan
priority: normal
severity: normal
status: open
title: Missing links to errnos on Built-in Exceptions page
type: enhancement
versions: Python 3.10, Python 3.5, Python 3.6, Python 3.7, Python 3.8, Python 
3.9

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com