added file::erase placeholder function
documentation edits