Whats new in CubicWeb 3.14

==========================

API changes

-----------

* `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:

  - instead of taking (attr, var) as two string argument, they now take (select,

    attr, var) where select is the rql syntax tree beinx constructed and var the

    variable *node*.

  - instead of returning some string to be inserted in the ORDERBY clause, it has

    to modify the syntax tree

  Backward compat is kept with proper warning, BESIDE cases below:

  - custom order method return **something else the a variable name with or

    without the sorting order** (e.g. cases where you sort on the value of a

    registered procedure as it was done in the tracker for instance). In such

    case, an error is logged telling that this sorting is ignored until API

    upgrade.

  - client code use direct access to one of those methods on an entity (no code

* `Entity._rest_attr_info` class method has been renamed to

  `Entity.cw_rest_attr_info`

  No backward compat yet since this is a protected method an no code is known to

  use it outside cubicweb itself.

* `AnyEntity.linked_to` has been removed as part of a refactoring of this

  functionality (link a entity to another one at creation step). It was replaced

  by a `EntityFieldsForm.linked_to` property.

  In the same refactoring, `cubicweb.web.formfield.relvoc_linkedto`,

  `cubicweb.web.formfield.relvoc_init` and

  `cubicweb.web.formfield.relvoc_unrelated` were removed and replaced by

  RelationField methods with the same names, that take a form as a parameter.

  **No backward compatibility yet**. It's still time to cry for it.

* `CWPermission` entity type and its associated require_permission relation type

  (abstract) and require_group relation definitions have been moved to a new

  `localperms` cube. With this have gone some functions from the

  `cubicweb.schemas` package as well as some views. This makes cubicweb itself

  smaller while you get all the local permissions stuff into a single,

  documented, place.

  Backward compat is kept for existing instances, **though you should have

  installed the localperms cubes**. A proper error should be displayed when

  trying to migrate to 3.14 an instance the use `CWPermission` without the new

  cube installed. For new instances / test, you should add a dependancy on the

  new cube in cubes using this feature, along with a dependancy on cubicweb >=

  3.14.

  which are however kept for backward compat, with some warnings that may not be

  very clear unfortunatly (you may see your own table view subclass name here,

  which doesn't make the problem that clear). Notice that `_cw.view('table',

  rset, *kwargs)` will be routed to the new `RsetTableView` or to the old

  `TableView` depending on given extra arguments. See #1986413.

* `IEditControlAdapter` has been deprecated in favor of `EditController`

  overloading, which was made easier by adding dedicated selectors called

Unintrusive API changes

-----------------------

User interface changes

----------------------

* users and groups management now really lead to that (i.e. includes *groups*

Configuration

------------