document cached option
exactly false, not falsey to match docs