Issue 19691: Weird wording in RuntimeError doc (original) (raw)

This issue has been migrated to GitHub: https://github.com/python/cpython/issues/63890

classification

process

Created on 2013-11-22 14:21 by pitrou, last changed 2022-04-11 14:57 by admin. This issue is now closed.

Messages (6)
msg203763 - (view)	Author: Antoine Pitrou (pitrou) *	Date: 2013-11-22 14:21
The RuntimeError documentation has a strange sentence embedded in it: """This exception is mostly a relic from a previous version of the interpreter; it is not used very much any more""" http://docs.python.org/dev/library/exceptions.html#RuntimeError That's quite wrong. RuntimeError may not be raised inside the interpreter core, but it's raised by a bunch of stdlib modules.
msg204292 - (view)	Author: Ezio Melotti (ezio.melotti) *	Date: 2013-11-25 03:46
So maybe it can just be removed?
msg204298 - (view)	Author: Georg Brandl (georg.brandl) *	Date: 2013-11-25 06:55
I think so.
msg204365 - (view)	Author: Antoine Pitrou (pitrou) *	Date: 2013-11-25 17:13
The mention was already there in 1994 (2ec96140a36b), under the following form: +\begin{excdesc}{RuntimeError} + Raised when an error is detected that doesn't fall in any of the + other categories. The associated value is a string indicating what + precisely went wrong. (This exception is a relic from a previous + version of the interpreter; it is not used any more except by some + extension modules that haven't been converted to define their own + exceptions yet.) +\end{excdesc} It was changed slightly from being "a relic" to "mostly a relic" in 1997 (238a8b6096e1): \begin{excdesc}{RuntimeError} Raised when an error is detected that doesn't fall in any of the other categories. The associated value is a string indicating what - precisely went wrong. (This exception is a relic from a previous - version of the interpreter; it is not used any more except by some - extension modules that haven't been converted to define their own - exceptions yet.) + precisely went wrong. (This exception is mostly a relic from a + previous version of the interpreter; it is not used very much any + more.) \end{excdesc}
msg204376 - (view)	Author: Roundup Robot (python-dev)	Date: 2013-11-25 18:08
New changeset 313d9bb253bf by Antoine Pitrou in branch '2.7': Issue #19691: remove outdated mention about RuntimeError http://hg.python.org/cpython/rev/313d9bb253bf
msg204378 - (view)	Author: Roundup Robot (python-dev)	Date: 2013-11-25 18:12
New changeset 6aeaaa614a19 by Antoine Pitrou in branch '3.3': Issue #19691: remove outdated mention about RuntimeError http://hg.python.org/cpython/rev/6aeaaa614a19 New changeset f4de1c5e381d by Antoine Pitrou in branch 'default': Issue #19691: remove outdated mention about RuntimeError http://hg.python.org/cpython/rev/f4de1c5e381d