Updates from Mon 30 Mar

- [ReactNative] Clean up no longer needed reference to NavigationBarClass | Philipp von Weitershausen
- [TextInput] returnKeyType, enablesReturnKeyAutomatically, secureTextEntry, more keyboardTypes | Tadeu Zagallo
- [ReactNative] PropTypes for NavigationBars | Philipp von Weitershausen
- Changed LayoutAnimation to use ms instead of seconds for consistency | Nick Lockwood
- Better date support | Nick Lockwood
- Renamed throttleScrollCallbackMS to scrollEventThrottle | Nick Lockwood
- Fixed threading issues in RCTImageDownloader | Nick Lockwood
- [iOS][Assets]: Cleaning up more 1x png from Libraries | Radu Marin
- [ReactNative][docs] LinkingIOS | Tadeu Zagallo
- Fixing TouchableOpacity and TouchableHighlight documentation | Ben Alpert
- [react-native] Add React.addons.createFragment | Ben Alpert

Libraries/Image/RCTImageDownloader.h

@@ -16,14 +16,30 @@ typedef void (^RCTImageDownloadBlock)(UIImage *image, NSError *error);
 
 + (instancetype)sharedInstance;
 
+/**
+ * Downloads a block of raw data and returns it. Note that the callback block
+ * will not be executed on the same thread you called the method from, nor on
+ * the main thread. Returns a token that can be used to cancel the download.
+ */
 - (id)downloadDataForURL:(NSURL *)url
                    block:(RCTDataDownloadBlock)block;
 
+/**
+ * Downloads an image and decompresses it a the size specified. The compressed
+ * image will be cached in memory and to disk. Note that the callback block
+ * will not be executed on the same thread you called the method from, nor on
+ * the main thread. Returns a token that can be used to cancel the download.
+ */
 - (id)downloadImageForURL:(NSURL *)url
                      size:(CGSize)size
                     scale:(CGFloat)scale
                     block:(RCTImageDownloadBlock)block;
 
+/**
+ * Cancel an in-flight download. If multiple requets have been made for the
+ * same image, only the request that relates to the token passed will be
+ * cancelled.
+ */
 - (void)cancelDownload:(id)downloadToken;
 
 @end