diff --git a/contrib/src/main/java/org/archive/modules/extractor/ExtractorYoutubeDL.java b/contrib/src/main/java/org/archive/modules/extractor/ExtractorYoutubeDL.java index 49d11fce..92217d45 100644 --- a/contrib/src/main/java/org/archive/modules/extractor/ExtractorYoutubeDL.java +++ b/contrib/src/main/java/org/archive/modules/extractor/ExtractorYoutubeDL.java @@ -53,18 +53,22 @@ import com.google.gson.JsonStreamParser; * html. * *
- * Keeps a log of media captured as a result of youtube-dl extraction. The - * format of the log is as follows: + * Keeps a log of containing pages and media captured as a result of youtube-dl + * extraction. The format of the log is as follows: * *
[timestamp] [media-http-status] [media-length] [media-mimetype] [media-digest] [media-timestamp] [media-url] [annotation] [containing-page-digest] [containing-page-timestamp] [containing-page-url] [seed-url]* *
- * The annotation field looks like {@code "youtube-dl:1/3"}. In this example, - * "3" is the number of media urls youtube-dl discovered on the page, and "1" is - * the index of this media within the page. The intention is to use this for - * playback. The rest of the fields included in the log were also chosen to - * support creation of an index of media by containing page, to be used for - * playback. + * For containing pages, all of the {@code media-*} fields have the value + * {@code "-"}, and the annotation field looks like {@code "youtube-dl:3"}, + * meaning that ExtractorYoutubeDL extracted 3 media links from the page. + * + *
+ * For media, the annotation field looks like {@code "youtube-dl:1/3"}, meaning
+ * this is the first of three media links extracted from the containing page.
+ * The intention is to use this for playback. The rest of the fields included in
+ * the log were also chosen to support creation of an index of media by
+ * containing page, to be used for playback.
*
* @author nlevitt
*/
@@ -160,11 +164,16 @@ public class ExtractorYoutubeDL extends Extractor implements Lifecycle {
}
} else {
List