diff -r 63dac5212552 Doc/library/stdtypes.rst
--- a/Doc/library/stdtypes.rst	Sat Jan 10 09:00:20 2015 +0100
+++ b/Doc/library/stdtypes.rst	Sun Jan 25 11:33:02 2015 -0500
@@ -1944,22 +1944,22 @@
         "They're Bill's Friends."
 
 
-.. method:: str.translate(map)
-
-   Return a copy of the *s* where all characters have been mapped through the
-   *map* which must be a dictionary of Unicode ordinals (integers) to Unicode
-   ordinals, strings or ``None``.  Unmapped characters are left untouched.
-   Characters mapped to ``None`` are deleted.
+.. method:: str.translate(table)
+
+   Return a copy of the string in which each character has been
+   mapped through the given translation table.  The table must be
+   an object that implements indexing via :meth:`__getitem__`, typically
+   a :term:`mapping` or :term:`sequence`.  When indexed by a Unicode ordinal (an integer),
+   the table object can do any of the following:
+   return a Unicode ordinal or a string, to
+   map the character to one or more other characters; or
+   return ``None``, to delete the character from the return string; or
+   raise a :exc:`LookupError` exception, to
+   map the character to itself.
 
    You can use :meth:`str.maketrans` to create a translation map from
    character-to-character mappings in different formats.
 
-   .. note::
-
-      An even more flexible approach is to create a custom character mapping
-      codec using the :mod:`codecs` module (see :mod:`encodings.cp1251` for an
-      example).
-
 
 .. method:: str.upper()
 
diff -r 63dac5212552 Objects/unicodeobject.c
--- a/Objects/unicodeobject.c	Sat Jan 10 09:00:20 2015 +0100
+++ b/Objects/unicodeobject.c	Sun Jan 25 11:33:02 2015 -0500
@@ -13065,11 +13065,12 @@
 PyDoc_STRVAR(translate__doc__,
              "S.translate(table) -> str\n\
 \n\
-Return a copy of the string S, where all characters have been mapped\n\
-through the given translation table, which must be a mapping of\n\
-Unicode ordinals to Unicode ordinals, strings, or None.\n\
-Unmapped characters are left untouched. Characters mapped to None\n\
-are deleted.");
+Return a copy of the string S in which each character has been mapped\n\
+through the given translation table. The table must implement\n\
+lookup/indexing via __getitem__, for instance a dictionary or list,\n\
+mapping Unicode ordinals to Unicode ordinals, strings, or None. If\n\
+this operation raises LookupError, the character is left untouched.\n\
+Characters mapped to None are deleted.");
 
 static PyObject*
 unicode_translate(PyObject *self, PyObject *table)