[1/9] git commit: updated refs/heads/1781-reorganize-and-improve-docs to f2a0c93

[kx...@apache.org]

Updated Branches:
  refs/heads/1781-reorganize-and-improve-docs 32b4efcca -> f2a0c9369


Add Windows installation instructions for binary distrib.


Project: http://git-wip-us.apache.org/repos/asf/couchdb/repo
Commit: http://git-wip-us.apache.org/repos/asf/couchdb/commit/28e23fdf
Tree: http://git-wip-us.apache.org/repos/asf/couchdb/tree/28e23fdf
Diff: http://git-wip-us.apache.org/repos/asf/couchdb/diff/28e23fdf

Branch: refs/heads/1781-reorganize-and-improve-docs
Commit: 28e23fdf136b4a0ff4aba81d47e4368a0b85fa8a
Parents: 32b4efc
Author: Alexander Shorin <kx...@apache.org>
Authored: Sun Aug 4 14:00:54 2013 +0400
Committer: Alexander Shorin <kx...@apache.org>
Committed: Sun Aug 4 14:00:54 2013 +0400

----------------------------------------------------------------------
 share/doc/src/install/windows.rst | 53 +++++++++++++++++++++++++++++++++-
 1 file changed, 52 insertions(+), 1 deletion(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/couchdb/blob/28e23fdf/share/doc/src/install/windows.rst
----------------------------------------------------------------------
diff --git a/share/doc/src/install/windows.rst b/share/doc/src/install/windows.rst
index eb46c6e..79bbb87 100644
--- a/share/doc/src/install/windows.rst
+++ b/share/doc/src/install/windows.rst
@@ -17,7 +17,58 @@
 Installation on Windows
 =======================
 
-For a high-level guide to Microsoft Windows.
+There are two ways to install CouchDB on Windows.
+
+Installation from binaries
+==========================
+
+This is the most simplest way to go.
+
+#. Get `the latest Windows binaries`_ from `CouchDB web site`_.
+   Old releases are available at `archive`_.
+
+#. Follow the installation wizard steps:
+
+   - Next on "Welcome" screen
+   - Accept the License agreement
+   - Select the installation directory
+   - Specify "Start Menu" group name
+   - Approve that you'd like to install CouchDB as service and let him been
+     started automatically after installation (probably, you'd like so)
+   - Verify installation settings
+   - Install CouchDB
+
+#. `Open up Futon`_ (if you hadn't selected autostart CouchDB after
+   installation, you have to start it first manually)
+
+#. It's time to Relax!
+
+.. note::
+   In some cases you might been asked to reboot Windows to complete
+   installation process, because of using on different Microsoft Visual C++
+   runtimes by CouchDB.
+
+.. note:: **Upgrading note**
+
+   It's very recommended to uninstall previous CouchDB version before upgrading,
+   especially if the new one is built against different Erlang release.
+   The reason is simple: there may left a some of libraries with alternative or
+   incompatible versions from old Erlang release that may create conflicts,
+   errors and weird crushes.
+
+   In this case, make sure you'd backup of your `local.ini` config and CouchDB
+   database/index files.
+
+.. _Open up Futon: http://localhost:5984/_utils
+.. _CouchDB web site: http://couchdb.org/
+.. _archive: http://archive.apache.org/dist/couchdb/binary/win/
+.. _the latest Windows binaries: http://couchdb.org/#download
+
+
+Installation from sources
+=========================
+
+If you're Windows geek, this section is for you!
 
 Troubleshooting
 ---------------

[3/9] git commit: updated refs/heads/1781-reorganize-and-improve-docs to f2a0c93

[kx...@apache.org]

Add auth API references for config. Small cleanup.


Project: http://git-wip-us.apache.org/repos/asf/couchdb/repo
Commit: http://git-wip-us.apache.org/repos/asf/couchdb/commit/dbd7643d
Tree: http://git-wip-us.apache.org/repos/asf/couchdb/tree/dbd7643d
Diff: http://git-wip-us.apache.org/repos/asf/couchdb/diff/dbd7643d

Branch: refs/heads/1781-reorganize-and-improve-docs
Commit: dbd7643decef9dbaa08233a78c8d6527505192b4
Parents: d8d0805
Author: Alexander Shorin <kx...@apache.org>
Authored: Fri Aug 9 00:17:36 2013 +0400
Committer: Alexander Shorin <kx...@apache.org>
Committed: Fri Aug 9 00:17:36 2013 +0400

----------------------------------------------------------------------
 share/doc/src/config/auth.rst | 21 +++++++++++----------
 1 file changed, 11 insertions(+), 10 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/couchdb/blob/dbd7643d/share/doc/src/config/auth.rst
----------------------------------------------------------------------
diff --git a/share/doc/src/config/auth.rst b/share/doc/src/config/auth.rst
index 16c2012..e2229cf 100644
--- a/share/doc/src/config/auth.rst
+++ b/share/doc/src/config/auth.rst
@@ -173,7 +173,7 @@ that requires authentication::
 ---------------------------------------------------------
 
 When this option ``true`` the :ref:`secret <config/couch_httpd_auth/secret>` is
-required for `Proxy Auth`::
+required for :ref:`api/auth/proxy`::
 
   [couch_httpd_auth]
   proxy_use_secret = false
@@ -221,7 +221,7 @@ should be authenticated::
 ``secret`` :: Proxy Auth secret token
 -------------------------------------
 
-The secret token used for `Proxy Auth` authentication method::
+The secret token used for :ref:`api/auth/proxy` method::
 
   [couch_httpd_auth]
   secret = 92de07df7e7a3fe14808cef90a7cc0d91
@@ -259,7 +259,7 @@ all users documents while users may browse only their own document::
 -------------------------------------------
 
 HTTP header name (``X-Auth-CouchDB-Roles`` by default) that contains the list of
-user's roles separated by a comma. Used for `Proxy Auth`::
+user's roles separated by a comma. Used for :ref:`api/auth/proxy`::
 
   [couch_httpd_auth]
   x_auth_roles = X-Auth-CouchDB-Roles
@@ -276,7 +276,7 @@ authenticate the authorization. This token is an `HMAC-SHA1` created from
 :ref:`username <config/couch_httpd_auth/x_auth_username>`. The secret key
 should be the same in the client and CouchDB node. This token is optional
 if value of :ref:`proxy_use_secret <config/couch_httpd_auth/proxy_use_secret>`
-option isn't ``true``. Used for `Proxy Auth`::
+option isn't ``true``. Used for :ref:`api/auth/proxy`::
 
   [couch_httpd_auth]
   x_auth_roles = X-Auth-CouchDB-Token
@@ -288,7 +288,7 @@ option isn't ``true``. Used for `Proxy Auth`::
 -------------------------------------------------
 
 HTTP header name (``X-Auth-CouchDB-UserName`` by default) containing the
-username. Used for `Proxy Auth`::
+username. Used for :ref:`api/auth/proxy`::
 
   [couch_httpd_auth]
   x_auth_username = X-Auth-CouchDB-UserName
@@ -307,8 +307,9 @@ username. Used for `Proxy Auth`::
 Store credentials within config
 -------------------------------
 
-To let users be authenticated by `OAuth` (:rfc:`5849`) method there is need to
-setup three special sections in :ref:`configuration <config>` file:
+To let users be authenticated by :ref:`api/auth/oauth` (:rfc:`5849`) method
+there is need to setup three special sections in :ref:`configuration <config>`
+file:
 
 1. Consumer secret:
 
@@ -338,10 +339,10 @@ setup three special sections in :ref:`configuration <config>` file:
 Store OAuth credentials within auth database
 --------------------------------------------
 
-.. versionadded:: 1.2: CouchDB is able to store OAuth credentials within users
-   documents instead of config file.
+.. versionadded:: 1.2
 
-::
+CouchDB is able to store OAuth credentials within users documents instead of
+config file by using next option::
 
   [couch_httpd_oauth]
   use_users_db = true

[6/9] git commit: updated refs/heads/1781-reorganize-and-improve-docs to f2a0c93

[kx...@apache.org]

Split changelog.rst into group of per release branch articles.

Easy to track. Easy to support. Easy to autogenerate.
Changes are synced with 1.4.x branch.
Added 1.2.1 and 1.2.2 changes.


Project: http://git-wip-us.apache.org/repos/asf/couchdb/repo
Commit: http://git-wip-us.apache.org/repos/asf/couchdb/commit/4c0241d1
Tree: http://git-wip-us.apache.org/repos/asf/couchdb/tree/4c0241d1
Diff: http://git-wip-us.apache.org/repos/asf/couchdb/diff/4c0241d1

Branch: refs/heads/1781-reorganize-and-improve-docs
Commit: 4c0241d174e3c7245f5f205fc79253a5a6664d34
Parents: 40e6eff
Author: Alexander Shorin <kx...@apache.org>
Authored: Fri Aug 9 02:50:03 2013 +0400
Committer: Alexander Shorin <kx...@apache.org>
Committed: Fri Aug 9 02:50:03 2013 +0400

----------------------------------------------------------------------
 share/doc/build/Makefile.am      |   33 +-
 share/doc/src/api/basics.rst     |    3 +
 share/doc/src/changelog.rst      | 1336 ---------------------------------
 share/doc/src/config/auth.rst    |    2 +-
 share/doc/src/index.rst          |    2 +-
 share/doc/src/whatsnew/0.10.rst  |   98 +++
 share/doc/src/whatsnew/0.11.rst  |  256 +++++++
 share/doc/src/whatsnew/0.8.rst   |  177 +++++
 share/doc/src/whatsnew/0.9.rst   |  190 +++++
 share/doc/src/whatsnew/1.0.rst   |  252 +++++++
 share/doc/src/whatsnew/1.1.rst   |  166 ++++
 share/doc/src/whatsnew/1.2.rst   |  239 ++++++
 share/doc/src/whatsnew/1.3.rst   |  252 +++++++
 share/doc/src/whatsnew/1.4.rst   |   58 ++
 share/doc/src/whatsnew/index.rst |   30 +
 15 files changed, 1753 insertions(+), 1341 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/couchdb/blob/4c0241d1/share/doc/build/Makefile.am
----------------------------------------------------------------------
diff --git a/share/doc/build/Makefile.am b/share/doc/build/Makefile.am
index 75e9ddb..ccbd9bd 100644
--- a/share/doc/build/Makefile.am
+++ b/share/doc/build/Makefile.am
@@ -111,7 +111,16 @@ html_files = \
     html/_sources/replication/intro.txt \
     html/_sources/replication/protocol.txt \
     html/_sources/replication/replicator.txt \
-    html/_sources/changelog.txt \
+    html/_sources/whatsnew/0.8.txt \
+    html/_sources/whatsnew/0.9.txt \
+    html/_sources/whatsnew/0.10.txt \
+    html/_sources/whatsnew/0.11.txt \
+    html/_sources/whatsnew/1.0.txt \
+    html/_sources/whatsnew/1.1.txt \
+    html/_sources/whatsnew/1.2.txt \
+    html/_sources/whatsnew/1.3.txt \
+    html/_sources/whatsnew/1.4.txt \
+    html/_sources/whatsnew/index.txt \
     html/_sources/contributing.txt \
     html/_sources/externals.txt \
     html/_sources/index.txt \
@@ -202,7 +211,16 @@ html_files = \
     html/replication/intro.html \
     html/replication/protocol.html \
     html/replication/replicator.html \
-    html/changelog.html \
+    html/whatsnew/0.8.html \
+    html/whatsnew/0.9.html \
+    html/whatsnew/0.10.html \
+    html/whatsnew/0.11.html \
+    html/whatsnew/1.0.html \
+    html/whatsnew/1.1.html \
+    html/whatsnew/1.2.html \
+    html/whatsnew/1.3.html \
+    html/whatsnew/1.4.html \
+    html/whatsnew/index.html \
     html/externals.html \
     html/index.html \
     html/intro.html \
@@ -291,7 +309,16 @@ src_files = \
     ../src/replication/intro.rst \
     ../src/replication/protocol.rst \
     ../src/replication/replicator.rst \
-    ../src/changelog.rst \
+    ../src/whatsnew/0.8.rst \
+    ../src/whatsnew/0.9.rst \
+    ../src/whatsnew/0.10.rst \
+    ../src/whatsnew/0.11.rst \
+    ../src/whatsnew/1.0.rst \
+    ../src/whatsnew/1.1.rst \
+    ../src/whatsnew/1.2.rst \
+    ../src/whatsnew/1.3.rst \
+    ../src/whatsnew/1.4.rst \
+    ../src/whatsnew/index.rst \
     ../src/contributing.rst \
     ../src/externals.rst \
     ../src/index.rst \

http://git-wip-us.apache.org/repos/asf/couchdb/blob/4c0241d1/share/doc/src/api/basics.rst
----------------------------------------------------------------------
diff --git a/share/doc/src/api/basics.rst b/share/doc/src/api/basics.rst
index a1b1b82..dbd486a 100644
--- a/share/doc/src/api/basics.rst
+++ b/share/doc/src/api/basics.rst
@@ -301,6 +301,9 @@ languages, including Perl, Python, Ruby, Erlang and others.
    valid, invalid structures will cause CouchDB to return an HTTP status code
    of 500 (server error).
 
+
+.. _json/numbers:
+
 Number Handling
 ---------------
 

http://git-wip-us.apache.org/repos/asf/couchdb/blob/4c0241d1/share/doc/src/changelog.rst
----------------------------------------------------------------------
diff --git a/share/doc/src/changelog.rst b/share/doc/src/changelog.rst
deleted file mode 100644
index de61621..0000000
--- a/share/doc/src/changelog.rst
+++ /dev/null
@@ -1,1336 +0,0 @@
-.. 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 History
-***************
-
-.. contents::
-   :depth: 1
-   :local:
-
-1.4.x Branch
-============
-
-.. contents::
-   :depth: 1
-   :local:
-
-Upgrade Notes
--------------
-
-We now support Erlang/OTP R16; the minimum required version is R14B.
-
-Version 1.4.0
--------------
-
-* Bumped Mochiweb dependency to 2.4.2.
-* Disabled link to the Futon test suite.
-* Split up replicator_db tests into multiple independent tests.
-
-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.
-
-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`
-
-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`
-
-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.
-
-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.
-
-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.
-
-OAuth
-^^^^^
-
-* Updated bundled erlang_oauth library to the latest version.
-
-1.1.x Branch
-============
-
-.. contents::
-   :depth: 1
-   :local:
-
-Version 1.1.1
--------------
-
-* Support SpiderMonkey 1.8.5
-* Add configurable maximum to the number of bytes returned by _log.
-* Allow CommonJS modules to be an empty string.
-* Bump minimum Erlang version to R13B02.
-* Do not run deleted validate_doc_update functions.
-* ETags for views include current sequence if include_docs=true.
-* Fix bug where duplicates can appear in _changes feed.
-* Fix bug where update handlers break after conflict resolution.
-* Fix bug with _replicator where include "filter" could crash couch.
-* Fix crashes when compacting large views.
-* Fix file descriptor leak in _log
-* Fix missing revisions in _changes?style=all_docs.
-* Improve handling of compaction at max_dbs_open limit.
-* JSONP responses now send "text/javascript" for Content-Type.
-* Link to ICU 4.2 on Windows.
-* Permit forward slashes in path to update functions.
-* Reap couchjs processes that hit reduce_overflow error.
-* Status code can be specified in update handlers.
-* Support provides() in show functions.
-* _view_cleanup when ddoc has no views now removes all index files.
-* max_replication_retry_count now supports "infinity".
-* Fix replication crash when source database has a document with empty ID.
-* Fix deadlock when assigning couchjs processes to serve requests.
-* Fixes to the document multipart PUT API.
-* Fixes regarding file descriptor leaks for databases with views.
-
-
-Version 1.1.0
--------------
-
-.. note:: All CHANGES for 1.0.2 and 1.0.3 also apply to 1.1.0.
-
-Externals
-^^^^^^^^^
-
-* Added OS Process module to manage daemons outside of CouchDB.
-* Added HTTP Proxy handler for more scalable externals.
-
-Futon
-^^^^^
-
-* Added a "change password"-feature to Futon.
-
-HTTP Interface
-^^^^^^^^^^^^^^
-
-* Native SSL support.
-* Added support for HTTP range requests for attachments.
-* Added built-in filters for `_changes`: `_doc_ids` and `_design`.
-* Added configuration option for TCP_NODELAY aka "Nagle".
-* Allow POSTing arguments to `_changes`.
-* Allow `keys` parameter for GET requests to views.
-* Allow wildcards in vhosts definitions.
-* More granular ETag support for views.
-* More flexible URL rewriter.
-* Added support for recognizing "Q values" and media parameters in
-  HTTP Accept headers.
-* Validate doc ids that come from a PUT to a URL.
-
-Replicator
-^^^^^^^^^^
-
-* Added `_replicator` database to manage replications.
-* Fixed issues when an endpoint is a remote database accessible via SSL.
-* Added support for continuous by-doc-IDs replication.
-* Fix issue where revision info was omitted when replicating attachments.
-* Integrity of attachment replication is now verified by MD5.
-
-Storage System
-^^^^^^^^^^^^^^
-
-* Multiple micro-optimizations when reading data.
-
-URL Rewriter & Vhosts
-^^^^^^^^^^^^^^^^^^^^^
-
-* Fix for variable substituion
-
-View Server
-^^^^^^^^^^^
-
-* Added CommonJS support to map functions.
-* Added `stale=update_after` query option that triggers a view update after
-  returning a `stale=ok` response.
-* Warn about empty result caused by `startkey` and `endkey` limiting.
-* Built-in reduce function `_sum` now accepts lists of integers as input.
-* Added view query aliases start_key, end_key, start_key_doc_id and
-  end_key_doc_id.
-
-1.0.x Branch
-============
-
-.. contents::
-   :depth: 1
-   :local:
-
-Version 1.0.3
--------------
-
-General
-^^^^^^^
-
-* Fixed compatibility issues with Erlang R14B02.
-
-Etap Test Suite
-^^^^^^^^^^^^^^^
-
-* Etap tests no longer require use of port 5984. They now use a randomly
-  selected port so they won't clash with a running CouchDB.
-
-Futon
-^^^^^
-
-* Made compatible with jQuery 1.5.x.
-
-HTTP Interface
-^^^^^^^^^^^^^^
-
-* Fix bug that allows invalid UTF-8 after valid escapes.
-* The query parameter `include_docs` now honors the parameter `conflicts`.
-  This applies to queries against map views, _all_docs and _changes.
-* Added support for inclusive_end with reduce views.
-
-Replicator
-^^^^^^^^^^
-
-* Enabled replication over IPv6.
-* Fixed for crashes in continuous and filtered changes feeds.
-* Fixed error when restarting replications in OTP R14B02.
-* Upgrade ibrowse to version 2.2.0.
-* Fixed bug when using a filter and a limit of 1.
-
-Security
-^^^^^^^^
-
-* Fixed OAuth signature computation in OTP R14B02.
-* Handle passwords with : in them.
-
-Storage System
-^^^^^^^^^^^^^^
-
-* More performant queries against _changes and _all_docs when using the
-  `include_docs` parameter.
-
-Windows
-^^^^^^^
-
-* Windows builds now require ICU >= 4.4.0 and Erlang >= R14B03. See
-  :issue:`1152`, and :issue:`963` + OTP-9139 for more information.
-
-
-Version 1.0.2
--------------
-
-Futon
-^^^^^
-
-* Make test suite work with Safari and Chrome.
-* Fixed animated progress spinner.
-* Fix raw view document link due to overzealous URI encoding.
-* Spell javascript correctly in loadScript(uri).
-
-HTTP Interface
-^^^^^^^^^^^^^^
-
-* Allow reduce=false parameter in map-only views.
-* Fix parsing of Accept headers.
-* Fix for multipart GET APIs when an attachment was created during a
-  local-local replication. See :issue:`1022` for details.
-
-Log System
-^^^^^^^^^^
-
-* Reduce lengthy stack traces.
-* Allow logging of native <xml> types.
-
-Replicator
-^^^^^^^^^^
-
-* Updated ibrowse library to 2.1.2 fixing numerous replication issues.
-* Make sure that the replicator respects HTTP settings defined in the config.
-* Fix error when the ibrowse connection closes unexpectedly.
-* Fix authenticated replication (with HTTP basic auth) of design documents
-  with attachments.
-* Various fixes to make replication more resilient for edge-cases.
-
-Storage System
-^^^^^^^^^^^^^^
-
-* Fix leaking file handles after compacting databases and views.
-* Fix databases forgetting their validation function after compaction.
-* Fix occasional timeout errors after successfully compacting large databases.
-* Fix ocassional error when writing to a database that has just been compacted.
-* Fix occasional timeout errors on systems with slow or heavily loaded IO.
-* Fix for OOME when compactions include documents with many conflicts.
-* Fix for missing attachment compression when MIME types included parameters.
-* Preserve purge metadata during compaction to avoid spurious view rebuilds.
-* Fix spurious conflicts introduced when uploading an attachment after
-  a doc has been in a conflict. See :issue:`902` for details.
-* Fix for frequently edited documents in multi-master deployments being
-  duplicated in _changes and _all_docs.  See :issue:`968` for details on how
-  to repair.
-* Significantly higher read and write throughput against database and
-  view index files.
-
-View Server
-^^^^^^^^^^^
-
-* Don't trigger view updates when requesting `_design/doc/_info`.
-* Fix for circular references in CommonJS requires.
-* Made isArray() function available to functions executed in the query server.
-* Documents are now sealed before being passed to map functions.
-* Force view compaction failure when duplicated document data exists. When
-  this error is seen in the logs users should rebuild their views from
-  scratch to fix the issue. See :issue:`999` for details.
-
-
-Version 1.0.1
--------------
-
-Authentication
-^^^^^^^^^^^^^^
-
-* Enable basic-auth popup when required to access the server, to prevent
-   people from getting locked out.
-
-Build and System Integration
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-* Included additional source files for distribution.
-
-Futon
-^^^^^
-
-* User interface element for querying stale (cached) views.
-
-HTTP Interface
-^^^^^^^^^^^^^^
-
-* Expose `committed_update_seq` for monitoring purposes.
-* Show fields saved along with _deleted=true. Allows for auditing of deletes.
-* More robust Accept-header detection.
-
-Replicator
-^^^^^^^^^^
-
-* Added support for replication via an HTTP/HTTPS proxy.
-* Fix pull replication of attachments from 0.11 to 1.0.x.
-* Make the _changes feed work with non-integer seqnums.
-
-Storage System
-^^^^^^^^^^^^^^
-
-* Fix data corruption bug :issue:`844`. Please see
-  http://couchdb.apache.org/notice/1.0.1.html for details.
-
-
-Version 1.0.0
--------------
-
-Security
-^^^^^^^^
-
-* Added authentication caching, to avoid repeated opening and closing of the
-  users database for each request requiring authentication.
-
-Storage System
-^^^^^^^^^^^^^^
-
-* Small optimization for reordering result lists.
-* More efficient header commits.
-* Use O_APPEND to save lseeks.
-* Faster implementation of pread_iolist(). Further improves performance on
-  concurrent reads.
-
-View Server
-^^^^^^^^^^^
-
-* Faster default view collation.
-* Added option to include update_seq in view responses.
-
-0.11.x Branch
-=============
-
-.. contents::
-   :depth: 1
-   :local:
-
-Version 0.11.2
---------------
-
-Authentication
-^^^^^^^^^^^^^^
-
-* User documents can now be deleted by admins or the user.
-
-Futon
-^^^^^
-
-* Add some Futon files that were missing from the Makefile.
-
-HTTP Interface
-^^^^^^^^^^^^^^
-
-* Better error messages on invalid URL requests.
-
-Replicator
-^^^^^^^^^^
-
-* Fix bug when pushing design docs by non-admins, which was hanging the
-   replicator for no good reason.
-* Fix bug when pulling design documents from a source that requires
-   basic-auth.
-
-Security
-^^^^^^^^
-
-* Avoid potential DOS attack by guarding all creation of atoms.
-
-
-Version 0.11.1
---------------
-
-Build and System Integration
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-* Output of `couchdb --help` has been improved.
-* Fixed compatibility with the Erlang R14 series.
-* Fixed warnings on Linux builds.
-* Fixed build error when aclocal needs to be called during the build.
-* Require ICU 4.3.1.
-* Fixed compatibility with Solaris.
-
-Configuration System
-^^^^^^^^^^^^^^^^^^^^
-
-* Fixed timeout with large .ini files.
-
-Futon
-^^^^^
-
-* Use "expando links" for over-long document values in Futon.
-* Added continuous replication option.
-* Added option to replicating test results anonymously to a community
-  CouchDB instance.
-* Allow creation and deletion of config entries.
-* Fixed display issues with doc ids that have escaped characters.
-* Fixed various UI issues.
-
-HTTP Interface
-^^^^^^^^^^^^^^
-
-* Mask passwords in active tasks and logging.
-* Update mochijson2 to allow output of BigNums not in float form.
-* Added support for X-HTTP-METHOD-OVERRIDE.
-* Better error message for database names.
-* Disable jsonp by default.
-* Accept gzip encoded standalone attachments.
-* Made max_concurrent_connections configurable.
-* Made changes API more robust.
-* Send newly generated document rev to callers of an update function.
-
-JavaScript Clients
-^^^^^^^^^^^^^^^^^^
-
-* Added tests for couch.js and jquery.couch.js
-* Added changes handler to jquery.couch.js.
-* Added cache busting to jquery.couch.js if the user agent is msie.
-* Added support for multi-document-fetch (via _all_docs) to jquery.couch.js.
-* Added attachment versioning to jquery.couch.js.
-* Added option to control ensure_full_commit to jquery.couch.js.
-* Added list functionality to jquery.couch.js.
-* Fixed issues where bulkSave() wasn't sending a POST body.
-
-Log System
-^^^^^^^^^^
-
-* Log HEAD requests as HEAD, not GET.
-* Keep massive JSON blobs out of the error log.
-* Fixed a timeout issue.
-
-Replication System
-^^^^^^^^^^^^^^^^^^
-
-* Refactored various internal APIs related to attachment streaming.
-* Fixed hanging replication.
-* Fixed keepalive issue.
-
-Security
-^^^^^^^^
-
-* Added authentication redirect URL to log in clients.
-* Fixed query parameter encoding issue in oauth.js.
-* Made authentication timeout configurable.
-* Temporary views are now admin-only resources.
-
-Storage System
-^^^^^^^^^^^^^^
-
-* Don't require a revpos for attachment stubs.
-* Added checking to ensure when a revpos is sent with an attachment stub,
-  it's correct.
-* Make file deletions async to avoid pauses during compaction and db
-  deletion.
-* Fixed for wrong offset when writing headers and converting them to blocks,
-  only triggered when header is larger than 4k.
-* Preserve _revs_limit and instance_start_time after compaction.
-
-Test Suite
-^^^^^^^^^^
-
-* Made the test suite overall more reliable.
-
-View Server
-^^^^^^^^^^^
-
-* Provide a UUID to update functions (and all other functions) that they can
-  use to create new docs.
-* Upgrade CommonJS modules support to 1.1.1.
-* Fixed erlang filter funs and normalize filter fun API.
-* Fixed hang in view shutdown.
-
-URL Rewriter & Vhosts
-^^^^^^^^^^^^^^^^^^^^^
-
-* Allow more complex keys in rewriter.
-* Allow global rewrites so system defaults are available in vhosts.
-* Allow isolation of databases with vhosts.
-* Fix issue with passing variables to query parameters.
-
-
-Version 0.11.0
---------------
-
-Build and System Integration
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-* Updated and improved source documentation.
-* Fixed distribution preparation for building on Mac OS X.
-* Added support for building a Windows installer as part of 'make dist'.
-* Bug fix for building couch.app's module list.
-* ETap tests are now run during make distcheck. This included a number of
-  updates to the build system to properly support VPATH builds.
-* Gavin McDonald setup a build-bot instance. More info can be found at
-  http://ci.apache.org/buildbot.html
-
-Futon
-^^^^^
-
-* Added a button for view compaction.
-* JSON strings are now displayed as-is in the document view, without the
-  escaping of new-lines and quotes. That dramatically improves readability of
-  multi-line strings.
-* Same goes for editing of JSON string values. When a change to a field value is
-  submitted, and the value is not valid JSON it is assumed to be a string. This
-  improves editing of multi-line strings a lot.
-* Hitting tab in textareas no longer moves focus to the next form field, but
-  simply inserts a tab character at the current caret position.
-* Fixed some font declarations.
-
-HTTP Interface
-^^^^^^^^^^^^^^
-
-* Provide Content-MD5 header support for attachments.
-* Added URL Rewriter handler.
-* Added virtual host handling.
-
-Replication
-^^^^^^^^^^^
-
-* Added option to implicitly create replication target databases.
-* Avoid leaking file descriptors on automatic replication restarts.
-* Added option to replicate a list of documents by id.
-* Allow continuous replication to be cancelled.
-
-Runtime Statistics
-^^^^^^^^^^^^^^^^^^
-
-* Statistics are now calculated for a moving window instead of non-overlapping
-  timeframes.
-* Fixed a problem with statistics timers and system sleep.
-* Moved statistic names to a term file in the priv directory.
-
-Security
-^^^^^^^^
-
-* Fixed CVE-2010-0009: Apache CouchDB Timing Attack Vulnerability.
-* Added default cookie-authentication and users database.
-* Added Futon user interface for user signup and login.
-* Added per-database reader access control lists.
-* Added per-database security object for configuration data in validation
-  functions.
-* Added proxy authentication handler
-
-Storage System
-^^^^^^^^^^^^^^
-
-* Adds batching of multiple updating requests, to improve throughput with many
-  writers. Removed the now redundant couch_batch_save module.
-* Adds configurable compression of attachments.
-
-View Server
-^^^^^^^^^^^
-
-* Added optional 'raw' binary collation for faster view builds where Unicode
-  collation is not important.
-* Improved view index build time by reducing ICU collation callouts.
-* Improved view information objects.
-* Bug fix for partial updates during view builds.
-* Move query server to a design-doc based protocol.
-* Use json2.js for JSON serialization for compatiblity with native JSON.
-* Major refactoring of couchjs to lay the groundwork for disabling cURL
-  support. The new HTTP interaction acts like a synchronous XHR. Example usage
-  of the new system is in the JavaScript CLI test runner.
-
-
-
-0.10.x Branch
-=============
-
-.. contents::
-   :depth: 1
-   :local:
-
-Version 0.10.1
---------------
-
-Build and System Integration
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-* Test suite now works with the distcheck target.
-
-Replicator
-^^^^^^^^^^
-
-* Stability enhancements regarding redirects, timeouts, OAuth.
-
-Query Server
-^^^^^^^^^^^^
-
-* Avoid process leaks
-* Allow list and view to span languages
-
-Stats
-^^^^^
-
-* Eliminate new process flood on system wake
-
-
-Version 0.10.0
---------------
-
-Build and System Integration
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-* Changed `couchdb` script configuration options.
-* Added default.d and local.d configuration directories to load sequence.
-
-HTTP Interface
-^^^^^^^^^^^^^^
-
-* Added optional cookie-based authentication handler.
-* Added optional two-legged OAuth authentication handler.
-
-Storage Format
-^^^^^^^^^^^^^^
-
-* Add move headers with checksums to the end of database files for extra robust
-  storage and faster storage.
-
-View Server
-^^^^^^^^^^^
-
-* Added native Erlang views for high-performance applications.
-
-0.9.x Branch
-============
-
-.. contents::
-   :depth: 1
-   :local:
-
-Version 0.9.2
--------------
-
-Build and System Integration
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-* Remove branch callbacks to allow building couchjs against newer versions of
-  Spidermonkey.
-
-Replication
-^^^^^^^^^^^
-
-* Fix replication with 0.10 servers initiated by an 0.9 server (:issue:`559`).
-
-
-Version 0.9.1
--------------
-
-Build and System Integration
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-* PID file directory is now created by the SysV/BSD daemon scripts.
-* Fixed the environment variables shown by the configure script.
-* Fixed the build instructions shown by the configure script.
-* Updated ownership and permission advice in `README` for better security.
-
-Configuration and stats system
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-* Corrected missing configuration file error message.
-* Fixed incorrect recording of request time.
-
-Database Core
-^^^^^^^^^^^^^
-
-* Document validation for underscore prefixed variables.
-* Made attachment storage less sparse.
-* Fixed problems when a database with delayed commits pending is considered
-  idle, and subject to losing changes when shutdown. (:issue:`334`)
-
-External Handlers
-^^^^^^^^^^^^^^^^^
-
-* Fix POST requests.
-
-Futon
-^^^^^
-
-* Redirect when loading a deleted view URI from the cookie.
-
-HTTP Interface
-^^^^^^^^^^^^^^
-
-* Attachment requests respect the "rev" query-string parameter.
-
-JavaScript View Server
-^^^^^^^^^^^^^^^^^^^^^^
-
-* Useful JavaScript Error messages.
-
-Replication
-^^^^^^^^^^^
-
-* Added support for Unicode characters transmitted as UTF-16 surrogate pairs.
-* URL-encode attachment names when necessary.
-* Pull specific revisions of an attachment, instead of just the latest one.
-* Work around a rare chunk-merging problem in ibrowse.
-* Work with documents containing Unicode characters outside the Basic
-  Multilingual Plane.
-
-
-Version 0.9.0
--------------
-
-Build and System Integration
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-* The `couchdb` script now supports system chainable configuration files.
-* The Mac OS X daemon script now redirects STDOUT and STDERR like SysV/BSD.
-* The build and system integration have been improved for portability.
-* Added COUCHDB_OPTIONS to etc/default/couchdb file.
-* Remove COUCHDB_INI_FILE and COUCHDB_PID_FILE from etc/default/couchdb file.
-* Updated `configure.ac` to manually link `libm` for portability.
-* Updated `configure.ac` to extended default library paths.
-* Removed inets configuration files.
-* Added command line test runner.
-* Created dev target for make.
-
-Configuration and stats system
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-* Separate default and local configuration files.
-* HTTP interface for configuration changes.
-* Statistics framework with HTTP query API.
-
-Database Core
-^^^^^^^^^^^^^
-
-* Faster B-tree implementation.
-* Changed internal JSON term format.
-* Improvements to Erlang VM interactions under heavy load.
-* User context and administrator role.
-* Update validations with design document validation functions.
-* Document purge functionality.
-* Ref-counting for database file handles.
-
-Design Document Resource Paths
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-* Added httpd_design_handlers config section.
-* Moved _view to httpd_design_handlers.
-* Added ability to render documents as non-JSON content-types with _show and
-  _list functions, which are also httpd_design_handlers.
-
-Futon Utility Client
-^^^^^^^^^^^^^^^^^^^^
-
-* Added pagination to the database listing page.
-* Implemented attachment uploading from the document page.
-* Added page that shows the current configuration, and allows modification of
-  option values.
-* Added a JSON "source view" for document display.
-* JSON data in view rows is now syntax highlighted.
-* Removed the use of an iframe for better integration with browser history and
-  bookmarking.
-* Full database listing in the sidebar has been replaced by a short list of
-  recent databases.
-* The view editor now allows selection of the view language if there is more
-  than one configured.
-* Added links to go to the raw view or document URI.
-* Added status page to display currently running tasks in CouchDB.
-* JavaScript test suite split into multiple files.
-* Pagination for reduce views.
-
-HTTP Interface
-^^^^^^^^^^^^^^
-
-* Added client side UUIDs for idempotent document creation
-* HTTP COPY for documents
-* Streaming of chunked attachment PUTs to disk
-* Remove negative count feature
-* Add include_docs option for view queries
-* Add multi-key view post for views
-* Query parameter validation
-* Use stale=ok to request potentially cached view index
-* External query handler module for full-text or other indexers.
-* Etags for attachments, views, shows and lists
-* Show and list functions for rendering documents and views as developer
-  controlled content-types.
-* Attachment names may use slashes to allow uploading of nested directories
-  (useful for static web hosting).
-* Option for a view to run over design documents.
-* Added newline to JSON responses. Closes bike-shed.
-
-Replication
-^^^^^^^^^^^
-
-* Using ibrowse.
-* Checkpoint replications so failures are less expensive.
-* Automatically retry of failed replications.
-* Stream attachments in pull-replication.
-
-0.8.x Branch
-============
-
-.. contents::
-   :depth: 1
-   :local:
-
-Version 0.8.1-incubating
-------------------------
-
-Build and System Integration
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-* The `couchdb` script no longer uses `awk` for configuration checks as this
-  was causing portability problems.
-* Updated `sudo` example in `README` to use the `-i` option, this fixes
-  problems when invoking from a directory the `couchdb` user cannot access.
-
-Database Core
-^^^^^^^^^^^^^
-
-* Fix for replication problems where the write queues can get backed up if the
-  writes aren't happening fast enough to keep up with the reads. For a large
-  replication, this can exhaust memory and crash, or slow down the machine
-  dramatically. The fix keeps only one document in the write queue at a time.
-* Fix for databases sometimes incorrectly reporting that they contain 0
-  documents after compaction.
-* CouchDB now uses ibrowse instead of inets for its internal HTTP client
-  implementation. This means better replication stability.
-
-Futon
-^^^^^
-
-* The view selector dropdown should now work in Opera and Internet Explorer
-  even when it includes optgroups for design documents. (:issue:`81`)
-
-JavaScript View Server
-^^^^^^^^^^^^^^^^^^^^^^
-
-* Sealing of documents has been disabled due to an incompatibility with
-  SpiderMonkey 1.9.
-* Improve error handling for undefined values emitted by map functions.
-  (:issue:`83`)
-
-HTTP Interface
-^^^^^^^^^^^^^^
-
-* Fix for chunked responses where chunks were always being split into multiple
-  TCP packets, which caused problems with the test suite under Safari, and in
-  some other cases.
-* Fix for an invalid JSON response body being returned for some kinds of
-  views. (:issue:`84`)
-* Fix for connections not getting closed after rejecting a chunked request.
-  (:issue:`55`)
-* CouchDB can now be bound to IPv6 addresses.
-* The HTTP `Server` header now contains the versions of CouchDB and Erlang.
-
-
-Version 0.8.0-incubating
-------------------------
-
-Build and System Integration
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-* CouchDB can automatically respawn following a server crash.
-* Database server no longer refuses to start with a stale PID file.
-* System logrotate configuration provided.
-* Improved handling of ICU shared libraries.
-* The `couchdb` script now automatically enables SMP support in Erlang.
-* The `couchdb` and `couchjs` scripts have been improved for portability.
-* The build and system integration have been improved for portability.
-
-Database Core
-^^^^^^^^^^^^^
-
-* The view engine has been completely decoupled from the storage engine. Index
-  data is now stored in separate files, and the format of the main database
-  file has changed.
-* Databases can now be compacted to reclaim space used for deleted documents
-  and old document revisions.
-* Support for incremental map/reduce views has been added.
-* To support map/reduce, the structure of design documents has changed. View
-  values are now JSON objects containing at least a `map` member, and
-  optionally a `reduce` member.
-* View servers are now identified by name (for example `javascript`) instead of
-  by media type.
-* Automatically generated document IDs are now based on proper UUID generation
-  using the crypto module.
-* The field `content-type` in the JSON representation of attachments has been
-  renamed to `content_type` (underscore).
-
-Futon
-^^^^^
-
-* When adding a field to a document, Futon now just adds a field with an
-  autogenerated name instead of prompting for the name with a dialog. The name
-  is automatically put into edit mode so that it can be changed immediately.
-* Fields are now sorted alphabetically by name when a document is displayed.
-* Futon can be used to create and update permanent views.
-* The maximum number of rows to display per page on the database page can now
-  be adjusted.
-* Futon now uses the XMLHTTPRequest API asynchronously to communicate with the
-  CouchDB HTTP server, so that most operations no longer block the browser.
-* View results sorting can now be switched between ascending and descending by
-  clicking on the `Key` column header.
-* Fixed a bug where documents that contained a `@` character could not be
-  viewed. (:issue:`12`)
-* The database page now provides a `Compact` button to trigger database
-  compaction. (:issue:`38`)
-* Fixed portential double encoding of document IDs and other URI segments in
-  many instances. (:issue:`39`)
-* Improved display of attachments.
-* The JavaScript Shell has been removed due to unresolved licensing issues.
-
-JavaScript View Server
-^^^^^^^^^^^^^^^^^^^^^^
-
-* SpiderMonkey is no longer included with CouchDB, but rather treated as a
-  normal external dependency. A simple C program (`_couchjs`) is provided that
-  links against an existing SpiderMonkey installation and uses the interpreter
-  embedding API.
-* View functions using the default JavaScript view server can now do logging
-  using the global `log(message)` function. Log messages are directed into the
-  CouchDB log at `INFO` level. (:issue:`59`)
-* The global `map(key, value)` function made available to view code has been
-  renamed to `emit(key, value)`.
-* Fixed handling of exceptions raised by view functions.
-
-HTTP Interface
-^^^^^^^^^^^^^^
-
-* CouchDB now uses MochiWeb instead of inets for the HTTP server
-  implementation. Among other things, this means that the extra configuration
-  files needed for inets (such as `couch_httpd.conf`) are no longer used.
-* The HTTP interface now completely supports the `HEAD` method. (:issue:`3`)
-* Improved compliance of `Etag` handling with the HTTP specification.
-  (:issue:`13`)
-* Etags are no longer included in responses to document `GET` requests that
-  include query string parameters causing the JSON response to change without
-  the revision or the URI having changed.
-* The bulk document update API has changed slightly on both the request and the
-  response side. In addition, bulk updates are now atomic.
-* CouchDB now uses `TCP_NODELAY` to fix performance problems with persistent
-  connections on some platforms due to nagling.
-* Including a `?descending=false` query string parameter in requests to views
-  no longer raises an error.
-* Requests to unknown top-level reserved URLs (anything with a leading
-  underscore) now return a `unknown_private_path` error instead of the
-  confusing `illegal_database_name`.
-* The Temporary view handling now expects a JSON request body, where the JSON
-  is an object with at least a `map` member, and optional `reduce` and
-  `language` members.
-* Temporary views no longer determine the view server based on the Content-Type
-  header of the `POST` request, but rather by looking for a `language` member
-  in the JSON body of the request.
-* The status code of responses to `DELETE` requests is now 200 to reflect that
-  that the deletion is performed synchronously.

http://git-wip-us.apache.org/repos/asf/couchdb/blob/4c0241d1/share/doc/src/config/auth.rst
----------------------------------------------------------------------
diff --git a/share/doc/src/config/auth.rst b/share/doc/src/config/auth.rst
index 4ce2056..e457647 100644
--- a/share/doc/src/config/auth.rst
+++ b/share/doc/src/config/auth.rst
@@ -93,7 +93,7 @@ Further details are available in `security`, including configuring the
 work factor for ``PBKDF2``, and the algorithm itself at
 `PBKDF2 (RFC-2898) <http://tools.ietf.org/html/rfc2898>`_.
 
-.. versionchanged:: 1.3 `PBKDF2` server-side hashed salted password support
+.. versionchanged:: 1.4 `PBKDF2` server-side hashed salted password support
    added, now as a synchronous call for the ``_config/admins`` API.
 
 

http://git-wip-us.apache.org/repos/asf/couchdb/blob/4c0241d1/share/doc/src/index.rst
----------------------------------------------------------------------
diff --git a/share/doc/src/index.rst b/share/doc/src/index.rst
index 1cc84af..0ad38b1 100644
--- a/share/doc/src/index.rst
+++ b/share/doc/src/index.rst
@@ -38,7 +38,7 @@ Contents
     api/index
     json-structure
     contributing
-    changelog
+    whatsnew/index
 
 .. This is how you get a TM sign into a link. Haha. Seriously.
 .. |Apache CouchDB(TM)| unicode:: Apache U+0020 CouchDB U+2122

http://git-wip-us.apache.org/repos/asf/couchdb/blob/4c0241d1/share/doc/src/whatsnew/0.10.rst
----------------------------------------------------------------------
diff --git a/share/doc/src/whatsnew/0.10.rst b/share/doc/src/whatsnew/0.10.rst
new file mode 100644
index 0000000..f879052
--- /dev/null
+++ b/share/doc/src/whatsnew/0.10.rst
@@ -0,0 +1,98 @@
+.. 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/0.10.x:
+
+0.10.x Branch
+=============
+
+.. contents::
+   :depth: 1
+   :local:
+
+
+.. _release/0.10.2:
+
+Version 0.10.2
+--------------
+
+Build and System Integration
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+* Fixed distribution preparation for building on Mac OS X.
+
+Security
+^^^^^^^^
+
+* Fixed CVE-2010-0009: Apache CouchDB Timing Attack Vulnerability
+
+Replicator
+^^^^^^^^^^
+
+* Avoid leaking file descriptors on automatic replication restarts.
+
+
+.. _release/0.10.1:
+
+Version 0.10.1
+--------------
+
+Build and System Integration
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+* Test suite now works with the distcheck target.
+
+Replicator
+^^^^^^^^^^
+
+* Stability enhancements regarding redirects, timeouts, OAuth.
+
+Query Server
+^^^^^^^^^^^^
+
+* Avoid process leaks
+* Allow list and view to span languages
+
+Stats
+^^^^^
+
+* Eliminate new process flood on system wake
+
+
+.. _release/0.10.0:
+
+Version 0.10.0
+--------------
+
+Build and System Integration
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+* Changed `couchdb` script configuration options.
+* Added default.d and local.d configuration directories to load sequence.
+
+HTTP Interface
+^^^^^^^^^^^^^^
+
+* Added optional cookie-based authentication handler.
+* Added optional two-legged OAuth authentication handler.
+
+Storage Format
+^^^^^^^^^^^^^^
+
+* Add move headers with checksums to the end of database files for extra robust
+  storage and faster storage.
+
+View Server
+^^^^^^^^^^^
+
+* Added native Erlang views for high-performance applications.

http://git-wip-us.apache.org/repos/asf/couchdb/blob/4c0241d1/share/doc/src/whatsnew/0.11.rst
----------------------------------------------------------------------
diff --git a/share/doc/src/whatsnew/0.11.rst b/share/doc/src/whatsnew/0.11.rst
new file mode 100644
index 0000000..549f588
--- /dev/null
+++ b/share/doc/src/whatsnew/0.11.rst
@@ -0,0 +1,256 @@
+.. 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/0.11.x:
+
+0.11.x Branch
+=============
+
+.. contents::
+   :depth: 1
+   :local:
+
+
+.. _release/0.11.2:
+
+Version 0.11.2
+--------------
+
+Authentication
+^^^^^^^^^^^^^^
+
+* User documents can now be deleted by admins or the user.
+
+Futon
+^^^^^
+
+* Add some Futon files that were missing from the Makefile.
+
+HTTP Interface
+^^^^^^^^^^^^^^
+
+* Better error messages on invalid URL requests.
+
+Replicator
+^^^^^^^^^^
+
+* Fix bug when pushing design docs by non-admins, which was hanging the
+  replicator for no good reason.
+* Fix bug when pulling design documents from a source that requires
+  basic-auth.
+
+Security
+^^^^^^^^
+
+* Avoid potential DOS attack by guarding all creation of atoms.
+* Fixed CVE-2010-2234: Apache CouchDB Cross Site Request Forgery Attack
+
+
+.. _release/0.11.1:
+
+Version 0.11.1
+--------------
+
+Build and System Integration
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+* Output of `couchdb --help` has been improved.
+* Fixed compatibility with the Erlang R14 series.
+* Fixed warnings on Linux builds.
+* Fixed build error when aclocal needs to be called during the build.
+* Require ICU 4.3.1.
+* Fixed compatibility with Solaris.
+
+Configuration System
+^^^^^^^^^^^^^^^^^^^^
+
+* Fixed timeout with large .ini files.
+
+Futon
+^^^^^
+
+* Use "expando links" for over-long document values in Futon.
+* Added continuous replication option.
+* Added option to replicating test results anonymously to a community
+  CouchDB instance.
+* Allow creation and deletion of config entries.
+* Fixed display issues with doc ids that have escaped characters.
+* Fixed various UI issues.
+
+HTTP Interface
+^^^^^^^^^^^^^^
+
+* Mask passwords in active tasks and logging.
+* Update mochijson2 to allow output of BigNums not in float form.
+* Added support for X-HTTP-METHOD-OVERRIDE.
+* Better error message for database names.
+* Disable jsonp by default.
+* Accept gzip encoded standalone attachments.
+* Made max_concurrent_connections configurable.
+* Made changes API more robust.
+* Send newly generated document rev to callers of an update function.
+
+JavaScript Clients
+^^^^^^^^^^^^^^^^^^
+
+* Added tests for couch.js and jquery.couch.js
+* Added changes handler to jquery.couch.js.
+* Added cache busting to jquery.couch.js if the user agent is msie.
+* Added support for multi-document-fetch (via _all_docs) to jquery.couch.js.
+* Added attachment versioning to jquery.couch.js.
+* Added option to control ensure_full_commit to jquery.couch.js.
+* Added list functionality to jquery.couch.js.
+* Fixed issues where bulkSave() wasn't sending a POST body.
+
+Log System
+^^^^^^^^^^
+
+* Log HEAD requests as HEAD, not GET.
+* Keep massive JSON blobs out of the error log.
+* Fixed a timeout issue.
+
+Replication System
+^^^^^^^^^^^^^^^^^^
+
+* Refactored various internal APIs related to attachment streaming.
+* Fixed hanging replication.
+* Fixed keepalive issue.
+
+Security
+^^^^^^^^
+
+* Added authentication redirect URL to log in clients.
+* Fixed query parameter encoding issue in oauth.js.
+* Made authentication timeout configurable.
+* Temporary views are now admin-only resources.
+
+Storage System
+^^^^^^^^^^^^^^
+
+* Don't require a revpos for attachment stubs.
+* Added checking to ensure when a revpos is sent with an attachment stub,
+  it's correct.
+* Make file deletions async to avoid pauses during compaction and db
+  deletion.
+* Fixed for wrong offset when writing headers and converting them to blocks,
+  only triggered when header is larger than 4k.
+* Preserve _revs_limit and instance_start_time after compaction.
+
+Test Suite
+^^^^^^^^^^
+
+* Made the test suite overall more reliable.
+
+View Server
+^^^^^^^^^^^
+
+* Provide a UUID to update functions (and all other functions) that they can
+  use to create new docs.
+* Upgrade CommonJS modules support to 1.1.1.
+* Fixed erlang filter funs and normalize filter fun API.
+* Fixed hang in view shutdown.
+
+URL Rewriter & Vhosts
+^^^^^^^^^^^^^^^^^^^^^
+
+* Allow more complex keys in rewriter.
+* Allow global rewrites so system defaults are available in vhosts.
+* Allow isolation of databases with vhosts.
+* Fix issue with passing variables to query parameters.
+
+
+.. _release/0.11.0:
+
+Version 0.11.0
+--------------
+
+Build and System Integration
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+* Updated and improved source documentation.
+* Fixed distribution preparation for building on Mac OS X.
+* Added support for building a Windows installer as part of 'make dist'.
+* Bug fix for building couch.app's module list.
+* ETap tests are now run during make distcheck. This included a number of
+  updates to the build system to properly support VPATH builds.
+* Gavin McDonald setup a build-bot instance. More info can be found at
+  http://ci.apache.org/buildbot.html
+
+Futon
+^^^^^
+
+* Added a button for view compaction.
+* JSON strings are now displayed as-is in the document view, without the
+  escaping of new-lines and quotes. That dramatically improves readability of
+  multi-line strings.
+* Same goes for editing of JSON string values. When a change to a field value is
+  submitted, and the value is not valid JSON it is assumed to be a string. This
+  improves editing of multi-line strings a lot.
+* Hitting tab in textareas no longer moves focus to the next form field, but
+  simply inserts a tab character at the current caret position.
+* Fixed some font declarations.
+
+HTTP Interface
+^^^^^^^^^^^^^^
+
+* Provide Content-MD5 header support for attachments.
+* Added URL Rewriter handler.
+* Added virtual host handling.
+
+Replication
+^^^^^^^^^^^
+
+* Added option to implicitly create replication target databases.
+* Avoid leaking file descriptors on automatic replication restarts.
+* Added option to replicate a list of documents by id.
+* Allow continuous replication to be cancelled.
+
+Runtime Statistics
+^^^^^^^^^^^^^^^^^^
+
+* Statistics are now calculated for a moving window instead of non-overlapping
+  timeframes.
+* Fixed a problem with statistics timers and system sleep.
+* Moved statistic names to a term file in the priv directory.
+
+Security
+^^^^^^^^
+
+* Fixed CVE-2010-0009: Apache CouchDB Timing Attack Vulnerability.
+* Added default cookie-authentication and users database.
+* Added Futon user interface for user signup and login.
+* Added per-database reader access control lists.
+* Added per-database security object for configuration data in validation
+  functions.
+* Added proxy authentication handler
+
+Storage System
+^^^^^^^^^^^^^^
+
+* Adds batching of multiple updating requests, to improve throughput with many
+  writers. Removed the now redundant couch_batch_save module.
+* Adds configurable compression of attachments.
+
+View Server
+^^^^^^^^^^^
+
+* Added optional 'raw' binary collation for faster view builds where Unicode
+  collation is not important.
+* Improved view index build time by reducing ICU collation callouts.
+* Improved view information objects.
+* Bug fix for partial updates during view builds.
+* Move query server to a design-doc based protocol.
+* Use json2.js for JSON serialization for compatiblity with native JSON.
+* Major refactoring of couchjs to lay the groundwork for disabling cURL
+  support. The new HTTP interaction acts like a synchronous XHR. Example usage
+  of the new system is in the JavaScript CLI test runner.

http://git-wip-us.apache.org/repos/asf/couchdb/blob/4c0241d1/share/doc/src/whatsnew/0.8.rst
----------------------------------------------------------------------
diff --git a/share/doc/src/whatsnew/0.8.rst b/share/doc/src/whatsnew/0.8.rst
new file mode 100644
index 0000000..0819fd7
--- /dev/null
+++ b/share/doc/src/whatsnew/0.8.rst
@@ -0,0 +1,177 @@
+.. 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/0.8.x:
+
+0.8.x Branch
+============
+
+.. contents::
+   :depth: 1
+   :local:
+
+
+.. _release/0.8.1:
+
+Version 0.8.1-incubating
+------------------------
+
+Build and System Integration
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+* The `couchdb` script no longer uses `awk` for configuration checks as this
+  was causing portability problems.
+* Updated `sudo` example in `README` to use the `-i` option, this fixes
+  problems when invoking from a directory the `couchdb` user cannot access.
+
+Database Core
+^^^^^^^^^^^^^
+
+* Fix for replication problems where the write queues can get backed up if the
+  writes aren't happening fast enough to keep up with the reads. For a large
+  replication, this can exhaust memory and crash, or slow down the machine
+  dramatically. The fix keeps only one document in the write queue at a time.
+* Fix for databases sometimes incorrectly reporting that they contain 0
+  documents after compaction.
+* CouchDB now uses ibrowse instead of inets for its internal HTTP client
+  implementation. This means better replication stability.
+
+Futon
+^^^^^
+
+* The view selector dropdown should now work in Opera and Internet Explorer
+  even when it includes optgroups for design documents. (:issue:`81`)
+
+JavaScript View Server
+^^^^^^^^^^^^^^^^^^^^^^
+
+* Sealing of documents has been disabled due to an incompatibility with
+  SpiderMonkey 1.9.
+* Improve error handling for undefined values emitted by map functions.
+  (:issue:`83`)
+
+HTTP Interface
+^^^^^^^^^^^^^^
+
+* Fix for chunked responses where chunks were always being split into multiple
+  TCP packets, which caused problems with the test suite under Safari, and in
+  some other cases.
+* Fix for an invalid JSON response body being returned for some kinds of
+  views. (:issue:`84`)
+* Fix for connections not getting closed after rejecting a chunked request.
+  (:issue:`55`)
+* CouchDB can now be bound to IPv6 addresses.
+* The HTTP `Server` header now contains the versions of CouchDB and Erlang.
+
+
+.. _release/0.8.0:
+
+Version 0.8.0-incubating
+------------------------
+
+Build and System Integration
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+* CouchDB can automatically respawn following a server crash.
+* Database server no longer refuses to start with a stale PID file.
+* System logrotate configuration provided.
+* Improved handling of ICU shared libraries.
+* The `couchdb` script now automatically enables SMP support in Erlang.
+* The `couchdb` and `couchjs` scripts have been improved for portability.
+* The build and system integration have been improved for portability.
+
+Database Core
+^^^^^^^^^^^^^
+
+* The view engine has been completely decoupled from the storage engine. Index
+  data is now stored in separate files, and the format of the main database
+  file has changed.
+* Databases can now be compacted to reclaim space used for deleted documents
+  and old document revisions.
+* Support for incremental map/reduce views has been added.
+* To support map/reduce, the structure of design documents has changed. View
+  values are now JSON objects containing at least a `map` member, and
+  optionally a `reduce` member.
+* View servers are now identified by name (for example `javascript`) instead of
+  by media type.
+* Automatically generated document IDs are now based on proper UUID generation
+  using the crypto module.
+* The field `content-type` in the JSON representation of attachments has been
+  renamed to `content_type` (underscore).
+
+Futon
+^^^^^
+
+* When adding a field to a document, Futon now just adds a field with an
+  autogenerated name instead of prompting for the name with a dialog. The name
+  is automatically put into edit mode so that it can be changed immediately.
+* Fields are now sorted alphabetically by name when a document is displayed.
+* Futon can be used to create and update permanent views.
+* The maximum number of rows to display per page on the database page can now
+  be adjusted.
+* Futon now uses the XMLHTTPRequest API asynchronously to communicate with the
+  CouchDB HTTP server, so that most operations no longer block the browser.
+* View results sorting can now be switched between ascending and descending by
+  clicking on the `Key` column header.
+* Fixed a bug where documents that contained a `@` character could not be
+  viewed. (:issue:`12`)
+* The database page now provides a `Compact` button to trigger database
+  compaction. (:issue:`38`)
+* Fixed portential double encoding of document IDs and other URI segments in
+  many instances. (:issue:`39`)
+* Improved display of attachments.
+* The JavaScript Shell has been removed due to unresolved licensing issues.
+
+JavaScript View Server
+^^^^^^^^^^^^^^^^^^^^^^
+
+* SpiderMonkey is no longer included with CouchDB, but rather treated as a
+  normal external dependency. A simple C program (`_couchjs`) is provided that
+  links against an existing SpiderMonkey installation and uses the interpreter
+  embedding API.
+* View functions using the default JavaScript view server can now do logging
+  using the global `log(message)` function. Log messages are directed into the
+  CouchDB log at `INFO` level. (:issue:`59`)
+* The global `map(key, value)` function made available to view code has been
+  renamed to `emit(key, value)`.
+* Fixed handling of exceptions raised by view functions.
+
+HTTP Interface
+^^^^^^^^^^^^^^
+
+* CouchDB now uses MochiWeb instead of inets for the HTTP server
+  implementation. Among other things, this means that the extra configuration
+  files needed for inets (such as `couch_httpd.conf`) are no longer used.
+* The HTTP interface now completely supports the `HEAD` method. (:issue:`3`)
+* Improved compliance of `Etag` handling with the HTTP specification.
+  (:issue:`13`)
+* Etags are no longer included in responses to document `GET` requests that
+  include query string parameters causing the JSON response to change without
+  the revision or the URI having changed.
+* The bulk document update API has changed slightly on both the request and the
+  response side. In addition, bulk updates are now atomic.
+* CouchDB now uses `TCP_NODELAY` to fix performance problems with persistent
+  connections on some platforms due to nagling.
+* Including a `?descending=false` query string parameter in requests to views
+  no longer raises an error.
+* Requests to unknown top-level reserved URLs (anything with a leading
+  underscore) now return a `unknown_private_path` error instead of the
+  confusing `illegal_database_name`.
+* The Temporary view handling now expects a JSON request body, where the JSON
+  is an object with at least a `map` member, and optional `reduce` and
+  `language` members.
+* Temporary views no longer determine the view server based on the Content-Type
+  header of the `POST` request, but rather by looking for a `language` member
+  in the JSON body of the request.
+* The status code of responses to `DELETE` requests is now 200 to reflect that
+  that the deletion is performed synchronously.

http://git-wip-us.apache.org/repos/asf/couchdb/blob/4c0241d1/share/doc/src/whatsnew/0.9.rst
----------------------------------------------------------------------
diff --git a/share/doc/src/whatsnew/0.9.rst b/share/doc/src/whatsnew/0.9.rst
new file mode 100644
index 0000000..caba761
--- /dev/null
+++ b/share/doc/src/whatsnew/0.9.rst
@@ -0,0 +1,190 @@
+.. 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/0.9.x:
+
+0.9.x Branch
+============
+
+.. contents::
+   :depth: 1
+   :local:
+
+
+.. _release/0.9.2:
+
+Version 0.9.2
+-------------
+
+Build and System Integration
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+* Remove branch callbacks to allow building couchjs against newer versions of
+  Spidermonkey.
+
+Replication
+^^^^^^^^^^^
+
+* Fix replication with 0.10 servers initiated by an 0.9 server (:issue:`559`).
+
+
+.. _release/0.9.1:
+
+Version 0.9.1
+-------------
+
+Build and System Integration
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+* PID file directory is now created by the SysV/BSD daemon scripts.
+* Fixed the environment variables shown by the configure script.
+* Fixed the build instructions shown by the configure script.
+* Updated ownership and permission advice in `README` for better security.
+
+Configuration and stats system
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+* Corrected missing configuration file error message.
+* Fixed incorrect recording of request time.
+
+Database Core
+^^^^^^^^^^^^^
+
+* Document validation for underscore prefixed variables.
+* Made attachment storage less sparse.
+* Fixed problems when a database with delayed commits pending is considered
+  idle, and subject to losing changes when shutdown. (:issue:`334`)
+
+External Handlers
+^^^^^^^^^^^^^^^^^
+
+* Fix POST requests.
+
+Futon
+^^^^^
+
+* Redirect when loading a deleted view URI from the cookie.
+
+HTTP Interface
+^^^^^^^^^^^^^^
+
+* Attachment requests respect the "rev" query-string parameter.
+
+JavaScript View Server
+^^^^^^^^^^^^^^^^^^^^^^
+
+* Useful JavaScript Error messages.
+
+Replication
+^^^^^^^^^^^
+
+* Added support for Unicode characters transmitted as UTF-16 surrogate pairs.
+* URL-encode attachment names when necessary.
+* Pull specific revisions of an attachment, instead of just the latest one.
+* Work around a rare chunk-merging problem in ibrowse.
+* Work with documents containing Unicode characters outside the Basic
+  Multilingual Plane.
+
+
+.. _release/0.9.0:
+
+Version 0.9.0
+-------------
+
+Build and System Integration
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+* The `couchdb` script now supports system chainable configuration files.
+* The Mac OS X daemon script now redirects STDOUT and STDERR like SysV/BSD.
+* The build and system integration have been improved for portability.
+* Added COUCHDB_OPTIONS to etc/default/couchdb file.
+* Remove COUCHDB_INI_FILE and COUCHDB_PID_FILE from etc/default/couchdb file.
+* Updated `configure.ac` to manually link `libm` for portability.
+* Updated `configure.ac` to extended default library paths.
+* Removed inets configuration files.
+* Added command line test runner.
+* Created dev target for make.
+
+Configuration and stats system
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+* Separate default and local configuration files.
+* HTTP interface for configuration changes.
+* Statistics framework with HTTP query API.
+
+Database Core
+^^^^^^^^^^^^^
+
+* Faster B-tree implementation.
+* Changed internal JSON term format.
+* Improvements to Erlang VM interactions under heavy load.
+* User context and administrator role.
+* Update validations with design document validation functions.
+* Document purge functionality.
+* Ref-counting for database file handles.
+
+Design Document Resource Paths
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+* Added httpd_design_handlers config section.
+* Moved _view to httpd_design_handlers.
+* Added ability to render documents as non-JSON content-types with _show and
+  _list functions, which are also httpd_design_handlers.
+
+Futon Utility Client
+^^^^^^^^^^^^^^^^^^^^
+
+* Added pagination to the database listing page.
+* Implemented attachment uploading from the document page.
+* Added page that shows the current configuration, and allows modification of
+  option values.
+* Added a JSON "source view" for document display.
+* JSON data in view rows is now syntax highlighted.
+* Removed the use of an iframe for better integration with browser history and
+  bookmarking.
+* Full database listing in the sidebar has been replaced by a short list of
+  recent databases.
+* The view editor now allows selection of the view language if there is more
+  than one configured.
+* Added links to go to the raw view or document URI.
+* Added status page to display currently running tasks in CouchDB.
+* JavaScript test suite split into multiple files.
+* Pagination for reduce views.
+
+HTTP Interface
+^^^^^^^^^^^^^^
+
+* Added client side UUIDs for idempotent document creation
+* HTTP COPY for documents
+* Streaming of chunked attachment PUTs to disk
+* Remove negative count feature
+* Add include_docs option for view queries
+* Add multi-key view post for views
+* Query parameter validation
+* Use stale=ok to request potentially cached view index
+* External query handler module for full-text or other indexers.
+* Etags for attachments, views, shows and lists
+* Show and list functions for rendering documents and views as developer
+  controlled content-types.
+* Attachment names may use slashes to allow uploading of nested directories
+  (useful for static web hosting).
+* Option for a view to run over design documents.
+* Added newline to JSON responses. Closes bike-shed.
+
+Replication
+^^^^^^^^^^^
+
+* Using ibrowse.
+* Checkpoint replications so failures are less expensive.
+* Automatically retry of failed replications.
+* Stream attachments in pull-replication.

http://git-wip-us.apache.org/repos/asf/couchdb/blob/4c0241d1/share/doc/src/whatsnew/1.0.rst
----------------------------------------------------------------------
diff --git a/share/doc/src/whatsnew/1.0.rst b/share/doc/src/whatsnew/1.0.rst
new file mode 100644
index 0000000..5354339
--- /dev/null
+++ b/share/doc/src/whatsnew/1.0.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.0.x:
+
+1.0.x Branch
+============
+
+.. contents::
+   :depth: 1
+   :local:
+
+
+.. _release/1.0.4:
+
+Version 1.0.4
+-------------
+
+HTTP Interface
+^^^^^^^^^^^^^^
+
+* Fix missing revisions in ``_changes?style=all_docs``.
+* Fix validation of attachment names.
+
+Log System
+^^^^^^^^^^
+
+* Fix file descriptor leak in ``_log``.
+
+Replicator
+^^^^^^^^^^
+
+* Fix a race condition where replications can go stale
+
+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
+
+View System
+^^^^^^^^^^^
+
+* Avoid invalidating view indexes when running out of file descriptors.
+
+
+.. _release/1.0.3:
+
+Version 1.0.3
+-------------
+
+General
+^^^^^^^
+
+* Fixed compatibility issues with Erlang R14B02.
+
+Etap Test Suite
+^^^^^^^^^^^^^^^
+
+* Etap tests no longer require use of port 5984. They now use a randomly
+  selected port so they won't clash with a running CouchDB.
+
+Futon
+^^^^^
+
+* Made compatible with jQuery 1.5.x.
+
+HTTP Interface
+^^^^^^^^^^^^^^
+
+* Fix bug that allows invalid UTF-8 after valid escapes.
+* The query parameter `include_docs` now honors the parameter `conflicts`.
+  This applies to queries against map views, _all_docs and _changes.
+* Added support for inclusive_end with reduce views.
+
+Replicator
+^^^^^^^^^^
+
+* Enabled replication over IPv6.
+* Fixed for crashes in continuous and filtered changes feeds.
+* Fixed error when restarting replications in OTP R14B02.
+* Upgrade ibrowse to version 2.2.0.
+* Fixed bug when using a filter and a limit of 1.
+
+Security
+^^^^^^^^
+
+* Fixed OAuth signature computation in OTP R14B02.
+* Handle passwords with : in them.
+
+Storage System
+^^^^^^^^^^^^^^
+
+* More performant queries against _changes and _all_docs when using the
+  `include_docs` parameter.
+
+Windows
+^^^^^^^
+
+* Windows builds now require ICU >= 4.4.0 and Erlang >= R14B03. See
+  :issue:`1152`, and :issue:`963` + OTP-9139 for more information.
+
+
+.. _release/1.0.2:
+
+Version 1.0.2
+-------------
+
+Futon
+^^^^^
+
+* Make test suite work with Safari and Chrome.
+* Fixed animated progress spinner.
+* Fix raw view document link due to overzealous URI encoding.
+* Spell javascript correctly in loadScript(uri).
+
+HTTP Interface
+^^^^^^^^^^^^^^
+
+* Allow reduce=false parameter in map-only views.
+* Fix parsing of Accept headers.
+* Fix for multipart GET APIs when an attachment was created during a
+  local-local replication. See :issue:`1022` for details.
+
+Log System
+^^^^^^^^^^
+
+* Reduce lengthy stack traces.
+* Allow logging of native <xml> types.
+
+Replicator
+^^^^^^^^^^
+
+* Updated ibrowse library to 2.1.2 fixing numerous replication issues.
+* Make sure that the replicator respects HTTP settings defined in the config.
+* Fix error when the ibrowse connection closes unexpectedly.
+* Fix authenticated replication (with HTTP basic auth) of design documents
+  with attachments.
+* Various fixes to make replication more resilient for edge-cases.
+
+Storage System
+^^^^^^^^^^^^^^
+
+* Fix leaking file handles after compacting databases and views.
+* Fix databases forgetting their validation function after compaction.
+* Fix occasional timeout errors after successfully compacting large databases.
+* Fix ocassional error when writing to a database that has just been compacted.
+* Fix occasional timeout errors on systems with slow or heavily loaded IO.
+* Fix for OOME when compactions include documents with many conflicts.
+* Fix for missing attachment compression when MIME types included parameters.
+* Preserve purge metadata during compaction to avoid spurious view rebuilds.
+* Fix spurious conflicts introduced when uploading an attachment after
+  a doc has been in a conflict. See :issue:`902` for details.
+* Fix for frequently edited documents in multi-master deployments being
+  duplicated in _changes and _all_docs.  See :issue:`968` for details on how
+  to repair.
+* Significantly higher read and write throughput against database and
+  view index files.
+
+View Server
+^^^^^^^^^^^
+
+* Don't trigger view updates when requesting `_design/doc/_info`.
+* Fix for circular references in CommonJS requires.
+* Made isArray() function available to functions executed in the query server.
+* Documents are now sealed before being passed to map functions.
+* Force view compaction failure when duplicated document data exists. When
+  this error is seen in the logs users should rebuild their views from
+  scratch to fix the issue. See :issue:`999` for details.
+
+
+.. _release/1.0.1:
+
+Version 1.0.1
+-------------
+
+Authentication
+^^^^^^^^^^^^^^
+
+* Enable basic-auth popup when required to access the server, to prevent
+   people from getting locked out.
+
+Build and System Integration
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+* Included additional source files for distribution.
+
+Futon
+^^^^^
+
+* User interface element for querying stale (cached) views.
+
+HTTP Interface
+^^^^^^^^^^^^^^
+
+* Expose `committed_update_seq` for monitoring purposes.
+* Show fields saved along with _deleted=true. Allows for auditing of deletes.
+* More robust Accept-header detection.
+
+Replicator
+^^^^^^^^^^
+
+* Added support for replication via an HTTP/HTTPS proxy.
+* Fix pull replication of attachments from 0.11 to 1.0.x.
+* Make the _changes feed work with non-integer seqnums.
+
+Storage System
+^^^^^^^^^^^^^^
+
+* Fix data corruption bug :issue:`844`. Please see
+  http://couchdb.apache.org/notice/1.0.1.html for details.
+
+
+.. _release/1.0.0:
+
+Version 1.0.0
+-------------
+
+Security
+^^^^^^^^
+
+* Added authentication caching, to avoid repeated opening and closing of the
+  users database for each request requiring authentication.
+
+Storage System
+^^^^^^^^^^^^^^
+
+* Small optimization for reordering result lists.
+* More efficient header commits.
+* Use O_APPEND to save lseeks.
+* Faster implementation of pread_iolist(). Further improves performance on
+  concurrent reads.
+
+View Server
+^^^^^^^^^^^
+
+* Faster default view collation.
+* Added option to include update_seq in view responses.

http://git-wip-us.apache.org/repos/asf/couchdb/blob/4c0241d1/share/doc/src/whatsnew/1.1.rst
----------------------------------------------------------------------
diff --git a/share/doc/src/whatsnew/1.1.rst b/share/doc/src/whatsnew/1.1.rst
new file mode 100644
index 0000000..f733ee9
--- /dev/null
+++ b/share/doc/src/whatsnew/1.1.rst
@@ -0,0 +1,166 @@
+.. 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.1.x:
+
+1.1.x Branch
+============
+
+.. contents::
+   :depth: 1
+   :local:
+
+
+.. _release/1.1.2:
+
+Version 1.1.2
+-------------
+
+Build System
+^^^^^^^^^^^^
+
+* Don't `ln` the `couchjs` install target on Windows
+* Remove ICU version dependency on Windows.
+* Improve SpiderMonkey version detection.
+
+HTTP Interface
+^^^^^^^^^^^^^^
+
+* ETag of attachment changes only when the attachment changes, not
+  the document.
+* Fix retrieval of headers larger than 4k.
+* Allow OPTIONS HTTP method for list requests.
+* Don't attempt to encode invalid json.
+
+Log System
+^^^^^^^^^^
+
+* Improvements to log messages for file-related errors.
+
+Replicator
+^^^^^^^^^^
+
+ * Fix pull replication of documents with many revisions.
+ * Fix replication from an HTTP source to an HTTP target.
+
+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
+
+View Server
+^^^^^^^^^^^
+
+* Avoid invalidating view indexes when running out of file descriptors.
+
+
+.. _release/1.1.1:
+
+Version 1.1.1
+-------------
+
+* Support SpiderMonkey 1.8.5
+* Add configurable maximum to the number of bytes returned by _log.
+* Allow CommonJS modules to be an empty string.
+* Bump minimum Erlang version to R13B02.
+* Do not run deleted validate_doc_update functions.
+* ETags for views include current sequence if include_docs=true.
+* Fix bug where duplicates can appear in _changes feed.
+* Fix bug where update handlers break after conflict resolution.
+* Fix bug with _replicator where include "filter" could crash couch.
+* Fix crashes when compacting large views.
+* Fix file descriptor leak in _log
+* Fix missing revisions in _changes?style=all_docs.
+* Improve handling of compaction at max_dbs_open limit.
+* JSONP responses now send "text/javascript" for Content-Type.
+* Link to ICU 4.2 on Windows.
+* Permit forward slashes in path to update functions.
+* Reap couchjs processes that hit reduce_overflow error.
+* Status code can be specified in update handlers.
+* Support provides() in show functions.
+* _view_cleanup when ddoc has no views now removes all index files.
+* max_replication_retry_count now supports "infinity".
+* Fix replication crash when source database has a document with empty ID.
+* Fix deadlock when assigning couchjs processes to serve requests.
+* Fixes to the document multipart PUT API.
+* Fixes regarding file descriptor leaks for databases with views.
+
+
+.. _release/1.1.0:
+
+Version 1.1.0
+-------------
+
+.. note:: All CHANGES for 1.0.2 and 1.0.3 also apply to 1.1.0.
+
+Externals
+^^^^^^^^^
+
+* Added OS Process module to manage daemons outside of CouchDB.
+* Added HTTP Proxy handler for more scalable externals.
+
+Futon
+^^^^^
+
+* Added a "change password"-feature to Futon.
+
+HTTP Interface
+^^^^^^^^^^^^^^
+
+* Native SSL support.
+* Added support for HTTP range requests for attachments.
+* Added built-in filters for `_changes`: `_doc_ids` and `_design`.
+* Added configuration option for TCP_NODELAY aka "Nagle".
+* Allow POSTing arguments to `_changes`.
+* Allow `keys` parameter for GET requests to views.
+* Allow wildcards in vhosts definitions.
+* More granular ETag support for views.
+* More flexible URL rewriter.
+* Added support for recognizing "Q values" and media parameters in
+  HTTP Accept headers.
+* Validate doc ids that come from a PUT to a URL.
+
+Replicator
+^^^^^^^^^^
+
+* Added `_replicator` database to manage replications.
+* Fixed issues when an endpoint is a remote database accessible via SSL.
+* Added support for continuous by-doc-IDs replication.
+* Fix issue where revision info was omitted when replicating attachments.
+* Integrity of attachment replication is now verified by MD5.
+
+Storage System
+^^^^^^^^^^^^^^
+
+* Multiple micro-optimizations when reading data.
+
+URL Rewriter & Vhosts
+^^^^^^^^^^^^^^^^^^^^^
+
+* Fix for variable substituion
+
+View Server
+^^^^^^^^^^^
+
+* Added CommonJS support to map functions.
+* Added `stale=update_after` query option that triggers a view update after
+  returning a `stale=ok` response.
+* Warn about empty result caused by `startkey` and `endkey` limiting.
+* Built-in reduce function `_sum` now accepts lists of integers as input.
+* Added view query aliases start_key, end_key, start_key_doc_id and
+  end_key_doc_id.

[7/9] git commit: updated refs/heads/1781-reorganize-and-improve-docs to f2a0c93

[kx...@apache.org]

Sort changes by issue number in asc order.

Much more easy to navigate over them in this way.


Project: http://git-wip-us.apache.org/repos/asf/couchdb/repo
Commit: http://git-wip-us.apache.org/repos/asf/couchdb/commit/ace8bcf4
Tree: http://git-wip-us.apache.org/repos/asf/couchdb/tree/ace8bcf4
Diff: http://git-wip-us.apache.org/repos/asf/couchdb/diff/ace8bcf4

Branch: refs/heads/1781-reorganize-and-improve-docs
Commit: ace8bcf43af3743c47d66df2082672afd4226ab9
Parents: 4c0241d
Author: Alexander Shorin <kx...@apache.org>
Authored: Fri Aug 9 02:59:41 2013 +0400
Committer: Alexander Shorin <kx...@apache.org>
Committed: Fri Aug 9 02:59:41 2013 +0400

----------------------------------------------------------------------
 share/doc/src/whatsnew/1.3.rst | 131 ++++++++++++++++++------------------
 1 file changed, 66 insertions(+), 65 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/couchdb/blob/ace8bcf4/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
index 3ef847c..cb14c87 100644
--- a/share/doc/src/whatsnew/1.3.rst
+++ b/share/doc/src/whatsnew/1.3.rst
@@ -55,8 +55,8 @@ Replicator
 Log System
 ^^^^^^^^^^
 
-* Don't log about missing .compact files. :commit:`06f1a8dc`
 * :issue:`1794`: Fix bug in WARN level logging from 1.3.0.
+* Don't log about missing .compact files. :commit:`06f1a8dc`
 
 View Server
 ^^^^^^^^^^^
@@ -67,9 +67,9 @@ View Server
 Miscellaneous
 ^^^^^^^^^^^^^
 
-* Improve documentation: better structure, improve language, less duplication.
 * :issue:`1784`: Improvements to test suite and VPATH build system.
   :commit:`01afaa4f`
+* Improve documentation: better structure, improve language, less duplication.
 
 
 .. _release/1.3.0:
@@ -92,12 +92,12 @@ Documentation
 Futon
 ^^^^^
 
-* :issue:`1470`: Futon raises popup on attempt to navigate to missed/deleted
-  document. :commit:`5da40eef`
+* :issue:`509`: Added view request duration to Futon. :commit:`2d2c7d1e`
+* :issue:`627`: Support all timezones. :commit:`b1a049bb`
 * :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:`1470`: Futon raises popup on attempt to navigate to missed/deleted
+  document. :commit:`5da40eef`
 * :issue:`1473`, :issue:`1472`: Disable buttons for actions that the user
   doesn't have permissions to. :commit:`7156254d`
 
@@ -106,24 +106,19 @@ 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:`764`, :issue:`514`, :issue:`430`: Fix sending HTTP headers from
+  ``_list`` function, :commit:`2a74f88375`
+* :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:`986`: Added Server-Sent Events protocol to db changes API.
+  See http://www.w3.org/TR/eventsource/ for details. :commit:`093d2aa6`
+* :issue:`1026`: Database names are encoded with respect of special characters
+  in the rewriter now. :commit:`272d6415`
+* :issue:`1097`: Allow `OPTIONS` request to shows and lists functions.
+  :commit:`9f53704a`
+* :issue:`1210`: Files starting with underscore can be attached and updated now.
+  :commit:`05858792`
 * :issue:`1277`: Better query parameter support and code clarity:
   :commit:`7e3c69ba`
 
@@ -133,27 +128,32 @@ HTTP Interface
   * ``?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`
+* :issue:`1285`: Allow configuration of vendor and modules version in CouchDB
+  welcome message. :commit:`3c24a94d`
+* :issue:`1321`: Variables in rewrite rules breaks OAuth authentication.
+  :commit:`c307ba95`
+* :issue:`1337`: Use MD5 for attachment ETag header value. :commit:`6d912c9f`
+* :issue:`1381`: Add jquery.couch support for Windows 8 Metro apps.
+  :commit:`dfc5d37c`
+* :issue:`1441`: Limit recursion depth in the URL rewriter.
+  Defaults to a maximum of 100 invocations but is configurable.
+  :commit:`d076976c`
+* :issue:`1442`: No longer rewrites the `X-CouchDB-Requested-Path` during
+  recursive calls to the rewriter. :commit:`56744f2f`
+* :issue:`1501`: :ref:`Changes feed <changes>` now can take special parameter
+  ``since=now`` to emit changes since current point of time. :commit:`3bbb2612`
+* :issue:`1502`: Allow users to delete own _users doc. :commit:`f0d6f19bc8`
+* :issue:`1511`: CouchDB checks `roles` field for `_users` database documents
+  with more care. :commit:`41205000`
+* :issue:`1537`: Include user name in show/list `ETags`. :commit:`ac320479`
 * 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`
+* Add support to serve single file with CouchDB, :commit:`2774531ff2`
 * Allow any 2xx code to indicate success, :commit:`0d50103cfd`
+* Fix `_session` for IE7.
 * Restore 400 error for empty PUT, :commit:`2057b895`
-* Add support to serve single file with CouchDB, :commit:`2774531ff2`
+* Return ``X-Couch-Id`` header if doc is created, :commit:`98515bf0b9`
 * Support auth cookies with ``:`` characters, :commit:`d9566c831d`
 
 Log System
@@ -169,16 +169,16 @@ Log System
 Replicator
 ^^^^^^^^^^
 
-* :issue:`1557`: Upgrade some code to use BIFs bring good improvements for
-  replication.
+* :issue:`1248`: `HTTP 500` error now doesn't occurs when replicating with
+  ``?doc_ids=null``. :commit:`bea76dbf`
+* :issue:`1259`: Stabilize replication id, :commit:`c6252d6d7f`
+* :issue:`1323`: Replicator now acts as standalone application.
+  :commit:`f913ca6e`
 * :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`
+* :issue:`1557`: Upgrade some code to use BIFs bring good improvements for
+  replication.
 
 Security
 ^^^^^^^^
@@ -203,17 +203,18 @@ Storage System
 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:`1321`: Moved the JS test suite to the CLI.
 * :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.
+* :issue:`1339`: Use shell trap to catch dying beam processes during test runs.
+  :commit:`2921c78`
+* :issue:`1389`: Improved tracebacks printed by the JS CLI tests.
+* :issue:`1563`: Ensures urlPrefix is set in all ajax requests.
+  :commit:`07a6af222`
 * Fix race condition for test running on faster hardware.
+* Improved the reliability of a number of tests.
+
 
 URL Rewriter & Vhosts
 ^^^^^^^^^^^^^^^^^^^^^
@@ -229,24 +230,24 @@ UUID Algorithms
 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`
+* :issue:`410`: More graceful error handling for JavaScript validate_doc_update
+  functions.
+* :issue:`1372`: `_stats` builtin reduce function no longer produces error for
+  empty view result.
+* :issue:`1444`: Fix missed_named_view error that occurs on existed design
+  documents and views. :commit:`b59ac98b`
+* :issue:`1445`: CouchDB tries no more to delete view file if it couldn't open
+  it, even if the error is `emfile`.
+* :issue:`1483`: Update handlers requires valid doc ids. :commit:`72ea7e38`
+* :issue:`1491`: Clenaup view tables. :commit:`c37204b7`
 * Deprecate E4X support, :commit:`cdfdda2314`
 
 Windows
 ^^^^^^^
 
-* :issue:`1482`: Use correct linker flang to build `snappy_nif.dll` on Windows.
+* :issue:`1482`: Use correct linker flag to build `snappy_nif.dll` on Windows.
   :commit:`a6eaf9f1`
 * Allows building cleanly on Windows without cURL, :commit:`fb670f5712`

[8/9] git commit: updated refs/heads/1781-reorganize-and-improve-docs to f2a0c93

[kx...@apache.org]

Import breaking changes and upgrade notes from wiki.


Project: http://git-wip-us.apache.org/repos/asf/couchdb/repo
Commit: http://git-wip-us.apache.org/repos/asf/couchdb/commit/925913e3
Tree: http://git-wip-us.apache.org/repos/asf/couchdb/tree/925913e3
Diff: http://git-wip-us.apache.org/repos/asf/couchdb/diff/925913e3

Branch: refs/heads/1781-reorganize-and-improve-docs
Commit: 925913e3aa6d33757805eb815c4c2c13b1ded256
Parents: ace8bcf
Author: Alexander Shorin <kx...@apache.org>
Authored: Fri Aug 9 12:02:51 2013 +0400
Committer: Alexander Shorin <kx...@apache.org>
Committed: Fri Aug 9 12:02:51 2013 +0400

----------------------------------------------------------------------
 share/doc/src/whatsnew/0.10.rst |  74 +++++++++++++----
 share/doc/src/whatsnew/0.11.rst | 152 ++++++++++++++++++++++++++++-------
 share/doc/src/whatsnew/0.8.rst  |  25 +++---
 share/doc/src/whatsnew/0.9.rst  | 112 +++++++++++++++++++++-----
 share/doc/src/whatsnew/1.0.rst  |  89 ++++++++++++--------
 share/doc/src/whatsnew/1.1.rst  |  33 ++++----
 share/doc/src/whatsnew/1.2.rst  |  49 +++++------
 share/doc/src/whatsnew/1.3.rst  |  45 ++++++-----
 share/doc/src/whatsnew/1.4.rst  |   7 +-
 9 files changed, 416 insertions(+), 170 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/couchdb/blob/925913e3/share/doc/src/whatsnew/0.10.rst
----------------------------------------------------------------------
diff --git a/share/doc/src/whatsnew/0.10.rst b/share/doc/src/whatsnew/0.10.rst
index f879052..c628e1f 100644
--- a/share/doc/src/whatsnew/0.10.rst
+++ b/share/doc/src/whatsnew/0.10.rst
@@ -13,6 +13,7 @@
 
 .. _release/0.10.x:
 
+=============
 0.10.x Branch
 =============
 
@@ -21,23 +22,68 @@
    :local:
 
 
+.. _release/0.10.x/upgrade:
+
+Upgrade Notes
+=============
+
+Modular Configuration Directories
+---------------------------------
+
+CouchDB now loads configuration from the following places (`glob(7)`_ syntax)
+in order:
+
+- PREFIX/default.ini
+- PREFIX/default.d/*
+- PREFIX/local.ini
+- PREFIX/local.d/*
+
+The configuration options for `couchdb` script have changed to::
+
+  -a FILE     add configuration FILE to chain
+  -A DIR      add configuration DIR to chain
+  -n          reset configuration file chain (including system default)
+  -c          print configuration file chain and exit
+
+
+.. _glob(7): http://linux.die.net/man/7/glob
+
+Show and List API change
+------------------------
+
+Show and List functions must have a new structure in 0.10.
+See `Formatting_with_Show_and_List_ for details.
+
+.. _Formatting_with_Show_and_List: http://wiki.apache.org/couchdb/Formatting_with_Show_and_List
+
+Stricter enforcing of reduciness in reduce-functions
+----------------------------------------------------
+
+Reduce functions are now required to reduce the number of values for a key.
+
+View query reduce parameter strictness
+--------------------------------------
+
+CouchDB now considers the parameter ``reduce=false`` to be an error for queries
+of map-only views, and responds with status code 400.
+
 .. _release/0.10.2:
 
 Version 0.10.2
---------------
+==============
 
 Build and System Integration
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+----------------------------
 
 * Fixed distribution preparation for building on Mac OS X.
 
 Security
-^^^^^^^^
+--------
 
 * Fixed CVE-2010-0009: Apache CouchDB Timing Attack Vulnerability
 
 Replicator
-^^^^^^^^^^
+----------
 
 * Avoid leaking file descriptors on automatic replication restarts.
 
@@ -45,26 +91,26 @@ Replicator
 .. _release/0.10.1:
 
 Version 0.10.1
---------------
+==============
 
 Build and System Integration
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+----------------------------
 
 * Test suite now works with the distcheck target.
 
 Replicator
-^^^^^^^^^^
+----------
 
 * Stability enhancements regarding redirects, timeouts, OAuth.
 
 Query Server
-^^^^^^^^^^^^
+------------
 
 * Avoid process leaks
 * Allow list and view to span languages
 
 Stats
-^^^^^
+-----
 
 * Eliminate new process flood on system wake
 
@@ -72,27 +118,27 @@ Stats
 .. _release/0.10.0:
 
 Version 0.10.0
---------------
+==============
 
 Build and System Integration
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+----------------------------
 
 * Changed `couchdb` script configuration options.
 * Added default.d and local.d configuration directories to load sequence.
 
 HTTP Interface
-^^^^^^^^^^^^^^
+--------------
 
 * Added optional cookie-based authentication handler.
 * Added optional two-legged OAuth authentication handler.
 
 Storage Format
-^^^^^^^^^^^^^^
+--------------
 
 * Add move headers with checksums to the end of database files for extra robust
   storage and faster storage.
 
 View Server
-^^^^^^^^^^^
+-----------
 
 * Added native Erlang views for high-performance applications.

http://git-wip-us.apache.org/repos/asf/couchdb/blob/925913e3/share/doc/src/whatsnew/0.11.rst
----------------------------------------------------------------------
diff --git a/share/doc/src/whatsnew/0.11.rst b/share/doc/src/whatsnew/0.11.rst
index 549f588..6db258a 100644
--- a/share/doc/src/whatsnew/0.11.rst
+++ b/share/doc/src/whatsnew/0.11.rst
@@ -13,6 +13,7 @@
 
 .. _release/0.11.x:
 
+=============
 0.11.x Branch
 =============
 
@@ -21,28 +22,123 @@
    :local:
 
 
+.. _release/0.11.x/upgrade:
+
+Upgrade Notes
+=============
+
+Changes Between 0.11.0 and 0.11.1
+---------------------------------
+
+- ``_log`` and ``_temp_views`` are now admin-only resources.
+- ``_bulk_docs`` now requires a valid `Content-Type` header of
+  ``application/json``.
+- `JSONP` is disabled by default. An .ini option was added to selectively
+  enable it.
+- The ``key``, ``startkey`` and ``endkey`` properties of the request object
+  passed to :ref:`list <listfun>` and :ref:`show <showfun>` functions now
+  contain JSON objects representing the URL encoded string values in the query
+  string. Previously, these properties contained strings which needed to be
+  converted to JSON before using.
+
+
+Changes Between 0.10.x and 0.11.0
+---------------------------------
+
+show, list, update and validation functions
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+The ``req`` argument to show, list, update and validation functions now contains
+the member method with the specified HTTP method of the current request.
+Previously, this member was called ``verb``. ``method`` is following :rfc:`2616`
+(HTTP 1.1) closer.
+
+_admins -> _security
+^^^^^^^^^^^^^^^^^^^^
+
+The `/db/_admins` handler has been removed and replaced with a
+:ref:`/db/_security <api/db/security>` object. Any existing `_admins` will be
+dropped and need to be added to the security object again. The reason for this
+is that the old system made no distinction between names and roles, while the
+new one does, so there is no way to automatically upgrade the old admins list.
+
+The security object has 2 special fields, ``admins`` and ``readers``, which
+contain lists of names and roles which are admins or readers on that database.
+Anything else may be stored in other fields on the security object. The entire
+object is made available to validation functions.
+
+json2.js
+^^^^^^^^
+
+JSON handling in the query server has been upgraded to use `json2.js`_.
+This allows us to use faster native JSON serialization when it is available.
+
+In previous versions, attempts to serialize undefined would throw an exception,
+causing the doc that emitted undefined to be dropped from the view index.
+The new behavior is to serialize undefined as null. Applications depending on
+the old behavior will need to explicitly check for undefined.
+
+Another change is that E4X's XML objects will not automatically be
+stringified. XML users will need to call ``my_xml_object.toXMLString()``
+to return a string value. :commit:`8d3b7ab3`
+
+.. _json2.js: https://github.com/douglascrockford/JSON-js/blob/master/json2.js
+
+
+WWW-Authenticate
+^^^^^^^^^^^^^^^^
+
+The default configuration has been changed to avoid causing basic-auth popups
+which result from sending the WWW-Authenticate header. To enable basic-auth
+popups, uncomment the :ref:`WWW-Authenticate <config/httpd/WWW-Authenticate>`
+line in `local.ini`.
+
+Query server line protocol
+^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+The query server line protocol has changed for all functions except
+:ref:`map <qs/map_doc>`, :ref:`reduce <qs/reduce>`, and
+:ref:`rereduce <qs/rereduce>`. This allows us to cache the entire design
+document in the query server process, which results in faster performance for
+common operations. It also gives more flexibility to query server
+implementators and shouldn't require major changes in the future when adding
+new query server features.
+
+UTF8 JSON
+^^^^^^^^^
+
+JSON request bodies are validated for proper UTF-8 before saving, instead of
+waiting to fail on subsequent read requests.
+
+_changes line format
+^^^^^^^^^^^^^^^^^^^^
+
+Continuous changes are now newline delimited, instead of having each line
+followed by a comma.
+
+
 .. _release/0.11.2:
 
 Version 0.11.2
---------------
+==============
 
 Authentication
-^^^^^^^^^^^^^^
+--------------
 
 * User documents can now be deleted by admins or the user.
 
 Futon
-^^^^^
+-----
 
 * Add some Futon files that were missing from the Makefile.
 
 HTTP Interface
-^^^^^^^^^^^^^^
+--------------
 
 * Better error messages on invalid URL requests.
 
 Replicator
-^^^^^^^^^^
+----------
 
 * Fix bug when pushing design docs by non-admins, which was hanging the
   replicator for no good reason.
@@ -50,7 +146,7 @@ Replicator
   basic-auth.
 
 Security
-^^^^^^^^
+--------
 
 * Avoid potential DOS attack by guarding all creation of atoms.
 * Fixed CVE-2010-2234: Apache CouchDB Cross Site Request Forgery Attack
@@ -59,10 +155,10 @@ Security
 .. _release/0.11.1:
 
 Version 0.11.1
---------------
+==============
 
 Build and System Integration
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+----------------------------
 
 * Output of `couchdb --help` has been improved.
 * Fixed compatibility with the Erlang R14 series.
@@ -72,12 +168,12 @@ Build and System Integration
 * Fixed compatibility with Solaris.
 
 Configuration System
-^^^^^^^^^^^^^^^^^^^^
+--------------------
 
 * Fixed timeout with large .ini files.
 
 Futon
-^^^^^
+-----
 
 * Use "expando links" for over-long document values in Futon.
 * Added continuous replication option.
@@ -88,7 +184,7 @@ Futon
 * Fixed various UI issues.
 
 HTTP Interface
-^^^^^^^^^^^^^^
+--------------
 
 * Mask passwords in active tasks and logging.
 * Update mochijson2 to allow output of BigNums not in float form.
@@ -101,7 +197,7 @@ HTTP Interface
 * Send newly generated document rev to callers of an update function.
 
 JavaScript Clients
-^^^^^^^^^^^^^^^^^^
+------------------
 
 * Added tests for couch.js and jquery.couch.js
 * Added changes handler to jquery.couch.js.
@@ -113,21 +209,21 @@ JavaScript Clients
 * Fixed issues where bulkSave() wasn't sending a POST body.
 
 Log System
-^^^^^^^^^^
+----------
 
 * Log HEAD requests as HEAD, not GET.
 * Keep massive JSON blobs out of the error log.
 * Fixed a timeout issue.
 
 Replication System
-^^^^^^^^^^^^^^^^^^
+------------------
 
 * Refactored various internal APIs related to attachment streaming.
 * Fixed hanging replication.
 * Fixed keepalive issue.
 
 Security
-^^^^^^^^
+--------
 
 * Added authentication redirect URL to log in clients.
 * Fixed query parameter encoding issue in oauth.js.
@@ -135,7 +231,7 @@ Security
 * Temporary views are now admin-only resources.
 
 Storage System
-^^^^^^^^^^^^^^
+--------------
 
 * Don't require a revpos for attachment stubs.
 * Added checking to ensure when a revpos is sent with an attachment stub,
@@ -147,12 +243,12 @@ Storage System
 * Preserve _revs_limit and instance_start_time after compaction.
 
 Test Suite
-^^^^^^^^^^
+----------
 
 * Made the test suite overall more reliable.
 
 View Server
-^^^^^^^^^^^
+-----------
 
 * Provide a UUID to update functions (and all other functions) that they can
   use to create new docs.
@@ -161,7 +257,7 @@ View Server
 * Fixed hang in view shutdown.
 
 URL Rewriter & Vhosts
-^^^^^^^^^^^^^^^^^^^^^
+---------------------
 
 * Allow more complex keys in rewriter.
 * Allow global rewrites so system defaults are available in vhosts.
@@ -172,10 +268,10 @@ URL Rewriter & Vhosts
 .. _release/0.11.0:
 
 Version 0.11.0
---------------
+==============
 
 Build and System Integration
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+----------------------------
 
 * Updated and improved source documentation.
 * Fixed distribution preparation for building on Mac OS X.
@@ -187,7 +283,7 @@ Build and System Integration
   http://ci.apache.org/buildbot.html
 
 Futon
-^^^^^
+-----
 
 * Added a button for view compaction.
 * JSON strings are now displayed as-is in the document view, without the
@@ -201,14 +297,14 @@ Futon
 * Fixed some font declarations.
 
 HTTP Interface
-^^^^^^^^^^^^^^
+--------------
 
 * Provide Content-MD5 header support for attachments.
 * Added URL Rewriter handler.
 * Added virtual host handling.
 
 Replication
-^^^^^^^^^^^
+-----------
 
 * Added option to implicitly create replication target databases.
 * Avoid leaking file descriptors on automatic replication restarts.
@@ -216,7 +312,7 @@ Replication
 * Allow continuous replication to be cancelled.
 
 Runtime Statistics
-^^^^^^^^^^^^^^^^^^
+------------------
 
 * Statistics are now calculated for a moving window instead of non-overlapping
   timeframes.
@@ -224,7 +320,7 @@ Runtime Statistics
 * Moved statistic names to a term file in the priv directory.
 
 Security
-^^^^^^^^
+--------
 
 * Fixed CVE-2010-0009: Apache CouchDB Timing Attack Vulnerability.
 * Added default cookie-authentication and users database.
@@ -235,14 +331,14 @@ Security
 * Added proxy authentication handler
 
 Storage System
-^^^^^^^^^^^^^^
+--------------
 
 * Adds batching of multiple updating requests, to improve throughput with many
   writers. Removed the now redundant couch_batch_save module.
 * Adds configurable compression of attachments.
 
 View Server
-^^^^^^^^^^^
+-----------
 
 * Added optional 'raw' binary collation for faster view builds where Unicode
   collation is not important.

http://git-wip-us.apache.org/repos/asf/couchdb/blob/925913e3/share/doc/src/whatsnew/0.8.rst
----------------------------------------------------------------------
diff --git a/share/doc/src/whatsnew/0.8.rst b/share/doc/src/whatsnew/0.8.rst
index 0819fd7..a7cd5fe 100644
--- a/share/doc/src/whatsnew/0.8.rst
+++ b/share/doc/src/whatsnew/0.8.rst
@@ -13,6 +13,7 @@
 
 .. _release/0.8.x:
 
+============
 0.8.x Branch
 ============
 
@@ -24,10 +25,10 @@
 .. _release/0.8.1:
 
 Version 0.8.1-incubating
-------------------------
+========================
 
 Build and System Integration
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+----------------------------
 
 * The `couchdb` script no longer uses `awk` for configuration checks as this
   was causing portability problems.
@@ -35,7 +36,7 @@ Build and System Integration
   problems when invoking from a directory the `couchdb` user cannot access.
 
 Database Core
-^^^^^^^^^^^^^
+-------------
 
 * Fix for replication problems where the write queues can get backed up if the
   writes aren't happening fast enough to keep up with the reads. For a large
@@ -47,13 +48,13 @@ Database Core
   implementation. This means better replication stability.
 
 Futon
-^^^^^
+-----
 
 * The view selector dropdown should now work in Opera and Internet Explorer
   even when it includes optgroups for design documents. (:issue:`81`)
 
 JavaScript View Server
-^^^^^^^^^^^^^^^^^^^^^^
+----------------------
 
 * Sealing of documents has been disabled due to an incompatibility with
   SpiderMonkey 1.9.
@@ -61,7 +62,7 @@ JavaScript View Server
   (:issue:`83`)
 
 HTTP Interface
-^^^^^^^^^^^^^^
+--------------
 
 * Fix for chunked responses where chunks were always being split into multiple
   TCP packets, which caused problems with the test suite under Safari, and in
@@ -77,10 +78,10 @@ HTTP Interface
 .. _release/0.8.0:
 
 Version 0.8.0-incubating
-------------------------
+========================
 
 Build and System Integration
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+----------------------------
 
 * CouchDB can automatically respawn following a server crash.
 * Database server no longer refuses to start with a stale PID file.
@@ -91,7 +92,7 @@ Build and System Integration
 * The build and system integration have been improved for portability.
 
 Database Core
-^^^^^^^^^^^^^
+-------------
 
 * The view engine has been completely decoupled from the storage engine. Index
   data is now stored in separate files, and the format of the main database
@@ -110,7 +111,7 @@ Database Core
   renamed to `content_type` (underscore).
 
 Futon
-^^^^^
+-----
 
 * When adding a field to a document, Futon now just adds a field with an
   autogenerated name instead of prompting for the name with a dialog. The name
@@ -133,7 +134,7 @@ Futon
 * The JavaScript Shell has been removed due to unresolved licensing issues.
 
 JavaScript View Server
-^^^^^^^^^^^^^^^^^^^^^^
+----------------------
 
 * SpiderMonkey is no longer included with CouchDB, but rather treated as a
   normal external dependency. A simple C program (`_couchjs`) is provided that
@@ -147,7 +148,7 @@ JavaScript View Server
 * Fixed handling of exceptions raised by view functions.
 
 HTTP Interface
-^^^^^^^^^^^^^^
+--------------
 
 * CouchDB now uses MochiWeb instead of inets for the HTTP server
   implementation. Among other things, this means that the extra configuration

http://git-wip-us.apache.org/repos/asf/couchdb/blob/925913e3/share/doc/src/whatsnew/0.9.rst
----------------------------------------------------------------------
diff --git a/share/doc/src/whatsnew/0.9.rst b/share/doc/src/whatsnew/0.9.rst
index caba761..65b5d38 100644
--- a/share/doc/src/whatsnew/0.9.rst
+++ b/share/doc/src/whatsnew/0.9.rst
@@ -13,6 +13,7 @@
 
 .. _release/0.9.x:
 
+============
 0.9.x Branch
 ============
 
@@ -21,19 +22,90 @@
    :local:
 
 
+.. _release/0.9.x/upgrade:
+
+Upgrade Notes
+=============
+
+Response to Bulk Creation/Updates
+---------------------------------
+
+The response to a bulk creation / update now looks like this
+
+.. code-block:: javascript
+
+  [
+      {"id": "0", "rev": "3682408536"},
+      {"id": "1", "rev": "3206753266"},
+      {"id": "2", "error": "conflict", "reason": "Document update conflict."}
+  ]
+
+Database File Format
+--------------------
+
+The database file format has changed. CouchDB itself does yet not provide any
+tools for migrating your data. In the meantime, you can use third-party scripts
+to deal with the migration, such as the dump/load tools that come with the
+development version (trunk) of `couchdb-python`_.
+
+.. _couchdb-python: http://code.google.com/p/couchdb-python/
+
+Renamed "count" to "limit"
+--------------------------
+
+The view query API has been changed: ``count`` has become ``limit``.
+This is a better description of what the parameter does, and should be a simple
+update in any client code.
+
+Moved View URLs
+---------------
+
+The view URLs have been moved to design document resources. This means that
+paths that used to be like http://hostname:5984/mydb/_view/designname/viewname?limit=10
+will now look like http://hostname:5984/mydb/_design/designname/_view/viewname?limit=10.
+See the `REST, Hypermedia, and CouchApps`_  thread on dev for details.
+
+.. _REST, Hypermedia, and CouchApps: http://mail-archives.apache.org/mod_mbox/couchdb-dev/200902.mbox/%3Ce282921e0902242116n2cd207c4x7a9d0feced3f10d9@mail.gmail.com%3E
+
+Attachments
+-----------
+
+Names of attachments are no longer allowed to start with an underscore.
+
+Error Codes
+-----------
+
+Some refinements have been made to error handling. CouchDB will send 400 instead
+of 500 on invalid query parameters. Most notably, document update conflicts now
+respond with `409 Conflict` instead of `412 Precondition Failed`. The error code
+for when attempting to create a database that already exists is now 412
+instead of 409.
+
+ini file format
+---------------
+
+CouchDB 0.9 changes sections and configuration variable names in configuration
+files. Old .ini files won't work. Also note that CouchDB now ships with two .ini
+files where 0.8 used couch.ini there are now `default.ini` and `local.ini`.
+`default.ini` contains CouchDB's standard configuration values. local.ini is
+meant for local changes. `local.ini` is not overwritten on CouchDB updates, so
+your edits are safe. In addition, the new runtime configuration system persists
+changes to the configuration in `local.ini`.
+
+
 .. _release/0.9.2:
 
 Version 0.9.2
--------------
+=============
 
 Build and System Integration
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+----------------------------
 
 * Remove branch callbacks to allow building couchjs against newer versions of
   Spidermonkey.
 
 Replication
-^^^^^^^^^^^
+-----------
 
 * Fix replication with 0.10 servers initiated by an 0.9 server (:issue:`559`).
 
@@ -41,10 +113,10 @@ Replication
 .. _release/0.9.1:
 
 Version 0.9.1
--------------
+=============
 
 Build and System Integration
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+----------------------------
 
 * PID file directory is now created by the SysV/BSD daemon scripts.
 * Fixed the environment variables shown by the configure script.
@@ -52,13 +124,13 @@ Build and System Integration
 * Updated ownership and permission advice in `README` for better security.
 
 Configuration and stats system
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+------------------------------
 
 * Corrected missing configuration file error message.
 * Fixed incorrect recording of request time.
 
 Database Core
-^^^^^^^^^^^^^
+-------------
 
 * Document validation for underscore prefixed variables.
 * Made attachment storage less sparse.
@@ -66,27 +138,27 @@ Database Core
   idle, and subject to losing changes when shutdown. (:issue:`334`)
 
 External Handlers
-^^^^^^^^^^^^^^^^^
+-----------------
 
 * Fix POST requests.
 
 Futon
-^^^^^
+-----
 
 * Redirect when loading a deleted view URI from the cookie.
 
 HTTP Interface
-^^^^^^^^^^^^^^
+--------------
 
 * Attachment requests respect the "rev" query-string parameter.
 
 JavaScript View Server
-^^^^^^^^^^^^^^^^^^^^^^
+----------------------
 
 * Useful JavaScript Error messages.
 
 Replication
-^^^^^^^^^^^
+-----------
 
 * Added support for Unicode characters transmitted as UTF-16 surrogate pairs.
 * URL-encode attachment names when necessary.
@@ -99,10 +171,10 @@ Replication
 .. _release/0.9.0:
 
 Version 0.9.0
--------------
+=============
 
 Build and System Integration
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+----------------------------
 
 * The `couchdb` script now supports system chainable configuration files.
 * The Mac OS X daemon script now redirects STDOUT and STDERR like SysV/BSD.
@@ -116,14 +188,14 @@ Build and System Integration
 * Created dev target for make.
 
 Configuration and stats system
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+------------------------------
 
 * Separate default and local configuration files.
 * HTTP interface for configuration changes.
 * Statistics framework with HTTP query API.
 
 Database Core
-^^^^^^^^^^^^^
+-------------
 
 * Faster B-tree implementation.
 * Changed internal JSON term format.
@@ -134,7 +206,7 @@ Database Core
 * Ref-counting for database file handles.
 
 Design Document Resource Paths
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+------------------------------
 
 * Added httpd_design_handlers config section.
 * Moved _view to httpd_design_handlers.
@@ -142,7 +214,7 @@ Design Document Resource Paths
   _list functions, which are also httpd_design_handlers.
 
 Futon Utility Client
-^^^^^^^^^^^^^^^^^^^^
+--------------------
 
 * Added pagination to the database listing page.
 * Implemented attachment uploading from the document page.
@@ -162,7 +234,7 @@ Futon Utility Client
 * Pagination for reduce views.
 
 HTTP Interface
-^^^^^^^^^^^^^^
+--------------
 
 * Added client side UUIDs for idempotent document creation
 * HTTP COPY for documents
@@ -182,7 +254,7 @@ HTTP Interface
 * Added newline to JSON responses. Closes bike-shed.
 
 Replication
-^^^^^^^^^^^
+-----------
 
 * Using ibrowse.
 * Checkpoint replications so failures are less expensive.

http://git-wip-us.apache.org/repos/asf/couchdb/blob/925913e3/share/doc/src/whatsnew/1.0.rst
----------------------------------------------------------------------
diff --git a/share/doc/src/whatsnew/1.0.rst b/share/doc/src/whatsnew/1.0.rst
index 5354339..4ec9a2f 100644
--- a/share/doc/src/whatsnew/1.0.rst
+++ b/share/doc/src/whatsnew/1.0.rst
@@ -13,6 +13,7 @@
 
 .. _release/1.0.x:
 
+============
 1.0.x Branch
 ============
 
@@ -21,29 +22,51 @@
    :local:
 
 
+.. _release/1.0.x/upgrade:
+
+Upgrade Notes
+=============
+
+Note, to replicate with a 1.0 CouchDB instance you must first upgrade in-place
+your current CouchDB to 1.0 or 0.11.1 -- backporting so that 0.10.x can
+replicate to 1.0 wouldn't be that hard. All that is required is patching the
+replicator to use the ``application/json`` content type.
+
+- ``_log`` and ``_temp_views`` are now admin-only resources.
+- ``_bulk_docs`` now requires a valid `Content-Type` header of
+  ``application/json``.
+- `JSONP` is disabled by default. An .ini option was added to selectively
+  enable it.
+- The ``key``, ``startkey`` and ``endkey`` properties of the request object
+  passed to :ref:`list <listfun>` and :ref:`show <showfun>` functions now
+  contain JSON objects representing the URL encoded string values in the query
+  string. Previously, these properties contained strings which needed to be
+  converted to JSON before using.
+
+
 .. _release/1.0.4:
 
 Version 1.0.4
--------------
+=============
 
 HTTP Interface
-^^^^^^^^^^^^^^
+--------------
 
 * Fix missing revisions in ``_changes?style=all_docs``.
 * Fix validation of attachment names.
 
 Log System
-^^^^^^^^^^
+----------
 
 * Fix file descriptor leak in ``_log``.
 
 Replicator
-^^^^^^^^^^
+----------
 
 * Fix a race condition where replications can go stale
 
 Security
-^^^^^^^^
+--------
 
 * Fixed CVE-2012-5641: Apache CouchDB Information disclosure via unescaped
   backslashes in URLs on Windows
@@ -53,7 +76,7 @@ Security
   UI
 
 View System
-^^^^^^^^^^^
+-----------
 
 * Avoid invalidating view indexes when running out of file descriptors.
 
@@ -61,26 +84,26 @@ View System
 .. _release/1.0.3:
 
 Version 1.0.3
--------------
+=============
 
 General
-^^^^^^^
+-------
 
 * Fixed compatibility issues with Erlang R14B02.
 
 Etap Test Suite
-^^^^^^^^^^^^^^^
+---------------
 
 * Etap tests no longer require use of port 5984. They now use a randomly
   selected port so they won't clash with a running CouchDB.
 
 Futon
-^^^^^
+-----
 
 * Made compatible with jQuery 1.5.x.
 
 HTTP Interface
-^^^^^^^^^^^^^^
+--------------
 
 * Fix bug that allows invalid UTF-8 after valid escapes.
 * The query parameter `include_docs` now honors the parameter `conflicts`.
@@ -88,7 +111,7 @@ HTTP Interface
 * Added support for inclusive_end with reduce views.
 
 Replicator
-^^^^^^^^^^
+----------
 
 * Enabled replication over IPv6.
 * Fixed for crashes in continuous and filtered changes feeds.
@@ -97,19 +120,19 @@ Replicator
 * Fixed bug when using a filter and a limit of 1.
 
 Security
-^^^^^^^^
+--------
 
 * Fixed OAuth signature computation in OTP R14B02.
 * Handle passwords with : in them.
 
 Storage System
-^^^^^^^^^^^^^^
+--------------
 
 * More performant queries against _changes and _all_docs when using the
   `include_docs` parameter.
 
 Windows
-^^^^^^^
+-------
 
 * Windows builds now require ICU >= 4.4.0 and Erlang >= R14B03. See
   :issue:`1152`, and :issue:`963` + OTP-9139 for more information.
@@ -118,10 +141,10 @@ Windows
 .. _release/1.0.2:
 
 Version 1.0.2
--------------
+=============
 
 Futon
-^^^^^
+-----
 
 * Make test suite work with Safari and Chrome.
 * Fixed animated progress spinner.
@@ -129,7 +152,7 @@ Futon
 * Spell javascript correctly in loadScript(uri).
 
 HTTP Interface
-^^^^^^^^^^^^^^
+--------------
 
 * Allow reduce=false parameter in map-only views.
 * Fix parsing of Accept headers.
@@ -137,13 +160,13 @@ HTTP Interface
   local-local replication. See :issue:`1022` for details.
 
 Log System
-^^^^^^^^^^
+----------
 
 * Reduce lengthy stack traces.
 * Allow logging of native <xml> types.
 
 Replicator
-^^^^^^^^^^
+----------
 
 * Updated ibrowse library to 2.1.2 fixing numerous replication issues.
 * Make sure that the replicator respects HTTP settings defined in the config.
@@ -153,7 +176,7 @@ Replicator
 * Various fixes to make replication more resilient for edge-cases.
 
 Storage System
-^^^^^^^^^^^^^^
+--------------
 
 * Fix leaking file handles after compacting databases and views.
 * Fix databases forgetting their validation function after compaction.
@@ -172,7 +195,7 @@ Storage System
   view index files.
 
 View Server
-^^^^^^^^^^^
+-----------
 
 * Don't trigger view updates when requesting `_design/doc/_info`.
 * Fix for circular references in CommonJS requires.
@@ -186,40 +209,40 @@ View Server
 .. _release/1.0.1:
 
 Version 1.0.1
--------------
+=============
 
 Authentication
-^^^^^^^^^^^^^^
+--------------
 
 * Enable basic-auth popup when required to access the server, to prevent
    people from getting locked out.
 
 Build and System Integration
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+----------------------------
 
 * Included additional source files for distribution.
 
 Futon
-^^^^^
+-----
 
 * User interface element for querying stale (cached) views.
 
 HTTP Interface
-^^^^^^^^^^^^^^
+--------------
 
 * Expose `committed_update_seq` for monitoring purposes.
 * Show fields saved along with _deleted=true. Allows for auditing of deletes.
 * More robust Accept-header detection.
 
 Replicator
-^^^^^^^^^^
+----------
 
 * Added support for replication via an HTTP/HTTPS proxy.
 * Fix pull replication of attachments from 0.11 to 1.0.x.
 * Make the _changes feed work with non-integer seqnums.
 
 Storage System
-^^^^^^^^^^^^^^
+--------------
 
 * Fix data corruption bug :issue:`844`. Please see
   http://couchdb.apache.org/notice/1.0.1.html for details.
@@ -228,16 +251,16 @@ Storage System
 .. _release/1.0.0:
 
 Version 1.0.0
--------------
+=============
 
 Security
-^^^^^^^^
+--------
 
 * Added authentication caching, to avoid repeated opening and closing of the
   users database for each request requiring authentication.
 
 Storage System
-^^^^^^^^^^^^^^
+--------------
 
 * Small optimization for reordering result lists.
 * More efficient header commits.
@@ -246,7 +269,7 @@ Storage System
   concurrent reads.
 
 View Server
-^^^^^^^^^^^
+-----------
 
 * Faster default view collation.
 * Added option to include update_seq in view responses.

http://git-wip-us.apache.org/repos/asf/couchdb/blob/925913e3/share/doc/src/whatsnew/1.1.rst
----------------------------------------------------------------------
diff --git a/share/doc/src/whatsnew/1.1.rst b/share/doc/src/whatsnew/1.1.rst
index f733ee9..4a78300 100644
--- a/share/doc/src/whatsnew/1.1.rst
+++ b/share/doc/src/whatsnew/1.1.rst
@@ -13,6 +13,7 @@
 
 .. _release/1.1.x:
 
+============
 1.1.x Branch
 ============
 
@@ -24,17 +25,17 @@
 .. _release/1.1.2:
 
 Version 1.1.2
--------------
+=============
 
 Build System
-^^^^^^^^^^^^
+------------
 
 * Don't `ln` the `couchjs` install target on Windows
 * Remove ICU version dependency on Windows.
 * Improve SpiderMonkey version detection.
 
 HTTP Interface
-^^^^^^^^^^^^^^
+--------------
 
 * ETag of attachment changes only when the attachment changes, not
   the document.
@@ -43,18 +44,18 @@ HTTP Interface
 * Don't attempt to encode invalid json.
 
 Log System
-^^^^^^^^^^
+----------
 
 * Improvements to log messages for file-related errors.
 
 Replicator
-^^^^^^^^^^
+----------
 
  * Fix pull replication of documents with many revisions.
  * Fix replication from an HTTP source to an HTTP target.
 
 Security
-^^^^^^^^
+--------
 
 * Fixed CVE-2012-5641: Apache CouchDB Information disclosure via unescaped
   backslashes in URLs on Windows
@@ -64,7 +65,7 @@ Security
   UI
 
 View Server
-^^^^^^^^^^^
+-----------
 
 * Avoid invalidating view indexes when running out of file descriptors.
 
@@ -72,7 +73,7 @@ View Server
 .. _release/1.1.1:
 
 Version 1.1.1
--------------
+=============
 
 * Support SpiderMonkey 1.8.5
 * Add configurable maximum to the number of bytes returned by _log.
@@ -104,23 +105,23 @@ Version 1.1.1
 .. _release/1.1.0:
 
 Version 1.1.0
--------------
+=============
 
 .. note:: All CHANGES for 1.0.2 and 1.0.3 also apply to 1.1.0.
 
 Externals
-^^^^^^^^^
+---------
 
 * Added OS Process module to manage daemons outside of CouchDB.
 * Added HTTP Proxy handler for more scalable externals.
 
 Futon
-^^^^^
+-----
 
 * Added a "change password"-feature to Futon.
 
 HTTP Interface
-^^^^^^^^^^^^^^
+--------------
 
 * Native SSL support.
 * Added support for HTTP range requests for attachments.
@@ -136,7 +137,7 @@ HTTP Interface
 * Validate doc ids that come from a PUT to a URL.
 
 Replicator
-^^^^^^^^^^
+----------
 
 * Added `_replicator` database to manage replications.
 * Fixed issues when an endpoint is a remote database accessible via SSL.
@@ -145,17 +146,17 @@ Replicator
 * Integrity of attachment replication is now verified by MD5.
 
 Storage System
-^^^^^^^^^^^^^^
+--------------
 
 * Multiple micro-optimizations when reading data.
 
 URL Rewriter & Vhosts
-^^^^^^^^^^^^^^^^^^^^^
+---------------------
 
 * Fix for variable substituion
 
 View Server
-^^^^^^^^^^^
+-----------
 
 * Added CommonJS support to map functions.
 * Added `stale=update_after` query option that triggers a view update after

http://git-wip-us.apache.org/repos/asf/couchdb/blob/925913e3/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
index fe6a918..3d6620d 100644
--- a/share/doc/src/whatsnew/1.2.rst
+++ b/share/doc/src/whatsnew/1.2.rst
@@ -13,6 +13,7 @@
 
 .. _release/1.2.x:
 
+============
 1.2.x Branch
 ============
 
@@ -21,8 +22,10 @@
    :local:
 
 
+.. _release/1.2.x/upgrade:
+
 Upgrade Notes
--------------
+=============
 
 .. warning::
 
@@ -31,7 +34,7 @@ Upgrade Notes
    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:
@@ -53,7 +56,7 @@ changed so that non-administrator users can see less information:
   * 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
@@ -69,16 +72,16 @@ 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.
@@ -87,21 +90,21 @@ HTTP Interface
 .. _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.
@@ -109,7 +112,7 @@ HTTP Interface
   of 100 invocations but is configurable.
 
 Security
-^^^^^^^^
+--------
 
 * Fixed CVE-2012-5641: Apache CouchDB Information disclosure via unescaped
   backslashes in URLs on Windows
@@ -119,12 +122,12 @@ Security
   UI
 
 Replication
-^^^^^^^^^^^
+-----------
 
 * Fix potential timeouts.
 
 View Server
-^^^^^^^^^^^
+-----------
 
 * Change use of signals to avoid broken view groups.
 
@@ -132,10 +135,10 @@ View Server
 .. _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
@@ -154,7 +157,7 @@ Authentication
   `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
@@ -166,7 +169,7 @@ Build System
 * Added --with-js-lib-name option.
 
 Futon
-^^^^^
+-----
 
 * The `Status` screen (active tasks) now displays two new task status
   fields: `Started on` and `Updated on`.
@@ -174,7 +177,7 @@ Futon
   edit that amounts to a revert.
 
 HTTP Interface
-^^^^^^^^^^^^^^
+--------------
 
 * Added a native JSON parser.
 * The _active_tasks API now offers more granular fields. Each
@@ -186,12 +189,12 @@ HTTP Interface
 * 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.
@@ -206,7 +209,7 @@ Replicator
   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
@@ -226,7 +229,7 @@ Storage System
   and `_design`.
 
 View Server
-^^^^^^^^^^^
+-----------
 
 * Add CoffeeScript (http://coffeescript.org/) as a first class view server
   language.
@@ -235,5 +238,3 @@ View Server
   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/925913e3/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
index cb14c87..7e69785 100644
--- a/share/doc/src/whatsnew/1.3.rst
+++ b/share/doc/src/whatsnew/1.3.rst
@@ -13,6 +13,7 @@
 
 .. _release/1.3.x:
 
+============
 1.3.x Branch
 ============
 
@@ -21,8 +22,10 @@
    :local:
 
 
+.. _release/1.3.x/upgrade:
+
 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
@@ -44,28 +47,28 @@ CouchDB 1.0.x release.
 .. _release/1.3.1:
 
 Version 1.3.1
--------------
+=============
 
 Replicator
-^^^^^^^^^^
+----------
 
 * :issue:`1788`: Tolerate missing source and target fields in _replicator docs.
   :commit:`869f42e2`
 
 Log System
-^^^^^^^^^^
+----------
 
 * :issue:`1794`: Fix bug in WARN level logging from 1.3.0.
 * Don't log about missing .compact files. :commit:`06f1a8dc`
 
 View Server
-^^^^^^^^^^^
+-----------
 
 * :issue:`1792`: Fix the -S option to couchjs to increase memory limits.
   :commit:`cfaa66cd`
 
 Miscellaneous
-^^^^^^^^^^^^^
+-------------
 
 * :issue:`1784`: Improvements to test suite and VPATH build system.
   :commit:`01afaa4f`
@@ -75,22 +78,22 @@ Miscellaneous
 .. _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:`509`: Added view request duration to Futon. :commit:`2d2c7d1e`
 * :issue:`627`: Support all timezones. :commit:`b1a049bb`
@@ -102,7 +105,7 @@ Futon
   doesn't have permissions to. :commit:`7156254d`
 
 HTTP Interface
-^^^^^^^^^^^^^^
+--------------
 
 * :issue:`431`: Introduce experimental :ref:`CORS support <cors>`.
   :commit:`b90e4021`
@@ -157,7 +160,7 @@ HTTP Interface
 * 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`
@@ -167,7 +170,7 @@ Log System
   system dbs, :commit:`41667642f7`
 
 Replicator
-^^^^^^^^^^
+----------
 
 * :issue:`1248`: `HTTP 500` error now doesn't occurs when replicating with
   ``?doc_ids=null``. :commit:`bea76dbf`
@@ -181,13 +184,13 @@ Replicator
   replication.
 
 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`_.
 
@@ -195,13 +198,13 @@ Source Repository
 .. _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:`1321`: Moved the JS test suite to the CLI.
 * :issue:`1338`: Start CouchDB with ``port=0``. While CouchDB might be already
@@ -217,18 +220,18 @@ Test Suite
 
 
 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:`111`: Improve the errors reported by the javascript view server
   to provide a more friendly error report when something goes wrong.
@@ -246,7 +249,7 @@ Query and View Server
 * Deprecate E4X support, :commit:`cdfdda2314`
 
 Windows
-^^^^^^^
+-------
 
 * :issue:`1482`: Use correct linker flag to build `snappy_nif.dll` on Windows.
   :commit:`a6eaf9f1`

http://git-wip-us.apache.org/repos/asf/couchdb/blob/925913e3/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
index 7c7d29b..06577f6 100644
--- a/share/doc/src/whatsnew/1.4.rst
+++ b/share/doc/src/whatsnew/1.4.rst
@@ -13,6 +13,7 @@
 
 .. _release/1.4.x:
 
+============
 1.4.x Branch
 ============
 
@@ -21,8 +22,10 @@
    :local:
 
 
+.. _release/1.4.x/upgrade:
+
 Upgrade Notes
--------------
+=============
 
 We now support Erlang/OTP R16B and R16B01; the minimum required version is R14B.
 
@@ -33,7 +36,7 @@ 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`

[9/9] git commit: updated refs/heads/1781-reorganize-and-improve-docs to f2a0c93

[kx...@apache.org]

Add MacOS installation guide.


Project: http://git-wip-us.apache.org/repos/asf/couchdb/repo
Commit: http://git-wip-us.apache.org/repos/asf/couchdb/commit/f2a0c936
Tree: http://git-wip-us.apache.org/repos/asf/couchdb/tree/f2a0c936
Diff: http://git-wip-us.apache.org/repos/asf/couchdb/diff/f2a0c936

Branch: refs/heads/1781-reorganize-and-improve-docs
Commit: f2a0c93693ced8b0e96920aa46718489879cae68
Parents: 925913e
Author: Alexander Shorin <kx...@apache.org>
Authored: Fri Aug 9 12:55:07 2013 +0400
Committer: Alexander Shorin <kx...@apache.org>
Committed: Fri Aug 9 12:55:07 2013 +0400

----------------------------------------------------------------------
 share/doc/build/Makefile.am     |   3 +
 share/doc/src/install/index.rst |   3 +-
 share/doc/src/install/mac.rst   | 188 +++++++++++++++++++++++++++++++++++
 share/doc/src/install/unix.rst  |  67 +------------
 4 files changed, 196 insertions(+), 65 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/couchdb/blob/f2a0c936/share/doc/build/Makefile.am
----------------------------------------------------------------------
diff --git a/share/doc/build/Makefile.am b/share/doc/build/Makefile.am
index ccbd9bd..ad10df9 100644
--- a/share/doc/build/Makefile.am
+++ b/share/doc/build/Makefile.am
@@ -100,6 +100,7 @@ html_files = \
     html/_sources/install/index.txt \
     html/_sources/install/freebsd.txt \
     html/_sources/install/gentoo.txt \
+    html/_sources/install/mac.txt \
     html/_sources/install/unix.txt \
     html/_sources/install/windows.txt \
     html/_sources/query-server/index.txt \
@@ -200,6 +201,7 @@ html_files = \
     html/install/index.html \
     html/install/freebsd.html \
     html/install/gentoo.html \
+    html/install/mac.html \
     html/install/unix.html \
     html/install/windows.html \
     html/query-server/index.html \
@@ -298,6 +300,7 @@ src_files = \
     ../src/install/index.rst \
     ../src/install/freebsd.rst \
     ../src/install/gentoo.rst \
+    ../src/install/mac.rst \
     ../src/install/unix.rst \
     ../src/install/windows.rst \
     ../src/query-server/index.rst \

http://git-wip-us.apache.org/repos/asf/couchdb/blob/f2a0c936/share/doc/src/install/index.rst
----------------------------------------------------------------------
diff --git a/share/doc/src/install/index.rst b/share/doc/src/install/index.rst
index 45ca9de..7ab87fd 100644
--- a/share/doc/src/install/index.rst
+++ b/share/doc/src/install/index.rst
@@ -22,7 +22,6 @@ Installation
 
    unix
    windows
+   mac
    freebsd
    gentoo
-
-

http://git-wip-us.apache.org/repos/asf/couchdb/blob/f2a0c936/share/doc/src/install/mac.rst
----------------------------------------------------------------------
diff --git a/share/doc/src/install/mac.rst b/share/doc/src/install/mac.rst
new file mode 100644
index 0000000..5cfeab0
--- /dev/null
+++ b/share/doc/src/install/mac.rst
@@ -0,0 +1,188 @@
+.. 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.
+
+
+.. _install/mac:
+
+=====================
+Installation on MacOS
+=====================
+
+.. _install/mac/binary:
+
+Install from binaries
+=====================
+
+#. Get `the latest MacOS binaries`_ from `CouchDB web site`_.
+   Old releases are available at `archive`_.
+#. Unzip it and place CouchDB Server into the Applications directory
+#. Run CouchDB
+#. `Open up Futon`_
+#. It's time to Relax!
+
+.. _Open up Futon: http://localhost:5984/_utils
+.. _CouchDB web site: http://couchdb.org/
+.. _archive: http://archive.apache.org/dist/couchdb/binary/mac/
+.. _the latest MacOS binaries: http://couchdb.org/#download
+
+
+.. _install/mac/homebrew:
+
+Installation with HomeBrew
+==========================
+
+You can install the build tools by running::
+
+    open /Applications/Installers/Xcode\ Tools/XcodeTools.mpkg
+
+You will need `Homebrew`_ installed to use the `brew` command. To install the
+other :ref:`dependencies <install/unix/dependencies>` run next commands::
+
+    brew install autoconf
+    brew install autoconf-archive
+    brew install automake
+    brew install libtool
+    brew install erlang
+    brew install icu4c
+    brew install spidermonkey
+    brew install curl
+
+You may want to link ICU so that CouchDB can find the header files
+automatically::
+
+    brew link icu4c
+
+The same is true for recent versions of Erlang::
+
+    brew link erlang
+
+Now it's time to brew CouchDB::
+
+  brew install couchdb
+
+
+The above Erlang install will use the bottled (pre-compiled) version if you are:
+using `/usr/local` for `homebrew`, and on 10.6 or 10.7. If you're not on one of
+these, `homebrew` will build from source, so consider doing::
+
+  brew install erlang --no-docs
+
+to trim down compilation time.
+
+If you're hacking on CouchDB, and we hope you will, you may try the current
+git-based master (head) branch, or the next development release using this
+``couchdb`` recipe, using either ``--head`` or ``--devel`` options respectively.
+This will allow quick installation of the future release branch when it becomes
+active. If you're not sure if you need this, then you probably don't.
+In both cases we assume you are comfortable identifying bugs, and handling any
+potential upgrades between commits to the codebase.
+
+::
+
+  brew install [--devel|--head] couchdb
+
+.. note::
+
+   OS X Lion might hang on the final brew.
+   See the thread at https://github.com/mxcl/homebrew/issues/7024 it seems in
+   most cases to be resolved by breaking out with ``CTRL-C`` and then repeating
+   with ``brew install -v couchdb``.
+
+If you wish to have CouchDB run as a daemon then, set up the account,
+using the "User & Groups" preference pane:
+
+- Create a standard user `couchdb` with home directory as
+  `/usr/local/var/lib/couchdb`
+
+- Create a group called `couchdb` and add yourself, the `couchdb` user, and any
+  others you want to be able to edit config or db files directly to it.
+  Use the `advanced` group options to ensure the internal name is also correctly
+  called `couchdb`.
+
+Some versions of Mac OS X ship a problematic OpenSSL library. If you're
+experiencing troubles with CouchDB crashing intermittently with a segmentation
+fault or a bus error, you will need to install your own version of OpenSSL.
+
+.. _Homebrew: http://mxcl.github.com/homebrew/
+
+
+Running as a Daemon
+-------------------
+
+You can use the `launchctl` command to control the CouchDB daemon.
+
+You can load the configuration by running::
+
+    sudo launchctl load \
+         /usr/local/Library/LaunchDaemons/org.apache.couchdb.plist
+
+You can stop the CouchDB daemon by running::
+
+    sudo launchctl unload \
+         /usr/local/Library/LaunchDaemons/org.apache.couchdb.plist
+
+You can start CouchDB by running::
+
+    sudo launchctl start org.apache.couchdb
+
+You can restart CouchDB by running::
+
+    sudo launchctl stop org.apache.couchdb
+
+You can edit the launchd configuration by running::
+
+    open /usr/local/Library/LaunchDaemons/org.apache.couchdb.plist
+
+To start the daemon on boot, copy the configuration file to::
+
+    /Library/LaunchDaemons
+
+Consult your system documentation for more information.
+
+.. _install/mac/macports:
+
+Installation from MacPorts
+==========================
+
+To install CouchDB using MacPorts you have 2 package choices:
+
+- ``couchdb`` - the latest release version
+- ``couchdb-devel`` - updated every few weeks with the latest from the master
+  branch
+
+::
+
+  $ sudo port install couchdb
+
+should be enough. MacPorts takes care of installing all necessary dependencies.
+If you have already installed some of the CouchDB dependencies via MacPorts,
+run this command to check and upgrade any outdated ones, after installing
+CouchDB::
+
+  $ sudo port upgrade couchdb
+
+This will upgrade dependencies recursively, if there are more recent versions
+available. If you want to run CouchDB as a service controlled by the OS, load
+the launchd configuration which comes with the project, with this command::
+
+  $ sudo port load couchdb
+
+and it should be up and accessible via Futon at http://127.0.0.1:5984/_utils.
+It should also be restarted automatically after reboot.
+
+Updating the ports collection. The collection of port files has to be updated
+to reflect the latest versions of available packages. In order to do that run::
+
+  $ sudo port selfupdate
+
+to update the port tree, and then install just as explained.
+

http://git-wip-us.apache.org/repos/asf/couchdb/blob/f2a0c936/share/doc/src/install/unix.rst
----------------------------------------------------------------------
diff --git a/share/doc/src/install/unix.rst b/share/doc/src/install/unix.rst
index 3cd5902..da4e5bd 100644
--- a/share/doc/src/install/unix.rst
+++ b/share/doc/src/install/unix.rst
@@ -44,6 +44,9 @@ Please work through these in order if you experience any problems.
 .. _wiki: http://wiki.apache.org/couchdb
 .. _friendly mailing lists: http://couchdb.apache.org/community/lists.html
 
+
+.. _install/unix/dependencies:
+
 Dependencies
 ------------
 
@@ -119,37 +122,8 @@ distributions, it's recommended to use a more recent js-devel-1.8.5.
 Mac OS X
 ~~~~~~~~
 
-You can install the build tools by running::
-
-    open /Applications/Installers/Xcode\ Tools/XcodeTools.mpkg
-
-You can install the other dependencies by running::
-
-    brew install autoconf
-    brew install autoconf-archive
-    brew install automake
-    brew install libtool
-    brew install erlang
-    brew install icu4c
-    brew install spidermonkey
-    brew install curl
-
-You may want to link ICU so that CouchDB can find the header files automatically::
-
-    brew link icu4c
+Follow :ref:`install/mac/homebrew` reference till `brew install couchdb` step.
 
-The same is true for recent versions of Erlang::
-
-    brew link erlang
-
-You will need `Homebrew`_ installed to use the `brew` command.
-
-Some versions of Mac OS X ship a problematic OpenSSL library. If you're
-experiencing troubles with CouchDB crashing intermittently with a segmentation
-fault or a bus error, you will need to install your own version of OpenSSL. See
-the troubleshooting guide, mentioned above, for more information.
-
-.. _Homebrew: http://mxcl.github.com/homebrew/
 
 Installing
 ----------
@@ -293,36 +267,3 @@ A `logrotate` configuration is installed into::
 Consult your `logrotate` documentation for more information.
 
 It is critical that the CouchDB logs are rotated so as not to fill your disk.
-
-Mac OS X
-~~~~~~~~
-
-You can use the `launchctl` command to control the CouchDB daemon.
-
-You can load the configuration by running::
-
-    sudo launchctl load \
-         /usr/local/Library/LaunchDaemons/org.apache.couchdb.plist
-
-You can stop the CouchDB daemon by running::
-
-    sudo launchctl unload \
-         /usr/local/Library/LaunchDaemons/org.apache.couchdb.plist
-
-You can start CouchDB by running::
-
-    sudo launchctl start org.apache.couchdb
-
-You can restart CouchDB by running::
-
-    sudo launchctl stop org.apache.couchdb
-
-You can edit the launchd configuration by running::
-
-    open /usr/local/Library/LaunchDaemons/org.apache.couchdb.plist
-
-To start the daemon on boot, copy the configuration file to::
-
-    /Library/LaunchDaemons
-
-Consult your system documentation for more information.

[2/9] git commit: updated refs/heads/1781-reorganize-and-improve-docs to f2a0c93

[kx...@apache.org]

Update config with version markers and users_db_public option.


Project: http://git-wip-us.apache.org/repos/asf/couchdb/repo
Commit: http://git-wip-us.apache.org/repos/asf/couchdb/commit/d8d08056
Tree: http://git-wip-us.apache.org/repos/asf/couchdb/tree/d8d08056
Diff: http://git-wip-us.apache.org/repos/asf/couchdb/diff/d8d08056

Branch: refs/heads/1781-reorganize-and-improve-docs
Commit: d8d080561cd5c0c84371f7473ccf13a3c0315f7b
Parents: 28e23fd
Author: Alexander Shorin <kx...@apache.org>
Authored: Fri Aug 9 00:13:08 2013 +0400
Committer: Alexander Shorin <kx...@apache.org>
Committed: Fri Aug 9 00:13:08 2013 +0400

----------------------------------------------------------------------
 share/doc/src/config/auth.rst | 31 ++++++++++++++++++++++++-------
 1 file changed, 24 insertions(+), 7 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/couchdb/blob/d8d08056/share/doc/src/config/auth.rst
----------------------------------------------------------------------
diff --git a/share/doc/src/config/auth.rst b/share/doc/src/config/auth.rst
index 6e3b59e..16c2012 100644
--- a/share/doc/src/config/auth.rst
+++ b/share/doc/src/config/auth.rst
@@ -184,13 +184,7 @@ required for `Proxy Auth`::
 ``public_fields`` :: User documents public fields
 -------------------------------------------------
 
-.. warning::
-
-   Due to :issue:`1838` issue, setting `public fields` allows list all documents
-   in the :ref:`_users <config/couch_httpd_auth/authentication_db>` database,
-   no matter does their documents contains public fields or not. If your system
-   uses email-based user login, enabling this feature may be fatal from security
-   point.
+.. versionadded:: 1.4
 
 Comma-separated list of field names that will be available to view for any user
 document in :ref:`authentication_db <config/couch_httpd_auth/authentication_db>`
@@ -201,6 +195,14 @@ If unset or not specified, authenticated users may retrieve only their own docs.
   [couch_httpd_auth]
   public_fields = first_name, last_name, contacts, url
 
+.. note::
+   Using the ``public_fields`` whitelist for user document properties requires
+   setting the :ref:`users_db_public <config/couch_httpd_auth/users_db_public>`
+   option to ``true`` (the latter option has no other purpose)::
+
+     [couch_httpd_auth]
+     users_db_public = true
+
 
 .. _config/couch_httpd_auth/require_valid_user:
 
@@ -236,6 +238,21 @@ Number of seconds since the last request before session will be expired::
   timeout = 600
 
 
+
+.. _config/couch_httpd_auth/users_db_public:
+
+``users_db_public`` :: Publish users info
+-----------------------------------------
+
+.. versionadded:: 1.4
+
+Allow all users to view user documents. By default, only admins may browse
+all users documents while users may browse only their own document::
+
+  [couch_httpd_auth]
+  users_db_public = false
+
+
 .. _config/couch_httpd_auth/x_auth_roles:
 
 ``x_auth_roles`` :: Proxy Auth roles header

[4/9] git commit: updated refs/heads/1781-reorganize-and-improve-docs to f2a0c93

[kx...@apache.org]

More inner references.


Project: http://git-wip-us.apache.org/repos/asf/couchdb/repo
Commit: http://git-wip-us.apache.org/repos/asf/couchdb/commit/40e6eff6
Tree: http://git-wip-us.apache.org/repos/asf/couchdb/tree/40e6eff6
Diff: http://git-wip-us.apache.org/repos/asf/couchdb/diff/40e6eff6

Branch: refs/heads/1781-reorganize-and-improve-docs
Commit: 40e6eff61e0e3bb50f40055b75443eec30db734e
Parents: dbd7643
Author: Alexander Shorin <kx...@apache.org>
Authored: Fri Aug 9 00:21:01 2013 +0400
Committer: Alexander Shorin <kx...@apache.org>
Committed: Fri Aug 9 00:21:01 2013 +0400

----------------------------------------------------------------------
 share/doc/src/config/auth.rst | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/couchdb/blob/40e6eff6/share/doc/src/config/auth.rst
----------------------------------------------------------------------
diff --git a/share/doc/src/config/auth.rst b/share/doc/src/config/auth.rst
index e2229cf..4ce2056 100644
--- a/share/doc/src/config/auth.rst
+++ b/share/doc/src/config/auth.rst
@@ -347,9 +347,10 @@ config file by using next option::
   [couch_httpd_oauth]
   use_users_db = true
 
-If set to ``true``, OAuth token and consumer secrets will be looked up
-in the authentication database (``_user``). These secrets are stored in
-a top level field named ``"oauth"`` in user documents. Example:
+If set to ``true``, OAuth token and consumer secrets will be looked up in the
+:ref:`authentication database <config/couch_httpd_auth/authentication_db>`.
+These secrets are stored in a top level field named ``"oauth"`` in user
+documents. Example:
 
 .. code-block:: javascript
 

[5/9] Split changelog.rst into group of per release branch articles.

[kx...@apache.org]

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