diff --git a/lib/ace/edit_session.js b/lib/ace/edit_session.js
index d8578d03..a951afbb 100644
--- a/lib/ace/edit_session.js
+++ b/lib/ace/edit_session.js
@@ -318,7 +318,7 @@ var EditSession = function(text, mode) {
     };
 
     /**
-    * EditSession.getSelection() -> String
+    * EditSession.getSelection() -> Selection
     *
     * Returns the string of the current selection.
     **/
@@ -349,11 +349,11 @@ var EditSession = function(text, mode) {
     };
 
     /**
-    * EditSession.getTokenAt(row, column) -> Array
+    * EditSession.getTokenAt(row, column) -> Object
     * - row (Number): The row number to retrieve from
     * - column (Number): The column number to retrieve from
     *
-    * Returns an array of tokens at the indicated row and column.
+    * Returns an object indicating the token at the current row. THe object has two properties: `index` and `start`.
     **/
     this.getTokenAt = function(row, column) {
         var tokens = this.bgTokenizer.getTokens(row);
@@ -1204,8 +1204,8 @@ var EditSession = function(text, mode) {
     };
 
     /** related to: Document.getTextRange
-    * EditSession.getTextRange(range) -> Array
-    * - range (String): The range to work with
+    * EditSession.getTextRange(range) -> String
+    * - range (Range): The range to work with
     *
     * {:Document.getTextRange.desc}
     **/