You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@couchdb.apache.org by de...@apache.org on 2014/03/31 21:46:09 UTC

[15/41] couchdb commit: updated refs/heads/Update-Sidebar-Ui to c1e1423

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/Update-Sidebar-Ui
Commit: 29256149029714af6379dadd62022ee6f46b58ec
Parents: ebbee3c
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

----------------------------------------------------------------------
 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