From 325908d3233442084693561aabde842866010d17 Mon Sep 17 00:00:00 2001
From: Siddique Hameed <siddii+git@gmail.com>
Date: Wed, 22 May 2013 13:47:17 -0500
Subject: [PATCH 01/23] docs(guide/unit-testing): add expression example

* Improved developer guide, directive unit testing documentation code with scope expression
* Removed documentation block with nothing on it
---
 .../guide/dev_guide.unit-testing.ngdoc        | 26 +++++--------------
 1 file changed, 7 insertions(+), 19 deletions(-)

diff --git a/docs/content/guide/dev_guide.unit-testing.ngdoc b/docs/content/guide/dev_guide.unit-testing.ngdoc
index 175af471ff22..c27180fea84a 100644
--- a/docs/content/guide/dev_guide.unit-testing.ngdoc
+++ b/docs/content/guide/dev_guide.unit-testing.ngdoc
@@ -294,14 +294,14 @@ app.directive('aGreatEye', function () {
     return {
         restrict: 'E',
         replace:  true,
-        template: '<h1>lidless, wreathed in flame</h1>'
+        template: '<h1>lidless, wreathed in flame, {{1 + 1}} times</h1>'
     };
 });
 </pre>
 
 This directive is used as a tag `<a-great-eye></a-great-eye>`. It replaces the entire tag with the
-template `<h1>lidless, wreathed in flame</h1>`. Now we are going to write a jasmine unit test to
-verify this functionality.
+template `<h1>lidless, wreathed in flame, {{1 + 1}} times</h1>`. Now we are going to write a jasmine unit test to
+verify this functionality. Note that the expression `{{1 + 1}}` times will also be evaluated in the rendered content.
 
 <pre>
 describe('Unit testing great quotes', function() {
@@ -322,30 +322,18 @@ describe('Unit testing great quotes', function() {
     it('Replaces the element with the appropriate content', function() {
         // Compile a piece of HTML containing the directive
         var element = $compile("<a-great-eye></a-great-eye>")($rootScope);
+        // fire all the watches, so the scope expression {{1 + 1}} will be evaluated
+        $rootScope.$digest();
         // Check that the compiled element contains the templated content
-        expect(element.html()).toContain("lidless, wreathed in flame");
+        expect(element.html()).toContain("lidless, wreathed in flame, 2 times");
     });
 });
 </pre>
 
 We inject the $compile service and $rootScope before each jasmine test. The $compile service is used
 to render the aGreatEye directive. After rendering the directive we ensure that the directive has
-replaced the content and "lidless, wreathed in flame" is present.
+replaced the content and "lidless, wreathed in flame, 2 times" is present.
 
-## Mocks
-oue
-
-## Global State Isolation
-oue
-
-# Preferred way of Testing
-uo
-
-## JavaScriptTestDriver
-ou
-
-## Jasmine
-ou
 
 ## Sample project
 See the {@link https://github.com/angular/angular-seed angular-seed} project for an example.

From 508d845d81e300c98a2498a9358c2b3c98372c87 Mon Sep 17 00:00:00 2001
From: Vojta Jina <vojta.jina@gmail.com>
Date: Fri, 24 May 2013 15:55:11 -0700
Subject: [PATCH 02/23] test(matchers): update toThrow matcher

---
 test/matchers.js | 35 +++++++++++++++++++++++++++++++++++
 1 file changed, 35 insertions(+)

diff --git a/test/matchers.js b/test/matchers.js
index 3630c3b18c98..8e4be118e122 100644
--- a/test/matchers.js
+++ b/test/matchers.js
@@ -151,3 +151,38 @@ beforeEach(function() {
 
   });
 });
+
+
+// TODO(vojta): remove this once Jasmine in Karma gets updated
+// https://github.com/pivotal/jasmine/blob/c40b64a24c607596fa7488f2a0ddb98d063c872a/src/core/Matchers.js#L217-L246
+// This toThrow supports RegExps.
+jasmine.Matchers.prototype.toThrow = function(expected) {
+  var result = false;
+  var exception, exceptionMessage;
+  if (typeof this.actual != 'function') {
+    throw new Error('Actual is not a function');
+  }
+  try {
+    this.actual();
+  } catch (e) {
+    exception = e;
+  }
+
+  if (exception) {
+    exceptionMessage = exception.message || exception;
+    result = (isUndefined(expected) || this.env.equals_(exceptionMessage, expected.message || expected) || (jasmine.isA_("RegExp", expected) && expected.test(exceptionMessage)));
+  }
+
+  var not = this.isNot ? "not " : "";
+  var regexMatch = jasmine.isA_("RegExp", expected) ? " an exception matching" : "";
+
+  this.message = function() {
+    if (exception) {
+      return ["Expected function " + not + "to throw" + regexMatch, expected ? expected.message || expected : "an exception", ", but it threw", exceptionMessage].join(' ');
+    } else {
+      return "Expected function to throw an exception.";
+    }
+  };
+
+  return result;
+};

From 64672501f07c7e8be36b43bce84d3b6ff93655ea Mon Sep 17 00:00:00 2001
From: Igor Minar <igor@angularjs.org>
Date: Fri, 24 May 2013 11:00:14 -0700
Subject: [PATCH 03/23] feat(ngError): add error message compression and better
 error messages

- add toThrowNg matcher
---
 angularFiles.js                   |  1 +
 src/Angular.js                    | 11 +++--
 src/auto/injector.js              | 12 ++---
 src/jqLite.js                     | 14 +++---
 src/loader.js                     |  2 +-
 src/ng/cacheFactory.js            |  2 +-
 src/ng/compile.js                 | 33 +++++--------
 src/ng/controller.js              |  5 +-
 src/ng/directive/input.js         |  7 +--
 src/ng/directive/ngRepeat.js      | 12 ++---
 src/ng/directive/select.js        |  8 ++--
 src/ng/httpBackend.js             |  2 +-
 src/ng/interpolate.js             |  2 +-
 src/ng/location.js                |  6 +--
 src/ng/parse.js                   | 23 +++++----
 src/ng/rootScope.js               | 11 ++---
 src/ngError.js                    | 47 ++++++++++++++++++
 src/ngMock/angular-mocks.js       | 19 ++++----
 test/AngularSpec.js               | 16 ++++---
 test/BinderSpec.js                |  2 +-
 test/auto/injectorSpec.js         | 31 ++++++------
 test/loaderSpec.js                |  2 +-
 test/matchers.js                  |  6 ++-
 test/ng/animatorSpec.js           |  2 +-
 test/ng/cacheFactorySpec.js       |  2 +-
 test/ng/compileSpec.js            | 41 +++++++++++-----
 test/ng/controllerSpec.js         | 10 ++++
 test/ng/directive/inputSpec.js    | 14 +++---
 test/ng/directive/ngRepeatSpec.js | 14 +++---
 test/ng/directive/selectSpec.js   |  4 +-
 test/ng/interpolateSpec.js        |  4 +-
 test/ng/locationSpec.js           |  8 ++--
 test/ng/parseSpec.js              | 10 ++--
 test/ng/rootScopeSpec.js          | 12 ++---
 test/ngErrorSpec.js               | 80 +++++++++++++++++++++++++++++++
 35 files changed, 315 insertions(+), 160 deletions(-)
 create mode 100644 src/ngError.js
 create mode 100644 test/ngErrorSpec.js

diff --git a/angularFiles.js b/angularFiles.js
index 1ffe3310b336..39ccec907d0a 100755
--- a/angularFiles.js
+++ b/angularFiles.js
@@ -5,6 +5,7 @@ angularFiles = {
     'src/AngularPublic.js',
     'src/jqLite.js',
     'src/apis.js',
+    'src/ngError.js',
 
     'src/auto/injector.js',
 
diff --git a/src/Angular.js b/src/Angular.js
index aefe7ad5f5bc..22fb005e0663 100644
--- a/src/Angular.js
+++ b/src/Angular.js
@@ -215,7 +215,7 @@ function nextUid() {
 
 /**
  * Set or clear the hashkey for an object.
- * @param obj object 
+ * @param obj object
  * @param h the hashkey (!truthy to delete the hashkey)
  */
 function setHashKey(obj, h) {
@@ -590,7 +590,10 @@ function isLeafNode (node) {
  * @returns {*} The copy or updated `destination`, if `destination` was specified.
  */
 function copy(source, destination){
-  if (isWindow(source) || isScope(source)) throw Error("Can't copy Window or Scope");
+  if (isWindow(source) || isScope(source)) {
+    throw ngError(43, "Can't copy! Making copies of Window or Scope instances is not supported.");
+  }
+
   if (!destination) {
     destination = source;
     if (source) {
@@ -603,7 +606,7 @@ function copy(source, destination){
       }
     }
   } else {
-    if (source === destination) throw Error("Can't copy equivalent objects or arrays");
+    if (source === destination) throw ngError(44, "Can't copy! Source and destination are identical.");
     if (isArray(source)) {
       destination.length = 0;
       for ( var i = 0; i < source.length; i++) {
@@ -1055,7 +1058,7 @@ function bindJQuery() {
  */
 function assertArg(arg, name, reason) {
   if (!arg) {
-    throw new Error("Argument '" + (name || '?') + "' is " + (reason || "required"));
+    throw ngError(45, "Argument '{0}' is {1}", (name || '?'), (reason || "required"));
   }
   return arg;
 }
diff --git a/src/auto/injector.js b/src/auto/injector.js
index 9c492dc54bd6..1bd56acdf639 100644
--- a/src/auto/injector.js
+++ b/src/auto/injector.js
@@ -422,7 +422,7 @@ function createInjector(modulesToLoad) {
       },
       providerInjector = (providerCache.$injector =
           createInternalInjector(providerCache, function() {
-            throw Error("Unknown provider: " + path.join(' <- '));
+            throw ngError(1, "Unknown provider: {0}", path.join(' <- '));
           })),
       instanceCache = {},
       instanceInjector = (instanceCache.$injector =
@@ -455,7 +455,7 @@ function createInjector(modulesToLoad) {
       provider_ = providerInjector.instantiate(provider_);
     }
     if (!provider_.$get) {
-      throw Error('Provider ' + name + ' must define $get factory method.');
+      throw ngError(2, "Provider '{0}' must define $get factory method.", name);
     }
     return providerCache[name + providerSuffix] = provider_;
   }
@@ -536,12 +536,9 @@ function createInjector(modulesToLoad) {
   function createInternalInjector(cache, factory) {
 
     function getService(serviceName) {
-      if (typeof serviceName !== 'string') {
-        throw Error('Service name expected');
-      }
       if (cache.hasOwnProperty(serviceName)) {
         if (cache[serviceName] === INSTANTIATING) {
-          throw Error('Circular dependency: ' + path.join(' <- '));
+          throw ngError(4, 'Circular dependency found: {0}', path.join(' <- '));
         }
         return cache[serviceName];
       } else {
@@ -563,6 +560,9 @@ function createInjector(modulesToLoad) {
 
       for(i = 0, length = $inject.length; i < length; i++) {
         key = $inject[i];
+        if (typeof key !== 'string') {
+          throw ngError(3, 'Incorrect injection token! Expected service name as string, got {0}', key);
+        }
         args.push(
           locals && locals.hasOwnProperty(key)
           ? locals[key]
diff --git a/src/jqLite.js b/src/jqLite.js
index 218b9683378b..cf9d1fa168e8 100644
--- a/src/jqLite.js
+++ b/src/jqLite.js
@@ -153,7 +153,7 @@ function JQLite(element) {
   }
   if (!(this instanceof JQLite)) {
     if (isString(element) && element.charAt(0) != '<') {
-      throw Error('selectors not implemented');
+      throw ngError(46, 'Looking up elements via selectors is not supported by jqLite! See: http://docs.angularjs.org/api/angular.element');
     }
     return new JQLite(element);
   }
@@ -627,22 +627,22 @@ forEach({
                 }
               }
               return false;
-            };	
+            };
 
           events[type] = [];
-		
-		  // Refer to jQuery's implementation of mouseenter & mouseleave
+
+          // Refer to jQuery's implementation of mouseenter & mouseleave
           // Read about mouseenter and mouseleave:
           // http://www.quirksmode.org/js/events_mouse.html#link8
-          var eventmap = { mouseleave : "mouseout", mouseenter : "mouseover"}          
+          var eventmap = { mouseleave : "mouseout", mouseenter : "mouseover"};
+
           bindFn(element, eventmap[type], function(event) {
             var ret, target = this, related = event.relatedTarget;
             // For mousenter/leave call the handler if related is outside the target.
             // NB: No relatedTarget if the mouse left/entered the browser window
             if ( !related || (related !== target && !contains(target, related)) ){
               handle(event, type);
-            }	
-
+            }
           });
 
         } else {
diff --git a/src/loader.js b/src/loader.js
index 5b74a4f3ac95..7c96a20d3604 100644
--- a/src/loader.js
+++ b/src/loader.js
@@ -70,7 +70,7 @@ function setupModuleLoader(window) {
       }
       return ensure(modules, name, function() {
         if (!requires) {
-          throw Error('No module: ' + name);
+          throw ngError(47, "Module '{0}' is not available! You either misspelled the module name or forgot to load it.", name);
         }
 
         /** @type {!Array.<Array.<*>>} */
diff --git a/src/ng/cacheFactory.js b/src/ng/cacheFactory.js
index ce690ebfe2a4..1c23e06339eb 100644
--- a/src/ng/cacheFactory.js
+++ b/src/ng/cacheFactory.js
@@ -28,7 +28,7 @@ function $CacheFactoryProvider() {
 
     function cacheFactory(cacheId, options) {
       if (cacheId in caches) {
-        throw Error('cacheId ' + cacheId + ' taken');
+        throw ngError(10, "CacheId '{0}' is already taken!", cacheId);
       }
 
       var size = 0,
diff --git a/src/ng/compile.js b/src/ng/compile.js
index 96529d3cdda9..be22482b033b 100644
--- a/src/ng/compile.js
+++ b/src/ng/compile.js
@@ -18,9 +18,6 @@
  */
 
 
-var NON_ASSIGNABLE_MODEL_EXPRESSION = 'Non-assignable model expression: ';
-
-
 /**
  * @ngdoc function
  * @name ng.$compile
@@ -155,7 +152,6 @@ function $CompileProvider($provide) {
       Suffix = 'Directive',
       COMMENT_DIRECTIVE_REGEXP = /^\s*directive\:\s*([\d\w\-_]+)\s+(.*)$/,
       CLASS_DIRECTIVE_REGEXP = /(([\d\w\-_]+)(?:\:([^;]+))?;?)/,
-      MULTI_ROOT_TEMPLATE_ERROR = 'Template must have exactly one root element. was: ',
       urlSanitizationWhitelist = /^\s*(https?|ftp|mailto|file):/;
 
 
@@ -392,10 +388,6 @@ function $CompileProvider($provide) {
       };
     }
 
-    function wrongMode(localName, mode) {
-      throw Error("Unsupported '" + mode + "' for '" + localName + "'.");
-    }
-
     function safeAddClass($element, className) {
       try {
         $element.addClass(className);
@@ -669,7 +661,7 @@ function $CompileProvider($provide) {
             compileNode = $template[0];
 
             if ($template.length != 1 || compileNode.nodeType !== 1) {
-              throw new Error(MULTI_ROOT_TEMPLATE_ERROR + directiveValue);
+              throw ngError(12, "Template for directive '{0}' must have exactly one root element.", directiveName);
             }
 
             replaceWith(jqCollection, $compileNode, compileNode);
@@ -755,7 +747,7 @@ function $CompileProvider($provide) {
           }
           value = $element[retrievalMethod]('$' + require + 'Controller');
           if (!value && !optional) {
-            throw Error("No controller: " + require);
+            throw ngError(13, "Controller '{0}', required by directive '{1}', can't be found!", require, directiveName);
           }
           return value;
         } else if (isArray(require)) {
@@ -783,8 +775,8 @@ function $CompileProvider($provide) {
 
           var parentScope = scope.$parent || scope;
 
-          forEach(newIsolateScopeDirective.scope, function(definiton, scopeName) {
-            var match = definiton.match(LOCAL_REGEXP) || [],
+          forEach(newIsolateScopeDirective.scope, function(definition, scopeName) {
+            var match = definition.match(LOCAL_REGEXP) || [],
                 attrName = match[3] || scopeName,
                 optional = (match[2] == '?'),
                 mode = match[1], // @, =, or &
@@ -815,8 +807,8 @@ function $CompileProvider($provide) {
                 parentSet = parentGet.assign || function() {
                   // reset the change, or we will throw this exception on every $digest
                   lastValue = scope[scopeName] = parentGet(parentScope);
-                  throw Error(NON_ASSIGNABLE_MODEL_EXPRESSION + attrs[attrName] +
-                      ' (directive: ' + newIsolateScopeDirective.name + ')');
+                  throw ngError(14, "Expression '{0}' used with directive '{1}' is non-assignable!",
+                      attrs[attrName], newIsolateScopeDirective.name);
                 };
                 lastValue = scope[scopeName] = parentGet(parentScope);
                 scope.$watch(function parentValueWatch() {
@@ -846,8 +838,8 @@ function $CompileProvider($provide) {
               }
 
               default: {
-                throw Error('Invalid isolate scope definition for directive ' +
-                    newIsolateScopeDirective.name + ': ' + definiton);
+                throw ngError(15, "Invalid isolate scope definition for directive '{0}'. Definition: {... {1}: '{2}' ...}",
+                    newIsolateScopeDirective.name, scopeName, definition);
               }
             }
           });
@@ -1000,7 +992,8 @@ function $CompileProvider($provide) {
             compileNode = $template[0];
 
             if ($template.length != 1 || compileNode.nodeType !== 1) {
-              throw new Error(MULTI_ROOT_TEMPLATE_ERROR + content);
+              throw ngError(16, "Template for directive '{0}' must have exactly one root element. Template: {1}",
+                  origAsyncDirective.name, templateUrl);
             }
 
             tempTemplateAttrs = {$attr: {}};
@@ -1037,7 +1030,7 @@ function $CompileProvider($provide) {
           linkQueue = null;
         }).
         error(function(response, code, headers, config) {
-          throw Error('Failed to load template: ' + config.url);
+          throw ngError(17, 'Failed to load template: {0}', config.url);
         });
 
       return function delayedNodeLinkFn(ignoreChildLinkFn, scope, node, rootElement, controller) {
@@ -1065,8 +1058,8 @@ function $CompileProvider($provide) {
 
     function assertNoDuplicate(what, previousDirective, directive, element) {
       if (previousDirective) {
-        throw Error('Multiple directives [' + previousDirective.name + ', ' +
-          directive.name + '] asking for ' + what + ' on: ' +  startingTag(element));
+        throw ngError(18, 'Multiple directives [{0}, {1}] asking for {2} on: {3}',
+            previousDirective.name, directive.name, what, startingTag(element));
       }
     }
 
diff --git a/src/ng/controller.js b/src/ng/controller.js
index 5c19cf887265..2df0bde9519c 100644
--- a/src/ng/controller.js
+++ b/src/ng/controller.js
@@ -74,9 +74,8 @@ function $ControllerProvider() {
       instance = $injector.instantiate(expression, locals);
 
       if (identifier) {
-        if (typeof locals.$scope !== 'object') {
-          throw new Error('Can not export controller as "' + identifier + '". ' +
-              'No scope object provided!');
+        if (!(locals && typeof locals.$scope == 'object')) {
+          throw ngError(47, "Cannot export controller '{0}' as '{1}'! No $scope object provided via `locals`.", constructor || expression.name, identifier);
         }
 
         locals.$scope[identifier] = instance;
diff --git a/src/ng/directive/input.js b/src/ng/directive/input.js
index 543ed36733a1..610396a566d8 100644
--- a/src/ng/directive/input.js
+++ b/src/ng/directive/input.js
@@ -475,7 +475,8 @@ function textInputType(scope, element, attr, ctrl, $sniffer, $browser) {
         var patternObj = scope.$eval(pattern);
 
         if (!patternObj || !patternObj.test) {
-          throw new Error('Expected ' + pattern + ' to be a RegExp but was ' + patternObj);
+          throw ngError(5, 'ngPattern error! Expected {0} to be a RegExp but was {1}. Element: {2}',
+                                                      pattern,                   patternObj,   startingTag(element));
         }
         return validate(patternObj, value);
       };
@@ -918,8 +919,8 @@ var NgModelController = ['$scope', '$exceptionHandler', '$attrs', '$element', '$
       ngModelSet = ngModelGet.assign;
 
   if (!ngModelSet) {
-    throw Error(NON_ASSIGNABLE_MODEL_EXPRESSION + $attr.ngModel +
-        ' (' + startingTag($element) + ')');
+    throw ngError(6, "ngModel error! Expression '{0}' is non-assignable. Element: {1}", $attr.ngModel,
+        startingTag($element));
   }
 
   /**
diff --git a/src/ng/directive/ngRepeat.js b/src/ng/directive/ngRepeat.js
index 330f6abb18cc..34d32f59adb2 100644
--- a/src/ng/directive/ngRepeat.js
+++ b/src/ng/directive/ngRepeat.js
@@ -157,8 +157,8 @@ var ngRepeatDirective = ['$parse', '$animator', function($parse, $animator) {
           hashFnLocals = {$id: hashKey};
 
         if (!match) {
-          throw Error("Expected ngRepeat in form of '_item_ in _collection_[ track by _id_]' but got '" +
-            expression + "'.");
+          throw ngError(7, "ngRepeat error! Expected expression in form of '_item_ in _collection_[ track by _id_]' but got '{0}'.",
+            expression);
         }
 
         lhs = match[1];
@@ -182,8 +182,8 @@ var ngRepeatDirective = ['$parse', '$animator', function($parse, $animator) {
 
         match = lhs.match(/^(?:([\$\w]+)|\(([\$\w]+)\s*,\s*([\$\w]+)\))$/);
         if (!match) {
-          throw Error("'item' in 'item in collection' should be identifier or (key, value) but got '" +
-              lhs + "'.");
+          throw ngError(8, "ngRepeat error! '_item_' in '_item_ in _collection_' should be an identifier or '(_key_, _value_)' expression, but got '{0}'.",
+                                                                    lhs);
         }
         valueIdentifier = match[3] || match[1];
         keyIdentifier = match[2];
@@ -244,8 +244,8 @@ var ngRepeatDirective = ['$parse', '$animator', function($parse, $animator) {
                if (block && block.element) lastBlockMap[block.id] = block;
              });
              // This is a duplicate and we need to throw an error
-             throw new Error('Duplicates in a repeater are not allowed. Repeater: ' + expression +
-                 ' key: ' + trackById);
+             throw ngError(50, "ngRepeat error! Duplicates in a repeater are not allowed. Use 'track by' expression to specify unique keys. Repeater: {0}, Duplicate key: {1}",
+                                                                                                                                                    expression,       trackById);
            } else {
              // new never before seen block
              nextBlockOrder[index] = { id: trackById };
diff --git a/src/ng/directive/select.js b/src/ng/directive/select.js
index 7a1cab5337ec..6dda33f5d086 100644
--- a/src/ng/directive/select.js
+++ b/src/ng/directive/select.js
@@ -300,9 +300,9 @@ var selectDirective = ['$compile', '$parse', function($compile,   $parse) {
         var match;
 
         if (! (match = optionsExp.match(NG_OPTIONS_REGEXP))) {
-          throw Error(
-            "Expected ngOptions in form of '_select_ (as _label_)? for (_key_,)?_value_ in _collection_ (track by _expr_)?'" +
-            " but got '" + optionsExp + "'.");
+          throw ngError(9,
+            "ngOptions error! Expected expression in form of '_select_ (as _label_)? for (_key_,)?_value_ in _collection_' but got '{0}'. Element: {1}",
+            optionsExp, startingTag(selectElement));
         }
 
         var displayFn = $parse(match[2] || match[1]),
@@ -357,7 +357,7 @@ var selectDirective = ['$compile', '$parse', function($compile,   $parse) {
                       for (var trackIndex = 0; trackIndex < collection.length; trackIndex++) {
                         locals[valueName] = collection[trackIndex];
                         if (trackFn(scope, locals) == key) break;
-                      } 
+                      }
                     } else {
                       locals[valueName] = collection[key];
                     }
diff --git a/src/ng/httpBackend.js b/src/ng/httpBackend.js
index ed8404f96cfb..5b9657057e66 100644
--- a/src/ng/httpBackend.js
+++ b/src/ng/httpBackend.js
@@ -2,7 +2,7 @@ var XHR = window.XMLHttpRequest || function() {
   try { return new ActiveXObject("Msxml2.XMLHTTP.6.0"); } catch (e1) {}
   try { return new ActiveXObject("Msxml2.XMLHTTP.3.0"); } catch (e2) {}
   try { return new ActiveXObject("Msxml2.XMLHTTP"); } catch (e3) {}
-  throw new Error("This browser does not support XMLHttpRequest.");
+  throw ngError(19, "This browser does not support XMLHttpRequest.");
 };
 
 
diff --git a/src/ng/interpolate.js b/src/ng/interpolate.js
index dcf05d778f3e..42218fd383d8 100644
--- a/src/ng/interpolate.js
+++ b/src/ng/interpolate.js
@@ -139,7 +139,7 @@ function $InterpolateProvider() {
             return concat.join('');
           }
           catch(err) {
-            var newErr = new Error('Error while interpolating: ' + text + '\n' + err.toString());
+            var newErr = ngError(48, "$interpolate error! Can't interpolate: {0}\n{1}", text, err.toString());
             $exceptionHandler(newErr);
           }
         };
diff --git a/src/ng/location.js b/src/ng/location.js
index 4efa019c706f..7b011abe9b57 100644
--- a/src/ng/location.js
+++ b/src/ng/location.js
@@ -95,7 +95,7 @@ function LocationHtml5Url(appBase, basePrefix) {
     matchUrl(url, parsed);
     var pathUrl = beginsWith(appBaseNoFile, url);
     if (!isString(pathUrl)) {
-      throw Error('Invalid url "' + url + '", missing path prefix "' + appBaseNoFile + '".');
+      throw ngError(21, '$location error! Invalid url "{0}", missing path prefix "{1}".', url, appBaseNoFile);
     }
     matchAppUrl(pathUrl, parsed);
     extend(this, parsed);
@@ -157,11 +157,11 @@ function LocationHashbangUrl(appBase, hashPrefix) {
     matchUrl(url, this);
     var withoutBaseUrl = beginsWith(appBase, url) || beginsWith(appBaseNoFile, url);
     if (!isString(withoutBaseUrl)) {
-      throw new Error('Invalid url "' + url + '", does not start with "' + appBase +  '".');
+      throw ngError(22, '$location error! Invalid url "{0}", does not start with "{1}".', url, appBase);
     }
     var withoutHashUrl = withoutBaseUrl.charAt(0) == '#' ? beginsWith(hashPrefix, withoutBaseUrl) : withoutBaseUrl;
     if (!isString(withoutHashUrl)) {
-      throw new Error('Invalid url "' + url + '", missing hash prefix "' + hashPrefix + '".');
+      throw ngError(49, '$location error! Invalid url "{0}", missing hash prefix "{1}".', url, hashPrefix);
     }
     matchAppUrl(withoutHashUrl, this);
     this.$$compose();
diff --git a/src/ng/parse.js b/src/ng/parse.js
index 4616d15d267b..5af52f600d6f 100644
--- a/src/ng/parse.js
+++ b/src/ng/parse.js
@@ -123,11 +123,11 @@ function lex(text, csp){
 
   function throwError(error, start, end) {
     end = end || index;
-    throw Error("Lexer Error: " + error + " at column" +
-        (isDefined(start)
-            ? "s " + start +  "-" + index + " [" + text.substring(start, end) + "]"
-            : " " + end) +
-        " in expression [" + text + "].");
+    var colStr = (isDefined(start) ?
+        "s " + start +  "-" + index + " [" + text.substring(start, end) + "]"
+        : " " + end);
+    throw ngError(23, "Lexer Error: {0} at column{1} in expression [{2}].",
+        error, colStr, text);
   }
 
   function readNumber() {
@@ -309,15 +309,14 @@ function parser(text, json, $filter, csp){
 
   ///////////////////////////////////
   function throwError(msg, token) {
-    throw Error("Syntax Error: Token '" + token.text +
-      "' " + msg + " at column " +
-      (token.index + 1) + " of the expression [" +
-      text + "] starting at [" + text.substring(token.index) + "].");
+    throw ngError(24,
+        "Syntax Error: Token '{0}' {1} at column {2} of the expression [{3}] starting at [{4}].",
+        token.text, msg, (token.index + 1), text, text.substring(token.index));
   }
 
   function peekToken() {
     if (tokens.length === 0)
-      throw Error("Unexpected end of expression: " + text);
+      throw ngError(25, "Unexpected end of expression: {0}", text);
     return tokens[0];
   }
 
@@ -366,7 +365,7 @@ function parser(text, json, $filter, csp){
       constant: left.constant && middle.constant && right.constant
     });
   }
-  
+
   function binaryFn(left, fn, right) {
     return extend(function(self, locals) {
       return fn(self, locals, left, right);
@@ -471,7 +470,7 @@ function parser(text, json, $filter, csp){
       return left;
     }
   }
-  
+
   function logicalOR() {
     var left = logicalAND();
     var token;
diff --git a/src/ng/rootScope.js b/src/ng/rootScope.js
index 904f24d4c6d5..6648655133f1 100644
--- a/src/ng/rootScope.js
+++ b/src/ng/rootScope.js
@@ -161,10 +161,6 @@ function $RootScopeProvider(){
         var Child,
             child;
 
-        if (isFunction(isolate)) {
-          // TODO: remove at some point
-          throw Error('API-CHANGE: Use $controller to instantiate controllers.');
-        }
         if (isolate) {
           child = new Scope();
           child.$root = this.$root;
@@ -560,8 +556,9 @@ function $RootScopeProvider(){
 
           if(dirty && !(ttl--)) {
             clearPhase();
-            throw Error(TTL + ' $digest() iterations reached. Aborting!\n' +
-                'Watchers fired in the last 5 iterations: ' + toJson(watchLog));
+            throw ngError(27,
+                '{0} $digest() iterations reached. Aborting!\nWatchers fired in the last 5 iterations: {1}',
+                TTL, toJson(watchLog));
           }
         } while (dirty || asyncQueue.length);
 
@@ -923,7 +920,7 @@ function $RootScopeProvider(){
 
     function beginPhase(phase) {
       if ($rootScope.$$phase) {
-        throw Error($rootScope.$$phase + ' already in progress');
+        throw ngError(28, '{0} already in progress', $rootScope.$$phase);
       }
 
       $rootScope.$$phase = phase;
diff --git a/src/ngError.js b/src/ngError.js
new file mode 100644
index 000000000000..d054336cc7c3
--- /dev/null
+++ b/src/ngError.js
@@ -0,0 +1,47 @@
+'use strict';
+
+/**
+ * @description
+ *
+ * This object extends the error class and provides interpolation capability
+ * to make it easier to write and read Error messages within Angular. It can
+ * be called as follows:
+ *
+ * throw ngError(13, 'This {0} is {1}', foo, bar);
+ *
+ * The above will replace {0} with the value of foo, and {1} with the value of
+ * bar. The object is not restricted in the number of arguments it can take.
+ *
+ * If fewer arguments are specified than necessary for interpolation, the extra
+ * interpolation markers will be preserved in the final string.
+ *
+ * @param {...} arguments The first argument to this object is the error
+ *     number, the second argument the message with templated points for
+ *     Interpolation (of the for {0} for the first, {1} for the second and
+ *     so on). The second argument onwards are interpolated into the error
+ *     message string in order.
+ */
+function ngError() {
+  var message = '[NgErr' + arguments[0] + '] ' + arguments[1],
+      i = 0,
+      l = arguments.length - 2,
+      curlyRegexp, arg;
+
+  for (; i < l; i++) {
+    curlyRegexp = new RegExp("\\{" + i + "\\}", "gm");
+    arg = arguments[i + 2];
+
+    if (isFunction(arg)) {
+      arg = arg.toString().replace(/ \{[\s\S]*$/, '');
+    } else if (!isString(arg)) {
+      arg = toJson(arg);
+    }
+
+    message = message.replace(curlyRegexp, arg);
+  }
+
+  // even if we are called as constructor we can bypass the new ngError instance and return
+  // an instance of a real Error that contains correct stack info + extra frame for ngError call
+  // TODO(i): can we rewrite the stack string to remove ngError frame?
+  return new Error(message);
+}
diff --git a/src/ngMock/angular-mocks.js b/src/ngMock/angular-mocks.js
index be71e326bd3b..647c0be626ee 100644
--- a/src/ngMock/angular-mocks.js
+++ b/src/ngMock/angular-mocks.js
@@ -972,13 +972,12 @@ function createHttpBackendMock($rootScope, $delegate, $browser) {
 
     if (expectation && expectation.match(method, url)) {
       if (!expectation.matchData(data))
-        throw Error('Expected ' + expectation + ' with different data\n' +
+        throw new Error('Expected ' + expectation + ' with different data\n' +
             'EXPECTED: ' + prettyPrint(expectation.data) + '\nGOT:      ' + data);
 
       if (!expectation.matchHeaders(headers))
-        throw Error('Expected ' + expectation + ' with different headers\n' +
-            'EXPECTED: ' + prettyPrint(expectation.headers) + '\nGOT:      ' +
-            prettyPrint(headers));
+        throw new Error('Expected ' + expectation + ' with different headers\n' +
+            'EXPECTED: ' + prettyPrint(expectation.headers) + '\nGOT:      ' + prettyPrint(headers));
 
       expectations.shift();
 
@@ -1002,9 +1001,9 @@ function createHttpBackendMock($rootScope, $delegate, $browser) {
       }
     }
     throw wasExpected ?
-        Error('No response defined !') :
-        Error('Unexpected request: ' + method + ' ' + url + '\n' +
-              (expectation ? 'Expected ' + expectation : 'No more request expected'));
+        new Error('No response defined !') :
+        new Error('Unexpected request: ' + method + ' ' + url + '\n' +
+                  (expectation ? 'Expected ' + expectation : 'No more request expected'));
   }
 
   /**
@@ -1299,7 +1298,7 @@ function createHttpBackendMock($rootScope, $delegate, $browser) {
   $httpBackend.verifyNoOutstandingExpectation = function() {
     $rootScope.$digest();
     if (expectations.length) {
-      throw Error('Unsatisfied requests: ' + expectations.join(', '));
+      throw new Error('Unsatisfied requests: ' + expectations.join(', '));
     }
   };
 
@@ -1451,7 +1450,7 @@ function MockXhr() {
  *
  * This service is just a simple decorator for {@link ng.$timeout $timeout} service
  * that adds a "flush" and "verifyNoPendingTasks" methods.
- */ 
+ */
 
 angular.mock.$TimeoutDecorator = function($delegate, $browser) {
 
@@ -1477,7 +1476,7 @@ angular.mock.$TimeoutDecorator = function($delegate, $browser) {
    */
   $delegate.verifyNoPendingTasks = function() {
     if ($browser.deferredFns.length) {
-      throw Error('Deferred tasks to flush (' + $browser.deferredFns.length + '): ' +
+      throw new Error('Deferred tasks to flush (' + $browser.deferredFns.length + '): ' +
           formatPendingTasksAsString($browser.deferredFns));
     }
   };
diff --git a/test/AngularSpec.js b/test/AngularSpec.js
index 0e5017ad25d9..de0296239231 100644
--- a/test/AngularSpec.js
+++ b/test/AngularSpec.js
@@ -84,19 +84,21 @@ describe('angular', function() {
     });
 
     it('should throw an exception if a Scope is being copied', inject(function($rootScope) {
-      expect(function() { copy($rootScope.$new()); }).toThrow("Can't copy Window or Scope");
+      expect(function() { copy($rootScope.$new()); }).
+          toThrow("[NgErr43] Can't copy! Making copies of Window or Scope instances is not supported.");
     }));
 
     it('should throw an exception if a Window is being copied', function() {
-      expect(function() { copy(window); }).toThrow("Can't copy Window or Scope");
+      expect(function() { copy(window); }).
+          toThrow("[NgErr43] Can't copy! Making copies of Window or Scope instances is not supported.");
     });
 
     it('should throw an exception when source and destination are equivalent', function() {
       var src, dst;
 	    src = dst = {key: 'value'};
-      expect(function() { copy(src, dst); }).toThrow("Can't copy equivalent objects or arrays");
+      expect(function() { copy(src, dst); }).toThrow("[NgErr44] Can't copy! Source and destination are identical.");
       src = dst = [2, 4];
-      expect(function() { copy(src, dst); }).toThrow("Can't copy equivalent objects or arrays");
+      expect(function() { copy(src, dst); }).toThrow("[NgErr44] Can't copy! Source and destination are identical.");
     });
 
     it('should not copy the private $$hashKey', function() {
@@ -580,7 +582,7 @@ describe('angular', function() {
 
       expect(function() {
         angularInit(appElement, bootstrap);
-      }).toThrow('No module: doesntexist');
+      }).toThrow("[NgErr47] Module 'doesntexist' is not available! You either misspelled the module name or forgot to load it.");
     });
   });
 
@@ -724,7 +726,7 @@ describe('angular', function() {
 
       expect(function() {
         angular.bootstrap(element, ['doesntexist']);
-      }).toThrow('No module: doesntexist');
+      }).toThrow("[NgErr47] Module 'doesntexist' is not available! You either misspelled the module name or forgot to load it.");
 
       expect(element.html()).toBe('{{1+2}}');
       dealoc(element);
@@ -783,7 +785,7 @@ describe('angular', function() {
 
         expect(function() {
           element.injector().get('foo');
-        }).toThrow('Unknown provider: fooProvider <- foo');
+        }).toThrow('[NgErr1] Unknown provider: fooProvider <- foo');
 
         expect(element.injector().get('$http')).toBeDefined();
       });
diff --git a/test/BinderSpec.js b/test/BinderSpec.js
index b6a7a00d4dbe..2a1b205d1df8 100644
--- a/test/BinderSpec.js
+++ b/test/BinderSpec.js
@@ -175,7 +175,7 @@ describe('Binder', function() {
       $rootScope.error['throw'] = function() {throw 'MyError';};
       errorLogs.length = 0;
       $rootScope.$apply();
-      expect(errorLogs.shift().message).toBe('Error while interpolating: {{error.throw()}}\nMyError');
+      expect(errorLogs.shift().message).toBe("[NgErr48] $interpolate error! Can't interpolate: {{error.throw()}}\nMyError");
 
       $rootScope.error['throw'] = function() {return 'ok';};
       $rootScope.$apply();
diff --git a/test/auto/injectorSpec.js b/test/auto/injectorSpec.js
index 8fd03be48cbb..b59a344f0466 100644
--- a/test/auto/injectorSpec.js
+++ b/test/auto/injectorSpec.js
@@ -70,7 +70,7 @@ describe('injector', function() {
   it('should provide useful message if no provider', function() {
     expect(function() {
       injector.get('idontexist');
-    }).toThrow("Unknown provider: idontexistProvider <- idontexist");
+    }).toThrow("[NgErr1] Unknown provider: idontexistProvider <- idontexist");
   });
 
 
@@ -79,7 +79,7 @@ describe('injector', function() {
     providers('b', function(a) {return 2;});
     expect(function() {
       injector.get('b');
-    }).toThrow("Unknown provider: idontexistProvider <- idontexist <- a <- b");
+    }).toThrow("[NgErr1] Unknown provider: idontexistProvider <- idontexist <- a <- b");
   });
 
 
@@ -127,10 +127,10 @@ describe('injector', function() {
     it('should fail with errors if not function or array', function() {
       expect(function() {
         injector.invoke({});
-      }).toThrow("Argument 'fn' is not a function, got Object");
+      }).toThrow("[NgErr45] Argument 'fn' is not a function, got Object");
       expect(function() {
         injector.invoke(['a', 123], {});
-      }).toThrow("Argument 'fn' is not a function, got number");
+      }).toThrow("[NgErr45] Argument 'fn' is not a function, got number");
     });
   });
 
@@ -268,7 +268,8 @@ describe('injector', function() {
     it('should error on invalid module name', function() {
       expect(function() {
         createInjector(['IDontExist'], {});
-      }).toThrow("No module: IDontExist");
+      }).toThrow("[NgErr47] Module 'IDontExist' is not available! You either misspelled the module name or forgot to load it.");
+
     });
 
 
@@ -551,7 +552,7 @@ describe('injector', function() {
           createInjector([
             {}
           ], {});
-        }).toThrow("Argument 'module' is not a function, got Object");
+        }).toThrow("[NgErr45] Argument 'module' is not a function, got Object");
       });
 
 
@@ -568,7 +569,7 @@ describe('injector', function() {
         angular.module('TestModule', [], function(xyzzy) {});
         expect(function() {
           createInjector(['TestModule']);
-        }).toThrow('Unknown provider: xyzzy from TestModule');
+        }).toThrow('[NgErr1] Unknown provider: xyzzy from TestModule');
       });
 
 
@@ -576,7 +577,7 @@ describe('injector', function() {
         function myModule(xyzzy){}
         expect(function() {
           createInjector([myModule]);
-        }).toThrow('Unknown provider: xyzzy from ' + myModule);
+        }).toThrow('[NgErr1] Unknown provider: xyzzy from ' + myModule);
       });
 
 
@@ -584,7 +585,7 @@ describe('injector', function() {
         function myModule(xyzzy){}
         expect(function() {
           createInjector([['xyzzy', myModule]]);
-        }).toThrow('Unknown provider: xyzzy from ' + myModule);
+        }).toThrow('[NgErr1] Unknown provider: xyzzy from ' + myModule);
       });
 
 
@@ -594,7 +595,7 @@ describe('injector', function() {
             $provide.factory('service', function(service){});
             return function(service) {}
           }])
-        }).toThrow('Circular dependency: service');
+        }).toThrow("[NgErr4] Circular dependency found: service");
       });
 
 
