diff --git a/doc/routing.rst b/doc/routing.rst
index b2e93de8ef9..6a4af3374a9 100644
--- a/doc/routing.rst
+++ b/doc/routing.rst
@@ -12,9 +12,16 @@ endpoints.
 
 In older version of OpenERP, adding RPC endpoints was done by subclassing the
 ``openerp.netsvc.ExportService`` class. Adding WSGI handlers was done by
-registering them with the ``openerp.wsgi.register_wsgi_handler()`` function.
+registering them with the :py:func:`openerp.wsgi.register_wsgi_handler`
+function.
 
 Starting with OpenERP 7.1, exposing a new arbitrary WSGI handler is done with
-the ``openerp.http.handler`` decorator while adding an RPC endpoint is done
-with the ``openerp.http.rpc`` decorator.
+the :py:func:`openerp.http.handler` decorator while adding an RPC endpoint is
+done with the :py:func:`openerp.http.rpc` decorator.
 
+Routing decorators
+------------------
+
+.. automodule:: openerp.http
+   :members:
+   :undoc-members:
diff --git a/openerp/http.py b/openerp/http.py
index 004542f3100..e2f3024110d 100644
--- a/openerp/http.py
+++ b/openerp/http.py
@@ -1,8 +1,8 @@
 # -*- coding: utf-8 -*-
 
 """
-Decorators to register WSGI and RPC endpoints handlers. See doc/routing.rst.
-# TODO use sphinx ref to doc/routing.rst.
+``openerp.http`` offers decorators to register WSGI and RPC endpoints handlers.
+See :ref:`routing`.
 """
 
 from . import service