--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/doc/changes/3.21.rst Thu Jul 02 19:54:25 2015 +0200
@@ -0,0 +1,74 @@
+What's new in CubicWeb 3.21?
+============================
+
+New features
+------------
+
+* the datadir-url configuration option lets one choose where static data files
+ are served (instead of the default ${base-url}/data/)
+
+* some integrity checking that was previously implemented in Python was
+ moved to the SQL backend. This includes some constraints, and
+ referential integrity. Some consequences are that:
+
+ - disabling integrity hooks no longer disables those checks
+ - upgrades that modify constraints will fail when running on sqlite
+ (but upgrades aren't supported on sqlite anyway)
+
+* for easier instance monitoring, cubicweb can regularly dump some statistics
+ (basically those exposed by the 'info' and 'gc' views) in json format to a file
+
+User-visible changes
+--------------------
+
+* the use of fckeditor for text form fields is disabled by default
+
+* the 'https-deny-anonymous' configuration setting no longer exists
+
+Code movement
+-------------
+
+The cubicweb.web.views.timeline module (providing the timeline-json, timeline
+and static-timeline views) has moved to a standalone cube_
+
+.. _cube: https://www.cubicweb.org/project/cubicweb-timeline
+
+API changes
+-----------
+
+* req.set_cookie's "expires" argument, if not None, is expected to be a
+ date or a datetime in UTC. It was previously interpreted as localtime
+ with the UTC offset the server started in, which was inconsistent (we
+ are not aware of any users of that API).
+
+* the way to run tests on a postgresql backend has changed slightly, use
+ cubicweb.devtools.{start,stop}pgcluster in setUpModule and tearDownModule
+
+* the Connection and ClientConnection objects introduced in CubicWeb 3.19 have
+ been unified. To connect to a repository, use::
+
+ session = repo.new_session(login, password=...)
+ with session.new_cnx() as cnx:
+ cnx.execute(...)
+
+ In tests, the 'repo_cnx' and 'client_cnx' methods of RepoAccess are now
+ aliases to 'cnx'.
+
+Deprecated code drops
+---------------------
+
+* the user_callback api has been removed; people should use plain
+ ajax functions instead
+
+* the `Pyro` and `Zmq-pickle` remote repository access methods have
+ been entirely removed (emerging alternatives such as rqlcontroller
+ and cwclientlib should be used instead). Note that as a side effect,
+ "repository-only" instances (i.e. without a http component) are no
+ longer possible. If you have any such instances, you will need to
+ rename the configuration file from repository.conf to all-in-one.conf
+ and run ``cubicweb-ctl upgrade`` to update it. Likewise, remote cubicweb-ctl
+ shell is no longer available.
+
+* the old (deprecated since 3.19) `DBAPI` api is completely removed
+
+* cubicweb.toolsutils.config_connect() has been removed