filehandling package: added JavaDoc and minor ammendments.