title: OpenERP cache features
body: <p>I want to cache some results in my OpenERP module, so I dug around a bit and found <a href="http://bazaar.launchpad.net/~openerp/openobject-server/5.0/annotate/head:/bin/tools/misc.py#L576" rel="nofollow noreferrer">the cache decorator</a>. Unfortunately, the most documentation I've been able to find is in the class declaration:</p>
  
  <blockquote>
    <p>Use it as a decorator of the function you plan to cache Timeout: 0 = no timeout, otherwise in seconds</p>
  </blockquote>
  
  <p>Can anybody recommend a good example of how to use this? Are there known problems to avoid?</p>