From 5bb73999ada767474b4af042552fd57ad85219e5 Mon Sep 17 00:00:00 2001
From: Hans-Christoph Steiner <hans@eds.org>
Date: Fri, 13 May 2016 12:49:55 +0200
Subject: [PATCH] more javadoc about how the download URL is used as a unique
 ID

---
 .../main/java/org/fdroid/fdroid/ProgressListener.java    | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/app/src/main/java/org/fdroid/fdroid/ProgressListener.java b/app/src/main/java/org/fdroid/fdroid/ProgressListener.java
index 915b64ee6..1e71373ad 100644
--- a/app/src/main/java/org/fdroid/fdroid/ProgressListener.java
+++ b/app/src/main/java/org/fdroid/fdroid/ProgressListener.java
@@ -7,6 +7,15 @@ import java.net.URL;
  * updates, APKs, etc). This also keeps this class pure Java so that classes
  * that use {@code ProgressListener} can be tested on the JVM, without requiring
  * an Android device or emulator.
+ * <p/>
+ * The full URL of a download is used as the unique identifier throughout
+ * F-Droid.  I can take a few forms:
+ * <ul>
+ * <li>{@link URL} instances
+ * <li>{@link android.net.Uri} instances
+ * <li>{@code String} instances, i.e. {@link URL#toString()}
+ * <li>{@code int}s, i.e. {@link String#hashCode()}
+ * </ul>
  */
 public interface ProgressListener {