Better doxygen comments for file.h

Also, changed `tr_sys_dir_create_temp` to return bool.