[issue44279] doc: contextlib.suppress documentation is imprecise

[Irit Katriel]

Change by Irit Katriel :


--
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

[issue44279] doc: contextlib.suppress documentation is imprecise

[Irit Katriel]

Irit Katriel  added the comment:


New changeset 1065ba66b535b786d6dc5f7d912c6486d9a834ae by Miss Islington (bot) 
in branch '3.10':
bpo-44279: revert 'exceptions are raised' back to 'exceptions occur' (GH-26492) 
(GH-26538)
https://github.com/python/cpython/commit/1065ba66b535b786d6dc5f7d912c6486d9a834ae


--

___
Python tracker 

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

[issue44279] doc: contextlib.suppress documentation is imprecise

[Irit Katriel]

Irit Katriel  added the comment:


New changeset ea298e1e33eb03b2b4ea2f4556e59b11e3bf240f by Miss Islington (bot) 
in branch '3.9':
bpo-44279: revert 'exceptions are raised' back to 'exceptions occur' (GH-26492) 
(GH-26539)
https://github.com/python/cpython/commit/ea298e1e33eb03b2b4ea2f4556e59b11e3bf240f


--

___
Python tracker 

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

[issue44279] doc: contextlib.suppress documentation is imprecise

[miss-islington]

Change by miss-islington :


--
pull_requests: +25130
pull_request: https://github.com/python/cpython/pull/26539

___
Python tracker 

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

[issue44279] doc: contextlib.suppress documentation is imprecise

[Irit Katriel]

Irit Katriel  added the comment:


New changeset dda9ecbfece28aad7b8ba7eaf7951dd9816f78b1 by Irit Katriel in 
branch 'main':
bpo-44279: revert 'exceptions are raised' back to 'exceptions occur' (GH-26492)
https://github.com/python/cpython/commit/dda9ecbfece28aad7b8ba7eaf7951dd9816f78b1


--

___
Python tracker 

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

[issue44279] doc: contextlib.suppress documentation is imprecise

[miss-islington]

Change by miss-islington :


--
nosy: +miss-islington
nosy_count: 5.0 -> 6.0
pull_requests: +25129
pull_request: https://github.com/python/cpython/pull/26538

___
Python tracker 

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

[issue44279] doc: contextlib.suppress documentation is imprecise

[Irit Katriel]

Change by Irit Katriel :


--
pull_requests: +25088
stage: resolved -> patch review
pull_request: https://github.com/python/cpython/pull/26492

___
Python tracker 

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

[issue44279] doc: contextlib.suppress documentation is imprecise

[Eric V. Smith]

Eric V. Smith  added the comment:

I'm not sure the original version needs improving.

This sounds like a problem understanding how warnings work.

Do you really want to say that for warnings, they're sometimes handled by the 
warning machinery and therefore don't get passed along to the calling code? It 
seems to me that you'd need to explain that everywhere the documents discuss 
handling exceptions. I don't think this one place is more special than others.

--

___
Python tracker 

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

[issue44279] doc: contextlib.suppress documentation is imprecise

[Irit Katriel]

Irit Katriel  added the comment:

I see, that’s a good point. Any suggestion regarding the original confusion 
with warnings? (See PR 26428).

--
status: closed -> open

___
Python tracker 

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

[issue44279] doc: contextlib.suppress documentation is imprecise

[Raymond Hettinger]

Raymond Hettinger  added the comment:

I think the old wording was better.  Code can explicitly raise an exception, 
but other exceptions just occur when calling builtin functions or with a 
keyboard interrupt.

--
nosy: +eric.smith, rhettinger

___
Python tracker 

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

[issue44279] doc: contextlib.suppress documentation is imprecise

[Irit Katriel]

Change by Irit Katriel :


--
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

[issue44279] doc: contextlib.suppress documentation is imprecise

[Irit Katriel]

Irit Katriel  added the comment:


New changeset 9a688624973a2b753b84f892b65268543c7ff67d by Irit Katriel in 
branch '3.9':
[3.9] bpo-44279: [doc] reword contextlib.suppress documentation (GH-26428) 
(GH-26481)
https://github.com/python/cpython/commit/9a688624973a2b753b84f892b65268543c7ff67d


--

___
Python tracker 

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

[issue44279] doc: contextlib.suppress documentation is imprecise

[Irit Katriel]

Irit Katriel  added the comment:


New changeset 6563ea5c60be2e4896df52eff777aa93743f1551 by Irit Katriel in 
branch '3.10':
[3.10] bpo-44279: [doc] reword contextlib.suppress documentation (GH-26428) 
(GH-26480)
https://github.com/python/cpython/commit/6563ea5c60be2e4896df52eff777aa93743f1551


--

___
Python tracker 

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

[issue44279] doc: contextlib.suppress documentation is imprecise

[Irit Katriel]

Change by Irit Katriel :


--
pull_requests: +25078
pull_request: https://github.com/python/cpython/pull/26481

___
Python tracker 

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

[issue44279] doc: contextlib.suppress documentation is imprecise

[Irit Katriel]

Change by Irit Katriel :


--
pull_requests: +25077
pull_request: https://github.com/python/cpython/pull/26480

___
Python tracker 

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

[issue44279] doc: contextlib.suppress documentation is imprecise

[Irit Katriel]

Irit Katriel  added the comment:


New changeset 87272b70f157af76cb14ff90d73dfc5d9bfb945a by MapleCCC in branch 
'main':
bpo-44279: [doc] reword contextlib.suppress documentation (GH-26428)
https://github.com/python/cpython/commit/87272b70f157af76cb14ff90d73dfc5d9bfb945a


--

___
Python tracker 

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

[issue44279] doc: contextlib.suppress documentation is imprecise

[MapleCCC]

Change by MapleCCC :


--
keywords: +patch
nosy: +MapleCCC
nosy_count: 2.0 -> 3.0
pull_requests: +25075
stage:  -> patch review
pull_request: https://github.com/python/cpython/pull/26428

___
Python tracker 

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

[issue44279] doc: contextlib.suppress documentation is imprecise

[Irit Katriel]

New submission from Irit Katriel :

"suppresses any of the specified exceptions if they occur in the body of a with 
statement"

Should be:

"suppresses any of the specified exceptions if they are raised in the body of a 
with statement"

--
assignee: docs@python
components: Documentation, Library (Lib)
messages: 394863
nosy: docs@python, iritkatriel
priority: normal
severity: normal
status: open
title: doc: contextlib.suppress documentation is imprecise
versions: Python 3.10, Python 3.11, Python 3.9

___
Python tracker 

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