abstracted out clear-cache-partial arguments

 * This was used for shared? caches, but is now available externally
 * documentation and tests