[migration doc] talk about changes in Entity.fetch_rql
authorSylvain Thénault <sylvain.thenault@logilab.fr>
Mon, 26 Sep 2011 18:03:38 +0200
changeset 7859 15809afe093b
parent 7848 db6bb2da397c
child 7868 39a54b88906d
[migration doc] talk about changes in Entity.fetch_rql
doc/3.14.rst
--- a/doc/3.14.rst	Fri Sep 23 14:56:31 2011 +0200
+++ b/doc/3.14.rst	Mon Sep 26 18:03:38 2011 +0200
@@ -1,6 +1,13 @@
 API changes in cubicweb 3.14
 ----------------------------
 
+* `Entity.fetch_rql` `restriction` argument has been deprecated and should be
+  replaced with a call to the new `Entity.fetch_rqlst` method, get the returned
+  value (a rql `Select` node) and use the RQL syntax tree API to include the
+  above-mentionned restrictions.
+
+  Backward compat is kept with proper warning.
+
 * `Entity.fetch_order` and `Entity.fetch_unrelated_order` class methods have been
   replaced by `Entity.cw_fetch_order` and `Entity.cw_fetch_unrelated_order` with
   a different prototype: