original code repository is at https://github.com/mapserver/mapcache
repository of this version: https://github.com/OpenWebGlobe/mapcache

This version of MapCache is modified, it has

* improved GDAL support (source_gdal)
* support for OpenWebGlobe tile format (service_owg)
* support for elevation tiles, coloring or float32 RGBA encoding
* support for OpenWebGlobe JSON elevation tiles 
* experimental support for TMS input (service_tms)
* S3 support (cache_s3)

and many more features are planned. All features are still in "experimental" 
state.

################################################################################  
  
To enable all new features, run configure this way:  
./configure --with-gdal --with-s3

make sure to install gdal and libs3 and its dependencies.
(libs3 can be retrieved from: http://git.ischo.com/libs3.git)
(more info about libs3: http://libs3.ischo.com.s3.amazonaws.com/index.html)


** Example Configurations **

Elevation:
  <source name="SRTM" type="gdal">
     <data>/data/srtm.vrt</data>            
  </source>
  <format name="myjson" type="JSON">
  </format> 
  <tileset name="gdal-json-srtm">
     <source>SRTM</source>
     <cache>mycache</cache>
     <grid>mygrid</grid>
     <format>myjson</format>
     <auto_expire>86400</auto_expire>
     <elevation/>
  </tileset>
  
S3-Cache:
  <cache name="s3cache" type="s3">
    <base>tiles</base>
    <host>s3-eu-west-1.amazonaws.com</host>
    <bucket>my_bucket_name</bucket>
    <access_key>HERE_IS_THE_ACCESS_KEY</access_key>
    <secret_key>and_here_is_secret_key</secret_key>
  </cache>
  
you can also limit the max zoom stored on S3:
  if higher zoom levels are requested, they are retrieved from original source:
  <cache name="s3cache" type="s3">
    <base>tiles</base>
    <host>s3-eu-west-1.amazonaws.com</host>
    <bucket>my_bucket_name</bucket>
    <access_key>HERE_IS_THE_ACCESS_KEY</access_key>
    <secret_key>and_here_is_secret_key</secret_key>
    <maxzoom>15</maxzoom>
  </cache>