some documentation; support flushing caches