Discussion:
[Python-3000-checkins] r66880 - python/branches/py3k/Doc/reference/datamodel.rst
benjamin.peterson
2008-10-12 12:51:12 UTC
Permalink
Author: benjamin.peterson
Date: Sun Oct 12 14:51:12 2008
New Revision: 66880

Log:
remove a mention of backtick repr

Modified:
python/branches/py3k/Doc/reference/datamodel.rst

Modified: python/branches/py3k/Doc/reference/datamodel.rst
==============================================================================
--- python/branches/py3k/Doc/reference/datamodel.rst (original)
+++ python/branches/py3k/Doc/reference/datamodel.rst Sun Oct 12 14:51:12 2008
@@ -1108,15 +1108,14 @@

.. index:: builtin: repr

- Called by the :func:`repr` built-in function and by string conversions (reverse
- quotes) to compute the "official" string representation of an object. If at all
- possible, this should look like a valid Python expression that could be used to
- recreate an object with the same value (given an appropriate environment). If
- this is not possible, a string of the form ``<...some useful description...>``
- should be returned. The return value must be a string object. If a class
- defines :meth:`__repr__` but not :meth:`__str__`, then :meth:`__repr__` is also
- used when an "informal" string representation of instances of that class is
- required.
+ Called by the :func:`repr` built-in function to compute the "official" string
+ representation of an object. If at all possible, this should look like a
+ valid Python expression that could be used to recreate an object with the
+ same value (given an appropriate environment). If this is not possible, a
+ string of the form ``<...some useful description...>`` should be returned.
+ The return value must be a string object. If a class defines :meth:`__repr__`
+ but not :meth:`__str__`, then :meth:`__repr__` is also used when an
+ "informal" string representation of instances of that class is required.

This is typically used for debugging, so it is important that the representation
is information-rich and unambiguous.

Loading...