From: Georg Brandl Date: Tue, 31 Mar 2009 19:10:35 +0000 (+0000) Subject: #1096310: document usage of sys.__std*__ a bit better. X-Git-Tag: v2.7a1~1690 X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=b48adecbd68442708f74c57779c4bbce80fec7cd;p=python #1096310: document usage of sys.__std*__ a bit better. --- diff --git a/Doc/library/sys.rst b/Doc/library/sys.rst index 30555c824b..6d02109e37 100644 --- 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 - could be useful to restore the actual files to known working file objects in - case they have been overwritten with a broken object. + ``stdout`` at the start of the program. They are used during finalization, + and could be useful to print to the actual standard stream no matter if the + ``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