Alow disabling debug info such as ng-scope, ng-binding classes

docs/content/guide/$location.ngdoc

@@ -469,12 +469,12 @@ In these examples we use `<base href="/base/index.html" />`
     it("should show fake browser info on load", function(){
       expect(addressBar.getAttribute('value')).toBe(url);
 
-      expect(element(by.binding('$location.protocol')).getText()).toBe('http');
-      expect(element(by.binding('$location.host')).getText()).toBe('www.example.com');
-      expect(element(by.binding('$location.port')).getText()).toBe('80');
-      expect(element(by.binding('$location.path')).getText()).toBe('/path');
-      expect(element(by.binding('$location.search')).getText()).toBe('{"a":"b"}');
-      expect(element(by.binding('$location.hash')).getText()).toBe('h');
+      expect(element(by.binding('$location.protocol()')).getText()).toBe('http');
+      expect(element(by.binding('$location.host()')).getText()).toBe('www.example.com');
+      expect(element(by.binding('$location.port()')).getText()).toBe('80');
+      expect(element(by.binding('$location.path()')).getText()).toBe('/path');
+      expect(element(by.binding('$location.search()')).getText()).toBe('{"a":"b"}');
+      expect(element(by.binding('$location.hash()')).getText()).toBe('h');
 
     });
 
@@ -485,24 +485,24 @@ In these examples we use `<base href="/base/index.html" />`
 
       expect(addressBar.getAttribute('value')).toBe("http://www.example.com/base/first?a=b");
 
-      expect(element(by.binding('$location.protocol')).getText()).toBe('http');
-      expect(element(by.binding('$location.host')).getText()).toBe('www.example.com');
-      expect(element(by.binding('$location.port')).getText()).toBe('80');
-      expect(element(by.binding('$location.path')).getText()).toBe('/first');
-      expect(element(by.binding('$location.search')).getText()).toBe('{"a":"b"}');
-      expect(element(by.binding('$location.hash')).getText()).toBe('');
+      expect(element(by.binding('$location.protocol()')).getText()).toBe('http');
+      expect(element(by.binding('$location.host()')).getText()).toBe('www.example.com');
+      expect(element(by.binding('$location.port()')).getText()).toBe('80');
+      expect(element(by.binding('$location.path()')).getText()).toBe('/first');
+      expect(element(by.binding('$location.search()')).getText()).toBe('{"a":"b"}');
+      expect(element(by.binding('$location.hash()')).getText()).toBe('');
 
 
       navigation.get(1).click();
 
       expect(addressBar.getAttribute('value')).toBe("http://www.example.com/base/sec/ond?flag#hash");
 
-      expect(element(by.binding('$location.protocol')).getText()).toBe('http');
-      expect(element(by.binding('$location.host')).getText()).toBe('www.example.com');
-      expect(element(by.binding('$location.port')).getText()).toBe('80');
-      expect(element(by.binding('$location.path')).getText()).toBe('/sec/ond');
-      expect(element(by.binding('$location.search')).getText()).toBe('{"flag":true}');
-      expect(element(by.binding('$location.hash')).getText()).toBe('hash');
+      expect(element(by.binding('$location.protocol()')).getText()).toBe('http');
+      expect(element(by.binding('$location.host()')).getText()).toBe('www.example.com');
+      expect(element(by.binding('$location.port()')).getText()).toBe('80');
+      expect(element(by.binding('$location.path()')).getText()).toBe('/sec/ond');
+      expect(element(by.binding('$location.search()')).getText()).toBe('{"flag":true}');
+      expect(element(by.binding('$location.hash()')).getText()).toBe('hash');
     });
 
   </file>
@@ -621,12 +621,12 @@ In these examples we use `<base href="/base/index.html" />`
     it("should show fake browser info on load", function(){
       expect(addressBar.getAttribute('value')).toBe(url);
 
-      expect(element(by.binding('$location.protocol')).getText()).toBe('http');
-      expect(element(by.binding('$location.host')).getText()).toBe('www.example.com');
-      expect(element(by.binding('$location.port')).getText()).toBe('80');
-      expect(element(by.binding('$location.path')).getText()).toBe('/path');
-      expect(element(by.binding('$location.search')).getText()).toBe('{"a":"b"}');
-      expect(element(by.binding('$location.hash')).getText()).toBe('h');
+      expect(element(by.binding('$location.protocol()')).getText()).toBe('http');
+      expect(element(by.binding('$location.host()')).getText()).toBe('www.example.com');
+      expect(element(by.binding('$location.port()')).getText()).toBe('80');
+      expect(element(by.binding('$location.path()')).getText()).toBe('/path');
+      expect(element(by.binding('$location.search()')).getText()).toBe('{"a":"b"}');
+      expect(element(by.binding('$location.hash()')).getText()).toBe('h');
 
     });
 
