Implement atomic increment/decrement in Cache library

Requested via issue #109
Supersedes PR #241
fix doc warnings
d'oh - :noindex: in wrong place

Signed-off-by: Connor Tumbleson <connor.tumbleson@gmail.com>
Merge pull request #2805 from iBotPeaches/develop

fix doc warnings/errors