Implementing cache item persistence.

Adding tests.
Formatting config example in cache docblock.
Moving persist docs to main docblock; reformatting docblock.
Merge pull request #1050 from davidpersson/cache-persist

Explicit persistence for cached items