fix documentation explain why the HTTP status code 400 will be returned when ?rev= is included in the request URL
Project: http://git-wip-us.apache.org/repos/asf/couchdb/repo Commit: http://git-wip-us.apache.org/repos/asf/couchdb/commit/29256149 Tree: http://git-wip-us.apache.org/repos/asf/couchdb/tree/29256149 Diff: http://git-wip-us.apache.org/repos/asf/couchdb/diff/29256149 Branch: refs/heads/master Commit: 29256149029714af6379dadd62022ee6f46b58ec Parents: ebbee3c Author: Andy Wenk <[email protected]> Authored: Fri Mar 21 22:57:04 2014 +0100 Committer: Andy Wenk <[email protected]> Committed: Fri Mar 21 22:57:04 2014 +0100 ---------------------------------------------------------------------- share/doc/src/api/database/common.rst | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/couchdb/blob/29256149/share/doc/src/api/database/common.rst ---------------------------------------------------------------------- diff --git a/share/doc/src/api/database/common.rst b/share/doc/src/api/database/common.rst index f715c70..a1483d9 100644 --- a/share/doc/src/api/database/common.rst +++ b/share/doc/src/api/database/common.rst @@ -223,6 +223,12 @@ Deletes the specified database, and all the documents and attachments contained within it. + .. note:: + + To avoid deleting a database, CouchDB will respond with the HTTP status code 400 + when the request URL includes a ?rev= parameter. This suggests that one wants to delete + a document but forgot to add the document id to the URL. + :param db: Database name :<header Accept: - :mimetype:`application/json` - :mimetype:`text/plain` @@ -230,7 +236,7 @@ - :mimetype:`text/plain; charset=utf-8` :>json boolean ok: Operation status :code 200: Database removed successfully - :code 400: Invalid database name + :code 400: Invalid database name or forgotten document id by accident :code 401: CouchDB Server Administrator privileges required :code 404: Database doesn't exist
