From 6e6c6ac3d7ccd235d8cb6835db85a432ac0ccba5 Mon Sep 17 00:00:00 2001 From: Ezio Melotti Date: Fri, 23 Aug 2013 22:41:39 +0300 Subject: #18796: improve documentation of the file argument of dis.show_code. Initial patch by Vajrasky Kok. --- Doc/library/dis.rst | 3 ++- Lib/dis.py | 5 ++++- 2 files changed, 6 insertions(+), 2 deletions(-) diff --git a/Doc/library/dis.rst b/Doc/library/dis.rst index 468ce92..a546f68 100644 --- a/Doc/library/dis.rst +++ b/Doc/library/dis.rst @@ -109,7 +109,8 @@ object isn't useful: .. function:: show_code(x, *, file=None) Print detailed code object information for the supplied function, method, - source code string or code object to stdout. + source code string or code object to *file* (or ``sys.stdout`` if *file* + is not specified). This is a convenient shorthand for ``print(code_info(x), file=file)``, intended for interactive exploration at the interpreter prompt. diff --git a/Lib/dis.py b/Lib/dis.py index ca4094c..0d62c08 100644 --- a/Lib/dis.py +++ b/Lib/dis.py @@ -146,7 +146,10 @@ def _format_code_info(co): return "\n".join(lines) def show_code(co, *, file=None): - """Print details of methods, functions, or code to stdout.""" + """Print details of methods, functions, or code to *file*. + + If *file* is not provided, the output is printed on stdout. + """ print(code_info(co), file=file) _Instruction = collections.namedtuple("_Instruction", -- cgit v0.12