From 57253cdd5863787ea77f5eea90d752f3e0203166 Mon Sep 17 00:00:00 2001 From: John Mark Bell Date: Sun, 28 Mar 2010 23:25:21 +0000 Subject: Fixup per review svn path=/trunk/netsurf/; revision=10196 --- content/llcache.h | 19 ++++++++++++++----- 1 file changed, 14 insertions(+), 5 deletions(-) (limited to 'content/llcache.h') diff --git a/content/llcache.h b/content/llcache.h index b2c856f3b..7c3fad6de 100644 --- a/content/llcache.h +++ b/content/llcache.h @@ -81,10 +81,16 @@ typedef nserror (*llcache_handle_callback)(llcache_handle *handle, const llcache_event *event, void *pw); /** Flags for low-level cache object retrieval */ -#define LLCACHE_RETRIEVE_FORCE_FETCH (1 << 0) /* Force a new fetch */ -#define LLCACHE_RETRIEVE_VERIFIABLE (1 << 1) /* Requested URL was verified */ -#define LLCACHE_RETRIEVE_SNIFF_TYPE (1 << 2) /* Permit content-type sniffing */ -#define LLCACHE_RETRIEVE_NO_ERROR_PAGES (1 << 3) /* No error pages */ +enum llcache_retrieve_flag { + /** Force a new fetch */ + LLCACHE_RETRIEVE_FORCE_FETCH = (1 << 0), + /** Requested URL was verified */ + LLCACHE_RETRIEVE_VERIFIABLE = (1 << 1), + /** Permit content-type sniffing */ + LLCACHE_RETRIEVE_SNIFF_TYPE = (1 << 2), + /**< No error pages */ + LLCACHE_RETRIEVE_NO_ERROR_PAGES = (1 << 3) +}; /** Low-level cache query types */ typedef enum { @@ -150,7 +156,9 @@ typedef nserror (*llcache_query_callback)(const llcache_query *query, void *pw, nserror llcache_initialise(llcache_query_callback cb, void *pw); /** - * Poll the low-level cache + * Cause the low-level cache to emit any pending notifications + * and attempt to clean the cache. No guarantee is made about + * what, if any, cache cleaning will occur. * * \return NSERROR_OK on success, appropriate error otherwise. */ @@ -221,6 +229,7 @@ const uint8_t *llcache_handle_get_source_data(const llcache_handle *handle, * \todo Forcing the client to parse the header value seems wrong. * Better would be to return the actual value part and an array of * key-value pairs for any additional parameters. + * \todo Deal with multiple headers of the same key (e.g. Set-Cookie) */ const char *llcache_handle_get_header(const llcache_handle *handle, const char *key); -- cgit v1.2.3