From d0d246b29c91b065368c71acdaa9c7968afde350 Mon Sep 17 00:00:00 2001
From: Louis Chatriot <louis.chatriot@gmail.com>
Date: Thu, 16 May 2013 10:59:33 +0200
Subject: [PATCH] Began querying

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

diff --git a/README.md b/README.md
index be09b4d..6ffc1e1 100644
--- a/README.md
+++ b/README.md
@@ -21,6 +21,16 @@ var Datastore = require('nedb')
 db.loadDatabase(function (err) {    // Callback is optional
   // err is the error, if any
 });
+
+// Of course you can create multiple datastores if you need several
+// collections. For example:
+db = {};
+db.users = new Datastore('path/to/users.db');
+db.robots = new Datastore('path/to/robots.db');
+
+// You need to load each database
+db.users.loadDatabase();
+db.robots.loadDatabase();
 ```
 
 ### Inserting documents
@@ -43,6 +53,29 @@ db.insert(document, function (err, newDoc) {   // Callback is optional
 });
 ```
 
+### Finding documents
+For now, you can only select documents based on field equality. You can
+use `find` to look for multiple documents matching you query, of
+`findOne` to look for one specific document.
+
+```javascript
+// Let's say our datastore contains the following collection
+// { _id: 'id1', planet: 'Mars', system: 'solar', inhabited: false }
+// { _id: 'id2', planet: 'Earth', system: 'solar', inhabited: true }
+// { _id: 'id3', planet: 'Jupiter', system: 'solar', inhabited: false }
+// { _id: 'id4', planet: 'Omicron Persia 8', system: 'futurama', inhabited: true }
+
+// Finding all planets in the solar system
+db.find({ system: 'solar' }, function (err, docs) {
+  // docs is an array containing documents _id1, _id2, _id3
+});
+
+// Finding all inhabited planets in the solar system
+db.find({ system: 'solar', inhabited: true }, function (err, docs) {
+  // docs is an array containing document _id2 only
+});
+```
+
 
 ## Performance
 ### Speed