Added examples

Author: Mark Lagendijk

README.md

@@ -23,6 +23,26 @@ The dot separated propertyPath.
 #### returns
 Type: `boolean`
 
+``` javascript
+var object = {
+	level1: {
+		level2: Object.create({
+			level3: {
+				value: 'value 3'
+			}
+		})
+	}
+};
+_.deepIn(object, 'level1');
+// -> true
+_.deepIn(object, 'level1.level2');
+// -> true
+_.deepIn(object, 'level1.level2.level3');
+// -> true
+_.deepIn(object, 'level1.level2.level3.value');
+// -> true
+```
+
 ### _.deepHas(object, propertyPath)
 Executes a deep check for the existence of a *own* property in an object tree.
 
@@ -39,6 +59,26 @@ The dot separated propertyPath.
 #### returns
 Type: `boolean`
 
+``` javascript
+var object = {
+	level1: {
+		level2: Object.create({
+			level3: {
+				value: 'value 3'
+			}
+		})
+	}
+};
+_.deepHas(object, 'level1');
+// -> true
+_.deepHas(object, 'level1.level2');
+// -> true
+_.deepHas(object, 'level1.level2.level3');
+// -> false
+_.deepHas(object, 'level1.level2.level3.value');
+// -> false
+```
+
 ### _.deepGetValue(object, propertyPath)
 Retreives the value of a property in an object tree.
 
@@ -57,6 +97,25 @@ Type: `*|undefined`
 
 The value, or undefined if it doesn't exists.
 
+``` javascript
+var object = {
+	level1: {
+		value: 'value 1',
+		level2: Object.create({
+			level3: {
+				value: 'value 3'
+			}
+		})
+	}
+};
+_.deepGetValue(object, 'level1.value');
+// -> 'value 1'
+_.deepGetValue(object, 'level1.level2.level3.value');
+// -> 'value 3'
+_.deepGetValue(object, 'foo.bar.baz');
+// -> undefined
+```
+
 ### _.deepGetOwnValue(object, propertyPath)
 Retreives the value of a *own* property in an object tree.
 
@@ -75,6 +134,25 @@ Type: `*|undefined`
 
 The value, or undefined if it doesn't exists.
 
+``` javascript
+var object = {
+	level1: {
+		value: 'value 1',
+		level2: Object.create({
+			level3: {
+				value: 'value 3'
+			}
+		})
+	}
+};
+_.deepGetOwnValue(object, 'level1.value');
+// -> 'value 1'
+_.deepGetOwnValue(object, 'level1.level2.level3.value');
+// -> undefined
+_.deepGetOwnValue(object, 'foo.bar.baz');
+// -> undefined
+```
+
 ### _.deepSetValue(object, propertyPath, value)
 Executes a deep check for the existence of a own property in an object tree.
 
@@ -96,6 +174,14 @@ The value to set.
 #### returns
 Type: `Object`
 
+``` javascript
+var object = {};
+_.deepSetValue(object, 'level1.level2.level3.value', 'value 3');
+// -> { level1: { level2: { level3: { value: 'value 3' }}}}
+_.deepSetValue(object, 'level1.level2.level3.value', 'foo');
+// -> { level1: { level2: { level3: { value: 'foo' }}}}
+```
+
 ### _.deepPluck(collection, propertyPath)
 Executes a deep pluck on an collection of object trees.
 
@@ -110,4 +196,17 @@ Type: `string`
 The dot separated propertyPath.
 
 #### returns
-Type: `Object|Array`
+Type: `Array`
+
+``` javascript
+var collection = [
+	{ level1: { level2: { level3: { value: 1 }}}},
+	{ level1: { level2: { level3: { value: 2 }}}},
+	{ level1: { level2: { level3: { value: 3 }}}},
+	{ level1: { level2: { level3: { value: 4 }}}},
+	{ level1: { level2: {} }},
+	{}
+];
+_.deepPluck(collection, 'level1.level2.level3.value');
+// -> [ 1, 2, 3, 4, undefined, undefined ]
+```

lodash.deep.js

@@ -108,7 +108,7 @@
          * Executes a deep pluck on an collection of object trees.
          * @param {Object|Array} collection - The collection of object trees.
          * @param {string} propertyPath - The dot separated propertyPath.
-         * @returns {Object|Array}
+         * @returns {Array}
          */
         deepPluck: function(collection, propertyPath){
             return _.map(collection, function(item){