Docs: Add unreleased features

Author: msiemens

README.rst

@@ -163,61 +163,67 @@ extensions: Contributions to TinyDB are welcome! Here's how to get started:
 Changelog
 *********
 
-**v3.5.0** (2017-08-30)
-=======================
+*unreleased*
+============
+
+- Allow updating all documents using ``db.update(fields)`` (see
+  `issue #157 <https://github.com/msiemens/tinydb/issues/157>`_).
+
+v3.5.0 (2017-08-30)
+===================
 
 - Expose the table name via ``table.name`` (see
-  `issue #148 <https://github.com/msiemens/tinydb/issues/147>`_).
+  `issue #147 <https://github.com/msiemens/tinydb/issues/147>`_).
 - Allow better subclassing of the ``TinyDB`` class
   (see `pull request #150 <https://github.com/msiemens/tinydb/pull/150>`_).
 
-**v3.4.1** (2017-08-23)
-=======================
+v3.4.1 (2017-08-23)
+===================
 
 - Expose TinyDB version via ``import tinyb; tinydb.__version__`` (see
   `issue #148 <https://github.com/msiemens/tinydb/issues/148>`_).
 
-**v3.4.0** (2017-08-08)
-=======================
+v3.4.0 (2017-08-08)
+===================
 
 - Add new update operations: ``add(key, value)``, ``substract(key, value)``,
   and ``set(key, value)``
   (see `pull request #145 <https://github.com/msiemens/tinydb/pull/145>`_).
 
-**v3.3.1** (2017-06-27)
-=======================
+v3.3.1 (2017-06-27)
+===================
 
 - Use relative imports to allow vendoring TinyDB in other packages
   (see `pull request #142 <https://github.com/msiemens/tinydb/pull/142>`_).
 
-**v3.3.0** (2017-06-05)
-=======================
+v3.3.0 (2017-06-05)
+===================
 
 - Allow iterating over a database or table yielding all elements
   (see `pull request #139 <https://github.com/msiemens/tinydb/pull/139>`_).
 
-**v3.2.3** (2017-04-22)
-=======================
+v3.2.3 (2017-04-22)
+===================
 
 - Fix bug with accidental modifications to the query cache when modifying
   the list of search results (see `issue #132 <https://github.com/msiemens/tinydb/issues/132>`_).
 
-**v3.2.2** (2017-01-16)
-=======================
+v3.2.2 (2017-01-16)
+===================
 
 - Fix the ``Query`` constructor to prevent wrong usage
   (see `issue #117 <https://github.com/msiemens/tinydb/issues/117>`_).
 
-**v3.2.1** (2016-06-29)
-=======================
+v3.2.1 (2016-06-29)
+===================
 
 - Fix a bug with queries on elements that have a ``path`` key
   (see `pull request #107 <https://github.com/msiemens/tinydb/pull/107>`_).
 - Don't write to the database file needlessly when opening the database
   (see `pull request #104 <https://github.com/msiemens/tinydb/pull/104>`_).
 
-**v3.2.0** (2016-04-25)
-=======================
+v3.2.0 (2016-04-25)
+===================
 
 - Add a way to specify the default table name via `default_table <http://tinydb.readthedocs.io/en/v3.2.0/usage.html#default-table>`_
   (see `pull request #98 <https://github.com/msiemens/tinydb/pull/98>`_).
@@ -228,38 +234,38 @@ Changelog
 
 - Extend API documentation (see `issue #96 <https://github.com/msiemens/tinydb/issues/96>`_).
 
-**v3.1.3** (2016-02-14)
-=======================
+v3.1.3 (2016-02-14)
+===================
 
 - Fix a bug when that breaks the JSONStorage when the ``TinyDB`` instance gets garbagge collected
   (see `issue #92 <https://github.com/msiemens/tinydb/issues/92>`_).
 
-**v3.1.2** (2016-01-30)
-=======================
+v3.1.2 (2016-01-30)
+===================
 
 - Fix a bug when using unhashable elements (lists, dicts) with
   ``Query.any`` or ``Query.all`` queries
   (see `a forum post by karibul <https://forum.m-siemens.de/d/4-error-with-any-and-all-queries>`_).
 
-**v3.1.1** (2016-01-23)
-=======================
+v3.1.1 (2016-01-23)
+===================
 
 - Inserting a dictionary with data that is not JSON serializable doesn't
   lead to corrupt files anymore (see `issue #89 <https://github.com/msiemens/tinydb/issues/89>`_).
 - Fix a bug in the LRU cache that may lead to an invalid query cache
   (see `issue #87 <https://github.com/msiemens/tinydb/issues/87>`_).
 
-**v3.1.0** (2015-12-31)
-=======================
+v3.1.0 (2015-12-31)
+===================
 
 - ``db.update(...)`` and ``db.remove(...)`` now return affected element IDs
   (see `issue #83 <https://github.com/msiemens/tinydb/issues/83>`_).
 - Inserting an invalid element (i.e. not a ``dict``) now raises an error
   instead of corrupting the database (see
   `issue #74 <https://github.com/msiemens/tinydb/issues/74>`_).
 
-**v3.0.0** (2015-11-13)
-=======================
+v3.0.0 (2015-11-13)
+===================
 
 -  Overhauled Query model:
 
@@ -287,15 +293,15 @@ Changelog
 .. _msiemens/tinydb-smartcache: https://github.com/msiemens/tinydb-smartcache
 .. _msiemens/tinydb-serialization: https://github.com/msiemens/tinydb-serialization
 
