From 64ed34f94962679bb305bf67a6b9897c62d1ea87 Mon Sep 17 00:00:00 2001
From: Jo Liss <joliss42@gmail.com>
Date: Mon, 6 Feb 2012 14:14:50 +0100
Subject: [PATCH] Make it clearer that extend and defaults modify in place
 *and* return

---
 index.html | 9 +++++----
 1 file changed, 5 insertions(+), 4 deletions(-)

diff --git a/index.html b/index.html
index 9c10bc272..ab8d15095 100644
--- a/index.html
+++ b/index.html
@@ -1005,8 +1005,9 @@ _.functions(_);
         <b class="header">extend</b><code>_.extend(destination, *sources)</code>
         <br />
         Copy all of the properties in the <b>source</b> objects over to the
-        <b>destination</b> object. It's in-order, so the last source will override
-        properties of the same name in previous arguments.
+        <b>destination</b> object, and return the <b>destination</b> object.
+        It's in-order, so the last source will override properties of the same
+        name in previous arguments.
       </p>
       <pre>
 _.extend({name : 'moe'}, {age : 50});
@@ -1017,8 +1018,8 @@ _.extend({name : 'moe'}, {age : 50});
         <b class="header">defaults</b><code>_.defaults(object, *defaults)</code>
         <br />
         Fill in missing properties in <b>object</b> with default values from the
-        <b>defaults</b> objects. As soon as the property is filled, further defaults
-        will have no effect.
+        <b>defaults</b> objects, and return the <b>object</b>. As soon as the
+        property is filled, further defaults will have no effect.
       </p>
       <pre>
 var iceCream = {flavor : "chocolate"};