@@ -637,24 +637,24 @@ In these examples we use `<base href="/base/index.html" />`
 
       expect(addressBar.getAttribute('value')).toBe("http://www.example.com/base/index.html#!/first?a=b");
 
-      expect(element(by.binding('$location.protocol')).getText()).toBe('http');
-      expect(element(by.binding('$location.host')).getText()).toBe('www.example.com');
-      expect(element(by.binding('$location.port')).getText()).toBe('80');
-      expect(element(by.binding('$location.path')).getText()).toBe('/first');
-      expect(element(by.binding('$location.search')).getText()).toBe('{"a":"b"}');
-      expect(element(by.binding('$location.hash')).getText()).toBe('');
+      expect(element(by.binding('$location.protocol()')).getText()).toBe('http');
+      expect(element(by.binding('$location.host()')).getText()).toBe('www.example.com');
+      expect(element(by.binding('$location.port()')).getText()).toBe('80');
+      expect(element(by.binding('$location.path()')).getText()).toBe('/first');
+      expect(element(by.binding('$location.search()')).getText()).toBe('{"a":"b"}');
+      expect(element(by.binding('$location.hash()')).getText()).toBe('');
 
 
       navigation.get(1).click();
 
       expect(addressBar.getAttribute('value')).toBe("http://www.example.com/base/index.html#!/sec/ond?flag#hash");
 
-      expect(element(by.binding('$location.protocol')).getText()).toBe('http');
-      expect(element(by.binding('$location.host')).getText()).toBe('www.example.com');
-      expect(element(by.binding('$location.port')).getText()).toBe('80');
-      expect(element(by.binding('$location.path')).getText()).toBe('/sec/ond');
-      expect(element(by.binding('$location.search')).getText()).toBe('{"flag":true}');
-      expect(element(by.binding('$location.hash')).getText()).toBe('hash');
+      expect(element(by.binding('$location.protocol()')).getText()).toBe('http');
+      expect(element(by.binding('$location.host()')).getText()).toBe('www.example.com');
+      expect(element(by.binding('$location.port()')).getText()).toBe('80');
+      expect(element(by.binding('$location.path()')).getText()).toBe('/sec/ond');
+      expect(element(by.binding('$location.search()')).getText()).toBe('{"flag":true}');
+      expect(element(by.binding('$location.hash()')).getText()).toBe('hash');
 
     });
   </file>

docs/content/guide/index.ngdoc

@@ -81,6 +81,7 @@ This is a short list of libraries with specific support and documentation for wo
 
 ### General
 
