docs(ngModel): clarify docs for NgModelController#

IgorMinar · IgorMinar · commit 43997c15406d · 2013-08-08T23:08:40.000-07:00
Closes angular#3498
diff --git a/src/ng/directive/input.js b/src/ng/directive/input.js
@@ -1042,8 +1042,10 @@ var NgModelController = ['$scope', '$exceptionHandler', '$attrs', '$element', '$
    * For example {@link ng.directive:input input} or
    * {@link ng.directive:select select} directives call it.
    *
-   * It internally calls all `parsers` and if resulted value is valid, updates the model and
-   * calls all registered change listeners.
+   * It internally calls all `parsers` (including validators) and updates the `$modelValue` and the actual model path.
+   * Lastly it calls all registered change listeners.
+   *
+   * If validators determine the value is invalid, the `$modelValue` and the model path will be set to `undefined`.
    *
    * @param {string} value Value from the view.
    */

Original file line number	Diff line number	Diff line change
`@@ -1042,8 +1042,10 @@ var NgModelController = ['$scope', '$exceptionHandler', '$attrs', '$element', '$`
`1042`	`1042`	`* For example {@link ng.directive:input input} or`
`1043`	`1043`	`* {@link ng.directive:select select} directives call it.`
`1044`	`1044`	`*`
`1045`		- * It internally calls all `parsers` and if resulted value is valid, updates the model and
`1046`		`- * calls all registered change listeners.`
	`1045`	+ * It internally calls all `parsers` (including validators) and updates the `$modelValue` and the actual model path.
	`1046`	`+ * Lastly it calls all registered change listeners.`
	`1047`	`+ *`
	`1048`	+ * If validators determine the value is invalid, the `$modelValue` and the model path will be set to `undefined`.
`1047`	`1049`	`*`
`1048`	`1050`	`* @param {string} value Value from the view.`
`1049`	`1051`	`*/`