summaryrefslogtreecommitdiff
path: root/content/fetch.h
diff options
context:
space:
mode:
authorJames Bursa <james@netsurf-browser.org>2003-04-17 21:35:02 +0000
committerJames Bursa <james@netsurf-browser.org>2003-04-17 21:35:02 +0000
commit58c28f9c1ab86da14f15cee44ae936c74d812a5f (patch)
treed4612d8ac49f79eda95439939faae6d26aefbe2f /content/fetch.h
parent1ab6b6c50b9a9898c30f1c5837f88e1d697059fd (diff)
downloadnetsurf-58c28f9c1ab86da14f15cee44ae936c74d812a5f.tar.gz
netsurf-58c28f9c1ab86da14f15cee44ae936c74d812a5f.tar.bz2
[project @ 2003-04-17 21:35:02 by bursa]
Max one fetch from each host at once, fix multiple fetches of same url. svn path=/import/netsurf/; revision=127
Diffstat (limited to 'content/fetch.h')
-rw-r--r--content/fetch.h25
1 files changed, 24 insertions, 1 deletions
diff --git a/content/fetch.h b/content/fetch.h
index ab3029b23..92c269a02 100644
--- a/content/fetch.h
+++ b/content/fetch.h
@@ -1,5 +1,28 @@
/**
- * $Id: fetch.h,v 1.2 2003/03/15 15:53:20 bursa Exp $
+ * $Id: fetch.h,v 1.3 2003/04/17 21:35:02 bursa Exp $
+ *
+ * This module handles fetching of data from any url.
+ *
+ * Usage:
+ *
+ * fetch_init() must be called once before any other function. fetch_quit()
+ * must be called before exiting.
+ *
+ * fetch_start() will begin fetching a url. The function returns immediately.
+ * A pointer to an opaque struct fetch is returned, which can be passed to
+ * fetch_abort() to abort the fetch at any time. The caller must supply a
+ * callback function which is called when anything interesting happens. The
+ * callback function is first called with msg = FETCH_TYPE, with the
+ * Content-Type header in data, then one or more times with FETCH_DATA with
+ * some data for the url, and finally with FETCH_FINISHED. Alternatively,
+ * FETCH_ERROR indicates an error occurred: data contains an error message.
+ * Some private data can be passed as the last parameter to fetch_start, and
+ * callbacks will contain this.
+ *
+ * fetch_poll() must be called regularly to make progress on fetches.
+ *
+ * fetch_filetype() is used internally to determine the mime type of local
+ * files. It is platform specific, and implemented elsewhere.
*/
#ifndef _NETSURF_DESKTOP_FETCH_H_