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: Weird wording in RuntimeError doc
Type: behavior Stage: resolved
Components: Documentation Versions: Python 3.3, Python 3.4, Python 2.7
process
Status: closed Resolution: fixed
Dependencies: Superseder:
Assigned To: docs@python Nosy List: docs@python, ezio.melotti, georg.brandl, martin.panter, neologix, pitrou, python-dev
Priority: normal Keywords: easy

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) * (Python committer) 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) * (Python committer) Date: 2013-11-25 03:46
So maybe it can just be removed?
msg204298 - (view) Author: Georg Brandl (georg.brandl) * (Python committer) Date: 2013-11-25 06:55
I think so.
msg204365 - (view) Author: Antoine Pitrou (pitrou) * (Python committer) 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) (Python triager) 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) (Python triager) 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
History
Date User Action Args
2022-04-11 14:57:53adminsetgithub: 63890
2013-11-25 18:13:51pitrousetstatus: open -> closed
resolution: fixed
stage: needs patch -> resolved
2013-11-25 18:12:53python-devsetmessages: + msg204378
2013-11-25 18:08:39python-devsetnosy: + python-dev
messages: + msg204376
2013-11-25 17:13:19pitrousetmessages: + msg204365
2013-11-25 06:55:20georg.brandlsetnosy: + georg.brandl
messages: + msg204298
2013-11-25 03:46:47ezio.melottisetnosy: + ezio.melotti
messages: + msg204292

keywords: + easy
stage: needs patch
2013-11-24 00:53:57martin.pantersetnosy: + martin.panter
2013-11-22 14:21:48pitroucreate