document IOBase.__del__'s behavior (closes #21764)

Patch from Nikolaus Rath.

diff --git a/Doc/library/io.rst b/Doc/library/io.rst
index be208847da5eb70867f36b2e6152d690b2b28639..7b400858668fe186c678c022231dfb25fbf27099 100644 (file)
--- a/Doc/library/io.rst
+++ b/Doc/library/io.rst
@@ -346,6 +346,12 @@ I/O Base Classes
       is usual for each of the lines provided to have a line separator at the
       end.
 
+   .. method:: __del__()
+
+      Prepare for object destruction. :class:`IOBase` provides a default
+      implementation of this method that calls the instance's
+      :meth:`~IOBase.close` method.
+
 
 .. class:: RawIOBase