add documentation for new options (reference cache)

users might be glad about documentation