# HG changeset patch
# User Sylvain Thénault <sylvain.thenault@logilab.fr>
# Date 1317053018 -7200
# Node ID 15809afe093b4b3da1662582a764e1c1bdcfebc0
# Parent  db6bb2da397c0bf3b3a93732603bc3d484ee3a84
[migration doc] talk about changes in Entity.fetch_rql

diff -r db6bb2da397c -r 15809afe093b 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: