summaryrefslogtreecommitdiff
path: root/content/cache.h
diff options
context:
space:
mode:
Diffstat (limited to 'content/cache.h')
-rw-r--r--content/cache.h23
1 files changed, 7 insertions, 16 deletions
diff --git a/content/cache.h b/content/cache.h
index 4bc64d6e3..8cdb9b63c 100644
--- a/content/cache.h
+++ b/content/cache.h
@@ -5,27 +5,18 @@
* Copyright 2003 James Bursa <bursa@users.sourceforge.net>
*/
-/**
- * The cache contains a content structure for each url. If a structure is not
+/** \file
+ * Caching of converted contents (interface).
+ *
+ * The cache contains a ::content structure for each url. If a structure is not
* in state CONTENT_STATUS_DONE, then loading and converting must be actively
* in progress, so that when a not done content is retrieved no action needs
* to be taken to load it.
*
- * Each content in the cache is either freeable or not freeable. If an entry
- * is freeable, the cache may destroy it through content_destroy at any time.
- *
- * cache_get attempts to retrieve an url from the cache, returning the
- * content and setting it to not freeable on success, and returning 0 on
- * failure.
- *
- * cache_put adds a content to the cache, setting it to not freeable.
- *
- * cache_freeable sets the content to freeable.
+ * Each content in the cache is either freeable or non-freeable. If an entry
+ * is freeable, the cache may destroy it through content_destroy() at any time.
*
- * cache_destroy informs the cache that a content is about to be destroyed,
- * and must be removed from the cache. This should be called when an error
- * occurs when loading an url and the content is destroyed. The content must
- * be non freeable.
+ * The cache uses the cache element of struct content.
*/
#ifndef _NETSURF_DESKTOP_CACHE_H_