docs($http): explain why $http may not make the request immediately

wakandan · petebacondarwin · commit 16c7ab1ba0bd · 2013-09-13T14:20:14.000+01:00
I came across this issue today and after researching has found out this thread on so: http://stackoverflow.com/questions/17039998/angular-not-making-http-requests-immediately. It took me quite sometimes to figure out this so I hope the addition in documentation could save somebody else some times and frustration.
diff --git a/src/ng/http.js b/src/ng/http.js
@@ -185,6 +185,10 @@ function $HttpProvider() {
      * will result in the success callback being called. Note that if the response is a redirect,
      * XMLHttpRequest will transparently follow it, meaning that the error callback will not be
      * called for such responses.
+     * 
+     * If your $http is scheduled from something that doesn't cause a $digest to fire then your 
+     * request won't be sent immediately. To make sure a $http request if fired immediately, wrap your
+     * call around with an $scope.$apply(function(){ //make $http request here }
      *
      * # Shortcut methods
      *

Original file line number	Diff line number	Diff line change
`@@ -185,6 +185,10 @@ function $HttpProvider() {`
`185`	`185`	`* will result in the success callback being called. Note that if the response is a redirect,`
`186`	`186`	`* XMLHttpRequest will transparently follow it, meaning that the error callback will not be`
`187`	`187`	`* called for such responses.`
	`188`	`+ *`
	`189`	`+ * If your $http is scheduled from something that doesn't cause a $digest to fire then your`
	`190`	`+ * request won't be sent immediately. To make sure a $http request if fired immediately, wrap your`
	`191`	`+ * call around with an $scope.$apply(function(){ //make $http request here }`
`188`	`192`	`*`
`189`	`193`	`* # Shortcut methods`
`190`	`194`	`*`