From 1cf09144ba3e8f7b1e83507b37b843125c3ffb80 Mon Sep 17 00:00:00 2001
From: Louis Chatriot <louis.chatriot@gmail.com>
Date: Thu, 16 May 2013 17:45:35 +0200
Subject: [PATCH] Update README.md

---
 README.md | 22 ++++++++++++++++++++++
 1 file changed, 22 insertions(+)

diff --git a/README.md b/README.md
index c259853..6a36eb5 100644
--- a/README.md
+++ b/README.md
@@ -135,6 +135,28 @@ db.update({ planet: 'Pluton' }, { $set: { inhabited: false } }, { upsert: true }
 });
 ```
 
+### Removing documents
+`db.remove(query, options, callback)` will remove all documents matching `query` according to `options`  
+* `query` is the same as the ones used for finding and updating
+* `options` only one option for now: `multi` which allows the removal of multiple documents if set to true. Default is false
+* `callback` is optional, signature: err, numRemoved
+
+```javascript
+// Let's use the same example collection as in the "finding document" part
+
+// Remove one document from the collection
+// options set to {} since the default for multi is false
+db.remove({ _id: 'id2' }, {}, function (err, numRemoved) {
+  // numRemoved = 1
+});
+
+// Remove multiple documents
+db.remove({ system: 'solar' }, { multi: true }, function (err, numRemoved) {
+  // numRemoved = 3
+  // All planets from the solar system were removed
+});
+```
+
 
 ## Performance
 ### Speed