diff --git a/odoo/fields.py b/odoo/fields.py
index 141a66ec25e..fcf2cb786e1 100644
--- a/odoo/fields.py
+++ b/odoo/fields.py
@@ -235,6 +235,10 @@ class Field(MetaField('DummyField', (object,), {})):
         to bypass access rights (by default ``True`` for stored fields, ``False``
         for non stored fields)
 
+    :param bool recursive: whether the field has recursive dependencies (the field
+        ``X`` has a dependency like ``parent_id.X``); declaring a field recursive
+        must be explicit to guarantee that recomputation is correct
+
     :param str inverse: name of a method that inverses the field (optional)
 
     :param str search: name of a method that implement search on the field (optional)