@@ -605,7 +606,7 @@ describe('injector', function() {
             $provide.factory('b', function(a){});
             return function(a) {}
           }])
-        }).toThrow('Circular dependency: b <- a');
+        }).toThrow('[NgErr4] Circular dependency found: b <- a');
       });
     });
   });
@@ -695,7 +696,7 @@ describe('injector', function() {
     it('should throw usefull error on wrong argument type]', function() {
       expect(function() {
         $injector.invoke({});
-      }).toThrow("Argument 'fn' is not a function, got Object");
+      }).toThrow("[NgErr45] Argument 'fn' is not a function, got Object");
     });
   });
 
@@ -782,7 +783,7 @@ describe('injector', function() {
       }]);
       expect(function() {
         $injector.get('nameProvider');
-      }).toThrow("Unknown provider: nameProviderProvider <- nameProvider");
+      }).toThrow("[NgErr1] Unknown provider: nameProviderProvider <- nameProvider");
     });
 
 
@@ -790,7 +791,7 @@ describe('injector', function() {
       var  $injector = createInjector([]);
       expect(function() {
         $injector.get('$provide').value('a', 'b');
-      }).toThrow("Unknown provider: $provideProvider <- $provide");
+      }).toThrow("[NgErr1] Unknown provider: $provideProvider <- $provide");
     });
 
 
@@ -800,7 +801,7 @@ describe('injector', function() {
         createInjector([function($provide) {
           $provide.value('name', 'angular')
         }, instanceLookupInModule]);
-      }).toThrow('Unknown provider: name from ' + String(instanceLookupInModule));
+      }).toThrow('[NgErr1] Unknown provider: name from ' + String(instanceLookupInModule));
     });
   });
 });
diff --git a/test/loaderSpec.js b/test/loaderSpec.js
index b2341a71ae38..802d5c1dccb8 100644
--- a/test/loaderSpec.js
+++ b/test/loaderSpec.js
@@ -68,6 +68,6 @@ describe('module loader', function() {
   it('should complain of no module', function() {
     expect(function() {
       window.angular.module('dontExist');
-    }).toThrow('No module: dontExist');
+    }).toThrow("[NgErr47] Module 'dontExist' is not available! You either misspelled the module name or forgot to load it.");
   });
 });
diff --git a/test/matchers.js b/test/matchers.js
index 8e4be118e122..13d284e6452e 100644
--- a/test/matchers.js
+++ b/test/matchers.js
@@ -147,8 +147,12 @@ beforeEach(function() {
       return this.actual.hasClass ?
               this.actual.hasClass(clazz) :
               angular.element(this.actual).hasClass(clazz);
-    }
+    },
 
+    toThrowNg: function(expected) {
+      return jasmine.Matchers.prototype.toThrow.call(this, new RegExp('\\[NgErr\\d*\\] ' +
+          expected.replace(/[\-\[\]\/\{\}\(\)\*\+\?\.\\\^\$\|]/g, "\\$&")));
+    }
   });
 });
 
diff --git a/test/ng/animatorSpec.js b/test/ng/animatorSpec.js
index d4d7c0ece02b..cf5667d291f4 100644
--- a/test/ng/animatorSpec.js
+++ b/test/ng/animatorSpec.js
@@ -719,6 +719,6 @@ describe("$animator", function() {
     expect(function() {
       var animate = $animator($rootScope, { ngAnimate: ':' });
       animate.enter();
-    }).toThrow("Syntax Error: Token ':' not a primary expression at column 1 of the expression [:] starting at [:].");
+    }).toThrow("[NgErr24] Syntax Error: Token ':' not a primary expression at column 1 of the expression [:] starting at [:].");
   }));
 });
