Deprecate the sd_setImageWithPreviousCachedImageWithURL with the specify options…

… to achieve this usage

@@ -155,7 +155,9 @@
                  completed:(nullable SDExternalCompletionBlock)completedBlock;
                  completed:(nullable SDExternalCompletionBlock)completedBlock;
 
 
 /**
 /**
- * Set the imageView `image` with an `url` and optionally a placeholder image.
+ * Set the imageView `image` with an `url` and custom options. The placeholder image is from previous cached image and will use the provided one instead if the query failed.
+ * This method was designed to ensure that placeholder and query cache process happened in the same runloop to avoid flashing on cell during two `setImage:` call. But it's really misunderstanding and deprecated.
+ * This can be done by using `sd_setImageWithURL:` with `SDWebImageQueryDiskSync`. But take care that if the memory cache missed, query disk cache synchronously may reduce the frame rate
  *
  *
  * The download is asynchronous and cached.
  * The download is asynchronous and cached.
  *
  *
@@ -169,12 +171,13 @@
  *                       is nil and the second parameter may contain an NSError. The third parameter is a Boolean
  *                       is nil and the second parameter may contain an NSError. The third parameter is a Boolean
  *                       indicating if the image was retrieved from the local cache or from the network.
  *                       indicating if the image was retrieved from the local cache or from the network.
  *                       The fourth parameter is the original image url.
  *                       The fourth parameter is the original image url.
+ * @deprecated consider using `SDWebImageQueryDiskSync` options with `sd_setImageWithURL:` instead
  */
  */
 - (void)sd_setImageWithPreviousCachedImageWithURL:(nullable NSURL *)url
 - (void)sd_setImageWithPreviousCachedImageWithURL:(nullable NSURL *)url
                                  placeholderImage:(nullable UIImage *)placeholder
                                  placeholderImage:(nullable UIImage *)placeholder
                                           options:(SDWebImageOptions)options
                                           options:(SDWebImageOptions)options
                                          progress:(nullable SDWebImageDownloaderProgressBlock)progressBlock
                                          progress:(nullable SDWebImageDownloaderProgressBlock)progressBlock
-                                        completed:(nullable SDExternalCompletionBlock)completedBlock;
+                                        completed:(nullable SDExternalCompletionBlock)completedBlock __deprecated_msg("This method is misunderstanding and deprecated, consider using `SDWebImageQueryDiskSync` options with `sd_setImageWithURL:` instead");
 
 
 #if SD_UIKIT
 #if SD_UIKIT