docs(input): provide explanation of how ngModel will affect the local scope

mrlucmorin · petebacondarwin · commit bc76e7255b7b · 2013-06-04T20:16:37.000+01:00
diff --git a/src/ng/directive/input.js b/src/ng/directive/input.js
@@ -1051,7 +1051,7 @@ var NgModelController = ['$scope', '$exceptionHandler', '$attrs', '$element', '$
  * @element input
  *
  * @description
- * Is directive that tells Angular to do two-way data binding. It works together with `input`,
+ * Is a directive that tells Angular to do two-way data binding. It works together with `input`,
  * `select`, `textarea`. You can easily write your own directives to use `ngModel` as well.
  *
  * `ngModel` is responsible for:
@@ -1062,6 +1062,10 @@ var NgModelController = ['$scope', '$exceptionHandler', '$attrs', '$element', '$
  * - keeping state of the control (valid/invalid, dirty/pristine, validation errors),
  * - setting related css class onto the element (`ng-valid`, `ng-invalid`, `ng-dirty`, `ng-pristine`),
  * - register the control with parent {@link ng.directive:form form}.
+ * 
+ * Note: `ngModel` will try to bind to the property given by evaluating the expression on the
+ * current scope. If the property doesn't already exist on this scope, it will be created
+ * implicitly and added to the scope.
  *
  * For basic examples, how to use `ngModel`, see:
  *

Original file line number	Diff line number	Diff line change
`@@ -1051,7 +1051,7 @@ var NgModelController = ['$scope', '$exceptionHandler', '$attrs', '$element', '$`
`1051`	`1051`	`* @element input`
`1052`	`1052`	`*`
`1053`	`1053`	`* @description`
`1054`		- * Is directive that tells Angular to do two-way data binding. It works together with `input`,
	`1054`	+ * Is a directive that tells Angular to do two-way data binding. It works together with `input`,
`1055`	`1055`	* `select`, `textarea`. You can easily write your own directives to use `ngModel` as well.
`1056`	`1056`	`*`
`1057`	`1057`	* `ngModel` is responsible for:
`@@ -1062,6 +1062,10 @@ var NgModelController = ['$scope', '$exceptionHandler', '$attrs', '$element', '$`
`1062`	`1062`	`* - keeping state of the control (valid/invalid, dirty/pristine, validation errors),`
`1063`	`1063`	* - setting related css class onto the element (`ng-valid`, `ng-invalid`, `ng-dirty`, `ng-pristine`),
`1064`	`1064`	`* - register the control with parent {@link ng.directive:form form}.`
	`1065`	`+ *`
	`1066`	+ * Note: `ngModel` will try to bind to the property given by evaluating the expression on the
	`1067`	`+ * current scope. If the property doesn't already exist on this scope, it will be created`
	`1068`	`+ * implicitly and added to the scope.`
`1065`	`1069`	`*`
`1066`	`1070`	* For basic examples, how to use `ngModel`, see:
`1067`	`1071`	`*`