diff --git a/test/ng/cacheFactorySpec.js b/test/ng/cacheFactorySpec.js
index ddfadbbc3efb..4b15fd7b8ac8 100644
--- a/test/ng/cacheFactorySpec.js
+++ b/test/ng/cacheFactorySpec.js
@@ -15,7 +15,7 @@ describe('$cacheFactory', function() {
   it('should complain if the cache id is being reused', inject(function($cacheFactory) {
     $cacheFactory('cache1');
     expect(function() { $cacheFactory('cache1'); }).
-      toThrow('cacheId cache1 taken');
+      toThrow("[NgErr10] CacheId 'cache1' is already taken!");
   }));
 
 
diff --git a/test/ng/compileSpec.js b/test/ng/compileSpec.js
index 26f61357bee3..bf3d0b777c50 100755
--- a/test/ng/compileSpec.js
+++ b/test/ng/compileSpec.js
@@ -632,11 +632,11 @@ describe('$compile', function() {
           inject(function($compile) {
             expect(function() {
               $compile('<p no-root-elem></p>');
-            }).toThrow('Template must have exactly one root element. was: dada');
+            }).toThrow("[NgErr12] Template for directive 'noRootElem' must have exactly one root element.");
 
             expect(function() {
               $compile('<p multi-root-elem></p>');
-            }).toThrow('Template must have exactly one root element. was: <div></div><div></div>');
+            }).toThrow("[NgErr12] Template for directive 'multiRootElem' must have exactly one root element.");
 
             // ws is ok
             expect(function() {
@@ -985,7 +985,7 @@ describe('$compile', function() {
 
               expect(function() {
                 $httpBackend.flush();
-              }).toThrow('Failed to load template: hello.html');
+              }).toThrow('[NgErr17] Failed to load template: hello.html');
               expect(sortedHtml(element)).toBe('<div><b class="hello"></b></div>');
             }
         ));
@@ -1005,7 +1005,7 @@ describe('$compile', function() {
           inject(function($compile){
             expect(function() {
               $compile('<div><div class="sync async"></div></div>');
-            }).toThrow('Multiple directives [sync, async] asking for template on: '+
+            }).toThrow('[NgErr18] Multiple directives [sync, async] asking for template on: '+
                 '<div class="sync async">');
           });
         });
@@ -1189,14 +1189,14 @@ describe('$compile', function() {
             $compile('<p template></p>');
             $rootScope.$digest();
             expect($exceptionHandler.errors.pop().message).
-                toBe('Template must have exactly one root element. was: dada');
+                toBe("[NgErr16] Template for directive 'template' must have exactly one root element. Template: template.html");
 
             // multi root
             $templateCache.put('template.html', '<div></div><div></div>');
             $compile('<p template></p>');
             $rootScope.$digest();
             expect($exceptionHandler.errors.pop().message).
-                toBe('Template must have exactly one root element. was: <div></div><div></div>');
+                toBe("[NgErr16] Template for directive 'template' must have exactly one root element. Template: template.html");
 
             // ws is ok
             $templateCache.put('template.html', '  <div></div> \n');
@@ -1456,7 +1456,7 @@ describe('$compile', function() {
           function($rootScope, $compile) {
             expect(function(){
               $compile('<div class="iscope-a; scope-b"></div>');
-            }).toThrow('Multiple directives [iscopeA, scopeB] asking for isolated scope on: ' +
+            }).toThrow('[NgErr18] Multiple directives [iscopeA, scopeB] asking for isolated scope on: ' +
                 '<div class="iscope-a; scope-b ng-isolate-scope ng-scope">');
           })
         );
@@ -1466,7 +1466,7 @@ describe('$compile', function() {
           function($rootScope, $compile) {
             expect(function(){
               $compile('<div class="iscope-a; iscope-b"></div>');
-            }).toThrow('Multiple directives [iscopeA, iscopeB] asking for isolated scope on: ' +
+            }).toThrow('[NgErr18] Multiple directives [iscopeA, iscopeB] asking for isolated scope on: ' +
                 '<div class="iscope-a; iscope-b ng-isolate-scope ng-scope">');
           })
         );
@@ -2074,7 +2074,7 @@ describe('$compile', function() {
 
         componentScope.ref = 'ignore me';
         expect($rootScope.$apply).
-            toThrow("Non-assignable model expression: 'hello ' + name (directive: myComponent)");
+            toThrow("[NgErr14] Expression ''hello ' + name' used with directive 'myComponent' is non-assignable!");
         expect(componentScope.ref).toBe('hello world');
         // reset since the exception was rethrown which prevented phase clearing
         $rootScope.$$phase = null;
@@ -2150,7 +2150,7 @@ describe('$compile', function() {
     it('should throw on unknown definition', inject(function() {
       expect(function() {
         compile('<div><span bad-declaration>');
-      }).toThrow('Invalid isolate scope definition for directive badDeclaration: xxx');
+      }).toThrow("[NgErr15] Invalid isolate scope definition for directive 'badDeclaration'. Definition: {... attr: 'xxx' ...}");
     }));
 
     it('should expose a $$isolateBindings property onto the scope', inject(function() {
@@ -2233,6 +2233,25 @@ describe('$compile', function() {
     });
 
 
+    it("should throw an error if required controller can't be found",function() {
+      module(function() {
+        directive('dep', function(log) {
+          return {
+            require: '^main',
+            link: function(scope, element, attrs, controller) {
+              log('dep:' + controller.name);
+            }
+          };
+        });
+      });
+      inject(function(log, $compile, $rootScope) {
+        expect(function() {
+          $compile('<div main><div dep></div></div>')($rootScope);
+        }).toThrow("[NgErr13] Controller 'main', required by directive 'dep', can't be found!");
+      });
+    });
+
+
     it('should have optional controller on current element', function() {
       module(function() {
         directive('dep', function(log) {
@@ -2415,7 +2434,7 @@ describe('$compile', function() {
       inject(function($compile) {
         expect(function() {
           $compile('<div class="first second"></div>');
-        }).toThrow('Multiple directives [first, second] asking for transclusion on: ' +
+        }).toThrow('[NgErr18] Multiple directives [first, second] asking for transclusion on: ' +
             '<div class="first second ng-isolate-scope ng-scope">');
       });
     });
diff --git a/test/ng/controllerSpec.js b/test/ng/controllerSpec.js
index f0dcb407cae8..b041dec71607 100644
--- a/test/ng/controllerSpec.js
+++ b/test/ng/controllerSpec.js
@@ -124,5 +124,15 @@ describe('$controller', function() {
       expect(scope.foo).toBe(foo);
       expect(scope.foo.mark).toBe('foo');
     });
+
+
+    it('should throw an error if $scope is not provided', function() {
+      $controllerProvider.register('a.b.FooCtrl', function() { this.mark = 'foo'; });
+
+      expect(function() {
+        $controller('a.b.FooCtrl as foo');
+      }).toThrow("[NgErr47] Cannot export controller 'a.b.FooCtrl' as 'foo'! No $scope object provided via `locals`.");
+
+    });
   });
 });
diff --git a/test/ng/directive/inputSpec.js b/test/ng/directive/inputSpec.js
index f8898074f13e..68caf1f56ad8 100644
--- a/test/ng/directive/inputSpec.js
+++ b/test/ng/directive/inputSpec.js
@@ -43,7 +43,7 @@ describe('NgModelController', function() {
     }
 
     expect(exception.message).
-        toMatch(/Non-assignable model expression: 1\+2 \(<input( value="")? ng-model="1\+2">\)/);
+        toMatch(/^\[NgErr6\] ngModel error! Expression '1\+2' is non\-assignable\. Element: <input( value="")? ng-model="1\+2">$/);
   }));
 
 
@@ -457,7 +457,7 @@ describe('input', function() {
     expect(function() {
       compileInput('<input type="text" ng-model="throw \'\'">');
       scope.$digest();
-    }).toThrow("Syntax Error: Token '''' is an unexpected token at column 7 of the expression [throw ''] starting at [''].");
+    }).toThrow("[NgErr24] Syntax Error: Token '''' is an unexpected token at column 7 of the expression [throw ''] starting at [''].");
   });
 
 
@@ -548,11 +548,11 @@ describe('input', function() {
     });
 
 
-    xit('should throw an error when scope pattern can\'t be found', function() {
-      compileInput('<input type="text" ng-model="foo" ng-pattern="fooRegexp" />');
-
-      expect(function() { changeInputValueTo('xx'); }).
-          toThrow('Expected fooRegexp to be a RegExp but was undefined');
+    it('should throw an error when scope pattern can\'t be found', function() {
+      expect(function() {
+        compileInput('<input type="text" ng-model="foo" ng-pattern="fooRegexp" />');
+        scope.$apply();
+      }).toThrowNg('ngPattern error! Expected fooRegexp to be a RegExp but was undefined.');
     });
   });
 
diff --git a/test/ng/directive/ngRepeatSpec.js b/test/ng/directive/ngRepeatSpec.js
index e7e9af3549cc..ac6ceb830f2e 100644
--- a/test/ng/directive/ngRepeatSpec.js
+++ b/test/ng/directive/ngRepeatSpec.js
@@ -269,7 +269,7 @@ describe('ngRepeat', function() {
     element = jqLite('<ul><li ng-repeat="i dont parse"></li></ul>');
     $compile(element)(scope);
     expect($exceptionHandler.errors.shift()[0].message).
-        toBe("Expected ngRepeat in form of '_item_ in _collection_[ track by _id_]' but got 'i dont parse'.");
+        toBe("[NgErr7] ngRepeat error! Expected expression in form of '_item_ in _collection_[ track by _id_]' but got 'i dont parse'.");
   });
 
 
@@ -277,7 +277,7 @@ describe('ngRepeat', function() {
       element = jqLite('<ul><li ng-repeat="i dont parse in foo"></li></ul>');
       $compile(element)(scope);
     expect($exceptionHandler.errors.shift()[0].message).
-        toBe("'item' in 'item in collection' should be identifier or (key, value) but got 'i dont parse'.");
+        toBe("[NgErr8] ngRepeat error! '_item_' in '_item_ in _collection_' should be an identifier or '(_key_, _value_)' expression, but got 'i dont parse'.");
   });
 
 
@@ -481,7 +481,7 @@ describe('ngRepeat', function() {
       scope.items = [a, a, a];
       scope.$digest();
       expect($exceptionHandler.errors.shift().message).
-          toEqual('Duplicates in a repeater are not allowed. Repeater: item in items key: object:003');
+          toEqual("[NgErr50] ngRepeat error! Duplicates in a repeater are not allowed. Use 'track by' expression to specify unique keys. Repeater: item in items, Duplicate key: object:003");
 
       // recover
       scope.items = [a];
@@ -501,7 +501,7 @@ describe('ngRepeat', function() {
       scope.items = [d, d, d];
       scope.$digest();
       expect($exceptionHandler.errors.shift().message).
-          toEqual('Duplicates in a repeater are not allowed. Repeater: item in items key: object:009');
+          toEqual("[NgErr50] ngRepeat error! Duplicates in a repeater are not allowed. Use 'track by' expression to specify unique keys. Repeater: item in items, Duplicate key: object:009");
 
       // recover
       scope.items = [a];
@@ -563,7 +563,7 @@ describe('ngRepeat ngAnimate', function() {
   }
 
   function applyCSS(element, cssProp, cssValue) {
-    element.css(cssProp, cssValue);    
+    element.css(cssProp, cssValue);
     element.css(vendorPrefix + cssProp, cssValue);
   }
 
@@ -592,7 +592,7 @@ describe('ngRepeat ngAnimate', function() {
       '<div><div ' +
         'ng-repeat="item in items" ' +
         'ng-animate="{enter: \'custom-enter\'}">' +
-        '{{ item }}' + 
+        '{{ item }}' +
       '</div></div>'
     ))($rootScope);
 
@@ -635,7 +635,7 @@ describe('ngRepeat ngAnimate', function() {
       '<div><div ' +
         'ng-repeat="item in items" ' +
         'ng-animate="{leave: \'custom-leave\'}">' +
-        '{{ item }}' + 
+        '{{ item }}' +
       '</div></div>'
     ))($rootScope);
 
diff --git a/test/ng/directive/selectSpec.js b/test/ng/directive/selectSpec.js
index 0cb2a81222d5..5a168f53de88 100644
--- a/test/ng/directive/selectSpec.js
+++ b/test/ng/directive/selectSpec.js
@@ -494,8 +494,8 @@ describe('select', function() {
     it('should throw when not formated "? for ? in ?"', function() {
       expect(function() {
         compile('<select ng-model="selected" ng-options="i dont parse"></select>');
-      }).toThrow("Expected ngOptions in form of '_select_ (as _label_)? for (_key_,)?_value_ in" +
-                 " _collection_ (track by _expr_)?' but got 'i dont parse'.");
+      }).toThrowNg("ngOptions error! Expected expression in form of '_select_ (as _label_)? for (_key_,)?_value_ in" +
+                   " _collection_' but got 'i dont parse'.");
     });
 
 
diff --git a/test/ng/interpolateSpec.js b/test/ng/interpolateSpec.js
index 2877f92e83e3..0af38506ae46 100644
--- a/test/ng/interpolateSpec.js
+++ b/test/ng/interpolateSpec.js
@@ -32,7 +32,7 @@ describe('$interpolate', function() {
     };
     expect(function () {
       $interpolate('{{err()}}')($rootScope);
-    }).toThrow('Error while interpolating: {{err()}}\nError: oops');
+    }).toThrow("[NgErr48] $interpolate error! Can't interpolate: {{err()}}\nError: oops");
   }));
 
   it('should stop interpolation when encountering an exception', inject(function($interpolate, $compile, $rootScope) {
@@ -43,7 +43,7 @@ describe('$interpolate', function() {
     $compile(dom)($rootScope);
     expect(function () {
       $rootScope.$apply();
-    }).toThrow('Error while interpolating: {{err()}}\nError: oops');
+    }).toThrow("[NgErr48] $interpolate error! Can't interpolate: {{err()}}\nError: oops");
     expect(dom[0].innerHTML).toEqual('2');
     expect(dom[1].innerHTML).toEqual('{{err()}}');
     expect(dom[2].innerHTML).toEqual('{{1 + 2}}');
diff --git a/test/ng/locationSpec.js b/test/ng/locationSpec.js
index c4a88fd93eb0..4aaa4d51520c 100644
--- a/test/ng/locationSpec.js
+++ b/test/ng/locationSpec.js
@@ -203,7 +203,7 @@ describe('$location', function() {
 
       expect(function() {
         url.$$parse('http://other.server.org/path#/path');
-      }).toThrow('Invalid url "http://other.server.org/path#/path", missing path prefix "http://server.org/base/".');
+      }).toThrow('[NgErr21] $location error! Invalid url "http://other.server.org/path#/path", missing path prefix "http://server.org/base/".');
     });
 
 
@@ -212,7 +212,7 @@ describe('$location', function() {
 
       expect(function() {
         url.$$parse('http://server.org/path#/path');
-      }).toThrow('Invalid url "http://server.org/path#/path", missing path prefix "http://server.org/base/".');
+      }).toThrow('[NgErr21] $location error! Invalid url "http://server.org/path#/path", missing path prefix "http://server.org/base/".');
     });
 
 
@@ -325,14 +325,14 @@ describe('$location', function() {
     it('should throw error when invalid server url given', function() {
       expect(function() {
         url.$$parse('http://server.org/path#/path');
-      }).toThrow('Invalid url "http://server.org/path#/path", does not start with "http://www.server.org:1234/base".');
+      }).toThrow('[NgErr22] $location error! Invalid url "http://server.org/path#/path", does not start with "http://www.server.org:1234/base".');
     });
 
 
     it('should throw error when invalid hashbang prefix given', function() {
       expect(function() {
         url.$$parse('http://www.server.org:1234/base#/path');
-      }).toThrow('Invalid url "http://www.server.org:1234/base#/path", missing hash prefix "#!".');
+      }).toThrow('[NgErr49] $location error! Invalid url "http://www.server.org:1234/base#/path", missing hash prefix "#!".');
     });
 
 
diff --git a/test/ng/parseSpec.js b/test/ng/parseSpec.js
index 7d3315b3cea4..c3cb0ce11f4a 100644
--- a/test/ng/parseSpec.js
+++ b/test/ng/parseSpec.js
@@ -156,11 +156,11 @@ describe('parser', function() {
     it('should throws exception for invalid exponent', function() {
       expect(function() {
         lex("0.5E-");
-      }).toThrow(new Error('Lexer Error: Invalid exponent at column 4 in expression [0.5E-].'));
+      }).toThrow(new Error('[NgErr23] Lexer Error: Invalid exponent at column 4 in expression [0.5E-].'));
 
       expect(function() {
         lex("0.5E-A");
-      }).toThrow(new Error('Lexer Error: Invalid exponent at column 4 in expression [0.5E-A].'));
+      }).toThrow(new Error('[NgErr23] Lexer Error: Invalid exponent at column 4 in expression [0.5E-A].'));
     });
 
     it('should tokenize number starting with a dot', function() {
@@ -171,7 +171,7 @@ describe('parser', function() {
     it('should throw error on invalid unicode', function() {
       expect(function() {
         lex("'\\u1''bla'");
-      }).toThrow(new Error("Lexer Error: Invalid unicode escape [\\u1''b] at column 2 in expression ['\\u1''bla']."));
+      }).toThrow(new Error("[NgErr23] Lexer Error: Invalid unicode escape [\\u1''b] at column 2 in expression ['\\u1''bla']."));
     });
   });
 
@@ -304,7 +304,7 @@ describe('parser', function() {
 
         expect(function() {
           scope.$eval("1|nonexistent");
-        }).toThrow(new Error("Unknown provider: nonexistentFilterProvider <- nonexistentFilter"));
+        }).toThrow(new Error("[NgErr1] Unknown provider: nonexistentFilterProvider <- nonexistentFilter"));
 
         scope.offset =  3;
         expect(scope.$eval("'abcd'|substring:1:offset")).toEqual("bc");
@@ -492,7 +492,7 @@ describe('parser', function() {
       it('should throw exception on non-closed bracket', function() {
         expect(function() {
           scope.$eval('[].count(');
-        }).toThrow('Unexpected end of expression: [].count(');
+        }).toThrow('[NgErr25] Unexpected end of expression: [].count(');
       });
 
       it('should evaluate double negation', function() {
diff --git a/test/ng/rootScopeSpec.js b/test/ng/rootScopeSpec.js
index cac7c16017dc..0b258c83a74f 100644
--- a/test/ng/rootScopeSpec.js
+++ b/test/ng/rootScopeSpec.js
@@ -215,7 +215,7 @@ describe('Scope', function() {
 
         expect(function() {
           $rootScope.$digest();
-        }).toThrow('100 $digest() iterations reached. Aborting!\n'+
+        }).toThrow('[NgErr27] 100 $digest() iterations reached. Aborting!\n'+
             'Watchers fired in the last 5 iterations: ' +
             '[["a; newVal: 96; oldVal: 95","b; newVal: 97; oldVal: 96"],' +
             '["a; newVal: 97; oldVal: 96","b; newVal: 98; oldVal: 97"],' +
@@ -299,7 +299,7 @@ describe('Scope', function() {
       $rootScope.$watch('name', function() {
         expect(function() {
           $rootScope.$digest();
-        }).toThrow('$digest already in progress');
+        }).toThrow('[NgErr28] $digest already in progress');
         callCount++;
       });
       $rootScope.name = 'a';
@@ -759,7 +759,7 @@ describe('Scope', function() {
           $rootScope.$apply(function() {
             $rootScope.$apply();
           });
-        }).toThrow('$apply already in progress');
+        }).toThrow('[NgErr28] $apply already in progress');
       }));
 
 
@@ -771,7 +771,7 @@ describe('Scope', function() {
               $rootScope.$apply();
             });
           });
-        }).toThrow('$digest already in progress');
+        }).toThrow('[NgErr28] $digest already in progress');
       }));
 
 
@@ -781,7 +781,7 @@ describe('Scope', function() {
         childScope1.$watch('x', function() {
           childScope1.$apply();
         });
-        expect(function() { childScope1.$apply(); }).toThrow('$digest already in progress');
+        expect(function() { childScope1.$apply(); }).toThrow('[NgErr28] $digest already in progress');
       }));
 
 
@@ -798,7 +798,7 @@ describe('Scope', function() {
 
         expect(function() { childScope2.$apply(function() {
           childScope2.x = 'something';
-        }); }).toThrow('$digest already in progress');
+        }); }).toThrow('[NgErr28] $digest already in progress');
       }));
     });
   });
diff --git a/test/ngErrorSpec.js b/test/ngErrorSpec.js
new file mode 100644
index 000000000000..81773322841c
--- /dev/null
+++ b/test/ngErrorSpec.js
@@ -0,0 +1,80 @@
+'use strict';
+
+describe('ngError', function() {
+
+  var supportStackTraces = function() {
+    var e = new Error();
+    return isDefined(e.stack);
+  };
+
+  it('should return an Error instance', function() {
+    var myError = ngError();
+    expect(myError instanceof Error).toBe(true);
+  });
+
+
+  it('should generate stack trace at the frame where ngError was called', function() {
+    var myError;
+
+    function someFn() {
+      function nestedFn() {
+        myError = ngError(0, "I fail!");
+      }
+      nestedFn();
+    }
+
+    someFn();
+
+    // only Chrome, Firefox have stack
+    if (!supportStackTraces()) return;
+
+    expect(myError.stack).toMatch(/^[.\s\S]+nestedFn[.\s\S]+someFn.+/);
+  });
+
+
+  it('should interpolate string arguments without quotes', function() {
+    var myError = ngError(26, 'This {0} is "{1}"', 'foo', 'bar');
+    expect(myError.message).toBe('[NgErr26] This foo is "bar"');
+  });
+
+
+  it('should interpolate non-string arguments', function() {
+    var arr = [1, 2, 3],
+        obj = {a: 123, b: 'baar'},
+        anonFn = function(something) { return something; },
+        namedFn = function foo(something) { return something; },
+        myError;
+
+    myError = ngError(26, 'arr: {0}; obj: {1}; anonFn: {2}; namedFn: {3}',
+                               arr,      obj,      anonFn,      namedFn);
+
+    expect(myError.message).toContain('[NgErr26] arr: [1,2,3]; obj: {"a":123,"b":"baar"};');
+    // IE does not add space after "function"
+    expect(myError.message).toMatch(/anonFn: function\s?\(something\);/);
+    expect(myError.message).toContain('namedFn: function foo(something)');
+  });
+
+
+  it('should not suppress falsy objects', function() {
+    var myError = ngError(26, 'false: {0}; zero: {1}; null: {2}; undefined: {3}; emptyStr: {4}',
+                                   false,      0,         null,      undefined,      '');
+    expect(myError.message).
+        toBe('[NgErr26] false: false; zero: 0; null: null; undefined: undefined; emptyStr: ');
+  });
+
+
+  it('should preserve interpolation markers when fewer arguments than needed are provided', function() {
+    // this way we can easily see if we are passing fewer args than needed
+
+    var foo = 'Fooooo',
+        myError = ngError(26, 'This {0} is {1} on {2}', foo);
+
+    expect(myError.message).toBe('[NgErr26] This Fooooo is {1} on {2}');
+  });
+
+
+  it('should pass through the message if no interpolation is needed', function() {
+    var myError = ngError(26, 'Something horrible happened!');
+    expect(myError.message).toBe('[NgErr26] Something horrible happened!');
+  });
+});

