docs - adding cross links from directives to guide.expression

src/directives.js

@@ -8,7 +8,7 @@
  *  before the template enters execution mode during bootstrap.
  *
  * @element ANY
- * @param {expression} expression to eval.
+ * @param {expression} expression {@link guide.expression Expression} to eval.
  *
  * @example
    <doc:example>
@@ -43,7 +43,7 @@ angularDirective("ng:init", function(expression){
  * The `ng:controller` directive specifies the MVC controller class
  *
  * @element ANY
- * @param {expression} expression to eval.
+ * @param {expression} expression {@link guide.expression Expression} to eval.
  *
  * @example
  * Here is a simple form for editing the user contact information. Adding, removing clearing and
@@ -130,7 +130,7 @@ angularDirective("ng:controller", function(expression){
  * without displaying the result to the user.
  *
  * @element ANY
- * @param {expression} expression to eval.
+ * @param {expression} expression {@link guide.expression Expression} to eval.
  *
  * @example
  * Notice that `{{` `obj.multiplied = obj.a * obj.b` `}}` has a side effect of assigning
@@ -178,7 +178,7 @@ angularDirective("ng:eval", function(expression){
  * `<span ng:bind="expression"></span>` at bootstrap time.
  *
  * @element ANY
- * @param {expression} expression to eval.
+ * @param {expression} expression {@link guide.expression Expression} to eval.
  *
  * @example
  * Try it here: enter text in text box and watch the greeting change.
@@ -335,15 +335,15 @@ var REMOVE_ATTRIBUTES = {
  * @name angular.directive.ng:bind-attr
  *
  * @description
- * The `ng:bind-attr` attribute specifies that the element attributes
+ * The `ng:bind-attr` attribute specifies that {@link guide.data-binding databindings}  should be
- * which should be replaced by the expression in it. Unlike `ng:bind`
+ * created between element attributes and given expressions. Unlike `ng:bind` the `ng:bind-attr`
- * the `ng:bind-attr` contains a JSON key value pairs representing
+ * contains a JSON key value pairs representing which attributes need to be mapped to which
- * which attributes need to be changed. You don’t usually write the
+ * {@link guide.expression expressions}.
- * `ng:bind-attr` in the HTML since embedding
+ *
- * <tt ng:non-bindable>{{expression}}</tt> into the
+ * You don’t usually write the `ng:bind-attr` in the HTML since embedding
- * attribute directly is the preferred way. The attributes get
+ * <tt ng:non-bindable>{{expression}}</tt> into the attribute directly as the attribute value is
- * translated into `<span ng:bind-attr="{attr:expression}"/>` at
+ * preferred. The attributes get translated into `<span ng:bind-attr="{attr:expression}"/>` at
- * bootstrap time.
+ * compile time.
  *
  * This HTML snippet is preferred way of working with `ng:bind-attr`
  * <pre>
@@ -425,7 +425,7 @@ angularDirective("ng:bind-attr", function(expression){
  * element is clicked.
  *
  * @element ANY
- * @param {expression} expression to eval upon click.
+ * @param {expression} expression {@link guide.expression Expression} to eval upon click.
  *
  * @example
    <doc:example>
@@ -476,7 +476,7 @@ angularDirective("ng:click", function(expression, element){
  * server and reloading the current page).
  *
  * @element form
- * @param {expression} expression to eval.
+ * @param {expression} expression {@link guide.expression Expression} to eval.
  *
  * @example
    <doc:example>
@@ -524,7 +524,7 @@ angularDirective("ng:submit", function(expression, element) {
  * an evaluation on variable change.
  *
  * @element ANY
- * @param {expression} expression to eval.
+ * @param {expression} expression {@link guide.expression Expression} to eval.
  *
  * @example
  * Notice that the counter is incremented
@@ -584,7 +584,7 @@ function ngClass(selector) {
  * conditionally.
  *
  * @element ANY
- * @param {expression} expression to eval.
+ * @param {expression} expression {@link guide.expression Expression} to eval.
  *
  * @example
    <doc:example>
@@ -625,7 +625,7 @@ angularDirective("ng:class", ngClass(function(){return true;}));
  * and takes affect only on odd (even) rows.
  *
  * @element ANY
- * @param {expression} expression to eval. Must be inside
+ * @param {expression} expression {@link guide.expression Expression} to eval. Must be inside
  * `ng:repeat`.
  *
  * @example
@@ -663,7 +663,7 @@ angularDirective("ng:class-odd", ngClass(function(i){return i % 2 === 0;}));
  * and takes affect only on odd (even) rows.
  *
  * @element ANY
- * @param {expression} expression to eval. Must be inside
+ * @param {expression} expression {@link guide.expression Expression} to eval. Must be inside
  * `ng:repeat`.
  *
  * @example
@@ -700,8 +700,8 @@ angularDirective("ng:class-even", ngClass(function(i){return i % 2 === 1;}));
  * of the HTML conditionally.
  *
  * @element ANY
- * @param {expression} expression if truthy then the element is
+ * @param {expression} expression If the {@link guide.expression expression} truthy then the element
- * shown or hidden respectively.
+ *     is shown or hidden respectively.
  *
  * @example
    <doc:example>
@@ -741,8 +741,8 @@ angularDirective("ng:show", function(expression, element){
  * of the HTML conditionally.
  *
  * @element ANY
- * @param {expression} expression if truthy then the element is
+ * @param {expression} expression If the {@link guide.expression expression} truthy then the element
- * shown or hidden respectively.
+ *     is shown or hidden respectively.
  *
  * @example
    <doc:example>
@@ -781,9 +781,8 @@ angularDirective("ng:hide", function(expression, element){
  * The ng:style allows you to set CSS style on an HTML element conditionally.
  *
  * @element ANY
- * @param {expression} expression which evals to an object whes key's are
+ * @param {expression} expression {@link guide.expression Expression} which evals to an object who's
- *        CSS style names and values are coresponding values for those
+ *      keys are CSS style names and values are coresponding values for those CSS keys.
- *        CSS keys.
  *
  * @example
    <doc:example>