cache.h: document add_[file_]to_index