package com.novoda.downloadmanager;

public interface CallbackThrottle {

    void setCallback(DownloadBatchStatusCallback callback);

    void update(DownloadBatchStatus downloadBatchStatus);

    void stopUpdates();
}

@@ -34,164 +34,731 @@
 r;%0A%0A
-public interface CallbackThrottle %7B%0A%0A    void setCallback(DownloadBatchStatusCallback callback);%0A%0A    void update(DownloadBatchStatus downloadBatchStatus);%0A
+/**%0A * An interface for defining the speed at which %7B@link DownloadBatchStatus%7D%0A * notifications are emitted.%0A */%0Apublic interface CallbackThrottle %7B%0A%0A    /**%0A     * The callback to pass each emission of %7B@link DownloadBatchStatus%7D to.%0A     *%0A     * @param callback to notify.%0A     */%0A    void setCallback(DownloadBatchStatusCallback callback);%0A%0A    /**%0A     * Called internally by the download manager each time a %7B@link DownloadBatchStatus%7D changes.%0A     * Clients should control the throttling of this status.%0A     *%0A     * @param downloadBatchStatus to throttle.%0A     */%0A    void update(DownloadBatchStatus downloadBatchStatus);%0A%0A    /**%0A     * Prevent additional %7B@link DownloadBatchStatus%7D from being emitted.%0A     */
 %0A   

Add javadoc to the CallbackThrottle.