update documentation around cache.clear() and other cache functions
Cache rework for #108 (closed) will probably affect interface for cache. Hopefully we will get rid of separate interface for negative answers, which is kind of confusing.
Also, I have suspiction that cache.clear('example.com.')
flushes everything in example.com.
sub-tree even though documentation suggests that this requires *.example.com.
.