Annotation of libwww/Library/src/WWWCache.html, revision 2.1

2.1     ! frystyk     1: <HTML>
        !             2: <HEAD>
        !             3: <TITLE>Declaration of W3C Reference PERSISTENT CACHE MODULE</TITLE>
        !             4: <!-- Changed by: Henrik Frystyk Nielsen,  1-Feb-1996 -->
        !             5: <NEXTID N="z11">
        !             6: </HEAD>
        !             7: <BODY>
        !             8: 
        !             9: <H1>Declaration of W3C Reference PERSISTENT CACHE MODULE</H1>
        !            10: 
        !            11: <PRE>
        !            12: /*
        !            13: **     (c) COPYRIGHT MIT 1995.
        !            14: **     Please first read the full copyright statement in the file COPYRIGH.
        !            15: */
        !            16: </PRE>
        !            17: 
        !            18: <H3>Cache Manager</H3>
        !            19: 
        !            20: Caching is a required part of any efficient Internet access
        !            21: applications as it saves bandwidth and improves access performance
        !            22: significantly in almost all types of accesses.  The Library supports
        !            23: two different types of cache: The memory cache and the file cache. The
        !            24: two types differ in several ways which reflects their two main
        !            25: purposes: The memory cache is for short term storage of graphic
        !            26: objects whereas the file cache is for intermediate term storage of
        !            27: data objects. Often it is desirable to have both a memory and a file
        !            28: version of a cached document, so the two types do not exclude each
        !            29: other. <P>
        !            30: 
        !            31: The cache contains details of temporary disk files which contain the
        !            32: contents of remote documents.  There is also a <A
        !            33: HREF="HTAnchor.html#z1">list of cache items for each URL</A> in its
        !            34: anchor object. <P>
        !            35: 
        !            36: There are various ways of handling Expires header when met in a
        !            37: history list. Either it can be ignored all together, the user can be
        !            38: notified with a warning, or the document can be reloaded
        !            39: automatically. This flag decides what action to be taken. The default
        !            40: action is HT_EXPIRES_IGNORE. In HT_EXPIRES_NOTIFY mode you can specify
        !            41: a message to tell the user (NULL is valid in which case my own message
        !            42: pops up - watch out it might be in Danish ;-)) <P>
        !            43: 
        !            44: The Library has two notions of a local cache: a file cache and a
        !            45: memory cache. The memory cache is handled by the client and the file
        !            46: cache is handled by the Library. Often the format of a object cached
        !            47: in memory is in the form of a hypertext object ready to be displayed
        !            48: (that is, it's already parsed).
        !            49: 
        !            50: <PRE>
        !            51: #ifndef WWWCACHE_H
        !            52: #define WWWCACHE_H
        !            53: </PRE>
        !            54: 
        !            55: <H2>Library Includes</H2>
        !            56: 
        !            57: <PRE>
        !            58: #ifdef __cplusplus
        !            59: extern "C" { 
        !            60: #endif
        !            61: </PRE>
        !            62: 
        !            63: <PRE>
        !            64: #include "HTCache.h"
        !            65: </PRE>
        !            66: 
        !            67: End of CACHE module
        !            68: 
        !            69: <PRE>
        !            70: #ifdef __cplusplus
        !            71: } /* end extern C definitions */
        !            72: #endif
        !            73: 
        !            74: #endif
        !            75: </PRE>
        !            76: 
        !            77: End of WWWCACHE API definition
        !            78: 
        !            79: </BODY>
        !            80: </HTML>

Webmaster