docs(directives): Edit for dartstyle and clarity.

naomiblack · Diana Salsbury · commit 838145225dd4 · 2014-07-16T09:44:22.000-07:00
Closes dart-archive#1037
diff --git a/lib/directive/ng_base_css.dart b/lib/directive/ng_base_css.dart
@@ -1,6 +1,6 @@
 part of angular.directive;
 /**
- * Specifies a base CSS to use for components defined under the directive. `Selector:[ng-base-css]`
+ * Specifies a base CSS to use for components defined under the directive. `Selector: [ng-base-css]`
  *
  * The NgBaseCss directive is typically used at the top of an Angular application, so that everything in the
  * application inherits the specified stylesheet.
diff --git a/lib/directive/ng_bind.dart b/lib/directive/ng_bind.dart
@@ -2,7 +2,7 @@ part of angular.directive;
 
 /**
  * Replaces the text content of the specified HTML element with the value of a given expression,
- * and updates the text content when the value of that expression changes. `Selector:[ng-bind]`
+ * and updates the text content when the value of that expression changes. `Selector: [ng-bind]`
  *
  * Typically, you don't use ngBind directly, but instead you use the double
  * curly markup `{{ expression }}` which is similar but less verbose.
@@ -12,7 +12,7 @@ part of angular.directive;
  * bindings from showing by using `ng-bind` instead of `{{ }}`. Since `ng-bind` is an element attribute, nothing is
  * shown to the user.
  *
- * An alternative solution to this problem would be using the [ngCloak] directive.
+ * An alternative solution to this problem would be using the [NgCloak] directive.
  */
 @Decorator(
   selector: '[ng-bind]',
diff --git a/lib/directive/ng_bind_html.dart b/lib/directive/ng_bind_html.dart
@@ -2,7 +2,7 @@ part of angular.directive;
 
 /**
  * Sanitizes an HTML string and invokes the browser's parser to insert the string into
- * the containing element in the DOM. `Selector:[ng-bind-html]`
+ * the containing element in the DOM. `Selector: [ng-bind-html]`
  *
  * # Example
  *
diff --git a/lib/directive/ng_bind_template.dart b/lib/directive/ng_bind_template.dart
@@ -1,7 +1,7 @@
 part of angular.directive;
 
 /**
- * Replaces the text content of an element with an interpolated template. `Selector:[ng-bind-template]`
+ * Replaces the text content of an element with an interpolated template. `Selector: [ng-bind-template]`
  *
  * # Example
  *
diff --git a/lib/directive/ng_class.dart b/lib/directive/ng_class.dart
@@ -2,7 +2,7 @@ part of angular.directive;
 
 /**
  * The `ngClass` directive allows you to dynamically style an HTML element,
- * by binding to an expression that represents the classes to be bound.
+ * by binding to an expression that represents the classes to be bound. `Selector: [ng-class]`
  *
  * Classes are specified by a bound model that can be a string, array, or map:
  *
diff --git a/lib/directive/ng_cloak.dart b/lib/directive/ng_cloak.dart
@@ -1,26 +1,34 @@
 part of angular.directive;
 
 /**
- * The `ngCloak` directive is used to prevent the Angular html template from
- * being briefly displayed by the browser in its raw (uncompiled) form while
- * your application is loading. Use this directive to avoid the undesirable
- * flicker effect caused by the html template display.
+ * Hides elements on the page while the application loads. `Selector: [ng-cloak], .ng-cloak`
  *
- * The directive can be applied to the `<body>` element, but typically a
- * fine-grained application is preferred in order to benefit from progressive
- * rendering of the browser view.
+ * This prevents template artifacts from being briefly displayed by the browser in their raw (uncompiled) form while
+ * your application is loading. Use this directive to avoid the undesirable flicker effect caused by the HTML template
+ * display.
  *
- * `ngCloak` works in cooperation with a css. Following is the css rule:
+ * The directive can be applied to the `<body>` element, but typically a fine-grained application is preferred in order
+ * to benefit from progressive rendering of the browser view.
+ *
+ * `ng-cloak` works in conjunction with a css rule:
  *
  *     [ng-cloak], [data-ng-cloak], .ng-cloak {
  *        display: none !important;
  *     }
  *
- * When this css rule is loaded by the browser, all html elements (including
- * their children) that are tagged with the `ng-cloak` directive are hidden.
- * When Angular comes across this directive during the compilation of the
- * template it deletes the `ngCloak` element attribute, which makes the compiled
- * element visible.
+ * When this css rule is loaded by the browser, all elements (including their children) that are tagged with `ng-cloak`
+ * are hidden. When Angular encounters this directive during the compilation of the template, it deletes the `ng-cloak`
+ * element attribute, making the compiled element visible.
+ *
+ * # Examples
+ * NgCloak can be used as an attribute:
+ *
+ *     <div ng-cloak>
+ *
+ * Or as a class name:
+ *
+ *      <div class="myclass ng-cloak">
+ *
  */
 @Decorator(selector: '[ng-cloak]')
 @Decorator(selector: '.ng-cloak')
diff --git a/lib/directive/ng_control.dart b/lib/directive/ng_control.dart
@@ -1,11 +1,11 @@
 part of angular.directive;
 
 /**
- * The NgControl class is a super-class for handling info and error states between
- * inner controls and models. NgControl will automatically apply the associated CSS
- * classes for the error and info states that are applied as well as status flags.
- * NgControl is used with the form and fieldset as well as all other directives that
- * are used for user input with NgModel.
+ * Contains info and error states used during form and input validation.
+ *
+ * NgControl is a common superclass for forms and input controls that handles info and error states, as well as
+ * status flags. NgControl is used with the form and fieldset as well as all other directives that are used for
+ * user input with NgModel.
  */
 abstract class NgControl implements AttachAware, DetachAware {
   static const NG_VALID          = "ng-valid";
@@ -93,7 +93,7 @@ abstract class NgControl implements AttachAware, DetachAware {
   bool get invalidSubmit => _submitValid == false;
 
   String get name => _name;
-  void set name(value) {
+  void set name(String value) {
     _name = value;
   }
 

Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`part of angular.directive;`
`2`	`2`	`/**`
`3`		- * Specifies a base CSS to use for components defined under the directive. `Selector:[ng-base-css]`
	`3`	+ * Specifies a base CSS to use for components defined under the directive. `Selector: [ng-base-css]`
`4`	`4`	`*`
`5`	`5`	`* The NgBaseCss directive is typically used at the top of an Angular application, so that everything in the`
`6`	`6`	`* application inherits the specified stylesheet.`
Original file line number	Diff line number	Diff line change
`@@ -2,7 +2,7 @@ part of angular.directive;`
`2`	`2`
`3`	`3`	`/**`
`4`	`4`	`* Sanitizes an HTML string and invokes the browser's parser to insert the string into`
`5`		- * the containing element in the DOM. `Selector:[ng-bind-html]`
	`5`	+ * the containing element in the DOM. `Selector: [ng-bind-html]`
`6`	`6`	`*`
`7`	`7`	`* # Example`
`8`	`8`	`*`
Original file line number	Diff line number	Diff line change
`@@ -1,7 +1,7 @@`
`1`	`1`	`part of angular.directive;`
`2`	`2`
`3`	`3`	`/**`
`4`		- * Replaces the text content of an element with an interpolated template. `Selector:[ng-bind-template]`
	`4`	+ * Replaces the text content of an element with an interpolated template. `Selector: [ng-bind-template]`
`5`	`5`	`*`
`6`	`6`	`* # Example`
`7`	`7`	`*`
Original file line number	Diff line number	Diff line change
`@@ -2,7 +2,7 @@ part of angular.directive;`
`2`	`2`
`3`	`3`	`/**`
`4`	`4`	* The `ngClass` directive allows you to dynamically style an HTML element,
`5`		`- * by binding to an expression that represents the classes to be bound.`
	`5`	+ * by binding to an expression that represents the classes to be bound. `Selector: [ng-class]`
`6`	`6`	`*`
`7`	`7`	`* Classes are specified by a bound model that can be a string, array, or map:`
`8`	`8`	`*`