docs(*): renaming incorrect widget references to control or directive

1 files changed, 8 insertions, 6 deletions

diff --git a/src/directive/form.js b/src/directive/form.js
index 5427384a..db645188 100644
--- a/src/directive/form.js
+++ b/src/directive/form.js
@@ -7,16 +7,18 @@
  *
  * @property {boolean} $pristine True if user has not interacted with the form yet.
  * @property {boolean} $dirty True if user has already interacted with the form.
- * @property {boolean} $valid True if all of the containg widgets are valid.
- * @property {boolean} $invalid True if at least one containing widget is invalid.
+ * @property {boolean} $valid True if all of the containg forms and controls are valid.
+ * @property {boolean} $invalid True if at least one containing control or form is invalid.
  *
- * @property {Object} $error Is an object hash, containing references to all invalid widgets, where
+ * @property {Object} $error Is an object hash, containing references to all invalid controls or
+ *  forms, where:
  *
- *  - keys are error ids (such as `REQUIRED`, `URL` or `EMAIL`),
- *  - values are arrays of widgets that are invalid with given error.
+ *  - keys are validation tokens (error names) — such as `REQUIRED`, `URL` or `EMAIL`),
+ *  - values are arrays of controls or forms that are invalid with given error.
  *
  * @description
- * `FormController` keeps track of all its widgets as well as state of them form, such as being valid/invalid or dirty/pristine.
+ * `FormController` keeps track of all its controls and nested forms as well as state of them,
+ * such as being valid/invalid or dirty/pristine.
  *
  * Each {@link angular.module.ng.$compileProvider.directive.form form} directive creates an instance
  * of `FormController`.