docs(*): fixed typos

pborreli · pkozlowski-opensource · commit 9480136d9f06 · 2013-03-29T23:14:55.000+01:00
diff --git a/docs/content/guide/dev_guide.templates.databinding.ngdoc b/docs/content/guide/dev_guide.templates.databinding.ngdoc
@@ -2,7 +2,7 @@
 @name Developer Guide: Templates: Data Binding in Angular
 @description
 
-Data-binding in Angular web apps is the automatic syncronization of data between the model and view
+Data-binding in Angular web apps is the automatic synchronization of data between the model and view
 components.  The way that Angular implements data-binding lets you treat the model as the
 single-source-of-truth in your application.  The view is a projection of the model at all times.
 When the model changes, the view reflects the change, and vice versa.
diff --git a/docs/content/guide/directive.ngdoc b/docs/content/guide/directive.ngdoc
@@ -72,7 +72,7 @@ here:
 If an attribute with a binding is prefixed with `ngAttr` prefix (denormalized prefix: 'ng-attr-',
 'ng:attr-') then during the compilation the prefix will be removed and the binding will be applied
 to an unprefixed attribute. This allows binding to attributes that would otherwise be eagerly
-processed by browsers in their uncompilled form (e.g. `img[src]` or svg's `circle[cx]` attributes).
+processed by browsers in their uncompiled form (e.g. `img[src]` or svg's `circle[cx]` attributes).
 
 For example, considering template:
 
@@ -280,7 +280,7 @@ In most cases you will not need such fine control and so the above can be simpli
 different parts of this skeleton are explained in following sections. In this section we are
 interested only in some of this skeleton.
 
-The first step in simplyfing the code is to rely on the default values. Therefore the above can be
+The first step in simplifying the code is to rely on the default values. Therefore the above can be
 simplified as:
 
 <pre>
diff --git a/docs/content/misc/downloading.ngdoc b/docs/content/misc/downloading.ngdoc
@@ -64,8 +64,8 @@ testing angular apps even easier. Your unit/integration test harness should load
 to write and execute end-to-end tests for angular applications.
 
 * __`angular-loader.min.js`__ — Module loader for Angular modules. If you are loading multiple script files containing
- Angular modules, you can load them asynchronosuly and in any order as long as you load this file first. Often the
- contents of this file are copy&pasted into the `index.html` to avoid even the inial request to `angular-loader.min.js`.
+ Angular modules, you can load them asynchronously and in any order as long as you load this file first. Often the
+ contents of this file are copy&pasted into the `index.html` to avoid even the initial request to `angular-loader.min.js`.
  See [angular-seed](https://github.com/angular/angular-seed/blob/master/app/index-async.html) for an example of usage.
 
 * __`angular-resource.js`__, __`angular-cookies.js`__, etc - extra Angular modules with additional functionality.
diff --git a/src/Angular.js b/src/Angular.js
@@ -631,7 +631,7 @@ function shallowCopy(src, dst) {
  * * Both objects or values are of the same type and all of their properties pass `===` comparison.
  * * Both values are NaN. (In JavasScript, NaN == NaN => false. But we consider two NaN as equal)
  *
- * During a property comparision, properties of `function` type and properties with names
+ * During a property comparison, properties of `function` type and properties with names
  * that begin with `$` are ignored.
  *
  * Scope and DOMWindow objects are being compared only be identify (`===`).
@@ -838,7 +838,7 @@ function toKeyValue(obj) {
 
 
 /**
- * We need our custom method because encodeURIComponent is too agressive and doesn't follow
+ * We need our custom method because encodeURIComponent is too aggressive and doesn't follow
  * http://www.ietf.org/rfc/rfc3986.txt with regards to the character set (pchar) allowed in path
  * segments:
  *    segment       = *pchar
@@ -858,7 +858,7 @@ function encodeUriSegment(val) {
 
 /**
  * This method is intended for encoding *key* or *value* parts of query component. We need a custom
- * method becuase encodeURIComponent is too agressive and encodes stuff that doesn't have to be
+ * method because encodeURIComponent is too aggressive and encodes stuff that doesn't have to be
  * encoded per http://tools.ietf.org/html/rfc3986:
  *    query       = *( pchar / "/" / "?" )
  *    pchar         = unreserved / pct-encoded / sub-delims / ":" / "@"
diff --git a/src/bootstrap/google-prettify/prettify.js b/src/bootstrap/google-prettify/prettify.js
@@ -643,7 +643,7 @@ var REGEXP_PRECEDER_PATTERN = '(?:^^\\.?|[+-]|[!=]=?=?|\\#|%=?|&&?=?|\\(|\\*=?|[
     * recognized.
     *
     * Shortcut is an optional string of characters, any of which, if the first
-    * character, gurantee that this pattern and only this pattern matches.
+    * character, guarantee that this pattern and only this pattern matches.
     *
     * @param {Array} shortcutStylePatterns patterns that always start with
     *   a known character.  Must have a shortcut string.
diff --git a/src/jqLite.js b/src/jqLite.js
@@ -59,7 +59,7 @@
  * - [val()](http://api.jquery.com/val/)
  * - [wrap()](http://api.jquery.com/wrap/)
  *
- * ## In addtion to the above, Angular provides additional methods to both jQuery and jQuery lite:
+ * ## In addition to the above, Angular provides additional methods to both jQuery and jQuery lite:
  *
  * - `controller(name)` - retrieves the controller of the current element or its parent. By default
  *   retrieves controller associated with the `ngController` directive. If `name` is provided as
diff --git a/src/ng/browser.js b/src/ng/browser.js
@@ -252,7 +252,7 @@ function Browser(window, document, $log, $sniffer) {
    * @methodOf ng.$browser
    *
    * @param {string=} name Cookie name
-   * @param {string=} value Cokkie value
+   * @param {string=} value Cookie value
    *
    * @description
    * The cookies method provides a 'private' low level access to browser cookies.
@@ -314,7 +314,7 @@ function Browser(window, document, $log, $sniffer) {
    * @returns {*} DeferId that can be used to cancel the task via `$browser.defer.cancel()`.
    *
    * @description
-   * Executes a fn asynchroniously via `setTimeout(fn, delay)`.
+   * Executes a fn asynchronously via `setTimeout(fn, delay)`.
    *
    * Unlike when calling `setTimeout` directly, in test this function is mocked and instead of using
    * `setTimeout` in tests, the fns are queued in an array, which can be programmatically flushed
@@ -341,7 +341,7 @@ function Browser(window, document, $log, $sniffer) {
    * Cancels a defered task identified with `deferId`.
    *
    * @param {*} deferId Token returned by the `$browser.defer` function.
-   * @returns {boolean} Returns `true` if the task hasn't executed yet and was successfuly canceled.
+   * @returns {boolean} Returns `true` if the task hasn't executed yet and was successfully canceled.
    */
   self.defer.cancel = function(deferId) {
     if (pendingDeferIds[deferId]) {
diff --git a/src/ng/compile.js b/src/ng/compile.js
@@ -170,7 +170,7 @@ function $CompileProvider($provide) {
    *
    * @param {string} name Name of the directive in camel-case. (ie <code>ngBind</code> which will match as
    *                <code>ng-bind</code>).
-   * @param {function} directiveFactory An injectable directive factroy function. See {@link guide/directive} for more
+   * @param {function} directiveFactory An injectable directive factory function. See {@link guide/directive} for more
    *                info.
    * @returns {ng.$compileProvider} Self for chaining.
    */
diff --git a/src/ng/directive/input.js b/src/ng/directive/input.js
@@ -805,7 +805,7 @@ var VALID_CLASS = 'ng-valid',
  * @property {Array.<Function>} $formatters Whenever the model value changes, it executes all of
  *     these functions to convert the value as well as validate.
  *
- * @property {Object} $error An bject hash with all errors as keys.
+ * @property {Object} $error An object hash with all errors as keys.
  *
  * @property {boolean} $pristine True if user has not interacted with the control yet.
  * @property {boolean} $dirty True if user has already interacted with the control.
diff --git a/src/ng/directive/ngBind.js b/src/ng/directive/ngBind.js
@@ -12,7 +12,7 @@
  * Typically, you don't use `ngBind` directly, but instead you use the double curly markup like
  * `{{ expression }}` which is similar but less verbose.
  *
- * Once scenario in which the use of `ngBind` is prefered over `{{ expression }}` binding is when
+ * Once scenario in which the use of `ngBind` is preferred over `{{ expression }}` binding is when
  * it's desirable to put bindings into template that is momentarily displayed by the browser in its
  * raw state before Angular compiles it. Since `ngBind` is an element attribute, it makes the
  * bindings invisible to the user while the page is loading.
diff --git a/src/ng/directive/ngCloak.js b/src/ng/directive/ngCloak.js
@@ -10,7 +10,7 @@
  * directive to avoid the undesirable flicker effect caused by the html template display.
  *
  * The directive can be applied to the `<body>` element, but typically a fine-grained application is
- * prefered in order to benefit from progressive rendering of the browser view.
+ * preferred in order to benefit from progressive rendering of the browser view.
  *
  * `ngCloak` works in cooperation with a css rule that is embedded within `angular.js` and
  *  `angular.min.js` files. Following is the css rule:
diff --git a/src/ng/directive/ngPluralize.js b/src/ng/directive/ngPluralize.js
@@ -19,7 +19,7 @@
  * {@link http://unicode.org/repos/cldr-tmp/trunk/diff/supplemental/language_plural_rules.html
  * plural categories} in Angular's default en-US locale: "one" and "other".
  *
- * While a pural category may match many numbers (for example, in en-US locale, "other" can match
+ * While a plural category may match many numbers (for example, in en-US locale, "other" can match
  * any number that is not 1), an explicit number rule can only match one number. For example, the
  * explicit number rule for "3" matches the number 3. You will see the use of plural categories
  * and explicit number rules throughout later parts of this documentation.
@@ -87,7 +87,7 @@
  * plural categories "one" and "other".
  *
  * @param {string|expression} count The variable to be bounded to.
- * @param {string} when The mapping between plural category to its correspoding strings.
+ * @param {string} when The mapping between plural category to its corresponding strings.
  * @param {number=} offset Offset to deduct from the total number.
  *
  * @example
diff --git a/src/ng/directive/ngSwitch.js b/src/ng/directive/ngSwitch.js
@@ -20,7 +20,7 @@
  * @scope
  * @param {*} ngSwitch|on expression to match against <tt>ng-switch-when</tt>.
  * @paramDescription
- * On child elments add:
+ * On child elements add:
  *
  * * `ngSwitchWhen`: the case statement to match against. If match then this
  *   case will be displayed. If the same match appears multiple times, all the
@@ -59,7 +59,7 @@
          select('selection').option('home');
          expect(element('.doc-example-live [ng-switch]').text()).toMatch(/Home Span/);
         });
-        it('should select deafault', function() {
+        it('should select default', function() {
          select('selection').option('other');
          expect(element('.doc-example-live [ng-switch]').text()).toMatch(/default/);
         });
diff --git a/src/ng/filter/orderBy.js b/src/ng/filter/orderBy.js
@@ -9,7 +9,7 @@
  * Orders a specified `array` by the `expression` predicate.
  *
  * Note: this function is used to augment the `Array` type in Angular expressions. See
- * {@link ng.$filter} for more informaton about Angular arrays.
+ * {@link ng.$filter} for more information about Angular arrays.
  *
  * @param {Array} array The array to sort.
  * @param {function(*)|string|Array.<(function(*)|string)>} expression A predicate to be
diff --git a/src/ng/http.js b/src/ng/http.js
@@ -297,7 +297,7 @@ function $HttpProvider() {
      * `$httpProvider.defaults.headers.get['My-Header']='value'`.
      *
      * Additionally, the defaults can be set at runtime via the `$http.defaults` object in a similar
-     * fassion as described above.
+     * fashion as described above.
      *
      *
      * # Transforming Requests and Responses
diff --git a/src/ng/parse.js b/src/ng/parse.js
@@ -697,11 +697,11 @@ function setter(obj, path, setValue) {
 }
 
 /**
- * Return the value accesible from the object by path. Any undefined traversals are ignored
+ * Return the value accessible from the object by path. Any undefined traversals are ignored
  * @param {Object} obj starting object
  * @param {string} path path to traverse
  * @param {boolean=true} bindFnToScope
- * @returns value as accesbile by path
+ * @returns value as accessible by path
  */
 //TODO(misko): this function needs to be removed
 function getter(obj, path, bindFnToScope) {
@@ -873,7 +873,7 @@ function getterFn(path, csp) {
  * @returns {function(context, locals)} a function which represents the compiled expression:
  *
  *    * `context` – `{object}` – an object against which any expressions embedded in the strings
- *      are evaluated against (tipically a scope object).
+ *      are evaluated against (typically a scope object).
  *    * `locals` – `{object=}` – local variables context object, useful for overriding values in
  *      `context`.
  *
diff --git a/src/ng/rootScope.js b/src/ng/rootScope.js
@@ -736,7 +736,7 @@ function $RootScopeProvider(){
        * Afterwards, the event propagates to all direct and indirect scopes of the current scope and
        * calls all registered listeners along the way. The event cannot be canceled.
        *
-       * Any exception emmited from the {@link ng.$rootScope.Scope#$on listeners} will be passed
+       * Any exception emitted from the {@link ng.$rootScope.Scope#$on listeners} will be passed
        * onto the {@link ng.$exceptionHandler $exceptionHandler} service.
        *
        * @param {string} name Event name to emit.
diff --git a/src/ng/route.js b/src/ng/route.js
@@ -486,7 +486,7 @@ function $RouteProvider(){
     }
 
     /**
-     * @returns interpolation of the redirect path with the parametrs
+     * @returns interpolation of the redirect path with the parameters
      */
     function interpolate(string, params) {
       var result = [];
diff --git a/src/ng/window.js b/src/ng/window.js
@@ -8,7 +8,7 @@
  * A reference to the browser's `window` object. While `window`
  * is globally available in JavaScript, it causes testability problems, because
  * it is a global variable. In angular we always refer to it through the
- * `$window` service, so it may be overriden, removed or mocked for testing.
+ * `$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.
diff --git a/src/ngResource/resource.js b/src/ngResource/resource.js
@@ -27,14 +27,14 @@
  *
  * and you ready to get started!
  *
- * @param {string} url A parameterized URL template with parameters prefixed by `:` as in
+ * @param {string} url A parametrized URL template with parameters prefixed by `:` as in
  *   `/user/:username`. If you are using a URL with a port number (e.g.
  *   `http://example.com:8080/api`), you'll need to escape the colon character before the port
  *   number, like this: `$resource('http://example.com\\:8080/api')`.
  *
  * @param {Object=} paramDefaults Default values for `url` parameters. These can be overridden in
  *   `actions` methods. If any of the parameter value is a function, it will be executed every time
- *   when a param value needs to be obtained for a request (unless the param was overriden).
+ *   when a param value needs to be obtained for a request (unless the param was overridden).
  *
  *   Each key value in the parameter object is first bound to url template if present and then any
  *   excess keys are appended to the url search query after the `?`.
@@ -61,7 +61,7 @@
  *     and `JSONP`.
  *   - **`params`** – {Object=} – Optional set of pre-bound parameters for this action. If any of the
  *     parameter value is a function, it will be executed every time when a param value needs to be
- *     obtained for a request (unless the param was overriden).
+ *     obtained for a request (unless the param was overridden).
  *   - **`url`** – {string} – action specific `url` override. The url templating is supported just like
  *     for the resource-level urls.
  *   - **`isArray`** – {boolean=} – If true then the returned object for this action is an array, see
@@ -296,7 +296,7 @@ angular.module('ngResource', ['ng']).
 
     /**
      * This method is intended for encoding *key* or *value* parts of query component. We need a custom
-     * method becuase encodeURIComponent is too agressive and encodes stuff that doesn't have to be
+     * method because encodeURIComponent is too aggressive and encodes stuff that doesn't have to be
      * encoded per http://tools.ietf.org/html/rfc3986:
      *    query       = *( pchar / "/" / "?" )
      *    pchar         = unreserved / pct-encoded / sub-delims / ":" / "@"
diff --git a/src/ngScenario/Scenario.js b/src/ngScenario/Scenario.js
@@ -145,7 +145,7 @@ angular.scenario.setUpAndRun = function(config) {
 
 /**
  * Iterates through list with iterator function that must call the
- * continueFunction to continute iterating.
+ * continueFunction to continue iterating.
  *
  * @param {Array} list list to iterate over
  * @param {function()} iterator Callback function(value, continueFunction)

Original file line number	Diff line number	Diff line change
`@@ -643,7 +643,7 @@ var REGEXP_PRECEDER_PATTERN = '(?:^^\\.?\|[+-]\|[!=]=?=?\|\\#\|%=?\|&&?=?\|\\(\|\\*=?\|[`
`643`	`643`	`* recognized.`
`644`	`644`	`*`
`645`	`645`	`* Shortcut is an optional string of characters, any of which, if the first`
`646`		`- * character, gurantee that this pattern and only this pattern matches.`
	`646`	`+ * character, guarantee that this pattern and only this pattern matches.`
`647`	`647`	`*`
`648`	`648`	`* @param {Array} shortcutStylePatterns patterns that always start with`
`649`	`649`	`* a known character. Must have a shortcut string.`
Original file line number	Diff line number	Diff line change
`@@ -59,7 +59,7 @@`
`59`	`59`	`* - [val()](http://api.jquery.com/val/)`
`60`	`60`	`* - [wrap()](http://api.jquery.com/wrap/)`
`61`	`61`	`*`
`62`		`- * ## In addtion to the above, Angular provides additional methods to both jQuery and jQuery lite:`
	`62`	`+ * ## In addition to the above, Angular provides additional methods to both jQuery and jQuery lite:`
`63`	`63`	`*`
`64`	`64`	* - `controller(name)` - retrieves the controller of the current element or its parent. By default
`65`	`65`	* retrieves controller associated with the `ngController` directive. If `name` is provided as
Original file line number	Diff line number	Diff line change
`@@ -252,7 +252,7 @@ function Browser(window, document, $log, $sniffer) {`
`252`	`252`	`* @methodOf ng.$browser`
`253`	`253`	`*`
`254`	`254`	`* @param {string=} name Cookie name`
`255`		`- * @param {string=} value Cokkie value`
	`255`	`+ * @param {string=} value Cookie value`
`256`	`256`	`*`
`257`	`257`	`* @description`
`258`	`258`	`* The cookies method provides a 'private' low level access to browser cookies.`
`@@ -314,7 +314,7 @@ function Browser(window, document, $log, $sniffer) {`
`314`	`314`	* @returns {*} DeferId that can be used to cancel the task via `$browser.defer.cancel()`.
`315`	`315`	`*`
`316`	`316`	`* @description`
`317`		- * Executes a fn asynchroniously via `setTimeout(fn, delay)`.
	`317`	+ * Executes a fn asynchronously via `setTimeout(fn, delay)`.
`318`	`318`	`*`
`319`	`319`	* Unlike when calling `setTimeout` directly, in test this function is mocked and instead of using
`320`	`320`	* `setTimeout` in tests, the fns are queued in an array, which can be programmatically flushed
`@@ -341,7 +341,7 @@ function Browser(window, document, $log, $sniffer) {`
`341`	`341`	* Cancels a defered task identified with `deferId`.
`342`	`342`	`*`
`343`	`343`	* @param {*} deferId Token returned by the `$browser.defer` function.
`344`		- * @returns {boolean} Returns `true` if the task hasn't executed yet and was successfuly canceled.
	`344`	+ * @returns {boolean} Returns `true` if the task hasn't executed yet and was successfully canceled.
`345`	`345`	`*/`
`346`	`346`	`self.defer.cancel = function(deferId) {`
`347`	`347`	`if (pendingDeferIds[deferId]) {`
Original file line number	Diff line number	Diff line change
`@@ -170,7 +170,7 @@ function $CompileProvider($provide) {`
`170`	`170`	`*`
`171`	`171`	`* @param {string} name Name of the directive in camel-case. (ie <code>ngBind</code> which will match as`
`172`	`172`	`* <code>ng-bind</code>).`
`173`		`- * @param {function} directiveFactory An injectable directive factroy function. See {@link guide/directive} for more`
	`173`	`+ * @param {function} directiveFactory An injectable directive factory function. See {@link guide/directive} for more`
`174`	`174`	`* info.`
`175`	`175`	`* @returns {ng.$compileProvider} Self for chaining.`
`176`	`176`	`*/`
Original file line number	Diff line number	Diff line change
`@@ -805,7 +805,7 @@ var VALID_CLASS = 'ng-valid',`
`805`	`805`	`* @property {Array.<Function>} $formatters Whenever the model value changes, it executes all of`
`806`	`806`	`* these functions to convert the value as well as validate.`
`807`	`807`	`*`
`808`		`- * @property {Object} $error An bject hash with all errors as keys.`
	`808`	`+ * @property {Object} $error An object hash with all errors as keys.`
`809`	`809`	`*`
`810`	`810`	`* @property {boolean} $pristine True if user has not interacted with the control yet.`
`811`	`811`	`* @property {boolean} $dirty True if user has already interacted with the control.`
Original file line number	Diff line number	Diff line change
`@@ -12,7 +12,7 @@`
`12`	`12`	* Typically, you don't use `ngBind` directly, but instead you use the double curly markup like
`13`	`13`	* `{{ expression }}` which is similar but less verbose.
`14`	`14`	`*`
`15`		- * Once scenario in which the use of `ngBind` is prefered over `{{ expression }}` binding is when
	`15`	+ * Once scenario in which the use of `ngBind` is preferred over `{{ expression }}` binding is when
`16`	`16`	`* it's desirable to put bindings into template that is momentarily displayed by the browser in its`
`17`	`17`	* raw state before Angular compiles it. Since `ngBind` is an element attribute, it makes the
`18`	`18`	`* bindings invisible to the user while the page is loading.`