diff options
author | gaogaotiantian <gaogaotiantian@hotmail.com> | 2023-03-30 22:51:36 (GMT) |
---|---|---|
committer | GitHub <noreply@github.com> | 2023-03-30 22:51:36 (GMT) |
commit | c1e71ce56fdb3eab62ad3190d09130f800e54610 (patch) | |
tree | 0e487b0a4a3a595d7397d3390e0e1a0c8410da6a /Doc | |
parent | 01a49d17454b9072a0c46b550573ea430048684a (diff) | |
download | cpython-c1e71ce56fdb3eab62ad3190d09130f800e54610.zip cpython-c1e71ce56fdb3eab62ad3190d09130f800e54610.tar.gz cpython-c1e71ce56fdb3eab62ad3190d09130f800e54610.tar.bz2 |
Minor docs improvements fix for `codeop` (#103123)
Diffstat (limited to 'Doc')
-rw-r--r-- | Doc/library/codeop.rst | 14 |
1 files changed, 7 insertions, 7 deletions
diff --git a/Doc/library/codeop.rst b/Doc/library/codeop.rst index c66b9d3..90df499 100644 --- a/Doc/library/codeop.rst +++ b/Doc/library/codeop.rst @@ -19,10 +19,10 @@ module instead. There are two parts to this job: -#. Being able to tell if a line of input completes a Python statement: in +#. Being able to tell if a line of input completes a Python statement: in short, telling whether to print '``>>>``' or '``...``' next. -#. Remembering which future statements the user has entered, so subsequent +#. Remembering which future statements the user has entered, so subsequent input can be compiled with these in effect. The :mod:`codeop` module provides a way of doing each of these things, and a way @@ -33,9 +33,9 @@ To do just the former: .. function:: compile_command(source, filename="<input>", symbol="single") Tries to compile *source*, which should be a string of Python code and return a - code object if *source* is valid Python code. In that case, the filename + code object if *source* is valid Python code. In that case, the filename attribute of the code object will be *filename*, which defaults to - ``'<input>'``. Returns ``None`` if *source* is *not* valid Python code, but is a + ``'<input>'``. Returns ``None`` if *source* is *not* valid Python code, but is a prefix of valid Python code. If there is a problem with *source*, an exception will be raised. @@ -43,9 +43,9 @@ To do just the former: :exc:`OverflowError` or :exc:`ValueError` if there is an invalid literal. The *symbol* argument determines whether *source* is compiled as a statement - (``'single'``, the default), as a sequence of statements (``'exec'``) or + (``'single'``, the default), as a sequence of :term:`statement` (``'exec'``) or as an :term:`expression` (``'eval'``). Any other value will - cause :exc:`ValueError` to be raised. + cause :exc:`ValueError` to be raised. .. note:: @@ -69,5 +69,5 @@ To do just the former: Instances of this class have :meth:`__call__` methods identical in signature to :func:`compile_command`; the difference is that if the instance compiles program - text containing a ``__future__`` statement, the instance 'remembers' and + text containing a :mod:`__future__` statement, the instance 'remembers' and compiles all subsequent program texts with the statement in force. |