docs($http): add more info about transform function

IgorMinar · IgorMinar · commit 1516a69cd21e · 2013-03-06T11:20:49.000-08:00
diff --git a/src/ng/http.js b/src/ng/http.js
@@ -245,10 +245,14 @@ function $HttpProvider() {
      *  - if XSRF prefix is detected, strip it (see Security Considerations section below)
      *  - if json response is detected, deserialize it using a JSON parser
      *
-     * To override these transformation locally, specify transform functions as `transformRequest`
-     * and/or `transformResponse` properties of the config object. To globally override the default
-     * transforms, override the `$httpProvider.defaults.transformRequest` and
-     * `$httpProvider.defaults.transformResponse` properties of the `$httpProvider`.
+     * To globally augment or override the default transforms, modify the `$httpProvider.defaults.transformRequest` and
+     * `$httpProvider.defaults.transformResponse` properties of the `$httpProvider`. These properties are by default an
+     * array of transform functions, which allows you to `push` or `unshift` a new transformation function into the
+     * transformation chain. You can also decide to completely override any default transformations by assigning your
+     * transformation functions to these properties directly without the array wrapper.
+     *
+     * Similarly, to locally override the request/response transforms, augment the `transformRequest` and/or
+     * `transformResponse` properties of the config object passed into `$http`.
      *
      *
      * # Caching

Original file line number	Diff line number	Diff line change
`@@ -245,10 +245,14 @@ function $HttpProvider() {`
`245`	`245`	`* - if XSRF prefix is detected, strip it (see Security Considerations section below)`
`246`	`246`	`* - if json response is detected, deserialize it using a JSON parser`
`247`	`247`	`*`
`248`		- * To override these transformation locally, specify transform functions as `transformRequest`
`249`		- * and/or `transformResponse` properties of the config object. To globally override the default
`250`		- * transforms, override the `$httpProvider.defaults.transformRequest` and
`251`		- * `$httpProvider.defaults.transformResponse` properties of the `$httpProvider`.
	`248`	+ * To globally augment or override the default transforms, modify the `$httpProvider.defaults.transformRequest` and
	`249`	+ * `$httpProvider.defaults.transformResponse` properties of the `$httpProvider`. These properties are by default an
	`250`	+ * array of transform functions, which allows you to `push` or `unshift` a new transformation function into the
	`251`	`+ * transformation chain. You can also decide to completely override any default transformations by assigning your`
	`252`	`+ * transformation functions to these properties directly without the array wrapper.`
	`253`	`+ *`
	`254`	+ * Similarly, to locally override the request/response transforms, augment the `transformRequest` and/or
	`255`	+ * `transformResponse` properties of the config object passed into `$http`.
`252`	`256`	`*`
`253`	`257`	`*`
`254`	`258`	`* # Caching`