From f2472174dee2824ec11b6d879b48e33ae313a356 Mon Sep 17 00:00:00 2001
From: Misko Hevery <misko@hevery.com>
Date: Fri, 24 May 2013 12:41:38 -0700
Subject: [PATCH 04/23] feat($compile): support multi-element directive

By appending  directive-start and directive-end to a
directive it is now possible to have the directive
act on a group of elements.

It is now possible to iterate over multiple elements like so:

<table>
  <tr ng-repeat-start="item in list">I get repeated</tr>
  <tr ng-repeat-end>I also get repeated</tr>
</table>
---
 src/jqLite.js                |  50 ++++++++------
 src/ng/animator.js           |  15 +++--
 src/ng/compile.js            | 123 ++++++++++++++++++++++++++++------
 src/ng/directive/ngRepeat.js |   2 +-
 test/jqLiteSpec.js           |  12 ++--
 test/ng/compileSpec.js       | 125 +++++++++++++++++++++++++++++++++++
 6 files changed, 276 insertions(+), 51 deletions(-)

diff --git a/src/jqLite.js b/src/jqLite.js
index cf9d1fa168e8..4959a2ed36b9 100644
--- a/src/jqLite.js
+++ b/src/jqLite.js
@@ -165,7 +165,8 @@ function JQLite(element) {
     div.innerHTML = '<div>&#160;</div>' + element; // IE insanity to make NoScope elements work!
     div.removeChild(div.firstChild); // remove the superfluous div
     JQLiteAddNodes(this, div.childNodes);
-    this.remove(); // detach the elements from the temporary DOM div.
+    var fragment = jqLite(document.createDocumentFragment());
+    fragment.append(this); // detach the elements from the temporary DOM div.
   } else {
     JQLiteAddNodes(this, element);
   }
@@ -456,24 +457,26 @@ forEach({
     }
   },
 
