maybe even better not to speak about the CACHE hive var when refering to ti but simply link to the detailed explanations. Sorry, i realize at the end of this 'Show Diff Stats' i'm too verbose! bothering you for tiny tiny changes!!! 
i guess less is better in a tech-savvy context like an API doc
Anyway, i'll be on holiday starting next week so, i'll just bother you with 1 or 2 extra PR before i'm done with this API doc :)