From d26bffbc3f7c83a1f97b2601e183562bfa29153f Mon Sep 17 00:00:00 2001
From: Braden Shepherdson
Date: Tue, 23 Jul 2013 10:42:34 -0700
Subject: docs(bootstrap): Note that ngScenario requires ngApp

ngScenario expects an ngApp directive to be used, and doesn't work for
manually bootstrapped apps. The failure mode is to hang on navigation.

Trying to make this wont-fix bug less obscure by documenting it.
Eventually Protractor will replace ngScenario and fix this.
---
 docs/content/guide/dev_guide.e2e-testing.ngdoc | 4 ++++
 src/Angular.js                                 | 3 +++
 2 files changed, 7 insertions(+)

diff --git a/docs/content/guide/dev_guide.e2e-testing.ngdoc b/docs/content/guide/dev_guide.e2e-testing.ngdoc
index 243517ad..00339cb4 100644
--- a/docs/content/guide/dev_guide.e2e-testing.ngdoc
+++ b/docs/content/guide/dev_guide.e2e-testing.ngdoc
@@ -302,3 +302,7 @@ element('.btn-danger').click();
     element('table tbody a');
     element('.btn-danger').click();
 </pre>
+
+# Caveats
+
+ngScenario does not work with apps that manually bootstrap using angular.bootstrap. You must use the ng-app directive.
diff --git a/src/Angular.js b/src/Angular.js
index 764363ef..0a38b230 100644
--- a/src/Angular.js
+++ b/src/Angular.js
@@ -999,6 +999,9 @@ function angularInit(element, bootstrap) {
  *
  * See: {@link guide/bootstrap Bootstrap}
  *
+ * Note that ngScenario-based end-to-end tests cannot use this function to bootstrap manually.
+ * They must use {@link api/ng.directive:ngApp ngApp}.
+ *
  * @param {Element} element DOM element which is the root of angular application.
  * @param {Array<String|Function>=} modules an array of module declarations. See: {@link angular.module modules}
  * @returns {AUTO.$injector} Returns the newly created injector for this app.
-- 
cgit v1.2.3