url: Disk Caching

 
 5.1 Disk Caching
 ================
 
 The disk cache stores retrieved documents locally, whence they can be
 retrieved more quickly.  When requesting a URL that is in the cache, the
 library checks to see if the page has changed since it was last
 retrieved from the remote machine.  If not, the local copy is used,
 saving the transmission over the network.  Currently the cache isn’t
 cleared automatically.
 
  -- User Option: url-automatic-caching
      Setting this variable non-‘nil’ causes documents to be cached
      automatically.
 
  -- User Option: url-cache-directory
      This variable specifies the directory to store the cache files.  It
      defaults to sub-directory ‘cache’ of ‘url-configuration-directory’.
 
  -- User Option: url-cache-creation-function
      The cache relies on a scheme for mapping URLs to files in the
      cache.  This variable names a function which sets the type of cache
      to use.  It takes a URL as argument and returns the absolute file
      name of the corresponding cache file.  The two supplied
      possibilities are ‘url-cache-create-filename-using-md5’ and
      ‘url-cache-create-filename-human-readable’.
 
  -- Function: url-cache-create-filename-using-md5 url
      Creates a cache file name from URL using MD5 hashing.  This is
      creates entries with very few cache collisions and is fast.
           (url-cache-create-filename-using-md5 "http://www.example.com/foo/bar")
             ⇒ "/home/fx/.url/cache/fx/http/com/example/www/b8a35774ad20db71c7c3409a5410e74f"
 
  -- Function: url-cache-create-filename-human-readable url
      Creates a cache file name from URL more obviously connected to URL
      than for ‘url-cache-create-filename-using-md5’, but more likely to
      conflict with other files.
           (url-cache-create-filename-human-readable "http://www.example.com/foo/bar")
             ⇒ "/home/fx/.url/cache/fx/http/com/example/www/foo/bar"
 
  -- Function: url-cache-expired
      This function returns non-‘nil’ if a cache entry has expired (or is
      absent).  The arguments are a URL and optional expiration delay in
      seconds (default URL-CACHE-EXPIRE-TIME).
 
  -- User Option: url-cache-expire-time
      This variable is the default number of seconds to use for the
      expire-time argument of the function ‘url-cache-expired’.
 
  -- Function: url-fetch-from-cache
      This function takes a URL as its argument and returns a buffer
      containing the data cached for that URL.