Realign documentation

Author: florentx

docs/api.rst

@@ -87,6 +87,10 @@ for database management.  Use :func:`dir` function to introspect them.
 
    Expose the ``/web/webclient`` :class:`WebAPI`.
 
+.. autoclass:: WebAPI
+   :members:
+   :undoc-members:
+
 
 Odoo RPC Services
 ~~~~~~~~~~~~~~~~~
@@ -142,10 +146,6 @@ Please refer to `the Odoo documentation`_ for more details.
 
    Removed in OpenERP 7.
 
-.. autoclass:: WebAPI
-   :members:
-   :undoc-members:
-
 .. autoclass:: Service
    :members:
    :undoc-members:
@@ -158,7 +158,7 @@ Environment
 -----------
 
 .. autoclass:: Env
-   :members: lang, execute, access, models, ref, __getitem__, odoo_env, registry
+   :members: lang, access, models, ref, __getitem__, odoo_env, registry
    :undoc-members:
 
    .. attribute:: db_name
@@ -219,7 +219,7 @@ Please refer to `the Odoo documentation`_ for details.
 
 .. attribute:: Env._web(obj, method, *params, **kwargs)
 
-   Expose the root of the ``/web`` API.
+   Expose the ``/web`` API and its endpoints.
 
 .. method:: Env.exec_workflow(obj, signal, obj_id)
 

odooly.py

@@ -517,11 +517,11 @@ def __new__(cls, client, db_name=()):
         return env
 
     def __contains__(self, name):
-        """Test wether the given model exists."""
+        """Test wether this model exists."""
         return name in self._model_names or name in self.models(name)
 
     def __getitem__(self, name):
-        """Return the given :class:`Model`."""
+        """Return the :class:`Model` for the given ``name``."""
         return self._get(name)
 
     def __iter__(self):
@@ -741,11 +741,12 @@ def _cache_set(self, key, value, db_name=None):
         return value
 
     def execute(self, obj, method, *params, **kwargs):
-        """Wrapper around ``object.execute_kw`` RPC method.
+        """Wrapper around ``/web/dataset/call_kw`` Web endpoint,
+        or ``object.execute_kw`` RPC method.
 
-        Argument `method` is the name of an ``osv.osv`` method or
-        a method available on this `obj`.
-        Method `params` are allowed.  If needed, keyword
+        Argument `method` is the name of a standard ``Model`` method
+        or a specific method available on this `obj`.
+        Method `params` are accepted.  If needed, keyword
         arguments are collected in `kwargs`.
         """
         assert self.uid, 'Not connected'