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

Patch from Nikolaus Rath.

diff --git a/Doc/library/io.rst b/Doc/library/io.rst
index 79f65e00071f5aecc935b80aba015ce489dcd183..0c7d3c7f6b0e05de92996cec148bf20467750164 100644 (file)
--- a/Doc/library/io.rst
+++ b/Doc/library/io.rst
@@ -353,6 +353,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