rewrite pastefig() qt doc section for display()

docs/source/interactive/qtconsole.txt

@@ -52,14 +52,25 b' input and the drawing eventloop.'
 .. image:: figs/besselj.png
     :width: 519px
 
-.. pastefig:
+.. display:
 
-:func:`pastefig`
-****************
+:func:`display`
+***************
 
-An additional function, :func:`pastefig`, will be added to the global namespace if you
-specify the ``pylab`` argument. This takes the active figures in matplotlib, and embeds
-them in your document. This is especially useful for saving_ your work.
+An additional function, :func:`display`, will be added to the global namespace if you
+specify the ``pylab`` argument. The IPython display system provides a mechanism for
+specifying PNG or SVG (and more) representations of objects for GUI frontends. By default,
+IPython registers convenient PNG and SVG renderers for matplotlib figures, so you can
+embed them in your document by calling :func:`display` on one or more of them. This is
+especially useful for saving_ your work.
+
+.. sourcecode:: ipython
+
+    In [5]: plot(range(5)) # plots in the matplotlib window
+    
+    In [6]: display(gcf()) # embeds the current figure in the qtconsole
+    
+    In [7]: display(*getfigs()) # embeds all active figures in the qtconsole
 
 .. _inline:
 
@@ -67,9 +78,9 b' them in your document. This is especially useful for saving_ your work.'
 ******************
 
 If you want to have all of your figures embedded in your session, instead of calling
-:func:`pastefig`, you can specify ``--pylab=inline`` when you start the console,
+:func:`display`, you can specify ``--pylab=inline`` when you start the console,
 and each time you make a plot, it will show up in your document, as if you had
-called :func:`pastefig`.
+called :func:`display(fig)`.
 
 
 .. _saving:
@@ -78,7 +89,7 b' Saving and Printing'
 ===================
 
 IPythonQt has the ability to save your current session, as either HTML or XHTML. If you
-have been using :func:`pastefig` or inline_ pylab, your figures will be PNG
+have been using :func:`display` or inline_ pylab, your figures will be PNG
 in HTML, or inlined as SVG in XHTML. PNG images have the option to be either in an
 external folder, as in many browsers' "Webpage, Complete" option, or inlined as well, for
 a larger, but more portable file.