docs($window): improve style and clarify wording

David Sanders · pkozlowski-opensource · commit fd45d590ef92 · 2013-07-21T20:24:33.000+02:00
diff --git a/src/ng/window.js b/src/ng/window.js
@@ -10,8 +10,10 @@
  * it is a global variable. In angular we always refer to it through the
  * `$window` service, so it may be overridden, removed or mocked for testing.
  *
- * All expressions are evaluated with respect to current scope so they don't
- * suffer from window globality.
+ * Expressions, like the one defined for the `ngClick` directive in the example
+ * below, are evaluated with respect to the current scope.  Therefore, there is
+ * no risk of inadvertently coding in a dependency on a global value in such an
+ * expression.
  *
  * @example
    <doc:example>

Original file line number	Diff line number	Diff line change
`@@ -10,8 +10,10 @@`
`10`	`10`	`* it is a global variable. In angular we always refer to it through the`
`11`	`11`	* `$window` service, so it may be overridden, removed or mocked for testing.
`12`	`12`	`*`
`13`		`- * All expressions are evaluated with respect to current scope so they don't`
`14`		`- * suffer from window globality.`
	`13`	+ * Expressions, like the one defined for the `ngClick` directive in the example
	`14`	`+ * below, are evaluated with respect to the current scope. Therefore, there is`
	`15`	`+ * no risk of inadvertently coding in a dependency on a global value in such an`
	`16`	`+ * expression.`
`15`	`17`	`*`
`16`	`18`	`* @example`
`17`	`19`	`<doc:example>`