docs: move Router.route() into Sphinx.

docs/api.rst

@@ -340,9 +340,11 @@ Router Class
 
 	.. method:: route(msg)
 
-        Arrange for `msg` to be forwarded towards its destination. If its
+        Arrange for the :py:class:`Message` `msg` to be delivered to its
-        destination is the local context, then arrange for it to be dispatched
+        destination using any relevant downstream context, or if none is found,
-        using the local handlers.
+        by forwarding the message upstream towards the master context. If `msg`
+        is destined for the local context, it is dispatched using the handles
+        registered with :py:meth:`add_handler`.
 
         This may be called from any thread.
 

mitogen/core.py

@@ -914,13 +914,6 @@ class Router(object):
         stream.send(msg)
 
     def route(self, msg):
-        """
-        Arrange for the :py:class:`Message` `msg` to be delivered to its
-        destination using any relevant downstream context, or if none is found,
-        by forwarding the message upstream towards the master context. If `msg`
-        is destined for the local context, it is dispatched using the handles
-        registered with :py:meth:`add_handler`.
-        """
         self.broker.defer(self._async_route, msg)