docs($http) Clarify how to specify JSONP callback.

garetht · IgorMinar · commit 0252a9889b0e · 2014-07-21T14:55:15.000-07:00
Make clear that it is the name of the callback that should be `JSON_CALLBACK`, instead of the current vague description. Closes #8269
diff --git a/src/ng/http.js b/src/ng/http.js
@@ -854,7 +854,7 @@ function $HttpProvider() {
      * Shortcut method to perform `JSONP` request.
      *
      * @param {string} url Relative or absolute URL specifying the destination of the request.
-     *                     Should contain `JSON_CALLBACK` string.
+     *                     The name of the callback should be the string `JSON_CALLBACK`.
      * @param {Object=} config Optional configuration object
      * @returns {HttpPromise} Future object
      */

Original file line number	Diff line number	Diff line change
`@@ -854,7 +854,7 @@ function $HttpProvider() {`
`854`	`854`	* Shortcut method to perform `JSONP` request.
`855`	`855`	`*`
`856`	`856`	`* @param {string} url Relative or absolute URL specifying the destination of the request.`
`857`		- * Should contain `JSON_CALLBACK` string.
	`857`	+ * The name of the callback should be the string `JSON_CALLBACK`.
`858`	`858`	`* @param {Object=} config Optional configuration object`
`859`	`859`	`* @returns {HttpPromise} Future object`
`860`	`860`	`*/`