+* **Docs Page:** {@link guide/production Running an AngularJS App in Production}
 * **Javascript minification: **[Background](http://thegreenpizza.github.io/2013/05/25/building-minification-safe-angular.js-applications/), [ng-annotate automation tool](https://github.com/olov/ng-annotate)
 * **Analytics and Logging:** [Angularyitcs (Google Analytics)](http://ngmodules.org/modules/angularytics), [Angulartics (Analytics)](https://github.com/luisfarzati/angulartics), [Logging Client-Side Errors](http://www.bennadel.com/blog/2542-Logging-Client-Side-Errors-With-AngularJS-And-Stacktrace-js.htm)
 * **SEO:** [By hand](http://www.yearofmoo.com/2012/11/angularjs-and-seo.html), [prerender.io](http://prerender.io/), [Brombone](http://www.brombone.com/), [SEO.js](http://getseojs.com/), [SEO4Ajax](http://www.seo4ajax.com/)

docs/content/guide/module.ngdoc

@@ -50,7 +50,7 @@ I'm in a hurry. How do I get a Hello World module working?
 
   <file name="protractor.js" type="protractor">
     it('should add Hello to the name', function() {
-      expect(element(by.binding("{{ 'World' | greet }}")).getText()).toEqual('Hello, World!');
+      expect(element(by.binding(" 'World' | greet ")).getText()).toEqual('Hello, World!');
     });
   </file>
 </example>
@@ -128,7 +128,7 @@ The above is a suggestion. Tailor it to your needs.
 
   <file name="protractor.js" type="protractor">
     it('should add Hello to the name', function() {
-      expect(element(by.binding("{{ greeting }}")).getText()).toEqual('Bonjour World!');
+      expect(element(by.binding(" greeting ")).getText()).toEqual('Bonjour World!');
     });
   </file>
 

docs/content/guide/production.ngdoc

@@ -0,0 +1,42 @@
+@ngdoc overview
+@name  Running in Production
+@description
+
+# Running an AngularJS App in Production
+
+There are a few things you might consider when running your AngularJS application in production.
+
+
+## Disabling Debug Data
+
+By default AngularJS attaches information about scopes to DOM nodes, and adds CSS classes
+to data-bound elements. The information that is not included is:
+
+As a result of `ngBind`, `ngBindHtml` or `{{...}}` interpolations, binding data and CSS class
+`ng-class` is attached to the corresponding element.
+
+Where the compiler has created a new scope, the scope and either `ng-scope` or `ng-isolated-scope`
+CSS class are attached to the corresponding element. These scope references can then be accessed via
+`element.scope()` and `element.isolateScope()`.
+
+Tools like [Protractor](github.com/angular/protractor) and
+[Batarang](https://github.com/angular/angularjs-batarang) need this information to run,
+but you can disable this in production for a significant performance boost with:
+
+```js
+myApp.config(['$compileProvider', function ($compileProvider) {
+  $compileProvider.debugInfoEnabled(false);
+}]);
+```
+
+If you wish to debug an application with this information then you should open up a debug
+console in the browser then call this method directly in this console:
+
+```js
+angular.reloadWithDebugInfo();
+```
+
+The page should reload and the debug information should now be available.
+
+For more see the docs pages on {@link ng.$compileProvider#debugInfoEnabled `$compileProvider`}
+and {@link ng/function/angular.reloadWithDebugInfo `angular.reloadWithDebugInfo`}.

scripts/clean-shrinkwrap.js

@@ -23,9 +23,6 @@ function cleanModule(module, name) {
   if (name === 'chokidar') {
     if (module.version === '0.8.1') {
       delete module.dependencies;
-    } else if ( module.version !== '0.8.2') {
-      throw new Error("Unfamiliar chokidar version (v" + module.version +
-          ") , please check status of https://github.com/paulmillr/chokidar/pull/106");
     }
   }
 

src/.jshintrc

@@ -88,6 +88,7 @@
     "getBlockNodes": false,
     "createMap": false,
     "VALIDITY_STATE_PROPERTY": false,
+    "reloadWithDebugInfo": false,
 
     "skipDestroyOnNextJQueryCleanData": true,
 

src/Angular.js

@@ -1402,6 +1402,14 @@ function bootstrap(element, modules, config) {
     modules.unshift(['$provide', function($provide) {
       $provide.value('$rootElement', element);
     }]);
+
+    if (config.debugInfoEnabled) {
+      // Pushing so that this overrides `debugInfoEnabled` setting defined in user's `modules`.
+      modules.push(['$compileProvider', function($compileProvider) {
+        $compileProvider.debugInfoEnabled(true);
+      }]);
+    }
+
     modules.unshift('ng');
     var injector = createInjector(modules, config.strictDi);
     injector.invoke(['$rootScope', '$rootElement', '$compile', '$injector',
@@ -1415,8 +1423,14 @@ function bootstrap(element, modules, config) {
     return injector;
   };
 
+  var NG_ENABLE_DEBUG_INFO = /^NG_ENABLE_DEBUG_INFO!/;
   var NG_DEFER_BOOTSTRAP = /^NG_DEFER_BOOTSTRAP!/;
 
+  if (window && NG_ENABLE_DEBUG_INFO.test(window.name)) {
+    config.debugInfoEnabled = true;
+    window.name = window.name.replace(NG_ENABLE_DEBUG_INFO, '');
+  }
+
   if (window && !NG_DEFER_BOOTSTRAP.test(window.name)) {
     return doBootstrap();
   }
@@ -1430,6 +1444,21 @@ function bootstrap(element, modules, config) {
   };
 }
 
+/**
+ * @ngdoc function
+ * @name angular.reloadWithDebugInfo
+ * @module ng
+ * @description
+ * Use this function to reload the current application with debug information turned on.
+ * This takes precedence over a call to `$compileProvider.debugInfoEnabled(false)`.
+ *
+ * See {@link ng.$compileProvider#debugInfoEnabled} for more.
+ */
+function reloadWithDebugInfo() {
+  window.name = 'NG_ENABLE_DEBUG_INFO!' + window.name;
+  window.location.reload();
+}
+
 var SNAKE_CASE_REGEXP = /[A-Z]/g;
 function snake_case(name, separator) {
   separator = separator || '_';

src/AngularPublic.js

@@ -136,7 +136,8 @@ function publishExternalAPI(angular){
     'uppercase': uppercase,
     'callbacks': {counter: 0},
     '$$minErr': minErr,
-    '$$csp': csp
+    '$$csp': csp,
+    'reloadWithDebugInfo': reloadWithDebugInfo
   });
 
   angularModule = setupModuleLoader(window);