Adding examples from ipython1-dev to docs/examples/kernel. These

examples show how to use IPython for parallel computing.  I need to
update the import statements and make sure they work with the merged
code.  But here they are.

docs/examples/kernel/asyncmultiengine1.py

@@ -0,0 +1,23
+#!/usr/bin/env python
+# encoding: utf-8
+
+# A super simple example showing how to use all of this in a fully
+# asynchronous manner.  The TaskClient also works in this mode.
+
+from twisted.internet import reactor, defer
+from ipython1.kernel import asyncclient
+
+def printer(r):
+    print r
+    return r
+
+def submit(client):
+    d = client.push(dict(a=5, b='asdf', c=[1,2,3]),targets=0,block=True)
+    d.addCallback(lambda _: client.pull(('a','b','c'),targets=0,block=True))
+    d.addBoth(printer)
+    d.addCallback(lambda _: reactor.stop())
+
+d = asyncclient.get_multiengine_client()
+d.addCallback(submit)
+
+reactor.run()
  No newline at end of file

docs/examples/kernel/asynctask1.py

@@ -0,0 +1,31
+#!/usr/bin/env python
+# encoding: utf-8
+
+# This example shows how the AsynTaskClient can be used
+
+from twisted.internet import reactor, defer
+from ipython1.kernel import asynclient
+
+mec = asynclient.AsynMultiEngineClient(('localhost', 10105))
+tc = asynclient.AsynTaskClient(('localhost',10113))
+
+cmd1 = """\
+a = 5
+b = 10*d
+c = a*b*d
+"""
+
+t1 = asynclient.Task(cmd1, clear_before=False, clear_after=True, pull=['a','b','c'])
+
+d = mec.push(dict(d=30))
+
+def raise_and_print(tr):
+    tr.raiseException()
+    print "a, b: ", tr.ns.a, tr.ns.b
+    return tr
+
+d.addCallback(lambda _: tc.run(t1))
+d.addCallback(lambda tid: tc.get_task_result(tid,block=True))
+d.addCallback(raise_and_print)
+d.addCallback(lambda _: reactor.stop())
+reactor.run()