diff --git a/src/lang/array.js b/src/lang/array.js
index 2354aec..4c69db5 100644
--- a/src/lang/array.js
+++ b/src/lang/array.js
@@ -131,7 +131,16 @@ Array.from = $A;
 
   /**
    *  Array#clear() -> Array
-   *  Empties an array.
+   *
+   *  Clears the array (makes it empty) and returns the array reference.
+   *
+   *  ### Example
+   *
+   *      var guys = ['Sam', 'Justin', 'Andrew', 'Dan'];
+   *      guys.clear();
+   *      // -> []
+   *      guys
+   *      // -> []
   **/
   function clear() {
     this.length = 0;