added logical file documentation