1 files changed, 22 insertions, 10 deletions

diff --git a/src/fs/gnunet-fs-gtk-download.h b/src/fs/gnunet-fs-gtk-download.h
index 0780afa1..3d7ac16c 100644
--- a/src/fs/gnunet-fs-gtk-download.h
+++ b/src/fs/gnunet-fs-gtk-download.h
@@ -23,14 +23,17 @@
  * @brief functions for downloading
  * @author Christian Grothoff
  */
-
 #ifndef GNUNET_FS_GTK_DOWNLOAD_H
 #define GNUNET_FS_GTK_DOWNLOAD_H
+
 #include "gnunet-fs-gtk-common.h"
 
+
+/**
+ * Information we keep for a download.
+ */
 struct DownloadContext;
 
-typedef void (*GNUNET_FS_DownloadAsCallback ) (struct DownloadContext *dc);
 
 /**
  * Information we keep for a download.
@@ -84,20 +87,29 @@ struct DownloadContext
    */
   struct SearchTab *tab;
 
-  /**
-   * A function to call once a filename is picked.
-   */
-  GNUNET_FS_DownloadAsCallback cb;
 };
 
 
+/**
+ * Actually start the download that is specified by the given download
+ * context and its options.  Will add a download entry to the
+ * respective tree model and trigger a start of the download using the
+ * FS-API.
+ *
+ * @param dc download context of the download to execute
+ */
 void
-GNUNET_GTK_save_as_dialog_free_download_context (struct DownloadContext *dc);
+GNUNET_FS_GTK_download_context_start_download (struct DownloadContext *dc);
 
 
-void
-GNUNET_FS_GTK_default_open_download_as_callback (struct DownloadContext *dc);
-
+/**
+ * Open the 'save as' dialog for a download.  Calls
+ * 'GNUNET_FS_GTK_download_context_start_download' when the dialog is
+ * complete.  Will release the 'dc' resources if the dialog is
+ * cancelled.
+ *
+ * @param dc download context for the file/directory 
+ */
 void
 GNUNET_FS_GTK_open_download_as_dialog (struct DownloadContext *dc);