You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@couchdb.apache.org by kx...@apache.org on 2013/08/09 10:57:17 UTC
[5/9] Split changelog.rst into group of per release branch articles.
http://git-wip-us.apache.org/repos/asf/couchdb/blob/4c0241d1/share/doc/src/whatsnew/1.2.rst
----------------------------------------------------------------------
diff --git a/share/doc/src/whatsnew/1.2.rst b/share/doc/src/whatsnew/1.2.rst
new file mode 100644
index 0000000..fe6a918
--- /dev/null
+++ b/share/doc/src/whatsnew/1.2.rst
@@ -0,0 +1,239 @@
+.. Licensed under the Apache License, Version 2.0 (the "License"); you may not
+.. use this file except in compliance with the License. You may obtain a copy of
+.. the License at
+..
+.. http://www.apache.org/licenses/LICENSE-2.0
+..
+.. Unless required by applicable law or agreed to in writing, software
+.. distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+.. WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+.. License for the specific language governing permissions and limitations under
+.. the License.
+
+
+.. _release/1.2.x:
+
+1.2.x Branch
+============
+
+.. contents::
+ :depth: 1
+ :local:
+
+
+Upgrade Notes
+-------------
+
+.. warning::
+
+ This version drops support for the database format that was introduced in
+ version 0.9.0. Compact your older databases (that have not been compacted
+ for a long time) before upgrading, or they will become inaccessible.
+
+Security changes
+^^^^^^^^^^^^^^^^
+
+The interface to the ``_users`` and ``_replicator`` databases have been
+changed so that non-administrator users can see less information:
+
+* In the ``_users`` database:
+
+ * User documents can now only be read by the respective users, as well as
+ administrators. Other users cannot read these documents.
+ * Views can only be defined and queried by administrator users.
+ * The ``_changes`` feed can only be queried by administrator users.
+
+* In the ``_replicator`` database:
+
+ * Documents now have a forced ``owner`` field that corresponds to the
+ authenticated user that created them.
+ * Non-owner users will not see confidential information like passwords or
+ OAuth tokens in replication documents; they can still see the other
+ contents of those documents. Administrators can see everything.
+ * Views can only be defined and queried by administrators.
+
+Database Compression
+^^^^^^^^^^^^^^^^^^^^
+
+The new optional (but enabled by default) compression of disk files requires
+an upgrade of the on-disk format (5 -> 6) which occurs on creation for new
+databases and views, and on compaction for existing files. This format is not
+supported in previous releases, so rollback would require replication to the
+previous CouchDB release or restoring from backup.
+
+Compression can be disabled by setting ``compression = none`` in your
+``local.ini`` ``[couchdb]`` section, but the on-disk format will still be
+upgraded.
+
+
+.. _release/1.2.2:
+
+Version 1.2.2
+-------------
+
+Build System
+^^^^^^^^^^^^
+
+* Fixed issue in `couchdb` script where stopped status returns before process
+ exits.
+
+HTTP Interface
+^^^^^^^^^^^^^^
+
+* Reset rewrite counter on new request, avoiding unnecessary request failures
+ due to bogus rewrite limit reports.
+
+
+.. _release/1.2.1:
+
+Version 1.2.1
+-------------
+
+Build System
+^^^^^^^^^^^^
+
+* Fix couchdb start script.
+* Win: fix linker invocations.
+
+Futon
+^^^^^
+
+* Disable buttons that aren't available for the logged-in user.
+
+HTTP Interface
+^^^^^^^^^^^^^^
+
+* No longer rewrites the ``X-CouchDB-Requested-Path`` during recursive
+ calls to the rewriter.
+* Limit recursion depth in the URL rewriter. Defaults to a maximum
+ of 100 invocations but is configurable.
+
+Security
+^^^^^^^^
+
+* Fixed CVE-2012-5641: Apache CouchDB Information disclosure via unescaped
+ backslashes in URLs on Windows
+* Fixed CVE-2012-5649: Apache CouchDB JSONP arbitrary code execution with Adobe
+ Flash
+* Fixed CVE-2012-5650: Apache CouchDB DOM based Cross-Site Scripting via Futon
+ UI
+
+Replication
+^^^^^^^^^^^
+
+* Fix potential timeouts.
+
+View Server
+^^^^^^^^^^^
+
+* Change use of signals to avoid broken view groups.
+
+
+.. _release/1.2.0:
+
+Version 1.2.0
+-------------
+
+Authentication
+^^^^^^^^^^^^^^
+
+* Fix use of OAuth with VHosts and URL rewriting.
+* OAuth secrets can now be stored in the users system database
+ as an alternative to key value pairs in the .ini configuration.
+ By default this is disabled (secrets are stored in the .ini)
+ but can be enabled via the .ini configuration key `use_users_db`
+ in the `couch_httpd_oauth` section.
+* Documents in the _users database are no longer publicly
+ readable.
+* Confidential information in the _replication database is no
+ longer publicly readable.
+* Password hashes are now calculated by CouchDB. Clients are no
+ longer required to do this manually.
+* Cookies used for authentication can be made persistent by enabling
+ the .ini configuration key `allow_persistent_cookies` in the
+ `couch_httpd_auth` section.
+
+Build System
+^^^^^^^^^^^^
+
+* cURL is no longer required to build CouchDB as it is only
+ used by the command line JS test runner. If cURL is available
+ when building CouchJS you can enable the HTTP bindings by
+ passing -H on the command line.
+* Temporarily made `make check` pass with R15B. A more thorough
+ fix is in the works (:issue:`1424`).
+* Fixed --with-js-include and --with-js-lib options.
+* Added --with-js-lib-name option.
+
+Futon
+^^^^^
+
+* The `Status` screen (active tasks) now displays two new task status
+ fields: `Started on` and `Updated on`.
+* Futon remembers view code every time it is saved, allowing to save an
+ edit that amounts to a revert.
+
+HTTP Interface
+^^^^^^^^^^^^^^
+
+* Added a native JSON parser.
+* The _active_tasks API now offers more granular fields. Each
+ task type is now able to expose different properties.
+* Added built-in changes feed filter `_view`.
+* Fixes to the `_changes` feed heartbeat option which caused
+ heartbeats to be missed when used with a filter. This caused
+ timeouts of continuous pull replications with a filter.
+* Properly restart the SSL socket on configuration changes.
+
+OAuth
+^^^^^
+
+* Updated bundled `erlang_oauth` library to the latest version.
+
+Replicator
+^^^^^^^^^^
+
+* A new replicator implementation. It offers more performance and
+ configuration options.
+* Passing non-string values to query_params is now a 400 bad
+ request. This is to reduce the surprise that all parameters
+ are converted to strings internally.
+* Added optional field `since_seq` to replication objects/documents.
+ It allows to bootstrap a replication from a specific source sequence
+ number.
+* Simpler replication cancellation. In addition to the current method,
+ replications can now be canceled by specifying the replication ID
+ instead of the original replication object/document.
+
+Storage System
+^^^^^^^^^^^^^^
+
+* Added optional database and view index file compression (using Google's
+ snappy or zlib's deflate). This feature is enabled by default, but it
+ can be disabled by adapting local.ini accordingly. The on-disk format
+ is upgraded on compaction and new DB/view creation to support this.
+* Several performance improvements, most notably regarding database writes
+ and view indexing.
+* Computation of the size of the latest MVCC snapshot data and all its
+ supporting metadata, both for database and view index files. This
+ information is exposed as the `data_size` attribute in the database and
+ view group information URIs.
+* The size of the buffers used for database and view compaction is now
+ configurable.
+* Added support for automatic database and view compaction. This feature
+ is disabled by default, but it can be enabled via the .ini configuration.
+* Performance improvements for the built-in changes feed filters `_doc_ids`
+ and `_design`.
+
+View Server
+^^^^^^^^^^^
+
+* Add CoffeeScript (http://coffeescript.org/) as a first class view server
+ language.
+* Fixed old index file descriptor leaks after a view cleanup.
+* The requested_path property keeps the pre-rewrite path even when no VHost
+ configuration is matched.
+* Fixed incorrect reduce query results when using pagination parameters.
+* Made icu_driver work with Erlang R15B and later.
+
+
http://git-wip-us.apache.org/repos/asf/couchdb/blob/4c0241d1/share/doc/src/whatsnew/1.3.rst
----------------------------------------------------------------------
diff --git a/share/doc/src/whatsnew/1.3.rst b/share/doc/src/whatsnew/1.3.rst
new file mode 100644
index 0000000..3ef847c
--- /dev/null
+++ b/share/doc/src/whatsnew/1.3.rst
@@ -0,0 +1,252 @@
+.. Licensed under the Apache License, Version 2.0 (the "License"); you may not
+.. use this file except in compliance with the License. You may obtain a copy of
+.. the License at
+..
+.. http://www.apache.org/licenses/LICENSE-2.0
+..
+.. Unless required by applicable law or agreed to in writing, software
+.. distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+.. WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+.. License for the specific language governing permissions and limitations under
+.. the License.
+
+
+.. _release/1.3.x:
+
+1.3.x Branch
+============
+
+.. contents::
+ :depth: 1
+ :local:
+
+
+Upgrade Notes
+-------------
+
+You can upgrade your existing CouchDB 1.0.x installation to 1.3.0
+without any specific steps or migration. When you run CouchDB, the
+existing data and index files will be opened and used as normal.
+
+The first time you run a compaction routine on your database within 1.3.0,
+the data structure and indexes will be updated to the new version of the
+CouchDB database format that can only be read by CouchDB 1.3.0 and later.
+This step is not reversible. Once the data files have been updated and
+migrated to the new version the data files will no longer work with a
+CouchDB 1.0.x release.
+
+.. warning::
+ If you want to retain support for opening the data files in
+ CouchDB 1.0.x you must back up your data files before performing the
+ upgrade and compaction process.
+
+
+.. _release/1.3.1:
+
+Version 1.3.1
+-------------
+
+Replicator
+^^^^^^^^^^
+
+* :issue:`1788`: Tolerate missing source and target fields in _replicator docs.
+ :commit:`869f42e2`
+
+Log System
+^^^^^^^^^^
+
+* Don't log about missing .compact files. :commit:`06f1a8dc`
+* :issue:`1794`: Fix bug in WARN level logging from 1.3.0.
+
+View Server
+^^^^^^^^^^^
+
+* :issue:`1792`: Fix the -S option to couchjs to increase memory limits.
+ :commit:`cfaa66cd`
+
+Miscellaneous
+^^^^^^^^^^^^^
+
+* Improve documentation: better structure, improve language, less duplication.
+* :issue:`1784`: Improvements to test suite and VPATH build system.
+ :commit:`01afaa4f`
+
+
+.. _release/1.3.0:
+
+Version 1.3.0
+-------------
+
+Database core
+^^^^^^^^^^^^^
+
+* :issue:`1512`: Validate bind address before assignment. :commit:`09ead8a0`
+* Restore ``max_document_size`` protection. :commit:`bf1eb135`
+
+Documentation
+^^^^^^^^^^^^^
+
+* :issue:`1523`: Import CouchBase documentation and convert them into
+ `Sphinx docs <http://sphinx.pocoo.org/>`_
+
+Futon
+^^^^^
+
+* :issue:`1470`: Futon raises popup on attempt to navigate to missed/deleted
+ document. :commit:`5da40eef`
+* :issue:`1383`: Futon view editor won't allow you to save original view after
+ saving a revision. :commit:`ce48342`
+* :issue:`627`: Support all timezones. :commit:`b1a049bb`
+* :issue:`509`: Added view request duration to Futon. :commit:`2d2c7d1e`
+* :issue:`1473`, :issue:`1472`: Disable buttons for actions that the user
+ doesn't have permissions to. :commit:`7156254d`
+
+HTTP Interface
+^^^^^^^^^^^^^^
+
+* :issue:`431`: Introduce experimental :ref:`CORS support <cors>`.
+ :commit:`b90e4021`
+* :issue:`1537`: Include user name in show/list `ETags`. :commit:`ac320479`
+* :issue:`1511`: CouchDB checks `roles` field for `_users` database documents
+ with more care. :commit:`41205000`
+* :issue:`1502`: Allow users to delete own _users doc. :commit:`f0d6f19bc8`
+* :issue:`1501`: :ref:`Changes feed <changes>` now can take special parameter
+ ``since=now`` to emit changes since current point of time. :commit:`3bbb2612`
+* :issue:`1442`: No longer rewrites the `X-CouchDB-Requested-Path` during
+ recursive calls to the rewriter. :commit:`56744f2f`
+* :issue:`1441`: Limit recursion depth in the URL rewriter.
+ Defaults to a maximum of 100 invocations but is configurable.
+ :commit:`d076976c`
+* :issue:`1381`: Add jquery.couch support for Windows 8 Metro apps.
+ :commit:`dfc5d37c`
+* :issue:`1337`: Use MD5 for attachment ETag header value. :commit:`6d912c9f`
+* :issue:`1321`: Variables in rewrite rules breaks OAuth authentication.
+ :commit:`c307ba95`
+* :issue:`1285`: Allow configuration of vendor and modules version in CouchDB
+ welcome message. :commit:`3c24a94d`
+* :issue:`1277`: Better query parameter support and code clarity:
+ :commit:`7e3c69ba`
+
+ * Responses to documents created/modified via form data `POST` to /db/doc or
+ copied with `COPY` should now include `Location` header.
+ * Form data POST to /db/doc now includes an `ETag` response header.
+ * ``?batch=ok`` is now supported for `COPY` and `POST` /db/doc updates.
+ * ``?new_edits=false`` is now supported for more operations.
+
+* :issue:`1210`: Files starting with underscore can be attached and updated now.
+ :commit:`05858792`
+* :issue:`1097`: Allow `OPTIONS` request to shows and lists functions.
+ :commit:`9f53704a`
+* :issue:`1026`: Database names are encoded with respect of special characters
+ in the rewriter now. :commit:`272d6415`
+* :issue:`986`: Added Server-Sent Events protocol to db changes API.
+ See http://www.w3.org/TR/eventsource/ for details. :commit:`093d2aa6`
+* :issue:`887`: Fix ``bytes`` and ``offset`` parameters semantic for `_log`
+ resource (`explanation <https://git-wip-us.apache.org/repos/asf?p=couchdb.git;a=blobdiff;f=src/couchdb/couch_log.erl;h=1b05f4db2;hp=0befe7aab;hb=ad700014;hpb=7809f3ca>`_)
+ :commit:`ad700014`
+* :issue:`764`, :issue:`514`, :issue:`430`: Fix sending HTTP headers from
+ ``_list`` function, :commit:`2a74f88375`
+* Send a 202 response for `_restart`. :commit:`b213e16f`
+* Make password hashing synchronous when using the /_config/admins API.
+ :commit:`08071a80`
+* Fix `_session` for IE7.
+* Return ``X-Couch-Id`` header if doc is created, :commit:`98515bf0b9`
+* Allow any 2xx code to indicate success, :commit:`0d50103cfd`
+* Restore 400 error for empty PUT, :commit:`2057b895`
+* Add support to serve single file with CouchDB, :commit:`2774531ff2`
+* Support auth cookies with ``:`` characters, :commit:`d9566c831d`
+
+Log System
+^^^^^^^^^^
+
+* :issue:`1380`: Minor fixes for logrotate support.
+* Improve file I/O error logging and handling, :commit:`4b6475da`
+* Module Level Logging, :commit:`b58f069167`
+* Log 5xx responses at error level, :commit:`e896b0b7`
+* Log problems opening database at ERROR level except for auto-created
+ system dbs, :commit:`41667642f7`
+
+Replicator
+^^^^^^^^^^
+
+* :issue:`1557`: Upgrade some code to use BIFs bring good improvements for
+ replication.
+* :issue:`1363`: Fix rarely occurred, but still race condition in changes feed
+ if a quick burst of changes happens while replication is starting the
+ replication can go stale. :commit:`573a7bb9`
+* :issue:`1323`: Replicator now acts as standalone application.
+ :commit:`f913ca6e`
+* :issue:`1259`: Stabilize replication id, :commit:`c6252d6d7f`
+* :issue:`1248`: `HTTP 500` error now doesn't occurs when replicating with
+ ``?doc_ids=null``. :commit:`bea76dbf`
+
+Security
+^^^^^^^^
+
+* :issue:`1060`: Passwords are now hashed using the PBKDF2 algorithm with a
+ configurable work factor. :commit:`7d418134`
+
+Source Repository
+^^^^^^^^^^^^^^^^^
+
+* The source repository was migrated from `SVN`_ to `Git`_.
+
+.. _SVN: https://svn.apache.org/repos/asf/couchdb
+.. _Git: https://git-wip-us.apache.org/repos/asf/couchdb.git
+
+Storage System
+^^^^^^^^^^^^^^
+
+* Fixed unnecessary conflict when deleting and creating a
+ document in the same batch.
+
+Test Suite
+^^^^^^^^^^
+
+* :issue:`1563`: Ensures urlPrefix is set in all ajax requests.
+ :commit:`07a6af222`
+* :issue:`1389`: Improved tracebacks printed by the JS CLI tests.
+* :issue:`1339`: Use shell trap to catch dying beam processes during test runs.
+ :commit:`2921c78`
+* :issue:`1338`: Start CouchDB with ``port=0``. While CouchDB might be already
+ running on the default port 5984, port number 0 let the TCP stack figure out a
+ free port to run. :commit:`127cbe3`
+* :issue:`1321`: Moved the JS test suite to the CLI.
+* Improved the reliability of a number of tests.
+* Fix race condition for test running on faster hardware.
+
+URL Rewriter & Vhosts
+^^^^^^^^^^^^^^^^^^^^^
+
+* :issue:`1026`: Database name is encoded during rewriting
+ (allowing embedded /'s, etc). :commit:`272d6415`
+
+UUID Algorithms
+^^^^^^^^^^^^^^^
+
+* :issue:`1373`: Added the utc_id algorithm :commit:`5ab712a2`
+
+Query and View Server
+^^^^^^^^^^^^^^^^^^^^^
+
+* :issue:`1491`: Clenaup view tables. :commit:`c37204b7`
+* :issue:`1483`: Update handlers requires valid doc ids. :commit:`72ea7e38`
+* :issue:`1445`: CouchDB tries no more to delete view file if it couldn't open
+ it, even if the error is `emfile`.
+* :issue:`1444`: Fix missed_named_view error that occurs on existed design
+ documents and views. :commit:`b59ac98b`
+* :issue:`1372`: `_stats` builtin reduce function no longer produces error for
+ empty view result.
+* :issue:`410`: More graceful error handling for JavaScript validate_doc_update
+ functions.
+* :issue:`111`: Improve the errors reported by the javascript view server
+ to provide a more friendly error report when something goes wrong.
+ :commit:`0c619ed`
+* Deprecate E4X support, :commit:`cdfdda2314`
+
+Windows
+^^^^^^^
+
+* :issue:`1482`: Use correct linker flang to build `snappy_nif.dll` on Windows.
+ :commit:`a6eaf9f1`
+* Allows building cleanly on Windows without cURL, :commit:`fb670f5712`
http://git-wip-us.apache.org/repos/asf/couchdb/blob/4c0241d1/share/doc/src/whatsnew/1.4.rst
----------------------------------------------------------------------
diff --git a/share/doc/src/whatsnew/1.4.rst b/share/doc/src/whatsnew/1.4.rst
new file mode 100644
index 0000000..7c7d29b
--- /dev/null
+++ b/share/doc/src/whatsnew/1.4.rst
@@ -0,0 +1,58 @@
+.. Licensed under the Apache License, Version 2.0 (the "License"); you may not
+.. use this file except in compliance with the License. You may obtain a copy of
+.. the License at
+..
+.. http://www.apache.org/licenses/LICENSE-2.0
+..
+.. Unless required by applicable law or agreed to in writing, software
+.. distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+.. WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+.. License for the specific language governing permissions and limitations under
+.. the License.
+
+
+.. _release/1.4.x:
+
+1.4.x Branch
+============
+
+.. contents::
+ :depth: 1
+ :local:
+
+
+Upgrade Notes
+-------------
+
+We now support Erlang/OTP R16B and R16B01; the minimum required version is R14B.
+
+User document role values must now be strings. Other types of values will be
+refused when saving the user document.
+
+
+.. _release/1.4.0:
+
+Version 1.4.0
+-------------
+
+* :issue:`1139`: it's possible to apply :ref:`list <listfun>`
+ functions to ``_all_docs`` view. :commit:`54fd258e`
+* :issue:`1632`: Ignore epilogues in ``multipart/related`` MIME attachments.
+ :commit:`2b4ab67a`
+* :issue:`1634`: Reduce PBKDF2 work factor. :commit:`f726bc4d`
+* :issue:`1684`: Support for server-wide changes feed reporting on creation,
+ updates and deletion of databases. :commit:`917d8988`
+* :issue:`1772`: Prevent invalid JSON output when using `all_or_nothing`
+ :ref:`of bulk API <api/db/bulk_docs>`. :commit:`dfd39d57`
+* Add a :ref:`configurable whitelist <config/couch_httpd_auth/public_fields>`
+ of user document properties. :commit:`8d7ab8b1`
+* :issue:`1852`: Support Last-Event-ID header in EventSource changes feeds.
+ :commit:`dfd2199a`
+* Allow storing pre-hashed admin passwords via :ref:`config API <api/config>`.
+ :commit:`c98ba561`
+* Automatic loading of CouchDB plugins. :commit:`3fab6bb5`
+* Much improved documentation, including an :ref:`expanded description
+ <vdufun>` of `validate_doc_update` functions (commit:`ef9ac469`) and
+ a description of how CouchDB handles JSON :ref:`number values
+ <json/numbers>` (:commit:`bbd93f77`).
+* Split up `replicator_db` tests into multiple independent tests.
http://git-wip-us.apache.org/repos/asf/couchdb/blob/4c0241d1/share/doc/src/whatsnew/index.rst
----------------------------------------------------------------------
diff --git a/share/doc/src/whatsnew/index.rst b/share/doc/src/whatsnew/index.rst
new file mode 100644
index 0000000..b5a1f91
--- /dev/null
+++ b/share/doc/src/whatsnew/index.rst
@@ -0,0 +1,30 @@
+.. Licensed under the Apache License, Version 2.0 (the "License"); you may not
+.. use this file except in compliance with the License. You may obtain a copy of
+.. the License at
+..
+.. http://www.apache.org/licenses/LICENSE-2.0
+..
+.. Unless required by applicable law or agreed to in writing, software
+.. distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+.. WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+.. License for the specific language governing permissions and limitations under
+.. the License.
+
+
+.. _releases:
+
+Release History
+===============
+
+.. toctree::
+ :glob:
+
+ 1.4
+ 1.3
+ 1.2
+ 1.1
+ 1.0
+ 0.11
+ 0.10
+ 0.9
+ 0.8