You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@couchdb.apache.org by rn...@apache.org on 2014/07/10 11:47:10 UTC

[11/50] documentation commit: updated refs/heads/import-master to fe7f7bf

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-documentation/repo
Commit: http://git-wip-us.apache.org/repos/asf/couchdb-documentation/commit/793d70a2
Tree: http://git-wip-us.apache.org/repos/asf/couchdb-documentation/tree/793d70a2
Diff: http://git-wip-us.apache.org/repos/asf/couchdb-documentation/diff/793d70a2

Branch: refs/heads/import-master
Commit: 793d70a2ccb0efece834febe9ad2fa5733a5fecb
Parents: 5a4a2ef
Author: Andy Wenk <an...@nms.de>
Authored: Fri Mar 21 22:57:04 2014 +0100
Committer: Andy Wenk <an...@nms.de>
Committed: Fri Mar 21 22:57:04 2014 +0100

----------------------------------------------------------------------
 src/api/database/common.rst | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/couchdb-documentation/blob/793d70a2/src/api/database/common.rst
----------------------------------------------------------------------
diff --git a/src/api/database/common.rst b/src/api/database/common.rst
index f715c70..a1483d9 100644
--- a/src/api/database/common.rst
+++ b/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