-  text: extend((msie < 9)
-      ? function(element, value) {
-        if (element.nodeType == 1 /** Element */) {
-          if (isUndefined(value))
-            return element.innerText;
-          element.innerText = value;
-        } else {
-          if (isUndefined(value))
-            return element.nodeValue;
-          element.nodeValue = value;
-        }
+  text: (function() {
+    var NODE_TYPE_TEXT_PROPERTY = [];
+    if (msie < 9) {
+      NODE_TYPE_TEXT_PROPERTY[1] = 'innerText';    /** Element **/
+      NODE_TYPE_TEXT_PROPERTY[3] = 'nodeValue';    /** Text **/
+    } else {
+      NODE_TYPE_TEXT_PROPERTY[1] =                 /** Element **/
+      NODE_TYPE_TEXT_PROPERTY[3] = 'textContent';  /** Text **/
+    }
+    getText.$dv = '';
+    return getText;
+
+    function getText(element, value) {
+      var textProp = NODE_TYPE_TEXT_PROPERTY[element.nodeType]
+      if (isUndefined(value)) {
+        return textProp ? element[textProp] : '';
       }
-      : function(element, value) {
-        if (isUndefined(value)) {
-          return element.textContent;
-        }
-        element.textContent = value;
-      }, {$dv:''}),
+      element[textProp] = value;
+    }
+  })(),
 
   val: function(element, value) {
     if (isUndefined(value)) {
@@ -518,8 +521,14 @@ forEach({
         return this;
       } else {
         // we are a read, so read the first child.
-        if (this.length)
-          return fn(this[0], arg1, arg2);
+        var value = fn.$dv;
+        // Only if we have $dv do we iterate over all, otherwise it is just the first element.
+        var jj = value == undefined ? Math.min(this.length, 1) : this.length;
+        for (var j = 0; j < jj; j++) {
+          var nodeValue = fn(this[j], arg1, arg2);
+          value = value ? value + nodeValue : nodeValue;
+        }
+        return value;
       }
     } else {
       // we are a write, so apply to all children
@@ -529,7 +538,6 @@ forEach({
       // return self for chaining
       return this;
     }
-    return fn.$dv;
   };
 });
 
diff --git a/src/ng/animator.js b/src/ng/animator.js
index 2965717bdc3d..2b399813264b 100644
--- a/src/ng/animator.js
+++ b/src/ng/animator.js
@@ -395,11 +395,16 @@ var $AnimatorProvider = function() {
         }
   
         function insert(element, parent, after) {
-          if (after) {
-            after.after(element);
-          } else {
-            parent.append(element);
-          }
+          var afterNode = after && after[after.length - 1];
+          var parentNode = parent && parent[0] || afterNode && afterNode.parentNode;
+          var afterNextSibling = afterNode && afterNode.nextSibling;
+          forEach(element, function(node) {
+            if (afterNextSibling) {
+              parentNode.insertBefore(node, afterNextSibling);
+            } else {
+              parentNode.appendChild(node);
+            }
+          });
         }
   
         function remove(element) {
diff --git a/src/ng/compile.js b/src/ng/compile.js
index be22482b033b..2dddf82dcbff 100644
--- a/src/ng/compile.js
+++ b/src/ng/compile.js
@@ -358,11 +358,12 @@ function $CompileProvider($provide) {
         // jquery always rewraps, whereas we need to preserve the original selector so that we can modify it.
         $compileNodes = jqLite($compileNodes);
       }
+      var tempParent = document.createDocumentFragment();
       // We can not compile top level text elements since text nodes can be merged and we will
       // not be able to attach scope data to them, so we will wrap them in <span>
       forEach($compileNodes, function(node, index){
         if (node.nodeType == 3 /* text node */ && node.nodeValue.match(/\S+/) /* non-empty */ ) {
-          $compileNodes[index] = jqLite(node).wrap('<span></span>').parent()[0];
+          $compileNodes[index] = node = jqLite(node).wrap('<span></span>').parent()[0];
         }
       });
       var compositeLinkFn = compileNodes($compileNodes, transcludeFn, $compileNodes, maxPriority);
@@ -420,7 +421,7 @@ function $CompileProvider($provide) {
         attrs = new Attributes();
 
         // we must always refer to nodeList[i] since the nodes can be replaced underneath us.
-        directives = collectDirectives(nodeList[i], [], attrs, maxPriority);
+        directives = collectDirectives(nodeList[i], [], attrs, i == 0 ? maxPriority : undefined);
 
         nodeLinkFn = (directives.length)
             ? applyDirectivesToNode(directives, nodeList[i], attrs, transcludeFn, $rootElement)
@@ -509,6 +510,10 @@ function $CompileProvider($provide) {
           // iterate over the attributes
           for (var attr, name, nName, ngAttrName, value, nAttrs = node.attributes,
                    j = 0, jj = nAttrs && nAttrs.length; j < jj; j++) {
+            var attrStartName;
+            var attrEndName;
+            var index;
+
             attr = nAttrs[j];
             if (attr.specified) {
               name = attr.name;
@@ -517,6 +522,11 @@ function $CompileProvider($provide) {
               if (NG_ATTR_BINDING.test(ngAttrName)) {
                 name = ngAttrName.substr(6).toLowerCase();
               }
+              if ((index = ngAttrName.lastIndexOf('Start')) != -1 && index == ngAttrName.length - 5) {
+                attrStartName = name;
+                attrEndName = name.substr(0, name.length - 5) + 'end';
+                name = name.substr(0, name.length - 6);
+              }
               nName = directiveNormalize(name.toLowerCase());
               attrsMap[nName] = name;
               attrs[nName] = value = trim((msie && name == 'href')
@@ -526,7 +536,7 @@ function $CompileProvider($provide) {
                 attrs[nName] = true; // presence means true
               }
               addAttrInterpolateDirective(node, directives, value, nName);
-              addDirective(directives, nName, 'A', maxPriority);
+              addDirective(directives, nName, 'A', maxPriority, attrStartName, attrEndName);
             }
           }
 
@@ -565,6 +575,47 @@ function $CompileProvider($provide) {
       return directives;
     }
 
+    /**
+     * Given a node with an directive-start it collects all of the siblings until it find directive-end.
+     * @param node
+     * @param attrStart
+     * @param attrEnd
+     * @returns {*}
+     */
+    function groupScan(node, attrStart, attrEnd) {
+      var nodes = [];
+      var depth = 0;
+      if (attrStart && node.hasAttribute && node.hasAttribute(attrStart)) {
+        var startNode = node;
+        do {
+          if (!node) {
+            throw ngError(51, "Unterminated attribute, found '{0}' but no matching '{1}' found.", attrStart, attrEnd);
+          }
+          if (node.hasAttribute(attrStart)) depth++;
+          if (node.hasAttribute(attrEnd)) depth--;
+          nodes.push(node);
+          node = node.nextSibling;
+        } while (depth > 0);
+      } else {
+        nodes.push(node);
+      }
+      return jqLite(nodes);
+    }
+
+    /**
+     * Wrapper for linking function which converts normal linking function into a grouped
+     * linking function.
+     * @param linkFn
+     * @param attrStart
+     * @param attrEnd
+     * @returns {Function}
+     */
+    function groupElementsLinkFnWrapper(linkFn, attrStart, attrEnd) {
+      return function(scope, element, attrs, controllers) {
+        element = groupScan(element[0], attrStart, attrEnd);
+        return linkFn(scope, element, attrs, controllers);
+      }
+    }
 
     /**
      * Once the directives have been collected, their compile functions are executed. This method
@@ -601,6 +652,13 @@ function $CompileProvider($provide) {
       // executes all directives on the current element
       for(var i = 0, ii = directives.length; i < ii; i++) {
         directive = directives[i];
+        var attrStart = directive.$$start;
+        var attrEnd = directive.$$end;
+
+        // collect multiblock sections
+        if (attrStart) {
+          $compileNode = groupScan(compileNode, attrStart, attrEnd)
+        }
         $template = undefined;
 
         if (terminalPriority > directive.priority) {
@@ -631,11 +689,11 @@ function $CompileProvider($provide) {
           transcludeDirective = directive;
           terminalPriority = directive.priority;
           if (directiveValue == 'element') {
-            $template = jqLite(compileNode);
+            $template = groupScan(compileNode, attrStart, attrEnd)
             $compileNode = templateAttrs.$$element =
                 jqLite(document.createComment(' ' + directiveName + ': ' + templateAttrs[directiveName] + ' '));
             compileNode = $compileNode[0];
-            replaceWith(jqCollection, jqLite($template[0]), compileNode);
+            replaceWith(jqCollection, jqLite(sliceArgs($template)), compileNode);
             childTranscludeFn = compile($template, transcludeFn, terminalPriority);
           } else {
             $template = jqLite(JQLiteClone(compileNode)).contents();
@@ -699,9 +757,9 @@ function $CompileProvider($provide) {
           try {
             linkFn = directive.compile($compileNode, templateAttrs, childTranscludeFn);
             if (isFunction(linkFn)) {
-              addLinkFns(null, linkFn);
+              addLinkFns(null, linkFn, attrStart, attrEnd);
             } else if (linkFn) {
-              addLinkFns(linkFn.pre, linkFn.post);
+              addLinkFns(linkFn.pre, linkFn.post, attrStart, attrEnd);
             }
           } catch (e) {
             $exceptionHandler(e, startingTag($compileNode));
@@ -723,12 +781,14 @@ function $CompileProvider($provide) {
 
       ////////////////////
 
-      function addLinkFns(pre, post) {
+      function addLinkFns(pre, post, attrStart, attrEnd) {
         if (pre) {
+          if (attrStart) pre = groupElementsLinkFnWrapper(pre, attrStart, attrEnd);
           pre.require = directive.require;
           preLinkFns.push(pre);
         }
         if (post) {
+          if (attrStart) post = groupElementsLinkFnWrapper(post, attrStart, attrEnd);
           post.require = directive.require;
           postLinkFns.push(post);
         }
@@ -907,8 +967,8 @@ function $CompileProvider($provide) {
      *   * `M`: comment
      * @returns true if directive was added.
      */
-    function addDirective(tDirectives, name, location, maxPriority) {
-      var match = false;
+    function addDirective(tDirectives, name, location, maxPriority, startAttrName, endAttrName) {
+      var match = null;
       if (hasDirectives.hasOwnProperty(name)) {
         for(var directive, directives = $injector.get(name + Suffix),
             i = 0, ii = directives.length; i<ii; i++) {
@@ -916,8 +976,11 @@ function $CompileProvider($provide) {
             directive = directives[i];
             if ( (maxPriority === undefined || maxPriority > directive.priority) &&
                  directive.restrict.indexOf(location) != -1) {
+              if (startAttrName) {
+                directive = inherit(directive, {$$start: startAttrName, $$end: endAttrName});
+              }
               tDirectives.push(directive);
-              match = true;
+              match = directive;
             }
           } catch(e) { $exceptionHandler(e); }
         }
@@ -1120,30 +1183,50 @@ function $CompileProvider($provide) {
      *
      * @param {JqLite=} $rootElement The root of the compile tree. Used so that we can replace nodes
      *    in the root of the tree.
-     * @param {JqLite} $element The jqLite element which we are going to replace. We keep the shell,
+     * @param {JqLite} elementsToRemove The jqLite element which we are going to replace. We keep the shell,
      *    but replace its DOM node reference.
      * @param {Node} newNode The new DOM node.
      */
-    function replaceWith($rootElement, $element, newNode) {
-      var oldNode = $element[0],
-          parent = oldNode.parentNode,
+    function replaceWith($rootElement, elementsToRemove, newNode) {
+      var firstElementToRemove = elementsToRemove[0],
+          removeCount = elementsToRemove.length,
+          parent = firstElementToRemove.parentNode,
           i, ii;
 
       if ($rootElement) {
         for(i = 0, ii = $rootElement.length; i < ii; i++) {
-          if ($rootElement[i] == oldNode) {
-            $rootElement[i] = newNode;
+          if ($rootElement[i] == firstElementToRemove) {
+            $rootElement[i++] = newNode;
+            for (var j = i, j2 = j + removeCount - 1,
+                     jj = $rootElement.length;
+                 j < jj; j++, j2++) {
+              if (j2 < jj) {
+                $rootElement[j] = $rootElement[j2];
+              } else {
+                delete $rootElement[j];
+              }
+            }
+            $rootElement.length -= removeCount - 1;
             break;
           }
         }
       }
 
       if (parent) {
-        parent.replaceChild(newNode, oldNode);
+        parent.replaceChild(newNode, firstElementToRemove);
+      }
+      var fragment = document.createDocumentFragment();
+      fragment.appendChild(firstElementToRemove);
+      newNode[jqLite.expando] = firstElementToRemove[jqLite.expando];
+      for (var k = 1, kk = elementsToRemove.length; k < kk; k++) {
+        var element = elementsToRemove[k];
+        jqLite(element).remove(); // must do this way to clean up expando
+        fragment.appendChild(element);
+        delete elementsToRemove[k];
       }
 
-      newNode[jqLite.expando] = oldNode[jqLite.expando];
-      $element[0] = newNode;
+      elementsToRemove[0] = newNode;
+      elementsToRemove.length = 1
     }
   }];
 }
diff --git a/src/ng/directive/ngRepeat.js b/src/ng/directive/ngRepeat.js
index 34d32f59adb2..6c2da071956d 100644
--- a/src/ng/directive/ngRepeat.js
+++ b/src/ng/directive/ngRepeat.js
@@ -258,7 +258,7 @@ var ngRepeatDirective = ['$parse', '$animator', function($parse, $animator) {
             if (lastBlockMap.hasOwnProperty(key)) {
               block = lastBlockMap[key];
               animate.leave(block.element);
-              block.element[0][NG_REMOVED] = true;
+              forEach(block.element, function(element) { element[NG_REMOVED] = true});
               block.scope.$destroy();
             }
           }
diff --git a/test/jqLiteSpec.js b/test/jqLiteSpec.js
index 1ebe6ad48943..70c18d35600f 100644
--- a/test/jqLiteSpec.js
+++ b/test/jqLiteSpec.js
@@ -56,6 +56,9 @@ describe('jqLite', function() {
 
     it('should allow construction with html', function() {
       var nodes = jqLite('<div>1</div><span>2</span>');
+      expect(nodes[0].parentNode).toBeDefined();
+      expect(nodes[0].parentNode.nodeType).toBe(11); /** Document Fragment **/;
+      expect(nodes[0].parentNode).toBe(nodes[1].parentNode);
       expect(nodes.length).toEqual(2);
       expect(nodes[0].innerHTML).toEqual('1');
       expect(nodes[1].innerHTML).toEqual('2');
@@ -644,12 +647,13 @@ describe('jqLite', function() {
 
 
     it('should read/write value', function() {
-      var element = jqLite('<div>abc</div>');
-      expect(element.length).toEqual(1);
-      expect(element[0].innerHTML).toEqual('abc');
+      var element = jqLite('<div>ab</div><span>c</span>');
+      expect(element.length).toEqual(2);
+      expect(element[0].innerHTML).toEqual('ab');
+      expect(element[1].innerHTML).toEqual('c');
       expect(element.text()).toEqual('abc');
       expect(element.text('xyz') == element).toBeTruthy();
-      expect(element.text()).toEqual('xyz');
+      expect(element.text()).toEqual('xyzxyz');
     });
   });
 
diff --git a/test/ng/compileSpec.js b/test/ng/compileSpec.js
index bf3d0b777c50..95b2ab72d93f 100755
--- a/test/ng/compileSpec.js
+++ b/test/ng/compileSpec.js
@@ -2718,4 +2718,129 @@ describe('$compile', function() {
       expect(element.attr('test4')).toBe('Misko');
     }));
   });
+
+
+  describe('multi-element directive', function() {
+    it('should group on link function', inject(function($compile, $rootScope) {
+      $rootScope.show = false;
+      element = $compile(
+          '<div>' +
+              '<span ng-show-start="show"></span>' +
+              '<span ng-show-end></span>' +
+          '</div>')($rootScope);
+      $rootScope.$digest();
+      var spans = element.find('span');
+      expect(spans.eq(0).css('display')).toBe('none');
+      expect(spans.eq(1).css('display')).toBe('none');
+    }));
+
+
+    it('should group on compile function', inject(function($compile, $rootScope) {
+      $rootScope.show = false;
+      element = $compile(
+          '<div>' +
+              '<span ng-repeat-start="i in [1,2]">{{i}}A</span>' +
+              '<span ng-repeat-end>{{i}}B;</span>' +
+          '</div>')($rootScope);
+      $rootScope.$digest();
+      expect(element.text()).toEqual('1A1B;2A2B;');
+    }));
+
+
+    it('should group on $root compile function', inject(function($compile, $rootScope) {
+      $rootScope.show = false;
+      element = $compile(
+          '<div></div>' +
+              '<span ng-repeat-start="i in [1,2]">{{i}}A</span>' +
+              '<span ng-repeat-end>{{i}}B;</span>' +
+          '<div></div>')($rootScope);
+      $rootScope.$digest();
+      element = jqLite(element[0].parentNode.childNodes); // reset because repeater is top level.
+      expect(element.text()).toEqual('1A1B;2A2B;');
+    }));
+
+
+    it('should group on nested groups', inject(function($compile, $rootScope) {
+      $rootScope.show = false;
+      element = $compile(
+          '<div></div>' +
+              '<div ng-repeat-start="i in [1,2]">{{i}}A</div>' +
+              '<span ng-bind-start="\'.\'"></span>' +
+              '<span ng-bind-end></span>' +
+              '<div ng-repeat-end>{{i}}B;</div>' +
+          '<div></div>')($rootScope);
+      $rootScope.$digest();
+      element = jqLite(element[0].parentNode.childNodes); // reset because repeater is top level.
+      expect(element.text()).toEqual('1A..1B;2A..2B;');
+    }));
+
+
+    it('should group on nested groups', inject(function($compile, $rootScope) {
+      $rootScope.show = false;
+      element = $compile(
+          '<div></div>' +
+              '<div ng-repeat-start="i in [1,2]">{{i}}(</div>' +
+              '<span ng-repeat-start="j in [2,3]">{{j}}-</span>' +
+              '<span ng-repeat-end>{{j}}</span>' +
+              '<div ng-repeat-end>){{i}};</div>' +
+          '<div></div>')($rootScope);
+      $rootScope.$digest();
+      element = jqLite(element[0].parentNode.childNodes); // reset because repeater is top level.
+      expect(element.text()).toEqual('1(2-23-3)1;2(2-23-3)2;');
+    }));
+
+
+    it('should throw error if unterminated', function () {
+      module(function($compileProvider) {
+        $compileProvider.directive('foo', function() {
+          return {
+          };
+        });
+      });
+      inject(function($compile, $rootScope) {
+        expect(function() {
+          element = $compile(
+              '<div>' +
+                '<span foo-start></span>' +
+              '</div>');
+        }).toThrow("[NgErr51] Unterminated attribute, found 'foo-start' but no matching 'foo-end' found.");
+      });
+    });
+
+
+    it('should throw error if unterminated', function () {
+      module(function($compileProvider) {
+        $compileProvider.directive('foo', function() {
+          return {
+          };
+        });
+      });
+      inject(function($compile, $rootScope) {
+        expect(function() {
+          element = $compile(
+              '<div>' +
+                  '<span foo-start><span foo-end></span></span>' +
+              '</div>');
+        }).toThrow("[NgErr51] Unterminated attribute, found 'foo-start' but no matching 'foo-end' found.");
+      });
+    });
+
+
+    it('should support data- and x- prefix', inject(function($compile, $rootScope) {
+      $rootScope.show = false;
+      element = $compile(
+          '<div>' +
+              '<span data-ng-show-start="show"></span>' +
+              '<span data-ng-show-end></span>' +
+              '<span x-ng-show-start="show"></span>' +
+              '<span x-ng-show-end></span>' +
+          '</div>')($rootScope);
+      $rootScope.$digest();
+      var spans = element.find('span');
+      expect(spans.eq(0).css('display')).toBe('none');
+      expect(spans.eq(1).css('display')).toBe('none');
+      expect(spans.eq(2).css('display')).toBe('none');
+      expect(spans.eq(3).css('display')).toBe('none');
+    }));
+  });
 });

From 513e79a1e63cbde1b70325b569bd299a22c6cc95 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Matias=20Niemel=C3=A4?= <matias@yearofmoo.com>
Date: Mon, 20 May 2013 21:00:12 -0400
Subject: [PATCH 05/23] feat(ngdocs): provide support for inline variable
 hinting

---
 docs/spec/ngdocSpec.js       |  5 +++++
 docs/src/ngdoc.js            |  4 ++++
 src/ng/directive/ngRepeat.js | 10 ++++++----
 3 files changed, 15 insertions(+), 4 deletions(-)

diff --git a/docs/spec/ngdocSpec.js b/docs/spec/ngdocSpec.js
index 3cd9834b9423..9eed24ca28db 100644
--- a/docs/spec/ngdocSpec.js
+++ b/docs/spec/ngdocSpec.js
@@ -150,6 +150,11 @@ describe('ngdoc', function() {
         toMatch('</pre>\n\n<h1 id="one">One</h1>\n\n<pre');
     });
 
+    it('should replace inline variable type hints', function() {
+      expect(new Doc().markdown('{@type string}')).
+        toMatch(/<a\s+.*?class=".*?type-hint type-hint-string.*?".*?>/);
+    });
+
     it('should ignore nested doc widgets', function() {
       expect(new Doc().markdown(
         'before<div class="tabbable">\n' +
diff --git a/docs/src/ngdoc.js b/docs/src/ngdoc.js
index 7c07f00ffdcf..d66f33e64b0c 100644
--- a/docs/src/ngdoc.js
+++ b/docs/src/ngdoc.js
@@ -214,6 +214,10 @@ Doc.prototype = {
             (title || url).replace(/^#/g, '').replace(/\n/g, ' ') +
             (isAngular ? '</code>' : '') +
             '</a>';
+        }).
+        replace(/{@type\s+(\S+)(?:\s+(\S+))?}/g, function(_, type, url) {
+          url = url || '#';
+          return '<a href="' + url + '" class="' + self.prepare_type_hint_class_name(type) + '">' + type + '</a>';
         });
     });
     text = parts.join('');
diff --git a/src/ng/directive/ngRepeat.js b/src/ng/directive/ngRepeat.js
index 6c2da071956d..89b402c87b20 100644
--- a/src/ng/directive/ngRepeat.js
+++ b/src/ng/directive/ngRepeat.js
@@ -11,10 +11,12 @@
  *
  * Special properties are exposed on the local scope of each template instance, including:
  *
- *   * `$index` – `{number}` – iterator offset of the repeated element (0..length-1)
- *   * `$first` – `{boolean}` – true if the repeated element is first in the iterator.
- *   * `$middle` – `{boolean}` – true if the repeated element is between the first and last in the iterator.
- *   * `$last` – `{boolean}` – true if the repeated element is last in the iterator.
+ * | Variable  | Type            | Details                                                                     |
+ * |===========|=================|=============================================================================|
+ * | `$index`  | {@type number}  | iterator offset of the repeated element (0..length-1)                       |
+ * | `$first`  | {@type boolean} | true if the repeated element is first in the iterator.                      |
+ * | `$middle` | {@type boolean} | true if the repeated element is between the first and last in the iterator. |
+ * | `$last`   | {@type boolean} | true if the repeated element is last in the iterator.                       |
  *
  * Additionally, you can also provide animations via the ngAnimate attribute to animate the **enter**,
  * **leave** and **move** effects.

From f004b872a583c0221a4f947153d5c2fc794ed10c Mon Sep 17 00:00:00 2001
From: Gias Kay Lee <balancetraveller+github@gmail.com>
Date: Thu, 23 May 2013 14:02:52 +0800
Subject: [PATCH 06/23] docs(): Rectify animator.animate documentation

---
 src/ng/animator.js | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/src/ng/animator.js b/src/ng/animator.js
index 2b399813264b..b588de2445bb 100644
--- a/src/ng/animator.js
+++ b/src/ng/animator.js
@@ -262,7 +262,8 @@ var $AnimatorProvider = function() {
          * @description
          * Triggers a custom animation event to be executed on the given element
          *
-         * @param {jQuery/jqLite element} element that will be animated
+         * @param {string} event the name of the custom event 
+         * @param {jQuery/jqLite element} element the element that will be animated
         */
         animator.animate = function(event, element) {
           animateActionFactory(event, noop, noop)(element);

From afc325c7aceff8ac685a78d5a0b13c79834e73ab Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Matias=20Niemel=C3=A4?= <matias@yearofmoo.com>
Date: Sun, 26 May 2013 20:28:47 -0400
Subject: [PATCH 07/23] fix($animator): ensure $animator calculates the highest
 duration + delay for and transitions and animations together

---
 src/ng/animator.js      | 37 +++++++++++++++++++------------------
 test/ng/animatorSpec.js | 27 +++++++++++++++++++++++++++
 2 files changed, 46 insertions(+), 18 deletions(-)

diff --git a/src/ng/animator.js b/src/ng/animator.js
index b588de2445bb..a9ec161611db 100644
--- a/src/ng/animator.js
+++ b/src/ng/animator.js
@@ -345,28 +345,29 @@ var $AnimatorProvider = function() {
                 var ELEMENT_NODE = 1;
                 forEach(element, function(element) {
                   if (element.nodeType == ELEMENT_NODE) {
-                    var w3cProp = w3cTransitionProp,
-                        vendorProp = vendorTransitionProp,
-                        iterations = 1,
-                        elementStyles = $window.getComputedStyle(element) || {};
+                    var elementStyles = $window.getComputedStyle(element) || {};
 
-                    //use CSS Animations over CSS Transitions
-                    if(parseFloat(elementStyles[w3cAnimationProp + durationKey]) > 0 ||
-                       parseFloat(elementStyles[vendorAnimationProp + durationKey]) > 0) {
-                      w3cProp = w3cAnimationProp;
-                      vendorProp = vendorAnimationProp;
-                      iterations = Math.max(parseInt(elementStyles[w3cProp    + animationIterationCountKey]) || 0,
-                                            parseInt(elementStyles[vendorProp + animationIterationCountKey]) || 0,
-                                            iterations);
-                    }
+                    var transitionDelay     = Math.max(parseMaxTime(elementStyles[w3cTransitionProp     + delayKey]),
+                                                       parseMaxTime(elementStyles[vendorTransitionProp  + delayKey]));
+
+                    var animationDelay      = Math.max(parseMaxTime(elementStyles[w3cAnimationProp      + delayKey]),
+                                                       parseMaxTime(elementStyles[vendorAnimationProp   + delayKey]));
 
-                    var parsedDelay     = Math.max(parseMaxTime(elementStyles[w3cProp     + delayKey]),
-                                                   parseMaxTime(elementStyles[vendorProp  + delayKey]));
+                    var transitionDuration  = Math.max(parseMaxTime(elementStyles[w3cTransitionProp     + durationKey]),
+                                                       parseMaxTime(elementStyles[vendorTransitionProp  + durationKey]));
 
-                    var parsedDuration  = Math.max(parseMaxTime(elementStyles[w3cProp     + durationKey]),
-                                                   parseMaxTime(elementStyles[vendorProp  + durationKey]));
+                    var animationDuration   = Math.max(parseMaxTime(elementStyles[w3cAnimationProp      + durationKey]),
+                                                       parseMaxTime(elementStyles[vendorAnimationProp   + durationKey]));
+
+                    if(animationDuration > 0) {
+                      animationDuration *= Math.max(parseInt(elementStyles[w3cAnimationProp    + animationIterationCountKey]) || 0,
+                                                   parseInt(elementStyles[vendorAnimationProp + animationIterationCountKey]) || 0,
+                                                   1);
+                    }
 
-                    duration = Math.max(parsedDelay + (iterations * parsedDuration), duration);
+                    duration = Math.max(animationDelay  + animationDuration,
+                                        transitionDelay + transitionDuration,
+                                        duration);
                   }
                 });
                 $window.setTimeout(done, duration * 1000);
diff --git a/test/ng/animatorSpec.js b/test/ng/animatorSpec.js
index cf5667d291f4..439836091587 100644
--- a/test/ng/animatorSpec.js
+++ b/test/ng/animatorSpec.js
@@ -666,6 +666,33 @@ describe("$animator", function() {
           expect(element[0].style.display).toBe('');
       }));
 
+      it("should select the highest duration and delay",
+        inject(function($animator, $rootScope, $compile, $sniffer) {
+          var styles = 'transition:1s linear all 2s;' + 
+                       vendorPrefix + 'transition:1s linear all 2s;' + 
+                       'animation:my_ani 10s 1s;' + 
+                       vendorPrefix + 'animation:my_ani 10s 1s;';
+
+          element = $compile(html('<div style="' + styles + '">foo</div>'))($rootScope);
+
+          var animator = $animator($rootScope, {
+            ngAnimate : '{show: \'inline-show\'}'
+          });
+
+          element.css('display','none');
+          expect(element.css('display')).toBe('none');
+
+          animator.show(element);
+          if ($sniffer.transitions) {
+            window.setTimeout.expect(1).process();
+            window.setTimeout.expect(11000).process();
+          }
+          else {
+            expect(window.setTimeout.queue.length).toBe(0);
+          }
+          expect(element[0].style.display).toBe('');
+      }));
+
       it("should finish the previous transition when a new animation is started",
         inject(function($animator, $rootScope, $compile, $sniffer) {
           var style = 'transition: 1s linear all;' +

From 44946f9fb3a60fe8bda2860dc52c387e82f0650e Mon Sep 17 00:00:00 2001
From: Jeff Cross <middlefloor@gmail.com>
Date: Wed, 29 May 2013 13:44:59 -0700
Subject: [PATCH 08/23] fix(jqLite): Added optional name arg in removeData

jQuery's API for removeData allows a second 'name' argument to just
remove the property by that name from an element's data. The absence
of this argument was causing some features not to work correctly when
combining multiple directives, such as ng-click, ng-show, and ng-animate.
---
 src/jqLite.js           |  7 ++++++-
 test/jqLiteSpec.js      | 19 +++++++++++++++++++
 test/ng/animatorSpec.js | 22 ++++++++++++++++++++++
 3 files changed, 47 insertions(+), 1 deletion(-)

diff --git a/src/jqLite.js b/src/jqLite.js
index 4959a2ed36b9..4c68cdef325f 100644
--- a/src/jqLite.js
+++ b/src/jqLite.js
@@ -204,11 +204,16 @@ function JQLiteUnbind(element, type, fn) {
   }
 }
 
-function JQLiteRemoveData(element) {
+function JQLiteRemoveData(element, name) {
   var expandoId = element[jqName],
       expandoStore = jqCache[expandoId];
 
   if (expandoStore) {
+    if (name) {
+      delete jqCache[expandoId].data[name];
+      return;
+    }
+
     if (expandoStore.handle) {
       expandoStore.events.$destroy && expandoStore.handle({}, '$destroy');
       JQLiteUnbind(element);
diff --git a/test/jqLiteSpec.js b/test/jqLiteSpec.js
index 70c18d35600f..f121e1a055e0 100644
--- a/test/jqLiteSpec.js
+++ b/test/jqLiteSpec.js
@@ -246,6 +246,25 @@ describe('jqLite', function() {
       expect(jqLite(c).data('prop')).toBeUndefined();
     });
 
+    it('should only remove the specified value when providing a property name to removeData', function () {
+      var selected = jqLite(a);
+
+      expect(selected.data('prop1')).toBeUndefined();
+
+      selected.data('prop1', 'value');
+      selected.data('prop2', 'doublevalue');
+
+      expect(selected.data('prop1')).toBe('value');
+      expect(selected.data('prop2')).toBe('doublevalue');
+
+      selected.removeData('prop1');
+
+      expect(selected.data('prop1')).toBeUndefined();
+      expect(selected.data('prop2')).toBe('doublevalue');
+
+      selected.removeData('prop2');
+    });
+
     it('should emit $destroy event if element removed via remove()', function() {
       var log = '';
       var element = jqLite(a);
diff --git a/test/ng/animatorSpec.js b/test/ng/animatorSpec.js
index 439836091587..63fcf5c3ea02 100644
--- a/test/ng/animatorSpec.js
+++ b/test/ng/animatorSpec.js
@@ -345,11 +345,33 @@ describe("$animator", function() {
       });
 
       child.css('display','none');
+      element.data('foo', 'bar');
       animator.show(element);
       window.setTimeout.expect(1).process();
+
       animator.hide(element);
 
       expect(element.hasClass('animation-cancelled')).toBe(true);
+      expect(element.data('foo')).toEqual('bar');
+    }));
+
+    it("should NOT clobber all data on an element when animation is finished",
+      inject(function($animator, $rootScope) {
+      $animator.enabled(true);
+
+      animator = $animator($rootScope, {
+        ngAnimate : '{hide: \'custom-delay\', show: \'custom-delay\'}'
+      });
+
+      child.css('display','none');
+      element.data('foo', 'bar');
+
+      animator.show(element);
+      window.setTimeout.expect(1).process();
+
+      animator.hide(element);
+
+      expect(element.data('foo')).toEqual('bar');
     }));
 
 

From cd3410ab668ba369be1291516febf427b9da61d8 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Lucas=20Galfas=C3=B3?= <lgalfaso@gmail.com>
Date: Fri, 24 May 2013 22:43:09 -0300
Subject: [PATCH 09/23] chore(docs): add reference to the blog

Add a reference to the blog at the documentation.
---
 docs/src/templates/index.html | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/src/templates/index.html b/docs/src/templates/index.html
index 6054f81344e0..a3edba30f0e9 100644
--- a/docs/src/templates/index.html
+++ b/docs/src/templates/index.html
@@ -155,6 +155,7 @@
                 <i class="icon-comment icon-white"></i> Discuss <b class="caret"></b>
               </a>
               <ul class="dropdown-menu">
+                <li><a href="http://blog.angularjs.org">Blog</a></li>
                 <li><a href="http://groups.google.com/group/angular">Mailing List</a></li>
                 <li><a href="http://webchat.freenode.net/?channels=angularjs&uio=d4">Chat Room</a></li>
                 <li class="divider"></li>

From c72bec5d161518804e3228c0c2b1c65fd395f012 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Matias=20Niemel=C3=A4?= <matias@yearofmoo.com>
Date: Wed, 22 May 2013 22:37:42 -0400
Subject: [PATCH 10/23] fix(ngController): fix indentation bug which causes
 example to mess up

---
 src/ng/directive/ngController.js | 49 +++++++++++++++-----------------
 1 file changed, 23 insertions(+), 26 deletions(-)

diff --git a/src/ng/directive/ngController.js b/src/ng/directive/ngController.js
index be2f149f4a1a..289ee034e9e7 100644
--- a/src/ng/directive/ngController.js
+++ b/src/ng/directive/ngController.js
@@ -35,32 +35,32 @@
    <doc:example>
      <doc:source>
       <script>
-        function SettingsController() {
+        function SettingsController1() {
           this.name = "John Smith";
           this.contacts = [
             {type: 'phone', value: '408 555 1212'},
             {type: 'email', value: 'john.smith@example.org'} ];
           };
 
-        SettingsController.prototype.greet = function() {
+        SettingsController1.prototype.greet = function() {
           alert(this.name);
         };
 
-        SettingsController.prototype.addContact = function() {
+        SettingsController1.prototype.addContact = function() {
           this.contacts.push({type: 'email', value: 'yourname@example.org'});
         };
 
-        SettingsController.prototype.removeContact = function(contactToRemove) {
+        SettingsController1.prototype.removeContact = function(contactToRemove) {
          var index = this.contacts.indexOf(contactToRemove);
           this.contacts.splice(index, 1);
         };
 
-        SettingsController.prototype.clearContact = function(contact) {
+        SettingsController1.prototype.clearContact = function(contact) {
           contact.type = 'phone';
           contact.value = '';
         };
       </script>
-      <div ng-controller="SettingsController as settings">
+      <div id="ctrl-as-exmpl" ng-controller="SettingsController1 as settings">
         Name: <input type="text" ng-model="settings.name"/>
         [ <a href="" ng-click="settings.greet()">greet</a> ]<br/>
         Contact:
@@ -79,29 +79,26 @@
       </div>
      </doc:source>
      <doc:scenario>
-       it('should check controller', function() {
-         expect(element('.doc-example-live div>:input').val()).toBe('John Smith');
-         expect(element('.doc-example-live li:nth-child(1) input').val())
+       it('should check controller as', function() {
+         expect(element('#ctrl-as-exmpl>:input').val()).toBe('John Smith');
+         expect(element('#ctrl-as-exmpl li:nth-child(1) input').val())
            .toBe('408 555 1212');
-         expect(element('.doc-example-live li:nth-child(2) input').val())
+         expect(element('#ctrl-as-exmpl li:nth-child(2) input').val())
            .toBe('john.smith@example.org');
 
-         element('.doc-example-live li:first a:contains("clear")').click();
-         expect(element('.doc-example-live li:first input').val()).toBe('');
+         element('#ctrl-as-exmpl li:first a:contains("clear")').click();
+         expect(element('#ctrl-as-exmpl li:first input').val()).toBe('');
 
-         element('.doc-example-live li:last a:contains("add")').click();
-         expect(element('.doc-example-live li:nth-child(3) input').val())
+         element('#ctrl-as-exmpl li:last a:contains("add")').click();
+         expect(element('#ctrl-as-exmpl li:nth-child(3) input').val())
            .toBe('yourname@example.org');
        });
      </doc:scenario>
    </doc:example>
-
-
-
     <doc:example>
      <doc:source>
       <script>
-        function SettingsController($scope) {
+        function SettingsController2($scope) {
           $scope.name = "John Smith";
           $scope.contacts = [
             {type:'phone', value:'408 555 1212'},
@@ -126,7 +123,7 @@
           };
         }
       </script>
-      <div ng-controller="SettingsController">
+      <div id="ctrl-exmpl" ng-controller="SettingsController2">
         Name: <input type="text" ng-model="name"/>
         [ <a href="" ng-click="greet()">greet</a> ]<br/>
         Contact:
@@ -146,17 +143,17 @@
      </doc:source>
      <doc:scenario>
        it('should check controller', function() {
-         expect(element('.doc-example-live div>:input').val()).toBe('John Smith');
-         expect(element('.doc-example-live li:nth-child(1) input').val())
+         expect(element('#ctrl-exmpl>:input').val()).toBe('John Smith');
+         expect(element('#ctrl-exmpl li:nth-child(1) input').val())
            .toBe('408 555 1212');
-         expect(element('.doc-example-live li:nth-child(2) input').val())
+         expect(element('#ctrl-exmpl li:nth-child(2) input').val())
            .toBe('john.smith@example.org');
 
-         element('.doc-example-live li:first a:contains("clear")').click();
-         expect(element('.doc-example-live li:first input').val()).toBe('');
+         element('#ctrl-exmpl li:first a:contains("clear")').click();
+         expect(element('#ctrl-exmpl li:first input').val()).toBe('');
 
-         element('.doc-example-live li:last a:contains("add")').click();
-         expect(element('.doc-example-live li:nth-child(3) input').val())
+         element('#ctrl-exmpl li:last a:contains("add")').click();
+         expect(element('#ctrl-exmpl li:nth-child(3) input').val())
            .toBe('yourname@example.org');
        });
      </doc:scenario>

From 738bf569c5d1c869e1bd87dceed410c19dada133 Mon Sep 17 00:00:00 2001
From: adamshaylor <business@adamshaylor.com>
Date: Thu, 23 May 2013 11:33:10 -0600
Subject: [PATCH 11/23] docs(overview.ngdoc): clarify wording

---
 docs/content/guide/overview.ngdoc | 28 ++++++++++++++--------------
 1 file changed, 14 insertions(+), 14 deletions(-)

diff --git a/docs/content/guide/overview.ngdoc b/docs/content/guide/overview.ngdoc
index 837c0a3f3a1b..a8e806cd5f27 100644
--- a/docs/content/guide/overview.ngdoc
+++ b/docs/content/guide/overview.ngdoc
@@ -8,28 +8,28 @@
 AngularJS is a structural framework for dynamic web apps. It lets you use HTML as your template
 language and lets you extend HTML's syntax to express your application's components clearly and
 succinctly. Out of the box, it eliminates much of the code you currently write through data
-binding and dependency injection. And it all happens in JavaScript within the browser making it an
-ideal partner with any server technology.
+binding and dependency injection. And it all happens in JavaScript within the browser, making it
+an ideal partner with any server technology.
 
 Angular is what HTML would have been had it been designed for applications. HTML is a great
 declarative language for static documents. It does not contain much in the way of creating
-applications, and as a result building web applications is an exercise in *what do I have to do, so
-that I trick the browser in to doing what I want.*
+applications, and as a result building web applications is an exercise in *what do I have to do
+to trick the browser into doing what I want.*
 
-The impedance mismatch between dynamic applications and static documents is often solved as:
+The impedance mismatch between dynamic applications and static documents is often solved with:
 
-  * **library** - a collection of functions which are useful when writing web apps. Your code is
+  * **a library** - a collection of functions which are useful when writing web apps. Your code is
     in charge and it calls into the library when it sees fit. E.g., `jQuery`.
   * **frameworks** - a particular implementation of a web application, where your code fills in
     the details. The framework is in charge and it calls into your code when it needs something
-    app specific. E.g., `knockout`, `sproutcore`, etc.
+    app specific. E.g., `knockout`, `ember`, etc.
 
 
 Angular takes another approach. It attempts to minimize the impedance mismatch between document
 centric HTML and what an application needs by creating new HTML constructs. Angular teaches the
 browser new syntax through a construct we call directives. Examples include:
 
-  * Data binding as in `{{}}`.
+  * Data binding, as in `{{}}`.
   * DOM control structures for repeating/hiding DOM fragments.
   * Support for forms and form validation.
   * Attaching code-behind to DOM elements.
@@ -37,13 +37,13 @@ browser new syntax through a construct we call directives. Examples include:
 
 
 
-## End-to-end solution
+## A complete client-side solution
 
-Angular tries to be an end-to-end solution, when building a web application. This means it is
-not a single piece in an overall puzzle of building a web application, but an end-to-end solution.
-This makes Angular opinionated about how a CRUD application should be built. But while it is
-opinionated, it also tries to make sure that its opinion is just a starting point, which you can
-easily change. Angular comes with the following out-of-the-box:
+Angular is not a single piece in the overall puzzle of building the client-side of a web
+application. It handles all of the DOM and AJAX glue code you once wrote by hand and puts it in a
+well-defined structure. This makes Angular opinionated about how a CRUD application should be
+built. But while it is opinionated, it also tries to make sure that its opinion is just a
+starting point you can easily change. Angular comes with the following out-of-the-box:
 
   * Everything you need to build a CRUD app in a cohesive set: data-binding, basic templating
     directives, form validation, routing, deep-linking, reusable components, dependency injection.

From 18ca265964e98256a4234446832c1969bbcfa132 Mon Sep 17 00:00:00 2001
From: Eduardo Garcia <eg@manoderecha.mx>
Date: Tue, 21 May 2013 16:40:48 -0500
Subject: [PATCH 12/23] docs(guide): format snippets of code in plain text

---
 ...ev_guide.mvc.understanding_controller.ngdoc | 18 +++++++++++-------
 1 file changed, 11 insertions(+), 7 deletions(-)

diff --git a/docs/content/guide/dev_guide.mvc.understanding_controller.ngdoc b/docs/content/guide/dev_guide.mvc.understanding_controller.ngdoc
index 47d594278609..e3a570d47761 100644
--- a/docs/content/guide/dev_guide.mvc.understanding_controller.ngdoc
+++ b/docs/content/guide/dev_guide.mvc.understanding_controller.ngdoc
@@ -21,9 +21,11 @@ constructor). Constructors are always applied to an existing scope object.
 
 You set up the initial state of a scope by creating model properties. For example:
 
-function GreetingCtrl($scope) {
- $scope.greeting = 'Hola!';
-}
+<pre>
+    function GreetingCtrl($scope) {
+        $scope.greeting = 'Hola!';
+    }
+</pre>
 
 The `GreetingCtrl` controller creates a `greeting` model which can be referred to in a template.
 
@@ -32,11 +34,13 @@ in the global scope. This is only for demonstration purposes - in a real
 application you should use the `.controller` method of your Angular module for
 your application as follows:
 
-var myApp = angular.module('myApp',[]);
+<pre>
+    var myApp = angular.module('myApp',[]);
 
-myApp.controller('GreetingCtrl', ['$scope', function($scope) {
-  $scope.greeting = 'Hola!';
-}]);
+    myApp.controller('GreetingCtrl', ['$scope', function($scope) {
+        $scope.greeting = 'Hola!';
+    }]);
+</pre>
 
 Note also that we use the array notation to explicitly specify the dependency
 of the controller on the `$scope` service provided by Angular.

From 23c4df6cb249e77c7e16ec30e4a337f2e26bb74b Mon Sep 17 00:00:00 2001
From: Luc Morin <luc@stlm.ca>
Date: Tue, 4 Jun 2013 20:12:31 +0100
Subject: [PATCH 13/23] docs(input): provide explanation of how ngModel will
 affect the local scope

---
 src/ng/directive/input.js | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/src/ng/directive/input.js b/src/ng/directive/input.js
index 610396a566d8..fd301c6a5e83 100644
--- a/src/ng/directive/input.js
+++ b/src/ng/directive/input.js
@@ -1087,7 +1087,7 @@ var NgModelController = ['$scope', '$exceptionHandler', '$attrs', '$element', '$
  * @element input
  *
  * @description
- * Is directive that tells Angular to do two-way data binding. It works together with `input`,
+ * Is a directive that tells Angular to do two-way data binding. It works together with `input`,
  * `select`, `textarea`. You can easily write your own directives to use `ngModel` as well.
  *
  * `ngModel` is responsible for:
@@ -1098,6 +1098,10 @@ var NgModelController = ['$scope', '$exceptionHandler', '$attrs', '$element', '$
  * - keeping state of the control (valid/invalid, dirty/pristine, validation errors),
  * - setting related css class onto the element (`ng-valid`, `ng-invalid`, `ng-dirty`, `ng-pristine`),
  * - register the control with parent {@link ng.directive:form form}.
+ * 
+ * Note: `ngModel` will try to bind to the property given by evaluating the expression on the
+ * current scope. If the property doesn't already exist on this scope, it will be created
+ * implicitly and added to the scope.
  *
  * For basic examples, how to use `ngModel`, see:
  *

From d3fd671d380be3172e0290ad6292e06fdee4374a Mon Sep 17 00:00:00 2001
From: Jens Rantil <jens.rantil@gmail.com>
Date: Thu, 23 May 2013 09:26:51 +0200
Subject: [PATCH 14/23] docs(validate-commit-msg): fix incorrect comment

If you `cd` into the repo, `validate-commit-msg.js` will be in the root
of it.
---
 validate-commit-msg.js | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/validate-commit-msg.js b/validate-commit-msg.js
index ec853a462d08..665135a73671 100755
--- a/validate-commit-msg.js
+++ b/validate-commit-msg.js
@@ -6,7 +6,7 @@
  *
  * Installation:
  * >> cd <angular-repo>
- * >> ln -s ../../validate-commit-msg.js .git/hooks/commit-msg
+ * >> ln -s validate-commit-msg.js .git/hooks/commit-msg
  */
 var fs = require('fs');
 var util = require('util');

From 95bd140380dc41ca1dca36e8d48b10431046300d Mon Sep 17 00:00:00 2001
From: Alex Young <alex@helicoid.net>
Date: Thu, 23 May 2013 13:11:03 +0200
Subject: [PATCH 15/23] docs(guide/di): fix some small grammatical issues

---
 docs/content/guide/di.ngdoc | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/docs/content/guide/di.ngdoc b/docs/content/guide/di.ngdoc
index a723e6c38740..e1b57d31aa6e 100644
--- a/docs/content/guide/di.ngdoc
+++ b/docs/content/guide/di.ngdoc
@@ -102,12 +102,12 @@ dependency lookup responsibility to the injector by declaring the dependencies a
 
 Notice that by having the `ng-controller` instantiate the class, it can satisfy all of the
 dependencies of `MyController` without the controller ever knowing about the injector. This is
-the best outcome. The application code simply ask for the dependencies it needs, without having to
+the best outcome. The application code simply asks for the dependencies it needs, without having to
 deal with the injector. This setup does not break the Law of Demeter.
 
 # Dependency Annotation
 
-How does the injector know what service needs to be injected? 
+How does the injector know what service needs to be injected?
 
 The application developer needs to provide annotation information that the injector uses in order
 to resolve the dependencies. Throughout Angular certain API functions are invoked using the
@@ -137,7 +137,7 @@ http://www.pretotyping.org/ pretotyping}, and demo applications.
 # `$inject` Annotation
 
 To allow the minifers to rename the function parameters and still be able to inject right services
-the function needs to be annotate with the `$inject` property. The `$inject` property is an array
+the function needs to be annotated with the `$inject` property. The `$inject` property is an array
 of service names to inject.
 
 <pre>

From a8f8b035c72170fe20eb4f4d91afcfe0143cd566 Mon Sep 17 00:00:00 2001
From: Manuel Kiessling <manuel@kiessling.net>
Date: Thu, 23 May 2013 22:48:00 +0200
Subject: [PATCH 16/23] docs(guide/compiler): fix some minor language errors

---
 docs/content/guide/compiler.ngdoc | 23 +++++++++++------------
 1 file changed, 11 insertions(+), 12 deletions(-)

diff --git a/docs/content/guide/compiler.ngdoc b/docs/content/guide/compiler.ngdoc
index dc835808e239..fbba4a0eb638 100644
--- a/docs/content/guide/compiler.ngdoc
+++ b/docs/content/guide/compiler.ngdoc
@@ -6,21 +6,21 @@
 
 Angular's {@link api/ng.$compile HTML compiler} allows the developer to teach the
 browser new HTML syntax. The compiler allows you to attach behavior to any HTML element or attribute
-and even create new HTML element or attributes with custom behavior. Angular calls these behavior
+and even create new HTML elements or attributes with custom behavior. Angular calls these behavior
 extensions {@link api/ng.$compileProvider#directive directives}.
 
 HTML has a lot of constructs for formatting the HTML for static documents in a declarative fashion.
 For example if something needs to be centered, there is no need to provide instructions to the
-browser how the window size needs to be divided in half so that center is found, and that this
-center needs to be aligned with the text's center. Simply add `align="center"` attribute to any
+browser how the window size needs to be divided in half so that the center is found, and that this
+center needs to be aligned with the text's center. Simply add an `align="center"` attribute to any
 element to achieve the desired behavior. Such is the power of declarative language.
 
 But the declarative language is also limited, since it does not allow you to teach the browser new
 syntax. For example there is no easy way to get the browser to align the text at 1/3 the position
-instead of 1/2. What is needed is a way to teach browser new HTML syntax.
+instead of 1/2. What is needed is a way to teach the browser new HTML syntax.
 
 Angular comes pre-bundled with common directives which are useful for building any app. We also
-expect that you will create directives that are specific to your app. These extension become a
+expect that you will create directives that are specific to your app. These extensions become a
 Domain Specific Language for building your application.
 
 All of this compilation takes place in the web browser; no server side or pre-compilation step is
@@ -39,17 +39,16 @@ process happens in two phases.
   scope model are reflected in the view, and any user interactions with the view are reflected
   in the scope model. This makes the scope model the single source of truth.
 
-Some directives such {@link api/ng.directive:ngRepeat
-`ng-repeat`} clone DOM elements once for each item in collection. Having a compile and link phase
-improves performance since the cloned template only needs to be compiled once, and then linked
-once for each clone instance.
+Some directives such as {@link api/ng.directive:ngRepeat `ng-repeat`} clone DOM elements once
+for each item in a collection. Having a compile and link phase improves performance since the
+cloned template only needs to be compiled once, and then linked once for each clone instance.
 
 
 # Directive
 
-A directive is a behavior which should be triggered when specific HTML constructs are encountered in
-the compilation process. The directives can be placed in element names, attributes, class names, as
-well as comments. Here are some equivalent examples of invoking the {@link
+A directive is a behavior which should be triggered when specific HTML constructs are encountered
+during the compilation process. The directives can be placed in element names, attributes, class
+names, as well as comments. Here are some equivalent examples of invoking the {@link
 api/ng.directive:ngBind `ng-bind`} directive.
 
 <pre>

From c05e06cbac499a33bb384b91dec025ff1434f42e Mon Sep 17 00:00:00 2001
From: Robb Shecter <robb@weblaws.org>
Date: Fri, 24 May 2013 16:36:38 -0600
Subject: [PATCH 17/23] docs(guide/understanding_model): improve example
 consistency

---
 docs/content/guide/dev_guide.mvc.understanding_model.ngdoc | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/content/guide/dev_guide.mvc.understanding_model.ngdoc b/docs/content/guide/dev_guide.mvc.understanding_model.ngdoc
index 9e2795347b6c..1f4715c1be44 100644
--- a/docs/content/guide/dev_guide.mvc.understanding_model.ngdoc
+++ b/docs/content/guide/dev_guide.mvc.understanding_model.ngdoc
@@ -28,7 +28,7 @@ occurs in controllers:
 
 * Use an {@link expression angular expression} with an assignment operator in templates:
 
-         <button ng-click="{{foo='ball'}}">Click me</button>
+         <button ng-click="{{foo='bar'}}">Click me</button>
 
 * Use {@link api/ng.directive:ngInit ngInit directive} in templates (for toy/example apps
 only, not recommended for real applications):

From 78163213b8bbbfa1eb9c9b016ff058992f407681 Mon Sep 17 00:00:00 2001
From: Ehsan Ghandhari <ehs.ghan@gmail.com>
Date: Fri, 24 May 2013 19:54:41 -0300
Subject: [PATCH 18/23] docs(guide/concepts): add comment as a type of
 directive

---
 docs/content/guide/concepts.ngdoc | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/content/guide/concepts.ngdoc b/docs/content/guide/concepts.ngdoc
index 5e333c98c48f..fc5bce0add12 100644
--- a/docs/content/guide/concepts.ngdoc
+++ b/docs/content/guide/concepts.ngdoc
@@ -292,7 +292,7 @@ rendering the view compared to most other templating systems.
 # Directives
 
 A directive is a behavior or DOM transformation which is triggered by the presence of a custom attribute,
-element name, or a class name. A directive allows you to extend the HTML vocabulary in a
+element name, class name or comment. A directive allows you to extend the HTML vocabulary in a
 declarative fashion. Following is an example which enables data-binding for the `contenteditable`
 in HTML.
 

From ae3104c2321c76a84e42583da5fd5dd60d1eb100 Mon Sep 17 00:00:00 2001
From: Luc Morin <luc@stlm.ca>
Date: Mon, 27 May 2013 21:34:12 -0300
Subject: [PATCH 19/23] docs(ngClass): clarify the use of object map

---
 src/ng/directive/ngClass.js | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/src/ng/directive/ngClass.js b/src/ng/directive/ngClass.js
index e936ee228d0b..708f40954070 100644
--- a/src/ng/directive/ngClass.js
+++ b/src/ng/directive/ngClass.js
@@ -73,7 +73,9 @@ function classDirective(name, selector) {
  * @element ANY
  * @param {expression} ngClass {@link guide/expression Expression} to eval. The result
  *   of the evaluation can be a string representing space delimited class
- *   names, an array, or a map of class names to boolean values.
+ *   names, an array, or a map of class names to boolean values. In the case of a map, the
+ *   names of the properties whose values are truthy will be added as css classes to the
+ *   element.
  *
  * @example
    <example>

From 7fa4ffdf43aff48ba89fab64a579a72a0ce281e6 Mon Sep 17 00:00:00 2001
From: Siddique Hameed <siddii+git@gmail.com>
Date: Wed, 22 May 2013 09:36:08 -0500
Subject: [PATCH 20/23] docs(index): make menu links relative

Before the Develop drop down menu items were hard coded with an absolute url,
which meant that they did not work correctly on local or ci server builds.
---
 docs/src/templates/index.html | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/docs/src/templates/index.html b/docs/src/templates/index.html
index a3edba30f0e9..da75cff6b502 100644
--- a/docs/src/templates/index.html
+++ b/docs/src/templates/index.html
@@ -142,9 +142,9 @@
                 <i class="icon-book icon-white"></i> Develop <b class="caret"></b>
               </a>
               <ul class="dropdown-menu">
-                <li><a href="http://docs.angularjs.org/tutorial">Tutorial</a></li>
-                <li><a href="http://docs.angularjs.org/guide/">Developer Guide</a></li>
-                <li><a href="http://docs.angularjs.org/api/">API Reference</a></li>
+                <li><a href="./tutorial/">Tutorial</a></li>
+                <li><a href="./guide/">Developer Guide</a></li>
+                <li><a href="./api/">API Reference</a></li>
                 <li><a href="http://docs.angularjs.org/misc/contribute">Contribute</a></li>
                 <li><a href="http://code.angularjs.org/">Download</a></li>
               </ul>

From 560e28f8dbd943eb3c432733d4feea3bce7a4a21 Mon Sep 17 00:00:00 2001
From: Alan Klement <alan.m.klement@gmail.com>
Date: Wed, 29 May 2013 10:44:36 -0300
Subject: [PATCH 21/23] docs(sanitize): add @description section

---
 src/ngSanitize/sanitize.js | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)

diff --git a/src/ngSanitize/sanitize.js b/src/ngSanitize/sanitize.js
index 04eafa0d77dc..30de2231bf0f 100644
--- a/src/ngSanitize/sanitize.js
+++ b/src/ngSanitize/sanitize.js
@@ -4,6 +4,25 @@
  * @ngdoc overview
  * @name ngSanitize
  * @description
+ * 
+ * The `ngSanitize` module provides functionality to sanitize HTML.
+ * 
+ * # Installation
+ * As a separate module, it must be loaded after Angular core is loaded; otherwise, an 'Uncaught Error:
+ * No module: ngSanitize' runtime error will occur.
+ *
+ * <pre>
+ *   <script src="angular.js"></script>
+ *   <script src="angular-sanitize.js"></script>
+ * </pre>
+ *
+ * # Usage
+ * To make sure the module is available to your application, declare it as a dependency of you application
+ * module.
+ *
+ * <pre>
+ *   angular.module('app', ['ngSanitize']);
+ * </pre>
  */
 
 /*

From bcee59d9a260c4c59f4be664f8b8cf696d720547 Mon Sep 17 00:00:00 2001
From: Robb Shecter <robb@weblaws.org>
Date: Wed, 29 May 2013 19:27:54 -0600
Subject: [PATCH 22/23] docs(angular-mocks): fix typo in example

fromJSON() should be fromJson()
---
 src/ngMock/angular-mocks.js | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/ngMock/angular-mocks.js b/src/ngMock/angular-mocks.js
index 647c0be626ee..1b69dac3b297 100644
--- a/src/ngMock/angular-mocks.js
+++ b/src/ngMock/angular-mocks.js
@@ -1571,7 +1571,7 @@ angular.module('ngMockE2E', ['ng']).config(function($provide) {
  *
  *     // adds a new phone to the phones array
  *     $httpBackend.whenPOST('/phones').respond(function(method, url, data) {
- *       phones.push(angular.fromJSON(data));
+ *       phones.push(angular.fromJson(data));
  *     });
  *     $httpBackend.whenGET(/^\/templates\//).passThrough();
  *     //...

From 41ebf0a4bea3acb1b68fcfde8305b687dca15bf2 Mon Sep 17 00:00:00 2001
From: Brenton <git@appsforartists.com>
Date: Mon, 15 Jul 2013 16:00:51 -0700
Subject: [PATCH 23/23] docs(header): replace logo.png with logo.svg

The current logo looks awful on high-density displays.  SVG is a
better choice because it can scale to any resolution without
increasing file size.

Amending #2775 to add support for IE 8 by falling back to existing PNG
with img.onerror

Using relative URLs as directed by @btford and @petebacondarwin.
---
 docs/img/AngularJS-small.png                  | Bin 3139 -> 0 bytes
 ...angular_logo_for_dark_background_small.svg |  41 +++++++++
 docs/src/templates/css/docs.css               |   5 -
 docs/src/templates/index.html                 |   7 +-
 .../angular_logo_for_dark_background.svg      |  87 ++++++++++++++++++
 ...angular_logo_for_dark_background_small.svg |  41 +++++++++
 .../angular_logo_for_light_background.svg     |  86 +++++++++++++++++
 ...ngular_logo_for_light_background_small.svg |  40 ++++++++
 8 files changed, 301 insertions(+), 6 deletions(-)
 delete mode 100644 docs/img/AngularJS-small.png
 create mode 100644 docs/img/angular_logo_for_dark_background_small.svg
 create mode 100644 images/logo/AngularJS.exports/angular_logo_for_dark_background.svg
 create mode 100644 images/logo/AngularJS.exports/angular_logo_for_dark_background_small.svg
 create mode 100644 images/logo/AngularJS.exports/angular_logo_for_light_background.svg
 create mode 100644 images/logo/AngularJS.exports/angular_logo_for_light_background_small.svg

diff --git a/docs/img/AngularJS-small.png b/docs/img/AngularJS-small.png
deleted file mode 100644
index ab5e20f883c169088f1ca352e9687f8a1d72299d..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 3139
zcmV-J47~G+P)<h;3K|Lk000e1NJLTq003VA000>X1^@s6S55MS00009a7bBm000Bn
z000Bn0d7ZQH2?q$^+`lQRA>e5SqV^7M;iX$n_&({U_cN-QSl&Nt6@cEI6T;(;IS%3
z#bjOM>Sj|}k7!(7Q?(u#V<m=)L1UDdU9qBt8;wbDqd_DnY6OiD42Ks25fubElxv2W
zdHeOlH#}f4yH&|nZ53VhrjP&c?)Sd_|G&TP;RHdTr={b^kN1XrUQ0{MLWM#xhT}Na
z;T)c1p68EDnKGsFY5lupT_eCb0{_H`6Rv2VZM9k#plgKF-MhR~K|TqOA5(dAGigSQ
zAob8;#A~${$kVYPhg2%n=aG?-bzM)@E$N7W9ee<;w%Kgc@ca%+)0NfLDh9YJKacpj
zR!m*juA?75+(o8`4~cl5RD%YQX5>gx2RuW(Mq|Q)oq#tadwYBTYs{E2jU6ZJuD3^k
zJ9g~YXf(YB(B~=|8+xb;3q`;c6&39?ojg6sdwT*EWoA<82RqxzIHi(Qg9nqEc?4Ss
zm8t;>DN3dCt*EG|{C3LS6*~gT^z`&?QNxE%)?}V0Woao<7khx`%vpq(PnKT2Na^fM
zmc};27AzJrUArbeoRbq<0G;csSudEZ))dUt4Za=j_60saKYs{c{g9L;C0zoq&^lAk
z=qZRaJhcF5pZW9Kk0PrHEiGiaevPnF1j{d$iMop&5a6q;t4nRJZXKH2S3RPmNukpb
z&$YG-{sW1Hny!*Uua`t{rT>q#;?-A!A3S*Q`v3B6l@%2gH*GF16T6%g*3Lo>OOFum
zRqh^ShIRYQo=x{Y{nTMM9^hjSu}+^py<+_M@m{-k?@rb0^%;Ho^jY1p1H#_%fPjEg
zetv%MNwRb2&W(otdN8OVTCG+OntKO~D%aoNe`9!fxG5na;biaLy%RBBlGKOgAt50H
z4jee}wXd)5BJ|7p?6c1j0s{m61`ZrJTdwD*JT^3RC&Fp~WIOOM7H3bXsi{YX3>osQ
z)PQ%f;JFQAv6;;ywX=M^!Eo5iX1l-Q(xnxwzAG%Of4#*LuM%t{oj6Ws5vT$z=cbzH
z4=eB8yLZi`)e><qYX|XOA3ly$i1RF*l&7VU!Wcs2<3q|{jUws-d}jHNkuW#51500L
zXXik7clW?Yj~-oeb#*<&UP?+WW^+_SLxX*HPf1Dnc;du~i?g$`Y7r81E32xm>)qUj
z5AgSo@$vE521cbrI5RdkH-96IA<Kt(dU^&RJbJLUn(FFVPEJm|OzyB49Ubih0|_!U
zH{0+ob9FjhvRtvgzJ3}$rwQ*S0*&!|hlYeq?%A{FbI|LLr(DuE3t)^qm&58y42IEx
zg794n2~D>+?o5L~bxuUy&O8^<ixcXVu+Y*<P{*Dutkl;_W7u=A+0TpRnv4vx0MC1e
zlF4h$T585(cw--^`1*uhS1Ksn^i<#2SS8h2o|TnV9~2anWHOn)SF6=G<T9zeWy_Z7
zOP4NP3~%@(CMM>kNs}i_B6-d}_GeA-(Cuckx%|kHBZ>tJ7Q}S~pG^h}FIc~R{ZwgU
z=xsL`jVtjzqwqa;@Fh9Rm7EX{um!7g50AYW8ST6YVvbowDPkSjTwR%dyQCX2lAHsW
zClXbDaa7D(umI|s8nLViF^YM|A71Z9EL6zb;ienX($W-<>gv8mJ6x@Eg4J$rY;0@*
z@QXT2f0>r4Q>UsCu3~CyYqw`)WW1-*X#AU+n&93~PvN1V-uOlV#@i*Ev)BX=?2H_&
zrH6yjgf{S9I)mTq`BtlMx?Mz=g*1MC<Th#))nCmO$7-_L$RjkY)3^$~JB#_Z<N|}i
zQ2f!JJ+C8-_+g*fCznZOFHg^YaPeZ)1*z?q&W%Rn8`y6M@3#Y?W$($<R2Hr_%jbpR
z*sIsCU!QsT^5wHLV`5^{Qd76VBktOT9SV1e`>I(G_{N6%t2=^&6B7)EZHd9bf8J*_
z4ri)7Vkn}{!xq7<J>yaL=|irDR?F5797IF+d_=y>mXmr`3~^!M_Gw%rBkg6Wz+ygJ
zv6DrlrlsxN_Rc%0YL#jZK6HtsFXeDyEn>7us!MrXT%2cVX(<E5OKSVM@(`nOMM+7?
zag3)vdGe$)z)jb?yZ;7zN<V21U?dhNOqk$TQ&aOfHrl|gTelkK%$v7P(s7jc4-9-W
zg;#t~!11aw5?;D52&-yI*d^Gkd3z0p<;?O416FnnJ6-^pZNh@pO4f!3@e#~sk?SkK
zfRy0zEU}}O3r@CDVuvgq`v+d|s?;XWZxt22kg#LN1GMc%oE<5bJ*ccK$L8E$-p0xW
z1qCm9d3mjeoBIL?3&H|>k4~<PSgpq5fj0=9H?NL^qP}wF%DIT!dW5^b;(8?ygrN9O
zue=h8_u>$SIstp;%$Yk$`}Um&6Vt*V+APq)*sLirF|j2zE9<onva@?{yLd_S_Qi{;
zV;n#B2ja|D5;los9TSy-Zu&}NC=vhNC$(;N_dfoJs=oYE6q$T{shl0go}>Yr-=szy
zx;$shq{sQKhR#3nAka3493M3DF<gAgh!G>cgC(VEaaxvAPEJnd;>C*>BJR(?BBV&|
z@*LL{_sh!4te}&vZYdLj){aM&L)><_q03aoVt82CTX*i<xxH-JvfJ>w7bH2@&w=I3
zm;V9vHFz4Nc9!Sl=FUk<O1iaZ(V};;Na>)%Kgi`y#3`&Cb+!1yx$NxkUN!_@0o{C7
zw0vy1MRLpUIdvMlpCM-Hwcj{mbgk2wu3QldjnLKhYxPnk;ysc89^P)lZSB$eo1LAV
zyLa#2*UHPwy~mCnE4~AhAhfL6zkh!dEc`IMaV-EDh-M{XvfauzZro@)m6mqe!^0z}
zs;X);<h}5yv8cbD9~-;0umHD#GU|si3)rl`{Bd5maN)>t<Hik!7j4BxYx!1|P~VDn
z6%L>;qhGrO)>iS)g9l%{diAQZuCDGY2u15TXf(S1%^19{9|<Zm2`r4!tD&KN{%$lb
z-X9h==x}JL_H;yq^4-wj2}1?p*LB1dh#!vCFSPb>5hr0`gIO|5HD@zLdMQ>M{8SuE
zA^16SbMl@$Pt;&c2VA)kx0)?d7l6r%HmS~X99%w(kB|Qf?1%NYvNn8lRdRB2NZh7P
zdHH#HTL5kW#xk#3wJI*>$`zbdEY(b}ps?`w8#ZjnEiNuzheax5^Y!i9_lx|3f}$HY
zZ%$-7EZH!yo12?2_Ln;OQ(0MAjKkXdxGHG`{oUWH-S&$`KZyS^keU91Ru1HWaJ??R
zBhxy2;li<<J9mD9ramyBU97FZW-WBL3UA#c?!+5em)>V>MK;@<GQpNuYiYS!V`+JG
zyP@9fY!SYB$kF{;izQmTQpRq+VBfxdpA1U+2WfDC@^~&%jP*5{XUO#9k8B(<v9MDr
z3p=dQ2MeVhGDP$ecH7wled`AgzJu@~x&qh)qfz0o7||NUfu8&zgy>*B6I@(e&Vz>5
z$z`Fi8qQ)FBq)_0i0_4yCQZ7@tX{4IiZ~4Q!77EqYPMPnE?l@!B9~)~PynZww>>GB
z;G3DplyvMP>4qB&K{&<=c<;-YCsJdz=4D*GXy@}YX3TI##F*$L2)E8=XWs}j7(x_k
z^{vdz%yxe+MMOmC5k~uCz5#3%l^l1S>9ctx@W*Z1v?<eoYh!IjI(58GmR`sa_>zoM
zt4W8`u-0Ip8%0HFt5>gfctVo&yYn{iy|Hmz!GQx8mh;KIq?j~kP7^QQ5VXPM5PUEn
zZBP*D#!sMo)zyT%m74SC&yR=4=e70hE;&L#w0tIjTj-Fj#@)-B*x1+})1snC_x)wk
zWZ^o)+)BMWg0CJrlzK!?qQ_VO#A@@YQ>Ws=0Nw`h>|Uok{R9Gb@FhJgf;Y->pmKi%
zol=C39!;8aXGxWtLuT*ZV$65K0Za!fDtLR-(W6HNTsR%V$#gA1FO$aU&VL$#PT)&j
zun0p@eg}Mf#*!sV=ot?W;;{hrSOC?qVT275mztk`i%n-aK>uFq*PZ|82y_X)Gz1o5
zJf3(Qh{l2&6X+d_>&S{%0(6H5A*pY7{&WO>5`5Mj;Io5DEbh@)gKINhya&K{ydq_)
d-RZwT;NQ2uO^y?54Nd?6002ovPDHLkV1j!k3mE_a

diff --git a/docs/img/angular_logo_for_dark_background_small.svg b/docs/img/angular_logo_for_dark_background_small.svg
new file mode 100644
index 000000000000..58a6cc199a48
--- /dev/null
+++ b/docs/img/angular_logo_for_dark_background_small.svg
@@ -0,0 +1,41 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- Generator: Adobe Illustrator 15.0.0, SVG Export Plug-In  -->
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd" [
+	<!ENTITY ns_flows "http://ns.adobe.com/Flows/1.0/">
+]>
+<svg version="1.1"
+	 xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:a="http://ns.adobe.com/AdobeSVGViewerExtensions/3.0/"
+	 x="0px" y="0px" width="687px" height="176px" viewBox="0 0 687 176" overflow="visible" enable-background="new 0 0 687 176"
+	 xml:space="preserve">
+<defs>
+</defs>
+<path fill="#FFFFFF" d="M179.011,125.328V54.527h9.158l43.322,57.035V54.527h8.666v70.801h-9.158l-43.326-57.536v57.536H179.011z
+	 M179.011,125.328"/>
+<path fill="#FFFFFF" d="M310.46,122.554c-5.708,2.182-11.864,3.269-18.467,3.269c-25.644,0-38.469-12.294-38.469-36.887
+	c0-23.27,12.378-34.908,37.134-34.908c7.096,0,13.7,0.994,19.802,2.976v7.921c-6.103-2.311-12.378-3.468-18.813-3.468
+	c-19.306,0-28.96,9.162-28.96,27.479c0,19.639,9.504,29.463,28.517,29.463c3.034,0,6.404-0.396,10.103-1.193V93.145h9.154V122.554z
+	 M310.46,122.554"/>
+<path fill="#FFFFFF" d="M325.067,97.996V54.523h9.154v43.473c0,13.598,6.768,20.4,20.303,20.4c13.531,0,20.301-6.803,20.301-20.4
+	V54.523h9.158v43.473c0,18.556-9.82,27.825-29.459,27.825C334.886,125.821,325.067,116.552,325.067,97.996L325.067,97.996z
+	 M325.067,97.996"/>
+<path fill="#FFFFFF" d="M409.48,54.523v63.376h37.037v7.425h-46.191V54.523H409.48z M409.48,54.523"/>
+<path fill="#FFFFFF" d="M459.736,125.327h-9.504l35.201-80.146l35.199,80.146h-10.15l-9.158-22.282h-23.418l2.527-7.424h17.82
+	l-13.217-32.088L459.736,125.327z M459.736,125.327"/>
+<path fill="#FFFFFF" d="M530.289,125.328V54.527h30.203c13.469,0,20.197,5.659,20.197,16.982c0,9.207-6.578,16.028-19.75,20.445
+	l24.309,33.374h-12.086l-22.521-31.835v-5.992c13.531-2.151,20.301-7.344,20.301-15.598c0-6.533-3.766-9.801-11.293-9.801h-20.201
+	v63.226H530.289z M530.289,125.328"/>
+<path fill="#B52E31" d="M619.561,54.523v50.405c0,13.603-8.006,20.396-24.016,20.396V117.9c9.902,0,14.857-4.329,14.857-12.973
+	V54.523H619.561z M619.561,54.523"/>
+<path fill="#B52E31" d="M635.896,122.849v-8.418c7.428,2.639,15.447,3.965,24.064,3.965c12.178,0,18.271-4.457,18.271-13.372
+	c0-7.584-4.492-11.385-13.469-11.385h-9.113c-14.818,0-22.234-6.435-22.234-19.31c0-13.531,9.492-20.303,28.479-20.303
+	c8.25,0,15.922,0.998,23.021,2.976v8.418c-7.1-2.644-14.771-3.965-23.021-3.965c-12.875,0-19.311,4.293-19.311,12.875
+	c0,7.588,4.352,11.385,13.066,11.385h9.113c15.08,0,22.627,6.439,22.627,19.31c0,13.864-9.141,20.796-27.43,20.796
+	C651.344,125.819,643.324,124.826,635.896,122.849L635.896,122.849z M635.896,122.849"/>
+<path fill="#B2B2B2" d="M82.688,0L0,29.1l13.066,108.335l69.71,38.314l70.069-38.834l13.062-108.331L82.688,0z M82.688,0"/>
+<path fill="#B52E31" d="M157.66,34.846L82.496,9.214v157.381l62.991-34.861L157.66,34.846z M157.66,34.846"/>
+<path fill="#E23237" d="M9.279,35.308l11.196,96.889l62.019,34.398V9.211L9.279,35.308z M9.279,35.308"/>
+<path fill="#F2F2F2" d="M99.918,87.493L82.632,51.396L67.415,87.493H99.918z M106.508,102.672h-45.82l-10.251,25.64l-19.067,0.352
+	L82.496,14.929l52.908,113.734h-17.673L106.508,102.672z M106.508,102.672"/>
+<path fill="#B2B2B2" d="M82.496,14.929l0.136,36.467l17.268,36.125H82.534l-0.039,15.127l24.012,0.023l11.223,25.996l18.245,0.339
+	L82.496,14.929z M82.496,14.929"/>
+</svg>
diff --git a/docs/src/templates/css/docs.css b/docs/src/templates/css/docs.css
index 00aac98d5a1d..a98f7429cae3 100644
--- a/docs/src/templates/css/docs.css
+++ b/docs/src/templates/css/docs.css
@@ -1,8 +1,3 @@
-img.AngularJS-small {
-  width: 95px;
-  height: 25px;
-}
-
 /* this is here to avoid the display=block shuffling of ngShow */
 .breadcrumb li > * {
   float:left;
diff --git a/docs/src/templates/index.html b/docs/src/templates/index.html
index da75cff6b502..477fbf43e1f5 100644
--- a/docs/src/templates/index.html
+++ b/docs/src/templates/index.html
@@ -118,7 +118,12 @@
       <div class="navbar-inner">
         <div class="container">
           <a class="brand" href="http://angularjs.org" style="padding-top: 6px; padding-bottom: 0px;">
-            <img class="AngularJS-small" src="http://angularjs.org/img/AngularJS-small.png">
+            <img
+              width="95"
+              height="25"
+              src="img/angular_logo_for_dark_background_small.svg"
+              onerror="this.src = 'img/AngularJS-small.png'"
+            >
           </a>
           <ul class="nav">
             <li class="divider-vertical"></li>
diff --git a/images/logo/AngularJS.exports/angular_logo_for_dark_background.svg b/images/logo/AngularJS.exports/angular_logo_for_dark_background.svg
new file mode 100644
index 000000000000..7b609a4db25f
--- /dev/null
+++ b/images/logo/AngularJS.exports/angular_logo_for_dark_background.svg
@@ -0,0 +1,87 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- Generator: Adobe Illustrator 15.0.0, SVG Export Plug-In  -->
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd" [
+	<!ENTITY ns_flows "http://ns.adobe.com/Flows/1.0/">
+]>
+<svg version="1.1"
+	 xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:a="http://ns.adobe.com/AdobeSVGViewerExtensions/3.0/"
+	 x="0px" y="0px" width="687px" height="178px" viewBox="0 0 687 178" overflow="visible" enable-background="new 0 0 687 178"
+	 xml:space="preserve">
+<defs>
+</defs>
+<path fill="#FFFFFF" d="M179.011,125.328V54.527h9.158l43.322,57.035V54.527h8.666v70.801h-9.158l-43.326-57.536v57.536H179.011z
+	 M179.011,125.328"/>
+<path fill="#FFFFFF" d="M310.46,122.554c-5.708,2.182-11.864,3.269-18.467,3.269c-25.644,0-38.469-12.294-38.469-36.887
+	c0-23.27,12.378-34.908,37.134-34.908c7.096,0,13.7,0.994,19.802,2.976v7.921c-6.103-2.311-12.378-3.468-18.813-3.468
+	c-19.306,0-28.96,9.162-28.96,27.479c0,19.639,9.504,29.463,28.517,29.463c3.034,0,6.404-0.396,10.103-1.193V93.145h9.154V122.554z
+	 M310.46,122.554"/>
+<path fill="#FFFFFF" d="M325.067,97.996V54.523h9.154v43.473c0,13.598,6.768,20.4,20.303,20.4c13.531,0,20.301-6.803,20.301-20.4
+	V54.523h9.158v43.473c0,18.556-9.82,27.825-29.459,27.825C334.886,125.821,325.067,116.552,325.067,97.996L325.067,97.996z
+	 M325.067,97.996"/>
+<path fill="#FFFFFF" d="M409.48,54.523v63.376h37.037v7.425h-46.191V54.523H409.48z M409.48,54.523"/>
+<path fill="#FFFFFF" d="M459.736,125.327h-9.504l35.201-80.146l35.199,80.146h-10.15l-9.158-22.282h-23.418l2.527-7.424h17.82
+	l-13.217-32.088L459.736,125.327z M459.736,125.327"/>
+<path fill="#FFFFFF" d="M530.289,125.328V54.527h30.203c13.469,0,20.197,5.659,20.197,16.982c0,9.207-6.578,16.028-19.75,20.445
+	l24.309,33.374h-12.086l-22.521-31.835v-5.992c13.531-2.151,20.301-7.344,20.301-15.598c0-6.533-3.766-9.801-11.293-9.801h-20.201
+	v63.226H530.289z M530.289,125.328"/>
+<path fill="#B52E31" d="M619.561,54.523v50.405c0,13.603-8.006,20.396-24.016,20.396V117.9c9.902,0,14.857-4.329,14.857-12.973
+	V54.523H619.561z M619.561,54.523"/>
+<path fill="#B52E31" d="M635.896,122.849v-8.418c7.428,2.639,15.447,3.965,24.064,3.965c12.178,0,18.271-4.457,18.271-13.372
+	c0-7.584-4.492-11.385-13.469-11.385h-9.113c-14.818,0-22.234-6.435-22.234-19.31c0-13.531,9.492-20.303,28.479-20.303
+	c8.25,0,15.922,0.998,23.021,2.976v8.418c-7.1-2.644-14.771-3.965-23.021-3.965c-12.875,0-19.311,4.293-19.311,12.875
+	c0,7.588,4.352,11.385,13.066,11.385h9.113c15.08,0,22.627,6.439,22.627,19.31c0,13.864-9.141,20.796-27.43,20.796
+	C651.344,125.819,643.324,124.826,635.896,122.849L635.896,122.849z M635.896,122.849"/>
+<path fill="#FFFFFF" d="M533.812,165.946h1.945v-1.605c0.447,0.602,0.867,1.039,1.26,1.312c0.658,0.461,1.467,0.691,2.424,0.691
+	c1.709,0,3.047-0.656,4.012-1.969c0.963-1.312,1.445-2.961,1.445-4.945c0-2.094-0.488-3.678-1.463-4.752
+	c-0.977-1.074-2.25-1.611-3.818-1.611c-0.754,0-1.451,0.158-2.094,0.475c-0.645,0.316-1.197,0.775-1.66,1.377v-6.246h-2.051V165.946
+	L533.812,165.946z M539.311,164.481c-1.521,0-2.561-0.691-3.117-2.074c-0.297-0.734-0.447-1.691-0.447-2.871
+	c0-1.633,0.363-2.805,1.088-3.516c0.727-0.711,1.57-1.066,2.535-1.066c1.104,0,1.941,0.434,2.51,1.301s0.852,1.961,0.852,3.281
+	c0,1.484-0.283,2.68-0.852,3.586S540.453,164.481,539.311,164.481L539.311,164.481L539.311,164.481z M551.795,163.618l-3.363-10.223
+	h-2.391l4.641,12.92c-0.109,0.28-0.283,0.709-0.525,1.286s-0.383,0.896-0.422,0.959c-0.125,0.188-0.279,0.345-0.461,0.474
+	c-0.184,0.129-0.471,0.193-0.861,0.193c-0.125,0-0.27-0.012-0.432-0.035c-0.164-0.023-0.43-0.086-0.797-0.188v1.922
+	c0.234,0.062,0.432,0.105,0.592,0.129s0.389,0.035,0.686,0.035c1.217,0,2.076-0.352,2.576-1.055
+	c0.498-0.702,1.357-2.654,2.574-5.854c0.516-1.36,1.156-3.119,1.922-5.276c1.023-2.868,1.684-4.705,1.98-5.51h-2.332
+	L551.795,163.618L551.795,163.618z"/>
+<path fill="#B2B2B2" d="M82.688,0L0,29.1l13.066,108.335l69.71,38.314l70.069-38.834l13.062-108.331L82.688,0z M82.688,0"/>
+<path fill="#B52E31" d="M157.66,34.846L82.496,9.214v157.381l62.991-34.861L157.66,34.846z M157.66,34.846"/>
+<path fill="#E23237" d="M9.279,35.308l11.196,96.889l62.019,34.398V9.211L9.279,35.308z M9.279,35.308"/>
+<path fill="#F2F2F2" d="M99.918,87.493L82.632,51.396L67.415,87.493H99.918z M106.508,102.672h-45.82l-10.251,25.64l-19.067,0.352
+	L82.496,14.929l52.908,113.734h-17.673L106.508,102.672z M106.508,102.672"/>
+<path fill="#B2B2B2" d="M82.496,14.929l0.136,36.467l17.268,36.125H82.534l-0.039,15.127l24.012,0.023l11.223,25.996l18.245,0.339
+	L82.496,14.929z M82.496,14.929"/>
+<g id="XMLID_1_">
+	<g>
+		<path fill="#FFFFFF" d="M604.7,146.53c6.872-0.793,12.015,3.961,11.096,10.959c-0.879,6.683-9.395,10.638-15.615,6.849
+			c-1.97-1.199-3.979-3.493-4.384-6.712c-0.645-5.086,2.237-8.607,5.205-10.137C601.943,147.004,603.04,146.725,604.7,146.53z
+			 M610.864,162.146c3.14-5.126-0.861-14.731-6.026-14.383c-8.784,0.599-4.681,15.519,0.685,16.574
+			C607.691,164.766,610.048,163.481,610.864,162.146z"/>
+		<path fill="#FFFFFF" d="M582.373,158.311c2.072-2.402,7.231-1.718,11.644-1.78c-1.775,0.924-1.147,5.428-1.233,8.492
+			c-7.848,2.694-18.611,3.168-23.834-2.055c-2.26-2.26-3.373-5.039-4.109-8.767c0-1.187,0-2.374,0-3.562
+			c0.937-12.521,17.967-17.225,27.807-9.999c-1.438,1.301-2.312,3.168-4.657,3.562c0.114-0.754,0.759-0.977,0.822-1.781
+			c-2.803-3.681-10.114-4.736-14.521-2.055c-1.512,0.919-2.682,2.386-3.561,3.973c-5.941,10.765,4.742,25.164,17.807,20.136
+			c0-2.191,0-4.383,0-6.575C586.619,158.174,584.348,158.094,582.373,158.311z"/>
+		<path fill="#FFFFFF" d="M683.873,162.283c0.291,0.131-0.37,0.645-0.685,0.959c-1.632,1.644-4.338,2.87-8.082,2.465
+			c-7.214-0.775-10.284-11.494-5.342-16.574c3.47-3.566,12.288-4.109,13.698,2.192c-3.853,1.718-7.163,3.978-12.466,4.246
+			C671.54,161.484,678.086,165.799,683.873,162.283z M670.997,155.297c2.825-1.244,5.937-2.191,8.356-3.835
+			c-0.114-3.756-4.566-4.577-6.85-2.603C670.918,150.234,670.638,152.598,670.997,155.297z"/>
+		<path fill="#FFFFFF" d="M664.148,163.379c0.725,0.645,2.306,0.434,3.425,0.685c-1.495,1.701-5.708,0.686-8.63,0.959
+			c0.434-0.799,0.937-1.13,1.096-2.055c0.616-3.602,0-8.219,0-12.465c0-4.366,0-8.664,0-12.602c-1.004,0-2.009,0-3.014,0
+			c0.742-0.674,1.976-0.856,2.74-1.507c2.009,0,4.018,0,6.026,0c-2.465,0.673-1.78,4.383-1.78,7.671
+			C664.012,150.463,663.903,157.957,664.148,163.379z"/>
+		<path fill="#FFFFFF" d="M636.616,151.462c1.449,2.831,1.262,6.843-0.411,9.588c-2.711,4.452-9.651,5.913-14.108,3.288
+			c-3.219-1.896-6.05-7.517-3.562-12.465c1.353-2.688,4.161-5.018,8.63-5.343C631.736,146.193,635.212,148.723,636.616,151.462z
+			 M627.713,164.475c9.269,0.976,6.032-14.765,1.096-16.574c-0.754-0.279-2.151-0.229-2.739-0.137
+			C618.067,149.048,621.565,163.824,627.713,164.475z"/>
+		<path fill="#FFFFFF" d="M655.52,166.118c4.092,4.777-0.794,11.016-6.712,11.506c-1.553,0-3.105,0-4.657,0
+			c-4.161-0.588-7.917-3.727-6.027-7.944c1.433-3.202,5.434-4.2,10.137-4.521c-0.32-0.787-1.541-2.653-0.686-4.246
+			c-5.879,0.754-9.395-4.44-7.26-9.178c2.369-5.262,10.131-5.131,17.533-4.794c-1.256,0.845-2.392,1.81-4.794,1.507
+			c1.689,1.735,3.681,4.446,2.191,7.944c-0.696,1.633-4.172,3.419-4.109,5.205C651.198,163.327,654.246,164.635,655.52,166.118z
+			 M654.013,173.241c0.713-1.701-0.126-3.282-0.822-4.109c-1.256-1.489-2.482-2.785-4.657-2.739
+			c-3.767,0.08-5.759,1.307-6.438,2.191c-0.611,0.793-0.822,1.935-0.822,2.466C641.273,176.928,652.283,177.385,654.013,173.241z
+			 M647.301,159.681c7.391,1.764,5.113-11.985-0.686-11.369c-0.091,0.011-0.137,0.137-0.137,0.137
+			C640.874,149.281,643.728,158.824,647.301,159.681z"/>
+	</g>
+	<g>
+	</g>
+</g>
+</svg>
diff --git a/images/logo/AngularJS.exports/angular_logo_for_dark_background_small.svg b/images/logo/AngularJS.exports/angular_logo_for_dark_background_small.svg
new file mode 100644
index 000000000000..58a6cc199a48
--- /dev/null
+++ b/images/logo/AngularJS.exports/angular_logo_for_dark_background_small.svg
@@ -0,0 +1,41 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- Generator: Adobe Illustrator 15.0.0, SVG Export Plug-In  -->
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd" [
+	<!ENTITY ns_flows "http://ns.adobe.com/Flows/1.0/">
+]>
+<svg version="1.1"
+	 xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:a="http://ns.adobe.com/AdobeSVGViewerExtensions/3.0/"
+	 x="0px" y="0px" width="687px" height="176px" viewBox="0 0 687 176" overflow="visible" enable-background="new 0 0 687 176"
+	 xml:space="preserve">
+<defs>
+</defs>
+<path fill="#FFFFFF" d="M179.011,125.328V54.527h9.158l43.322,57.035V54.527h8.666v70.801h-9.158l-43.326-57.536v57.536H179.011z
+	 M179.011,125.328"/>
+<path fill="#FFFFFF" d="M310.46,122.554c-5.708,2.182-11.864,3.269-18.467,3.269c-25.644,0-38.469-12.294-38.469-36.887
+	c0-23.27,12.378-34.908,37.134-34.908c7.096,0,13.7,0.994,19.802,2.976v7.921c-6.103-2.311-12.378-3.468-18.813-3.468
+	c-19.306,0-28.96,9.162-28.96,27.479c0,19.639,9.504,29.463,28.517,29.463c3.034,0,6.404-0.396,10.103-1.193V93.145h9.154V122.554z
+	 M310.46,122.554"/>
+<path fill="#FFFFFF" d="M325.067,97.996V54.523h9.154v43.473c0,13.598,6.768,20.4,20.303,20.4c13.531,0,20.301-6.803,20.301-20.4
+	V54.523h9.158v43.473c0,18.556-9.82,27.825-29.459,27.825C334.886,125.821,325.067,116.552,325.067,97.996L325.067,97.996z
+	 M325.067,97.996"/>
+<path fill="#FFFFFF" d="M409.48,54.523v63.376h37.037v7.425h-46.191V54.523H409.48z M409.48,54.523"/>
+<path fill="#FFFFFF" d="M459.736,125.327h-9.504l35.201-80.146l35.199,80.146h-10.15l-9.158-22.282h-23.418l2.527-7.424h17.82
+	l-13.217-32.088L459.736,125.327z M459.736,125.327"/>
+<path fill="#FFFFFF" d="M530.289,125.328V54.527h30.203c13.469,0,20.197,5.659,20.197,16.982c0,9.207-6.578,16.028-19.75,20.445
+	l24.309,33.374h-12.086l-22.521-31.835v-5.992c13.531-2.151,20.301-7.344,20.301-15.598c0-6.533-3.766-9.801-11.293-9.801h-20.201
+	v63.226H530.289z M530.289,125.328"/>
+<path fill="#B52E31" d="M619.561,54.523v50.405c0,13.603-8.006,20.396-24.016,20.396V117.9c9.902,0,14.857-4.329,14.857-12.973
+	V54.523H619.561z M619.561,54.523"/>
+<path fill="#B52E31" d="M635.896,122.849v-8.418c7.428,2.639,15.447,3.965,24.064,3.965c12.178,0,18.271-4.457,18.271-13.372
+	c0-7.584-4.492-11.385-13.469-11.385h-9.113c-14.818,0-22.234-6.435-22.234-19.31c0-13.531,9.492-20.303,28.479-20.303
+	c8.25,0,15.922,0.998,23.021,2.976v8.418c-7.1-2.644-14.771-3.965-23.021-3.965c-12.875,0-19.311,4.293-19.311,12.875
+	c0,7.588,4.352,11.385,13.066,11.385h9.113c15.08,0,22.627,6.439,22.627,19.31c0,13.864-9.141,20.796-27.43,20.796
+	C651.344,125.819,643.324,124.826,635.896,122.849L635.896,122.849z M635.896,122.849"/>
+<path fill="#B2B2B2" d="M82.688,0L0,29.1l13.066,108.335l69.71,38.314l70.069-38.834l13.062-108.331L82.688,0z M82.688,0"/>
+<path fill="#B52E31" d="M157.66,34.846L82.496,9.214v157.381l62.991-34.861L157.66,34.846z M157.66,34.846"/>
+<path fill="#E23237" d="M9.279,35.308l11.196,96.889l62.019,34.398V9.211L9.279,35.308z M9.279,35.308"/>
+<path fill="#F2F2F2" d="M99.918,87.493L82.632,51.396L67.415,87.493H99.918z M106.508,102.672h-45.82l-10.251,25.64l-19.067,0.352
+	L82.496,14.929l52.908,113.734h-17.673L106.508,102.672z M106.508,102.672"/>
+<path fill="#B2B2B2" d="M82.496,14.929l0.136,36.467l17.268,36.125H82.534l-0.039,15.127l24.012,0.023l11.223,25.996l18.245,0.339
+	L82.496,14.929z M82.496,14.929"/>
+</svg>
diff --git a/images/logo/AngularJS.exports/angular_logo_for_light_background.svg b/images/logo/AngularJS.exports/angular_logo_for_light_background.svg
new file mode 100644
index 000000000000..adc8c8d9a855
--- /dev/null
+++ b/images/logo/AngularJS.exports/angular_logo_for_light_background.svg
@@ -0,0 +1,86 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- Generator: Adobe Illustrator 15.0.0, SVG Export Plug-In  -->
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd" [
+	<!ENTITY ns_flows "http://ns.adobe.com/Flows/1.0/">
+]>
+<svg version="1.1"
+	 xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:a="http://ns.adobe.com/AdobeSVGViewerExtensions/3.0/"
+	 x="0px" y="0px" width="687px" height="178px" viewBox="0 0 687 178" overflow="visible" enable-background="new 0 0 687 178"
+	 xml:space="preserve">
+<defs>
+</defs>
+<path d="M179.011,125.328V54.527h9.158l43.322,57.035V54.527h8.666v70.801h-9.158l-43.326-57.536v57.536H179.011z M179.011,125.328"
+	/>
+<path d="M310.46,122.554c-5.708,2.182-11.864,3.269-18.467,3.269c-25.644,0-38.469-12.294-38.469-36.887
+	c0-23.27,12.378-34.908,37.134-34.908c7.096,0,13.7,0.994,19.802,2.976v7.921c-6.103-2.311-12.378-3.468-18.813-3.468
+	c-19.306,0-28.96,9.162-28.96,27.479c0,19.639,9.504,29.463,28.517,29.463c3.034,0,6.404-0.396,10.103-1.193V93.145h9.154V122.554z
+	 M310.46,122.554"/>
+<path d="M325.067,97.996V54.523h9.154v43.473c0,13.598,6.768,20.4,20.303,20.4c13.531,0,20.301-6.803,20.301-20.4V54.523h9.158
+	v43.473c0,18.556-9.82,27.825-29.459,27.825C334.886,125.821,325.067,116.552,325.067,97.996L325.067,97.996z M325.067,97.996"/>
+<path d="M409.48,54.523v63.376h37.037v7.425h-46.191V54.523H409.48z M409.48,54.523"/>
+<path d="M459.736,125.327h-9.504l35.201-80.146l35.199,80.146h-10.15l-9.158-22.282h-23.418l2.527-7.424h17.82l-13.217-32.088
+	L459.736,125.327z M459.736,125.327"/>
+<path d="M530.289,125.328V54.527h30.203c13.469,0,20.197,5.659,20.197,16.982c0,9.207-6.578,16.028-19.75,20.445l24.309,33.374
+	h-12.086l-22.521-31.835v-5.992c13.531-2.151,20.301-7.344,20.301-15.598c0-6.533-3.766-9.801-11.293-9.801h-20.201v63.226H530.289z
+	 M530.289,125.328"/>
+<path fill="#B52E31" d="M619.561,54.523v50.405c0,13.603-8.006,20.396-24.016,20.396V117.9c9.902,0,14.857-4.329,14.857-12.973
+	V54.523H619.561z M619.561,54.523"/>
+<path fill="#B52E31" d="M635.896,122.849v-8.418c7.428,2.639,15.447,3.965,24.064,3.965c12.178,0,18.271-4.457,18.271-13.372
+	c0-7.584-4.492-11.385-13.469-11.385h-9.113c-14.818,0-22.234-6.435-22.234-19.31c0-13.531,9.492-20.303,28.479-20.303
+	c8.25,0,15.922,0.998,23.021,2.976v8.418c-7.1-2.644-14.771-3.965-23.021-3.965c-12.875,0-19.311,4.293-19.311,12.875
+	c0,7.588,4.352,11.385,13.066,11.385h9.113c15.08,0,22.627,6.439,22.627,19.31c0,13.864-9.141,20.796-27.43,20.796
+	C651.344,125.819,643.324,124.826,635.896,122.849L635.896,122.849z M635.896,122.849"/>
+<path d="M533.812,165.946h1.945v-1.605c0.447,0.602,0.867,1.039,1.26,1.312c0.658,0.461,1.467,0.691,2.424,0.691
+	c1.709,0,3.047-0.656,4.012-1.969c0.963-1.312,1.445-2.961,1.445-4.945c0-2.094-0.488-3.678-1.463-4.752
+	c-0.977-1.074-2.25-1.611-3.818-1.611c-0.754,0-1.451,0.158-2.094,0.475c-0.645,0.316-1.197,0.775-1.66,1.377v-6.246h-2.051V165.946
+	L533.812,165.946z M539.311,164.481c-1.521,0-2.561-0.691-3.117-2.074c-0.297-0.734-0.447-1.691-0.447-2.871
+	c0-1.633,0.363-2.805,1.088-3.516c0.727-0.711,1.57-1.066,2.535-1.066c1.104,0,1.941,0.434,2.51,1.301s0.852,1.961,0.852,3.281
+	c0,1.484-0.283,2.68-0.852,3.586S540.453,164.481,539.311,164.481L539.311,164.481L539.311,164.481z M551.795,163.618l-3.363-10.223
+	h-2.391l4.641,12.92c-0.109,0.28-0.283,0.709-0.525,1.286s-0.383,0.896-0.422,0.959c-0.125,0.188-0.279,0.345-0.461,0.474
+	c-0.184,0.129-0.471,0.193-0.861,0.193c-0.125,0-0.27-0.012-0.432-0.035c-0.164-0.023-0.43-0.086-0.797-0.188v1.922
+	c0.234,0.062,0.432,0.105,0.592,0.129s0.389,0.035,0.686,0.035c1.217,0,2.076-0.352,2.576-1.055
+	c0.498-0.702,1.357-2.654,2.574-5.854c0.516-1.36,1.156-3.119,1.922-5.276c1.023-2.868,1.684-4.705,1.98-5.51h-2.332
+	L551.795,163.618L551.795,163.618z"/>
+<path fill="#B2B2B2" d="M82.688,0L0,29.1l13.066,108.335l69.71,38.314l70.069-38.834l13.062-108.331L82.688,0z M82.688,0"/>
+<path fill="#B52E31" d="M157.66,34.846L82.496,9.214v157.381l62.991-34.861L157.66,34.846z M157.66,34.846"/>
+<path fill="#E23237" d="M9.279,35.308l11.196,96.889l62.019,34.398V9.211L9.279,35.308z M9.279,35.308"/>
+<path fill="#F2F2F2" d="M99.918,87.493L82.632,51.396L67.415,87.493H99.918z M106.508,102.672h-45.82l-10.251,25.64l-19.067,0.352
+	L82.496,14.929l52.908,113.734h-17.673L106.508,102.672z M106.508,102.672"/>
+<path fill="#B2B2B2" d="M82.496,14.929l0.136,36.467l17.268,36.125H82.534l-0.039,15.127l24.012,0.023l11.223,25.996l18.245,0.339
+	L82.496,14.929z M82.496,14.929"/>
+<g id="XMLID_1_">
+	<g>
+		<path d="M683.873,162.283c0.291,0.131-0.37,0.645-0.685,0.959c-1.632,1.644-4.338,2.87-8.082,2.465
+			c-7.214-0.775-10.284-11.494-5.342-16.574c3.47-3.566,12.288-4.109,13.698,2.192c-3.853,1.718-7.163,3.978-12.466,4.246
+			C671.54,161.484,678.086,165.799,683.873,162.283z M670.997,155.297c2.825-1.244,5.937-2.191,8.356-3.835
+			c-0.114-3.756-4.566-4.577-6.85-2.603C670.918,150.234,670.638,152.598,670.997,155.297z"/>
+		<path d="M664.148,163.379c0.725,0.645,2.306,0.434,3.425,0.685c-1.495,1.701-5.708,0.686-8.63,0.959
+			c0.434-0.799,0.937-1.13,1.096-2.055c0.616-3.602,0-8.219,0-12.465c0-4.366,0-8.664,0-12.602c-1.004,0-2.009,0-3.014,0
+			c0.742-0.674,1.976-0.856,2.74-1.507c2.009,0,4.018,0,6.026,0c-2.465,0.673-1.78,4.383-1.78,7.671
+			C664.012,150.463,663.903,157.957,664.148,163.379z"/>
+		<path d="M655.52,166.118c4.092,4.777-0.794,11.016-6.712,11.506c-1.553,0-3.105,0-4.657,0c-4.161-0.588-7.917-3.727-6.027-7.944
+			c1.433-3.202,5.434-4.2,10.137-4.521c-0.32-0.787-1.541-2.653-0.686-4.246c-5.879,0.754-9.395-4.44-7.26-9.178
+			c2.369-5.262,10.131-5.131,17.533-4.794c-1.256,0.845-2.392,1.81-4.794,1.507c1.689,1.735,3.681,4.446,2.191,7.944
+			c-0.696,1.633-4.172,3.419-4.109,5.205C651.198,163.327,654.246,164.635,655.52,166.118z M654.013,173.241
+			c0.713-1.701-0.126-3.282-0.822-4.109c-1.256-1.489-2.482-2.785-4.657-2.739c-3.767,0.08-5.759,1.307-6.438,2.191
+			c-0.611,0.793-0.822,1.935-0.822,2.466C641.273,176.928,652.283,177.385,654.013,173.241z M647.301,159.681
+			c7.391,1.764,5.113-11.985-0.686-11.369c-0.091,0.011-0.137,0.137-0.137,0.137C640.874,149.281,643.728,158.824,647.301,159.681z"
+			/>
+		<path d="M636.616,151.462c1.449,2.831,1.262,6.843-0.411,9.588c-2.711,4.452-9.651,5.913-14.108,3.288
+			c-3.219-1.896-6.05-7.517-3.562-12.465c1.353-2.688,4.161-5.018,8.63-5.343C631.736,146.193,635.212,148.723,636.616,151.462z
+			 M627.713,164.475c9.269,0.976,6.032-14.765,1.096-16.574c-0.754-0.279-2.151-0.229-2.739-0.137
+			C618.067,149.048,621.565,163.824,627.713,164.475z"/>
+		<path d="M604.7,146.53c6.872-0.793,12.015,3.961,11.096,10.959c-0.879,6.683-9.395,10.638-15.615,6.849
+			c-1.97-1.199-3.979-3.493-4.384-6.712c-0.645-5.086,2.237-8.607,5.205-10.137C601.943,147.004,603.04,146.725,604.7,146.53z
+			 M610.864,162.146c3.14-5.126-0.861-14.731-6.026-14.383c-8.784,0.599-4.681,15.519,0.685,16.574
+			C607.691,164.766,610.048,163.481,610.864,162.146z"/>
+		<path d="M582.373,158.311c2.072-2.402,7.231-1.718,11.644-1.78c-1.775,0.924-1.147,5.428-1.233,8.492
+			c-7.848,2.694-18.611,3.168-23.834-2.055c-2.26-2.26-3.373-5.039-4.109-8.767c0-1.187,0-2.374,0-3.562
+			c0.937-12.521,17.967-17.225,27.807-9.999c-1.438,1.301-2.312,3.168-4.657,3.562c0.114-0.754,0.759-0.977,0.822-1.781
+			c-2.803-3.681-10.114-4.736-14.521-2.055c-1.512,0.919-2.682,2.386-3.561,3.973c-5.941,10.765,4.742,25.164,17.807,20.136
+			c0-2.191,0-4.383,0-6.575C586.619,158.174,584.348,158.094,582.373,158.311z"/>
+	</g>
+	<g>
+	</g>
+</g>
+</svg>
diff --git a/images/logo/AngularJS.exports/angular_logo_for_light_background_small.svg b/images/logo/AngularJS.exports/angular_logo_for_light_background_small.svg
new file mode 100644
index 000000000000..93a4dff4fb34
--- /dev/null
+++ b/images/logo/AngularJS.exports/angular_logo_for_light_background_small.svg
@@ -0,0 +1,40 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- Generator: Adobe Illustrator 15.0.0, SVG Export Plug-In  -->
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd" [
+	<!ENTITY ns_flows "http://ns.adobe.com/Flows/1.0/">
+]>
+<svg version="1.1"
+	 xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:a="http://ns.adobe.com/AdobeSVGViewerExtensions/3.0/"
+	 x="0px" y="0px" width="687px" height="176px" viewBox="0 0 687 176" overflow="visible" enable-background="new 0 0 687 176"
+	 xml:space="preserve">
+<defs>
+</defs>
+<path d="M179.011,125.328V54.527h9.158l43.322,57.035V54.527h8.666v70.801h-9.158l-43.326-57.536v57.536H179.011z M179.011,125.328"
+	/>
+<path d="M310.46,122.554c-5.708,2.182-11.864,3.269-18.467,3.269c-25.644,0-38.469-12.294-38.469-36.887
+	c0-23.27,12.378-34.908,37.134-34.908c7.096,0,13.7,0.994,19.802,2.976v7.921c-6.103-2.311-12.378-3.468-18.813-3.468
+	c-19.306,0-28.96,9.162-28.96,27.479c0,19.639,9.504,29.463,28.517,29.463c3.034,0,6.404-0.396,10.103-1.193V93.145h9.154V122.554z
+	 M310.46,122.554"/>
+<path d="M325.067,97.996V54.523h9.154v43.473c0,13.598,6.768,20.4,20.303,20.4c13.531,0,20.301-6.803,20.301-20.4V54.523h9.158
+	v43.473c0,18.556-9.82,27.825-29.459,27.825C334.886,125.821,325.067,116.552,325.067,97.996L325.067,97.996z M325.067,97.996"/>
+<path d="M409.48,54.523v63.376h37.037v7.425h-46.191V54.523H409.48z M409.48,54.523"/>
+<path d="M459.736,125.327h-9.504l35.201-80.146l35.199,80.146h-10.15l-9.158-22.282h-23.418l2.527-7.424h17.82l-13.217-32.088
+	L459.736,125.327z M459.736,125.327"/>
+<path d="M530.289,125.328V54.527h30.203c13.469,0,20.197,5.659,20.197,16.982c0,9.207-6.578,16.028-19.75,20.445l24.309,33.374
+	h-12.086l-22.521-31.835v-5.992c13.531-2.151,20.301-7.344,20.301-15.598c0-6.533-3.766-9.801-11.293-9.801h-20.201v63.226H530.289z
+	 M530.289,125.328"/>
+<path fill="#B52E31" d="M619.561,54.523v50.405c0,13.603-8.006,20.396-24.016,20.396V117.9c9.902,0,14.857-4.329,14.857-12.973
+	V54.523H619.561z M619.561,54.523"/>
+<path fill="#B52E31" d="M635.896,122.849v-8.418c7.428,2.639,15.447,3.965,24.064,3.965c12.178,0,18.271-4.457,18.271-13.372
+	c0-7.584-4.492-11.385-13.469-11.385h-9.113c-14.818,0-22.234-6.435-22.234-19.31c0-13.531,9.492-20.303,28.479-20.303
+	c8.25,0,15.922,0.998,23.021,2.976v8.418c-7.1-2.644-14.771-3.965-23.021-3.965c-12.875,0-19.311,4.293-19.311,12.875
+	c0,7.588,4.352,11.385,13.066,11.385h9.113c15.08,0,22.627,6.439,22.627,19.31c0,13.864-9.141,20.796-27.43,20.796
+	C651.344,125.819,643.324,124.826,635.896,122.849L635.896,122.849z M635.896,122.849"/>
+<path fill="#B2B2B2" d="M82.688,0L0,29.1l13.066,108.335l69.71,38.314l70.069-38.834l13.062-108.331L82.688,0z M82.688,0"/>
+<path fill="#B52E31" d="M157.66,34.846L82.496,9.214v157.381l62.991-34.861L157.66,34.846z M157.66,34.846"/>
+<path fill="#E23237" d="M9.279,35.308l11.196,96.889l62.019,34.398V9.211L9.279,35.308z M9.279,35.308"/>
+<path fill="#F2F2F2" d="M99.918,87.493L82.632,51.396L67.415,87.493H99.918z M106.508,102.672h-45.82l-10.251,25.64l-19.067,0.352
+	L82.496,14.929l52.908,113.734h-17.673L106.508,102.672z M106.508,102.672"/>
+<path fill="#B2B2B2" d="M82.496,14.929l0.136,36.467l17.268,36.125H82.534l-0.039,15.127l24.012,0.023l11.223,25.996l18.245,0.339
+	L82.496,14.929z M82.496,14.929"/>
+</svg>