Fixed doxygen markup for BalanceCache.
Minor edits to Doxygen markup.
Added TODO re. some Doxygen issues.