Changing cache semantics, more docs