X-Git-Url: https://git.sesse.net/?a=blobdiff_plain;f=src%2Fplaylist%2Fpreparser.h;h=2df0d1a932e6e5c48cdaa888dae62c22e3e5fb1b;hb=2a2dd55119a03f4e410fca67cc07c7a4e990ed95;hp=f4ebc756d34dc9aa5599140c109afd5bd174a9b2;hpb=0021e6aae975b09163afdc52ad1740649a8265a6;p=vlc

diff --git a/src/playlist/preparser.h b/src/playlist/preparser.h
index f4ebc756d3..2df0d1a932 100644
--- a/src/playlist/preparser.h
+++ b/src/playlist/preparser.h
@@ -25,20 +25,33 @@
 #ifndef _PLAYLIST_PREPARSER_H
 #define _PLAYLIST_PREPARSER_H 1
 
-typedef struct
-{
-    playlist_t          *p_playlist;
-    playlist_fetcher_t  *p_fetcher;
-
-    vlc_thread_t    thread;
-    vlc_mutex_t     lock;
-    vlc_cond_t      wait;
-    input_item_t  **pp_waiting;
-    int             i_waiting;
-} playlist_preparser_t;
+/**
+ * Preparser opaque structure.
+ *
+ * The preparser object will retreive the meta data of any given input item in
+ * an asynchronous way.
+ * It will also issue art fetching requests.
+ */
+typedef struct playlist_preparser_t playlist_preparser_t;
 
+/**
+ * This function creates the preparser object and thread.
+ */
 playlist_preparser_t *playlist_preparser_New( playlist_t *, playlist_fetcher_t * );
+
+/**
+ * This function enqueues the provided item to be preparsed.
+ *
+ * The input item is retained until the preparsing is done or until the
+ * preparser object is deleted.
+ */
 void playlist_preparser_Push( playlist_preparser_t *, input_item_t * );
+
+/**
+ * This function destroys the preparser object and thread.
+ *
+ * All pending input items will be released.
+ */
 void playlist_preparser_Delete( playlist_preparser_t * );
 
 #endif