couchdb-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From kxe...@apache.org
Subject [8/9] git commit: updated refs/heads/1781-reorganize-and-improve-docs to f2a0c93
Date Fri, 09 Aug 2013 08:57:20 GMT
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 <kxepal@apache.org>
Authored: Fri Aug 9 12:02:51 2013 +0400
Committer: Alexander Shorin <kxepal@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`


Mime
View raw message