comments for docs

src/inputs/list.js

@@ -268,8 +268,8 @@ List - abstract class for inputs that have source option loaded from js array or
           
         If **function**, it should return data in format above (since 1.4.0).
         
-        Since 1.4.1 key `children` supported to render OPTGROUPs (select input only).  
+        Since 1.4.1 key `children` supported to render OPTGROUP (for **select** input only).  
-        Example `[{text: "group1", children: [{value: 1, text: "text1"}, {value: 2, text: "text2"}]}, ...]`. 
+        `[{text: "group1", children: [{value: 1, text: "text1"}, {value: 2, text: "text2"}]}, ...]` 
 
 		
         @property source 
@@ -294,8 +294,8 @@ List - abstract class for inputs that have source option loaded from js array or
         **/          
         sourceError: 'Error when loading list',
         /**
-        if <code>true</code> and source is **string url** - results will be cached for fields with the same source and name.  
+        if <code>true</code> and source is **string url** - results will be cached for fields with the same source.    
-        Usefull for editable grids.
+        Usefull for editable column in grid to prevent extra requests.
         
         @property sourceCache 
         @type boolean

src/inputs/typeahead.js

@@ -1,19 +1,29 @@
 /**
-Typeahead input (bootstrap only)
+Typeahead input (bootstrap only). Based on Twitter Bootstrap [typeahead](http://twitter.github.com/bootstrap/javascript.html#typeahead).  
+Depending on `source` format typeahead operates in two modes:
+
+* **strings**:  
+  When `source` defined as array of strings, e.g. `['text1', 'text2', 'text3' ...]`.  
+  User can submit one of these strings or any text entered in input (even if it is not matching source).
+  
+* **objects**:  
+  When `source` defined as array of objects, e.g. `[{value: 1, text: "text1"}, {value: 2, text: "text2"}, ...]`.  
+  User can submit only values that are in source (otherwise `null` is submitted). This is more like *dropdown* behavior.
 
 @class typeahead
 @extends list
+@since 1.4.1
 @final
 @example
 <a href="#" id="country" data-type="typeahead" data-pk="1" data-url="/post" data-original-title="Input country"></a>
 <script>
 $(function(){
     $('#country').editable({
-        value: 2,    
+        value: 'ru',    
         source: [
-              {value: 1, text: 'Active'},
+              {value: 'gb', text: 'Great Britain'},
-              {value: 2, text: 'Blocked'},
+              {value: 'us', text: 'United States'},
-              {value: 3, text: 'Deleted'}
+              {value: 'ru', text: 'Russia'}
            ]
         }
     });
@@ -185,7 +195,7 @@ $(function(){
         **/         
         tpl:'<input type="text">',
         /**
-        Configuration of typeahead.[Possible options](http://twitter.github.com/bootstrap/javascript.html#typeahead).
+        Configuration of typeahead. [Full list of options](http://twitter.github.com/bootstrap/javascript.html#typeahead).
         
         @property typeahead 
         @type object