Document ways of integrating objects with IPython.

docs/source/config/integrating.txt

@@ -0,0 +1,44 b''
+.. _integrating:
+
+=====================================
+Integrating your objects with IPython
+=====================================
+
+Tab completion
+==============
+
+To change the attributes displayed by tab-completing your object, define a
+``__dir__(self)`` method for it. For more details, see the documentation of the
+built-in `dir() function <http://docs.python.org/library/functions.html#dir>`_.
+
+Rich display
+============
+
+The notebook and the Qt console can display richer representations of objects.
+To use this, you can define any of a number of ``_repr_*_()`` methods. Note that
+these are surrounded by single, not double underscores.
+
+Both the notebook and the Qt console can display ``svg``, ``png`` and ``jpeg``
+representations. The notebook can also display ``html``, ``javascript``,
+``json`` and ``latex``. If the methods don't exist, or return ``None``, it falls
+back to a standard ``repr()``.
+
+For example::
+
+    class Shout(object):
+        def __init__(self, text):
+            self.text = text
+        
+        def _repr_html_(self):
+            return "<h1>" + self.text + "</h1>"
+
+Custom exception tracebacks
+===========================
+
+Rarely, you might want to display a different traceback with an exception -
+IPython's own parallel computing framework does this to display errors from the
+engines. To do this, define a ``_render_traceback_(self)`` method which returns
+a list of strings, each containing one line of the traceback.
+
+Please be conservative in using this feature; by replacing the default traceback
+you may hide important information from the user.

docs/source/config/index.txt

@@ -10,5 +10,6 b' Configuration and customization'
    overview.txt
    extensions/index.txt
    ipython.txt
+   integrating.txt
    editors.txt
    old.txt

docs/source/whatsnew/development.txt

@@ -6,4 +6,8 b' This document describes in-flight development work.'
 
 The CodeMirror js library has been updated fron 2.23 to 2.32 
 this might induce a few changes in behavior of keymaps in the notebook, 
-especially intenting/deindenting blocks that is now bounded to Ctrl+] and ctr+[
+especially intenting/deindenting blocks that is now bound to Ctrl+] and ctr+[
+
+* Exception types can now be displayed with a custom traceback, by defining a
+  ``_render_traceback_()`` method which returns a list of strings, each
+  containing one line of the traceback.