#1096310: document usage of sys.__std*__ a bit better.

#1096310: document usage of sys.std* a bit better.
b48adecb · Georg Brandl · 5206086e · b48adecb
Kaydet (Commit) b48adecb authored Mar 31, 2009 tarafından Georg Brandl
Hide whitespace changes
Inline Side-by-side

Showing with 8 additions and 3 deletions

sys.rst Doc/library/sys.rst +8 -3

No files found.
--- a/Doc/library/sys.rst
+++ b/Doc/library/sys.rst
@@ -871,9 +871,14 @@ always available.
          __stderr__
   These objects contain the original values of ``stdin``, ``stderr`` and
-   ``stdout`` at the start of the program.  They are used during finalization, and
+   ``stdout`` at the start of the program.  They are used during finalization,
-   could be useful to restore the actual files to known working file objects in
+   and could be useful to print to the actual standard stream no matter if the
-   case they have been overwritten with a broken object.
+   ``sys.std*`` object has been redirected.
+   It can also be used to restore the actual files to known working file objects
+   in case they have been overwritten with a broken object.  However, the
+   preferred way to do this is to explicitly save the previous stream before
+   replacing it, and restore the saved object.
 .. data:: tracebacklimit