Merge pull request #218 from square/jw/cleanups

Request transformer is beta. Clean up change log a bit.

CHANGELOG.md

@@ -4,17 +4,24 @@ Change Log
 Version 2.0.0 *(In Development)*
 ----------------------------
 
- * New architecture distances Picasso further from the main thread using a dedicated dispatcher thread to manage requests.
- * Request merging. Two requests on the same key will be combined and the result will be delivered to both at the same time.
- * `fetch()` requests are now properly wired up to be used as "warm up the cache" type of requests without a target.
+ * New architecture distances Picasso further from the main thread using a dedicated dispatcher
+   thread to manage requests.
+ * Request merging. Two requests on the same key will be combined and the result will be delivered
+   to both at the same time.
+ * `fetch()` requests are now properly wired up to be used as "warm up the cache" type of requests
+   without a target.
  * `fit()` will now automatically wait for the view to be measured before executing the request.
- * `shutdown()` API added. Clears the memory cache and stops all threads. Submitting new requests will cause a crash after `shutdown()` has been called.
+ * `shutdown()` API added. Clears the memory cache and stops all threads. Submitting new requests
+   will cause a crash after `shutdown()` has been called.
  * Batch completed requests to the main thread to reduce main thread re-layout/draw calls.
- * Variable thread count depending on network connectivity. The faster the network the more threads and vice versa. Also handles airplane mode.
- * Ability to rewrite requests on the fly. This is useful if you want to add custom logic for wiring up requests differently. 
+ * Variable thread count depending on network connectivity. The faster the network the more threads
+   and vice versa.
  * Ability to specify a callback with `ImageView` requests.
- * Picasso will now decode the bounds of the target bitmap over the network. This helps avoid decoding 2000x2000 images meant for 100x100 views.
+ * Picasso will now decode the bounds of the target bitmap over the network. This helps avoid
+   decoding 2000x2000 images meant for 100x100 views.
  * Support loading asset URIs in the form `file:///android_asset/...`.
+ * BETA: Ability to rewrite requests on the fly. This is useful if you want to add custom logic for
+   wiring up requests differently.
 
 
 Version 1.1.1 *(2013-06-14)*

picasso/src/main/java/com/squareup/picasso/Picasso.java

@@ -60,6 +60,9 @@ public interface Listener {
    * <p>
    * For example, if you use a CDN you can change the hostname for the image based on the current
    * location of the user in order to get faster download speeds.
+   * <p>
+   * <b>NOTE:</b> This is a beta feature. The API is subject to change in a backwards incompatible
+   * way at any time.
    */
   public interface RequestTransformer {
     /**
@@ -456,7 +459,12 @@ public Builder listener(Listener listener) {
       return this;
     }
 
-    /** Specify a transformer for all incoming requests. */
+    /**
+     * Specify a transformer for all incoming requests.
+     * <p>
+     * <b>NOTE:</b> This is a beta feature. The API is subject to change in a backwards incompatible
+     * way at any time.
+     */
     public Builder requestTransformer(RequestTransformer transformer) {
       if (transformer == null) {
         throw new IllegalArgumentException("Transformer must not be null.");