-**v2.4.0** (2015-08-14)
-=======================
+v2.4.0 (2015-08-14)
+===================
 
 - Allow custom parameters for custom test functions
   (see `issue #63 <https://github.com/msiemens/tinydb/issues/63>`_ and
   `pull request #64 <https://github.com/msiemens/tinydb/pull/64>`_).
 
-**v2.3.2** (2015-05-20)
-=======================
+v2.3.2 (2015-05-20)
+===================
 
 - Fix a forgotten debug output in the ``SerializationMiddleware``
   (see `issue #55 <https://github.com/msiemens/tinydb/issues/55>`_).
@@ -304,14 +310,14 @@ Changelog
 - Fix a problem with symlinks when checking out TinyDB on OSX Yosemite
   (see `issue #52 <https://github.com/msiemens/tinydb/issues/52>`_).
 
-**v2.3.1** (2015-04-30)
-=======================
+v2.3.1 (2015-04-30)
+===================
 
 - Hopefully fix a problem with using TinyDB as a dependency in a ``setup.py`` script
   (see `issue #51 <https://github.com/msiemens/tinydb/issues/51>`_).
 
-**v2.3.0** (2015-04-08)
-=======================
+v2.3.0 (2015-04-08)
+===================
 
 - Added support for custom serialization. That way, you can teach TinyDB
   to store ``datetime`` objects in a JSON file :)
@@ -321,20 +327,20 @@ Changelog
   (see `issue #49 <https://github.com/msiemens/tinydb/issues/49>`_)
 - Internal code has been cleaned up
 
-**v2.2.2** (2015-02-12)
-=======================
+v2.2.2 (2015-02-12)
+===================
 
 - Fixed a data loss when using ``CachingMiddleware`` together with ``JSONStorage``
   (see `issue #47 <https://github.com/msiemens/tinydb/issues/47>`_)
 
-**v2.2.1** (2015-01-09)
-=======================
+v2.2.1 (2015-01-09)
+===================
 
 - Fixed handling of IDs with the JSON backend that converted integers
   to strings (see `issue #45 <https://github.com/msiemens/tinydb/issues/45>`_)
 
-**v2.2.0** (2014-11-10)
-=======================
+v2.2.0 (2014-11-10)
+===================
 
 - Extended ``any`` and ``all`` queries to take lists as conditions
   (see `pull request #38 <https://github.com/msiemens/tinydb/pull/38>`_)
@@ -343,22 +349,22 @@ Changelog
 - Fixed some issues with ``CachingMiddleware`` in combination with
   ``JSONStorage`` (see `pull request #39 <https://github.com/msiemens/tinydb/pull/39>`_)
 
-**v2.1.0** (2014-10-14)
-=======================
+v2.1.0 (2014-10-14)
+===================
 
 - Added ``where(...).contains(regex)``
   (see `issue #32 <https://github.com/msiemens/tinydb/issues/32>`_)
 - Fixed a bug that corrupted data after reopening a database
   (see `issue #34 <https://github.com/msiemens/tinydb/issues/34>`_)
 
-**v2.0.1** (2014-09-22)
-=======================
+v2.0.1 (2014-09-22)
+===================
 
 - Fixed handling of Unicode data in Python 2
   (see `issue #28 <https://github.com/msiemens/tinydb/issues/28>`_).
 
-**v2.0.0** (2014-09-05)
-=======================
+v2.0.0 (2014-09-05)
+===================
 
 `Upgrade Notes <http://tinydb.readthedocs.io/en/v2.0/upgrade.html#upgrade-v2-0>`_
 
@@ -377,46 +383,46 @@ for details.
 - Added optional `smart query caching <http://tinydb.readthedocs.io/en/v2.0.0/usage.html#smart-query-cache>`_.
 - The query cache is now a `fixed size LRU cache <http://tinydb.readthedocs.io/en/v2.0.0/usage.html#query-caching>`_.
 
-**v1.4.0** (2014-07-22)
-=======================
+v1.4.0 (2014-07-22)
+===================
 
 - Added ``insert_multiple`` function
   (see `issue #8 <https://github.com/msiemens/tinydb/issues/8>`_).
 
-**v1.3.0** (2014-07-02)
-=======================
+v1.3.0 (2014-07-02)
+===================
 
 - Fixed `bug #7 <https://github.com/msiemens/tinydb/issues/7>`_: IDs not unique.
 - Extended the API: ``db.count(where(...))`` and ``db.contains(where(...))``.
 - The syntax ``query in db`` is now **deprecated** and replaced
   by ``db.contains``.
 
-**v1.2.0** (2014-06-19)
-=======================
+v1.2.0 (2014-06-19)
+===================
 
 - Added ``update`` method
   (see `issue #6 <https://github.com/msiemens/tinydb/issues/6>`_).
 
-**v1.1.1** (2014-06-14)
-=======================
+v1.1.1 (2014-06-14)
+===================
 
 - Merged `PR #5 <https://github.com/msiemens/tinydb/pull/5>`_: Fix minor
   documentation typos and style issues.
 
-**v1.1.0** (2014-05-06)
-=======================
+v1.1.0 (2014-05-06)
+===================
 
 - Improved the docs and fixed some typos.
 - Refactored some internal code.
 - Fixed a bug with multiple ``TinyDB?`` instances.
 
-**v1.0.1** (2014-04-26)
-=======================
+v1.0.1 (2014-04-26)
+===================
 
 - Fixed a bug in ``JSONStorage`` that broke the database when removing entries.
 
-**v1.0.0** (2013-07-20)
-=======================
+v1.0.0 (2013-07-20)
+===================
 
 - First official release – consider TinyDB stable now.