X-Git-Url: http://git.heureux-cyclage.org/?a=blobdiff_plain;f=includes%2Fdeferred%2FMergeableUpdate.php;h=6ae2bcc9e16a9fdaee206dd8ccf239bdb8376c73;hb=8b220cb5b6c5d3779b20a1d59de97291ece80282;hp=70760ce49c0c23a669db9789da25526ff3db46da;hpb=ea9fcc1e4d3b572199d82c426024e3e5efe23879;p=lhc%2Fweb%2Fwiklou.git

diff --git a/includes/deferred/MergeableUpdate.php b/includes/deferred/MergeableUpdate.php
index 70760ce49c..6ae2bcc9e1 100644
--- a/includes/deferred/MergeableUpdate.php
+++ b/includes/deferred/MergeableUpdate.php
@@ -1,12 +1,21 @@
 <?php
 
 /**
- * Interface that deferrable updates can implement. DeferredUpdates uses this to merge
- * all pending updates of PHP class into a single update by calling merge().
+ * Interface that deferrable updates can implement to signal that updates can be combined.
+ *
+ * DeferredUpdates uses this to merge all pending updates of PHP class into a single update
+ * by calling merge(). Note that upon merge(), the combined update goes to the back of the FIFO
+ * queue so that such updates occur after related non-mergeable deferred updates. For example,
+ * suppose updates that purge URLs can be merged, and the calling pattern is:
+ *   - a) DeferredUpdates::addUpdate( $purgeCdnUrlsA );
+ *   - b) DeferredUpdates::addUpdate( $deleteContentUrlsB );
+ *   - c) DeferredUpdates::addUpdate( $purgeCdnUrlsB )
+ *
+ * The purges for urls A and B will all happen after the $deleteContentUrlsB update.
  *
  * @since 1.27
  */
-interface MergeableUpdate {
+interface MergeableUpdate extends DeferrableUpdate {
 	/**
 	 * Merge this update with $update
 	 *