document internal caching
shut up Perl::Critic
bump Changes