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

garetht · IgorMinar · commit f309c4ceba3a · 2014-07-21T14:54:51.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
@@ -782,7 +782,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
`@@ -782,7 +782,7 @@ function $HttpProvider() {`
`782`	`782`	* Shortcut method to perform `JSONP` request.
`783`	`783`	`*`
`784`	`784`	`* @param {string} url Relative or absolute URL specifying the destination of the request.`
`785`		- * Should contain `JSON_CALLBACK` string.
	`785`	+ * The name of the callback should be the string `JSON_CALLBACK`.
`786`	`786`	`* @param {Object=} config Optional configuration object`
`787`	`787`	`* @returns {HttpPromise} Future object`
`788`	`788`	`*/`